@michengai/dsh-agency-agents 0.1.4 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +79 -38
  2. package/README.zh-CN.md +78 -37
  3. package/lib/client.js +2 -1
  4. package/package.json +1 -1
package/README.md CHANGED
@@ -5,79 +5,120 @@
5
5
 
6
6
  **271 summonable specialist agents for DeepSeek Harness**
7
7
 
8
- [中文](README.zh-CN.md) · [Documentation](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
8
+ [简体中文](README.zh-CN.md) · [Documentation](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
9
9
 
10
10
  [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
11
11
  [![Bundled agents](https://img.shields.io/badge/Bundled%20agents-271-0f766e.svg)](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)
12
12
  </div>
13
13
 
14
- `dsh-agency-agents` is a DeepSeek Harness (DSH) plugin. The parent session keeps task context, judgment, and final synthesis; it can delegate a complete task to a one-shot subagent with a persona from The Agency.
14
+ > DSH Agency Agents is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product.
15
15
 
16
- ## Use it in DSH
16
+ ## Features
17
17
 
18
- Browse and enable agents in the **Agents** settings panel. The plugin exposes the bundled agents by division, alongside their names, descriptions, and enabled state.
18
+ - Browse, enable, and disable bundled experts across 17 divisions in **Settings → Agents**.
19
+ - Summon enabled experts by name or slug from the composer’s **Agent** mode.
20
+ - Use `list_experts` to discover experts and `summon_expert` to start a one-shot specialist subagent.
21
+ - Use 271 bundled personas immediately, or connect a separately synchronized expert directory.
19
22
 
20
- ![DSH Agents panel](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/agent-roster.png)
23
+ The parent session keeps task context, judgment, and the final answer. Expert children provide a specialist perspective only and cannot summon further experts.
21
24
 
22
- Choose **Agent** mode in the chat composer, then identify the agent by name and slug. For example:
25
+ ## Prerequisites
23
26
 
24
- ```text
25
- Summon the "Code Review Engineer" agent (engineering-code-reviewer) for this task:
26
- Review the changes in the current workspace and list reproducible issues by severity.
27
- ```
27
+ - A working DeepSeek Harness Web installation with `dsh` available in PowerShell.
28
+ - Examples use the `web` profile; replace it with the target profile.
29
+ - Source installation and development require Node.js 22+ and pnpm. npm installation does not require running `pnpm install` separately.
28
30
 
29
- ![Summoning an agent from the composer](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/summon-prompt.png)
31
+ ## Installation
32
+
33
+ ### Install from npm
34
+
35
+ Run this from any PowerShell directory. `dsh plugin` installs the npm package and applies its bundled `cordis.patch.yml`:
36
+
37
+ ```powershell
38
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
39
+ $OutputEncoding = [System.Text.Encoding]::UTF8
40
+ dsh plugin --profile web add @michengai/dsh-agency-agents
41
+ dsh --profile web --dump-config
42
+ ```
30
43
 
31
- ## How it works
44
+ 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.
32
45
 
33
- | Stage | Parent session and plugin responsibility |
34
- | --- | --- |
35
- | Discover | `list_experts(division?)` returns compact division counts, or expands one division. |
36
- | Delegate | `summon_expert(expert, task)` starts a one-shot subagent by slug or unique name. |
37
- | Deliver | The subagent returns its specialist result; the parent session applies the original context and produces the final response. |
46
+ If a package mirror has not synchronized the latest version, append `--registry=https://registry.npmjs.org/`.
38
47
 
39
- - 271 agent personas are bundled; no external directory is required after installation.
40
- - Configure `root`, or set `AGENCY_AGENTS_ROOT`, to use a separately synchronized agent directory.
41
- - Agent children cannot call `summon_expert` or `list_experts`, preventing recursive delegation and unnecessary roster browsing.
42
- - `spawn` and `fork` are supported when the provider supports persona and tool filtering.
48
+ ### Install from source
43
49
 
44
- ## Install
50
+ Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
45
51
 
46
52
  ```powershell
47
53
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
48
54
  $OutputEncoding = [System.Text.Encoding]::UTF8
49
- dsh plugin --profile default add @michengai/dsh-agency-agents
50
- dsh --profile default --dump-config
55
+ Set-Location D:\Repository\deepseek-harness-plugin
56
+ git clone https://github.com/MichengAI/dsh-agency-agents.git
57
+ Set-Location .\dsh-agency-agents
58
+ pnpm install --frozen-lockfile
59
+ pnpm build
60
+ dsh plugin --profile web add .
61
+ dsh --profile web --dump-config
51
62
  ```
52
63
 
53
- Replace `default` with the target profile. The second command should show both `agency-agents` and `agency-agents-remote`; the latter is the Host Remote service used by the settings page. Install through `dsh plugin`: copying only client files without applying `cordis.patch.yml` leaves that Remote unavailable. For local development, replace the package name with `.`.
64
+ Restart DSH Web and hard-refresh the browser. `dsh plugin ... add .` reads the package metadata and `cordis.patch.yml`; do not install by copying `lib` directly.
54
65
 
55
- ## Configuration
66
+ ## Usage
56
67
 
57
- | Key | Default | Meaning |
68
+ 1. Open **Settings → Agents** and enable the needed experts.
69
+ 2. Select **Agent** mode in the composer.
70
+ 3. Name the expert and slug, then provide the complete task.
71
+
72
+ ```text
73
+ Summon the "Code Review Engineer" agent (engineering-code-reviewer) for this task:
74
+ Review the changes in the current workspace and list reproducible issues by severity.
75
+ ```
76
+
77
+ The parent session can also call `list_experts(division?)`, then delegate with `summon_expert(expert, task)`. Use a slug when a name is ambiguous.
78
+
79
+ ## Configuration and limits
80
+
81
+ | Key | Default | Purpose |
58
82
  | --- | --- | --- |
59
- | `root` | Bundled agent assets | External agent root; an explicit value overrides bundled assets. |
60
- | `provider` | `spawn` | DSH subagent provider. |
61
- | `divisions` | All 17 standard divisions | Top-level divisions to scan. |
62
- | `maxDepth` | Unset | Optional positive absolute child-depth cap; the provider must support depth limiting. |
83
+ | `root` | Bundled expert assets | External expert root; an explicit value takes priority. |
84
+ | `provider` | `spawn` | DSH subagent provider; `fork` also works when it supports persona and tool filtering. |
85
+ | `divisions` | 17 standard divisions | Top-level divisions to scan. |
86
+ | `maxDepth` | Unset | Positive absolute subagent-depth limit. |
63
87
 
64
- ## Bundled source and licensing
88
+ Set `AGENCY_AGENTS_ROOT` to use an external expert directory. The provider must support persona and tool filtering.
65
89
 
66
- The bundled agent personas originate from [The Agency](https://github.com/msitarzewski/agency-agents) and are copyrighted by AgentLand Contributors. The snapshot and its original license are in [assets\agency-agents](assets/agency-agents).
90
+ ## Secondary development
67
91
 
68
- **License boundary:** this plugin's TypeScript source, build scripts, and project documentation are licensed under [Apache License 2.0](LICENSE). The bundled upstream agent personas remain under the MIT License; see [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE). See [NOTICE](NOTICE) for attribution.
92
+ - [src\index.ts](src/index.ts): host entry point for catalog loading, tools, and settings.
93
+ - [src\remote-contract.ts](src/remote-contract.ts) and [src\remote.ts](src/remote.ts): Remote contract and implementation.
94
+ - [src\client\index.ts](src/client/index.ts): Settings page, composer button, and `@` trigger.
95
+ - `assets\agency-agents`: bundled personas; retain its MIT license and [NOTICE](NOTICE) attribution.
69
96
 
70
- The complete roster is split by division in the [agent roster](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md).
97
+ After changing `src` or `assets`, rebuild, test, and install from the local directory:
71
98
 
72
- ## Development and verification
99
+ ```powershell
100
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
101
+ $OutputEncoding = [System.Text.Encoding]::UTF8
102
+ pnpm build
103
+ pnpm test
104
+ pnpm verify
105
+ dsh plugin --profile web add .
106
+ ```
107
+
108
+ The published package includes `lib`, `assets`, the patch, and documentation only. Do not publish `node_modules` or local development files.
109
+
110
+ ## Validation
73
111
 
74
112
  ```powershell
75
113
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
76
114
  $OutputEncoding = [System.Text.Encoding]::UTF8
77
- pnpm install
78
115
  pnpm build
79
116
  pnpm test
80
117
  pnpm verify
81
118
  ```
82
119
 
83
- `prepublishOnly` runs build, test, and package-integrity verification automatically.
120
+ `prepublishOnly` runs these build, test, and package-integrity checks before publishing.
121
+
122
+ ## License and attribution
123
+
124
+ 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 CHANGED
@@ -11,73 +11,114 @@
11
11
  [![内置智能体](https://img.shields.io/badge/内置智能体-271-0f766e.svg)](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)
12
12
  </div>
13
13
 
14
- `dsh-agency-agents` 是 DeepSeek Harness（DSH）插件。主会话负责理解上下文、判断与最终交付；需要专业视角时，可将完整任务交给带有 The Agency persona 的一次性子代理。
14
+ > DSH Agency Agents 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
15
15
 
16
- ## 在 DSH 中使用
16
+ ## 功能概览
17
17
 
18
- 在设置的「智能体」面板中浏览并启用所需的智能体。插件按分区提供内置智能体，并在面板中保留名称、简介与启用状态。
18
+ - 在「设置 → 智能体」中按 17 个分区浏览、启用或停用内置专家。
19
+ - 在输入框的「智能体」模式中按名称或 slug 召唤已启用的专家处理完整任务。
20
+ - 提供 `list_experts` 与 `summon_expert` 工具，分别用于发现专家和启动一次性子代理。
21
+ - 内置 271 份 persona，无需额外下载；也可接入自行同步的专家目录。
19
22
 
20
- ![DSH 智能体面板](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/agent-roster.png)
23
+ 主会话保留任务上下文、判断和最终交付；专家子代理只提供专业视角，不能继续召唤专家，避免递归委派。
21
24
 
22
- 在对话输入框选择「智能体」模式，然后用名称和 slug 明确指定要召唤的智能体。例如：
25
+ ## 前置条件
23
26
 
24
- ```text
25
- 召唤智能体「代码审查工程师」（engineering-code-reviewer）处理以下任务：
26
- 审查当前工作区的改动，按严重程度列出可复现的问题。
27
- ```
27
+ - 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 `dsh`。
28
+ - 以下示例使用 `web` profile；请替换为实际目标 profile。
29
+ - 从源码安装或二次开发需要 Node.js 22+ 与 pnpm；仅从 npm 安装无需单独执行 `pnpm install`。
28
30
 
29
- ![召唤智能体的输入方式](https://raw.githubusercontent.com/MichengAI/dsh-agency-agents/main/assets/screenshots/summon-prompt.png)
31
+ ## 安装
30
32
 
31
- ## 工作方式
33
+ ### 从 npm 安装
32
34
 
33
- | 阶段 | 主会话与插件的职责 |
34
- | --- | --- |
35
- | 发现 | `list_experts(division?)` 无参返回分区和数量；传入分区后展开对应智能体。 |
36
- | 委派 | `summon_expert(expert, task)` 按 slug 或唯一名称启动一次性子代理。 |
37
- | 交付 | 子代理返回专业结论；主会话结合原始上下文完成判断与汇总。 |
35
+ 在任意 PowerShell 目录执行。`dsh plugin` 会安装 npm 包并自动应用包内的 `cordis.patch.yml`：
38
36
 
39
- - 默认内置 271 名智能体，安装后无需依赖外部目录。
40
- - 可通过 `root` 配置或 `AGENCY_AGENTS_ROOT` 环境变量覆盖为自行同步的智能体目录。
41
- - 子代理无法调用 `summon_expert` 或 `list_experts`，避免递归委派、无效花名册浏览和不可控消耗。
42
- - 支持 `spawn` 或 `fork` provider；provider 必须支持 persona 和工具过滤能力。
37
+ ```powershell
38
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
39
+ $OutputEncoding = [System.Text.Encoding]::UTF8
40
+ dsh plugin --profile web add @michengai/dsh-agency-agents
41
+ dsh --profile web --dump-config
42
+ ```
43
43
 
44
- ## 安装
44
+ 配置输出中应包含 `agency-agents` 与 `agency-agents-remote`。安装后重启 DSH Web 并在浏览器硬刷新；请勿手工复制客户端文件，否则设置页所需的 Remote 服务不会被挂载。
45
+
46
+ 若镜像未同步最新版本，可在安装命令末尾追加 `--registry=https://registry.npmjs.org/`。
47
+
48
+ ### 从源码安装
49
+
50
+ 适用于调试或使用未发布改动。克隆后的本地路径就是插件安装路径：
45
51
 
46
52
  ```powershell
47
53
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
48
54
  $OutputEncoding = [System.Text.Encoding]::UTF8
49
- dsh plugin --profile default add @michengai/dsh-agency-agents
50
- dsh --profile default --dump-config
55
+ Set-Location D:\Repository\deepseek-harness-plugin
56
+ git clone https://github.com/MichengAI/dsh-agency-agents.git
57
+ Set-Location .\dsh-agency-agents
58
+ pnpm install --frozen-lockfile
59
+ pnpm build
60
+ dsh plugin --profile web add .
61
+ dsh --profile web --dump-config
51
62
  ```
52
63
 
53
- 将 `default` 替换为目标 profile。第二条命令应显示 `agency-agents` 与 `agency-agents-remote` 两个组合项；后者是设置页读写启用状态所需的 Host Remote 服务。请通过 `dsh plugin` 安装，手工复制客户端文件而未应用 `cordis.patch.yml` 会使设置页显示 Remote 不可用。本地开发时可将包名替换为 `.`。
64
+ 完成后重启 DSH Web 并硬刷新浏览器。`dsh plugin ... add .` 会读取当前目录的包信息和 `cordis.patch.yml`；不要改为直接复制 `lib` 目录。
65
+
66
+ ## 使用
54
67
 
55
- ## 配置
68
+ 1. 打开「设置 → 智能体」，启用需要的专家。
69
+ 2. 在对话输入框选择「智能体」模式。
70
+ 3. 用名称和 slug 明确指定专家，并给出完整任务。例如：
56
71
 
57
- | 键 | 默认值 | 说明 |
72
+ ```text
73
+ 召唤智能体「代码审查工程师」（engineering-code-reviewer）处理以下任务：
74
+ 审查当前工作区的改动，按严重程度列出可复现的问题。
75
+ ```
76
+
77
+ 也可由主会话先调用 `list_experts(division?)` 查找专家，再使用 `summon_expert(expert, task)` 委派任务。名称不唯一时，请使用 slug。
78
+
79
+ ## 配置与边界
80
+
81
+ | 配置项 | 默认值 | 作用 |
58
82
  | --- | --- | --- |
59
- | `root` | 包内智能体资产 | 外部智能体根目录；显式配置优先于包内资产。 |
60
- | `provider` | `spawn` | DSH 子代理 provider。 |
61
- | `divisions` | 全部 17 个标准分区 | 需要扫描的顶层分区。 |
62
- | `maxDepth` | 不设置 | 可选的正整数绝对子代理深度上限；provider 必须支持深度限制。 |
83
+ | `root` | 包内专家资产 | 外部专家根目录；显式配置优先。 |
84
+ | `provider` | `spawn` | DSH 子代理 provider，可使用支持 persona 与工具过滤的 `fork`。 |
85
+ | `divisions` | 17 个标准分区 | 需要扫描的顶层分区。 |
86
+ | `maxDepth` | 未设置 | 正整数形式的绝对子代理深度上限。 |
87
+
88
+ 也可设置 `AGENCY_AGENTS_ROOT` 环境变量指定外部专家目录。子代理 provider 必须支持 persona 和工具过滤能力。
63
89
 
64
- ## 内置智能体来源与授权
90
+ ## 二次开发
65
91
 
66
- 智能体 persona 来源于 [The Agency](https://github.com/msitarzewski/agency-agents)，版权归 AgentLand Contributors。内置快照及其原始许可证位于 [assets\agency-agents](assets/agency-agents)。
92
+ - Host 端入口：[src\index.ts](src/index.ts)，负责加载专家目录、注册工具和设置项。
93
+ - Remote 契约与实现：[src\remote-contract.ts](src/remote-contract.ts)、[src\remote.ts](src/remote.ts)。
94
+ - 客户端入口：[src\client\index.ts](src/client/index.ts)，负责设置页、输入框按钮与 `@` 触发器。
95
+ - 内置 persona 位于 `assets\agency-agents`；保留其中的 MIT 许可证和 [NOTICE](NOTICE) 归属说明。
67
96
 
68
- **授权边界：**本插件的 TypeScript 源码、构建脚本与项目文档采用 [Apache License 2.0](LICENSE)；随包分发的上游智能体 persona 仍采用 MIT，完整文本见 [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE)。更多说明见 [NOTICE](NOTICE)。
97
+ 修改 `src` 或 `assets` 后，重新构建并以本地目录安装验证：
98
+
99
+ ```powershell
100
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
101
+ $OutputEncoding = [System.Text.Encoding]::UTF8
102
+ pnpm build
103
+ pnpm test
104
+ pnpm verify
105
+ dsh plugin --profile web add .
106
+ ```
69
107
 
70
- 全部内置智能体按分区列在 [智能体清单](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)。
108
+ 发布包只包含 `lib`、`assets`、补丁和文档；不要将 `node_modules` 或本地开发文件加入发布内容。
71
109
 
72
- ## 开发与验证
110
+ ## 验证
73
111
 
74
112
  ```powershell
75
113
  [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
76
114
  $OutputEncoding = [System.Text.Encoding]::UTF8
77
- pnpm install
78
115
  pnpm build
79
116
  pnpm test
80
117
  pnpm verify
81
118
  ```
82
119
 
83
- `prepublishOnly` 会自动执行构建、测试和发布完整性验证。
120
+ `prepublishOnly` 会在发布前依次执行上述构建、测试和包完整性检查。
121
+
122
+ ## 许可证与归属
123
+
124
+ 本项目 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/lib/client.js CHANGED
@@ -6829,7 +6829,8 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
6829
6829
  id: "agency-agents",
6830
6830
  order: 16,
6831
6831
  label: () => t("settings.nav"),
6832
- locale: NS
6832
+ locale: NS,
6833
+ icon: "expert"
6833
6834
  }, (props) => react.default.createElement(AgentsSettings, {
6834
6835
  ...props,
6835
6836
  remote,
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@michengai/dsh-agency-agents",
3
3
  "description": "Agency Experts — a summonable domain-expert roster for DSH (expert mode)",
4
- "version": "0.1.4",
4
+ "version": "0.1.6",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
7
7
  "types": "lib/index.d.ts",