dsh-plugin-tool-management 0.1.3 → 0.2.0
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 +211 -151
- package/README_EN.md +216 -151
- package/docs/images/agents-md.png +0 -0
- package/docs/images/history.png +0 -0
- package/docs/images/mcp.png +0 -0
- package/docs/images/skills.png +0 -0
- package/docs/images//345/234/272/346/231/257/350/256/260/345/277/206.png +0 -0
- package/lib/client.js +2123 -1407
- package/lib/index.js +117 -1
- package/lib/rules/provider.js +121 -0
- package/lib/rules/service.js +1657 -0
- package/lib/skills/core.js +10 -1
- package/lib/skills/service.js +5 -5
- package/package.json +10 -11
- package/screenshots.json +7 -0
package/README.md
CHANGED
|
@@ -1,96 +1,104 @@
|
|
|
1
|
-
# dsh-plugin-tool-management
|
|
2
|
-
|
|
3
|
-
[](https://www.npmjs.com/package/dsh-plugin-tool-management)
|
|
4
|
-
[](LICENSE)
|
|
5
|
-
[](package.json)
|
|
1
|
+
# dsh-plugin-tool-management
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/dsh-plugin-tool-management)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](package.json)
|
|
6
6
|
[](https://github.com/ouli-1242/dsh-plugin-tool-management)
|
|
7
7
|
|
|
8
|
-
**简体中文** · [English](README_EN.md)
|
|
9
|
-
|
|
10
|
-
**DeepSeek Harness 的 MCP
|
|
11
|
-
|
|
12
|
-
- **MCP**：连接了哪些服务、每个服务有哪些工具、哪些工具该让模型用——增删改查、启停、重启，全部即改即生效；
|
|
13
|
-
- **Skills**：本机各处的技能（DSH / Agents / Codex / Claude / 项目级 / 你自己指定的任意目录）一目了然，逐个或整组启停、创建、导入、回收；
|
|
14
|
-
- **AGENTS.md**：管理多套全局指令基线预设，一键「应用」写入 `~/.dsh/AGENTS.md`，新会话生效、当前会话不变；
|
|
15
|
-
- **History
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
|
45
|
-
|
|
46
|
-
|
|
|
47
|
-
|
|
|
48
|
-
|
|
|
49
|
-
|
|
|
50
|
-
|
|
|
51
|
-
|
|
|
52
|
-
|
|
|
53
|
-
|
|
|
54
|
-
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
dsh
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
###
|
|
90
|
-
|
|
91
|
-
-
|
|
92
|
-
-
|
|
93
|
-
-
|
|
8
|
+
**简体中文** · [English](README_EN.md)
|
|
9
|
+
|
|
10
|
+
**DeepSeek Harness 的 MCP 服务、技能与记忆管理插件。** 一个设置面板管好五件事：
|
|
11
|
+
|
|
12
|
+
- **MCP**：连接了哪些服务、每个服务有哪些工具、哪些工具该让模型用——增删改查、启停、重启，全部即改即生效；
|
|
13
|
+
- **Skills**：本机各处的技能（DSH / Agents / Codex / Claude / 项目级 / 你自己指定的任意目录）一目了然，逐个或整组启停、创建、导入、回收；
|
|
14
|
+
- **AGENTS.md**：管理多套全局指令基线预设，一键「应用」写入 `~/.dsh/AGENTS.md`，新会话生效、当前会话不变；
|
|
15
|
+
- **History**：已归档会话统一管理，按项目分组、批量恢复/删除，对话导入/导出，保留期自动清理；
|
|
16
|
+
- **场景记忆**：`~/.dsh/scene-memory/<场景>/` 下一个文件夹 = 一个场景、一个 `.md` = 一条记忆——**新建场景**、往里放 `.md`（文件名支持中文）、开关场景；启用场景里的记忆正文**整篇自动进入系统提示词**，不用每次重复解释。
|
|
17
|
+
|
|
18
|
+
不手改 `cordis.patch.yml`，不碰任何技能源文件，重启与升级后配置依旧。
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
<!-- 图片占位 1：MCP 管理页截图 → docs/images/mcp.png -->
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
<!-- 图片占位 2：Skills 管理页截图 → docs/images/skills.png -->
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
<!-- 图片占位 3：AGENTS.md 预设页截图 → docs/images/agents-md.png -->
|
|
31
|
+
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
<!-- 图片占位 4：History 归档会话页截图 → docs/images/history.png -->
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
<!-- 图片占位 5：场景记忆页截图 → docs/images/场景记忆.png -->
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
## 核心亮点
|
|
43
|
+
|
|
44
|
+
| 能力 | 说明 |
|
|
45
|
+
|---|---|
|
|
46
|
+
| 工具级开关 | MCP 服务器内的**单个工具可独立启停**：模型看不见也调不到，随时恢复；整台服务器还支持批量启停 |
|
|
47
|
+
| 重启语义 | 重启只重连、**不改变启停状态**（对已停用的服务执行重启不会意外启用它） |
|
|
48
|
+
| 密钥安全 | `env` / `headers` 中的密钥**默认打码**、URL 查询串遮蔽；查看明文与所有写操作一样受 token 保护 |
|
|
49
|
+
| 写入保护 | 每次改写补丁前自动留 `.bak` 时间戳备份（保留 5 份）；重复 loader id 写前拦截、跨级迁移失败自动回滚 |
|
|
50
|
+
| 备份恢复 | JSON 导入支持 `overwrite` 覆盖同 id 条目，不再只能跳过 |
|
|
51
|
+
| 技能来源 | 接入 `~/.agents` / `~/.codex` / `~/.claude` 三个官方不加载的技能目录，并支持**自定义任意技能目录**（只读接入、重叠拒绝） |
|
|
52
|
+
| 技能操作 | 创建技能、ZIP/文件夹导入、插件回收站（恢复 / 永久删除 / 系统回收站兜底）、系统编辑器打开源文件 |
|
|
53
|
+
| 即时刷新 | 技能目录由后台线程监听，编辑器里改完技能页面自动刷新 |
|
|
54
|
+
| AGENTS.md 预设 | 多套全局指令基线预设库：新建 / 导入 / 编辑 / 应用 / 删除；「应用」写入 `~/.dsh/AGENTS.md`（新会话生效，当前会话不变） |
|
|
55
|
+
| 会话归档管理 | History 页按项目分组展示已归档会话：搜索、全选、批量恢复 / 永久删除、保留期自动清理（改保留期后倒计时以修改时间为基准重置） |
|
|
56
|
+
| 对话导入 / 导出 | 从 Claude Code / Cursor（JSONL）、Codex（Markdown）、任意文本无痛接管对话；导出可选会话范围，目录默认桌面，支持 Markdown / JSONL |
|
|
57
|
+
| 斜杠命令 | 聊天框直接输入 `/mcp`、`/skills`、`/agents-md`、`/scene-memory` 查看状态 |
|
|
58
|
+
| 场景记忆自动生效 | 记忆 = `~/.dsh/scene-memory/<场景>/<name>.md`；勾选启用的场景，其目录树内所有 `.md` 正文**自动进入系统提示词**（per-agent `systemPrompt` 段），模型无需任何工具调用，切换后**下一个请求即生效** |
|
|
59
|
+
| 场景启用开关 | 场景 = `scene-memory/` 一级目录，目录名支持中文；「启用场景」多选开关全局持久化在 `rules-index.json` 的 `active`；**无配置时全部启用**，`_shared/` 恒常生效 |
|
|
60
|
+
| 前缀缓存友好 | 段文本只由「启用场景 + 文件内容」决定，逐字节稳定；场景切换 / 编辑记忆只变化一次，其余请求缓存照常命中（不违反"零注入层"——那条只禁每轮动态变化的内容） |
|
|
61
|
+
| 模型工具 | **10 个**：`skill_mcp_manager_*` 管 MCP，`skill_manager_*` 管技能，`rule_manager_*` 管场景记忆（创建前需用户确认，可在设置中关闭） |
|
|
62
|
+
| 界面 | 独立的 `dsm-*` 设计系统，五页风格统一（Rules 与 Scenes 已合并为「场景记忆」） |
|
|
63
|
+
|
|
64
|
+
## 快速开始
|
|
65
|
+
|
|
66
|
+
前置：已装好 DSH（`dsh web` 可运行），Node.js ≥ 18。
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
# 安装（装包 + 自动挂载）
|
|
70
|
+
dsh plugin --profile web add dsh-plugin-tool-management@latest
|
|
71
|
+
|
|
72
|
+
# 更新：重复执行同一命令
|
|
73
|
+
# 卸载：
|
|
74
|
+
dsh plugin --profile web remove dsh-plugin-tool-management
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
装完硬刷新浏览器（Cmd/Ctrl+Shift-R），设置里出现 **MCP**、**Skills**、**AGENTS.md**、**History**、**场景记忆** 五页即安装成功（客户端改动由 DSH 热加载，无需重启）。
|
|
78
|
+
|
|
79
|
+
也可以直接对任意 DSH 会话说：
|
|
80
|
+
|
|
81
|
+
```text
|
|
82
|
+
安装 dsh-plugin-tool-management 插件：
|
|
83
|
+
dsh plugin --profile web add dsh-plugin-tool-management@latest
|
|
84
|
+
装完提醒我硬刷新浏览器。
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
## 功能指南
|
|
88
|
+
|
|
89
|
+
### 管 MCP 服务
|
|
90
|
+
|
|
91
|
+
- **接入一个服务**：「新增服务」填 `serverName`（1–32 位 `[A-Za-z0-9_-]`，全局唯一）、传输方式与对应字段，选项目级或全局。写入的是 `cordis.patch.yml` 的 loader 行，HMR 自动生效。
|
|
92
|
+
- **看清现状**：每张卡片实时显示启停状态、loader 加载阶段与已注册工具数；页面顶部是统计卡，重复 loader id 这类会导致 DSH 起不来的问题会直接告警。
|
|
93
|
+
- **只关掉某个工具**：「详情」弹窗里逐个停用工具——比如模型总是乱调的搜索工具，停掉后它的 schema 从模型视野消失、调用也会被拦截，随时可恢复。
|
|
94
|
+
- **换密钥不泄露**：默认所有形似密钥的值显示为 `••••••`，排查问题时再点「显示密钥」。
|
|
95
|
+
- **迁移与备份**：编辑可改 serverName 甚至跨项目级/全局迁移（失败自动回滚）；JSON 导出/导入用于整份备份与换机。
|
|
96
|
+
|
|
97
|
+
### 管技能
|
|
98
|
+
|
|
99
|
+
- **看全貌**：按来源分组列出所有技能——项目级、运行时、内置、插件自带，以及四个用户目录（`~/.dsh` / `~/.agents` / `~/.codex` / `~/.claude`，后三个由本插件接入）和你自己添加的自定义目录。
|
|
100
|
+
- **启停**：单个技能、整个来源、整个项目，随时切换；实现是 override provider 的遮蔽策略，源文件一个字节都不动，换机或重装只要复制状态文件。
|
|
101
|
+
- **自定义目录**：点「添加目录」输入绝对路径，该目录即成为只读技能来源——适合管理散落在仓库、网盘同步目录里的技能合集；与已有来源重叠的路径会被拒绝，避免遮蔽失效。
|
|
94
102
|
- **创建与导入**：表单直接创建；ZIP、`.md`、技能文件夹拖进来就能装；删除先进回收站，可恢复，永久删除前还会尝试移入系统回收站兜底。
|
|
95
103
|
|
|
96
104
|
### 管 AGENTS.md 预设
|
|
@@ -104,63 +112,115 @@ dsh plugin --profile web add dsh-plugin-tool-management@latest
|
|
|
104
112
|
- **批量操作**：「全选」后批量恢复或永久删除；恢复的会话回到工作区列表，删除会连同其子代理子会话一并清理。
|
|
105
113
|
- **保留期**：顶部下拉选择自动清理周期（0 = 永久保留），到期自动清除；修改保留期后，所有会话的倒计时以修改时间为基准重新计算。
|
|
106
114
|
- **导入对话**：无痛接管其他工具的会话——Claude Code / Cursor 的 JSONL、Codex 的 Markdown、以及任意文本格式，导入后即可继续对话。
|
|
107
|
-
- **导出对话**：按会话范围（全部 / 仅归档 / 按工作区）导出，每个会话一个 Markdown 或 JSONL 文件；导出目录默认桌面，旁边带「选择文件夹」按钮弹出目录树，逐级浏览选中后自动回填绝对路径。
|
|
108
|
-
|
|
109
|
-
###
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
##
|
|
165
|
-
|
|
166
|
-
|
|
115
|
+
- **导出对话**：按会话范围（全部 / 仅归档 / 按工作区）导出，每个会话一个 Markdown 或 JSONL 文件；导出目录默认桌面，旁边带「选择文件夹」按钮弹出目录树，逐级浏览选中后自动回填绝对路径。
|
|
116
|
+
|
|
117
|
+
### 管场景记忆（场景记忆页）
|
|
118
|
+
|
|
119
|
+
> 这一页由原「Rules」与「Scenes」两页合并而来：**场景（一级目录）是分组维度，记忆（`.md`）是内容**。
|
|
120
|
+
> 目录名也从 `~/.dsh/rules/` 更名为 **`~/.dsh/scene-memory/`**——升级后请把原有文件移过去（见下方「升级注意」）。
|
|
121
|
+
|
|
122
|
+
- **场景 = `scene-memory/` 下的一级目录，目录名就是场景名**：`~/.dsh/scene-memory/办公/流程.md` 即"办公"场景下的一条记忆。目录名支持中文等任意 Unicode（≤64 字符，不含 `/ \ < > : " | ? *`，不以 `.` 开头）；`_shared/` 是保留的公共场景。
|
|
123
|
+
- **新建场景**：点「新建场景」直接建一个文件夹（也可以自己在 `scene-memory/` 下 `mkdir`，效果一样）。空场景会列出来，卡片上有「删除场景」按钮；里面还有记忆时不允许删除，避免一次操作带走整组内容。
|
|
124
|
+
- **每个 `.md` 就是一条记忆**：一句话或一段话都行，不用写 frontmatter，整篇正文都会注入。往场景文件夹里丢文件就生效，也可以点卡片上的「新建记忆」在页面里写——**文件名支持中文**（如 `站会流程.md`）。
|
|
125
|
+
- **开关场景**：场景卡片右侧的开关就是启用/停用（与 Skills 页同一套组件和布局）。其目录树内**所有 `.md` 的正文会自动进入系统提示词**——模型不需要做任何动作，也不用每次重复解释。切换**下一个请求即生效**，无需重开会话或重载插件。
|
|
126
|
+
- **默认全部启用**：没有任何配置时所有场景都生效（"丢进去就有用"）；场景多了再在页面上收窄，`_shared/` 恒常生效（卡片上没有勾选框）。
|
|
127
|
+
- **记忆 = 一个 Markdown 文件**：`<场景>/<name>.md`（flat）或 `<场景>/<name>/SKILL.md`（bundle，可带附件）。新建时填场景（从已有场景里挑，或**直接输入新场景名**——目录会自动创建）、名称（= 文件名）、描述与正文，frontmatter 全部可选，缺失时插件自动派生。
|
|
128
|
+
- **bundle 附件**：形态选 bundle 时可直接**添加附件**（多选，单个 ≤8 MB、单次 ≤16 MB / 32 个）；附件存在记忆目录里，**不会进入提示词**（只有 `SKILL.md` 正文注入），编辑时可逐个移除。flat 是单文件，没有目录可放附件。
|
|
129
|
+
- **启停与回收**：逐条启停（每行右侧开关，停用的记忆仍留在磁盘上，只是不进提示词）、编辑、移入回收站；页头「回收站」可以**恢复**或**永久删除**已删记忆，删除前有二次确认。`enabled` 等状态存在侧车索引里，绝不回写记忆文件。
|
|
130
|
+
- **注入预算可见**：页头下方常驻一条预算条（已用 / 上限字节），超限变红并标「已超限」。默认上限 64 KiB；**某条记忆放不下时只跳过它**、继续装后面放得下的小记忆，段尾会附一份「未注入（超出预算）」清单——模型与用户都能看到哪些记忆这次没进提示词，而不是静默丢失。
|
|
131
|
+
- **不再改写 `~/.dsh/AGENTS.md`**：原"始终层"已下线，公共基线改由 `_shared/` 承担，统一走系统提示词段。
|
|
132
|
+
|
|
133
|
+
#### 缓存与刷新（§5.2）
|
|
134
|
+
|
|
135
|
+
| 情形 | 前缀是否稳定 | 结果 |
|
|
136
|
+
|---|---|---|
|
|
137
|
+
| 场景组合不变、记忆文件不变 | 逐字节稳定 | ✅ 提示词前缀缓存命中 |
|
|
138
|
+
| 切换启用场景（显式动作） | 变化一次 | ⚠️ 该会话重新预热一次，可接受 |
|
|
139
|
+
| 编辑某条记忆（页面或编辑器） | 变化一次 | ⚠️ 同上，**下一个请求即生效** |
|
|
140
|
+
| 段落里放时间戳 / 计数 / 相对时间 | 每请求都变 | ❌ 禁止（实现里也没有） |
|
|
141
|
+
|
|
142
|
+
实现上采用「**两相扫描 + 指纹缓存**」：每次装配只做一次 `stat` 遍历产出指纹（不读正文），
|
|
143
|
+
指纹不变就直接复用上次拼接结果；指纹一变（切场景 / 改文件 / 改启停）才读正文并重排。
|
|
144
|
+
**没有用 `fs.watch`**——Windows 上递归监听不可靠，而监听静默失效的后果是永久返回过期内容；
|
|
145
|
+
指纹探测是亚毫秒级，换来"永远最新且永不静默失效"。
|
|
146
|
+
|
|
147
|
+
#### 升级注意：目录改名
|
|
148
|
+
|
|
149
|
+
v0.3 起默认目录是 `~/.dsh/scene-memory/`，插件**不再读取也不再自动迁移**旧的 `~/.dsh/rules/`。
|
|
150
|
+
升级后把原有内容移过去即可（同盘瞬时完成）：
|
|
151
|
+
|
|
152
|
+
```sh
|
|
153
|
+
# Windows PowerShell
|
|
154
|
+
Move-Item ~/.dsh/rules ~/.dsh/scene-memory
|
|
155
|
+
# macOS / Linux
|
|
156
|
+
mv ~/.dsh/rules ~/.dsh/scene-memory
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
如果新目录已存在（例如你已手工建过），把旧目录里的**场景文件夹**逐个移进去即可；
|
|
160
|
+
`_shared/` 也是普通场景目录，一并移动。
|
|
161
|
+
|
|
162
|
+
### 让模型和脚本参与管理
|
|
163
|
+
|
|
164
|
+
| 入口 | 能做什么 |
|
|
165
|
+
|---|---|
|
|
166
|
+
| `/mcp`、`/skills`、`/agents-md`、`/scene-memory` | 聊天框查看当前状态 |
|
|
167
|
+
| `skill_mcp_manager_list / set_enabled / restart / add` | 模型查询与操作 MCP 服务 |
|
|
168
|
+
| `skill_manager_list / set_enabled / create` | 模型查询与操作技能（创建前会征求你同意） |
|
|
169
|
+
| `rule_manager_list / read / write` | 模型查询与读写场景记忆（写入前会征求你同意，可在设置中关闭确认） |
|
|
170
|
+
| `POST /dsh-plugin-tool-management/api` | 脚本调用的 HTTP API（`{op, args}` 协议） |
|
|
171
|
+
|
|
172
|
+
## 配置与安全
|
|
173
|
+
|
|
174
|
+
插件 loader 行支持以下可选字段（`dsh plugin add` 会自动插入，一般无需手写）：
|
|
175
|
+
|
|
176
|
+
| 字段 | 说明 |
|
|
177
|
+
|---|---|
|
|
178
|
+
| `token` | 可选访问令牌。设置后**所有写操作与「显示密钥」**都要求 `x-dsh-token` 请求头。客户端从 localStorage 读取（键 `dsh-plugin-tool-management-token`，DevTools Console 设置后刷新即可），也可用环境变量 `DSH_PLUGIN_TOOL_MANAGEMENT_TOKEN`。 |
|
|
179
|
+
| `maxBodyBytes` | 请求体上限，默认 88 MiB（技能 ZIP 上传需要）。 |
|
|
180
|
+
|
|
181
|
+
关于为什么需要 token：插件的跨站防护（POST-only + 自定义头 + 同源校验）默认「DSH 只监听本机」。如果你把端口转发到局域网/公网，token 就是防止陌生人注入 MCP 命令（等同远程执行）与窃取明文密钥的最后防线——本地单机使用可不配置。
|
|
182
|
+
|
|
183
|
+
## 数据落点
|
|
184
|
+
|
|
185
|
+
| 内容 | 位置 |
|
|
186
|
+
|---|---|
|
|
187
|
+
| MCP 服务器定义 | `profiles/<profile>/cordis.patch.yml`（项目级）或 `~/.dsh/cordis.patch.yml`（全局），改写前自动 `.bak` |
|
|
188
|
+
| 服务器备注 / 页面设置 / 工具停用列表 / 导出 | DSH 主目录下的旁路 JSON（`skill-mcp-manager-*.json`） |
|
|
189
|
+
| 技能启停策略 / 自定义目录 | `~/.dsh/tool-management/state.json` |
|
|
190
|
+
| 技能回收站 / 导入暂存 | `~/.dsh/tool-management/trash`、`uploads` |
|
|
191
|
+
| AGENTS.md 预设库 / 应用结果 | 插件目录 `data/agents-md-presets/`；「应用」写入 `~/.dsh/AGENTS.md` |
|
|
192
|
+
| 归档会话账本 / 保留期 | 插件目录 `data/history-archived-at.json`、`data/history-retention.json` |
|
|
193
|
+
| 记忆文件（真源） | `~/.dsh/scene-memory/<场景>/<name>.md`（flat）或 `<场景>/<name>/SKILL.md`（bundle）；场景目录名可含中文 |
|
|
194
|
+
| 记忆索引 / 启用场景 | `~/.dsh/tool-management/rules-index.json`（`enabled`/排序/标签 + `active` 启用场景集合；`active: null` = 全部启用） |
|
|
195
|
+
| 记忆回收站 | `~/.dsh/tool-management/rules-trash/<trashId>/`（删除记忆先进这里，可恢复） |
|
|
196
|
+
| 运行日志 | `~/.dsh/dsh-plugin-tool-management.log`（滚动） |
|
|
197
|
+
|
|
198
|
+
## 常见问题
|
|
199
|
+
|
|
200
|
+
| 现象 | 解决 |
|
|
201
|
+
|---|---|
|
|
202
|
+
| 装完设置里没有页面 | 硬刷新；不行就重启 DSH。 |
|
|
203
|
+
| 出现重复的 MCP 页签 / 工具 | 与旧 loader 行双挂载，删掉 `cordis.patch.yml` 里的旧条目后重启。 |
|
|
204
|
+
| 改坏了配置 DSH 起不来 | 同目录取最近的 `cordis.patch.yml.bak-<时间戳>` 恢复。 |
|
|
205
|
+
| 页面数据不刷新 | 等待页面自动轮询（默认 5 秒）；或手动点「刷新」。 |
|
|
206
|
+
| 镜像源装不到最新版 | 加 `--registry=https://registry.npmjs.org` 稍后再试。 |
|
|
207
|
+
|
|
208
|
+
## 开发
|
|
209
|
+
|
|
210
|
+
```bash
|
|
211
|
+
npm install
|
|
212
|
+
npm run build # 构建（tsc + 同步客户端 bundle）
|
|
213
|
+
npm run build:client # 只同步 src/client.js → lib/client.js
|
|
214
|
+
npm run lint # 语法自检（node --check 两个产物）
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
> 本项目不维护测试套件。改动的验证方式是**直接跑一遍真实行为**（见 `docs/` 下的变更单验收项），
|
|
218
|
+
> 而不是断言代码当前怎么实现——后者只是把实现抄一遍，必然通过。
|
|
219
|
+
|
|
220
|
+
结构：宿主端 `src/index.ts`（Cordis 对象插件，`lib/index.js` 为发布产物）；技能核心 `src/skills/core.js`（纯 Node）；AGENTS.md 预设库 `src/agents-md/service.ts`；归档会话管理 `lib/history/`（`workspace.js` / `projcache.js` / `tombstone.js`）；对话导入解析 `src/imports/parsers.js`；场景记忆服务 `src/rules/`（`service.ts` 发现/CRUD/索引/两相扫描段渲染、`provider.ts` per-agent `systemPrompt` 段注册；模块路径与 `rules-*` op 名保留为内部协议，用户可见的页面与目录名已改为「场景记忆」/`scene-memory/`）；浏览器端 `src/client.js`（ModuleLoader CJS bundle，`dsm-*` 设计系统，经同源 API 与宿主通信）。运行时依赖仅 `fflate`（ZIP 解压）。
|
|
221
|
+
|
|
222
|
+
发布：`npm version patch && npm publish`（`prepublishOnly` 自动构建）。
|
|
223
|
+
|
|
224
|
+
## 许可证
|
|
225
|
+
|
|
226
|
+
MIT
|