Skip to content

Releases

v0.6.0 — 终端旁边多了一个文件面板

Choose a tag to compare

@SerenaderZ SerenaderZ released this 12 Nov 08:54

0.6.0 左侧文件面板

终端旁边多了一栏文件管理,照 MobaXterm 的样子:上面是目录树,下面是文件列表,中间的分隔条可以拖。默认是关着的,顶栏的文件夹图标或者 Ctrl+Alt+F 打开。

它跟着你的终端走。 在终端里 cd 一下,侧栏自己跳到那个目录,不用两边各点一遍。

两个来源

  • 本机 —— NAS 自己的文件。
  • 远程 SFTP —— 可以存多份连接,密码和私钥口令加密后落盘。

四条设计上的约定

一、默认隐藏,状态记在服务端。 开合、宽度、树高、用的哪个来源都存在 settings.json,和主题、布局同一个地方。只放浏览器本地会少写点代码,但这个应用的整个意义就是换台设备打开还是你离开时的样子,面板的状态不该是唯一的例外。

二、本机的文件操作按终端的身份来做。 tsd 是 root 起的,但终端里的 shell 降权到了管理员账户。不做这件事的话,你上传上去的文件属主会是 root,终端里的自己反而删不动它。文件操作会切到和终端一样的 uid/gid 再执行。

三、跟着终端走靠读 /proc/<pid>/cwd。 换成一推就知道的做法(PROMPT_COMMAND、OSC 7)要动你的 rc 文件,代价太大。1.5 秒看一眼符号链接,对任何能 cd 的程序都有效。

四、密码是加密的,但得说清楚防的是什么。 AES-GCM,密钥文件和密文放在同一个目录。它挡的是别人顺手翻到配置文件,挡不住已经拿到这台机器 root 的人。所以不写"军用级加密"这种话。

主机指纹第一次连接时记下来,之后对不上就拦住连接,而不是弹个警告继续连。

其它

  • 上传、下载、拖放上传、新建文件夹、重命名、删除、复制路径,都在右键菜单里。
  • 删非空目录会说「同名的还在,要不要连里面的东西一起删」,而不是甩一句 errno。
  • 文件列表底部原来还挤着一串权限位,300px 宽下每行都被截断,Windows 上还把目录报成 -rwxrwxrwx。现在只留大小和时间,完整路径和权限挪到悬停提示。

还没验到的

写在这里,免得装上去才发现:

  • 远程 SFTP 只跑通了「连不上」这一条路径 —— 打包这台机器上没有可连的 SSH 服务。真实握手、上传下载、指纹比对都还没实测。
  • 拖放上传 只验了文件选择框,drop 事件没法在无头浏览器里造出来。
  • 跟随终端目录 在 Windows 上不生效(要 Linux 才有 /proc/<pid>/cwd),得装到 NAS 上看。

安装

飞牛应用中心 → 设置 → 手动安装,挑对应架构:

架构 适合 文件
x86 N100 / N305 / Intel / AMD terminals_0.6.0_x86.fpk
arm RK3588 / ARM 板子 terminals_0.6.0_arm.fpk

md5:x86 37cbe4328bb36217867d270cf9b96470,arm e00153ac1c5e72a873e5a4e5eb12d99d。

v0.5.7 — 拖选不再偷偷复制

Choose a tag to compare

@SerenaderZ SerenaderZ released this 12 Nov 03:32

0.5.7 修「拖选之后点一下想取消,却提示复制成功」

拖选只是拖选:不写剪贴板。复制只发生在右键(有选区)那一刻,点一下取消就什么都不该发生。

这次为什么坏了

0.5.5 为了让「框 5 行、粘出来还是 3 行」不再发生,把程序随后发来的复制序列(OSC 52)换成了用户框住的内容再写进剪贴板。可程序的回放本身就是一次写剪贴板 —— 这一换,等于让每次拖选都必定写一次,拖选变成了静默自动复制。

更麻烦的是这条回放不保证在松手之后到达:Claude Code 这类全屏程序通过鼠标追踪先收到按下就把序列发出去了,于是它可能正好落在「按下 → 松开」之间。框取消了、什么都没选中,剪贴板却已经被写掉,还弹一句「按你框选的 5 行已写入剪贴板」。

改法

  • 拖选结束时只记一个时刻,不再保存框住的文本 —— 没东西可写,就不会偷偷写。
  • 拖选后 2 秒内程序发来的 OSC 52 一律当作它在回放这次拖选,直接吞掉:不写剪贴板、不提示。不管它落在松手之前还是之后。
  • 点一下取消时刻意不清那个时刻(清了的话,还在路上的回放会被判成「没有近期拖选、照常生效」,取消又白点)。
  • 超过 2 秒的程序复制(vim 的 y、tmux / ssh 的 osc52 插件)照常生效。
  • 右键复制拿到的仍然是框住的那几行,一个字不少。

验证

反向验证:只撤掉「吞掉回放」这一条,用例立刻红灯,报的正是用户看到的现象 ——「取消后剪贴板没有被写 7 → 8」「程序发来的 3 行(23 个字符)已写入剪贴板」。恢复后 ui-osc52 19 项、ui-sel 13 项、ui-clip 19 项全绿,go vet ./... 通过。

0.5.2 → 0.5.7 这一串在修什么

复制粘贴这条链路上连着踩了几个坑,现在整条是通的:

版本 修的问题
0.5.2 框 5 行粘出 3 行(取完文字顺手裁掉了结尾空行);补上 OSC 52(程序「选中即复制」发的序列,以前完全没人接)
0.5.3 加了版本自查和复制回执(后被用户判定无用,0.5.5 移除)
0.5.4 复制后焦点掉到 body,导致粘贴彻底失灵(http 下用临时 textarea + execCommand,select() 抢走了键盘焦点)
0.5.5 框选内容优先于程序晚到的 OSC 52(做法有误,见 0.5.7)
0.5.6 回执直接报行数;去掉全部快捷键提示,复制粘贴只用鼠标
0.5.7 拖选不再被程序回放变成静默自动复制;取消就是取消

关于「粘进 Claude Code 只看得到 3 行」:那个位置是 Claude 自己的渲染 —— 它收到多行粘贴会折叠成一行摘要(paste again to expand),发送时也会去掉消息末尾的空行。终端实际发出去的是完整的 5 行(实测字节:…v2.1.322\r glm…\r /root\r\r,4 个 CR、一行不少)。判断依据看回执行数,不要看它在聊天里显示几行。

安装

fnOS 应用中心 → 设置 → 手动安装,选 .fpk:

  • x86(N100 / N305 / Intel / AMD)→ terminals_0.5.7_x86.fpk
  • ARM(RK3588 等)→ terminals_0.5.7_arm.fpk

校验值:

d1a5d010b14e69739cb28955a719b311  terminals_0.5.7_x86.fpk
52c5e16a82a86c11b70a0b955efd7424  terminals_0.5.7_arm.fpk

升级后如果行为看着没变,先确认 tsd 进程真的重启了:安装包的 upgrade_callback 不自动重启,靠应用中心按 ctl_stop 处理。

v0.5.1

Choose a tag to compare

@SerenaderZ SerenaderZ released this 11 Nov 03:09

这段时间主要在两件事上:历史记录真正变成可以接着干活的入口,以及复制粘贴在各种全屏程序里的手感。

历史记录

标题不再取程序设置的窗口标题,改成你输入的第一条命令。由此带出一整套规则:

  • 只开窗口、什么都没敲 → 不记录,因为本来就没做什么
  • 点开一条老记录 → 后续敲的命令继续写进同一条,不是新建一条
  • 时间以最后关闭那个窗口为准;还活着的那条按最后活动时间算,列表里标「运行中」
  • 排序照着浏览器历史来,越新越靠上

点开一条记录仍然是"铺历史 + 接一个真 shell",但相关的一堆毛病都清掉了:打开后多出一行提示符、回看时你敲的无效命令那一行是空白、鼠标划过就冒 35;98;8M 这种数字串(历史日志里留着程序当年发的"打开鼠标追踪"序列,回放时被照着重演了)。

最实在的一条:刷新页面之后历史不会再消失了。以前那一屏历史是前端点开时自己画上去的,刷新后前端连"这条会话属于哪份记录"都不知道,只剩接手之后敲的内容。现在服务端在握手时把记录 id 一并给出,前端取回会话开始之前那一段日志,拼成历史 → 分界线 → 后续内容,一次铺上屏幕;期间到达的实时输出先攥住,铺完再按原顺序补,不丢也不重复。

顺带修了三个让"看起来正常、其实没记"的坑:接手后只敲空回车不算数(现在人一动手就开始记)、日志文件句柄丢了就静静返回(现在重开接着写)、状态灯把还没建过连的隐藏窗格也算进去(于是永远黄灯"连接中")。

选区与复制

  • 切标签回来满屏乱码:清字形图集只清了自己那一格,别的窗格指着已经没了的数据
  • 拖选后左键取消,右键粘出来的还是刚才那段:选了就自动复制的行为整套删掉,复制只在右键(或 Ctrl+Insert)
  • 三行文本粘出来变五行:全屏程序爱用不换行空格把每行补满整宽,translateToString 只认普通空格,于是每行后面拖着上百个看不见的字符,粘到会折行的地方就折出空行。现在每行按 Unicode 空白裁尾
  • 纯空白选区现在能复制出换行,和 Windows 终端一致:选 N 行给 N-1 个换行
  • 真要一个字节都不动(对齐的定宽文本、表格):Ctrl+Shift+Insert 原样复制,行尾空白和末尾空行全留

标签

双击标签可以自定义工作区名称。编辑态的宽度按双击那一刻的实际尺寸锁死,输入框正好占满原来文字那一块,左边、上边、宽高全对得上——以前的版本一进编辑就把标签撑宽,把后面所有标签往右挤,标签一多整条栏会抖一下。

安装

飞牛 NAS 的 fpk,选对应架构:

包 大小 MD5
terminals_0.5.1_x86.fpk 3226688 c1b13d2187fb6b536826bd59bbc1847f
terminals_0.5.1_arm.fpk 2947341 f3911815edcfe67d4d17f72aeb19ca56

卸载不会删 <数据目录>/history/,重装后历史还在;要腾空间手动清。

v0.3.0

Choose a tag to compare

@SerenaderZ SerenaderZ released this 10 Nov 01:33

给终端加了一本历史。

它是什么

每个终端会话的输出都会完整留一份。不是命令历史 —— 命令历史只记得你敲了什么,记不住你看到了什么;这里留下的是当时屏幕上出现过的全部内容,包括报错、构建输出、Claude Code 的回复。

存储只有两个出口:删单条、清空全部。不按大小裁剪、不按时间过期、不轮转。

面板

标题栏新增时钟按钮,快捷键 Ctrl+Alt+H。照着浏览器历史页做的:

  • 上面一个搜索框,按标题、目录、shell 过滤
  • 下面按「今天 / 昨天 / 最近 7 天 / 更早」分组
  • 每条右边是时间,鼠标移上去才露出删除
  • 还在跑的会话,标题后面标「运行中」

标题取程序自己设的窗口标题(OSC 0/2,claude、vim、npm 都会设)。服务端解析,所以没人打开页面时列表也是完整的。PowerShell 那种把标题设成 C:\Windows\System32\...\powershell.exe 的,会自动收敛成 powershell。

点开一条

不是只读回看,而是新开一个标签:

  1. 把那一次的输出铺满屏幕
  2. 末尾一条 ── 以上是历史记录 ── 的分界线
  3. 下面接一个真的、能用的 shell

所以看完历史可以直接接着敲命令,不用再开一个窗格。

日志默认只回放最后 2MB(终端回看缓冲本来也留不住更多),更早的部分会明确标注「更早的内容已省略(共 X MB)」。

数据放在哪

<数据目录>/history/:一条会话一个 .log(原始字节流)+ 一份 index.json(标题、目录、起止时间、字节数)。

日志才是唯一的事实:索引丢了会从 .log 文件名和大小把记录捞回来;进程被强杀留下的"还在跑"状态,下次启动也会按文件实际情况校正。

验证

新增 9 项 Go 单测(写入 / 重载 / 删除 / 清空 / 索引缺失 / 日志缺失 / 路径穿越 / 标题跨块解析 / 超长 OSC 恢复)+ 13 项界面回归(落盘、列表、搜索、点开、回放、回放后 shell 可用、删除、404、清空)。

原有回归全绿:复制粘贴 13、分屏焦点 9、Claude 选区 11、全屏 4、回放 8、重开 8、提示条 3、重连应答 9。

安装

  • x86:N100 / N305 / Intel / AMD
  • arm:RK3588 等 ARM 板

飞牛应用中心 → 设置 → 手动安装,选对应的 .fpk。

v0.2.21

Choose a tag to compare

@SerenaderZ SerenaderZ released this 05 Nov 08:09

重连不再往 shell 里塞乱码。

现象

每次重连(断线重连、关掉网页再打开)都会在提示符下面冒出:

root@Serenader:~# 1;2c
-bash: 1;2c: command not found
-bash: 2c: command not found

原因

重连会把历史输出重演一遍。历史里可能留着程序当初发出的终端查询序列(DA,例如 ESC[c,很多 CLI 用它在启动时探测终端能力)。

终端不知道这是重演,按规矩应答 ESC[?1;2c —— 而应答走的是和键盘输入同一条通道(onData),于是它被当成用户敲的字送进 PTY。ESC[? 被 readline 吞掉,剩下 1;2c 落在命令行上,回车一按就成了命令。

重连一次答一次,所以「每次重连都有」。

改法

回放这一段字节解析期间,onData / onBinary 一律不外发;最后一段写完立刻解锁,键盘不受影响。另加 3 秒兜底,万一服务端少发一段也不会把键盘锁死。

只屏蔽回放窗口,程序在实时输出里查询终端能力照常应答 —— 那是正常交互。

验证

新增 tools/ui-ack.mjs 9 项:真实断线重连 + 一帧确定性的回放(REPLAY_ACK_PROBE ESC[c)。

  • 回滚到 0.2.20:会记录到外发的 ESC[?1;2c —— 和你截图里的 1;2c 完全对得上;
  • 0.2.21:窗口内没有任何字节外发,窗口结束后自动解锁,键盘照常。

原有回归全绿:复制粘贴 13 项、分屏焦点 9 项、Claude 选区 11 项、全屏 4 项、回放 8 项、重开 8 项、提示条 3 项。

安装

  • x86:N100 / N305 / Intel / AMD
  • arm:RK3588 等 ARM 板

飞牛应用中心 → 设置 → 手动安装,选对应的 .fpk。

v0.2.20

Choose a tag to compare

@SerenaderZ SerenaderZ released this 05 Nov 01:20

点另一格,蓝框跟过来。

现象

分屏之后只有一格套着蓝框 —— 那是当前窗格,分屏、关闭、快捷键全作用在它身上。上一版之后,点另一格,蓝框不动,还是"选中"原来那一格,接下来按 Ctrl+Alt+= 也在错的地方分屏。

原因

0.2.19 把选区改成自己维护,为了不让终端库和里面的程序各自再选一遍,拖选的 mousedown 在终端那一层就地 stopPropagation 掉了。窗格自己的"按下即聚焦"监听挂在外层元素上,靠事件冒泡上来 —— 被拦住之后,这一下点击就不再算点击。

一句话:为了不重复选中文字,把"点到了这一格"也一起拦掉了。

改法

终端接管拖动时主动上报一次"用户点了这一格",焦点和蓝框一起挪过去。普通拖动、Shift 拖动、双击 / 三击、以及没拖动只是点一下,四条路都覆盖到。

验证

新增 9 项回归:分屏 → 点另一格 → 普通拖动 → 全屏程序里点另一格 → Shift 拖动。

回滚到 0.2.19 时这 9 项全红(蓝框一次都没动),改完全绿。原有回归仍然全绿:复制粘贴 13 项、Claude 选区 11 项、全屏 4 项、回放 8 项、重开 8 项、提示条 3 项。

安装

  • x86:N100 / N305 / Intel / AMD
  • arm:RK3588 等 ARM 板

飞牛应用中心 → 设置 → 手动安装,选对应的 .fpk。

v0.2.19

Choose a tag to compare

@SerenaderZ SerenaderZ released this 04 Nov 05:23

选区不再借终端库的模型,改成自己维护。三次补丁都是在堵别人家的窟窿,这次把窟窿绕开了。

为什么反复治不好

Claude Code 这类全屏程序每一帧都会把终端状态重设一遍,并且真的会消费鼠标报告。终端库自己的选区模型在这些路径上会被清掉,它画的高亮层也会被重绘冲掉 —— 于是同一个现象换着花样出现:有时框消失了,有时框还在但里面是空的,右键就落到粘贴。

现在怎么做

范围按鼠标坐标算,文字按范围从屏幕缓冲区取,高亮由我们自己画。这三样都不经过终端库,程序怎么重绘都改不了它们。

  • Shift 拖选完全归我们:鼠标事件不再转给程序。Claude Code 收不到就不会自己再选一遍、自己复制一次、再整屏重绘,框不会互相打架。
  • 不按 Shift 直接拖动也认:那个蓝色选框其实是 Claude Code 自己画的,它在 http 页面上根本写不进系统剪贴板(copied N chars to clipboard 是假的),所以以前右键只能粘贴。现在这种拖动也记一份范围,但不拦事件、不影响程序自己的交互,右键照样复制到你看见的那段字。
  • 拖动和单击按像素区分:短距离拖动不会再被当成点击、松手就把选区清掉。
  • 双击选词、三击选行补回来了(以前是终端库送的)。
  • 快照不再按时间过期,只有你确实做了别的事(在别处点左键、按键盘、复制完)才作废。

验证

在真实的 claude 会话里跑三条路径:普通拖动、Shift 拖动松手、Shift 拖动不松手按右键 —— 三条都能复制到 25 个字符。回归:复制粘贴 13 项、claude 选区 11 项、全屏 4 项、回放 8 项、重开 8 项、提示条 3 项全部通过。

安装

  • x86:N100 / N305 / Intel / AMD
  • arm:RK3588 等 ARM 板

飞牛应用中心 → 设置 → 手动安装,选对应的 .fpk。

v0.2.18

Choose a tag to compare

@SerenaderZ SerenaderZ released this 04 Nov 03:26

修「明明选着文字,右键出来却是粘贴」。

为什么选框还在、右键却是粘贴

全屏程序(Claude Code 这类)开着鼠标追踪,右键按下会被终端打包成鼠标报告发给程序;终端在「用户有其它输入」时会顺手把选区清掉。实测:按下那一刻选区里还有 27 个字符,等右键菜单事件触发时已经是 0。

所以复制只能靠一份快照兜底,而那份快照的有效期是 15 秒 —— 你选中一段慢慢读上二三十秒再右键,就刚好过期,落进粘贴。偏偏选框是前端自己画的、程序重绘冲不掉,于是出现「框明明还在,右键却是粘贴」。

改法

  • 按下瞬间就抓住内容:在右键按下的最早期(早于终端把这次按下变成鼠标报告)把选区文字存下来,并且这时候不解锁,让程序也清不掉。右键复制不再看时序运气。
  • 快照不再按时间过期:只有你确实做了别的事才作废 —— 在别处点左键、按键盘、复制完自动收掉。框还在就该能复制。
  • 两连击不变:复制后立刻收掉选框,所以「右键复制 → 右键粘贴」照旧;从来没选过时右键依然是粘贴。

验证

新增 4 项右键语义用例(按下即抓取、等很久仍复制、复制后必为粘贴、点过别处为粘贴),共 9 项;复制粘贴 11 项、全屏 4 项、回放 8 项、重开 8 项全部通过。

安装

  • x86:N100 / N305 / Intel / AMD
  • arm:RK3588 等 ARM 板

飞牛应用中心 → 设置 → 手动安装,选对应的 .fpk。

v0.2.17

Choose a tag to compare

@SerenaderZ SerenaderZ released this 04 Nov 02:14

修两个反复出现的老问题:重开网页后顶部一片叠字、Claude Code 里拖选高亮消失。

一、关掉网页再打开,屏幕顶部一片叠字

终端输出是字节流。同一段字节按 121 列解析和按 158 列解析,画出来是两幅完全不同的画面 —— readline、Ink 这些程序重画一行靠的是「回车 + 光标移动 + 擦除」,宽度一变,这些定位就全落到错的地方,两行字叠在一起,看着就是顶部一片乱码。

以前的回放不管宽度对不对都照灌。现在会话会记下每段输出是在多少列下写的,只回放「客户端当前宽度」那一段;宽度对不上就干脆不回放,清屏后让程序自己按新尺寸重画(Resize 会补一个 SIGWINCH,全屏程序整屏重绘,shell 也会重画提示符)。

顺带两处:建连前先等布局稳定(连续两次量到同一个列数),不再出现「页面还没排版好就按 80x24 灌一整段历史」;回放落地后整屏重画一次并清掉字形图集,顶部不会留上一次连接的残影。

二、Claude Code 里按住 Shift 拖选,高亮还是会自己消失

这次不跟 xterm 的渲染器较劲了。选区那层底色改成前端自己画:按选区范围在终端上盖一层色块,和终端内容、和程序怎么重绘完全无关,所以冲不掉。复制取文字仍然走终端自己的选区,右键语义不变:有选中就复制,没选中就粘贴。

另外,拖选期间即使选区数据被程序清掉,右键也能复制到刚选的那段(快照在锁定期间不再过期)。

安装

  • x86:N100 / N305 / Intel / AMD
  • arm:RK3588 等 ARM 板

飞牛应用中心 → 设置 → 手动安装,选对应的 .fpk。装完打开页面即为新版,不需要手动清缓存。

v0.2.16

Choose a tag to compare

@SerenaderZ SerenaderZ released this 04 Nov 00:34

修两个用起来最扎手的问题:全屏程序里选不中文字、重连后历史被重印一遍。

一、Claude Code 里按住 Shift 拖选,高亮会自己消失

这类程序每一帧都会把终端状态重设一遍,其中包含「重新进入备用屏幕」的序列。xterm 收到它就会当成一次缓冲区切换,顺手把选区清掉——鼠标协议明明没变,选中的东西却没了,根本来不及右键。

现在在拖选期间把「非用户意图的清选区」整个挡住:松手后高亮一直留着,直到你下一次点击或按键。复制之后照旧自动收掉,所以「右键复制 → 右键粘贴」两连击不受影响。

二、重连后出现两份一模一样的会话记录

建连那一刻浏览器还没算好行列数,URL 里带的是默认的 80x24。服务端照着改了一次 PTY,紧接着页面算完尺寸又改回来——两次窗口变化信号。Claude Code 用的 Ink 每收到一次就会把整个历史重排后重新打印,于是屏幕上出现两份同样的对话。

现在建连前先把行列数算准,只在真的对不上时才对账;回放完整时也不再主动抖尺寸。重连前后 PTY 尺寸保持一致。

三、升级后仍跑旧脚本

前端资源带上版本号(app.js?v=0.2.16)并禁用强缓存。之前升级完打开页面,浏览器可能还在跑上一版脚本,看到的现象是「明明更新了,bug 还在」。

安装

  • x86:N100 / N305 / Intel / AMD
  • arm:RK3588 等 ARM 板

飞牛应用中心 → 设置 → 手动安装,选对应的 .fpk。装完打开页面即为新版,不需要手动清缓存。