工作区深链接zekdeW/dsh-client-workspace-deep-link

dsh-client-workspace-deep-link

英文 | 中文

一个用于 DeepSeek Harness 的微型客户端插件，为 Web GUI 添加启动时工作区深链接：打开

http://127.0.0.1:3080/?workspace=

页面便会以该工作目录初始化一个新会话并选中它，让你直接进入限定于该目录的对话。当该目录已存在空白会话时会被复用，因此重复的深链接会落在同一个对话中。该入口会在任何网络请求之前从地址栏中消费掉，因此刷新页面永远不会再次初始化会话。

这使得 GUI 可以从任何外部工具启动——macOS 或 Linux 上的 Alfred / Raycast / 脚本、自定义按钮、DeepSeek Finder 工具栏应用——而无需改动 harness 仓库本身。

安装

需要可用的 dsh 安装（任何近期构建；harness 尚处于预发布阶段，因此插件 API 可能会变动）。

1. 将包安装到 web profile 中
dsh plugin --profile web add github:zekdeW/dsh-client-workspace-deep-link

2. 将插件行接入 profile 的 patch 层
编辑 ~/.dsh/profiles/web/cordis.patch.yml 并添加：
- insert:
- id: workspace-deep-link
name: '@zekdeW/dsh-client-workspace-deep-link'

3. 重启 web 服务器
kill $(lsof -ti :3080)
cd ~/dev/deepseek-harness && nohup pnpm dsh web >/tmp/dsh-web.log 2>&1 &

然后打开 http://127.0.0.1:3080/?workspace=/some/directory，一个限定于该目录的对话会立即启动。

工作原理

插件的浏览器端注册在 ctx.workspaces / ctx.sessions 上——与内置工作区选择器所驱动的服务相同——并在页面加载时：

1. 从 URL 中读取 ?workspace= 并将其从地址栏中移除（保留其他查询项）；
2. 将该路径注册为工作区（workspaces.create，对规范化路径幂等）；
3. 连接其空白会话（workspaces.connectWorkspace，会复用该目录已有的空白会话）并选中它（sessions.open）。

初始化只会重试可折叠的传输失败（internal，即页面加载/连接竞态，最多 40 次尝试，退避 250 毫秒）；Host 拒绝（无效目录）会停止初始化，而不会选中失败的会话。

开发

pnpm install
pnpm tsdown   # 生成 lib/（提交构建产物：git 安装不会运行构建脚本）

许可证

MIT

dsh-client-workspace-deep-link

给 DeepSeek Harness Web 界面加启动期 workspace 深链接的
微型客户端插件：打开

http://127.0.0.1:3080/?workspace=

页面就会新建一个以该目录为工作区的会话并选中它，直接进入限定该目录的对话。该目录已有空白会话时会被复用，
重复深链落在同一个对话里。参数会在任何网络请求前从地址栏移除，刷新页面不会重复创建会话。

装上之后，任何外部工具——Alfred / Raycast / 各种脚本、自定义按钮、
DeepSeek Finder 访达工具栏按钮——都能一键直达以指定目录为工作区的
对话，完全不用改 Harness 仓库本身。

安装

需要可用的 dsh（较新构建即可；Harness 处于 pre-release 阶段，插件 API 可能变动）。

1. 把包装进 web profile
dsh plugin --profile web add github:zekdeW/dsh-client-workspace-deep-link

2. 把插件行接进 profile 的补丁层
编辑 ~/.dsh/profiles/web/cordis.patch.yml,加入:
- insert:
- id: workspace-deep-link
name: '@zekdeW/dsh-client-workspace-deep-link'

3. 重启 web 服务
kill $(lsof -ti :3080)
cd ~/dev/deepseek-harness && nohup pnpm dsh web >/tmp/dsh-web.log 2>&1 &

然后打开 http://127.0.0.1:3080/?workspace=/某个目录，以该目录为工作区的对话会立即开始。

原理

插件浏览器侧注册在 ctx.workspaces / ctx.sessions 上——与内置 workspace 选择器驱动的是同一套服务。
页面加载时：

1. 从 URL 读取 ?workspace= 并从地址栏移除（保留其他查询参数）；
2. 把路径注册为 Workspace（workspaces.create，按规范路径幂等）；
3. 连接其空白会话（workspaces.connectWorkspace，会复用该目录已有的空白会话）并选中（sessions.open）。

种子过程只对折叠的传输失败（internal，页面加载与连接建立的竞态，上限 40 次、间隔 250 ms）重试；
Host 拒绝（目录无效）即停止，且不选中失败的会话。

开发

pnpm install
pnpm tsdown   # 产出 lib/(构建产物需提交进仓库:git 安装不会执行构建脚本)

License

MIT