在 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 根目錄配置下沉到項目層面，簡化了多項目環境下的管理複雜度。源碼與目錄信息可參考下方的鏈接。
