dsh-fangcun 0.3.0 → 0.6.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/CHANGELOG.md +280 -0
- package/README.md +226 -171
- package/lib/cards.js +164 -150
- package/lib/compat.js +157 -0
- package/lib/detect.js +101 -101
- package/lib/dispatch.js +156 -0
- package/lib/index.js +244 -1
- package/lib/mcp-pipe.js +172 -172
- package/lib/prompt.js +94 -76
- package/lib/proof.js +334 -282
- package/lib/status.js +130 -130
- package/lib/tool.js +623 -0
- package/lib/usage.js +373 -373
- package/lib/widget.js +895 -895
- package/package.json +6 -5
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,285 @@
|
|
|
1
1
|
# 变更记录
|
|
2
2
|
|
|
3
|
+
## 0.6.0(2026-11-17)· 那根管子
|
|
4
|
+
|
|
5
|
+
暮雨拍板:「**管子现在就做,它是其他一切的前提**」,形态选「开新会话(方寸发,DSH 里冒出)」。
|
|
6
|
+
|
|
7
|
+
### 管子两端
|
|
8
|
+
|
|
9
|
+
| 端 | 做什么 |
|
|
10
|
+
|---|---|
|
|
11
|
+
| **方寸** | 项目页多一个「🧠 派给 DSH」按钮 → 落一份派单文件到 `<数据根>/.dispatch-dsh/` |
|
|
12
|
+
| **插件(本仓)** | 每 8 秒看一眼派单目录,看见就 `ctx.agents.create()` 开新会话,把上下文包作为**第一条用户消息**塞进去,**建成后才删派单** |
|
|
13
|
+
|
|
14
|
+
### 为什么经文件,而不是两边直连
|
|
15
|
+
|
|
16
|
+
三方各有硬边界,只有文件能同时满足:
|
|
17
|
+
|
|
18
|
+
1. **方寸不 import DSH 的任何东西**(它连"DSH 装没装"都只是只读探测);
|
|
19
|
+
2. **插件不 import 方寸代码**(`plugin ③` 钉着,`layering ①` 也钉着);
|
|
20
|
+
3. 上下文包上万字,**塞不进命令行参数**。
|
|
21
|
+
|
|
22
|
+
所以:方寸写文件,插件读文件。跨进程只经文件,谁也不用知道对方的内部。
|
|
23
|
+
|
|
24
|
+
### 三条纪律(`test/dispatch.test.mjs` 7 条钉着)
|
|
25
|
+
|
|
26
|
+
1. **建成会话才删派单** —— 建失败留着,下次还能试。否则"用户点了没反应,派单也没了"是最坏的静默失败;
|
|
27
|
+
2. **坏派单立即丢弃** —— 不许每一拍都去读一个永远解不开的文件;
|
|
28
|
+
3. **坏文件/没目录/宿主炸了都不抛** —— 派单是锦上添花,不该拖垮记账与挂件。
|
|
29
|
+
|
|
30
|
+
### 为什么塞 `user/message` 而不是 `systemPrompt`
|
|
31
|
+
|
|
32
|
+
`systemPrompt` 每次装配都重算;而这个包是**"这一次派单的快照"**,属于这一轮历史。
|
|
33
|
+
塞成 `user/message`,模型看得到,也能在后续轮次里被引用,且不会跟着每一轮变形。
|
|
34
|
+
|
|
35
|
+
### 不开第二个 agent 循环
|
|
36
|
+
|
|
37
|
+
REV-014 定案:**借 DSH,不自研**。这里只调宿主的 `agents.create`,循环归宿主。
|
|
38
|
+
宿主没有 `agents` 服务(老宿主/形状变了)时**明说派不出去**,不假装。
|
|
39
|
+
|
|
40
|
+
### `health.dispatch` 让这件事可自证
|
|
41
|
+
|
|
42
|
+
用户点了「派给 DSH」,真正想知道的是**DSH 那边到底开没开**:
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
"dispatch": { "lastAt": "...", "lastProject": "sitian", "lastOk": true,
|
|
46
|
+
"lastSessionId": "fangcun-dispatch-...", "lastError": "" }
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
只报"成没成 + 会话 id",**不把上下文正文写进 health**(那可能是私事)。
|
|
50
|
+
|
|
51
|
+
**114/114 全绿。** 方寸侧 `tsc -p tsconfig.main.json` 退出 0、`vite build` 退出 0。
|
|
52
|
+
|
|
53
|
+
## 0.5.0(2026-11-17)
|
|
54
|
+
|
|
55
|
+
这一版让「**方寸的记忆**真的能用上」—— 而不只是存着。
|
|
56
|
+
|
|
57
|
+
### 来由
|
|
58
|
+
|
|
59
|
+
用户当天两句原话:
|
|
60
|
+
|
|
61
|
+
> 「会话迟早会消失,方寸要不要**直接把记忆层一步到位**算了。**不是记忆插件,但比记忆插件更强,是项目的灵魂。**」
|
|
62
|
+
|
|
63
|
+
> 「**方寸插件本身还可以做什么,好让 DSH 和方寸的组合更顺一点。**」
|
|
64
|
+
|
|
65
|
+
核实到的事实:方寸的 `contextPack`(章程+登记表+方针+决策+卡+日志六处)
|
|
66
|
+
**只生成文件,界面上没有「派给 agent」的口子** —— 所以模型开工前根本不知道项目要变成什么。
|
|
67
|
+
|
|
68
|
+
### 新增 `fangcun_context`:一屏说完项目背景
|
|
69
|
+
|
|
70
|
+
模型一次调用拿到三样,全是**作数的**、不是"相似片段":
|
|
71
|
+
|
|
72
|
+
| 拿到什么 | 来自方寸 | 为什么它比记忆插件强 |
|
|
73
|
+
|---|---|---|
|
|
74
|
+
| 章程四节(使命/目标/场景/边界) | `project_charter` | 这是**价值观锚**,检索不出来(它不是"说过的话")。缺哪节会明说「真没写」,不许替项目编 |
|
|
75
|
+
| 最近有效决策 | `decision_list` | 带**状态**(有效/已撤销/已合并)—— 知道哪条已被推翻,片段相似度不知道 |
|
|
76
|
+
| 手上还有的活 | `list_tasks` | 只列未结(完成/驳回不进背景),带状态机 |
|
|
77
|
+
|
|
78
|
+
三处**并行**拉(串行慢三倍且互不依赖);**全部都失败才算"没连上"**,只缺一处仍算连上并单独标注。
|
|
79
|
+
输出有界:决策 8 条、卡 12 张,超了明说。
|
|
80
|
+
|
|
81
|
+
### 规则段改成"先看项目要变成什么"
|
|
82
|
+
|
|
83
|
+
原来写的是"开工先查 → 列卡"。现在改成:
|
|
84
|
+
|
|
85
|
+
> 先用 `fangcun_context` 看清**这个项目要变成什么**(使命/目标/边界)再动手 ——
|
|
86
|
+
> 别凭记忆猜进度,也别照通用常识来。
|
|
87
|
+
|
|
88
|
+
这一句就是"AI 写代码没全局意识、天天乱改、忘记东西"的对策:**先给它项目的灵魂,再让它动手。**
|
|
89
|
+
|
|
90
|
+
### 同时修掉 0.4.1 的撒谎(详见 0.4.2,此处合并说明)
|
|
91
|
+
|
|
92
|
+
方寸没开时返回 `total: 0` 会被读成「方寸里没有卡」→ 去建重复卡。
|
|
93
|
+
现在 `connected` 与 `total` 分开,文案明写「不是"没有卡"」。
|
|
94
|
+
|
|
95
|
+
### health 增加 `link` 与三件套分工
|
|
96
|
+
|
|
97
|
+
- 插件只报「方寸」这一环(装没装 / 跑没跑),**不报 DSH**(插件就活在 DSH 里,报它没意义)
|
|
98
|
+
- 「装了没跑」的提示必须写**「不用重启 DSH」**(方寸打开就自动通)
|
|
99
|
+
|
|
100
|
+
### 测试
|
|
101
|
+
|
|
102
|
+
`tool ⑦/⑦b/⑦c` 三条钉住:缺节要说「真没写」、三处并行、**有一处通就算连上**、
|
|
103
|
+
缺 `project` 不许默认成"全部项目"。
|
|
104
|
+
|
|
105
|
+
**107/107 全绿。**
|
|
106
|
+
|
|
107
|
+
## 0.4.2(2026-11-17)
|
|
108
|
+
|
|
109
|
+
用户拍板:「方寸插件本身还可以做什么,好让 DSH 和方寸的组合更顺一点。
|
|
110
|
+
后续方寸内部界面也要调整,加强插件支持(**缺插件提示下插件,缺DSH提示下DSH,
|
|
111
|
+
插件本身也能提醒下方寸**)。」
|
|
112
|
+
|
|
113
|
+
### 修一个 0.4.1 我自己挖的坑:方寸没开时**撒了谎**
|
|
114
|
+
|
|
115
|
+
0.4.1 为了让「方寸没开是常态」不报错,`fangcun_tasks` 在管道失败时返回 `total: 0`。
|
|
116
|
+
**模型会读成「方寸里没有卡」—— 那是撒谎**,后果是它去建重复的卡。
|
|
117
|
+
|
|
118
|
+
现在 `connected` 与 `total` 分开:
|
|
119
|
+
|
|
120
|
+
| 情形 | connected | total | hint |
|
|
121
|
+
|---|---|---|---|
|
|
122
|
+
| 方寸跑着、真没卡 | `true` | `0` | 空 |
|
|
123
|
+
| 方寸没开 | `false` | `0` | 「方寸桌面版没有在运行,请打开后重试;没装就去下载」 |
|
|
124
|
+
|
|
125
|
+
渲染文案也改了:连不上时输出「**方寸未连接 —— 查不到待办(不是"没有卡")**」,
|
|
126
|
+
而不是「0 张未结」。写工具的失败也带上同一句 `hint`。
|
|
127
|
+
|
|
128
|
+
### 新增 `health.link`:三件套里「插件看得见的那两环」
|
|
129
|
+
|
|
130
|
+
```json
|
|
131
|
+
"link": {
|
|
132
|
+
"installed": true, // 方寸装没装(只读文件痕迹)
|
|
133
|
+
"running": false, // 方寸跑没跑(命名管道在不在)
|
|
134
|
+
"ready": false,
|
|
135
|
+
"pipePath": "\\\\.\\pipe\\tegula-mcp",
|
|
136
|
+
"hint": "方寸装了但没在运行 —— 打开方寸即可(打开后自动通,不用重启 DSH)"
|
|
137
|
+
}
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
**分工不许混说**:插件只报「方寸」这一环。「DSH 装没装」在插件里没有意义(插件就活在 DSH 进程里),
|
|
141
|
+
由方寸侧 `services/dshPlugin.ts` 报。两边各报自己看得见的,合起来才是完整三件套
|
|
142
|
+
(`test/link.test.mjs` ⑤ 钉着:插件侧不许有 `dsh` 状态字段)。
|
|
143
|
+
|
|
144
|
+
### 规则段:缺什么说什么,且给下一步
|
|
145
|
+
|
|
146
|
+
新增三条,对应三件套各自的缺口:
|
|
147
|
+
- 方寸没装 → 给下载页
|
|
148
|
+
- 方寸装了没跑 → 让用户打开方寸,**明确说不用重启 DSH**
|
|
149
|
+
- 方寸说「没装方寸插件」→ 那是方寸侧报的,在方寸里装
|
|
150
|
+
|
|
151
|
+
### 测试
|
|
152
|
+
|
|
153
|
+
`test/link.test.mjs` 新增 5 条(没装 / 装了没跑 / 都通 / 环境变量坏掉 / 分工不混说);
|
|
154
|
+
`tool.test.mjs` ④ 改写成「连不上必须 `connected:false` 且文案说"不是没有卡"」,
|
|
155
|
+
并新增 ④b 钉住「连上但没卡」与「没连上」必须能区分。
|
|
156
|
+
|
|
157
|
+
**104/104 全绿。**
|
|
158
|
+
|
|
159
|
+
## 0.4.1(2026-11-17)
|
|
160
|
+
|
|
161
|
+
这一版四件事:**取消 DSH 版本上界**、**宿主兼容性只提醒不退出**、**修 0.4.0 的自证失明**、
|
|
162
|
+
**防腐层边界上测试 + 验收闸加锁**。
|
|
163
|
+
|
|
164
|
+
### 取消 `engines.dsh` 上界(用户拍板:"能不能用随缘,插件永远只保适配版本")
|
|
165
|
+
|
|
166
|
+
原来是 `>=0.2.1-rc.2 <0.3.0`。核实宿主代码(`@deepseek-ai/dsh-app-boot` 的 `loadProfileDirectory`):
|
|
167
|
+
|
|
168
|
+
```js
|
|
169
|
+
const issue = evaluatePluginCompatibility(bundleManifest, exemptions);
|
|
170
|
+
if (issue !== void 0 && !issue.exempted) throw new Error(pluginCompatibilityWarning(issue));
|
|
171
|
+
// ...
|
|
172
|
+
} catch (error) { skippedBundles.push({ packageName, reason: String(error) }); }
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
**不满足 `engines` 会被 throw,然后 catch 成 `skippedBundles` —— 整个插件静默消失**:
|
|
176
|
+
挂件、记账、工具全没了,界面上只显示"没装",而且没有原因。
|
|
177
|
+
DSH 是 developer preview、升级频繁,于是 `<0.3.0` 就是一个定时炸弹。
|
|
178
|
+
|
|
179
|
+
现在只有下限 `>=0.2.1-rc.2`:**宁可能用 + 提醒,也不要静默退出**。
|
|
180
|
+
|
|
181
|
+
### 宿主兼容性自检(`lib/compat.js`)—— 只提醒,不退出
|
|
182
|
+
|
|
183
|
+
六个关键宿主能力各给三态:`ok` / `degraded`(存在但形状不像预期)/ `missing`。
|
|
184
|
+
结论进 `health.compat`:
|
|
185
|
+
|
|
186
|
+
```json
|
|
187
|
+
"compat": {
|
|
188
|
+
"checkedAt": "2026-11-17T...",
|
|
189
|
+
"capabilities": { "webServer": "ok", "systemPrompt": "ok", "tools": "ok", ... },
|
|
190
|
+
"warnings": [],
|
|
191
|
+
"summary": "全部 6 项宿主能力正常"
|
|
192
|
+
}
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
判据是**运行时真实形状**,不是版本号比较 —— 版本号相等不代表 API 没变(preview 期尤其)。
|
|
196
|
+
探测**绝不抛**:出错记成缺口并继续,插件照常干它能干的。
|
|
197
|
+
|
|
198
|
+
⚠ 一个真 bug(测试 ⑤ 抓出来的):最初只判 `typeof root.on === 'function'`,于是"宿主有 `on` 但一订阅就抛"
|
|
199
|
+
被当成健康 —— 记账与自证实际全哑却报绿。现在**真调一次**再判。
|
|
200
|
+
|
|
201
|
+
### 修 0.4.0 引入的自证失明(我自己挖的坑)
|
|
202
|
+
|
|
203
|
+
`proof.js` / `cards.js` 只认 `mcp__fangcun__*`(DSH 给 MCP 工具生成的名字)。
|
|
204
|
+
0.4.0 新增的 `fangcun_tasks` / `fangcun_card` / `fangcun_write` **不带这个前缀**,于是:
|
|
205
|
+
|
|
206
|
+
- `proof.rows` 不涨、`readBeforeEdit` / `wroteBack` 不涨
|
|
207
|
+
- `cards.lastCardId` 永远空 → 挂件「本次在办」消失、`usage` 的 note 不带 `card=`
|
|
208
|
+
|
|
209
|
+
等于把"接线坏了"的病(卡 140864fa)搬成"口径没跟上"。现在**两个前缀都认**,
|
|
210
|
+
并区分只读/写入:`fangcun_tasks` / `fangcun_card` 算查,`fangcun_write` 算回写
|
|
211
|
+
(只读工具算回写会把"只查不干"的病掩盖掉)。
|
|
212
|
+
|
|
213
|
+
### 验收闸加锁(两道)
|
|
214
|
+
|
|
215
|
+
用户/梅林的硬规则:"DSH 也得过闸……智能层不豁免治理层。"
|
|
216
|
+
|
|
217
|
+
- **第二道(原本就有,在方寸本体)**:`desktop/src/main/mcp/tools.ts` 的 `move_status` 对
|
|
218
|
+
`完成` / `驳回` 直接 `isError` 拒绝。**这道锁位置正确** —— 在方寸核心层,不在插件、不在 DSH。
|
|
219
|
+
- **第一道(新增,在插件)**:`SIGNOFF_STATUSES`。理由不是"不信任方寸",而是:
|
|
220
|
+
不该先撞墙才知道;且不许赌锁的位置(方寸哪天重构挪走了硬拒,插件这道还在)。
|
|
221
|
+
`move` 与 `update` 两条路径都过闸,不留后门。
|
|
222
|
+
|
|
223
|
+
### 防腐层边界上测试(`test/layering.test.mjs`)
|
|
224
|
+
|
|
225
|
+
用户拍板:"方寸↔DSH 之间收窄成一个适配模块,翻译只发生在这一处。"
|
|
226
|
+
核实结果:**已经基本是这样了**——所有 `root.get/inject/on/effect`、`webServer.register`、
|
|
227
|
+
`systemPrompt`、`tools.register` 全部集中在 `lib/index.js` 一个文件。
|
|
228
|
+
|
|
229
|
+
所以这版不重写,只**把它变成 CI 能守的规则**:除 `index.js` / `compat.js` 外,
|
|
230
|
+
任何 lib 文件出现 DSH 概念就红。做了反例验证(故意在 `cards.js` 塞 `root.get('webServer')`
|
|
231
|
+
→ 2 例失败),确认检测器真的有效,不是空跑。
|
|
232
|
+
|
|
233
|
+
### 规则段改写(`lib/prompt.js`)
|
|
234
|
+
|
|
235
|
+
原来只写 `mcp__fangcun__*` —— MCP 掉线时那些名字**在工具表里不存在**,这段变成死指令。
|
|
236
|
+
现在两条路径都写,并明确"两个都有时优先插件工具"。另加一条纪律:
|
|
237
|
+
**只到「待验收」,完成/驳回是用户签字,方寸会拒绝**。
|
|
238
|
+
|
|
239
|
+
## 0.4.0(2026-11-17)
|
|
240
|
+
|
|
241
|
+
**插件第一次真的让模型能调方寸做事。** 0.3.0 的全部对外出口是 4 条 HTTP 路由 ——
|
|
242
|
+
那是给浏览器/挂件看的,模型一个工具都没有。这一版补上那一层。
|
|
243
|
+
|
|
244
|
+
### 模型工具(REV-014 ②)
|
|
245
|
+
|
|
246
|
+
三个工具,注册在 `ctx.tools`(`lib/tool.js`):
|
|
247
|
+
|
|
248
|
+
| 工具 | 做什么 | 转发的方寸 MCP |
|
|
249
|
+
|---|---|---|
|
|
250
|
+
| `fangcun_tasks` | 列卡(只读) | `list_tasks` |
|
|
251
|
+
| `fangcun_card` | 读一张卡的正文(只读) | `get_task` |
|
|
252
|
+
| `fangcun_write` | `action: create / update / move` | `create_task` / `update_task` / `move_status` |
|
|
253
|
+
|
|
254
|
+
四条边界钉在测试里(`test/tool.test.mjs`,8 条):
|
|
255
|
+
|
|
256
|
+
- **只白名单转发**:`action` 不在三个里就抛,绝不转发任意工具名(那是提权)。
|
|
257
|
+
- **参数不全就抛,绝不猜**:`create` 没 `title`、`update`/`move` 没 `id`、`move` 没 `status` 都直接报错。
|
|
258
|
+
- **输出有界**:列表封顶 30 条、单卡正文封顶 4000 字,截断必须说出来
|
|
259
|
+
(用户原话:"每次一共就那么多上下文空间,占满对话就死了")。
|
|
260
|
+
- **不假装成功**:方寸没开时读工具回空列表、写工具回 `ok:false` + 原因,不抛堆栈也不谎报已写入。
|
|
261
|
+
|
|
262
|
+
### 为什么不叫 `mcp__fangcun__*`
|
|
263
|
+
|
|
264
|
+
宿主的方寸 MCP 客户端断开时(卡 `dsh-里的-fangcun-mcp-客-140864fa`),`mcp__fangcun__*` 全部消失。
|
|
265
|
+
这三个工具走**插件自己的命名管道**,不依赖那个 MCP 客户端 —— 所以 MCP 断开时它们仍在。
|
|
266
|
+
|
|
267
|
+
### 零依赖不变
|
|
268
|
+
|
|
269
|
+
不 import `@deepseek-ai/dsh-tools`(`defineTool` 只是类型标注 + 校验,返回的就是原对象),
|
|
270
|
+
形状按 `dsh-tools/src/contracts.ts` 的 `ToolDefinition` 对齐。
|
|
271
|
+
|
|
272
|
+
### health 新增 `tools`
|
|
273
|
+
|
|
274
|
+
`health.tools = { registered, names, error }`。拿不到 `tools` 服务(老宿主)时 `registered:false`
|
|
275
|
+
且 `error` 写明原因 —— 与 `prompt` 同一个口径:**不假装注册上**。
|
|
276
|
+
|
|
277
|
+
### 两处顺手修正
|
|
278
|
+
|
|
279
|
+
- `shapeCard` 的每个分支都填满 `output.schema` 的 required 字段:少一个字段,
|
|
280
|
+
宿主在 output 校验那步会拒掉整次调用,那会让"没连上方寸"以"工具坏了"的样子出现。
|
|
281
|
+
- `fangcun_tasks` / `fangcun_card` 的管道异常就地兜住:方寸没开是常态,不是异常。
|
|
282
|
+
|
|
3
283
|
## 0.3.0(2026-11-07)
|
|
4
284
|
|
|
5
285
|
这一版把契约 ⑥ 剩下的三件事做完:**规则段**、**一行现状**、**自证 sidecar**;
|