工具技能分项目管理 ZeaoZhang/dsh-tool-skill-manager

工具/技能管理 · Tools & Skills

DeepSeek Harness 插件包，按项目管理工具与技能。

配置档级的 disabledTools / disabledSkills 列表仍是默认值。每个项目可以再覆盖单条记录——继承、强制开启、强制关闭——不用改配置档，也不影响其他项目。

插件不在此管理范围内：DeepSeek Harness 启动时一次性组合插件树，第三方插件无法按项目卸载。请到「设置 → 插件」管理已安装的插件；需要按项目扩展能力时，把工具/技能注册到项目自身的技能目录或 Agent 预设中。

安装

- id: tool-skill-manager
name: '@local/tool-skill-manager'
config:
disabledTools: [] # profile default
disabledSkills: []
projects: {} # per-project overrides

id 必须唯一且可寻址：设置页通过 configEditor 持久化，它拒绝写入无法明确寻址的条目。

配置

| 字段 | 含义 |
| disabledTools | 对所有项目全局禁用的工具名（配置档默认值） |
| disabledSkills | 对所有项目全局禁用的技能名 |
| projects.<absolute root>.tools.<name> | true 强制开启，false 强制关闭；省略则继承 |
| projects.<absolute root>.skills.<name> | 技能的覆盖语义相同 |

项目边界取会话工作目录最近的祖先目录，该目录需包含 .git 标记——dsh-skill-filesystem 确定项目技能根目录时用的也是这条规则，找不到就回退到工作目录本身。

- id: tool-skill-manager
name: '@local/tool-skill-manager'
config:
disabledTools: [weather]
disabledSkills: []
projects:
/Users/me/code/my-app:
tools:
weather: true # force this tool on for this project
code_interpreter: false
skills:
deploy: false

覆盖配置只存在本机：它们写在当前配置档的补丁里，不进项目仓库。

设置页

设置 → 插件 → 工具/技能管理（Tools & Skills）。

- 范围选择器 —— Profile defaults 或任一在线/已配置的项目。Add project… 注册绝对路径；Remove project 删除该项目的覆盖配置。
- 工具 / 技能标签页 —— 搜索、逐行开关、批量启用/禁用，项目范围下还有三态覆盖：继承、强制开启、强制关闭。
- 技能页额外显示来源调用策略，项目范围下还有「只保留此项」操作。
- 每次 working-directory/change 都会重新评估会话：把会话移到另一个检出目录，它的工具限制和技能叠加层立即切换。

生效机制

- 工具 —— 项目生效策略会变成每个智能体的 tools.restrict({ deny })；插件一注册这些名字就立即拒绝，禁用的工具永远到不了模型。
- 技能 —— 每个智能体的服务商把禁用条目叠加为不可调用（目录保持稳定），skill 工具的守卫会拒绝加载它们。

开发

npm test # node --test test/*.test.js
测试使用伪造的 Cordis 上下文，覆盖以下场景：按智能体限制工具、技能叠加与守卫、工作目录切换、项目覆盖、项目注册与移除，以及路由校验。

限制

- 只列出全局注册的工具；预设或其他插件注册的智能体级工具由各自的组合管理。
- 技能来自 Harness 工作区目录，加上项目根目录（<project>/.dsh/skills、<project>/.agents/skills）。
- 配置档插件在启动时组合，有意不在本文范围内。

许可证

MIT