@michengai/dsh-agency-agents 0.1.4 → 0.1.5
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.
- package/README.md +79 -41
- package/README.zh-CN.md +78 -40
- package/lib/client.js +2 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -5,79 +5,117 @@
|
|
|
5
5
|
|
|
6
6
|
**271 summonable specialist agents for DeepSeek Harness**
|
|
7
7
|
|
|
8
|
-
[
|
|
9
|
-
|
|
10
|
-
[](LICENSE)
|
|
11
|
-
[](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)
|
|
8
|
+
[简体中文](README.zh-CN.md) · [Documentation](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
|
|
12
9
|
</div>
|
|
13
10
|
|
|
14
|
-
|
|
11
|
+
> DSH Agency Agents is a community-maintained DeepSeek Harness (DSH) plugin, not an official DeepSeek AI product.
|
|
15
12
|
|
|
16
|
-
##
|
|
13
|
+
## Features
|
|
17
14
|
|
|
18
|
-
Browse
|
|
15
|
+
- Browse, enable, and disable bundled experts across 17 divisions in **Settings → Agents**.
|
|
16
|
+
- Summon enabled experts by name or slug from the composer’s **Agent** mode.
|
|
17
|
+
- Use `list_experts` to discover experts and `summon_expert` to start a one-shot specialist subagent.
|
|
18
|
+
- Use 271 bundled personas immediately, or connect a separately synchronized expert directory.
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
The parent session keeps task context, judgment, and the final answer. Expert children provide a specialist perspective only and cannot summon further experts.
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
## Prerequisites
|
|
23
23
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
24
|
+
- A working DeepSeek Harness Web installation with `dsh` available in PowerShell.
|
|
25
|
+
- Examples use the `web` profile; replace it with the target profile.
|
|
26
|
+
- Source installation and development require Node.js 22+ and pnpm. npm installation does not require running `pnpm install` separately.
|
|
27
|
+
|
|
28
|
+
## Installation
|
|
29
|
+
|
|
30
|
+
### Install from npm
|
|
31
|
+
|
|
32
|
+
Run this from any PowerShell directory. `dsh plugin` installs the npm package and applies its bundled `cordis.patch.yml`:
|
|
28
33
|
|
|
29
|
-
|
|
34
|
+
```powershell
|
|
35
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
36
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
37
|
+
dsh plugin --profile web add @michengai/dsh-agency-agents
|
|
38
|
+
dsh --profile web --dump-config
|
|
39
|
+
```
|
|
30
40
|
|
|
31
|
-
|
|
41
|
+
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
42
|
|
|
33
|
-
|
|
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. |
|
|
43
|
+
If a package mirror has not synchronized the latest version, append `--registry=https://registry.npmjs.org/`.
|
|
38
44
|
|
|
39
|
-
|
|
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.
|
|
45
|
+
### Install from source
|
|
43
46
|
|
|
44
|
-
|
|
47
|
+
Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
|
|
45
48
|
|
|
46
49
|
```powershell
|
|
47
50
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
48
51
|
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
49
|
-
|
|
50
|
-
|
|
52
|
+
Set-Location D:\Repository\deepseek-harness-plugin
|
|
53
|
+
git clone https://github.com/MichengAI/dsh-agency-agents.git
|
|
54
|
+
Set-Location .\dsh-agency-agents
|
|
55
|
+
pnpm install --frozen-lockfile
|
|
56
|
+
pnpm build
|
|
57
|
+
dsh plugin --profile web add .
|
|
58
|
+
dsh --profile web --dump-config
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
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.
|
|
62
|
+
|
|
63
|
+
## Usage
|
|
64
|
+
|
|
65
|
+
1. Open **Settings → Agents** and enable the needed experts.
|
|
66
|
+
2. Select **Agent** mode in the composer.
|
|
67
|
+
3. Name the expert and slug, then provide the complete task.
|
|
68
|
+
|
|
69
|
+
```text
|
|
70
|
+
Summon the "Code Review Engineer" agent (engineering-code-reviewer) for this task:
|
|
71
|
+
Review the changes in the current workspace and list reproducible issues by severity.
|
|
51
72
|
```
|
|
52
73
|
|
|
53
|
-
|
|
74
|
+
The parent session can also call `list_experts(division?)`, then delegate with `summon_expert(expert, task)`. Use a slug when a name is ambiguous.
|
|
54
75
|
|
|
55
|
-
## Configuration
|
|
76
|
+
## Configuration and limits
|
|
56
77
|
|
|
57
|
-
| Key | Default |
|
|
78
|
+
| Key | Default | Purpose |
|
|
58
79
|
| --- | --- | --- |
|
|
59
|
-
| `root` | Bundled
|
|
60
|
-
| `provider` | `spawn` | DSH subagent provider. |
|
|
61
|
-
| `divisions` |
|
|
62
|
-
| `maxDepth` | Unset |
|
|
80
|
+
| `root` | Bundled expert assets | External expert root; an explicit value takes priority. |
|
|
81
|
+
| `provider` | `spawn` | DSH subagent provider; `fork` also works when it supports persona and tool filtering. |
|
|
82
|
+
| `divisions` | 17 standard divisions | Top-level divisions to scan. |
|
|
83
|
+
| `maxDepth` | Unset | Positive absolute subagent-depth limit. |
|
|
84
|
+
|
|
85
|
+
Set `AGENCY_AGENTS_ROOT` to use an external expert directory. The provider must support persona and tool filtering.
|
|
63
86
|
|
|
64
|
-
##
|
|
87
|
+
## Secondary development
|
|
65
88
|
|
|
66
|
-
|
|
89
|
+
- [src\index.ts](src/index.ts): host entry point for catalog loading, tools, and settings.
|
|
90
|
+
- [src\remote-contract.ts](src/remote-contract.ts) and [src\remote.ts](src/remote.ts): Remote contract and implementation.
|
|
91
|
+
- [src\client\index.ts](src/client/index.ts): Settings page, composer button, and `@` trigger.
|
|
92
|
+
- `assets\agency-agents`: bundled personas; retain its MIT license and [NOTICE](NOTICE) attribution.
|
|
67
93
|
|
|
68
|
-
|
|
94
|
+
After changing `src` or `assets`, rebuild, test, and install from the local directory:
|
|
95
|
+
|
|
96
|
+
```powershell
|
|
97
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
98
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
99
|
+
pnpm build
|
|
100
|
+
pnpm test
|
|
101
|
+
pnpm verify
|
|
102
|
+
dsh plugin --profile web add .
|
|
103
|
+
```
|
|
69
104
|
|
|
70
|
-
The
|
|
105
|
+
The published package includes `lib`, `assets`, the patch, and documentation only. Do not publish `node_modules` or local development files.
|
|
71
106
|
|
|
72
|
-
##
|
|
107
|
+
## Validation
|
|
73
108
|
|
|
74
109
|
```powershell
|
|
75
110
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
76
111
|
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
77
|
-
pnpm install
|
|
78
112
|
pnpm build
|
|
79
113
|
pnpm test
|
|
80
114
|
pnpm verify
|
|
81
115
|
```
|
|
82
116
|
|
|
83
|
-
`prepublishOnly` runs build, test, and package-integrity
|
|
117
|
+
`prepublishOnly` runs these build, test, and package-integrity checks before publishing.
|
|
118
|
+
|
|
119
|
+
## License and attribution
|
|
120
|
+
|
|
121
|
+
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
|
@@ -6,78 +6,116 @@
|
|
|
6
6
|
**为 DeepSeek Harness 提供 271 名可召唤的专业智能体**
|
|
7
7
|
|
|
8
8
|
[English](README.md) · [完整文档](docs/00-交接入口/00-阅读导航.md) · [Apache-2.0](LICENSE)
|
|
9
|
-
|
|
10
|
-
[](LICENSE)
|
|
11
|
-
[](docs/04-Agent运行体系/01-内置智能体清单/00-清单索引.md)
|
|
12
9
|
</div>
|
|
13
10
|
|
|
14
|
-
|
|
11
|
+
> DSH Agency Agents 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。
|
|
15
12
|
|
|
16
|
-
##
|
|
13
|
+
## 功能概览
|
|
17
14
|
|
|
18
|
-
|
|
15
|
+
- 在「设置 → 智能体」中按 17 个分区浏览、启用或停用内置专家。
|
|
16
|
+
- 在输入框的「智能体」模式中按名称或 slug 召唤已启用的专家处理完整任务。
|
|
17
|
+
- 提供 `list_experts` 与 `summon_expert` 工具，分别用于发现专家和启动一次性子代理。
|
|
18
|
+
- 内置 271 份 persona，无需额外下载；也可接入自行同步的专家目录。
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
主会话保留任务上下文、判断和最终交付；专家子代理只提供专业视角，不能继续召唤专家，避免递归委派。
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
## 前置条件
|
|
23
23
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
```
|
|
24
|
+
- 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 `dsh`。
|
|
25
|
+
- 以下示例使用 `web` profile；请替换为实际目标 profile。
|
|
26
|
+
- 从源码安装或二次开发需要 Node.js 22+ 与 pnpm；仅从 npm 安装无需单独执行 `pnpm install`。
|
|
28
27
|
|
|
29
|
-
|
|
28
|
+
## 安装
|
|
30
29
|
|
|
31
|
-
|
|
30
|
+
### 从 npm 安装
|
|
32
31
|
|
|
33
|
-
|
|
34
|
-
| --- | --- |
|
|
35
|
-
| 发现 | `list_experts(division?)` 无参返回分区和数量；传入分区后展开对应智能体。 |
|
|
36
|
-
| 委派 | `summon_expert(expert, task)` 按 slug 或唯一名称启动一次性子代理。 |
|
|
37
|
-
| 交付 | 子代理返回专业结论；主会话结合原始上下文完成判断与汇总。 |
|
|
32
|
+
在任意 PowerShell 目录执行。`dsh plugin` 会安装 npm 包并自动应用包内的 `cordis.patch.yml`：
|
|
38
33
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
34
|
+
```powershell
|
|
35
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
36
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
37
|
+
dsh plugin --profile web add @michengai/dsh-agency-agents
|
|
38
|
+
dsh --profile web --dump-config
|
|
39
|
+
```
|
|
43
40
|
|
|
44
|
-
|
|
41
|
+
配置输出中应包含 `agency-agents` 与 `agency-agents-remote`。安装后重启 DSH Web 并在浏览器硬刷新；请勿手工复制客户端文件，否则设置页所需的 Remote 服务不会被挂载。
|
|
42
|
+
|
|
43
|
+
若镜像未同步最新版本，可在安装命令末尾追加 `--registry=https://registry.npmjs.org/`。
|
|
44
|
+
|
|
45
|
+
### 从源码安装
|
|
46
|
+
|
|
47
|
+
适用于调试或使用未发布改动。克隆后的本地路径就是插件安装路径：
|
|
45
48
|
|
|
46
49
|
```powershell
|
|
47
50
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
48
51
|
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
49
|
-
|
|
50
|
-
|
|
52
|
+
Set-Location D:\Repository\deepseek-harness-plugin
|
|
53
|
+
git clone https://github.com/MichengAI/dsh-agency-agents.git
|
|
54
|
+
Set-Location .\dsh-agency-agents
|
|
55
|
+
pnpm install --frozen-lockfile
|
|
56
|
+
pnpm build
|
|
57
|
+
dsh plugin --profile web add .
|
|
58
|
+
dsh --profile web --dump-config
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
完成后重启 DSH Web 并硬刷新浏览器。`dsh plugin ... add .` 会读取当前目录的包信息和 `cordis.patch.yml`；不要改为直接复制 `lib` 目录。
|
|
62
|
+
|
|
63
|
+
## 使用
|
|
64
|
+
|
|
65
|
+
1. 打开「设置 → 智能体」，启用需要的专家。
|
|
66
|
+
2. 在对话输入框选择「智能体」模式。
|
|
67
|
+
3. 用名称和 slug 明确指定专家，并给出完整任务。例如：
|
|
68
|
+
|
|
69
|
+
```text
|
|
70
|
+
召唤智能体「代码审查工程师」（engineering-code-reviewer）处理以下任务：
|
|
71
|
+
审查当前工作区的改动，按严重程度列出可复现的问题。
|
|
51
72
|
```
|
|
52
73
|
|
|
53
|
-
|
|
74
|
+
也可由主会话先调用 `list_experts(division?)` 查找专家，再使用 `summon_expert(expert, task)` 委派任务。名称不唯一时，请使用 slug。
|
|
54
75
|
|
|
55
|
-
##
|
|
76
|
+
## 配置与边界
|
|
56
77
|
|
|
57
|
-
|
|
|
78
|
+
| 配置项 | 默认值 | 作用 |
|
|
58
79
|
| --- | --- | --- |
|
|
59
|
-
| `root` |
|
|
60
|
-
| `provider` | `spawn` | DSH 子代理 provider
|
|
61
|
-
| `divisions` |
|
|
62
|
-
| `maxDepth` |
|
|
80
|
+
| `root` | 包内专家资产 | 外部专家根目录；显式配置优先。 |
|
|
81
|
+
| `provider` | `spawn` | DSH 子代理 provider，可使用支持 persona 与工具过滤的 `fork`。 |
|
|
82
|
+
| `divisions` | 17 个标准分区 | 需要扫描的顶层分区。 |
|
|
83
|
+
| `maxDepth` | 未设置 | 正整数形式的绝对子代理深度上限。 |
|
|
63
84
|
|
|
64
|
-
|
|
85
|
+
也可设置 `AGENCY_AGENTS_ROOT` 环境变量指定外部专家目录。子代理 provider 必须支持 persona 和工具过滤能力。
|
|
65
86
|
|
|
66
|
-
|
|
87
|
+
## 二次开发
|
|
67
88
|
|
|
68
|
-
|
|
89
|
+
- Host 端入口：[src\index.ts](src/index.ts)，负责加载专家目录、注册工具和设置项。
|
|
90
|
+
- Remote 契约与实现：[src\remote-contract.ts](src/remote-contract.ts)、[src\remote.ts](src/remote.ts)。
|
|
91
|
+
- 客户端入口：[src\client\index.ts](src/client/index.ts)，负责设置页、输入框按钮与 `@` 触发器。
|
|
92
|
+
- 内置 persona 位于 `assets\agency-agents`；保留其中的 MIT 许可证和 [NOTICE](NOTICE) 归属说明。
|
|
69
93
|
|
|
70
|
-
|
|
94
|
+
修改 `src` 或 `assets` 后，重新构建并以本地目录安装验证：
|
|
71
95
|
|
|
72
|
-
|
|
96
|
+
```powershell
|
|
97
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
98
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
99
|
+
pnpm build
|
|
100
|
+
pnpm test
|
|
101
|
+
pnpm verify
|
|
102
|
+
dsh plugin --profile web add .
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
发布包只包含 `lib`、`assets`、补丁和文档；不要将 `node_modules` 或本地开发文件加入发布内容。
|
|
106
|
+
|
|
107
|
+
## 验证
|
|
73
108
|
|
|
74
109
|
```powershell
|
|
75
110
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
76
111
|
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
77
|
-
pnpm install
|
|
78
112
|
pnpm build
|
|
79
113
|
pnpm test
|
|
80
114
|
pnpm verify
|
|
81
115
|
```
|
|
82
116
|
|
|
83
|
-
`prepublishOnly`
|
|
117
|
+
`prepublishOnly` 会在发布前依次执行上述构建、测试和包完整性检查。
|
|
118
|
+
|
|
119
|
+
## 许可证与归属
|
|
120
|
+
|
|
121
|
+
本项目 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