前言¶
DeepSeek Harness (DSH) 采用“一切皆插件”的架构，这意味着为特定任务（如数学研究、数据分析、LaTeX 编辑）配置插件组合需要手动搜索、核验版本和安装，流程繁琐且容易出错。
dsh-autocompose 插件用于解决这一问题。它根据任务描述自动搜索 npm 上的 DSH 插件，核验版本与兼容性，并自动完成安装。在 DSH Desktop 中，它会打开一个独立的 DSH 客户端窗口供继续对话；也可以将插件安装到当前主环境，供后续任务复用。
安装与启用¶
当前版本适配 DSH 0.2.0-rc.2，要求 Node.js >=22.19。
在 DSH Desktop 的插件管理页输入包名安装：
dsh-autocompose@0.5.0
或使用命令行：
dsh plugin --profile desktop add dsh-autocompose@0.5.0 --save-exact --ignore-scripts
Web 宿主用户将 desktop 替换为 web，安装后刷新页面或重启，打开侧边栏的“自组装”。
核心能力¶
任务感知与插件搜索¶
插件根据中文或英文任务描述搜索 npm。它主要检索带有 dsh-plugin 和 deepseek-harness 标签的包。搜索关键词、候选数量和排除原因会保存在方案中，便于后续查看和审计。
自动组装与环境管理¶
组装过程仅使用已有插件，不生成插件代码。它支持两种主要运行模式：
- 独立窗口：在 DSH Desktop 中启动新的客户端实例，每个环境有独立的插件目录、会话和数据。适合需要持续对话的任务。
- 主环境安装：将插件直接安装到当前运行 AutoCompose 的 profile（Desktop 为
desktop，Web 为web），适合长期使用。
隔离执行与无模型开销¶
生成方案和安装插件的过程不调用模型。只有实际执行任务时才会调用模型。独立环境默认只读任务目录，主环境中的插件使用宿主权限。
使用方式¶
Web 界面操作¶
- 输入任务描述和工作目录。
- 选择“自动组装并打开客户端”以启动独立窗口，或选择“自动查找并安装到主环境”。
- 在独立窗口中继续对话，或在主环境查看安装结果。
命令行调用¶
在对话中直接调用工具：
调用 autocompose 的 assemble，为数学研究自动查找兼容插件并安装到当前环境。
调用 autocompose 的 assemble，destination 设为 window，为数学研究组装一个可持续对话的独立环境，直接打开 DSH 客户端。
注意事项与常见问题¶
权限与隔离¶
插件声明的权限仅用于展示和检查，不是对第三方代码的操作系统级隔离。临时任务的“只读”设置不限制主环境插件。
版本与兼容性¶
当前版本适配 DSH 0.2.0-rc.2。安装公开的 AutoCompose 包不需要 npm Token。
常见错误¶
- ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED：通常来自固定到 0.2.0 的旧 Git 提交。建议使用 npm 包名或当前仓库地址安装。
- Failed to replace env in config: ${NPM_TOKEN}：这是 npm 配置变量提示，安装公开包无需处理。
总结¶
dsh-autocompose 通过自动化的方案生成和安装流程，简化了 DSH 插件组合的搭建。它专注于组装已有生态，通过独立窗口或主环境安装两种模式，兼顾了临时任务的隔离性与长期使用的便捷性。
更多细节请参考 GitHub 仓库 或 SkillHub 目录。
