@michengai/dsh-agency-agents 0.1.17 → 0.1.19

package/README.md

@@ -1,14 +1,35 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/branding/dsh-logo.png" width="88" alt="DeepSeek Harness logo">
+<table cellpadding="0" cellspacing="0">
+<tr>
+<td valign="middle" align="center">
+  <img src="assets/branding/dsh-logo.png" alt="DeepSeek Harness logo" width="168">
+</td>
+<td valign="middle">
+<pre>
+   ____  ____  _   _
+  |  _ \/ ___|| | | |
+  | | | \___ \| |_| |
+  | |_| |___) |  _  |
+  |____/|____/|_| |_|
+      AGENCY AGENTS
+271 summonable specialists
+ DeepSeek Harness plugin
+</pre>
+</td>
+</tr>
+</table>
+</div>
+
+<div align="center">
 
   # DSH Agency Agents
 
   **271 summonable specialist agents for DeepSeek Harness**
 
-  [简体中文](README.zh-CN.md) · [Documentation](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
+  [简体中文](README.zh-CN.md) · [Apache-2.0](LICENSE)
 
   [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
-  [![Bundled agents](https://img.shields.io/badge/Bundled%20agents-271-0f766e.svg)](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)
+  [![Bundled agents](https://img.shields.io/badge/Bundled%20agents-271-0f766e.svg)](#features)
   [![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-agency-agents.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-agency-agents)
   [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/MichengAI/dsh-agency-agents)
   [![Node.js 22 or later](https://img.shields.io/badge/Node.js-22%20or%20later-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
@@ -22,20 +43,21 @@
 - Summon enabled experts by name or slug from the composer's **Experts** picker.
 - Use `list_experts` to discover experts and `summon_expert` to start a one-shot specialist subagent.
 - Use 271 bundled personas immediately, or connect a separately synchronized expert directory.
+- Paste one sentence into DSH, Codex, or WorkBuddy and let that agent install the plugin locally.
 
 The parent session keeps task context, judgment, and the final answer. Expert children provide a specialist perspective only and cannot summon further experts.
 
 ## Screenshots
 
-Enable the experts you need in **Settings → Experts**:
+Filter by category or search in **Settings → Experts**, then enable the experts you need:
 
-![DSH Experts panel](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/agent-roster.png)
+![DSH Experts panel](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/agent-roster-en.png)
 
-Open the composer's **Experts** picker and choose an enabled expert:
+Use `@` or the composer's **Experts** picker to choose an enabled expert:
 
 ![Experts picker](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/expert-picker.png)
 
-Then write the complete task with the expert name and slug:
+The name and slug are filled in; write the complete task next:
 
 ![Summoning an expert from the composer](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/summon-prompt.png)
 
@@ -47,20 +69,54 @@ Then write the complete task with the expert name and slug:
 
 ## Installation
 
-### Install from npm
+`dsh plugin add` forwards to `pnpm add` in the profile directory. Without a version and official registry, a local mirror or minimum-release-age policy can leave you on an older build.
+
+### Ask another agent to install it
+
+This plugin runs inside DeepSeek Harness Web. Copy one of the sentences below into DSH, Codex, or WorkBuddy and let that agent install it into your local `web` profile.
+
+From npm:
+
+```text
+Install the latest DSH plugin @michengai/dsh-agency-agents into my local web profile using the official npm registry: dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/. Then run dsh --profile web --dump-config, confirm agency-agents is mounted, and remind me to restart DSH Web and hard-refresh the browser.
+```
+
+From source:
+
+```text
+Install the DSH plugin from source at https://github.com/MichengAI/dsh-agency-agents: clone it, run pnpm install --frozen-lockfile and pnpm build, then run dsh plugin --profile web add . from that directory. Do not copy lib by itself. Then run dsh --profile web --dump-config, confirm agency-agents is mounted, and remind me to restart DSH Web and hard-refresh the browser.
+```
 
-Run this from any PowerShell directory. `dsh plugin` installs the npm package and applies its bundled `cordis.patch.yml`:
+| Product | How to use it |
+| --- | --- |
+| DSH | Send one of the sentences above to the current session. |
+| Codex | Send one of the sentences above to Codex and let it install locally. |
+| WorkBuddy | Send one of the sentences above to WorkBuddy; for a source install you can also paste `https://github.com/MichengAI/dsh-agency-agents`. |
+
+Codex and WorkBuddy only install the plugin. After that, open DSH Web and use **Settings → Experts**.
+
+You can also run the same npm command yourself:
+
+```powershell
+dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/
+```
+
+If `dsh` is not on PATH, replace the leading `dsh` with `npx --yes @deepseek-ai/dsh`.
+
+### Install the latest package from the official npm registry
+
+Run this from any PowerShell directory:
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-dsh plugin --profile web add @michengai/dsh-agency-agents
+dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/
 dsh --profile web --dump-config
 ```
 
-The configuration output should contain `agency-agents` and `agency-agents-remote`. Restart DSH Web and hard-refresh the browser. Do not copy client files manually: the Settings page needs the mounted Remote service.
+To pin a release, replace `@latest` with a version such as `@0.1.17`.
 
-If a package mirror has not synchronized the latest version, append `--registry=https://registry.npmjs.org/`.
+The configuration output should contain `agency-agents` and `agency-agents-remote`. Restart DSH Web and hard-refresh the browser. Do not copy client files manually: the Settings page needs the mounted Remote service.
 
 ### Install from source
 
@@ -83,7 +139,7 @@ Restart DSH Web and hard-refresh the browser. `dsh plugin ... add .` reads the p
 ## Usage
 
 1. Open **Settings → Experts** and enable the needed experts.
-2. Open the composer's **Experts** picker and choose an enabled expert.
+2. Use `@` or the composer **Experts** picker to choose an enabled expert.
 3. Name the expert and slug, then provide the complete task.
 
 ```text
@@ -101,7 +157,7 @@ The parent session can also call `list_experts(division?)`, then delegate with `
 | `divisions` | 17 standard divisions | Top-level divisions to scan. |
 | `maxDepth` | Unset | Positive absolute subagent-depth limit. |
 
-Set `AGENCY_AGENTS_ROOT` to use an external expert directory. The provider must support persona and tool filtering.
+Set `AGENCY_AGENTS_ROOT` to use an external expert directory. Persona bodies from that directory are injected as the child system prompt, so load them only from a trusted source. The provider must support persona and tool filtering. `summon_experts` accepts at most 8 experts with a concurrency of 4 and still returns successful answers when some experts fail.
 
 ## Secondary development
 
@@ -121,7 +177,9 @@ pnpm verify
 dsh plugin --profile web add .
 ```
 
-The published package includes `lib`, `assets`, the patch, and documentation only. Do not publish `node_modules` or local development files.
+Handoff and iteration notes stay in the local `docs` directory and are not tracked in Git; a fresh clone will not include that handover entry.
+
+The published package includes `lib`, `assets`, the patch, and the root README/license files. Do not publish `node_modules` or local development files.
 
 ## Validation
 
@@ -138,3 +196,4 @@ pnpm verify
 ## License and attribution
 
 This project’s TypeScript source, build scripts, and documentation use [Apache License 2.0](LICENSE). Bundled personas originate from [The Agency](https://github.com/msitarzewski/agency-agents) and remain MIT-licensed; see [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE).
+

package/README.zh-CN.md

@@ -1,14 +1,35 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/branding/dsh-logo.png" width="88" alt="DeepSeek Harness 标识">
+<table cellpadding="0" cellspacing="0">
+<tr>
+<td valign="middle" align="center">
+  <img src="assets/branding/dsh-logo.png" alt="DeepSeek Harness 标识" width="168">
+</td>
+<td valign="middle">
+<pre>
+   ____  ____  _   _
+  |  _ \/ ___|| | | |
+  | | | \___ \| |_| |
+  | |_| |___) |  _  |
+  |____/|____/|_| |_|
+      AGENCY AGENTS
+271 summonable specialists
+ DeepSeek Harness plugin
+</pre>
+</td>
+</tr>
+</table>
+</div>
+
+<div align="center">
 
   # DSH Agency Agents
 
   **为 DeepSeek Harness 提供 271 名可召唤的专业智能体**
 
-  [English](README.md) · [完整文档](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
+  [English](README.md) · [Apache-2.0](LICENSE)
 
   [![许可证：Apache-2.0](https://img.shields.io/badge/许可证-Apache--2.0-blue.svg)](LICENSE)
-  [![内置智能体](https://img.shields.io/badge/内置智能体-271-0f766e.svg)](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)
+  [![内置智能体](https://img.shields.io/badge/内置智能体-271-0f766e.svg)](#功能概览)
   [![npm package](https://img.shields.io/npm/v/%40michengai%2Fdsh-agency-agents.svg?label=npm%20package)](https://www.npmjs.com/package/@michengai/dsh-agency-agents)
   [![DSH Web Plugin](https://img.shields.io/badge/DSH%20Web-Plugin-0f766e.svg)](https://github.com/MichengAI/dsh-agency-agents)
   [![Node.js 22 or later](https://img.shields.io/badge/Node.js-22%20or%20later-339933.svg?logo=node.js&logoColor=white)](https://nodejs.org/)
@@ -22,20 +43,21 @@
 - 在输入框的「专家」中按名称或 slug 召唤已启用的专家处理完整任务。
 - 提供 `list_experts` 与 `summon_expert` 工具，分别用于发现专家和启动一次性子代理。
 - 内置 271 份 persona，无需额外下载；也可接入自行同步的专家目录。
+- 可把一句话复制到 DSH、Codex 或 WorkBuddy，让对方代装到本机 DSH。
 
 主会话保留任务上下文、判断和最终交付；专家子代理只提供专业视角，不能继续召唤专家，避免递归委派。
 
 ## 界面预览
 
-在「设置 → 专家」中启用需要的专家：
+在「设置 → 专家」中按分类筛选或搜索，再启用需要的专家：
 
 ![DSH 专家面板](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/agent-roster.png)
 
-在输入框点击「专家」，选择已启用的专家：
+在输入框用 `@` 或「专家」选择已启用的专家：
 
 ![专家选择器](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/expert-picker.png)
 
-再用名称和 slug 写出完整任务：
+回填名称和 slug 后，写出完整任务：
 
 ![召唤专家的输入方式](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/summon-prompt.png)
 
@@ -47,20 +69,54 @@
 
 ## 安装
 
-### 从 npm 安装
+`dsh plugin add` 会转发到 profile 目录里的 `pnpm add`。不写版本、不指定官方源时，本机镜像和最短发布间隔可能让你停在旧版。
+
+### 交给其他 Agent 一句话安装
+
+本插件运行在 DeepSeek Harness Web 里。把下面其中一句复制到 DSH、Codex 或 WorkBuddy，让它代你安装到本机 `web` profile。
+
+从 npm 安装：
+
+```text
+请把 DSH 插件 @michengai/dsh-agency-agents 最新版装进本机 web profile，使用官方 npm 源执行：dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/。装完执行 dsh --profile web --dump-config，确认已挂载 agency-agents，并提醒我重启 DSH Web 后硬刷新浏览器。
+```
+
+从源码安装：
+
+```text
+请从源码安装 DSH 插件 https://github.com/MichengAI/dsh-agency-agents：克隆到本机后执行 pnpm install --frozen-lockfile 和 pnpm build，再用 dsh plugin --profile web add . 把当前目录装进 web profile。不要只复制 lib。装完执行 dsh --profile web --dump-config，确认已挂载 agency-agents，并提醒我重启 DSH Web 后硬刷新浏览器。
+```
 
-在任意 PowerShell 目录执行。`dsh plugin` 会安装 npm 包并自动应用包内的 `cordis.patch.yml`：
+| 产品 | 怎么用 |
+| --- | --- |
+| DSH | 把上面其中一句发给当前会话。 |
+| Codex | 把上面其中一句发给 Codex，让它在本机执行安装。 |
+| WorkBuddy | 把上面其中一句发给 WorkBuddy；源码安装也可同时粘贴仓库地址 `https://github.com/MichengAI/dsh-agency-agents`。 |
+
+Codex 和 WorkBuddy 只负责代装；装好后仍要打开 DSH Web 使用「设置 → 专家」。
+
+也可以自己执行同一条 npm 命令：
+
+```powershell
+dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/
+```
+
+未把 `dsh` 装进 PATH 时，把开头的 `dsh` 换成 `npx --yes @deepseek-ai/dsh`。
+
+### 从官方 npm 安装最新版
+
+在任意 PowerShell 目录执行：
 
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-dsh plugin --profile web add @michengai/dsh-agency-agents
+dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/
 dsh --profile web --dump-config
 ```
 
-配置输出中应包含 `agency-agents` 与 `agency-agents-remote`。安装后重启 DSH Web 并在浏览器硬刷新；请勿手工复制客户端文件，否则设置页所需的 Remote 服务不会被挂载。
+需要钉死某一版时，把 `@latest` 换成具体版本，例如 `@0.1.17`。
 
-若镜像未同步最新版本，可在安装命令末尾追加 `--registry=https://registry.npmjs.org/`。
+配置输出中应包含 `agency-agents` 与 `agency-agents-remote`。安装后重启 DSH Web 并在浏览器硬刷新；请勿手工复制客户端文件，否则设置页所需的 Remote 服务不会被挂载。
 
 ### 从源码安装
 
@@ -83,7 +139,7 @@ dsh --profile web --dump-config
 ## 使用
 
 1. 打开「设置 → 专家」，启用需要的专家。
-2. 在对话输入框点击「专家」，选择已启用的专家。
+2. 在对话输入框用 `@` 或点击「专家」，选择已启用的专家。
 3. 用名称和 slug 明确指定专家，并给出完整任务。例如：
 
 ```text
@@ -101,7 +157,7 @@ dsh --profile web --dump-config
 | `divisions` | 17 个标准分区 | 需要扫描的顶层分区。 |
 | `maxDepth` | 未设置 | 正整数形式的绝对子代理深度上限。 |
 
-也可设置 `AGENCY_AGENTS_ROOT` 环境变量指定外部专家目录。子代理 provider 必须支持 persona 和工具过滤能力。
+也可设置 `AGENCY_AGENTS_ROOT` 环境变量指定外部专家目录。外部目录里的 persona 正文会注入为子代理系统提示，只应从可信来源加载。子代理 provider 必须支持 persona 和工具过滤能力。`summon_experts` 一次最多 8 名专家，并发 4，部分失败仍返回成功结果。
 
 ## 二次开发
 
@@ -121,7 +177,9 @@ pnpm verify
 dsh plugin --profile web add .
 ```
 
-发布包只包含 `lib`、`assets`、补丁和文档；不要将 `node_modules` 或本地开发文件加入发布内容。
+交接与迭代文档只保留在本机 `docs` 目录，不纳入 Git；克隆仓库后不会得到交接入口。
+
+发布包只包含 `lib`、`assets`、补丁和根目录说明/许可证；不要将 `node_modules` 或本地开发文件加入发布内容。
 
 ## 验证
 
@@ -138,3 +196,4 @@ pnpm verify
 ## 许可证与归属
 
 本项目 TypeScript 源码、构建脚本和文档采用 [Apache License 2.0](LICENSE)。内置专家 persona 源自 [The Agency](https://github.com/msitarzewski/agency-agents)，仍采用 MIT，许可证位于 [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE)。
+

package/assets/branding/banner.svg

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="640" height="240" viewBox="0 0 640 240" role="img" aria-label="DSH Agency Agents">
+  <rect width="640" height="240" rx="8" fill="#0d1117" stroke="#30363d" stroke-width="1"/>
+  <line x1="320" y1="12" x2="320" y2="228" stroke="#30363d" stroke-width="1"/>
+  <rect x="88" y="24" width="72" height="12" fill="#e6edf3"/>
+  <rect x="196" y="24" width="24" height="12" fill="#e6edf3"/>
+  <rect x="64" y="36" width="96" height="12" fill="#e6edf3"/>
+  <rect x="196" y="36" width="36" height="12" fill="#e6edf3"/>
+  <rect x="268" y="36" width="24" height="12" fill="#e6edf3"/>
+  <rect x="52" y="48" width="120" height="12" fill="#e6edf3"/>
+  <rect x="208" y="48" width="84" height="12" fill="#e6edf3"/>
+  <rect x="40" y="60" width="144" height="12" fill="#e6edf3"/>
+  <rect x="208" y="60" width="72" height="12" fill="#e6edf3"/>
+  <rect x="28" y="72" width="168" height="12" fill="#e6edf3"/>
+  <rect x="220" y="72" width="48" height="12" fill="#e6edf3"/>
+  <rect x="28" y="84" width="24" height="12" fill="#e6edf3"/>
+  <rect x="76" y="84" width="168" height="12" fill="#e6edf3"/>
+  <rect x="28" y="96" width="24" height="12" fill="#e6edf3"/>
+  <rect x="100" y="96" width="72" height="12" fill="#e6edf3"/>
+  <rect x="184" y="96" width="60" height="12" fill="#e6edf3"/>
+  <rect x="28" y="108" width="24" height="12" fill="#e6edf3"/>
+  <rect x="124" y="108" width="60" height="12" fill="#e6edf3"/>
+  <rect x="196" y="108" width="48" height="12" fill="#e6edf3"/>
+  <rect x="28" y="120" width="24" height="12" fill="#e6edf3"/>
+  <rect x="136" y="120" width="48" height="12" fill="#e6edf3"/>
+  <rect x="196" y="120" width="48" height="12" fill="#e6edf3"/>
+  <rect x="28" y="132" width="36" height="12" fill="#e6edf3"/>
+  <rect x="148" y="132" width="84" height="12" fill="#e6edf3"/>
+  <rect x="40" y="144" width="24" height="12" fill="#e6edf3"/>
+  <rect x="148" y="144" width="84" height="12" fill="#e6edf3"/>
+  <rect x="40" y="156" width="36" height="12" fill="#e6edf3"/>
+  <rect x="112" y="156" width="24" height="12" fill="#e6edf3"/>
+  <rect x="160" y="156" width="60" height="12" fill="#e6edf3"/>
+  <rect x="52" y="168" width="36" height="12" fill="#e6edf3"/>
+  <rect x="112" y="168" width="36" height="12" fill="#e6edf3"/>
+  <rect x="172" y="168" width="48" height="12" fill="#e6edf3"/>
+  <rect x="64" y="180" width="108" height="12" fill="#e6edf3"/>
+  <rect x="184" y="180" width="48" height="12" fill="#e6edf3"/>
+  <rect x="76" y="192" width="108" height="12" fill="#e6edf3"/>
+  <rect x="112" y="204" width="48" height="12" fill="#e6edf3"/>
+  <g font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" fill="#e6edf3" text-anchor="middle">
+    <text x="480" y="51" font-size="13" xml:space="preserve">  _____   _____ _    _</text>
+    <text x="480" y="67" font-size="13" xml:space="preserve"> |  __ \ / ____| |  | |</text>
+    <text x="480" y="83" font-size="13" xml:space="preserve"> | |  | | (___ | |__| |</text>
+    <text x="480" y="99" font-size="13" xml:space="preserve"> | |  | |\___ \|  __  |</text>
+    <text x="480" y="115" font-size="13" xml:space="preserve"> | |__| |____) | |  | |</text>
+    <text x="480" y="131" font-size="13" xml:space="preserve"> |_____/|_____/|_|  |_|</text>
+    <text x="480" y="161" font-size="12" font-weight="700">AGENCY AGENTS</text>
+    <text x="480" y="179" font-size="12">271 summonable specialists</text>
+    <text x="480" y="197" font-size="12">DeepSeek Harness plugin</text>
+  </g>
+</svg>

package/assets/branding/banner.txt

@@ -0,0 +1,11 @@
+README 左侧使用 assets/branding/dsh-logo.png（宽 168，不随表格均分撑开）
+右侧字符：
+
+   ____  ____  _   _
+  |  _ \/ ___|| | | |
+  | | | \___ \| |_| |
+  | |_| |___) |  _  |
+  |____/|____/|_| |_|
+      AGENCY AGENTS
+271 summonable specialists
+ DeepSeek Harness plugin

package/lib/{i18n-x9V6Ga4d.js → i18n-BL3miiHZ.js}

@@ -333,6 +333,12 @@ const zhHost = {
 	"error.summonRequiresAgent": "summon_expert 需要由智能体调用",
 	"error.summonManyRequiresAgent": "summon_experts 需要由智能体调用",
 	"error.expertsEmpty": "experts 必须是非空数组",
+	"error.expertsTooMany": "一次最多召唤 {max} 名专家，当前为 {count}",
+	"error.expertEmpty": "第 {index} 个专家不能为空",
+	"error.taskEmpty": "第 {index} 个专家任务不能为空",
+	"error.taskTooLong": "第 {index} 个专家任务过长（{length} 个字符，上限 {max}）",
+	"error.taskRequired": "专家任务不能为空",
+	"error.taskLimit": "专家任务过长（{length} 个字符，上限 {max}）",
 	"error.providerMissing": "子代理 provider \"{provider}\" 未注册",
 	"error.providerNoPersona": "子代理 provider \"{provider}\" 不支持专家人格",
 	"error.providerNoToolFilter": "子代理 provider \"{provider}\" 无法阻止递归专家委派",
@@ -344,7 +350,8 @@ const zhHost = {
 	"list.empty": "暂无可用专家。",
 	"list.emptyDivision": "没有匹配分区 \"{division}\" 的专家。",
 	"list.heading": "{total} 位专家，覆盖 {count} 个分区：",
-	"list.group": "## {division}（{count}）"
+	"list.group": "## {division}（{count}）",
+	"list.expertFailed": "失败：{error}"
 };
 /** 英文宿主文案，key 完整性由 satisfies 在编译期保证。 */
 const enHost = {
@@ -359,6 +366,12 @@ const enHost = {
 	"error.summonRequiresAgent": "summon_expert requires a calling agent",
 	"error.summonManyRequiresAgent": "summon_experts requires a calling agent",
 	"error.expertsEmpty": "experts must be a non-empty array",
+	"error.expertsTooMany": "summon at most {max} experts at once, got {count}",
+	"error.expertEmpty": "expert #{index} must not be empty",
+	"error.taskEmpty": "expert task #{index} must not be empty",
+	"error.taskTooLong": "expert task #{index} is too long ({length} characters, limit {max})",
+	"error.taskRequired": "The expert task must not be empty",
+	"error.taskLimit": "The expert task is too long ({length} characters, limit {max})",
 	"error.providerMissing": "subagent provider \"{provider}\" is not registered",
 	"error.providerNoPersona": "subagent provider \"{provider}\" does not support expert personas",
 	"error.providerNoToolFilter": "subagent provider \"{provider}\" cannot prevent recursive expert delegation",
@@ -370,7 +383,8 @@ const enHost = {
 	"list.empty": "No experts available.",
 	"list.emptyDivision": "No experts matched division \"{division}\".",
 	"list.heading": "{total} experts across {count} divisions:",
-	"list.group": "## {division} ({count})"
+	"list.group": "## {division} ({count})",
+	"list.expertFailed": "Failed: {error}"
 };
 /** 将未知值收成 zh / en；只有显式 en 才走英文。 */
 function resolveHostLocale(value) {
@@ -438,5 +452,12 @@ function renderExpertList(locale, args, value) {
 	}));
 	return lines.join("\n");
 }
+/** 渲染批量召唤结果：成功项输出答案，失败项输出本地化失败句。 */
+function renderSummonResults(locale, results) {
+	return results.map((item) => {
+		const body = item.ok ? item.answer : formatHost(locale, "list.expertFailed", { error: item.error ?? "" });
+		return "## " + item.expert + "\n" + body;
+	}).join("\n\n");
+}
 //#endregion
-export { readHostLocale as a, ZH_NAME as c, matchDivision as i, localizedExpertDescription as n, renderExpertList as o, localizedExpertName as r, ZH_DIVISION as s, formatHost as t };
+export { readHostLocale as a, ZH_DIVISION as c, matchDivision as i, ZH_NAME as l, localizedExpertDescription as n, renderExpertList as o, localizedExpertName as r, renderSummonResults as s, formatHost as t };

package/lib/index.d.ts

@@ -1,6 +1,10 @@
 import z from "@deepseek-ai/schemastery";
 import "@deepseek-ai/dsh-settings";
 import { Context } from "@deepseek-ai/cordis";
+//#region src/names.d.ts
+/** 智能体 slug（文件名去 .md）→ 中文名（现实岗位）。缺省时回退英文 frontmatter name。 */
+declare const ZH_NAME: Readonly<Record<string, string>>;
+//#endregion
 //#region src/i18n.d.ts
 /** 与 DSH locale 插件一致的语言标识。 */
 type LocaleId = 'zh' | 'en';
@@ -8,6 +12,33 @@ type LocaleId = 'zh' | 'en';
 //#region src/index.d.ts
 declare const name = "agency-agents";
 declare const inject: string[];
+/** 一次批量召唤的专家数量上限，避免无界并行拖垮宿主。 */
+declare const SUMMON_EXPERTS_MAX = 8;
+/** 批量召唤的并发上限。 */
+declare const SUMMON_EXPERTS_CONCURRENCY = 4;
+/** 单条任务的 Unicode 码点上限。 */
+declare const SUMMON_TASK_MAX_CHARS = 8000;
+/** 已校验的批量召唤条目。 */
+interface SummonExpertSpec {
+  readonly expert: unknown;
+  readonly task: string;
+}
+/** 批量召唤中单个专家的结果。 */
+interface SummonExpertItemResult {
+  readonly expert: string;
+  readonly ok: boolean;
+  readonly answer: string;
+  readonly error?: string;
+}
+/** 校验批量召唤入参：非空、数量上限、专家名非空、任务非空且不超过码点上限。 */
+declare function validateSummonSpecs(specs: unknown, locale: LocaleId): SummonExpertSpec[];
+/** 受限并发地映射异步任务，结果顺序与输入一致。 */
+declare function mapPool<T, R>(items: readonly T[], concurrency: number, mapper: (item: T, index: number) => Promise<R>): Promise<R[]>;
+/** 把单次专家运行结果收成批量条目；失败时保留原始查询作为专家名。 */
+declare function toSummonItemResult(query: unknown, result: {
+  expert: string;
+  answer: string;
+} | Error): SummonExpertItemResult;
 /** One resolved expert ready to be summoned. */
 interface Expert {
   readonly slug: string;
@@ -61,4 +92,4 @@ declare function resolveExpert<T extends {
 }>(experts: readonly T[], query: unknown, locale?: LocaleId): T;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { Config, apply, inject, loadCatalog, name, parseFrontmatter, resolveCatalogRoot, resolveExpert, sanitize, stripBom, truncate, unquote };
+export { Config, SUMMON_EXPERTS_CONCURRENCY, SUMMON_EXPERTS_MAX, SUMMON_TASK_MAX_CHARS, SummonExpertItemResult, SummonExpertSpec, ZH_NAME, apply, inject, loadCatalog, mapPool, name, parseFrontmatter, resolveCatalogRoot, resolveExpert, sanitize, stripBom, toSummonItemResult, truncate, unquote, validateSummonSpecs };