DeepSeek Harness 项目级 Skill 根目录配置插件

在 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。

典型用法

  1. 打开 Settings → Plugins → Plugin configuration → Project Skill Paths。
  2. 在输入框中输入 . 代表当前 DSH 工作区,或点击文件选择器选择一个项目目录。
  3. 添加或移除 Skill 根目录,然后保存。
  4. 插件会在检测到的 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 根目录配置下沉到项目层面,简化了多项目环境下的管理复杂度。源码与目录信息可参考下方的链接。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜