前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」，这允许用户在 web profile 中通过扩展功能来增强界面。在调试或与智能体交互时，快速访问特定轮次生成的文件和导航历史记录通常需要手动复制粘贴或滚动。dsh-turn-tools 作为一个 DSH web 插件，通过为每轮对话添加文件按钮和圆点导航栏来解决这个问题。
插件介绍¶
dsh-turn-tools 是一个由 hu669293657 维护的插件，采用 MIT 许可证。它主要解决两个具体痛点：文件访问和对话导航。
核心功能¶
该插件在 DSH web 界面中增加了两个工具：
-
每轮产出文件按钮
当智能体轮次产生输出文件时，在该轮末尾渲染一个按钮。点击按钮通过系统默认应用程序打开文件（通过 harness 的host.openPathAPI）。 -
轮次导航圆点栏
聊天区右侧的浮动圆点栏，每轮对话一个圆点。点击圆点将滚动跳转到对应轮次。
安装与启用¶
安装可以通过 dsh plugin add 命令完成（使用 npm 包或 git URL），或者按照以下步骤手动安装：
- Copy this repo into
$DSH_HOME/profiles/web/node_modules/dsh-turn-tools/. - Append the contents of
cordis.patch.ymlto$DSH_HOME/profiles/web/cordis.patch.yml. - Restart dsh.
典型用法¶
- 重启 DSH：安装后必须重启 dsh；目前不支持热加载。
- 查看文件：当某轮对话生成输出文件时，按钮会出现在该轮的末尾。点击这些按钮会使用操作系统默认应用程序打开文件。
- 导航历史：点击右侧圆点栏中的圆点会将视图滚动到特定的对话轮次。
适用场景与注意¶
- 渲染限制：产出文件按钮仅在智能体轮次实际生成输出文件时才渲染。
- 调试：如果按钮或圆点没有出现，请检查浏览器控制台中的
window.__DSH_BOOT__.entries。条目dsh-turn-tools应处于活动状态，且不应显示“waiting for services”。 - 实现机制：插件通过
slots服务注册两个插槽：conversation.chat.turnTail（读取turn.data.get('deliverables')）和shell.overlay（使用MutationObserver扫描[data-dsh-turn-anchor]元素）。
结语¶
此插件简化了 DSH web 界面中的文件访问和历史导航。源代码托管在 GitHub 上，许可证为 MIT。通过目录链接可找到更多插件。
