dsh-turn-tools
English | 中文
English
A DeepSeek Harness (dsh) web plugin that adds two tools to the chat interface:
- Per-turn deliverable buttons — when an agent turn produces output files, buttons for each file are rendered at the end of that turn. Clicking a button opens the file with the OS default application (via the harness
host.openPath API).
- Turn navigator dot rail — a floating dot rail on the right side of the chat; one dot per conversation turn. Clicking a dot scrolls to that turn.
Requirements
- DeepSeek Harness (
@deepseek-ai/dsh) with the web profile.
Install
Via dsh plugin add (npm package or git URL), or install manually:
- Copy this repo into
$DSH_HOME/profiles/web/node_modules/dsh-turn-tools/.
- Append the contents of
cordis.patch.yml to $DSH_HOME/profiles/web/cordis.patch.yml.
- Restart dsh.
How it works
lib/client.js registers two slots via the slots service:
conversation.chat.turnTail — reads turn.data.get('deliverables') and renders one button per deliverable.shell.overlay — a MutationObserver scans [data-dsh-turn-anchor] elements to build the dot rail.
exports.inject = ['slots'] (cordis service names); connection is fetched lazily via ctx.get('connection') at click time.
FAQ
Buttons / dots don't appear after installing.
- Restart dsh after copying the files — there is no hot reload.
- Check
window.__DSH_BOOT__.entries in the browser console: the dsh-turn-tools entry should be active, with no waiting for services note.
- Deliverable buttons only render on turns that actually produced output files.
How do I uninstall?
- Delete
$DSH_HOME/profiles/web/node_modules/dsh-turn-tools/, remove the turn-tools insert entry from $DSH_HOME/profiles/web/cordis.patch.yml, and restart dsh.
中文
一个 DeepSeek Harness（dsh）web 插件，为聊天界面增加两个工具：
- 每轮产出文件按钮 — 当某轮对话产生输出文件时，在该轮末尾为每个文件渲染一个按钮，点击后调用系统默认程序打开（通过 harness 的
host.openPath API）。
- 轮次导航圆点栏 — 聊天区右侧的浮动圆点栏，每轮对话一个圆点，点击圆点滚动跳转到对应轮次。
前置要求
- DeepSeek Harness（
@deepseek-ai/dsh），使用 web profile。
安装
可通过 dsh plugin add 安装（npm 包或 git URL），或手动安装：
- 将本仓库拷贝到
$DSH_HOME/profiles/web/node_modules/dsh-turn-tools/。
- 将
cordis.patch.yml 的内容追加到 $DSH_HOME/profiles/web/cordis.patch.yml。
- 重启 dsh。
实现说明
lib/client.js 通过 slots 服务注册两个 slot：
conversation.chat.turnTail — 读取 turn.data.get('deliverables')，为每个产出渲染一个按钮。shell.overlay — 用 MutationObserver 扫描 [data-dsh-turn-anchor] 元素构建圆点栏。
exports.inject = ['slots']（cordis 服务名）；connection 在点击时通过 ctx.get('connection') 延迟获取。
常见问题
安装后按钮 / 圆点没有出现？
- 拷贝文件后需要重启 dsh——没有热加载。
- 在浏览器 console 检查
window.__DSH_BOOT__.entries：dsh-turn-tools 条目应为 active，且没有 waiting for services 提示。
- 产出文件按钮只在该轮确实产生了输出文件时才会渲染。
如何卸载？
- 删除
$DSH_HOME/profiles/web/node_modules/dsh-turn-tools/，从 $DSH_HOME/profiles/web/cordis.patch.yml 中移除 turn-tools 的 insert 条目，然后重启 dsh。
License
MIT
