dsh-project-config

从工作区的 .dsh/settings.yml 为 DSH 加载项目级的子代理、命令、MCP 服务器和 hooks。

DSH 自带的只读取项目里的 AGENTS.md 和 .dsh/skills/；子代理、命令、MCP、hooks 只能在全局配置，没法跟着项目走。

安装

dsh plugin --profile desktop add github:RicardoYan/dsh-workspace-trust#v0.1.0
dsh plugin --profile desktop add github:RicardoYan/dsh-project-config#v0.1.1

Web 端把 desktop 换成你的 profile 名（一般是 web）。装完重启 DSH。

卸载：dsh plugin --profile desktop remove dsh-project-config

配置

完整字段、hook 输入输出、从 Claude Code 迁移、常见坑和排查：docs/settings.md。

在工作区根目录放 .dsh/settings.yml（工作区 = 从会话目录往上最近的含 .dsh/settings.yml 或 .git 的目录）：

subagents:
  - toolName: code-reviewer              # 成为一个同名工具
    personaFile: agents/code-reviewer.md # 相对工作区根；frontmatter 的 description 用作用途
    toolFilter: { allow: [read, grep, mcp__github__search_code] }
commands:
  - name: release-notes                # /release-notes
    description: 生成发布说明
    handlerFile: tools/release-notes.mjs   # export default ({ rawInput, agent, workspaceRoot }) => '文本'
mcp:
  - serverName: github                 # 工具名 mcp__github__<工具>
    transport: stdio
    command: npx
    args: ['-y', '@modelcontextprotocol/server-github']
    env: { GITHUB_TOKEN: '${GITHUB_TOKEN}' }   # ${VAR} 取 DSH 进程的环境变量；也可以把 token 明文写进 settings.local.yml
hooks:
  tools/pre-execute:                   # 还支持 tools/post-execute、agent/pre-step、agent/turn-stopping、agent/created、agent/disposed、subagent/start、subagent/end
    - matcher: pwsh|bash
      command: node .dsh/hooks/check.mjs   # 在工作区根执行；stdin 收到 JSON；退出码 2 = 拦截，stderr 作为原因

• 个人配置（MCP 凭据、自己的 hooks）放 .dsh/settings.local.yml，加进 .gitignore：写法相同，同名条目整条覆盖 settings.yml 的，enabled: false 去掉 settings.yml 的同名条目，hooks 接在后面。只有 settings.yml 存在（可以是空文件）时才读取。详见 docs/settings.md §7
• skill 放 .dsh/skills/<名字>/SKILL.md，由 DSH 自己读取
• 子代理、MCP、hooks 对子代理同样生效；子代理共用主会话的 MCP 连接，按自己的 toolFilter 过滤（MCP 工具写全名）
• 子代理再派项目子代理：把对方的名字写进自己的 allow，并且对方的 maxDepth 要够（maxDepth 是它最多能出现在第几层，主会话直接派的是第 1 层）
• DSH 自带的通用 subagent 工具每个子代理都有，toolFilter 管不到它，写不写都一样；嵌套层数由 DSH 的子代理层数上限控制
• /project-config 查看本会话加载了什么、哪些被跳过及原因，以及每个 MCP 服务器的连接状态；/project-config reconnect [名字] 在当前会话里重连 MCP 服务器

安全边界

• 命令、MCP、hooks 会运行项目里的代码，只在工作区已信任时运行；信任由 dsh-workspace-trust 记录。没装它时一律按不信任处理，子代理照常可用
• 配置里的路径只接受相对路径；指向工作区外的（含符号链接）要求已信任，且不在禁止访问列表里
• 有 settings.yml 的工作区只读取自己的 AGENTS.md 和项目 skill，不再继承外层 git 仓库根目录的

注意

• 依赖 DSH 内部接口（agent 事件、dsh-tool-subagent、dsh-mcp-client 的工具定义、DSH 自带的 MCP SDK @modelcontextprotocol/client、dsh-hook-protocol、dsh-skill-filesystem、dsh-agent-instructions），适用于 @deepseek-ai/dsh >=0.2.0-rc.2 <0.3.0-0
• 装上或卸下本插件后，已有会话继续时会多收到一份完整的 AGENTS.md（只一次）
• 改了 settings.yml 或 settings.local.yml，新开的会话生效
• hooks 的 command 由 DSH 的 shell 执行：Windows 上是 PowerShell，带引号的程序路径前要加 &，如 & "C:/Program Files/nodejs/node.exe" check.mjs
• /project-config 和配置告警跟随 DSH 的语言设置，只显示中文或英文；字段名、事件名照原样显示
• 诊断日志：%TEMP%\dsh-project-config.log（超过 1MB 轮转）；MCP 的 url、headers、env 的值不会写进日志和 /project-config

许可证

MIT