前言¶
用 DeepSeek Harness（DSH）跑带流水线的会话时，工作区里往往会有一份 .superworker/ 记录：指令、节点、依赖关系、问题池等。这些数据若只留在磁盘上，人在浏览器里很难对照查看，智能体侧也需要一种稳定方式按记录里的「话语」作答。
dsh-superworker 是 DSH 的客户端类插件：宿主侧读取当前会话工作区里的 .superworker/ 记录并经网关提供给前端，浏览器侧在侧栏绘制 Superworker 工作面板；会话内还可通过面向智能体的 superworker 工具就地响应流水线内容。下面按定位、能力、安装与使用说明。
这是什么¶
- 名称：
dsh-superworker（npm 包名同为dsh-superworker） - 维护者：infraredsqy（作者 Infrareds，仓库 github.com/infraredsqy/dsh-superworker）
- 分类：DSH 插件目录中的「客户端」——在 Web UI 注入侧栏面板，并与宿主逻辑配合读写同一份
.superworker/记录 - 许可证：MIT
- 状态：README 标明处于早期阶段，与 DSH 开发者预览绑定；
.superworker/记录结构仍在快速演进，可能出现破坏性变更
插件不单独提供命令行工具安装到 PATH；面板的写操作由宿主侧（引擎自身的 words 层）就地处理。
核心功能¶
根据仓库 README，安装并选中带有 .superworker/ 记录的工作区会话后，你会得到：
-
Web UI 侧栏 Superworker 面板
界面上的指令、节点详情、「谁欠谁」关系图、问题池等，均来自当前会话工作区的.superworker/记录；面板中的写入也会写回同一位置。 -
会话内的
superworker工具
若工作区已有.superworker/记录，从会话第一步起即可使用该工具，就地回答流水线中的话语。其他工作区则需先加载某个sw-*skill 后才会出现；在此之前，该会话的请求头与未装此插件时一致。 -
DSH 设置中的 Superworker 选项
例如是否显示已归档指令、是否显示已关闭 issue（具体项以设置页为准）。 -
安装校验
可用dsh --profile <name> --dump-config查看配置，确认存在# == dsh-superworker段。
版本与兼容性¶
package.json 中当前版本为 0.1.1-rc.1。manifest 声明 engines.dsh 范围：在 DSH 仍处 0.2.x 的 rc 线内可安装；超出范围时 DSH 会拒绝安装或启动（incompatible-version，另有可选豁免命令）。DSH 进入 0.3 时该范围会随之上调。安装前请对照本机 DSH 版本与插件 Release 说明。
安装与启用¶
前提：已安装 DSH 并具备可写入的 profile；实际使用面板时需有已选中的会话，且该会话工作区包含 .superworker/ 流水线记录。未选中会话时，面板会提示无会话。
插件为预构建包，安装过程不执行构建步骤。从仓库 Releases 下载 .tgz 后执行：
dsh plugin --profile <name> add ./dsh-superworker-<version>.tgz
dsh plugin --profile <name> add dsh-superworker # 同上产物，按 npm 包名安装
若使用 pnpm 时出现若干 missing peer 警告，README 说明相关 peer 由 DSH 本身在运行时提供，一般可忽略。更多发布与从 git 安装的说明见仓库 docs/publish.md（本文不展开 git 安装路径）。
社区目录页：skillhub.cn/plugins/infraredsqy/dsh-superworker。目录站点为社区独立站点，与 DeepSeek / 幻方无官方从属关系。
典型用法¶
- 在目标工作区准备好符合当前形态的
.superworker/记录（结构可能随插件迭代变化，以仓库文档为准）。 - 按上文命令将插件加入指定 profile，并用
--dump-config确认dsh-superworker段已出现。 - 在 DSH Web UI 中打开对应该工作区的会话，在侧栏进入 Superworker，查看地图、指令、问题池等视图；按需修改会写回
.superworker/。 - 在同一会话中，让智能体调用
superworker工具处理流水线中的文本（工作区无记录时需先满足sw-*skill 加载条件）。
未选中会话时面板无法绑定工作区；请先选定会话再操作面板。
适用场景与注意¶
适合：已在 DSH 中使用 Superworker 流水线、需要在浏览器里对照 .superworker/ 记录并回写，同时希望会话内通过 superworker 工具与记录互动的开发者。
注意：
- 插件以当前 DSH 进程权限访问工作区文件；安装前应阅读源码与 MIT 许可证，确认记录路径与敏感内容暴露范围。
- 插件与 DSH 开发者预览、0.2.x rc 线强相关，生产环境升级 DSH 或插件前请核对
engines.dsh与 Release 说明。 .superworker/数据模型仍可能 breaking change，升级插件后宜对照仓库变更说明检查既有记录。- 问题与功能请求可走 GitHub Issues；运行与商务咨询见 README 中的联系邮箱。
结尾¶
dsh-superworker 把 .superworker/ 从「仅存在于工作区目录」变成 DSH 侧栏里可操作的工作面板，并在会话内提供 superworker 工具，使人与智能体围绕同一份流水线记录协作。更多信息见 目录页 与 GitHub 仓库。
