前言¶
在 DeepSeek Harness(DSH)里做具体任务时,往往要把工作目录、系统指令、技能、规范以及 MCP 等能力绑在一起,并在不同会话间复用同一套组合。若只靠手工改配置或零散复制文件,换项目就要重来一遍,能力来源一多也不易统一管理。
下面介绍的 dsh-workbuddy-project(包名与仓库名均为 dsh-workbuddy-project,维护者 matiomlei)面向「按项目组织 DSH 能力」:绑定工作目录与项目指令,选择专家、技能、规范、连接器,保存并编译为 DSH preset;支持项目模板、本地与共享能力库,并对已保存项目锁定能力版本。个人使用不需要团队账号、管理平台或 Git 仓库;Git 同步与贡献则需本机 Git 及仓库访问资格。
这是什么¶
一句话:为 DeepSeek Harness 按项目配置专家、技能、规则与连接器,复用项目模板,并可接入共享能力库。
- 目录页:skillhub.cn 插件页
- 源码与说明:GitHub — matiomlei/dsh-workbuddy-project
- 正式版本:0.3.0(MIT 许可证)
- 运行要求:Node.js >= 22;需兼容
package.json中 peer 依赖范围的 DSH(README 写明本轮验证使用 DSH 0.2.0-rc.2)
Web 界面提供「项目」「能力库」两个设置入口;命令和模型管理工具也支持无界面宿主。
核心功能¶
项目与 preset¶
- 绑定工作目录、项目指令和所选能力,保存并编译为 DSH preset。
- 默认项目注册与编译目录为
<DSH_HOME>/projects;未设置DSH_HOME时使用~/.dsh/projects。可在插件配置中显式指定projectsRoot。 - 工作目录内的项目声明保存在
.dsh/project.json。
专家¶
- 首位专家作为主专家加载;其他专家提供按需方法论卡。
- 专家团按单个入口加载(README 说明:专家卡不代表独立多智能体并行执行)。
完整能力包与能力库¶
- 专家、技能、规范、连接器保留完整目录及附带文件;项目能力选择器展示本地与共享来源。
- 能力库统一展示本地、项目和共享来源,按来源与类型筛选;新建能力默认保存到本地,无需 Git 仓库。
- 顶部共享资源库横栏仅显示已连接库数量与添加按钮,具体配置在弹窗中完成;填写 Git 地址后显示同步设置。
- 固定版本:项目锁定能力内容,资源库同步不会自动升级已保存项目;显式升级后使用新版内容。
连接器¶
- 支持 HTTP/stdio MCP 桥接、本机 DSH 连接器引用和 CLI 包;可检查连接、授权要求与工具发现结果。
- 当前边界:MCP 桥接支持 HTTP 与 stdio,SSE 不支持;OAuth 交互登录尚未实现,可引用已授权的本地 DSH 连接器或使用本机环境变量凭据;CLI 包不自动安装本机命令。
斜杠命令¶
库同步与项目升级是两个动作;保存现有项目保持已锁定版本。
/project list
/project preview <id>
/project apply <id>
/project upgrade <id>
安装与启用¶
安装命令须以仓库 README 为准。从正式 GitHub Release 制品安装:
dsh plugin --profile web add -w https://github.com/matiomlei/dsh-workbuddy-project/releases/download/v0.3.0/dsh-workbuddy-project-0.3.0.tgz
也可从项目仓库指定标签安装:
dsh plugin --profile web add -w github:matiomlei/dsh-workbuddy-project#v0.3.0
从 npm 安装指定正式版本:
dsh plugin --profile web add -w dsh-workbuddy-project@0.3.0
若以 npx 运行 DSH,命令前缀可换为 npx --no-install @deepseek-ai/dsh。安装后重启目标 DSH profile 并刷新界面。
本地打包安装示例:
npm pack
dsh plugin --profile web add -w /absolute/path/dsh-workbuddy-project-0.3.0.tgz
注意:插件在当前 DSH 进程权限下运行;安装前请自行查看源码与 MIT 许可证。发布版与旧开发插件应分别在不同 profile 验证;二者都提供 /project 命令和项目 preset,避免在同一 profile 同时启用。
典型用法¶
第一次使用¶
- 打开 设置 → 项目 → 新建项目,选择已有工作目录并填写项目指令。
- 按需选择专家、技能、规范和连接器;没有能力包时,也可先创建仅含指令的项目。
- 保存并编译;配置连接器的项目可点击「检查连接器」。
- 新建会话,在 preset 选择器中选中该项目。已有会话保留创建时配置。
体验示例模板¶
在 DSH 插件配置中,将 libraries 设为(路径替换为本机实际位置):
[{"name":"examples","path":"/absolute/path/to/dsh-workbuddy-project/examples/library"}]
随后在「项目」新建页面选择「代码评审」或「资料研究」模板。模板自带专家,无外部连接器或凭据依赖。界面添加新 Git 资源库时需要仓库地址;预配置本地示例库无需 Git 同步。
项目模板位于「项目」页。能力库同时发现本地能力、已注册项目自有能力和共享资源库;本地及项目能力可直接保存,外部已安装来源为只读查看。能力包格式与运行约定见仓库文档 docs/capability-packages.md。
适用场景与当前边界¶
适合谁
- 需要在 DSH 里为不同代码库或任务维护固定「工作目录 + 指令 + 能力组合」,并通过 preset 在新会话中一键选用的开发者。
- 希望统一管理本地能力、项目内能力与可选 Git 共享库,且不希望资源库同步悄悄改掉已锁定项目配置的使用者。
当前边界(README 原文要点)
- 共享资源库不提供成员角色、共享对话或任务协作服务。
- 包编辑器「提交为 PR」目前创建并推送 Git 评审分支;不会自动在托管平台建立 PR。
- 发现 WorkBuddy 包不代表导入其账号授权。
结尾¶
dsh-workbuddy-project 把 DSH 的项目级配置、能力包目录结构、连接器检查与版本锁定收进一套 Web 设置与 /project 命令,适合在「一切皆插件」的 DSH 生态里做可复现的项目 preset,而不是每次会话手工拼能力。