# @amaster\.ai/dsh-subagent-filesystem 中文文档 规范地址：https://npmcn.com/package/%40amaster.ai/dsh-subagent-filesystem/ 版本：0\.1\.42 npm 元数据更新时间：2026-11-07T03:21:42.693Z 中文译文更新时间：2026-11-06T14:17:25.255Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40amaster.ai/dsh-subagent-filesystem 原文对照：https://npmcn.com/package/%40amaster.ai/dsh-subagent-filesystem/?lang=original 项目主页：https://github.com/TGYD-helige/dsh-plugins#readme 源码仓库：https://github.com/TGYD-helige/dsh-plugins ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.8 MB，7 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：^20\.19 \|\| ^22\.12 \|\| \>=24\.0 - 运行依赖：2 个 - peer 依赖：@deepseek-ai/cordis ^4\.0\.4，@deepseek-ai/dsh-fs \>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1，@deepseek-ai/dsh-agent \>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1，@deepseek-ai/dsh-tools \>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1，@deepseek-ai/dsh-session \>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1，@deepseek-ai/dsh-subagent \>=0\.2\.1-rc\.2 \|\| \>=0\.2\.2-rc\.1，@deepseek-ai/dsh-session-query \>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1，@deepseek-ai/dsh-system-prompt \>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1 - 首次发布：2026-10-14T09:21:42.457Z - 最新版本发布：2026-11-07T03:21:42.526Z - 近 30 天下载量：3018（2026-10-06 至 2026-11-04，npm 官方下载统计） - 已发布版本数：21（近 12 个月 21 个） ## 中文简介 通过DSH文件系统发现Markdown专家角色,并通过本地在进程内子代理进行委托. ## 安装 ```sh npm install @amaster.ai/dsh-subagent-filesystem ``` 也可以使用：`pnpm add @amaster.ai/dsh-subagent-filesystem`、`yarn add @amaster.ai/dsh-subagent-filesystem`、`bun add @amaster.ai/dsh-subagent-filesystem` ## README # dsh- subagent- 文件系统 Dsh 标记下的角色 ![dsh-subagent-filesystem preview](https://npmcn.com/package/%40amaster.ai/dsh-subagent-filesystem/preview.png) 从代理工作区发现专家角色 `agents/*.md` 并揭露命名为代表团的工具。 每个Markdown机构成为单独的儿童系统部分,保留Harness指令,应用程序人物a,以及本地权限. 下放的任务仍然是用户内容。 文件仅通过呼叫者的范围读取 `ctx.fs`,包括远程和沙盒提供商,没有主机文件系统倒置. ## 安装和配置 ```sh dsh plugin --profile my-agent add @amaster.ai/dsh-subagent-filesystem ``` 启用配置文件中的捆绑 `cordis.patch.yml`数字 : ```yaml - 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`数字 : ```markdown --- 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供应商和应用配置下载在其范围之外. ## 测试 ```sh 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 、 本地儿童、 文件工具的同时使用决定性信件响应 。 此模式不能验证真模型行为 . ## 常见问题 ### @amaster\.ai/dsh-subagent-filesystem 是什么？ 通过DSH文件系统发现Markdown专家角色,并通过本地在进程内子代理进行委托\. ### 如何安装 @amaster\.ai/dsh-subagent-filesystem？ 在项目目录运行 npm install @amaster\.ai/dsh-subagent-filesystem，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（^4\.0\.4）、@deepseek-ai/dsh-fs（\>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1）、@deepseek-ai/dsh-agent（\>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1）、@deepseek-ai/dsh-tools（\>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1）、@deepseek-ai/dsh-session（\>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1）、@deepseek-ai/dsh-subagent（\>=0\.2\.1-rc\.2 \|\| \>=0\.2\.2-rc\.1）、@deepseek-ai/dsh-session-query（\>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1）、@deepseek-ai/dsh-system-prompt（\>=0\.2\.0-rc\.1 \|\| \>=0\.2\.1-rc\.1 \|\| \>=0\.2\.2-rc\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。 ### @amaster\.ai/dsh-subagent-filesystem 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @amaster\.ai/dsh-subagent-filesystem 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @amaster\.ai/dsh-subagent-filesystem 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js ^20\.19 \|\| ^22\.12 \|\| \>=24\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @amaster\.ai/dsh-subagent-filesystem 可以商用吗？ @amaster\.ai/dsh-subagent-filesystem 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @amaster\.ai/dsh-subagent-filesystem 的下载量有多少？ 根据 npm 官方下载统计，@amaster\.ai/dsh-subagent-filesystem 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,018 次，日均约 101 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @amaster\.ai/dsh-subagent-filesystem 还在维护吗？ 最新版本 0\.1\.42 发布于 2026/11/07（今天）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/10/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。