dsh- subagent- 文件系统
Dsh 标记下的角色
从代理工作区发现专家角色 agents/*.md 并揭露命名为代表团的工具。 每个Markdown机构成为单独的儿童系统部分,保留Harness指令,应用程序人物a,以及本地权限. 下放的任务仍然是用户内容。 文件仅通过呼叫者的范围读取 ctx.fs,包括远程和沙盒提供商,没有主机文件系统倒置.
安装和配置
dsh plugin --profile my-agent add @amaster.ai/dsh-subagent-filesystem
启用配置文件中的捆绑 cordis.patch.yml数字 :
- id: subagent-filesystem
config:
enabled: true
root: agents
默认禁用 . root 默认为 agents,相对于代理初始工作空间目录;沙盒部署可以明确选择 /agents。发现扫描直接 *.md 仅限孩子 缺少的根会生成一个空目录 。 文件在代理创建时被加载; 创建一个新的代理来取取更改 。 观看和热重装超出了初始范围.
要求 fs, (中文(简体) ), tools, (中文(简体) ), subagents, (中文(简体) ), systemPrompt,以及 sessionQuery 服务,加上注册为 spawn。标准无头剖面可以提供这些能力。 DSH 对等层 : >=0.2.1-rc.2 || >=0.2.2-rc.1; 测试的 DSH : 0.2.2-rc.1; 测试 Cordis : 4.1.0。该版本使用管理激活,需要DSH 02.1-rc.2或更新型;使用插件v0.1.27与DSH0.2.0.
定义格式
agents/inventory-analyst.md数字 :
---
name: inventory-analyst
description: Investigate inventory discrepancies and explain their causes.
---
You are the inventory analyst. Compare posted movements with current balances,
identify discrepancies, and report evidence before recommending changes.
Read references/inventory-rules.md relative to this definition before analysis.
仅 name 财务报告和审定财务报表 description 在YAML前题中支持。 名称必须是小写kebab-case,从字母开始,最多包含55个字符. 描述和身体必须是非空的。 定义必须是有效的UTF-8,最多为 1 MiB. 不支持的字段, 重复 YAML 密钥, 重复角色名称, 和工具名相撞失败 [dsh-subagent-filesystem] 错误。 没有发布部分目录;现有应用工具被保存.
{{…}} 在身体中保持文字状态。 儿童指导包括定义的资源目录. 儿童用自己的工具打开辅助参考文献、脚本和资产,对照该目录解决相对路径问题。 此插件不下载或执行资源 .
代表团
这个例子暴露了 subagent_inventory_analyst;其描述告诉父母何时授权.
| 参数 | 含义 |
|---|---|
prompt | 需要:作为儿童的用户信息提供的完整、自成一体的任务 |
description | 需要: 本地子代理的短任务标签 |
run_in_background | 默认假: 等待报告; 真: 返回可延续的儿童 ID |
背景儿童使用本地毕业通知和 send_message 供采取后续行动。 本地子代理服务保留模型默认,授权深度,沙盒边界,以及批准规则. 定义文件不能覆盖模型、工具或权限。 前景失败成为工具错误; 接受的运行总是到达本地清理 .
命名工具只属于消费的母代理 。 他们不会泄露到其他特工或工作场所,或自动复制给儿童。 A 类 subagent-filesystem/role 会话活动存储孩子的角色说明和资源路径。 冷还原重新安装了原始快照,而不是在源文件改变时更改已存在的角色. 通过耗用应用程序的现有会话存储和访问控制来保护这些指令快照.
卸载取消未完成的代表团,去掉注册和收听者,并释放插件开始的背景儿童. 角色恢复需要插件继续启用. 初始版本支持本地在进程产卵;外部ACP/Codex/Claude供应商和应用配置下载在其范围之外.
测试
pnpm --filter @amaster.ai/dsh-subagent-filesystem test
pnpm --filter @amaster.ai/dsh-subagent-filesystem typecheck
pnpm --filter @amaster.ai/dsh-subagent-filesystem build
.github/scripts/integration/dsh-subagent-filesystem.mjs 自动加入寄存器 E2E 矩阵。 它安装了被打包的捆绑,开始真正的dsh,通过集成模型代表,并验证实际的儿童系统指令,用户任务以及资源文件证据. 一个本地转发网关检查协议请求,因此系统/用户分离独立于模型的主张进行核查.
要求 : DSH_PKG_TARBALL, (中文(简体) ), DSH_INTEGRATION_BASE_URL,以及 DSH_INTEGRATION_API_KEY可选: DSH_CLI, (中文(简体) ), DSH_HOME,以及 DSH_INTEGRATION_MODEL. 用于地方发展 DSH_SUBAGENT_E2E_FAKE=1 用于在运行真实 dsh 、 本地儿童、 文件工具的同时使用决定性信件响应 。 此模式不能验证真模型行为 .