dsh-custom-mode 2.1.0 → 2.2.1
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.i18n.yaml +2 -2
- package/README.md +44 -391
- package/README.zh.md +44 -287
- package/client.js +14 -14
- package/composition.mjs +6 -6
- package/defaults.mjs +59 -0
- package/index.mjs +14 -4
- package/locales.mjs +8 -8
- package/package.json +18 -22
package/README.zh.md
CHANGED
|
@@ -2,322 +2,79 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | 中文
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
助手（多模式 / 多角色扮演 RP）。英文关键词：dsh custom mode / custom prompt / system prompt editor /
|
|
7
|
-
base mode / plugin switches / multi-assistant / multi-persona。
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
[](https://github.com/BOWLUNA/dsh-custom-mode/stargazers) [](https://www.npmjs.com/package/dsh-custom-mode) [](https://github.com/BOWLUNA/dsh-custom-mode/actions/workflows/test.yml) [](LICENSE) [](https://github.com/BOWLUNA/dsh-custom-mode#readme)
|
|
12
|
-
|
|
13
|
-
[](https://b23.tv/qJ4Ev0W) [](https://v.douyin.com/VWh0M03Fa4Y/) [](https://xhslink.cn/o/A7QtXmePBBF) [](https://discord.gg/pz97SfAfSy) [](https://github.com/BOWLUNA/dsh-custom-mode/discussions)
|
|
14
|
-
|
|
15
|
-
[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）用的自定义模式。它的系统提示词是一个普通文件，可以在 Web 设置页里编辑，**改完下一步模型调用即生效** —— 不用重启，也不用新建会话。
|
|
16
|
-
|
|
17
|
-
一句话：**给 dsh 的 agent 模式用的设置页** —— 选这个模式的基础组成、逐行开关它挂载的插件、并编辑它的系统提示词；提示词每个模型调用前重新读取。可以并存多个模式（「助手」），各自的提示词互不影响。
|
|
18
|
-
|
|
19
|
-
常见的叫法：自定义模式 · 自定义提示词 · 系统提示词编辑 · 多助手／多模式 · 多个 Agent 模式 ·
|
|
20
|
-
角色扮演／聊天人格（RP）。
|
|
21
|
-
|
|
22
|
-
**单元测试覆盖三条线，渲染闸门只跑 `0.2.0-rc.2`。** npm 的 `latest` 与 `next` 自 2026-09-29 起都指向 `0.2.0-rc.2`：
|
|
23
|
-
|
|
24
|
-
| dsh | 定位 | 状态 |
|
|
25
|
-
| --- | --- | --- |
|
|
26
|
-
| `0.2.0-rc.2` | **最新线** —— npm 的 `latest` 与 `next` 都指向它，官方桌面端也在这一条线上（与 dsh 同版本号） | ✅ CI（ubuntu node 20/24 + **windows**）+ 真机：这条线上安装、组合树与播种都验过（整道渲染闸门跑在这里）|
|
|
27
|
-
| `0.2.1-alpha.1` | 预览线 —— npm 的 `alpha` 指向它。单元测试覆盖；渲染闸门不在这条线上 | ✅ CI |
|
|
28
|
-
| `0.1.7-rc.2` | 上一个正式版 —— 仍在声明范围内，现役安装大多在它上面 | ✅ CI。设置页在这条线上会退回壳没提供的控件；渲染闸门不在这里 |
|
|
29
|
-
|
|
30
|
-
更早的线（`0.1.5-rc.3`、`0.1.6-alpha.*`）共用同一套机制，peer 范围仍然接纳，但不再单独占 CI 腿。
|
|
31
|
-
|
|
32
|
-
官方四个模式（`standard` / `ptc` / `minimal` / `cordis`）不受影响。
|
|
33
|
-
|
|
34
|
-
<p align="center">
|
|
35
|
-
<img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/01-mode-switch.png" width="360" alt="基础模式与插件开关">
|
|
36
|
-
<img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/02-plugin-switches.png" width="360" alt="插件开关"><br>
|
|
37
|
-
<img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/03-system-prompt.png" width="360" alt="系统提示词">
|
|
38
|
-
<img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/04-preset-picker.png" width="360" alt="模式选择器">
|
|
39
|
-
</p>
|
|
5
|
+
在 DeepSeek Harness（`dsh`）里改自定义模式的系统提示词、基础模式和插件开关。可以有多个助手。custom mode、system prompt、prompt editor。
|
|
40
6
|
|
|
41
7
|
<p align="center">
|
|
42
|
-
<img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/
|
|
8
|
+
<img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/header.png" width="820" alt="dsh-custom-mode">
|
|
43
9
|
</p>
|
|
44
10
|
|
|
45
|
-
|
|
11
|
+
<table align="center">
|
|
12
|
+
<tr>
|
|
13
|
+
<td align="center"><img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/05-assistant-manager.png" width="360" alt="助手"></td>
|
|
14
|
+
<td align="center"><img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/03-system-prompt.png" width="360" alt="系统提示词"></td>
|
|
15
|
+
</tr>
|
|
16
|
+
<tr>
|
|
17
|
+
<td align="center"><img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/01-mode-switch.png" width="360" alt="基础模式"></td>
|
|
18
|
+
<td align="center"><img src="https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/02-plugin-switches.png" width="360" alt="插件开关"></td>
|
|
19
|
+
</tr>
|
|
20
|
+
</table>
|
|
46
21
|
|
|
47
22
|
## 安装
|
|
48
23
|
|
|
49
|
-
|
|
24
|
+
钉版本。只写包名时，pnpm 的发布冷却期可能装到旧版。细节见 [docs/TROUBLESHOOTING.zh.md](docs/TROUBLESHOOTING.zh.md)。
|
|
50
25
|
|
|
51
26
|
```sh
|
|
52
|
-
dsh plugin --profile web add dsh-custom-mode@2.1
|
|
53
|
-
# 不带版本号会受 pnpm 的发布冷却期影响（`minimumReleaseAge`，默认一天）：发布后数小时内按名安装
|
|
54
|
-
# 可能**静默装到旧版** —— 实测 1.3.0 发布 38 分钟后按名安装装到了 1.0.3。用 profile 里的
|
|
55
|
-
# `npm ls dsh-custom-mode` 核对实际装到的版本，或像上面那样钉版本。
|
|
27
|
+
dsh plugin --profile web add dsh-custom-mode@2.2.1
|
|
56
28
|
```
|
|
57
29
|
|
|
58
|
-
|
|
59
|
-
**那里已有的文件一律不动**，所以你自己写过的 `prompt.md` 不会被覆盖。
|
|
60
|
-
|
|
61
|
-
**平台**：测试套件每次 push 都在 Ubuntu（Node 20 与 24）**和 Windows（Node 24）**上跑 —— 加 Windows
|
|
62
|
-
任务是因为那个平台有自己的失败模式（`install.sh` 里的 MSYS 路径、并发保存时 `rename` 的目标锁、平台表达式
|
|
63
|
-
求值方向相反）。两个 shell 脚本在任何 POSIX shell 下都能用，含 Git Bash。
|
|
64
|
-
|
|
65
|
-
### 图形界面安装（不用终端）
|
|
66
|
-
|
|
67
|
-
dsh `0.1.6-alpha.2` 起有插件管理页：**侧边栏 → 插件 → 添加插件**。它接受三种输入，本插件对应如下：
|
|
30
|
+
重启为这个 profile 提供服务的进程。设置页上的版本号才是正在运行的版本。
|
|
68
31
|
|
|
69
|
-
|
|
70
|
-
| --- | --- | --- |
|
|
71
|
-
| **包名** | `dsh-custom-mode` | 受 pnpm 发布冷却期影响，可能装到旧版。要这一版请钉 `@2.1.0` |
|
|
72
|
-
| **GitHub 仓库地址** | `https://github.com/BOWLUNA/dsh-custom-mode` | 指向**仓库根**即可 |
|
|
73
|
-
| **本地插件目录** | `<你 clone 的路径>` | 就是仓库根 —— 仓库根**本身**就是发布包 |
|
|
74
|
-
|
|
75
|
-
想逛整个生态还有一个**应用内市场**：装 `dshmarket`（`dsh plugin --profile web add dshmarket`），
|
|
76
|
-
打开 **设置 → 插件市场**，搜 `dsh-custom-mode` —— 卡片会读本插件声明的 `engines.dsh` 范围，
|
|
77
|
-
以及仓库里 `screenshots.json` 列出的精选截图（五张；它们就是 README 用的那几张
|
|
78
|
-
`docs/images/*.png`，所以每张图在仓库里只有一份）。
|
|
79
|
-
|
|
80
|
-
三条都可用，因为**仓库根的 `package.json` 就是发布包**：`dsh.bundle` / `main` /
|
|
81
|
-
`exports["./client"]` 都声明在仓库根，所以 npm 安装与"GitHub 地址"安装拿到的是同一批文件。
|
|
82
|
-
1.10.0 之前这个仓库有**两份清单**——根部的 `private: true` 包装清单加 `editor/package.json`——
|
|
83
|
-
那正是第三方目录把本插件显示成 `dsh-custom-mode#editor`、以及 dshfind 这类站点读到包装清单的
|
|
84
|
-
`private: true` 后报"作者尚未发布到 npm"的原因。现在只有根清单一份，`test/manifests.test.mjs` 盯着它不被加回来。
|
|
85
|
-
|
|
86
|
-
### 桌面端
|
|
87
|
-
|
|
88
|
-
桌面端就在 dsh 仓库里（`apps/desktop`），**与 dsh 同版本号发布**（Electron 与 `@deepseek-ai/dsh`
|
|
89
|
-
永远同一个精确版本），而且它就是**套了 Electron 壳的完整 Web 应用** —— 所以本插件的页面在那边原样渲染。
|
|
90
|
-
安装只有一条路，就是上面那条：
|
|
32
|
+
桌面端从应用里的插件页安装。CLI 不能改 `profiles/desktop`。
|
|
91
33
|
|
|
92
|
-
|
|
93
|
-
- **不要试着用独立的 CLI 装 —— dsh 自己就会拒绝**（0.1.7-rc.2 实测，0.2.0-rc.2 复测同样）：
|
|
94
|
-
```
|
|
95
|
-
$ dsh plugin --profile desktop add .
|
|
96
|
-
error: profile "desktop" is managed exclusively by the Electron application
|
|
97
|
-
```
|
|
98
|
-
桌面端独占 `$DSH_HOME/profiles/desktop`：那里的包操作持有 profile 事务锁，启动恢复还会重命名
|
|
99
|
-
`cordis.patch.yml`。所以 `install.sh` 也**拒绝** `--profile desktop` 并指向应用内安装 —— 两边一致，
|
|
100
|
-
而不是某一方偷偷绕过去。（只想在本机模拟 profile 形状时可设 `DSH_ALLOW_DESKTOP_PROFILE=1`。）
|
|
101
|
-
**应用自带的捆绑 CLI 是例外**：`<安装目录>\resources\runtime\cli\bin\dsh.cmd` 可以操作那个 profile
|
|
102
|
-
（1.11.1 实测时，命令写的版本和装上的版本对不上，这次记录作废）。它是启动器而不是 dsh 的
|
|
103
|
-
新功能 —— 它用 `ELECTRON_RUN_AS_NODE=1` 起 Electron 去跑 desktop-host 的 CLI，所以那是**应用在跟自己的
|
|
104
|
-
profile 说话**，不是从外面驱动它。
|
|
105
|
-
- **预设那一侧不用做任何事**：`$DSH_HOME/.agent-presets/` 是桌面端与 CLI 共享的产品数据，
|
|
106
|
-
预设由插件首次激活时落盘。
|
|
107
|
-
- **模式没出现在选择器里，就去「设置 → 自定义模式」读那条告警。** 行的启动条件在本机不满足时，平台会把整个
|
|
108
|
-
预设判为 broken 并**从所有选择器里丢掉**；设置页会点名那几行，并给出**「按本线修复」**。在桌面端那条线上，
|
|
109
|
-
这通常是一次点击 + **重启应用** —— 选择器只在应用启动时重读注册表（1.11.1 实测，见 `docs/MEASUREMENTS.md` §34）。
|
|
110
|
-
- 万一某个第三方 bundle 让应用起不来：原生恢复对话框提供**「禁用第三方插件」**，已安装的包与插件数据都留在磁盘上。
|
|
34
|
+
在 Windows 上，`install.sh` 是 bash，而且 PATH 里要有 `dsh`。否则用 DeepSeek Harness 自带的 `dsh`，或 `node node_modules/@deepseek-ai/dsh/lib/bin.js`。
|
|
111
35
|
|
|
112
|
-
|
|
113
|
-
版本比对（含预发布版）；而且自 0.2.0 起这项检查从"警告"升级成了**安装闸门**：范围不覆盖运行时就
|
|
114
|
-
直接装不进去（`installation rejected: Plugin … is incompatible with dsh 0.2.0-rc.2`）。所以那个范围
|
|
115
|
-
**就是**支持声明本身，只有在真实安装并测过新线之后才会动——"大概能用"的范围正是会变成支持工单的那种声明。
|
|
116
|
-
|
|
117
|
-
想同时留下源码（或者不用 npm 安装），就 clone 下来跑脚本，它把同样两件事显式做一遍：
|
|
118
|
-
|
|
119
|
-
```sh
|
|
120
|
-
git clone https://github.com/BOWLUNA/dsh-custom-mode
|
|
121
|
-
cd dsh-custom-mode
|
|
122
|
-
./install.sh # 复制 preset/ 到 $DSH_HOME/.agent-presets/custom/，并安装插件
|
|
123
|
-
./uninstall.sh # 卸载插件；默认保留你的提示词，加 --purge 一并删除
|
|
124
|
-
```
|
|
36
|
+
## 使用
|
|
125
37
|
|
|
126
|
-
|
|
38
|
+
1. 打开设置 → 自定义模式。
|
|
39
|
+
2. 改系统提示词。保存按钮在编辑器下面。
|
|
40
|
+
3. `settings.yaml` 里还没有 `agent-presets.default` 时，新会话用这个助手。已经写过的值保持原样。
|
|
127
41
|
|
|
128
|
-
|
|
42
|
+
提示词是 `prompt.md`。下一步组装模型输入时会重读这个文件。历史可以把旧稿载入编辑器；载入不落盘。打开页面之后文件被改过时，这一次保存会被拒绝。模型要改同一份文件，只能走 `custom_prompt`，并且先问过你。
|
|
129
43
|
|
|
130
|
-
|
|
131
|
-
（[最新版](https://github.com/BOWLUNA/dsh-custom-mode/releases/latest/download/dsh-custom-mode.dshpreset)）。
|
|
132
|
-
它是一个 zip，里面是一个**开箱可用的助手**：`manifest.json` 加 `preset/` —— 组成文件、`prompt.md`、
|
|
133
|
-
每次模型调用前重读它的读取器，以及一个**模型可见的工具**（读写这份提示词）。在桌面端导入它，
|
|
134
|
-
**不用装任何包**就能得到一个可用的「自定义模式」：
|
|
44
|
+
新建助手时选一种姿态。它只影响下一次新建。
|
|
135
45
|
|
|
136
|
-
| | |
|
|
46
|
+
| 姿态 | 新建之后 |
|
|
137
47
|
| --- | --- |
|
|
138
|
-
|
|
|
139
|
-
|
|
|
140
|
-
|
|
141
|
-
⇒ 预设是「30 秒看看这是什么」，插件是「长期用它」。导入预设与之后装插件**不冲突**：
|
|
142
|
-
插件把自己的预设写在 `$DSH_HOME/.agent-presets/` 下，且**从不覆盖**你自己写的 `prompt.md`。
|
|
143
|
-
|
|
144
|
-
## 使用
|
|
48
|
+
| 开发 | 内置标准模式的工具集。 |
|
|
49
|
+
| 写作 | 终端关，文件工具开。 |
|
|
50
|
+
| 聊天 | 文件和终端关。 |
|
|
145
51
|
|
|
146
|
-
|
|
52
|
+
## 边界
|
|
147
53
|
|
|
148
|
-
-
|
|
149
|
-
-
|
|
150
|
-
-
|
|
151
|
-
（`tools/pre-execute` 返回 `ask`）：请求会停在「等待审批」，面板里写明**要写什么、写到哪**，你点「允许一次」
|
|
152
|
-
才会执行。实测：审批策略为 `ask` 时弹面板且批准后真的写入；为 `never`（完全权限）时不弹窗、**直接拒绝**。
|
|
153
|
-
所以最坏情况是"改不成"，从不是"悄悄改成了"。
|
|
154
|
-
- **「配置了却不生效」会被点名** —— 设置页会指出那些不生效的配置：「身份（系统提示词）」这一行关着而
|
|
155
|
-
`prompt.md` 还有内容（你写的提示词被静默忽略）、`custom_prompt` 工具行关着、助手没有名字或描述
|
|
156
|
-
（选择器里会显示成裸 id 或「暂无描述」）。
|
|
157
|
-
- **agent 能改自己的提示词，但要你批准** —— 会话内的 `custom_prompt` 工具可以读、整体替换，或者**追加**。
|
|
158
|
-
追加的意义在于**不必把整段提示词重新写一遍**：想记住一条规则时，不可能因为重写而丢掉已有内容
|
|
159
|
-
（实测：模型可能仍会先读一次，看看自己要加到什么内容后面）。两种写入动作都会先过平台的审批面板。
|
|
160
|
-
- **改动历史** —— 每次保存，以及**在设置页之外**发生的任何改动（会话内的 `custom_prompt` 工具、手工编辑 `prompt.md`），都会在提示词框下面留下一版，并标明时间与来源。载入某一版**只改草稿**：不点保存不会落盘，所以翻旧版本不会毁掉当前这版。在此之前，提示词被会话内改掉是**看不见的** —— 页面永远只显示"当前文本"。
|
|
161
|
-
- **恢复出厂提示词** —— 一键把**出厂模板**（新建助手时得到的那份文本）填回编辑器。它和页面上其它改动一样只改**草稿**：不点保存不会落盘，「重新读取」即可撤销。在此之前，把提示词改坏了只能删掉助手重建。
|
|
162
|
-
- **新增助手** —— 填个名字点「新增助手」。新助手从模板生成：标准模式的全部行 + 一份默认提示词，写好后在新建会话的选择器里就能选到它 —— **已经打开的页面里，选择器的列表是加载时的快照，要看到新助手需刷新一次（F5）**（实测；roster 本身已是最新）。
|
|
163
|
-
- **复制一份** —— 把当前助手的提示词、基础模式、逐行开关整个复制到新助手，之后各改各的。
|
|
164
|
-
- **每个助手各自独立** —— 提示词、基础模式、逐行开关都属于它自己，改一个不影响别的。
|
|
165
|
-
- **基础模式是"行集合"，不是提示词** —— 底子决定有哪些行、这个模式有哪些工具；本插件始终把底子的
|
|
166
|
-
`persona` 行替换成自己的读取器（`complete: false`），所以底子的**提示词语义不会被继承**。最明显的是
|
|
167
|
-
「极简模式」：你拿到的是极简的工具集，不是极简的提示词。
|
|
168
|
-
- **第五个基础模式：自定义模式（全部出厂行的并集）** —— 前四个是 dsh 出厂的模式，第五个是**本插件自己合成**的。
|
|
169
|
-
它的行集合是那四个模式的并集；同一行在多个模式里都有时，取**先出现的那个模式**的原文与出厂默认
|
|
170
|
-
（顺序：标准 → PTC → 极简 → 创造），所以出厂状态以标准模式为准。
|
|
171
|
-
为什么需要它：开关只能作用在**基础文本里已经有的行**上，于是选「标准模式」时，只有 PTC 才有的
|
|
172
|
-
`tool-presentation`、只有极简才有的持久终端组、只有创造模式才有的 `tool-cordis` 是**拨不到的**
|
|
173
|
-
—— 不是界面藏起来了，是合成器里根本没有那条通路。0.2.0-rc.2 上实测：标准 32 行、PTC 33 行、创造 33 行、
|
|
174
|
-
极简 7 行，**并集 40 行**。取并集时分组整体搬运，`isolate` realm 与 `!!js` 平台条件原样保留，
|
|
175
|
-
因此不会凭空造出一个会让 `dsh-agent-presets` 拒绝挂载的行。
|
|
176
|
-
- **两套壳不能同时开 —— 插件替你避让。** 并集里有一组互斥的行：极简的「持久终端壳」和标准的
|
|
177
|
-
`tool-bash`/`tool-pwsh` 是同一件东西的两种实现，都注册一个叫 `bash` 的工具。同时启用会让
|
|
178
|
-
`dsh-agent-presets` 把整个模式判为 **broken**，而 broken 的模式会被**从所有选择器里静默丢掉** ——
|
|
179
|
-
设置页却全绿。所以当选「自定义模式」时，打开其中一侧会自动关掉另一侧，并在保存提示里说明动了哪一行。
|
|
180
|
-
页面之外写进去的冲突组合（手工编辑、别的工具）会在告警里被点名。
|
|
181
|
-
- **切换助手不会丢草稿** —— 每个助手各自留着未保存的修改，列表上用「未保存」标出来；唯一会放弃修改的是「放弃修改并重新读取」（有草稿时按钮会改名说明）。
|
|
182
|
-
- **删除** —— 先确认，再由插件自己动手删。确认形态取决于这条线：壳把 `RiskConfirmation` 交给第三方客户端插件时，是壳自己的弹窗（需勾选）；而 `0.1.7-rc.2` 的客户端种子表只暴露 `Button/Input/Switch/Tag/Pill`，于是退化为原生 `confirm`（护栏不变，少一个勾选框）。删除两条线都能用：`0.1.6` 及更早有 `agentPresets.remove()`，`0.1.7`+ 根本没有这个调用 —— 那里由插件自己注销注册表项并删掉目录。删除只移除磁盘上的模式目录：**正在使用它的会话不受影响**（组成在会话创建时就已读取），新建会话时不再出现。
|
|
183
|
-
- **直接对 agent 说** —— 每个助手都自带 `custom_prompt` 工具，会话里可以读取或改写**它自己**的提示词。
|
|
184
|
-
- **直接改文件** —— `$DSH_HOME/.agent-presets/<助手 id>/prompt.md` 是那个助手的唯一事实来源。
|
|
54
|
+
- 不替换标准、PTC、极简、创造。
|
|
55
|
+
- 不附带角色扮演预设。
|
|
56
|
+
- 不用 CLI 改桌面端 profile。headless 不会启动使用 agent preset 的会话。
|
|
185
57
|
|
|
186
|
-
|
|
58
|
+
## 兼容
|
|
187
59
|
|
|
188
|
-
|
|
189
|
-
`@deepseek-ai/dsh-client-ui-primitives`，因此主题、深浅色与后续改版都会自动作用到本页；老壳没有提供这组
|
|
190
|
-
原子组件时会退回内置的朴素控件，功能不变。
|
|
60
|
+
声明范围：`>=0.1.5-rc.2 <0.2.0-0 || >=0.1.6-alpha.1 <0.2.0-0 || >=0.1.7-alpha.1 <0.2.0-0 || >=0.2.0-0 <0.3.0-0 || >=0.2.1-alpha.1 <0.3.0-0`
|
|
191
61
|
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
### 与官方「插件管理」页的分工
|
|
195
|
-
|
|
196
|
-
dsh `0.1.6-alpha.2` 起自带了插件管理页，可以实时启用/停用插件。它和本模式的逐行开关**管的是不同层级**：
|
|
197
|
-
|
|
198
|
-
| | 官方插件管理页 | 本模式的逐行开关 |
|
|
62
|
+
| dsh | 声明 | 2.2.1 核对 |
|
|
199
63
|
| --- | --- | --- |
|
|
200
|
-
|
|
|
201
|
-
|
|
|
202
|
-
|
|
203
|
-
两者并存，不冲突：官方决定「这台机器有什么」，本模式决定「这个模式用其中的哪些」。
|
|
64
|
+
| `0.2.0-rc.2` | 声明支持 | 本版发布前的 Windows web profile |
|
|
65
|
+
| `0.2.1-alpha.1` | 声明支持，CI 有这条腿 | 本版没有重跑 |
|
|
66
|
+
| `0.1.7-rc.2` | 声明支持，CI 有这条腿 | 本版没有重跑 |
|
|
204
67
|
|
|
205
|
-
|
|
206
|
-
**agent-preset 行保持只读**。也就是说**官方管不到 preset 这一层**——本模式补的正是这一块。
|
|
207
|
-
|
|
208
|
-
一个可以当场演示的例子：`tool-plugin-manager`（模型侧的插件安装/启停工具）在**标准模式与 PTC 模式里
|
|
209
|
-
出厂就是关闭的**（只有创造模式默认打开）。官方模式不给你改它的入口，而在这里**拨一下就能打开**。
|
|
210
|
-
|
|
211
|
-
## 工作原理
|
|
212
|
-
|
|
213
|
-
dsh 的系统提示词通常来自 preset 的 YAML，而官方 `@deepseek-ai/dsh-persona` 的 `prefix` 只在挂载时解析一次。本 preset 注册同名的 `deployment:persona-prefix` section，但把 `text` 写成**函数**，agent loop 在每次模型调用前都会调它。
|
|
214
|
-
|
|
215
|
-
因此两件事的生效时机不同：
|
|
216
|
-
|
|
217
|
-
- **提示词文本**每步重新读取，所以改动对**正在运行**的会话立即生效。
|
|
218
|
-
- **开关与基础模式**会重写组成文件。`agent-presets` 在该文件的 `mtimeMs` 与 `size` 变化时重新挂载，所以由**新会话**生效；已开着的会话保持它启动时的配置 —— 这是刻意的，中途换工具集会出问题。
|
|
219
|
-
|
|
220
|
-
行开关是三态。没碰过的行与出厂行逐字节相同，包括 `!!js` 平台条件与出厂 `disabled`；显式开或关才会把那个条件替换成布尔值。平台表达式在宿主端求值，所以页面显示的是这台机器上实际生效的状态，而不是"有没有这个键"。
|
|
221
|
-
|
|
222
|
-
多助手不需要机制上的新能力：`dsh-agent-presets` 本来就会扫描用户预设根目录下的**每一个**目录，而且每次读 roster 都重新扫盘，所以一个刚建的目录在下一次选会话时就可见。每个助手的 `prompt-reader.mjs` / `prompt-tool.mjs` 都是按**自己模块位置**解析 `prompt.md` 的，N 份拷贝等于 N 套互不干扰的提示词。新增用包内模板播种；删除在有 `agentPresets.remove()` 的线上交给平台（它会拒绝删出厂 preset，并再确认目录确实在可写根目录下），在 `0.1.7`+ 上由本插件自己注销注册表项并删目录。
|
|
223
|
-
|
|
224
|
-
## 版本
|
|
225
|
-
|
|
226
|
-
**支持三条线：最新正式线（`0.2.0-rc.2`，npm 的 `latest` 与 `next` 自 2026-09-29 起都指向它，也是桌面端
|
|
227
|
-
所在的那条线）、最新预览线（`0.2.1-alpha.1`，npm 的 `alpha` 指向它）与上一个正式版（`0.1.7-rc.2`，
|
|
228
|
-
仍在声明范围内，现役安装大多在它上面）** —— 声明为
|
|
229
|
-
`>=0.1.5-rc.2 <0.2.0-0 || >=0.1.6-alpha.1 <0.2.0-0 || >=0.1.7-alpha.1 <0.2.0-0 || >=0.2.0-0 <0.3.0-0 || >=0.2.1-alpha.1 <0.3.0-0`。
|
|
230
|
-
官方一键安装读的是 `peerDependencies`，并且**预发布版参与比较**（`dsh-app-boot` 里的 `semver.satisfies(version, range, { includePrerelease: true })`）。因此当前稳定线 `0.2.0-rc.2` 与预览线 `0.2.1-alpha.1` 都能装上。范围里仍点名预发布版本，是因为 npm / pnpm 的默认比较更严，插件市场走那套语义时也不会把预览线拒掉。CI 对这三条线各装一次并跑完全部测试。渲染闸门只跑 `0.2.0-rc.2`，壳的界面改动先落在这条线上。更早的 `0.1.5` / `0.1.6` 仍在 peer 范围内，不再单独占一条 CI。
|
|
231
|
-
**官方桌面端（DeepSeek Harness Desktop）也在覆盖范围内**：它与 dsh 同版本号，当前即为 `0.2.0-rc.2`，
|
|
232
|
-
正是这条矩阵钉住的组合；在应用内（侧栏 → Plugins）安装即可，CLI 那条路 dsh 自己会拒。
|
|
233
|
-
`0.2.0-rc.2` 实测（2026-09-30，干净的一次性 `DSH_HOME`）：`dsh plugin --profile web add dsh-custom-mode`
|
|
234
|
-
640ms 解析成功、组合树里有本插件的行、启动时五个预设文件全部播种、声明式注册表同步出助手，
|
|
235
|
-
且 `agentPresets` 能力面不变（`list, register, inventory, select, document`）。
|
|
236
|
-
|
|
237
|
-
包版本走**自己的线** —— `1.0.0`、`1.0.1` …… 它不镜像 DSH 的版本号。本插件支持哪些 dsh，由
|
|
238
|
-
根 `package.json` 的 `engines.dsh` 与 `@deepseek-ai/dsh` peer 范围声明，并由
|
|
239
|
-
`tools/verify-version-consistency.mjs`（CI 里执行）断言"CI 实际安装并测试的 dsh 版本落在这些范围内"。
|
|
240
|
-
|
|
241
|
-
拆开有两个原因。一是目录与市场要求裸 `x.y.z` 才自动安装 —— 有的会解析 npm `latest` 并拒绝任何带
|
|
242
|
-
预发布标签的版本；二是版本号字符串本来就不是一个可校验的声明，声明式的范围才是，而且它才是官方改动时
|
|
243
|
-
会过期的那一个。实际决定兼容性的仍然是下面这些 API 是否还在 —— 那些范围就是为它们写的。
|
|
244
|
-
|
|
245
|
-
<details>
|
|
246
|
-
<summary>耦合点清单（升级 dsh 时逐个核对）</summary>
|
|
247
|
-
|
|
248
|
-
| 依赖 | 变化后的后果 |
|
|
249
|
-
| --- | --- |
|
|
250
|
-
| `ctx.systemPrompt.section()` 且 `text` 支持**函数** | 提示词不再热更新 —— 整个项目的立足点 |
|
|
251
|
-
| `agentPresets` 依据组成文件的 `mtimeMs`+`size` 重挂载 | 开关要重启进程才生效 |
|
|
252
|
-
| `ctx.tools.register()` | 失去 `custom_prompt` 工具 |
|
|
253
|
-
| `ctx.connection.fetch.register({ path, methods, requestBody, fetch })` | 设置页 404 —— 什么都没注册 |
|
|
254
|
-
| `kind: 'prefix'` 同时匹配 `path` 与 `path/…` | 只有列表能打开，`/state`、`/create`、`/delete` 全部 404 |
|
|
255
|
-
| `agentPresets.list()` 行里有 `id` / `trust` / `path`，`preset.yml` 提供 `name` / `description` | 助手列表为空或认不出助手 |
|
|
256
|
-
| `agentPresets.remove(id)`（仅旧线），且拒绝 `trust: 'system'` | 0.1.7+ 的删除不再需要它 —— 声明式后端自己注销注册表项并删目录 |
|
|
257
|
-
| `ctx.connection.requestRejection(req)` | 设置页失败关闭（503），不再提供服务 |
|
|
258
|
-
| `ctx.inject(deps, cb)`（作用域化等待） | 在没有 web 服务器的 profile 里，整行会停在 `pending` |
|
|
259
|
-
| `dsh.client` + `exports["./client"]`，且客户端 bundle id 等于包名 | 浏览器半不会被发现 |
|
|
260
|
-
| `settings.section` 插槽（`id` / `order` / `label`） | 设置项位置与标签 |
|
|
261
|
-
| **`settings.section` 不再提供 `locale:`**（0.1.6-alpha.2 起） | 壳不会递进绑定到本命名空间的 `t`；页面自带词典兜底，见 ARCHITECTURE §15 |
|
|
262
|
-
| `preset.yml` 的 `order` 参与 roster 排序 | 「上移 / 下移」不生效 |
|
|
263
|
-
| `ctx.locale.register/bind` | 回退中文 |
|
|
264
|
-
| **出厂组成从哪来** —— 0.1.7+ 是 `agentPresets.readDocument(<mode>).content`，更早是 `@deepseek-ai/dsh-agent-presets` 的文件 | 基础模式与插件开关变为只读（提示词仍可保存），见 `base-composition.mjs` |
|
|
265
|
-
| 出厂布局 `<presets>/<id>/agent.cordis.yml` 与行的文本形状 | 基础模式切换失效 |
|
|
266
|
-
| `!!js` 平台表达式 | 平台行显示错误状态 |
|
|
267
|
-
|
|
268
|
-
</details>
|
|
68
|
+
单元套件在 WSL2 Ubuntu 26.04 下也通过了（只有 Node，没有 dsh 进程，没有浏览器）。这不是 Linux 桌面的结果。
|
|
269
69
|
|
|
270
70
|
## 文档
|
|
271
71
|
|
|
272
|
-
- [
|
|
273
|
-
- [
|
|
274
|
-
- [
|
|
275
|
-
- [
|
|
276
|
-
- [
|
|
277
|
-
- [`CHANGELOG.md`](CHANGELOG.zh.md) · [`SECURITY.md`](SECURITY.zh.md) · [`CONTRIBUTING.zh.md`](CONTRIBUTING.zh.md)
|
|
72
|
+
- [docs/TROUBLESHOOTING.zh.md](docs/TROUBLESHOOTING.zh.md) — 装到旧版、基础模式不可用、升级停在半截
|
|
73
|
+
- [docs/ARCHITECTURE.zh.md](docs/ARCHITECTURE.zh.md) — 提示词在哪被读，依赖宿主的哪些调用
|
|
74
|
+
- [docs/PUBLISHING.zh.md](docs/PUBLISHING.zh.md) — tag 与发布
|
|
75
|
+
- [CONTRIBUTING.zh.md](CONTRIBUTING.zh.md) — 给人看
|
|
76
|
+
- [AGENTS.md](AGENTS.md) — 给 agent 看
|
|
278
77
|
|
|
279
|
-
##
|
|
280
|
-
|
|
281
|
-
```sh
|
|
282
|
-
node test/run.mjs # 15 个套件；自己解析出厂 preset 目录（0.1.7+ 从宿主声明派生）
|
|
283
|
-
```
|
|
284
|
-
|
|
285
|
-
改 `client.js` 会被 `@deepseek-ai/dsh-client-hmr` 在约 1 秒后热替换；改宿主半（`index.mjs`、`composition.mjs`、`meta.mjs`、`paths.mjs`）需要重启。每个套件在防什么见 [`test/README.md`](test/README.zh.md)，改行为之前先读 [`CONTRIBUTING.zh.md`](CONTRIBUTING.zh.md)。
|
|
286
|
-
|
|
287
|
-
## 如果它有用
|
|
288
|
-
|
|
289
|
-
在 GitHub 上点个 ⭐，是让一个插件在几千个条目的目录里被看见的唯一办法 —— 它不花你什么，却正是这个项目
|
|
290
|
-
还在被维护的理由。如果它在你的 dsh 线上**不好用**，带上 `dsh --version` 提个 issue：那是最快的修法，
|
|
291
|
-
上面那张兼容表就是上一次这么来的。
|
|
292
|
-
|
|
293
|
-
## License
|
|
78
|
+
## 许可证
|
|
294
79
|
|
|
295
80
|
MIT
|
|
296
|
-
|
|
297
|
-
## 更新
|
|
298
|
-
|
|
299
|
-
插件装在 profile 的 `node_modules` 里，安装由平台负责，所以"更新"就是**再装一次** —— 你的数据不会被碰：
|
|
300
|
-
|
|
301
|
-
```sh
|
|
302
|
-
# 钉版本的写法：要哪版就是哪版
|
|
303
|
-
dsh plugin --profile web add dsh-custom-mode@2.1.0
|
|
304
|
-
# 然后重启为该 profile 提供服务的 DSH 进程
|
|
305
|
-
```
|
|
306
|
-
|
|
307
|
-
**不要按裸名安装，也不要用 `@latest`。** pnpm 有发布冷却期（`minimumReleaseAge`，默认 24 小时）。
|
|
308
|
-
`dsh plugin add dsh-custom-mode` 会解析成**超过 24 小时的最新版**。实测：npm 上 `latest` 已是发布 6 分钟的 1.12.2 时，`@latest` 装成了 1.11.6。请钉精确版本。
|
|
309
|
-
|
|
310
|
-
每次钉精确版本，pnpm 都会在 profile 的 `pnpm-workspace.yaml` 里追加一条 `minimumReleaseAgeExclude`。pnpm 11.7.0 只认第一条命中包名的记录（[pnpm#12463](https://github.com/pnpm/pnpm/issues/12463)）。这个包只留一条 `dsh-custom-mode`，不要留一串版本号。本插件不改这个文件。若安装报 `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`，把列表收成那一条再装一次：`node_modules` 里可能已经是新版本，而 `package.json` 仍写着旧版本。
|
|
311
|
-
|
|
312
|
-
**怎样算升级成功**：重启 dsh，再看本设置页底部的版本号。
|
|
313
|
-
|
|
314
|
-
**更新不会碰的东西**：`$DSH_HOME/.agent-presets/<你的助手>/` —— `prompt.md`、`preset.yml` 与你逐行拨过的开关都属于你。
|
|
315
|
-
播种只补**缺失**的文件，你写过的提示词永远不会被覆盖。
|
|
316
|
-
|
|
317
|
-
**如果基础模式与插件开关变灰、并带一行提示**：这条 dsh 线没有向本插件交出出厂组成（解析器依次试过宿主的
|
|
318
|
-
`readDocument()`、旧线的 presets 包、打包的 `dsh-web-app` patch，宿主日志里会写清每一次尝试）。系统提示词
|
|
319
|
-
仍可单独保存，模式本身不受影响。0.1.7 上这在 1.9.13 之前是一个硬 500。
|
|
320
|
-
|
|
321
|
-
**如果更新后某个模式不再出现在选择器里**：老版本创建的助手会保留它自己的组成文件；如果那份文件启用了一行本机
|
|
322
|
-
这条 dsh 线不提供的插件，平台会把整个预设判为 broken 并从选择器里静默丢弃（设置页照常能开）。打开设置页：
|
|
323
|
-
它会明确告诉你，并提供**「按本线修复」** —— 只关掉那几行，其它选择一字不动。
|
package/client.js
CHANGED
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
* Browser half: 「自定义模式」settings page — the assistant manager.
|
|
3
3
|
*
|
|
4
4
|
* Blocks:
|
|
5
|
-
* 0. 助手 —
|
|
6
|
-
* 1.
|
|
7
|
-
* 2.
|
|
8
|
-
* 3.
|
|
9
|
-
* 4.
|
|
5
|
+
* 0. 助手 — pick, create, duplicate, delete.
|
|
6
|
+
* 1. 系统提示词 — the prompt, then Save directly under it.
|
|
7
|
+
* 2. 模式名称 — display name and description.
|
|
8
|
+
* 3. 基础模式 — standard / ptc / minimal / cordis / all.
|
|
9
|
+
* 4. 插件开关 — collapsed until the user opens it.
|
|
10
10
|
*
|
|
11
11
|
* Three decisions worth knowing before editing this file:
|
|
12
12
|
*
|
|
@@ -126,11 +126,11 @@ try {
|
|
|
126
126
|
"msg.repaired": "已修复",
|
|
127
127
|
"meta.version": "插件版本",
|
|
128
128
|
"meta.versionHint": "未钉版本时，可能装到较旧的发布。要换版本，按 README 钉版本重装，然后重启。",
|
|
129
|
-
"api.saved": "已保存（{name}，{mode}
|
|
129
|
+
"api.saved": "已保存（{name}，{mode}）。下一步组装时会重读已保存的提示词。",
|
|
130
130
|
"api.conflict": "磁盘上的提示词已经变了，这次没有写入。先重新读取，再决定要不要覆盖。",
|
|
131
131
|
"api.savedWithExclusiveRows": "已保存（{name}，{mode}）。已关闭不能同时启用的行：{rows}。",
|
|
132
132
|
"api.created": "已创建「{name}」。刷新后，新会话的模式菜单里会出现它。",
|
|
133
|
-
"api.savedPrompt": "已保存系统提示词（{name}
|
|
133
|
+
"api.savedPrompt": "已保存系统提示词（{name}）。下一步组装时会重读这个文件。",
|
|
134
134
|
"api.duplicated": "已从「{from}」复制。两份互不影响。",
|
|
135
135
|
"api.deleted": "已删除「{name}」。正在使用它的会话不受影响。",
|
|
136
136
|
"api.reordered": "顺序已保存。新会话的模式菜单按此排列。",
|
|
@@ -205,7 +205,7 @@ try {
|
|
|
205
205
|
"cap.hint": "关闭的行，这个助手不会使用。",
|
|
206
206
|
"rows.hint": "关闭的行，这个助手不会使用。",
|
|
207
207
|
"prompt.heading": "系统提示词",
|
|
208
|
-
"prompt.hint": "
|
|
208
|
+
"prompt.hint": "保存后，下一步组装模型输入时重读这个文件。",
|
|
209
209
|
"status.enabled": "已启用",
|
|
210
210
|
"status.disabled": "已停用",
|
|
211
211
|
"status.changed": "已改",
|
|
@@ -219,7 +219,7 @@ try {
|
|
|
219
219
|
"msg.unsaved": "有未保存的修改",
|
|
220
220
|
"msg.readFailed": "读取失败",
|
|
221
221
|
"msg.saveFailed": "保存失败",
|
|
222
|
-
"msg.saved": "
|
|
222
|
+
"msg.saved": "已保存。下一步组装时会重读这个文件。",
|
|
223
223
|
"status.detail": "{message}：{detail}",
|
|
224
224
|
"row.persona.label": "身份（系统提示词）",
|
|
225
225
|
"row.persona.note": "关闭后，此提示词不会生效。",
|
|
@@ -360,11 +360,11 @@ try {
|
|
|
360
360
|
"msg.repaired": "Repaired",
|
|
361
361
|
"meta.version": "Plugin version",
|
|
362
362
|
"meta.versionHint": "Without a pinned version, an older release may be installed. To change it, reinstall with the version pin from the README, then restart.",
|
|
363
|
-
"api.saved": "Saved ({name}, {mode}).
|
|
363
|
+
"api.saved": "Saved ({name}, {mode}). The next model step rereads the saved prompt.",
|
|
364
364
|
"api.conflict": "The prompt on disk has changed, so this save was not written. Reload, then decide whether to overwrite.",
|
|
365
365
|
"api.savedWithExclusiveRows": "Saved ({name}, {mode}). Turned off rows that cannot be on together: {rows}.",
|
|
366
366
|
"api.created": "Created {name}. Refresh once, then it appears in the mode menu for a new session.",
|
|
367
|
-
"api.savedPrompt": "System prompt saved ({name}).
|
|
367
|
+
"api.savedPrompt": "System prompt saved ({name}). The next model step rereads this file.",
|
|
368
368
|
"api.duplicated": "Copied from {from}. The two are independent from now on.",
|
|
369
369
|
"api.deleted": "Deleted {name}. Sessions already using it are unchanged.",
|
|
370
370
|
"api.reordered": "Order saved. New sessions list modes in this order.",
|
|
@@ -439,7 +439,7 @@ try {
|
|
|
439
439
|
"cap.hint": "A row that is off is not used by this assistant.",
|
|
440
440
|
"rows.hint": "A row that is off is not used by this assistant.",
|
|
441
441
|
"prompt.heading": "System prompt",
|
|
442
|
-
"prompt.hint": "After you save, the next model step
|
|
442
|
+
"prompt.hint": "After you save, the next model step rereads this file.",
|
|
443
443
|
"status.enabled": "Enabled",
|
|
444
444
|
"status.disabled": "Disabled",
|
|
445
445
|
"status.changed": "changed",
|
|
@@ -453,7 +453,7 @@ try {
|
|
|
453
453
|
"msg.unsaved": "Unsaved changes",
|
|
454
454
|
"msg.readFailed": "Load failed",
|
|
455
455
|
"msg.saveFailed": "Save failed",
|
|
456
|
-
"msg.saved": "Saved.
|
|
456
|
+
"msg.saved": "Saved. The next model step rereads this file.",
|
|
457
457
|
"status.detail": "{message}: {detail}",
|
|
458
458
|
"row.persona.label": "Identity (system prompt)",
|
|
459
459
|
"row.persona.note": "Off: this prompt has no effect.",
|
|
@@ -2252,7 +2252,6 @@ try {
|
|
|
2252
2252
|
),
|
|
2253
2253
|
),
|
|
2254
2254
|
...(editorReady ? editorSections.filter((section) => section.key === "prompt") : []),
|
|
2255
|
-
...(editorReady ? editorSections.filter((section) => section.key === "name") : []),
|
|
2256
2255
|
react.createElement(
|
|
2257
2256
|
"div",
|
|
2258
2257
|
{ className: "cpfe-bar" },
|
|
@@ -2284,6 +2283,7 @@ try {
|
|
|
2284
2283
|
),
|
|
2285
2284
|
react.createElement("span", { className: statusClass }, shown),
|
|
2286
2285
|
),
|
|
2286
|
+
...(editorReady ? editorSections.filter((section) => section.key === "name") : []),
|
|
2287
2287
|
editorReady
|
|
2288
2288
|
? react.createElement(
|
|
2289
2289
|
"p",
|
package/composition.mjs
CHANGED
|
@@ -66,14 +66,14 @@ export {
|
|
|
66
66
|
* it never asks the host for the user's own preset.
|
|
67
67
|
*/
|
|
68
68
|
export const BASE_MODES = [
|
|
69
|
-
{ id: 'standard', label: '标准模式', note: '
|
|
70
|
-
{ id: 'ptc', label: 'PTC 模式', note: '
|
|
71
|
-
{ id: 'minimal', label: '极简模式', note: '只有 Shell
|
|
72
|
-
{ id: 'cordis', label: '
|
|
69
|
+
{ id: 'standard', label: '标准模式', note: '出厂的完整工具集。' },
|
|
70
|
+
{ id: 'ptc', label: 'PTC 模式', note: '标准模式，另开 PTC 工具呈现。' },
|
|
71
|
+
{ id: 'minimal', label: '极简模式', note: '只有 Shell 与终端。提示词仍以本页为准。' },
|
|
72
|
+
{ id: 'cordis', label: '创造模式', note: '标准模式，另开 Cordis 运行时工具。' },
|
|
73
73
|
{
|
|
74
74
|
id: UNION_MODE_ID,
|
|
75
|
-
label: '
|
|
76
|
-
note: '
|
|
75
|
+
label: '全部出厂行',
|
|
76
|
+
note: '四套官方预设的行合在一处，均可开关。',
|
|
77
77
|
},
|
|
78
78
|
]
|
|
79
79
|
|
package/defaults.mjs
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Fill `agent-presets.default` only when the user has not set it.
|
|
3
|
+
*
|
|
4
|
+
* The host hard-codes `standard` in the profile composition. The same key in
|
|
5
|
+
* `$DSH_HOME/settings.yaml` is the runtime override. Writing it on every boot
|
|
6
|
+
* would undo a user who chose Standard on purpose, so an existing `default`
|
|
7
|
+
* is left untouched — including `default: standard`.
|
|
8
|
+
*/
|
|
9
|
+
import { existsSync, mkdirSync, readFileSync } from 'node:fs'
|
|
10
|
+
import { join } from 'node:path'
|
|
11
|
+
import { writeAtomic } from './atomic.mjs'
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* @param {string} home - `DSH_HOME`.
|
|
15
|
+
* @param {string} presetId - assistant directory id, normally `custom`.
|
|
16
|
+
* @returns {{ wrote: boolean, reason: string }}
|
|
17
|
+
*/
|
|
18
|
+
export function ensureUnsetDefaultPreset(home, presetId) {
|
|
19
|
+
if (typeof home !== 'string' || home === '' || typeof presetId !== 'string' || !/^[a-z0-9-]+$/.test(presetId)) {
|
|
20
|
+
return { wrote: false, reason: 'bad-args' }
|
|
21
|
+
}
|
|
22
|
+
if (!existsSync(join(home, '.agent-presets', presetId, 'prompt.md'))) {
|
|
23
|
+
return { wrote: false, reason: 'no-preset' }
|
|
24
|
+
}
|
|
25
|
+
const file = join(home, 'settings.yaml')
|
|
26
|
+
if (!existsSync(file)) {
|
|
27
|
+
mkdirSync(home, { recursive: true })
|
|
28
|
+
writeAtomic(file, 'agent-presets:\n default: ' + presetId + '\n')
|
|
29
|
+
return { wrote: true, reason: 'created' }
|
|
30
|
+
}
|
|
31
|
+
const text = readFileSync(file, 'utf8')
|
|
32
|
+
if (text.includes('\0')) return { wrote: false, reason: 'binary' }
|
|
33
|
+
const lines = text.split('\n')
|
|
34
|
+
let section = -1
|
|
35
|
+
for (let i = 0; i < lines.length; i += 1) {
|
|
36
|
+
const line = lines[i]
|
|
37
|
+
if (line.trim() === '' || /^\s*#/.test(line)) continue
|
|
38
|
+
if (/^agent-presets\s*:/.test(line)) {
|
|
39
|
+
if (/default\s*:/.test(line)) return { wrote: false, reason: 'inline' }
|
|
40
|
+
section = i
|
|
41
|
+
break
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
if (section === -1) {
|
|
45
|
+
const suffix = (text.endsWith('\n') || text === '' ? '' : '\n') + 'agent-presets:\n default: ' + presetId + '\n'
|
|
46
|
+
writeAtomic(file, text + suffix)
|
|
47
|
+
return { wrote: true, reason: 'appended' }
|
|
48
|
+
}
|
|
49
|
+
for (let i = section + 1; i < lines.length; i += 1) {
|
|
50
|
+
const line = lines[i]
|
|
51
|
+
if (line.trim() === '' || /^\s*#/.test(line)) continue
|
|
52
|
+
if (/^\S/.test(line)) break
|
|
53
|
+
if (/^\s+default\s*:/.test(line)) return { wrote: false, reason: 'present' }
|
|
54
|
+
}
|
|
55
|
+
lines.splice(section + 1, 0, ' default: ' + presetId)
|
|
56
|
+
const next = lines.join('\n')
|
|
57
|
+
writeAtomic(file, next.endsWith('\n') ? next : next + '\n')
|
|
58
|
+
return { wrote: true, reason: 'inserted' }
|
|
59
|
+
}
|
package/index.mjs
CHANGED
|
@@ -55,7 +55,8 @@ import {
|
|
|
55
55
|
} from './preset-backend/index.mjs'
|
|
56
56
|
import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
|
|
57
57
|
import { dirname, join } from 'node:path'
|
|
58
|
-
import { PROMPT_PATH, COMPOSITION_PATH, ROUTE_PATH, PRESET_DIR } from './paths.mjs'
|
|
58
|
+
import { PROMPT_PATH, COMPOSITION_PATH, ROUTE_PATH, PRESET_DIR, dshHome } from './paths.mjs'
|
|
59
|
+
import { ensureUnsetDefaultPreset } from './defaults.mjs'
|
|
59
60
|
import {
|
|
60
61
|
allowlistOverrides,
|
|
61
62
|
applyRowExclusivity,
|
|
@@ -579,7 +580,7 @@ export function savePromptOnly(directory, { id, mode, prompt, name, description,
|
|
|
579
580
|
code: 'savedPromptOnly',
|
|
580
581
|
// 响应里的名字用**磁盘上的那个**（issue #9）：请求省略 name 时不该把 params.name 报成裸目录 id。
|
|
581
582
|
params: { name: (displayName === undefined || displayName === '' ? name : displayName) === '' ? id : (displayName === undefined || displayName === '' ? name : displayName), mode },
|
|
582
|
-
note: '
|
|
583
|
+
note: '已保存系统提示词（本机取不到基础模式的出厂组成，插件开关与基础模式未改动）。下一步组装时会重读这个文件。',
|
|
583
584
|
}
|
|
584
585
|
}
|
|
585
586
|
|
|
@@ -730,7 +731,7 @@ export function saveState(rows, input) {
|
|
|
730
731
|
params: { name: displayName, mode, rows: autoOff.join(', ') },
|
|
731
732
|
note:
|
|
732
733
|
'已保存（' + displayName + '，基础模式 ' + mode + '）。这两套壳注册同名工具、不能同时启用 —— ' +
|
|
733
|
-
'已自动关掉：' + autoOff.join('、') + '
|
|
734
|
+
'已自动关掉：' + autoOff.join('、') + '。下一步组装时会重读已保存的提示词。',
|
|
734
735
|
}
|
|
735
736
|
}
|
|
736
737
|
return {
|
|
@@ -739,7 +740,7 @@ export function saveState(rows, input) {
|
|
|
739
740
|
mode,
|
|
740
741
|
code: 'saved',
|
|
741
742
|
params: { name: displayName, mode },
|
|
742
|
-
note: '已保存（' + displayName + '，基础模式 ' + mode + '
|
|
743
|
+
note: '已保存（' + displayName + '，基础模式 ' + mode + '）。下一步组装时会重读已保存的提示词。',
|
|
743
744
|
}
|
|
744
745
|
}
|
|
745
746
|
|
|
@@ -1124,6 +1125,15 @@ export function apply(ctx) {
|
|
|
1124
1125
|
console.error('custom-mode: 初始化 preset 目录时出现意外错误（已忽略）: ' + describe(error))
|
|
1125
1126
|
}
|
|
1126
1127
|
|
|
1128
|
+
try {
|
|
1129
|
+
const presetDefault = ensureUnsetDefaultPreset(dshHome(), LEGACY_ID)
|
|
1130
|
+
if (presetDefault.wrote) {
|
|
1131
|
+
console.log('custom-mode: settings.yaml 里没有 agent-presets.default，已写成 ' + LEGACY_ID + '。已有的值不会改。')
|
|
1132
|
+
}
|
|
1133
|
+
} catch (error) {
|
|
1134
|
+
console.error('custom-mode: 没有写 agent-presets.default: ' + describe(error))
|
|
1135
|
+
}
|
|
1136
|
+
|
|
1127
1137
|
try {
|
|
1128
1138
|
ctx.inject(WEB_SERVICES, (scope) => {
|
|
1129
1139
|
// Compatibility guard: this plugin reads host APIs that a future DSH release could
|