概览
dsh-roles-zeta
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **preset 仍以整个插件加载,多出的工具由遮罩藏起来。** 只允许 `read` 的 reviewer,保留下来的 `dsh-tool-fs` row 仍会挂上 `write`、`edit`、`read_image`;host plane 的工具(`delegate`、`working_directory`、MCP resource 工具、每个已连接 MCP server 的 `mcp__*` 工具)也仍存在于 preset 之外。两者都到不了 child:逐工具遮罩会藏起 `allow` 没给的每个名称,没有 `allow` 的角色则会失去 `delegate` 与委派工具,除非设了 `delegation: true`。遮罩在 child 创建当下计算,所以之后才注册的允许工具(例如晚一点才连上的 MCP server)对该 child 仍是隐藏的;child 在自己 scope 注册的工具(它的结构化输出工具)则永远不会被遮罩。 - **角色 preset 会和内置 preset 并列。** 它们是普通的 Agent Preset,所以 Web 的 preset 菜单会把它们列在 `standard`、`cordis` 等之后。 - **host 重启后恢复后台 child,需要先有它的 preset。** 角色 preset 是第一次使用时才注册。host 重启前启动的角色 child,在同一个角色从同一个父 preset 再委派一次之前,向它发消息会得到 unknown preset 错误。 - **工具对照表按 dsh 0.2.1-rc.2 建立。** 表里没列的工具插件会整个保留;之后的 dsh 版本若改了工具名,要等表更新才认得。 - **角色改变不了工作区指示链。** 每个 child 与父加载同一条 `AGENTS.md`/`CLAUDE.md` 链。 - **斜杠指令是请求,不是保证。** 委派由模型执行,对话记录会显示它有没有做。 - **设置页改的是文件,不是 session。** 已启动的 child 不受之后的修改影响;下一次启动才读新文件。 - **没有 per-role 记忆。**
