dsh-enhancement-suite 0.1.2 → 0.1.3

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/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Scorp1o117
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Scorp1o117
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,122 +1,124 @@
1
- # DeepSeek Harness Enhancement Suite
2
-
3
- [![中文文档](https://img.shields.io/badge/%E4%B8%AD%E6%96%87%E6%96%87%E6%A1%A3-blue)](README.zh.md) [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D22.18-green)](package.json)
4
-
5
- **Vision · Soul / Persona · Long-term Memory · Plugin Marketplace**
6
-
7
- The official entry point and one-command installer for the four Scorp1o117 plugins that enhance [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). This suite is a real installer — not a link collection: it drives the official `dsh plugin` CLI, mounts what needs mounting, and checks the result.
8
-
9
- > **This repository does not vendor or replace the individual plugins.**
10
- > **Each plugin remains independently maintained in its own upstream repository.**
11
-
12
- ---
13
-
14
- ## 👁️ dsh-tool-vision
15
-
16
- 给文本模型增加视觉能力和图片桥接。
17
-
18
- [![npm](https://img.shields.io/npm/v/dsh-tool-vision)](https://www.npmjs.com/package/dsh-tool-vision) [![license](https://img.shields.io/npm/l/dsh-tool-vision)](https://github.com/Scorp1o117/dsh-tool-vision/blob/main/LICENSE)
19
-
20
- [→ upstream repository](https://github.com/Scorp1o117/dsh-tool-vision)
21
-
22
- ## 🎭 dsh-soul-md
23
-
24
- 为 Agent 增加 soul.md 人设、会话/工作区 Persona 和可演化人格。
25
-
26
- [![npm](https://img.shields.io/npm/v/dsh-soul-md)](https://www.npmjs.com/package/dsh-soul-md) [![license](https://img.shields.io/npm/l/dsh-soul-md)](https://github.com/Scorp1o117/dsh-soul-md/blob/main/LICENSE)
27
-
28
- [→ upstream repository](https://github.com/Scorp1o117/dsh-soul-md)
29
-
30
- ## 🧠 dsh-tdai-memory
31
-
32
- 完整的长期分层记忆、召回与搜索。
33
-
34
- [![npm](https://img.shields.io/npm/v/dsh-tdai-memory)](https://www.npmjs.com/package/dsh-tdai-memory) [![license](https://img.shields.io/npm/l/dsh-tdai-memory)](https://github.com/Scorp1o117/dsh-tdai-memory/blob/main/LICENSE)
35
-
36
- [→ upstream repository](https://github.com/Scorp1o117/dsh-tdai-memory)
37
-
38
- ## 🛒 dsh-plugin-marketplace
39
-
40
- 直接在 DSH Web UI 中发现和浏览插件。
41
-
42
- [![npm](https://img.shields.io/npm/v/dsh-plugin-marketplace)](https://www.npmjs.com/package/dsh-plugin-marketplace) [![license](https://img.shields.io/npm/l/dsh-plugin-marketplace)](https://github.com/Scorp1o117/dsh-plugin-marketplace/blob/main/LICENSE)
43
-
44
- [→ upstream repository](https://github.com/Scorp1o117/dsh-plugin-marketplace)
45
-
46
- ---
47
-
48
- ## Requirements
49
-
50
- - **Node.js >= 22.18** — the full suite inherits the `dsh-tdai-memory` engine requirement
51
- - **dsh CLI** on `PATH` — the official DeepSeek Harness CLI (`dsh plugin --profile <p> add <pkg>` is the install mechanism)
52
- - A target profile (default: `web`)
53
-
54
- ## Install & usage
55
-
56
- From this repository (no install needed):
57
-
58
- ```bash
59
- node bin/dsh-enhance.mjs list
60
- node bin/dsh-enhance.mjs install --dry-run
61
- node bin/dsh-enhance.mjs install
62
- node bin/dsh-enhance.mjs doctor
63
- ```
64
-
65
- As a global command (once published to npm):
66
-
67
- ```bash
68
- npm install -g dsh-enhancement-suite
69
- dsh-enhance list
70
- dsh-enhance install
71
- ```
72
-
73
- ## CLI
74
-
75
- ```
76
- dsh-enhance list Show the plugin registry (installed state per profile)
77
- dsh-enhance install Install all four plugins into a profile
78
- dsh-enhance update Update installed plugins to the latest versions
79
- dsh-enhance doctor Check Node, dsh CLI, profile and per-plugin state
80
-
81
- --profile <name> target profile (default: web)
82
- --only <keys> comma-separated selection: vision,soul,memory,marketplace (or package names)
83
- --dry-run print what would run without executing anything
84
- ```
85
-
86
- Examples:
87
-
88
- ```bash
89
- dsh-enhance install --dry-run # preview everything
90
- dsh-enhance install --profile web --only vision,soul
91
- dsh-enhance update --profile headless
92
- ```
93
-
94
- ## How it installs
95
-
96
- 1. Every plugin is installed through the **official CLI**: `dsh plugin --profile <profile> add <package>`. This suite never loads the plugins through its own dependency graph or its own cordis patch — the four upstream packages stay independent in the profile.
97
- 2. All four plugins now declare `dsh.bundle.patch` (as of vision 0.3.9 / soul-md 0.5.4 / tdai-memory 0.2.9 / marketplace 0.2.4), so `dsh plugin add` reconciles each into `dsh.profile.bundles` and its own bundle layer auto-mounts it.
98
- 3. For profiles that mounted a plugin manually before it gained its bundle manifest, the suite **removes the stale manual row** from `cordis.patch.yml` — two mounts of the same entry id would abort boot. (Non-bundle third-party plugins still get the safe idempotent mount logic: empty `[]` patches are replaced correctly, duplicates are skipped, flow-style arrays are refused instead of corrupted.)
99
- 4. Restart `dsh web` and the plugins load.
100
-
101
- Every step reports a clear `✓` / `✗`, failures are never swallowed, and no API key is read, printed, or forwarded.
102
-
103
- ## Integration / Adoption
104
-
105
- The following plugins are adopted and shipped built-in by the **Deepseek Harness EAC** desktop client:
106
-
107
- - 👁️ `dsh-tool-vision`
108
- - 🎭 `dsh-soul-md`
109
- - 🧠 `dsh-tdai-memory`
110
-
111
- [Deepseek-Harness-EAC](https://github.com/zouyuxuan122/Deepseek-Harness-EAC)
112
-
113
- > Note: EAC's built-in marketplace implementation is a separate project; it does not use `dsh-plugin-marketplace`.
114
-
115
- ## Documentation
116
-
117
- - [Architecture](docs/architecture.md) — design decisions, manifest schema, safety rules
118
- - [plugins.json](plugins.json) — the plugin manifest (npm name, repo, category, display name, description)
119
-
120
- ## License
121
-
122
- MIT — see [LICENSE](LICENSE). Each plugin keeps its own MIT license in its upstream repository.
1
+ # DeepSeek Harness Enhancement Suite
2
+
3
+ [![中文文档](https://img.shields.io/badge/%E4%B8%AD%E6%96%87%E6%96%87%E6%A1%A3-blue)](README.zh.md) [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D22.18-green)](package.json)
4
+
5
+ **Vision · Soul / Persona · Long-term Memory · Plugin Marketplace**
6
+
7
+ The official entry point and one-command installer for the four Scorp1o117 plugins that enhance [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH). This suite is a real installer — not a link collection: it drives the official `dsh plugin` CLI, mounts what needs mounting, and checks the result.
8
+
9
+ Version 0.1.3 is validated with DSH `0.1.1-rc.1` and reports pnpm native-build policy failures explicitly.
10
+
11
+ > **This repository does not vendor or replace the individual plugins.**
12
+ > **Each plugin remains independently maintained in its own upstream repository.**
13
+
14
+ ---
15
+
16
+ ## 👁️ dsh-tool-vision
17
+
18
+ 给文本模型增加视觉能力和图片桥接。
19
+
20
+ [![npm](https://img.shields.io/npm/v/dsh-tool-vision)](https://www.npmjs.com/package/dsh-tool-vision) [![license](https://img.shields.io/npm/l/dsh-tool-vision)](https://github.com/Scorp1o117/dsh-tool-vision/blob/main/LICENSE)
21
+
22
+ [→ upstream repository](https://github.com/Scorp1o117/dsh-tool-vision)
23
+
24
+ ## 🎭 dsh-soul-md
25
+
26
+ 为 Agent 增加 soul.md 人设、会话/工作区 Persona 和可演化人格。
27
+
28
+ [![npm](https://img.shields.io/npm/v/dsh-soul-md)](https://www.npmjs.com/package/dsh-soul-md) [![license](https://img.shields.io/npm/l/dsh-soul-md)](https://github.com/Scorp1o117/dsh-soul-md/blob/main/LICENSE)
29
+
30
+ [→ upstream repository](https://github.com/Scorp1o117/dsh-soul-md)
31
+
32
+ ## 🧠 dsh-tdai-memory
33
+
34
+ 完整的长期分层记忆、召回与搜索。
35
+
36
+ [![npm](https://img.shields.io/npm/v/dsh-tdai-memory)](https://www.npmjs.com/package/dsh-tdai-memory) [![license](https://img.shields.io/npm/l/dsh-tdai-memory)](https://github.com/Scorp1o117/dsh-tdai-memory/blob/main/LICENSE)
37
+
38
+ [→ upstream repository](https://github.com/Scorp1o117/dsh-tdai-memory)
39
+
40
+ ## 🛒 dsh-plugin-marketplace
41
+
42
+ 直接在 DSH Web UI 中发现和浏览插件。
43
+
44
+ [![npm](https://img.shields.io/npm/v/dsh-plugin-marketplace)](https://www.npmjs.com/package/dsh-plugin-marketplace) [![license](https://img.shields.io/npm/l/dsh-plugin-marketplace)](https://github.com/Scorp1o117/dsh-plugin-marketplace/blob/main/LICENSE)
45
+
46
+ [→ upstream repository](https://github.com/Scorp1o117/dsh-plugin-marketplace)
47
+
48
+ ---
49
+
50
+ ## Requirements
51
+
52
+ - **Node.js >= 22.18** — the full suite inherits the `dsh-tdai-memory` engine requirement
53
+ - **dsh CLI** on `PATH` — the official DeepSeek Harness CLI (`dsh plugin --profile <p> add <pkg>` is the install mechanism)
54
+ - A target profile (default: `web`)
55
+
56
+ ## Install & usage
57
+
58
+ From this repository (no install needed):
59
+
60
+ ```bash
61
+ node bin/dsh-enhance.mjs list
62
+ node bin/dsh-enhance.mjs install --dry-run
63
+ node bin/dsh-enhance.mjs install
64
+ node bin/dsh-enhance.mjs doctor
65
+ ```
66
+
67
+ As a global command (once published to npm):
68
+
69
+ ```bash
70
+ npm install -g dsh-enhancement-suite
71
+ dsh-enhance list
72
+ dsh-enhance install
73
+ ```
74
+
75
+ ## CLI
76
+
77
+ ```
78
+ dsh-enhance list Show the plugin registry (installed state per profile)
79
+ dsh-enhance install Install all four plugins into a profile
80
+ dsh-enhance update Update installed plugins to the latest versions
81
+ dsh-enhance doctor Check Node, dsh CLI, profile and per-plugin state
82
+
83
+ --profile <name> target profile (default: web)
84
+ --only <keys> comma-separated selection: vision,soul,memory,marketplace (or package names)
85
+ --dry-run print what would run without executing anything
86
+ ```
87
+
88
+ Examples:
89
+
90
+ ```bash
91
+ dsh-enhance install --dry-run # preview everything
92
+ dsh-enhance install --profile web --only vision,soul
93
+ dsh-enhance update --profile headless
94
+ ```
95
+
96
+ ## How it installs
97
+
98
+ 1. Every plugin is installed through the **official CLI**: `dsh plugin --profile <profile> add <package>`. This suite never loads the plugins through its own dependency graph or its own cordis patch — the four upstream packages stay independent in the profile.
99
+ 2. All four plugins now declare `dsh.bundle.patch` (as of vision 0.3.9 / soul-md 0.5.4 / tdai-memory 0.2.9 / marketplace 0.2.4), so `dsh plugin add` reconciles each into `dsh.profile.bundles` and its own bundle layer auto-mounts it.
100
+ 3. For profiles that mounted a plugin manually before it gained its bundle manifest, the suite **removes the stale manual row** from `cordis.patch.yml` — two mounts of the same entry id would abort boot. (Non-bundle third-party plugins still get the safe idempotent mount logic: empty `[]` patches are replaced correctly, duplicates are skipped, flow-style arrays are refused instead of corrupted.)
101
+ 4. Restart `dsh web` and the plugins load.
102
+
103
+ Every step reports a clear `✓` / `✗`, failures are never swallowed, and no API key is read, printed, or forwarded.
104
+
105
+ ## Integration / Adoption
106
+
107
+ The following plugins are adopted and shipped built-in by the **Deepseek Harness EAC** desktop client:
108
+
109
+ - 👁️ `dsh-tool-vision`
110
+ - 🎭 `dsh-soul-md`
111
+ - 🧠 `dsh-tdai-memory`
112
+
113
+ [Deepseek-Harness-EAC](https://github.com/zouyuxuan122/Deepseek-Harness-EAC)
114
+
115
+ > Note: EAC's built-in marketplace implementation is a separate project; it does not use `dsh-plugin-marketplace`.
116
+
117
+ ## Documentation
118
+
119
+ - [Architecture](docs/architecture.md) — design decisions, manifest schema, safety rules
120
+ - [plugins.json](plugins.json) — the plugin manifest (npm name, repo, category, display name, description)
121
+
122
+ ## License
123
+
124
+ MIT — see [LICENSE](LICENSE). Each plugin keeps its own MIT license in its upstream repository.
package/README.zh.md CHANGED
@@ -1,122 +1,124 @@
1
- # DeepSeek Harness Enhancement Suite
2
-
3
- [![English](https://img.shields.io/badge/English-blue)](README.md) [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D22.18-green)](package.json)
4
-
5
- **Vision · Soul / Persona · Long-term Memory · Plugin Marketplace**
6
-
7
- 四个 Scorp1o117 插件的官方总入口和一键安装套件,为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)增强能力。这是一个真正可用的一键安装器,而不是链接合集:它驱动官方 `dsh plugin` CLI、自动处理挂载、并检查结果。
8
-
9
- > **本仓库不复制、不替代任何独立插件。**
10
- > **每个插件都在各自的 upstream 仓库独立维护。**
11
-
12
- ---
13
-
14
- ## 👁️ dsh-tool-vision
15
-
16
- 给文本模型增加视觉能力和图片桥接。
17
-
18
- [![npm](https://img.shields.io/npm/v/dsh-tool-vision)](https://www.npmjs.com/package/dsh-tool-vision) [![license](https://img.shields.io/npm/l/dsh-tool-vision)](https://github.com/Scorp1o117/dsh-tool-vision/blob/main/LICENSE)
19
-
20
- [→ upstream 仓库](https://github.com/Scorp1o117/dsh-tool-vision)
21
-
22
- ## 🎭 dsh-soul-md
23
-
24
- 为 Agent 增加 soul.md 人设、会话/工作区 Persona 和可演化人格。
25
-
26
- [![npm](https://img.shields.io/npm/v/dsh-soul-md)](https://www.npmjs.com/package/dsh-soul-md) [![license](https://img.shields.io/npm/l/dsh-soul-md)](https://github.com/Scorp1o117/dsh-soul-md/blob/main/LICENSE)
27
-
28
- [→ upstream 仓库](https://github.com/Scorp1o117/dsh-soul-md)
29
-
30
- ## 🧠 dsh-tdai-memory
31
-
32
- 完整的长期分层记忆、召回与搜索。
33
-
34
- [![npm](https://img.shields.io/npm/v/dsh-tdai-memory)](https://www.npmjs.com/package/dsh-tdai-memory) [![license](https://img.shields.io/npm/l/dsh-tdai-memory)](https://github.com/Scorp1o117/dsh-tdai-memory/blob/main/LICENSE)
35
-
36
- [→ upstream 仓库](https://github.com/Scorp1o117/dsh-tdai-memory)
37
-
38
- ## 🛒 dsh-plugin-marketplace
39
-
40
- 直接在 DSH Web UI 中发现和浏览插件。
41
-
42
- [![npm](https://img.shields.io/npm/v/dsh-plugin-marketplace)](https://www.npmjs.com/package/dsh-plugin-marketplace) [![license](https://img.shields.io/npm/l/dsh-plugin-marketplace)](https://github.com/Scorp1o117/dsh-plugin-marketplace/blob/main/LICENSE)
43
-
44
- [→ upstream 仓库](https://github.com/Scorp1o117/dsh-plugin-marketplace)
45
-
46
- ---
47
-
48
- ## 环境要求
49
-
50
- - **Node.js >= 22.18** —— 完整套件继承 `dsh-tdai-memory` 的引擎要求
51
- - **dsh CLI** 在 `PATH` 上 —— 安装机制是官方 CLI:`dsh plugin --profile <p> add <pkg>`
52
- - 目标 profile(默认:`web`)
53
-
54
- ## 安装与使用
55
-
56
- 从本仓库直接运行(无需安装):
57
-
58
- ```bash
59
- node bin/dsh-enhance.mjs list
60
- node bin/dsh-enhance.mjs install --dry-run
61
- node bin/dsh-enhance.mjs install
62
- node bin/dsh-enhance.mjs doctor
63
- ```
64
-
65
- 发布到 npm 后作为全局命令使用:
66
-
67
- ```bash
68
- npm install -g dsh-enhancement-suite
69
- dsh-enhance list
70
- dsh-enhance install
71
- ```
72
-
73
- ## CLI
74
-
75
- ```
76
- dsh-enhance list 查看插件清单(含 profile 内的安装状态)
77
- dsh-enhance install 把四个插件安装进 profile
78
- dsh-enhance update 更新已安装插件到最新版本
79
- dsh-enhance doctor 检查 Node、dsh CLI、profile 与各插件状态
80
-
81
- --profile <name> 目标 profile(默认:web)
82
- --only <keys> 逗号分隔的选择:vision,soul,memory,marketplace(或包名)
83
- --dry-run 只打印将要执行的操作,不实际执行
84
- ```
85
-
86
- 示例:
87
-
88
- ```bash
89
- dsh-enhance install --dry-run # 预览全部操作
90
- dsh-enhance install --profile web --only vision,soul
91
- dsh-enhance update --profile headless
92
- ```
93
-
94
- ## 安装方式
95
-
96
- 1. 每个插件都通过**官方 CLI** 安装:`dsh plugin --profile <profile> add <package>`。本套件绝不通过自身的依赖图或自己的 cordis patch 间接加载插件——四个 upstream 包在 profile 中保持独立。
97
- 2. `dsh-plugin-marketplace` 声明了 `dsh.bundle.patch`,`dsh plugin add` 会把它对账进 `dsh.profile.bundles`,由 bundle 层自动挂载。
98
- 3. 其余三个是普通依赖;套件用与 marketplace 一键安装相同的安全、幂等逻辑,把挂载行追加到 profile 的 `cordis.patch.yml`(空 `[]` 补丁会被正确替换、重复挂载会被跳过、流式数组会被拒绝而不是损坏)。
99
- 4. 重启 `dsh web` 即可加载。
100
-
101
- 每一步都有清晰的 `✓` / `✗` 反馈,失败绝不吞掉,且不读取、不打印任何 API Key。
102
-
103
- ## 集成 / 采用
104
-
105
- 以下插件已被 **Deepseek Harness EAC** 桌面客户端内置采用:
106
-
107
- - 👁️ `dsh-tool-vision`
108
- - 🎭 `dsh-soul-md`
109
- - 🧠 `dsh-tdai-memory`
110
-
111
- [Deepseek-Harness-EAC](https://github.com/zouyuxuan122/Deepseek-Harness-EAC)
112
-
113
- > 注意:EAC 内置的 marketplace 实现是另一个项目,并没有使用 `dsh-plugin-marketplace`。
114
-
115
- ## 文档
116
-
117
- - [架构说明](docs/architecture.md) —— 设计决策、manifest 结构、安全规则
118
- - [plugins.json](plugins.json) —— 插件 manifest(npm 包名、仓库、分类、显示名、描述)
119
-
120
- ## License
121
-
122
- MIT —— 见 [LICENSE](LICENSE)。各插件在各自 upstream 仓库保留独立的 MIT License。
1
+ # DeepSeek Harness Enhancement Suite
2
+
3
+ [![English](https://img.shields.io/badge/English-blue)](README.md) [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D22.18-green)](package.json)
4
+
5
+ **Vision · Soul / Persona · Long-term Memory · Plugin Marketplace**
6
+
7
+ 四个 Scorp1o117 插件的官方总入口和一键安装套件,为 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)增强能力。这是一个真正可用的一键安装器,而不是链接合集:它驱动官方 `dsh plugin` CLI、自动处理挂载、并检查结果。
8
+
9
+ 0.1.3 已针对 DSH `0.1.1-rc.1` 验证,并会明确识别 pnpm 原生依赖构建策略导致的安装失败。
10
+
11
+ > **本仓库不复制、不替代任何独立插件。**
12
+ > **每个插件都在各自的 upstream 仓库独立维护。**
13
+
14
+ ---
15
+
16
+ ## 👁️ dsh-tool-vision
17
+
18
+ 给文本模型增加视觉能力和图片桥接。
19
+
20
+ [![npm](https://img.shields.io/npm/v/dsh-tool-vision)](https://www.npmjs.com/package/dsh-tool-vision) [![license](https://img.shields.io/npm/l/dsh-tool-vision)](https://github.com/Scorp1o117/dsh-tool-vision/blob/main/LICENSE)
21
+
22
+ [→ upstream 仓库](https://github.com/Scorp1o117/dsh-tool-vision)
23
+
24
+ ## 🎭 dsh-soul-md
25
+
26
+ 为 Agent 增加 soul.md 人设、会话/工作区 Persona 和可演化人格。
27
+
28
+ [![npm](https://img.shields.io/npm/v/dsh-soul-md)](https://www.npmjs.com/package/dsh-soul-md) [![license](https://img.shields.io/npm/l/dsh-soul-md)](https://github.com/Scorp1o117/dsh-soul-md/blob/main/LICENSE)
29
+
30
+ [→ upstream 仓库](https://github.com/Scorp1o117/dsh-soul-md)
31
+
32
+ ## 🧠 dsh-tdai-memory
33
+
34
+ 完整的长期分层记忆、召回与搜索。
35
+
36
+ [![npm](https://img.shields.io/npm/v/dsh-tdai-memory)](https://www.npmjs.com/package/dsh-tdai-memory) [![license](https://img.shields.io/npm/l/dsh-tdai-memory)](https://github.com/Scorp1o117/dsh-tdai-memory/blob/main/LICENSE)
37
+
38
+ [→ upstream 仓库](https://github.com/Scorp1o117/dsh-tdai-memory)
39
+
40
+ ## 🛒 dsh-plugin-marketplace
41
+
42
+ 直接在 DSH Web UI 中发现和浏览插件。
43
+
44
+ [![npm](https://img.shields.io/npm/v/dsh-plugin-marketplace)](https://www.npmjs.com/package/dsh-plugin-marketplace) [![license](https://img.shields.io/npm/l/dsh-plugin-marketplace)](https://github.com/Scorp1o117/dsh-plugin-marketplace/blob/main/LICENSE)
45
+
46
+ [→ upstream 仓库](https://github.com/Scorp1o117/dsh-plugin-marketplace)
47
+
48
+ ---
49
+
50
+ ## 环境要求
51
+
52
+ - **Node.js >= 22.18** —— 完整套件继承 `dsh-tdai-memory` 的引擎要求
53
+ - **dsh CLI** 在 `PATH` 上 —— 安装机制是官方 CLI:`dsh plugin --profile <p> add <pkg>`
54
+ - 目标 profile(默认:`web`)
55
+
56
+ ## 安装与使用
57
+
58
+ 从本仓库直接运行(无需安装):
59
+
60
+ ```bash
61
+ node bin/dsh-enhance.mjs list
62
+ node bin/dsh-enhance.mjs install --dry-run
63
+ node bin/dsh-enhance.mjs install
64
+ node bin/dsh-enhance.mjs doctor
65
+ ```
66
+
67
+ 发布到 npm 后作为全局命令使用:
68
+
69
+ ```bash
70
+ npm install -g dsh-enhancement-suite
71
+ dsh-enhance list
72
+ dsh-enhance install
73
+ ```
74
+
75
+ ## CLI
76
+
77
+ ```
78
+ dsh-enhance list 查看插件清单(含 profile 内的安装状态)
79
+ dsh-enhance install 把四个插件安装进 profile
80
+ dsh-enhance update 更新已安装插件到最新版本
81
+ dsh-enhance doctor 检查 Node、dsh CLI、profile 与各插件状态
82
+
83
+ --profile <name> 目标 profile(默认:web)
84
+ --only <keys> 逗号分隔的选择:vision,soul,memory,marketplace(或包名)
85
+ --dry-run 只打印将要执行的操作,不实际执行
86
+ ```
87
+
88
+ 示例:
89
+
90
+ ```bash
91
+ dsh-enhance install --dry-run # 预览全部操作
92
+ dsh-enhance install --profile web --only vision,soul
93
+ dsh-enhance update --profile headless
94
+ ```
95
+
96
+ ## 安装方式
97
+
98
+ 1. 每个插件都通过**官方 CLI** 安装:`dsh plugin --profile <profile> add <package>`。本套件绝不通过自身的依赖图或自己的 cordis patch 间接加载插件——四个 upstream 包在 profile 中保持独立。
99
+ 2. `dsh-plugin-marketplace` 声明了 `dsh.bundle.patch`,`dsh plugin add` 会把它对账进 `dsh.profile.bundles`,由 bundle 层自动挂载。
100
+ 3. 其余三个是普通依赖;套件用与 marketplace 一键安装相同的安全、幂等逻辑,把挂载行追加到 profile 的 `cordis.patch.yml`(空 `[]` 补丁会被正确替换、重复挂载会被跳过、流式数组会被拒绝而不是损坏)。
101
+ 4. 重启 `dsh web` 即可加载。
102
+
103
+ 每一步都有清晰的 `✓` / `✗` 反馈,失败绝不吞掉,且不读取、不打印任何 API Key。
104
+
105
+ ## 集成 / 采用
106
+
107
+ 以下插件已被 **Deepseek Harness EAC** 桌面客户端内置采用:
108
+
109
+ - 👁️ `dsh-tool-vision`
110
+ - 🎭 `dsh-soul-md`
111
+ - 🧠 `dsh-tdai-memory`
112
+
113
+ [Deepseek-Harness-EAC](https://github.com/zouyuxuan122/Deepseek-Harness-EAC)
114
+
115
+ > 注意:EAC 内置的 marketplace 实现是另一个项目,并没有使用 `dsh-plugin-marketplace`。
116
+
117
+ ## 文档
118
+
119
+ - [架构说明](docs/architecture.md) —— 设计决策、manifest 结构、安全规则
120
+ - [plugins.json](plugins.json) —— 插件 manifest(npm 包名、仓库、分类、显示名、描述)
121
+
122
+ ## License
123
+
124
+ MIT —— 见 [LICENSE](LICENSE)。各插件在各自 upstream 仓库保留独立的 MIT License。