在 DeepSeek Harness (DSH) 的使用场景中,Skill(技能)是定义智能体行为的核心单元。当需要在多个项目中复用特定技能,或者为不同项目定制专属工具集时,传统的全局 Skill 根目录配置显得不够灵活,容易造成配置污染。下面介绍一个能够为每个项目独立管理 Skill 根目录的插件。
dsh-project-skill-paths 是 NeoRrrr 维护的 DeepSeek Harness 插件。它的核心作用是为每个项目配置专属的 Skill 根目录,使技能配置随项目代码库一同管理,实现项目隔离。
核心功能¶
- 项目相对路径配置:支持配置任意数量的项目相对 Skill 根目录。
- 可视化管理:通过 DSH Desktop 的设置卡片添加或移除路径。
- 灵活定位:支持使用
.指代当前 DSH 工作区,或直接选择项目目录。 - 热重载:插件会监听
.dsh/skill-paths.yaml的变化,保存后无需重启 DSH 即可重新加载。 - 默认安全:默认拒绝绝对路径和超出项目边界的
..路径,防止误操作。 - 配置隔离:保持每个项目的配置文件位于项目内部,便于版本控制。
安装与启用¶
安装前请确保环境满足以下要求:DSH 版本 >=0.1.1-rc.2,Node.js 版本为 ^22.19.0 或 >=24.0.0。
在终端执行以下命令进行安装:
dsh plugin --profile desktop add github:NeoRrrr/dsh-project-skill-paths#v0.3.0
安装完成后,需要重启 DSH Desktop。
典型用法¶
- 打开 Settings → Plugins → Plugin configuration → Project Skill Paths。
- 在输入框中输入
.代表当前 DSH 工作区,或点击文件选择器选择一个项目目录。 - 添加或移除 Skill 根目录,然后保存。
- 插件会在检测到的 Git 项目根目录下生成
.dsh/skill-paths.yaml文件。
生成的配置文件格式如下:
# .dsh/skill-paths.yaml
version: 1
skillPaths:
- .codex/skills
- tools/AI/claude/skills
Skill 根目录下的文件命名需符合规范,支持 <skill-name>/SKILL.md 或 <skill-name>.md 格式。
适用场景与注意¶
该插件适合需要在项目内部维护特定 AI 工具链或辅助脚本的场景。
在优先级方面,插件配置的路径使用 Rank 250。这使其优先级高于全局 customSkillDirs,但低于项目内置的 <project>/.dsh/skills (100) 和 <project>/.agents/skills (200)。
安全方面,插件不会读取凭据、发起网络请求或修改 Codex 配置。在保存设置卡片时,插件只会写入当前选定项目的 .dsh/skill-paths.yaml。
结语¶
该插件通过将 Skill 根目录配置下沉到项目层面,简化了多项目环境下的管理复杂度。源码与目录信息可参考下方的链接。