终端链接点击 jeremytenjo/dsh-plugin-terminal-upgrades

DeepSeek Harness 终端增强

DeepSeek Harness 终端增强。第一个功能：在终端里按住 Option 键悬停在 URL 上，URL 会显示下划线；点击它，就会在浏览器中打开。触发键可配置。

功能

- 按住触发键时，链接显示下划线。 下划线画在 URL 所在的单元格上，颜色与 URL 一致，指针变成手形，点击前就能看出哪里可点。
- 点击打开浏览器。 点击 next dev 输出的 http://localhost:3000，会在新标签页打开；桌面应用把 URL 交给默认浏览器。
- 触发键可配置。 默认 Option，也可以在插件配置里改成 Command 或 Control。
- 普通点击不受影响。 文本选择、双击选词、键盘输入都照旧送达终端。只有按住触发键点击链接时才会拦截。
- 不改动终端。 插件读取终端已经渲染的行，再叠加自己的覆盖层；它从不改写终端文本，所以输出、颜色和 shell 都不受影响。
- 对所有终端标签页生效，包括安装之后才打开的标签页；移除插件时会干净地释放。

安装

在桌面应用里打开侧边栏的 Plugins，选择 Add plugin，填入这个目录。桌面配置档由 Electron 应用管理，所以在桌面端推荐用这种方式。

其他配置档请用命令行：

git clone https://github.com/jeremytenjo/dsh-plugin-terminal-upgrades.git
dsh plugin --profile <profile> add ./dsh-plugin-terminal-upgrades

把 <profile> 换成 dsh --profile <name> --dump-config 显示的名字（例如 web）。安装后重启 Host 或刷新页面。

包内已附带浏览器 bundle（client.js），安装时不需要构建步骤。

用法

1. 运行会打印 URL 的命令，例如在 Next.js 项目里执行 pnpm dev。
2. 按住触发键——默认是 Option（⌥）——把指针移到 URL 上。URL 显示下划线，终端光标变成手形。指针已经停在链接上时再按触发键，不用移动指针也会显示下划线。
3. 点击。URL 在新的浏览器标签页打开。在桌面应用里则用系统浏览器打开。

不按触发键时，点击同一个 URL 还是原来的行为：定位终端光标，开始选择文本。

配置

触发键默认是 Option（Alt）。在插件的配置档条目配置里修改：

~/.dsh/profiles/desktop/cordis.patch.yml
- id: dsh-plugin-terminal-upgrades
name: "dsh-plugin-terminal-upgrades"
config:
triggerKey: meta

| triggerKey | 按键 |
| alt（默认） | macOS 上是 Option，Windows 和 Linux 上是 Alt |
| meta | Command |
| ctrl | Control |
改动后重启 DeepSeek Harness：配置档会在启动时应用插件配置。Host 在启动过程中校验该值，遇到未知键会直接报错并停用插件，不会静默回退。浏览器在页面加载时读取一次设置，在结果返回前保持 Option 状态。

只有配置的按键会触发下划线和点击，其他修饰键保持无响应，因此用它们做其他终端手势的人不受影响。

工作原理

DeepSeek Harness 用 xterm 的 DOM 渲染器渲染终端，所以可见的行以文本形式存在于页面中。插件监听 document，把指针位置映射到终端行和字符偏移，并对指针下的任意行运行同一套 URL 规则：

- 仅限 http:// 和 https://。
- URL 后的句末标点和不成对的右括号会被排除，所以 see https://example.test/docs. 链接的是 URL，不含句号。
- 成对的右括号保留在链接内，所以 https://example.test/a_(b) 保留其 )。

客户端插件收不到配置档条目配置，因此 Host 那一半负责校验 triggerKey，并通过一条回环路由 /__dsh/terminal-upgrades 发布它；浏览器在启动时读取一次。下划线本身是插件自有的覆盖层元素，按 URL 的文本段定位，因此终端自身的 DOM 从不被修改。

插件不新增插槽、不新增终端状态、也不做逐终端设置，所以除了移除监听器和覆盖层，没有需要清理的东西。

限制

- 一次只处理一行。 折行到下一终端行的 URL 检测不到；http://localhost:3000 这类短链接不受影响。
- 下划线是覆盖层。 它跟随终端渲染出的文本段。滚动会隐藏它，直到指针再次移动；极不寻常的字体回退可能让它偏移一个像素。
- 自行捕获鼠标的程序。 在自行上报鼠标点击的终端程序里（如 Vim 或 less），用触发键点击链接会被插件消费；用触发键点击其他位置仍会传给程序。
- 仅支持 DOM 渲染器。 检测读取的是渲染出的行。如果终端切换到 canvas 或 WebGL 渲染器，什么都检测不到，插件也不做任何事。
- 不是通用链接打开器。 文件路径、行号和裸主机名都不算链接。

开发

pnpm install
pnpm run build # regenerates client.js from src/client.js
pnpm test # URL, offset, host-route and terminal-screen tests

src/client.js 是浏览器端源码，index.js 是 Host 那一半，scripts/build-client.mjs 把浏览器端打包成 client.js，并包成 Harness 模块加载器的形状。编辑 src/，运行 pnpm run build，然后重新加载页面。