android.permission.BLUETOOTH_CONNECT
+ 在安卓 12 以及更高版本上必须获得该权限
+ 以连接蓝牙 SPP UART 适配器
+ ]]>安卓系统并不能决定意图能够使用的资源 + (安卓自身的权限模型不足以灵活到支配任意软件的权限资源) + 像一些比如说 Automate 这样的自动化软件 + 通常并不提供任何绑定到服务的简单方式 + (在这个情况下检查应用凭据还是可以的). + 因此\"token\" 一栏已经添加到参数收藏夹中 + 用以缓解这个问题. 这一栏保存着一个唯一的ID + 作为口令来启动一个会话.
+会话内会运行一个脚本 + 用于控制会话实例的数量.
+要启动一个会话 (比如说：从 Automate 启动) 使用:
+Intent 目标: 服务 (前台启动)
+
+ 包名 (application ID):
+
+ Class:
+
+ 动作:
+
+ 分类:
+
+ 附加项:
+
+ 这个值应该是一个从你偏好的收藏设置中的\"token\"字符串.
+
所有 字符串 附加项 会被传递给环境变量并且以
+ String.toUpperCase(Locale.ROOT).replaceAll(\"[^A-Z0-9_]\", \"_\")
+ 命名并加上INPUT_前缀 . …FAV_TOKEN 值会被隐藏.
Highlights
+-
+
- UART, SSH, Telnet and local PTY support in the same application; +
- Adequate screen input methods as long as a terminal requires specific keyboard +functions; +
- Ability to set fixed screen columns and/or rows numbers. +
Features
+-
+
- Minimum supported Android version is 4.0 Ice Cream Sandwich. +
- Supported USB UART devices:
-
+
- Generic USB CDC, +
- CP210X, +
- FTDI, +
- PL2303, +
- CH34x, +
- CP2130 SPI-USB. +
+ - Bluetooth SPP UART devices are supported. +
- Local Linux PTY is supported. Feel free to use + +PRoot with some Linux environment. +
-
+Shell tool to interact with the Android environment is also present.
+
-
+
- Content exchange between other applications and own files / pipes has been implemented. +
- It also works in chrooted environments (PRoot at least). +
- USB and Bluetooth serial port dongles access from the command line is also implemented. +
- libusb support on nonrooted Android +[how to install]. + +
- Custom plugins +to access the Android environment and own API to create them as separate APKs. +
+ - Telnet (no encryption). +
- Supported SSH features:
-
+
- zlib compression; +
- password and public key authentication (OpenSSH and PEM key formats); +
- port forwarding (can be modified on a running SSH session); +
- starting extra shell channels on a running SSH session. +
+ - No MoSH, sorry. +
- Built-in screen keyboard and mouse. +
- Hardware buttons mapping. +
- Different charsets and customizable key mapping support. +
Credits
+Thanks to:
+-
+
- felHR85 and other contributors for +UsbSerial library +(license); +
- JCraft for their +JSch SSH library +(license); +
- mwiede and other contributors for +numerous JSch library improvements +(JSch license / +jBCrypt license / +JZlib license); +
- The Legion of the Bouncy Castle +for some modern ciphers for old Androids +(license); +
- The creators of the +DejaVu Sans Mono font +(license); +
- The authors of the +MaterialSeekBarPreference +widget +(Apache 2 license); +
- The author of the +BetterLinkMovementMethod +(license); +
- The author of the +Android Stem +(license); +
- Android Maven Gradle Plugin +(license); +
- Apache Commons +(Apache 2 license); +
- The Android Open Source Project +(official Google Android API and support libraries) +(Apache 2 license). +
Cryptography usage note
+The only part of this application that touches on cryptography is the SSH client used to +communicate with remote systems. Currently this is provided by the JSch library.
+This application is self-classified under ECCN 5D992 with the encryption authorization +type identifier MMKT.
+Disclaimer
+It\'s unlawful to provide this application to or use by the prohibited entities listed in +Sanctioned Destinations +and +Lists of Parties of Concern +.
+The copyright holder and contributors are not responsible for any actions of any parties +and their consequences related to the aforementioned regulation.
+]]>离线参考
+共同特性
+-
+
- 便笺板 +
本地Shell
+-
+
- Environment +
- termsh +
- 共享内容给 其他终端供查看和编辑 +
- 通过意图（intent）启动会话 +
注意
+-
+
- 8位C1控制代码支持 +
- RTL支持 +
所有符号均会以UTF-16编码的形式出现并且被转换输出至与终端字符集一致的 +上游输出.
+-
+
- \\\\ — `\\\' +
- \\{000-377} — 八进制符号代码 +
- \\u{0000-FFFF} — 十六进制符号代码 +
- \\e — Escape (\\u001B) +
- \\a — 响铃 (\\u0007) +
- \\b — 退格 (\\u0008) +
- \\t — Tab (\\u0009) +
- \\n — LF (\\u000A) +
- \\v — 垂直 tab (\\u000B) +
- \\f — 换页 (\\u000C) +
- \\r — CR (\\u000D) +
请先查看 + Wikipedia + 和 + invisible-island.net/xterm
+这个软件的管道处理过程是这样的:
+ =>
+ 字符集转换
+ =>
+ 输入解析器
+ =>
+
+ =>
+ 输出生成器
+ =>
+ 字符集转换
+ =>
8位控制代码在 流解析/生成 过程中被处理 + 也因此取决于当前的字符集编码.
+举个例子:
+ CSI (9B)在 UTF‑8 下变成C29B.
+
目前有两种RTL支持方式:
-
+
- 传统 — 根据Unicode规则显示每一个文本 + 并且原模原样从剪贴板复制/粘贴. +
- Raw 实验性 — 以LTR方式显示文本 + 并且以这样的方式从剪贴板复制/粘贴. +
注意: 目前而言, 如果raw 模式启用, 这些文本：
+ U+200E U+200F U+2066 U+2067 U+2068 U+2069 U+202A U+202B U+202C U+202D U+202E
+ 双向标记字符
+ 会从搜索小工具的文本中移除.
便笺板
+
+ 功能很大程度上是用于处理安卓系统的列集限制
+ 和缺乏内容URI引用计数能力的问题.
选中的终端缓冲内容会被拷贝到便笺板. 只需要按下
+
+ 按钮.
如果复制/共享的内容大小超出在 + 设置 菜单设置的大小或者编排失败，这个功能也会复制数据 + 至便笺板，只不过这一次使用的是内容URI
+如果一个条目在复制或共享后被删除, + 剪贴板中的内容将会被废弃 或者 当这些内容URI仍未被打开时 + 用于接收这些数据的软件会用不了它(与现实中的情况很不一样).
+注意:应用软件对于这些复制来的数据/获得的URI可能很不一样 + 比如说: + 当粘贴的内容仅包含URI时 + 浏览器一般会直接忽视粘贴进浏览器搜索栏的内容.
+ ]]>为处理 android.intent.action.SEND,
+ android.intent.action.SEND_MULTIPLE,
+ android.intent.action.VIEW or
+ android.intent.action.EDIT action,
+ 将会创建一个带有一些额外环境变量的新会话
+ 这些设置会在一个另外弹出的会话配置文件窗口中由用户自行选择.
+ \"展示至（show in） «共享至（share with） » / «打开方式（open with） » 选项窗口\"
+ 复选框应当在会话配置中选中来使其可见.
注意: 任何传递至其他 终端的URI + 都可以在其本地会话中访问. 访问控制的功能已经提上日程... +
环境变量
+Intent.getAction().Intent.getType().共享
+-
+
INPUT_TEXT [2|3|…][_URI ]* — +android.intent.extra.TEXTif plain.
+ INPUT_SPANNED [2|3|…][_URI ]* — +android.intent.extra.TEXTif formatted + (will be represented as HTML).
+ INPUT_HTML [2|3|…][_URI ]* — +android.intent.extra.HTML_TEXT.
+ INPUT_URIS — + a space separated list ofandroid.intent.extra.STREAM.
+ INPUT_SUBJECT — +android.intent.extra.SUBJECT.
+ INPUT_EMAIL_ {TO |CC |BCC } — +android.intent.extra.{EMAIL|CC|BCC}respectively.
+
Note: * — Suffix termsh uri).
查看和编辑
+-
+
INPUT_URI — 内容URI.
+
termsh cat | copy | with-uris etc.
+
are supposed to be used with the INPUT_URI.
-
+
DATA_DIR — 默认的数据持久化存储目录. +
这会随着软件删除一同被删除.
+ PROTECTED_DATA_DIR — 默认受设备保护的 + 数据持久化目录(能用就调). +
这会随着软件删除一同被删除.
+ SHARED_DATA_DIR — + 主共享/外部存储设备上的目录 + 软件会在这里存放自己的持久化文件 + (能用就调). + 其他拥有存储空间权限的软件也可以访问这里. +
这会随着软件删除一同被删除.
+ EXTERNAL_DATA_DIR — +SHARED_DATA_DIR 的别名.
+ PUBLIC_DATA_DIR — \"sdcard\"的根目录. +READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE这个权限是必要的.
+ LIB_DIR — 原生库路径.
+ APP_APK — 其他终端软件 的APK路径.
+ APP_ID — 其他终端软件 的application id.
+ APP_VERSION — 其他终端软件 的版本.
+ APP_TARGET_SDK — 其他终端软件的 +targetSdkVersion（可以去类似于LibCheck这样的软件查看）.
+ MY_DEVICE_ABIS — 受支持的架构列表 + 从最推荐到最不推荐.
+ MY_ANDROID_SDK — Android SDK版本.
+ SHELL_SESSION_TOKEN — 与相关数据关联 + 包括 termsh 权限和会话相关UI.
+
-
+
- 与其他终端共享内容 +
命令: +
-
+
- termsh (
$LIB_DIR/libtermsh.so ) — 一个用于 + 从终端Shell调用安卓功能的工具. + 带上参数help运行以了解 + 更多内容.
+
TERMSH=\"
用法
+ +\"$TERMSH\" [-r|--raw] <command> [<args...>]
-
+
-r|--raw— 当命令执行时，将一个tty转换到 +raw 模式，使用cfmakeraw()+libc函数设置. +(注意, Ctrl‑C等在这个模式下不会被PTY捕捉)
+
命令
+ +注意: 任何UI元素 (除了通知) 和相关命令 +在终端Activity对应的会话结束之前均会被屏蔽.
+ +-
+
+
+帮助 +
+- 会显示这一页这么一堆东西XD.
+notify [-i|--id <id>] [--] [<message>]
+notify -r|--remove -i|--id <id> +
+-
+显示通知, 在message段无参数传入时会默认用stdin.
+
-
+
-i|--id <id>— 通知id.
+-r|--remove— 通过id检索并删除相关通知.
+
+clipboard-copy [<string>] +
+-
+复制到剪贴板 (仅当用户在操作当前会话的UI时).
+如果没有提供<string>, 将会默认使用stdin. +
+clipboard-copy+权限是必须的. +uri [--] <file>
+uri [-m|--mime <mime>] [-n|--name <name>] [-s|--size <size>]
+uri -c|--close-stream [--] <URI>
+uri -l|--list-streams +
+-
+获取指定文件或流的自带的内容提供程序 URI，或关闭以前打开的流.
+
除非指定参数-w|--wait，否则命令处理完毕后会立即退出. +在指定为流的情况下, 当流读取到EOF（End Of File）标识或者它可以被选项 +-c|--close-stream <URI>关闭时， +<URI>将自动解除绑定. +-
+
-m|--mime <mime>— Mime type,*/*- default.
+-n|--name <name>— 用于表示流的名称.
+-s|--size <size>— 当输入是流，指定要在查询答案中提供的大小（以字节为单位） +比如说谷歌的Gmail客户端, 即使在使用流的情况下 +也会将缺省大小视为0.
+-w|--wait— 等待流读取到 EOF，然后将其关闭 +并退出;$TERMSH的终止也会关闭流. 当你需要在termsh关闭时 +仍然需要保持一个在运行的Shell管道时使用这个参数;
+example:tar -czv * | \"$TERMSH\" uri -w
+-c|--close-stream <URI>— 取消绑定流<URI>+并释放相关资源.
+-l|--list-streams— 列出所有绑定的流URIs.
+
+view|edit [<options...>] [--] <file|URI> +
+-
+使用适当的临时访问权限打开文件/URI以供查看/编辑.
+
在与用户交互后该命令并不会结束. +-
+
-N|--notify— 发送一个通知而不是弹出选项对话框.
+-m|--mime <mime>— Mime type,*/*- default.
+-p|--prompt <prompt>— 在选择对话框中显示.
+-r|--recipient <recipient>— 指定一个用于接受意图（intent） +的Activity.<recipient>可以是: +-
+
- 一个应用程序的Activity类名. +
- 传入其他应用的Acitvity作为参数应遵照如右格式:
+
<package>/<activity_class>
+(<activity_class>可以以一个 `.\' (dot)开头 +以使用<package>作为它的前缀:
+foo.bar/.Act=>foo.bar/foo.bar.Act). +
\"$TERMSH\" view +-r \'green_green_avk.anotherterm.FavoriteEditorActivity \' +-u \'local-terminal:/opts?execute=my_awesome_script\'
+-u|--uri— 使用URI而非文件.
+
+send [<options...>] [--] [<file|URI> ...] +
+-
+Send (
android.intent.action.SENDor +android.intent.action.SEND_MULTIPLE). +当代表stdin的 +/^(?:[a-z0-9+.-]+):\\/\\//i不匹配时 +<file|URI>将会被当作文件路径. +
`-\' is used to represent the stdin. +
当文件或者URI被指定时 +命令在流发送后或与用户交互后退出. +-
+
-N|--notify— 发送一个通知而不是弹出选项对话框.
+-m|--mime <mime>— Mime type for an stdin stream, +*/*- default.
+-n|--name <name>— 用于代表 + stdin 流的名字.
+-s|--size <size>— 当输入是流，指定要在查询答案中提供的大小（以字节为单位） +比如说谷歌的Gmail客户端, 即使在使用流的情况下 +也会将缺省大小视为0.
+-p|--prompt <prompt>— 弹出选项对话框.
+--text <text>— +android.intent.extra.TEXT.
+--text-stdin— +the same but from the stdin.
+--html <HTML>— +android.intent.extra.HTML_TEXT. +android.intent.extra.TEXTwill be set to +Html.fromHtml(<HTML>)+if no--text <text>or +--text-stdinis specified.
+--html-stdin— +the same but from the stdin.
+--subject <subject>— +android.intent.extra.SUBJECT.
+--email-to <address[ address]...>— +android.intent.extra.EMAIL.
+--email-cc <address[ address]...>— +android.intent.extra.CC.
+--email-bcc <address[ address]...>— +android.intent.extra.BCC.
+
+convert cat.jpg -grayscale average - | \"$TERMSH\" send -m image/jpeg --subject \'My cat\' --text \'Attached.\' -+
注意: 很多应用程序, 包括谷歌Gmail客户端, +要求事先知道流大小... +在上述情况流将不适用.
+convert cat.jpg -grayscale average cat_gray.jpg && \"$TERMSH\" send --subject \'My cat\' --text \'Attached.\' cat_gray.jpg+
但这个会有用.Or just resharing text content by value: +
+\"$TERMSH\" cat \"$INPUT_URI\" | \"$TERMSH\" send --text-stdin
+这个在使用文本文件的内容作为新邮件的的内容时会派上用场. +pick [<options...>] [--] [<path>] +
+-
+弹出文件选择窗口（SAF）并且将选中的文件 (或者它的URI) 至:
+
-
+
- 传递文件：当
<path>是一个文件;
+ - 由内容提供器（content provider）提供文件名的文件： (or deduced from the URI)
+当 <path>是一个目录;
+ - 该参数缺省时默认使用stdout. +
http和https方案也均随着file和content+受到支持= +
当URI被指定时 +命令在收到内容后退出，或在选择器对话框结果后立即退出. +-
+
--insecure— 通过HTTPS连接并忽视无效证书.
+-N|--notify— 发送一个通知而不是弹出选项对话框.
+-m|--mime <mime>— Mime type,*/*- default.
+-p|--prompt <prompt>— 弹出选项对话框.
+-u|--uri— 输出URI而非内容.
+-f|--force— 允许覆写目标.
+
+\"$TERMSH\" pick .
+\"$TERMSH\" pick | tar -zxv - 传递文件：当
+copy [-f|--force] [--insecure] [--progress] [-fp|--from-path|-fu|--from-uri <from>] [-tp|--to-path|-tu|--to-uri <to>] +
+-
+复制内容。现在仅支持单个文件.
+源URI可以是
content,http或者https. +目标 URI 方案必须为content. +当<from>或者<to>未指定, +stdin 或者 stdout 将被分别使用. +<to>可以是一个目录. + -
+
-f|--force— 允许覆写目标.
+--insecure— 通过HTTPS连接并忽视无效证书.
+--progress— 将当前进度输出至 stderr.
+
+cat [--insecure] [--progress] [<URI> ...] +
+-
+将指定URI内容连接至 stdout,
+`
-\' 用于代表 stdin. +URI方案可以为content,http或者https. +如果URI缺省, 将默认使用stdin. +-
+
--insecure— 通过HTTPS连接并忽视无效证书.
+--progress— 将当前进度输出至 stderr.
+
示例:
+
++\"$TERMSH\" cat \"content://$APP_ID.linksprovider/html/some_url_to_be_wrapped_into_html\" +
++uri=\"$(\"$TERMSH\" pick -u)\"
+\"$TERMSH\" cat \"$uri\" > \"$(\"$TERMSH\" name \"$uri\").new\" + +with-uris <name> <arg0> [<args...>] <URIs> +
+-
+
Warning: +这个命令可能在Android ≥ 10上不起作用.
+这个命令可用于 +内容分享，查看和编辑 功能. +它在指定<URI>的情况下运行，该命令由 procfs fd 条目表示 +<URIs>是单个参数，由空格分隔 +URI的内容提供者（content provider） 必须能够为返回整个文件描述符 +它会返回实际命令的退出值，在出现问题时会返回 +
+127或者1.效果与下列命令相同 +
+ +execp(name, arg0, args..., \"/proc/PID/fd/FD_URI0 /proc/PID/fd/FD_URI1 ...\") +name <URI> +
+-
+Get the name provided by content provider (or deduced from the URI)
. + +size [--insecure] <URI> +
+-
+获取内容提供者（content provider）提供的大小或者HTTP头部的
content-length+(若参数缺省则会返回null). + +mime [--insecure] <URI> +
+-
+获取内容提供者（content provider）提供的mime-type或者HTTP头部的
content-type+(若参数缺省则会返回*/*). + +serial -l|--list
+serial [-a|--adapter <address>] [-i|--insecure] [<baudrate>[/<databits>[/<stopbits>[/<parity>[/<flowcontrol>]]]]] +
+-
+连接到 USB 适配器并使用stdin / stdout.
+
-
+
-a|--adapter— 使用由<address>;指定的USB适配器
+-i|--insecure— 不使用安全连接 (蓝牙);
+-l|--list— 在表单中列出可用的 UART 适配器，格式：<address> <description>.
+
可能会用上的值:
+-
+
- 波特率: 一个正数
0
+ - 数据位:
-, 8,7,6,5
+ - 停止位:
-, 1,1.5,2
+ - 奇偶校验:
-, none,even,odd,mark,space
+ - 流控制:
-, off,xon_xoff,rts_cts,dsr_dtr
+
+— 保留当前值 默认:
+0/-/-/-/-注意: 此外, UART端口设置 +(
+<baudrate>,<databits>,<stopbits>, +<parity>,<flowcontrol>) +无法应用于使用 Android 蓝牙栈的蓝牙适配器.
+了解详情 +uri-encode <string> [<allowed>] +
+- 对
<string>进行URL转义但不转义 +<allowed>中指定的内容. +如果参数
+<allowed>缺省, +将会使用java.net.URLEncode.encode(v, \"UTF8\"). +转义将根据application/x-www-form-urlencoded的MIME格式进行.如果参数
+<allowed>以及指定 (指定的内容为空也行，这并不算是指定了个寂寞), +将会使用android.net.Uri.encode(). +但[A-Za-z0-9_!.~\\\'()*-]始终不受影响. +uri-decode <string> +
+- 对
<string>进行逆转义. +request-permission <name> <message> +
+- 使用一个对话框征得用户意见.
+
-
+
<name>— 可以是: +favmgmt, +pluginexec, +clipboard-copy.
+<message>— 用于展示的信息.
+
Return codes:
+-
+
0— 用户同意;
+1— 出错;
+2— 用户拒绝;
+3— 已经授权.
+
+revoke-permission <name> +
+- 除你权限.
+has-favorite <name> +
+- 返回
0值当一个命名为<name>的收藏项已经存在, +否则返回2. +调用此命令的shell必须具有管理收藏夹的权限 +否则会返回
1值. +create-shell-favorite [-t|--term <terminal_string>] [--] <name> <execute> +
+- 添加一个名字为
<name>+并且执行内容为<execute>脚本字符串的收藏项. +当名称<name>已被使用时会返回错误码2. +调用此命令的shell必须具有管理收藏夹的权限 +否则会返回
1值. +plugin [--] <package_name> [<args>...]
+plugin -h|--help [--] <package_name> +
+- 运行由参数
<package_name>指定的插件或者输出这个插件的信息页. +调用此命令的shell必须具有执行插件的权限 +否则会返回
1值. +wakelock {is-held|acquire [<timeout>]|release} +
+is-held返回值: +-
+
0— 唤醒锁开;
+2— 唤醒锁关.
+
+<timeout>是以秒为单位的十进制值 +精度为 1 毫秒.
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
+ +
注意:
+-
+
— 如果文件名推导失败 +则使用unnamed并返回退出代码2.
+— 便笺板列集限制适用.
+
相关的环境变量:
+-
+
TERMSH_UID — +此应用程序的真实 UID，用于欺骗检测. +若仿真的UID不同 +这是使用termsh必须配置的项 +(比如说Chroot下的环境).
+SHELL_SESSION_TOKEN — +当前会话token. +由 其他 终端 自行设置. +访问当前会话属性及其连接的终端窗口时 +需要设置.
+
/system/bin/sh -l;+ 否则执行
/system/bin/sh -l -c <>.+ 注意: Android 4.0.X 的
sh 没有
+ -l 选项.
+ ]]>注意: 若没有运行在例如PRoot的这样的沙盒运行环境下 + 任何运行在该终端的进程都可以读取任意应用程序的配置文件.
+ ]]>这只会在用户操作当前会话的UI时被执行 + 其他情况下会被忽视.
+ ]]>仅当需要从本地终端读取共享存储空间时 + 才需要为本软件授予该权限.
+警告: 只有你需要运行任意二进制文件时再… 好了好了，提醒一下而已.
+警告: 这个软件的共享目录是
+ 不需要这个权限就能访问的. (see the
+ SHARED_DATA_DIR 环境变量)
注意: 这个软件在该权限变动时 + 会关闭包括软件本体在内的所有的会话. + 这个是安卓的特性.
+ ]]>%s
注意:
+-
+
- 一些Android设备可以通过按住一些按钮 + (比如说 音量+/音量-) + 代表对于这个按键的连击. +
- 默认情况下Android使用自己的修饰符标志 + 但有时候输入法会坏事. + 在这种情况下，将修饰键映射到其自身可能会有所帮助. +
- 此应用程序自己的屏幕键盘不受影响 + 也不影响Android软输入/硬件键盘的修饰键状态. +
+这意味着，访问公共存储目录的传统方式已经过时 +即使授予此权限，也可能不起作用. +
怎么办:
-
+
- 你可以使用
termshshell工具 +通过 +Storage Access Framework（SAF）访问.
+ - 但仍然可以访问应用程序共享目录中的任何文件
+(这不需要额外权限) (详情参阅
+
SHARED_DATA_DIR环境变量).
+