@michengai/dsh-agency-agents 0.1.34 → 0.1.36
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/CHANGELOG.md +14 -0
- package/CHANGELOG.zh-CN.md +14 -0
- package/README.md +43 -63
- package/README.zh-CN.md +43 -63
- package/lib/client.js +1135 -221
- package/lib/{index-Cj9YDkgr.d.ts → index-D4dhi1A4.d.ts} +4 -4
- package/lib/index.d.ts +1 -1
- package/lib/index.js +1 -1
- package/lib/remote.d.ts +40 -2
- package/lib/remote.js +150 -9
- package/lib/{src-CYNv1yps.js → src-Di6THeMW.js} +327 -46
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,20 @@ The five most recent published versions are listed below.
|
|
|
6
6
|
|
|
7
7
|
## Unreleased
|
|
8
8
|
|
|
9
|
+
## 0.1.36 - 2026-09-09
|
|
10
|
+
|
|
11
|
+
- Added custom expert management with creation, editing, copying built-ins, avatar and Emoji selection, and source and enabled-state filters. Custom experts are available through @ suggestions, the chat picker, and summon tools.
|
|
12
|
+
- Made deletion permanent with immediate capacity recovery and automatic cleanup of legacy soft-deleted records. Name conflicts retain rename and delete access in Settings instead of making the entire catalog unavailable.
|
|
13
|
+
- Strengthened settings revision and catalog consistency checks, rejected invalid enablement entries, and prevented in-flight reads and delayed write receipts from overwriting newer results.
|
|
14
|
+
- Preserved drafts during editing conflicts and added review of the latest content before saving. Stale local catalogs no longer block valid saves after another window deletes or renames an expert to release its name.
|
|
15
|
+
- Made viewing, copying, and summoning nested experts read the actual file selected by the catalog, avoiding missing prompts or the wrong persona from a same-named file.
|
|
16
|
+
- Refined chat entry spacing, dropdown styling, blue focus feedback, and layered Escape handling. Prompt previews use a native dialog, and custom reference chips retain the same icon-and-name presentation as built-ins.
|
|
17
|
+
- Fixed a concurrency gap in automatic update locking and made release validation compatible with Windows CRLF line endings.
|
|
18
|
+
|
|
19
|
+
## 0.1.35 - 2026-09-09
|
|
20
|
+
|
|
21
|
+
- Unified settings headings, descriptions, and action layouts; maintenance controls no longer squeeze titles or versions. The layout adapts to native DSH settings without Codex UI.
|
|
22
|
+
|
|
9
23
|
## 0.1.34 - 2026-09-08
|
|
10
24
|
|
|
11
25
|
- Fixed the composer Expert picker so its scrollable menu opens within the available viewport space instead of being clipped when many experts are enabled.
|
package/CHANGELOG.zh-CN.md
CHANGED
|
@@ -6,6 +6,20 @@
|
|
|
6
6
|
|
|
7
7
|
## 未发布
|
|
8
8
|
|
|
9
|
+
## 0.1.36 - 2026-09-09
|
|
10
|
+
|
|
11
|
+
- 新增自定义专家管理：支持创建、编辑、复制内置专家、选择头像与 Emoji，以及来源和启用状态筛选；自定义专家可从 @ 候选、聊天入口和召唤工具调用。
|
|
12
|
+
- 专家删除改为永久删除并立即释放名额，自动清理旧版软删除记录；名称冲突保留设置页改名和删除入口，不再导致整张名册不可用。
|
|
13
|
+
- 加强配置修订号和名册一致性校验，拒绝无效启用项，防止在途旧查询及延迟写入回执覆盖最新结果。
|
|
14
|
+
- 编辑冲突时保留草稿，支持读取并核对最新内容后再保存；其他窗口删除或改名释放名称后，旧本地名册不再阻止合法保存。
|
|
15
|
+
- 嵌套目录专家的查看、复制与召唤均读取名册选中的实际文件，避免正文缺失或读到同名专家的错误 persona。
|
|
16
|
+
- 优化聊天入口间距、下拉样式、蓝色焦点反馈和 Escape 分层处理；提示词预览使用原生弹窗，自定义引用标签与内置保持统一图标和纯名称。
|
|
17
|
+
- 修复自动更新请求的并发锁空档，并让发布校验兼容 Windows CRLF 换行。
|
|
18
|
+
|
|
19
|
+
## 0.1.35 - 2026-09-09
|
|
20
|
+
|
|
21
|
+
- 统一设置页标题、说明与操作布局，标题及版本不再被维护按钮挤压；适配原生 DSH 设置内容区，无需安装 Codex UI。
|
|
22
|
+
|
|
9
23
|
## 0.1.34 - 2026-09-08
|
|
10
24
|
|
|
11
25
|
- 修复输入框「专家」选择器在启用较多专家时超出视口而被截断的问题，菜单现在会在可用空间内展开并滚动。
|
package/README.md
CHANGED
|
@@ -22,13 +22,12 @@
|
|
|
22
22
|
|
|
23
23
|
## Features
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
- Summon enabled experts by their localized name from the composer's **Experts** picker.
|
|
27
|
-
- Use `list_experts` to discover experts and `summon_expert` to start a one-shot specialist subagent.
|
|
28
|
-
- Use 321 bundled personas immediately, or connect a separately synchronized expert directory.
|
|
29
|
-
- Paste one sentence into DSH, Codex, or WorkBuddy and let that agent install the plugin locally.
|
|
25
|
+
Choose a specialist in DSH for code review, design, operations, or research. All 321 experts are bundled and ready to use after installation.
|
|
30
26
|
|
|
31
|
-
|
|
27
|
+
- **Find the right expert**: filter by category or search in **Settings → Experts**.
|
|
28
|
+
- **Enable the roles you need**: keep the picker focused by enabling or disabling experts.
|
|
29
|
+
- **Describe the task directly**: use `@` or the **Experts** picker, then write your complete request.
|
|
30
|
+
- **Get one final delivery**: experts provide specialist analysis and the parent conversation brings the results together. Experts cannot summon further experts.
|
|
32
31
|
|
|
33
32
|
## Screenshots
|
|
34
33
|
|
|
@@ -46,13 +45,18 @@ The localized expert name is inserted as a short tag; write the complete task ne
|
|
|
46
45
|
|
|
47
46
|
## DSH product ecosystem
|
|
48
47
|
|
|
49
|
-
|
|
48
|
+
For a ready-to-use workbench, download [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases). If you already use [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness), install any of these eight plugins individually. The desktop app includes all eight.
|
|
50
49
|
|
|
51
|
-
|
|
|
50
|
+
| Plugin | What you can do |
|
|
52
51
|
| --- | --- |
|
|
53
|
-
| [
|
|
54
|
-
| [
|
|
55
|
-
|
|
|
52
|
+
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | Organize projects and conversations, search tasks, and navigate chat turns |
|
|
53
|
+
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | Send tasks and receive replies through your usual messenger |
|
|
54
|
+
| [Automation](https://github.com/MichengAI/dsh-automation) | Schedule tasks and review each run |
|
|
55
|
+
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | Find, enable, create, and import local skills |
|
|
56
|
+
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | Search, restore, or clean up archived conversations |
|
|
57
|
+
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | Choose and summon specialists for your task |
|
|
58
|
+
| [BTW](https://github.com/MichengAI/dsh-btw) | Ask side questions without interrupting the main task |
|
|
59
|
+
| [Simplify](https://github.com/MichengAI/dsh-simplify) | Use /simplify to improve code within your Git changes |
|
|
56
60
|
|
|
57
61
|
## Prerequisites
|
|
58
62
|
|
|
@@ -62,40 +66,16 @@ This product can be installed independently or used through the desktop app or W
|
|
|
62
66
|
|
|
63
67
|
## Installation
|
|
64
68
|
|
|
65
|
-
|
|
69
|
+
The installation commands below use the official npm registry.
|
|
66
70
|
|
|
67
|
-
### Ask
|
|
71
|
+
### Ask an agent to install it (recommended)
|
|
68
72
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
From npm:
|
|
73
|
+
Send the prompt below to any agent that can run terminal commands on your computer. Replace `web` with your actual profile. Once installed, use the plugin in DSH.
|
|
72
74
|
|
|
73
75
|
```text
|
|
74
|
-
Install the
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
From source:
|
|
78
|
-
|
|
79
|
-
```text
|
|
80
|
-
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.
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
| Product | How to use it |
|
|
84
|
-
| --- | --- |
|
|
85
|
-
| DSH | Send one of the sentences above to the current session. |
|
|
86
|
-
| Codex | Send one of the sentences above to Codex and let it install locally. |
|
|
87
|
-
| WorkBuddy | Send one of the sentences above to WorkBuddy; for a source install you can also paste `https://github.com/MichengAI/dsh-agency-agents`. |
|
|
88
|
-
|
|
89
|
-
Codex and WorkBuddy only install the plugin. After that, open DSH Web and use **Settings → Experts**.
|
|
90
|
-
|
|
91
|
-
You can also run the same npm command yourself:
|
|
92
|
-
|
|
93
|
-
```powershell
|
|
94
|
-
dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/
|
|
76
|
+
Install the DSH plugin @michengai/dsh-agency-agents into my local web profile by running: dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/. Then run dsh --profile web --dump-config, confirm the configuration includes agency-agents, agency-agents-remote, and explain how to reload DSH and start using the plugin.
|
|
95
77
|
```
|
|
96
78
|
|
|
97
|
-
If `dsh` is not on PATH, replace the leading `dsh` with `npx --yes @deepseek-ai/dsh`.
|
|
98
|
-
|
|
99
79
|
### Install the latest package from the official npm registry
|
|
100
80
|
|
|
101
81
|
Run this from any PowerShell directory:
|
|
@@ -111,24 +91,6 @@ To pin a release, replace `@latest` with a version such as `@0.1.17`.
|
|
|
111
91
|
|
|
112
92
|
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.
|
|
113
93
|
|
|
114
|
-
### Install from source
|
|
115
|
-
|
|
116
|
-
Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
|
|
117
|
-
|
|
118
|
-
```powershell
|
|
119
|
-
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
120
|
-
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
121
|
-
Set-Location D:\Repository\deepseek-harness-plugin
|
|
122
|
-
git clone https://github.com/MichengAI/dsh-agency-agents.git
|
|
123
|
-
Set-Location .\dsh-agency-agents
|
|
124
|
-
pnpm install --frozen-lockfile
|
|
125
|
-
pnpm build
|
|
126
|
-
dsh plugin --profile web add .
|
|
127
|
-
dsh --profile web --dump-config
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
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.
|
|
131
|
-
|
|
132
94
|
## Updates
|
|
133
95
|
|
|
134
96
|
The settings title shows the installed version and a **Check for updates** button. When a newer release is available, **Update automatically** runs only when the DSH CLI or Desktop update service is available; otherwise, the dialog provides a profile-specific manual command to copy and run.
|
|
@@ -730,6 +692,24 @@ Set `AGENCY_AGENTS_ROOT` to use an external expert directory. Persona bodies fro
|
|
|
730
692
|
|
|
731
693
|
## Secondary development
|
|
732
694
|
|
|
695
|
+
### Install from source
|
|
696
|
+
|
|
697
|
+
Use this for debugging or unpublished changes. The cloned directory becomes the plugin source path:
|
|
698
|
+
|
|
699
|
+
```powershell
|
|
700
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
701
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
702
|
+
Set-Location D:\Repository\deepseek-harness-plugin
|
|
703
|
+
git clone https://github.com/MichengAI/dsh-agency-agents.git
|
|
704
|
+
Set-Location .\dsh-agency-agents
|
|
705
|
+
pnpm install --frozen-lockfile
|
|
706
|
+
pnpm build
|
|
707
|
+
dsh plugin --profile web add .
|
|
708
|
+
dsh --profile web --dump-config
|
|
709
|
+
```
|
|
710
|
+
|
|
711
|
+
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.
|
|
712
|
+
|
|
733
713
|
- [src\index.ts](src/index.ts): host entry point for catalog loading, tools, and settings.
|
|
734
714
|
- [src\remote-contract.ts](src/remote-contract.ts) and [src\remote.ts](src/remote.ts): Remote contract and implementation.
|
|
735
715
|
- [src\client\index.ts](src/client/index.ts): Settings page, composer button, and `@` trigger.
|
|
@@ -746,8 +726,6 @@ pnpm verify
|
|
|
746
726
|
dsh plugin --profile web add .
|
|
747
727
|
```
|
|
748
728
|
|
|
749
|
-
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.
|
|
750
|
-
|
|
751
729
|
The published package includes `lib`, `assets`, the patch, and the root README/license files. Do not publish `node_modules` or local development files.
|
|
752
730
|
|
|
753
731
|
## Validation
|
|
@@ -762,10 +740,12 @@ pnpm verify
|
|
|
762
740
|
|
|
763
741
|
`prepublishOnly` runs these build, test, and package-integrity checks before publishing.
|
|
764
742
|
|
|
765
|
-
##
|
|
743
|
+
## Custom experts
|
|
766
744
|
|
|
767
|
-
|
|
745
|
+
Open Settings → Experts → New expert. Set a name, description, category and prompt, then choose an avatar and a separate summon emoji (default 🧩). Save and enable makes the expert immediately available through @ and the Experts button. Reference labels use the standard expert icon and plain name, matching built-in experts; the emoji appears in candidate menus. Copy a base expert to customize it, or edit, enable, disable and delete custom experts. Deletion permanently removes the expert content and enabled state; it cannot be undone.
|
|
768
746
|
|
|
769
|
-
|
|
747
|
+
Data lives in the DSH settings agency-agents namespace outside the plugin directory and survives upgrades. External root still replaces the base roster; custom experts are appended. Viewing, copying, and summoning nested experts use the actual file selected by the catalog. The limit is 200 existing custom experts. Deletion frees a slot; legacy soft-deleted records are cleaned up on startup and subsequent writes. Name conflicts introduced by a base catalog update remain visible in Settings for renaming or deletion, but conflicting experts cannot be summoned. Concurrent changes reject stale saves and keep the draft in the editor. Read and compare the latest content, choose to keep your draft or load that content, then save explicitly. Deleted experts can only be continued as new experts. Remove disabled draft references or re-enable the expert; remove and reselect deleted or conflicting references. Writes carry a revision; see the [Remote contract](src/remote-contract.ts). Back up current settings before downgrading: restoring custom data is separate from rolling back plugin code.
|
|
770
748
|
|
|
771
|
-
|
|
749
|
+
## License and attribution
|
|
750
|
+
|
|
751
|
+
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
|
@@ -22,13 +22,12 @@
|
|
|
22
22
|
|
|
23
23
|
## 功能概览
|
|
24
24
|
|
|
25
|
-
|
|
26
|
-
- 在输入框的「专家」中按当前语言的名称召唤已启用的专家处理完整任务。
|
|
27
|
-
- 提供 `list_experts` 与 `summon_expert` 工具，分别用于发现专家和启动一次性子代理。
|
|
28
|
-
- 内置 321 份 persona，无需额外下载；也可接入自行同步的专家目录。
|
|
29
|
-
- 可把一句话复制到 DSH、Codex 或 WorkBuddy，让对方代装到本机 DSH。
|
|
25
|
+
遇到代码审查、设计、运营或研究任务时，在 DSH 中选一位合适的专家，让它从专业角度协助你完成工作。内置 321 名专家，安装后即可选择使用。
|
|
30
26
|
|
|
31
|
-
|
|
27
|
+
- **找到合适的专家**：在「设置 → 专家」按分类筛选或搜索。
|
|
28
|
+
- **只启用需要的角色**：随时启用或停用专家，让选择列表更简洁。
|
|
29
|
+
- **直接交代任务**：在输入框用 `@` 或「专家」选择角色，再写下完整需求。
|
|
30
|
+
- **由主会话统一交付**：专家提供专业分析，主会话汇总结果；专家不会继续召唤其他专家。
|
|
32
31
|
|
|
33
32
|
## 界面预览
|
|
34
33
|
|
|
@@ -46,13 +45,18 @@
|
|
|
46
45
|
|
|
47
46
|
## DSH 产品生态
|
|
48
47
|
|
|
49
|
-
|
|
48
|
+
想直接使用完整工作台，可下载 [DSH Codex Desktop](https://github.com/MichengAI/dsh-codex-desktop/releases)；已有 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 环境，可按需独立安装以下 8 个自研插件。桌面端已随附这些插件。
|
|
50
49
|
|
|
51
|
-
|
|
|
50
|
+
| 插件 | 你可以用它做什么 |
|
|
52
51
|
| --- | --- |
|
|
53
|
-
| [
|
|
54
|
-
| [
|
|
55
|
-
|
|
|
52
|
+
| [Codex UI](https://github.com/MichengAI/dsh-codex-ui) | 整理项目与会话、搜索任务、跳转对话轮次 |
|
|
53
|
+
| [IM Connect](https://github.com/MichengAI/dsh-im-connect) | 从微信、飞书、钉钉等消息平台下任务、收回复 |
|
|
54
|
+
| [Automation](https://github.com/MichengAI/dsh-automation) | 按计划执行任务，查看每次运行的结果 |
|
|
55
|
+
| [Skills Manager](https://github.com/MichengAI/dsh-skills-manager) | 统一查找、启停、创建和导入本机技能 |
|
|
56
|
+
| [Archive Manager](https://github.com/MichengAI/dsh-archive-manager) | 搜索、恢复或清理已归档会话 |
|
|
57
|
+
| [Agency Agents](https://github.com/MichengAI/dsh-agency-agents) | 按任务选择并召唤专业角色 |
|
|
58
|
+
| [BTW](https://github.com/MichengAI/dsh-btw) | 在当前上下文中临时旁问，不打断主任务 |
|
|
59
|
+
| [Simplify](https://github.com/MichengAI/dsh-simplify) | 用 /simplify 整理 Git 改动范围内的代码 |
|
|
56
60
|
|
|
57
61
|
## 前置条件
|
|
58
62
|
|
|
@@ -62,40 +66,16 @@
|
|
|
62
66
|
|
|
63
67
|
## 安装
|
|
64
68
|
|
|
65
|
-
|
|
69
|
+
以下安装命令使用官方 npm 源。
|
|
66
70
|
|
|
67
|
-
###
|
|
71
|
+
### 让 Agent 帮你安装（推荐）
|
|
68
72
|
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
从 npm 安装：
|
|
73
|
+
把下面这段话发给任意能够执行本机终端命令的 Agent。将 `web` 替换为实际使用的 profile；安装完成后，在 DSH 中使用本插件。
|
|
72
74
|
|
|
73
75
|
```text
|
|
74
|
-
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
从源码安装：
|
|
78
|
-
|
|
79
|
-
```text
|
|
80
|
-
请从源码安装 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 后硬刷新浏览器。
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
| 产品 | 怎么用 |
|
|
84
|
-
| --- | --- |
|
|
85
|
-
| DSH | 把上面其中一句发给当前会话。 |
|
|
86
|
-
| Codex | 把上面其中一句发给 Codex，让它在本机执行安装。 |
|
|
87
|
-
| WorkBuddy | 把上面其中一句发给 WorkBuddy；源码安装也可同时粘贴仓库地址 `https://github.com/MichengAI/dsh-agency-agents`。 |
|
|
88
|
-
|
|
89
|
-
Codex 和 WorkBuddy 只负责代装；装好后仍要打开 DSH Web 使用「设置 → 专家」。
|
|
90
|
-
|
|
91
|
-
也可以自己执行同一条 npm 命令：
|
|
92
|
-
|
|
93
|
-
```powershell
|
|
94
|
-
dsh plugin --profile web add @michengai/dsh-agency-agents@latest --registry=https://registry.npmjs.org/
|
|
76
|
+
请将 DSH 插件 @michengai/dsh-agency-agents 安装到本机 web profile，执行：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 和开始使用。
|
|
95
77
|
```
|
|
96
78
|
|
|
97
|
-
未把 `dsh` 装进 PATH 时，把开头的 `dsh` 换成 `npx --yes @deepseek-ai/dsh`。
|
|
98
|
-
|
|
99
79
|
### 从官方 npm 安装最新版
|
|
100
80
|
|
|
101
81
|
在任意 PowerShell 目录执行：
|
|
@@ -111,24 +91,6 @@ dsh --profile web --dump-config
|
|
|
111
91
|
|
|
112
92
|
配置输出中应包含 `agency-agents` 与 `agency-agents-remote`。安装后重启 DSH Web 并在浏览器硬刷新；请勿手工复制客户端文件，否则设置页所需的 Remote 服务不会被挂载。
|
|
113
93
|
|
|
114
|
-
### 从源码安装
|
|
115
|
-
|
|
116
|
-
适用于调试或使用未发布改动。克隆后的本地路径就是插件安装路径：
|
|
117
|
-
|
|
118
|
-
```powershell
|
|
119
|
-
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
120
|
-
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
121
|
-
Set-Location D:\Repository\deepseek-harness-plugin
|
|
122
|
-
git clone https://github.com/MichengAI/dsh-agency-agents.git
|
|
123
|
-
Set-Location .\dsh-agency-agents
|
|
124
|
-
pnpm install --frozen-lockfile
|
|
125
|
-
pnpm build
|
|
126
|
-
dsh plugin --profile web add .
|
|
127
|
-
dsh --profile web --dump-config
|
|
128
|
-
```
|
|
129
|
-
|
|
130
|
-
完成后重启 DSH Web 并硬刷新浏览器。`dsh plugin ... add .` 会读取当前目录的包信息和 `cordis.patch.yml`；不要改为直接复制 `lib` 目录。
|
|
131
|
-
|
|
132
94
|
## 在线更新
|
|
133
95
|
|
|
134
96
|
设置标题会显示当前版本和“检查更新”按钮。发现新版后，只有检测到 DSH CLI 或 Desktop 更新服务时才可使用“自动更新”；其他环境会在弹窗中提供可复制、与当前 Profile 对应的手工更新命令。
|
|
@@ -730,6 +692,24 @@ dsh --profile web --dump-config
|
|
|
730
692
|
|
|
731
693
|
## 二次开发
|
|
732
694
|
|
|
695
|
+
### 从源码安装
|
|
696
|
+
|
|
697
|
+
适用于调试或使用未发布改动。克隆后的本地路径就是插件安装路径：
|
|
698
|
+
|
|
699
|
+
```powershell
|
|
700
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
701
|
+
$OutputEncoding = [System.Text.Encoding]::UTF8
|
|
702
|
+
Set-Location D:\Repository\deepseek-harness-plugin
|
|
703
|
+
git clone https://github.com/MichengAI/dsh-agency-agents.git
|
|
704
|
+
Set-Location .\dsh-agency-agents
|
|
705
|
+
pnpm install --frozen-lockfile
|
|
706
|
+
pnpm build
|
|
707
|
+
dsh plugin --profile web add .
|
|
708
|
+
dsh --profile web --dump-config
|
|
709
|
+
```
|
|
710
|
+
|
|
711
|
+
完成后重启 DSH Web 并硬刷新浏览器。`dsh plugin ... add .` 会读取当前目录的包信息和 `cordis.patch.yml`；不要改为直接复制 `lib` 目录。
|
|
712
|
+
|
|
733
713
|
- Host 端入口：[src\index.ts](src/index.ts)，负责加载专家目录、注册工具和设置项。
|
|
734
714
|
- Remote 契约与实现：[src\remote-contract.ts](src/remote-contract.ts)、[src\remote.ts](src/remote.ts)。
|
|
735
715
|
- 客户端入口：[src\client\index.ts](src/client/index.ts)，负责设置页、输入框按钮与 `@` 触发器。
|
|
@@ -746,8 +726,6 @@ pnpm verify
|
|
|
746
726
|
dsh plugin --profile web add .
|
|
747
727
|
```
|
|
748
728
|
|
|
749
|
-
交接与迭代文档只保留在本机 `docs` 目录，不纳入 Git；克隆仓库后不会得到交接入口。
|
|
750
|
-
|
|
751
729
|
发布包只包含 `lib`、`assets`、补丁和根目录说明/许可证；不要将 `node_modules` 或本地开发文件加入发布内容。
|
|
752
730
|
|
|
753
731
|
## 验证
|
|
@@ -762,10 +740,12 @@ pnpm verify
|
|
|
762
740
|
|
|
763
741
|
`prepublishOnly` 会在发布前依次执行上述构建、测试和包完整性检查。
|
|
764
742
|
|
|
765
|
-
##
|
|
743
|
+
## 自定义专家
|
|
766
744
|
|
|
767
|
-
|
|
745
|
+
在「设置 → 专家」点击「新建专家」，填写名称、简介、分类和专家提示词，可分别选择头像与召唤 Emoji（默认 🧩）。「保存并启用」后立即通过 @ 或专家按钮选择；标签与内置专家一致，显示统一专家图标和纯名称；Emoji 用于候选菜单。基础专家可复制为自定义，自定义专家可编辑、启停、删除，删除会永久移除专家内容及启用状态，无法撤销。
|
|
768
746
|
|
|
769
|
-
|
|
747
|
+
数据保存在 DSH settings 的 agency-agents 命名空间，独立于插件目录，升级保留。外部 root 仍替换基础名册，自定义专家追加到该名册；嵌套目录专家的查看、复制与召唤均读取名册选中的实际文件。最多保留 200 位自定义专家，删除立即释放名额；旧版已删除记录在启动及后续写入时清理。内置或外部目录更新导致的名称冲突会在设置页标记，允许改名或删除，冲突专家暂停召唤。多窗口冲突时在当前编辑器保留草稿，可读取最新内容并核对，选择继续使用草稿或载入最新内容后再保存；已删除专家只能作为新专家继续。停用的草稿标签需移除或重新启用，已删除或冲突的标签需移除并重新选择。写入携带修订号，协议以 [Remote 契约](src/remote-contract.ts) 为准。回退旧插件前应备份最新 settings，自定义数据的恢复与代码回退分开处理。
|
|
770
748
|
|
|
771
|
-
|
|
749
|
+
## 许可证与归属
|
|
750
|
+
|
|
751
|
+
本项目 TypeScript 源码、构建脚本和文档采用 [Apache License 2.0](LICENSE)。内置专家 persona 源自 [The Agency](https://github.com/msitarzewski/agency-agents)，仍采用 MIT，许可证位于 [assets\agency-agents\LICENSE](assets/agency-agents/LICENSE)。
|