dsh-prompt-customizer 0.4.0 → 0.4.2
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 +21 -21
- package/README.en.md +278 -227
- package/README.i18n.yaml +2 -2
- package/README.md +278 -227
- package/client/client.js +82 -80
- package/client/client.js.map +1 -1
- package/cordis.patch.yml +8 -8
- package/lib/catalog.js +131 -131
- package/lib/effective.js +161 -158
- package/lib/index.js +943 -943
- package/lib/promotion.js +80 -80
- package/lib/schema.js +124 -124
- package/lib/sectionOps.d.mts +32 -32
- package/lib/sectionOps.mjs +128 -133
- package/lib/store.js +124 -124
- package/lib/vars.js +147 -147
- package/package.json +84 -64
- package/src/client/PresetsTab.tsx +281 -281
- package/src/client/PreviewTab.tsx +91 -91
- package/src/client/PreviewTools.tsx +33 -33
- package/src/client/SectionsTab.tsx +539 -556
- package/src/client/ToolsTab.tsx +293 -266
- package/src/client/index.ts +433 -422
- package/src/client/locales.ts +263 -259
- package/src/client/preset-io.ts +226 -226
- package/src/client/presets.ts +413 -408
- package/src/client/styles.ts +49 -49
- package/src/client/types.ts +128 -128
package/README.md
CHANGED
|
@@ -1,227 +1,278 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
>
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
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
|
-
|
|
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
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
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
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
##
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="assets/logo.svg" alt="dsh-prompt-customizer" width="180">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
<h1 align="center">dsh-prompt-customizer</h1>
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<strong>DeepSeek Harness 的系统提示词与工具目录定制器。<br>
|
|
9
|
+
按名称屏蔽 / 替换 / 注入 / 排序提示词段，按会话阶段与 agent 预设分层 —— 全部在设置面板里完成。</strong>
|
|
10
|
+
</p>
|
|
11
|
+
|
|
12
|
+
<p align="center">
|
|
13
|
+
<a href="README.en.md">English</a> ·
|
|
14
|
+
<strong>简体中文</strong>
|
|
15
|
+
</p>
|
|
16
|
+
|
|
17
|
+
<p align="center">
|
|
18
|
+
<a href="#安装">安装</a> •
|
|
19
|
+
<a href="#功能特性">功能特性</a> •
|
|
20
|
+
<a href="#使用说明">使用说明</a> •
|
|
21
|
+
<a href="#工作原理">工作原理</a> •
|
|
22
|
+
<a href="#已知限制">已知限制</a>
|
|
23
|
+
</p>
|
|
24
|
+
|
|
25
|
+
<p align="center">
|
|
26
|
+
<a href="https://github.com/DreamsTOF/dsh-prompt-customizer/releases"><img src="https://img.shields.io/badge/version-0.4.2-blue.svg" alt="Version"></a>
|
|
27
|
+
<a href="https://github.com/DreamsTOF/dsh-prompt-customizer/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="MIT License"></a>
|
|
28
|
+
<a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/DeepSeek_Harness-Plugin-blueviolet.svg" alt="DeepSeek Harness Plugin"></a>
|
|
29
|
+
<a href="https://www.npmjs.com/package/dsh-prompt-customizer"><img src="https://img.shields.io/npm/v/dsh-prompt-customizer" alt="npm version"></a>
|
|
30
|
+
<a href="https://www.npmjs.com/package/dsh-prompt-customizer"><img src="https://img.shields.io/npm/dm/dsh-prompt-customizer" alt="npm downloads"></a>
|
|
31
|
+
<a href="https://github.com/DreamsTOF/dsh-prompt-customizer/stargazers"><img src="https://img.shields.io/github/stars/DreamsTOF/dsh-prompt-customizer?style=social" alt="GitHub Stars"></a>
|
|
32
|
+
</p>
|
|
33
|
+
|
|
34
|
+
<p align="center">
|
|
35
|
+
<b>⭐ GitHub 仓库：<a href="https://github.com/DreamsTOF/dsh-prompt-customizer">DreamsTOF/dsh-prompt-customizer</a></b> —— 觉得有用就点个 Star；问题与需求请提 <a href="https://github.com/DreamsTOF/dsh-prompt-customizer/issues">Issue</a>
|
|
36
|
+
</p>
|
|
37
|
+
|
|
38
|
+
<p align="center">
|
|
39
|
+
<img src="assets/banner.svg" alt="system prompt → block · replace · inject · sort" width="900">
|
|
40
|
+
</p>
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 插件，让你在设置面板里控制**系统提示词**和**工具目录**。
|
|
45
|
+
|
|
46
|
+
其他插件注入的提示词段可能污染你的系统提示词。本插件让你按名称**屏蔽**、**替换**、**注入**、**排序**提示词段，并把工具从**模型可见目录**里隐藏 —— 全程实时生效，不需要改动任何其他插件。
|
|
47
|
+
|
|
48
|
+
两件事贯穿整个设计：
|
|
49
|
+
|
|
50
|
+
- **按会话阶段分层**：引导期（未晋级）/ 常驻期（晋级后）/ 压缩受控期（压缩后仍未晋级）各有**独立的屏蔽名单、独立的排序空间、独立的工具目录**。同一个预设可以做到首轮只给模型 1 个工具和几段提示词，晋级后放开全套。
|
|
51
|
+
- **按 agent 预设分层**：顶部选择器选「目标：全局默认」改的是默认值；选中某个 agent 预设后，改动只对该预设生效（字段级覆盖，未设置的字段继续回落全局）。
|
|
52
|
+
|
|
53
|
+
## 会话阶段怎么流转
|
|
54
|
+
|
|
55
|
+
阶段不是固定三拍，而是由**持久会话事件**推导出来的：首个 durable 的 `tool/call` 或
|
|
56
|
+
`assistant/message` 触发晋级，一次 `compaction/end` 把晋级复位。面板上三个阶段部分
|
|
57
|
+
就分别对应这三种状态。
|
|
58
|
+
|
|
59
|
+
<table>
|
|
60
|
+
<tr align="center">
|
|
61
|
+
<td width="28%"><b>① 会话开始</b><br><code>bootstrap</code><br><b>引导期</b></td>
|
|
62
|
+
<td width="6%">→</td>
|
|
63
|
+
<td width="28%"><b>② 首个 durable 信号</b><br><code>tool/call</code> · <code>assistant/message</code><br><b>常驻期</b> <code>active</code></td>
|
|
64
|
+
<td width="6%">→</td>
|
|
65
|
+
<td width="32%"><b>③ 一次压缩</b><br><code>compaction/end</code><br><b>压缩受控期</b> <code>compaction</code></td>
|
|
66
|
+
</tr>
|
|
67
|
+
<tr>
|
|
68
|
+
<td colspan="5" align="center">
|
|
69
|
+
④ 压缩后再来一个 durable 信号 → <b>回到常驻期</b>；只要再来一次压缩，又会落回压缩受控期
|
|
70
|
+
</td>
|
|
71
|
+
</tr>
|
|
72
|
+
</table>
|
|
73
|
+
|
|
74
|
+
完整的转移关系（引导期也能不经常驻期直接进压缩受控期）：
|
|
75
|
+
|
|
76
|
+
| 当前阶段 | 事件 | 去向 |
|
|
77
|
+
| ---------- | ---------------------------------------------- | -------------- |
|
|
78
|
+
| 引导期 | 首个 durable `tool/call` / `assistant/message` | **常驻期** |
|
|
79
|
+
| 引导期 | `compaction/end` | **压缩受控期** |
|
|
80
|
+
| 常驻期 | `compaction/end`（晋级复位） | **压缩受控期** |
|
|
81
|
+
| 压缩受控期 | 压缩之后新的 durable 信号 | **常驻期** |
|
|
82
|
+
| 任意 | 子代理会话（`delegationDepth > 0`） | 恒为**常驻期** |
|
|
83
|
+
| 任意 | 无会话的读取（清单、预览） | 恒为**常驻期** |
|
|
84
|
+
|
|
85
|
+
每个阶段各解析出什么 —— 面板的三个部分与配置字段一一对应：
|
|
86
|
+
|
|
87
|
+
| 面板里的部分 | 生效的段屏蔽 | 注入段的 `phase` | 生效的工具黑名单 |
|
|
88
|
+
| ------------------------- | -------------------- | -------------------------- | ---------------------------------------------------------- |
|
|
89
|
+
| 引导期提示词 / 引导期工具 | `sectionsBootstrap` | `bootstrap`（+ `always`） | `tools.bootstrap.exclude`，未配置则回落静态 |
|
|
90
|
+
| 常驻期提示词 / 常驻期工具 | `sections` | `active`（+ `always`） | `tools.exclude`（静态） |
|
|
91
|
+
| 压缩受控期提示词 / 工具 | `sectionsCompaction` | `compaction`（+ `always`） | `tools.compaction.exclude`，未配置则回落引导期，再回落静态 |
|
|
92
|
+
|
|
93
|
+
两点容易踩：
|
|
94
|
+
|
|
95
|
+
- **`always` 注入段三个阶段都在**，且各阶段的排序空间独立 —— 所以本插件产出的阶段条目排在 `always` 组之后（运行时按数组序后写覆盖前写，阶段序才压得住全局序）。
|
|
96
|
+
- **阶段视图是"这个状态会解析成什么"，不是"会话曾经是什么"**。预设原生的阶段规则（zero-tool bootstrap、warmup 等）在同一时刻也在生效，并且可能在其它插件之后改动结果 —— 见[已知限制](#已知限制)。
|
|
97
|
+
|
|
98
|
+
## 界面
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
## 功能特性
|
|
111
|
+
|
|
112
|
+
### 提示词段
|
|
113
|
+
|
|
114
|
+
- **屏蔽**：按名称从装配结果里移除该段。被屏蔽的行不会消失，仍可拖拽、编辑、恢复 —— 屏蔽只意味着不注入模型。
|
|
115
|
+
- **替换**：编辑该段文本，编辑框预填当前生效文本（动态段会尽力解析出真实内容再回显）。
|
|
116
|
+
- **注入**：每个阶段部分底部都能按名称 + 文本新建一段，带 `手动` 徽标，随时可删除。
|
|
117
|
+
- **排序**：整行拖拽（拖到某行上方/下方出现插入线）或 ↑/↓ 箭头。顺序以 0 起始的连续虚拟下标存储，不会出现重复或小数 order，也不需要手填数字。
|
|
118
|
+
- **每阶段独立**：引导期屏蔽写 `sectionsBootstrap`，压缩受控期写 `sectionsCompaction`，常驻期写 `sections`；三份名单互不继承、互不影响，排序空间也互不干扰，因此「引导期只留 5 段、常驻期全开」可以分别表达 —— 在一个阶段屏蔽 / 恢复某段，绝不会改变它在其它阶段的状态。从其它阶段（或全部池）拖进当前阶段即成为当前阶段的独立副本（带原文写入本阶段注入条目），源阶段保持原样。
|
|
119
|
+
- **强制覆盖（`forceSections`，默认开）**：包装宿主的装配入口，最终提示词段直接从注册表原始段重建 —— 预设插件自身的阶段裁段（如 liangshen 引导期 20→1）与 persona 的 `complete: true` 整段接管都无法再改写本插件的屏蔽 / 替换 / 注入 / 排序结果；工具目录与动态上下文保持预设与宿主行为。设为 `false` 退回瀑布流内过滤（此时完整段接管仍会压制段级定制）。
|
|
120
|
+
|
|
121
|
+
### 工具目录
|
|
122
|
+
|
|
123
|
+
- **只有黑名单**（`exclude`）：取消勾选即在**该阶段**隐藏这个工具，勾回来就恢复。没有白名单模式 —— 它会让 `exclude` 整体失效，一个拖拽就能悄悄关掉该阶段其它所有工具，而表达能力并不比反选更多。
|
|
124
|
+
- **拖入 = 让这一个工具在该阶段可见**（从该阶段黑名单里移除）；拖回「本系统全部工具」= 在该阶段隐藏它。每个动作只影响你拖的那一个工具，绝不牵连其它工具。
|
|
125
|
+
- **阶段目录**：引导期与压缩受控期各有独立的黑名单，运行时优先级为 **压缩受控期 > 引导期 > 静态** —— 压缩后仍未晋级且配了压缩目录就用它，否则未晋级时用引导目录，其余情况用静态过滤。
|
|
126
|
+
- **只能收窄，不能扩充**：过滤的对象是「装配已经给出的目录」。某个阶段本来没有的工具，无论怎么设置都不会出现（要它出现得去改那个预设的组成，不是这里）。
|
|
127
|
+
- 只影响面向模型的目录；工具本身与路由照常工作。
|
|
128
|
+
|
|
129
|
+
### 模型视角预览
|
|
130
|
+
|
|
131
|
+
预览 Tab 展示经过**所有插件**过滤后的最终系统提示词与工具目录，并按阶段切换。它与提示词 / 工具 Tab 读同一份装配结果，所见即模型所见。工具视图给出「模型可见 / 注册表总数」的对照 —— PTC、Code Mode 这类预设会把整套目录包装成单个 `run_code`，只看注册表会误判。
|
|
132
|
+
|
|
133
|
+
### 提示词变量
|
|
134
|
+
|
|
135
|
+
宿主只注册 `provider` / `model` / `cwd` 三个变量，段文本里引用别的 `{{name}}` 会直接让整次装配失败。本插件经官方扩展点追加两类变量：
|
|
136
|
+
|
|
137
|
+
- **内置系统事实**：`date` / `time` / `datetime` / `weekday` / `hostname` / `platform` / `arch` / `username` / `home` / `shell` / `locale` / `node_version`，每次装配现算。
|
|
138
|
+
- **全量环境变量**：`process.env` 的每个键映射为 `env_<小写，非法字符归并为 _>`，如 `PATH` → `{{env_path}}`、`USER.NAME` → `{{env_user_name}}`。
|
|
139
|
+
|
|
140
|
+
**黑名单（`envBlocklist`）**：env 里常有密钥，进了提示词就会随请求发给模型，所以命中黑名单的键不注册。预填条目覆盖常见凭据类键（含 `SECRET` / `TOKEN` / `PASSWORD` / `API_KEY` / `*_DSN` 等），条目支持 `*` 通配、大小写不敏感；面板的环境变量黑名单卡片可随时增删，卡里的折叠列表给出当前实际注册的变量清单。黑名单变化在下次装配生效（面板改动或直接改 `config.yaml` 都一样）。
|
|
141
|
+
|
|
142
|
+
**导出 / 导入随行**：导出预设时当前黑名单随行写入文件；导入端按并集并入（只增不减），与快照库语义一致。
|
|
143
|
+
|
|
144
|
+
严格渲染的代价：段里引用了一个未注册的名字（如被黑名单挡下的键），**整段装配失败**而不是留空 —— 面板清单里没列出的名字不要用。
|
|
145
|
+
|
|
146
|
+
### 配置快照与 agent 预设
|
|
147
|
+
|
|
148
|
+
- **保存当前配置**：把当前作用域的完整定制（含每阶段屏蔽名单、每阶段排序、阶段工具目录）存成一份可复用的配置快照。
|
|
149
|
+
- **应用**：同名段被覆盖、快照名单之外的当前段被默认屏蔽；快照里当前系统匹配不上的段默认跳过（跨系统导入不凭空建段），快照里没有的阶段字段保留你当前的值，不会被抹掉。同一时间只有一份在用。
|
|
150
|
+
- **导出 / 导入**：配置快照以 JSON 往返（Tauri 桌面走原生对话框，Web 走下载 / 文件选择），同名预设会被跳过。顺序以相对形式存储（每段记住它跟随谁），快照因此可跨不同段集合移植。
|
|
151
|
+
- **存为 agent 预设**：整体**复制**当前编辑目标的预设目录（组成文件、伴生脚本、技能目录一并带走）到用户预设根，再把当前定制写进它的覆盖项。新预设随即出现在顶部选择器里 —— 它是一个真正可切换的 agent 预设，而不只是一份配置副本。
|
|
152
|
+
|
|
153
|
+
### 跨预设的注册表池
|
|
154
|
+
|
|
155
|
+
「本系统全部提示词 / 本系统全部工具」不随编辑目标切换：它是一个**跨预设、只增不减的并集**（同名后见到者赢，新名追加），随你浏览各预设逐步长齐，存放在 `catalog.yaml` 这个派生缓存里，删掉会自行重建。
|
|
156
|
+
|
|
157
|
+
## 工作原理
|
|
158
|
+
|
|
159
|
+
一次改动从面板到模型的完整链路：
|
|
160
|
+
|
|
161
|
+
<table>
|
|
162
|
+
<tr align="center">
|
|
163
|
+
<td width="19%"><b>① 设置面板</b><br>提示词 / 工具 / 配置 / 预览<br><i>只改内存草稿</i></td>
|
|
164
|
+
<td width="3%">→</td>
|
|
165
|
+
<td width="19%"><b>② 插件自有路由</b><br><code>/config</code> · <code>/config/apply</code><br><code>/preview</code> · <code>/inventory</code> · <code>/presets</code></td>
|
|
166
|
+
<td width="3%">→</td>
|
|
167
|
+
<td width="19%"><b>③ config.yaml</b><br>全局字段 + <code>overrides[预设]</code><br><i>mtime 懒加载，手改即时生效</i></td>
|
|
168
|
+
<td width="3%">→</td>
|
|
169
|
+
<td width="34%"><b>④ 装配瀑布流</b><br><code>system-prompt/assemble</code> 钩子按会话推导阶段，<br>解析出生效配置并过滤</td>
|
|
170
|
+
</tr>
|
|
171
|
+
<tr>
|
|
172
|
+
<td colspan="9" align="center"><b>④ 内部依次是</b>：<code>mergeConfig(全局, overrides[会话所属预设])</code> → 段：屏蔽 → 替换 → 注入 → 按 order 排序；工具：<code>pickToolsFilter</code>（压缩 > 引导 > 静态）→ <code>applyToolFilter</code></td>
|
|
173
|
+
</tr>
|
|
174
|
+
<tr>
|
|
175
|
+
<td colspan="9" align="center">
|
|
176
|
+
<b>⑤ 交卷前还有一手</b>：宿主在瀑布流<b>之后</b>，若存在 <code>complete: true</code> 的段就把整份 sections 还原成那一条 —— 这就是面板会对这类预设亮黄标的原因（工具目录不受影响；<code>forceSections</code> 开启时本插件已在装配入口重建 sections，接管被绕过，不再亮黄标）
|
|
177
|
+
</td>
|
|
178
|
+
</tr>
|
|
179
|
+
<tr>
|
|
180
|
+
<td colspan="9" align="center"><b>⑥ 模型收到</b>：最终系统提示词 + 可见工具目录；预览 Tab 读的就是这一份结果</td>
|
|
181
|
+
</tr>
|
|
182
|
+
</table>
|
|
183
|
+
|
|
184
|
+
代码地图：
|
|
185
|
+
|
|
186
|
+
| 路径 | 作用 |
|
|
187
|
+
| --------------------------------- | -------------------------------------------------------------------------------- |
|
|
188
|
+
| `lib/index.js` | 宿主端：装配钩子、五条 HTTP 路由、agent 预设 fork、遗留字段一次性清理 |
|
|
189
|
+
| `lib/effective.js` | 纯函数：字段级 override 合并、阶段选取（注入段 / 工具目录）、黑名单过滤 |
|
|
190
|
+
| `lib/promotion.js` | 由 durable 事件推导 `{promoted, boundary}`，压缩复位、子代理恒已晋级 |
|
|
191
|
+
| `lib/vars.js` | 提示词变量：内置系统事实 + env 全量映射 / 黑名单，装配入口按签名懒同步 |
|
|
192
|
+
| `lib/sectionOps.mjs` | **面板与单测共用**的阶段状态纯函数（名单写回目标、注入身份、重排、逐阶段持久化） |
|
|
193
|
+
| `lib/store.js` / `lib/catalog.js` | 原子写 + last-good 回落的配置存储；跨预设段/工具累积登记表 |
|
|
194
|
+
| `src/client/` | 面板（React，无 JSX 语法糖依赖，`h()` 直写），构建进 `client/client.js` |
|
|
195
|
+
|
|
196
|
+
关键约定：阶段逻辑只有一份实现 —— `lib/sectionOps.mjs` 既被 tsdown 打进浏览器包，也被
|
|
197
|
+
`node --test` 直接 import 跑单测，所以「测试通过」和「界面行为」之间不存在第二套代码。
|
|
198
|
+
|
|
199
|
+
## 安装
|
|
200
|
+
|
|
201
|
+
```bash
|
|
202
|
+
dsh plugin --profile web add dsh-prompt-customizer
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
也可从本地检出安装：
|
|
206
|
+
|
|
207
|
+
```bash
|
|
208
|
+
dsh plugin --profile web add /path/to/dsh-prompt-customizer
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
安装后打开 dsh Web UI → **设置** → 侧边栏 **提示词定制**。
|
|
212
|
+
|
|
213
|
+
## 使用说明
|
|
214
|
+
|
|
215
|
+
### 提示词 Tab
|
|
216
|
+
|
|
217
|
+
三个阶段部分（引导期 / 常驻期 / 压缩受控期）**恒定全部显示** —— 某个预设没有某个阶段时，那部分只是空的，不会被隐藏。每行包含：
|
|
218
|
+
|
|
219
|
+
- **复选框**：屏蔽 / 取消屏蔽（`未屏蔽` / `已屏蔽` 徽标）
|
|
220
|
+
- **编辑**：替换该段文本；替换过的行带 `已替换` 徽标与「还原」按钮
|
|
221
|
+
- **↑/↓** 与**拖拽手柄**：调整该阶段内的顺序；`#N` 是它当前的虚拟下标
|
|
222
|
+
- `系统` / `手动` 徽标标明段的来源，只有 `手动` 段可以删除
|
|
223
|
+
|
|
224
|
+
标题旁的 `阶段可见 N` 是该部分当前的行数。底部的名称 + 文本输入框会按所在部分注入新段（阶段已锁定，不用再选）。
|
|
225
|
+
|
|
226
|
+
### 工具 Tab
|
|
227
|
+
|
|
228
|
+
每阶段一个部分，芯片式列出该阶段进入过滤的目录，标题旁 `阶段可见 启用数 / 总数`。勾选 = 该阶段可见，取消 = 在该阶段隐藏；从「本系统全部工具」拖入某个阶段只是让**这一个**工具在该阶段可见，拖回「全部」则在该阶段隐藏它。想看模型真正拿到几个工具，请去预览 Tab 的工具视图。
|
|
229
|
+
|
|
230
|
+
### 配置 Tab
|
|
231
|
+
|
|
232
|
+
五张卡片：**保存当前配置**（配置快照）、**存为 agent 预设**（fork 当前目标的预设目录）、**导入配置**、**环境变量黑名单**（增删条目、查看当前实际注册的变量清单）、**强制覆盖开关**。快照列表每行是 应用 / 导出 / 删除，正在使用的那一行带「使用中」标记。另有一张**恢复初始状态**卡片：清空全部定制并关闭 `forceSections`，与卸载插件等效（无需卸载 / 重启），点击需二次确认。
|
|
233
|
+
|
|
234
|
+
### 编辑目标与保存
|
|
235
|
+
|
|
236
|
+
顶部选择器决定改动落在哪。提示词与工具 Tab 共享同一份未保存草稿，**保存**按钮一次落盘；切到配置 / 预览 Tab 或切换编辑目标会丢弃草稿（会先弹确认）。也就是说：写坏的东西不点保存就不会进文件。
|
|
237
|
+
|
|
238
|
+
## 配置存放位置
|
|
239
|
+
|
|
240
|
+
- `~/.dsh/prompt-customizer/config.yaml` —— 唯一权威配置。首次启动时若该文件不存在而旧版 `settings.yaml` 里有对应段落，会自动迁移一次（主文档原样保留，可回滚）。手工编辑即时生效，无需重启。
|
|
241
|
+
- `~/.dsh/prompt-customizer/catalog.yaml` —— 跨预设的段 / 工具累积登记表，纯派生缓存，删掉会随浏览重建。
|
|
242
|
+
|
|
243
|
+
## 已知限制
|
|
244
|
+
|
|
245
|
+
下面都是实测结论。面板在相关情况下会直接给出黄色警示，不需要你猜：
|
|
246
|
+
|
|
247
|
+
- **有些预设的提示词不由段组成。** 若某个段以 `complete: true` 注册（dsh-persona 的「整段接管」），宿主会在装配瀑布流**之后**把整份 sections 还原成那一条段。`forceSections`（默认开）已在装配入口绕开该机制，段级定制照常生效；只有把它设为 `false` 时，本插件的屏蔽 / 替换 / 注入 / 排序才会对这类预设无效（工具过滤不受影响），面板会写明「最终系统提示词由 `deployment:persona` 段整段接管」。
|
|
248
|
+
- **丢弃段的原因不止一种**。除了 `complete` 接管，也存在预设用自己的规则在特定阶段裁段（实测某预设引导期 20 段 → 1 段，而注册表里并没有 complete 段）。所以面板还做了一次机制无关的比对：把本插件产出的段名与最终装配逐名核对，不符时提示「产出 N 段，模型只见 M 段」。
|
|
249
|
+
- **预览的伪会话可能降级**。阶段视图由一次合成会话驱动，个别预设插件会在这种会话上抛错；此时该阶段回退为无会话装配并标注「已降级」，即那个阶段看到的是不带原生阶段裁剪的结果。
|
|
250
|
+
- **替换动态生成的段会固定其内容**。像 `app:web-surface` 这类段在装配时实时生成（嵌入当前 Web 端口等）。替换后文本冻结为你编辑时的值，不再跟随运行时变化；想保持跟随请改用屏蔽。
|
|
251
|
+
- **动态段文本解析是尽力而为**。面板读取动态段时会尝试调用其生成函数（只传最小上下文）来回显真实内容；依赖更复杂上下文、一调就抛的段会显示 `<动态生成>`，其余功能不受影响。另外，带 `{{model}}` / `{{cwd}}` 之类变量的段在列表里显示的是**未替换的模板**，预览 Tab 里才是替换后的最终文本。
|
|
252
|
+
- **导出依赖宿主允许下载**。Web 回退走浏览器下载：若宿主 webview 静默丢弃下载，面板仍会提示「导出成功」而文件没有落地。导入（文件选择）不受影响。
|
|
253
|
+
- **工具目录不能被扩充**，见前文「只能收窄，不能扩充」。
|
|
254
|
+
|
|
255
|
+
## 开发
|
|
256
|
+
|
|
257
|
+
```bash
|
|
258
|
+
npm install
|
|
259
|
+
npm run check # typecheck + build + 全量单测
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
浏览器端用 [tsdown](https://github.com/rolldown/tsdown) 打包成 `client/client.js`（`__ModuleLoader__` factory bundle），宿主端代码在 `lib/`。阶段状态逻辑集中在 `lib/sectionOps.mjs`：同一份纯函数既被 UI 打包使用，也被 `node --test` 直接覆盖，测试即上线代码。
|
|
263
|
+
|
|
264
|
+
## License
|
|
265
|
+
|
|
266
|
+
[MIT](LICENSE) © 2026 DreamsTOF
|
|
267
|
+
|
|
268
|
+
---
|
|
269
|
+
|
|
270
|
+
## Star History
|
|
271
|
+
|
|
272
|
+
[](https://star-history.com/#DreamsTOF/dsh-prompt-customizer&Date)
|
|
273
|
+
|
|
274
|
+
---
|
|
275
|
+
|
|
276
|
+
<p align="center">
|
|
277
|
+
<strong>⭐ 如果这个插件让你的系统提示词更干净、工具目录更听话，就给它一个 star 吧！</strong>
|
|
278
|
+
</p>
|