dsh-as-aistudio 0.2.13 → 0.3.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 +31 -0
- package/README.md +5 -5
- package/package.json +17 -12
- package/src/client.js +3362 -225
- package/src/components.js +1 -1
- package/src/index.js +26 -1
- package/src/shell.js +30 -5
- package/src/vendor/host/_platform.js +132 -0
- package/src/vendor/host/dsh-delete-turn.js +661 -0
- package/src/vendor/host/dsh-delete-turn.logic.js +655 -0
- package/src/vendor/host/dsh-edit-turn.js +2813 -0
- package/src/vendor/host/dsh-edit-turn.patch.js +285 -0
- package/src/vendor/host/dsh-markdown-bubble.js +37 -0
- package/src/vendor/host/dsh-rerun-turn.js +2784 -0
- package/src/vendor/versions.json +6 -0
- package/docs/INTEROP.md +0 -230
- package/src/studio.js +0 -553
- package/src/vendor/dsh-delete-turn.js +0 -1174
- package/src/vendor/dsh-edit-turn.js +0 -2626
- package/src/vendor/dsh-markdown-bubble.js +0 -872
- package/src/vendor/dsh-rerun-turn.js +0 -1014
- package/tools/build.mjs +0 -87
- package/tools/bump.mjs +0 -82
- package/tools/head.txt +0 -13
- package/tools/tail.txt +0 -5
- package/tools/tail2.txt +0 -4
- package/tools/vendor.mjs +0 -125
- package/tools/verify-manifest.mjs +0 -77
package/docs/INTEROP.md
DELETED
|
@@ -1,230 +0,0 @@
|
|
|
1
|
-
# AI Studio 组件互操作契约 (v1)
|
|
2
|
-
|
|
3
|
-
> 本文档是四个组件插件 + 聚合插件 `dsh-as-aistudio` 之间**唯一**的跨包约定。
|
|
4
|
-
> 它是权威来源:任何组件在改动前必须对照本文件;冲突时以本文件为准。
|
|
5
|
-
> 目标:**任意子集都能装、都能跑、互不破坏**(1/2/3/4 个组件、以及叠加聚合插件的任意组合)。
|
|
6
|
-
|
|
7
|
-
## 0. 参与方
|
|
8
|
-
|
|
9
|
-
| 包名 | 角色 | 仓库 |
|
|
10
|
-
| --- | --- | --- |
|
|
11
|
-
| `dsh-delete-turn` | 组件:逐条消息删除 | https://github.com/DDDMUC/dsh-delete-turn |
|
|
12
|
-
| `dsh-edit-turn` | 组件:编辑任意用户轮次并重放 | https://github.com/DDDMUC/dsh-edit-turn |
|
|
13
|
-
| `dsh-rerun-turn` | 组件:原位重跑(infix rerun) | https://github.com/DDDMUC/dsh-rerun-turn |
|
|
14
|
-
| `dsh-markdown-bubble` | 组件:已发送消息的 Markdown 渲染 | https://github.com/DDDMUC/dsh-markdown-bubble |
|
|
15
|
-
| `dsh-as-aistudio` | 聚合:把上面四个组合成 AI Studio 式体验 | https://github.com/DDDMUC/dsh-as-aistudio |
|
|
16
|
-
|
|
17
|
-
运行环境:DSH `>=0.1.6-alpha.2`(本机实测 `0.2.0-rc.1`);profile `web`、`desktop`、`headless` 共用同一套客户端插件机制。
|
|
18
|
-
|
|
19
|
-
## 1. 铁律(违反即为 Bug)
|
|
20
|
-
|
|
21
|
-
**I1 —— 零硬依赖。** 组件之间**不得**互相 `import`/`require`,不得把兄弟包写进 `dependencies`/`peerDependencies`/`devDependencies`。任何兄弟协作必须是「运行时探测 + 缺席时优雅退场」。
|
|
22
|
-
|
|
23
|
-
**I2 —— 唯一身份。** 每个插件在 `ctx.slots.register` 时使用自己的 `id`;同一 slot 上的 `order` 值必须全平台唯一(见 §2 分配表)。相同 `order` 的先后顺序未定义。
|
|
24
|
-
|
|
25
|
-
**I3 —— 只动自己的 DOM。** 向消息行注入节点时:
|
|
26
|
-
- 每个自建节点必须带 `data-<ns>-*` 命名空间属性(`dshdt`/`dshet`/`dsrr`);
|
|
27
|
-
- **绝不**删除、改写、移动不是自己创建的节点;
|
|
28
|
-
- 绝不假设自己的节点是父节点的唯一子节点或最后一个子节点;
|
|
29
|
-
- 注入必须幂等:重复渲染找到已有节点就复用,不要再造一个。
|
|
30
|
-
|
|
31
|
-
**I4 —— 隐藏归因(本次重点修复项)。** 行/气泡的隐藏用**归属属性**表达:
|
|
32
|
-
`data-dshdt-hidden` (delete-turn)、`data-dshet-hidden` (edit-turn)、`data-dsrr-hidden` (rerun-turn)。
|
|
33
|
-
- 只有**设置了自己那个属性**的插件,才有资格清掉 `row.style.display`;
|
|
34
|
-
- 恢复可见前,必须确认**其他**归属属性都不存在(见 §4 的 `foreignHide` 辅助函数);
|
|
35
|
-
- 绝不因为「我看不到 `display:none` 的来源」就把它清掉。
|
|
36
|
-
|
|
37
|
-
**I5 —— 缺席的兄弟不是错误。** 探测兄弟插件失败(404 / fetch 抛错 / 超时)必须走「缺席」分支并且**不报错、不弹提示**。禁止用 `console.error` 刷缺席态。
|
|
38
|
-
|
|
39
|
-
**I6 —— web / desktop 同构。** 客户端半侧不得依赖 web profile 专有的全局量(如 `window.__DSH_BOOT__`、`location.port`、特定 DOM 层级)。宿主路由一律走**相对路径**,不经 `location.origin` 拼接。loopback 校验留在宿主半侧。桌面端(Electron 壳)与浏览器共用同一份 client bundle,任何 `navigator.userAgent` 分支都必须有另一种实现的等价路径。
|
|
40
|
-
|
|
41
|
-
**I7 —— 功能冻结。** 本轮**只修 Bug / 加固兼容性**。不得删除、改名、或改变任何已有交互的语义(按钮文案、点击序列、确认步骤、路由契约、日志文案)。可以新增测试、新增防御分支、修正明显错误的行为。
|
|
42
|
-
|
|
43
|
-
**I8 —— 自己那半侧自洽。** 每个包的 `npm test` 必须全绿;`npm run verify:contract` / `verify:client`(若存在)必须全绿。新增测试请覆盖你修的那个 Bug。
|
|
44
|
-
|
|
45
|
-
**I9 —— 版本与文档同步。** 每个包修完后:`package.json` version +1(patch 位),`dsh.engines.dsh` 保持与宿主兼容,README 增补一行「修复」条目(中英各一条)。
|
|
46
|
-
|
|
47
|
-
## 2. Slot order 分配表(权威)
|
|
48
|
-
|
|
49
|
-
`conversation.chat.assistant-actions`(助手回复下方的操作条):
|
|
50
|
-
|
|
51
|
-
| order | 插件 | id |
|
|
52
|
-
| --- | --- | --- |
|
|
53
|
-
| 5 | dsh-edit-turn | `edit-turn-reply` |
|
|
54
|
-
| 6 | dsh-rerun-turn | `rerun-turn-reply` |
|
|
55
|
-
| 40 | dsh-delete-turn | `delete-turn` |
|
|
56
|
-
|
|
57
|
-
→ **保持现状**,已唯一,不要改动。
|
|
58
|
-
|
|
59
|
-
`conversation.input.overlay`(输入框上方的浮层槽,零高度):
|
|
60
|
-
|
|
61
|
-
| order | 插件 | id |
|
|
62
|
-
| --- | --- | --- |
|
|
63
|
-
| 8 | dsh-delete-turn | `delete-turn` |
|
|
64
|
-
| 9 | dsh-edit-turn | `edit-turn` |
|
|
65
|
-
| 10 | dsh-rerun-turn | `rerun-turn` |
|
|
66
|
-
|
|
67
|
-
→ **dsh-rerun-turn 需从 8 改为 10**(当前与 delete-turn 撞号)。`dsh-as-aistudio` 自己的浮层用 order `12`,id `as-aistudio-overlay`。
|
|
68
|
-
|
|
69
|
-
## 3. 兄弟探测协议(edit-turn ↔ rerun-turn)
|
|
70
|
-
|
|
71
|
-
`dsh-edit-turn` 的编辑器里有一个「重跑」按钮,它的拥有者是 `dsh-rerun-turn`。探测方式(现状,**保留**):
|
|
72
|
-
|
|
73
|
-
```js
|
|
74
|
-
const response = await fetch(`${RERUN_PREFIX}/state`, { headers: { accept: 'application/json' } })
|
|
75
|
-
const present = response.status === 400 || response.status === 405
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
补充硬化要求:
|
|
79
|
-
- 探测结果为 `unknown` 时**不要**渲染兄弟按钮(避免闪一下又消失);
|
|
80
|
-
- 任何 `fetch` 异常都归入 `absent`,且不得 `console.error`;
|
|
81
|
-
- 探测必须在每次编辑器打开时刷新,缓存上限 = 一次会话内一次(现状即可)。
|
|
82
|
-
|
|
83
|
-
## 4. 隐藏归因辅助函数(每个组件各自拷一份,约 10 行,**不共享包**)
|
|
84
|
-
|
|
85
|
-
```js
|
|
86
|
-
// 三个组件的隐藏归属属性。别的插件设的隐藏,我不能清掉。
|
|
87
|
-
const HIDE_OWNERS = [
|
|
88
|
-
['dshdt', 'data-dshdt-hidden', 'dshdtHidden'],
|
|
89
|
-
['dshet', 'data-dshet-hidden', 'dshetHidden'],
|
|
90
|
-
['dsrr', 'data-dsrr-hidden', 'dsrrHidden'],
|
|
91
|
-
]
|
|
92
|
-
/** 除 `own` 之外,还有别的插件声明了隐藏吗? */
|
|
93
|
-
function foreignHideOn(row, own) {
|
|
94
|
-
for (const [key, attr, prop] of HIDE_OWNERS) {
|
|
95
|
-
if (key === own) continue
|
|
96
|
-
if (row.dataset?.[prop] === '1') return true
|
|
97
|
-
if (typeof row.hasAttribute === 'function' && row.hasAttribute(attr)) return true
|
|
98
|
-
}
|
|
99
|
-
return false
|
|
100
|
-
}
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
用法:**任何把 `row.style.display` 置回 `''` 的地方**,先问 `foreignHideOn(row, 'dsrr')`;为真时保持 `display:none`(即别人的隐藏继续生效)。
|
|
104
|
-
|
|
105
|
-
## 5. 消息行操作条的注入契约
|
|
106
|
-
|
|
107
|
-
三个组件都会往「用户消息行 / 助手回复行」的操作条里塞按钮。
|
|
108
|
-
|
|
109
|
-
- 锚点:**行内已有的操作条**;找不到就退到行尾,不要凭空造一条 bar;
|
|
110
|
-
- 插入位置右对齐、不挤掉宿主自己的按钮;
|
|
111
|
-
- 每次 MutationObserver 回调都要**先找自己的按钮**(按 `data-<ns>-*`),找到就只做状态同步(`disabled`/文案),不要 remove+re-insert(会丢焦点、会闪);
|
|
112
|
-
- `display:none` 的按钮必须能被第二次扫描跳过,不要堆积幽灵节点。
|
|
113
|
-
|
|
114
|
-
## 6. Web / Desktop 契约
|
|
115
|
-
|
|
116
|
-
- 宿主路由:相对路径 `/dsh-<name>/*` 或 `/api/dsh-<name>/*`,客户端一律 `fetch(prefix + ...)` 相对调用;
|
|
117
|
-
- 不得使用 `window.open`、`showDirectoryPicker`、剪贴板特权 API;
|
|
118
|
-
- 不得依赖 `<dialog>` 的 top-layer、`popover`、`CSS anchor positioning` 等仅在特定 Chromium 版本可用的特性(桌面端壳的 Chromium 版本可能更旧);
|
|
119
|
-
- 字体/字号跟随平台设置(历史 Bug:改写气泡不跟随平台字号);
|
|
120
|
-
- 键盘事件只监听 `keydown`,并且不 `preventDefault` 平台快捷键(`Cmd/Ctrl+K` 等)。
|
|
121
|
-
|
|
122
|
-
## 7. 交付物(每个组件)
|
|
123
|
-
|
|
124
|
-
1. 代码修复(只在自己的仓库里);
|
|
125
|
-
2. 新增/更新测试,覆盖修复点;
|
|
126
|
-
3. `README.md` 增补一行修复说明(中文 1 行 + English 1 行);
|
|
127
|
-
4. `package.json` version patch +1;
|
|
128
|
-
5. 一份 `FIXES.md`(或等价报告)写在会话工作区:`/Users/337mu/Documents/Default Project/_aistudio-reports/<包名>.md`,内容:**症状 / 证据(file:line)/ 修复 / 验证命令与结果 / 未解决项**。
|
|
129
|
-
|
|
130
|
-
## 8. 验收(聚合方会跑)
|
|
131
|
-
|
|
132
|
-
1. 每个包:`npm test`(+ `verify:*`)全绿;
|
|
133
|
-
2. 组合矩阵:把 4 个 client bundle 以 2^4 种组合装载进同一个 DOM stub,断言:无异常、slot 注册 id 唯一、无重复按钮、隐藏归因正确;
|
|
134
|
-
3. 真机:web profile 装载 `dsh-as-aistudio` + 任意子集,页面加载无 `error` 级别日志。
|
|
135
|
-
## 9. 热重载纪律(HMR)—— 2026-10-01「点不动」事故后新增
|
|
136
|
-
|
|
137
|
-
**改任何组件的 `client.js` 之后,必须重启宿主进程 + 让页面硬刷新,不要把 HMR 混合态交付给用户。**
|
|
138
|
-
|
|
139
|
-
事故形态(dsh-rerun-turn,2026-10-01 13:5x):用户点回答行 / 用户行的 ↻ 没有任何反应,宿主 `/debug` 也收不到 `apply` 请求;直取 `/plugins/<id>/client.js` 返回空。
|
|
140
|
-
根因不是代码缺陷,而是**混合态**:client bundle 被 HMR 单独重载(0.1.21 / 0.1.22 的改动触发了多次),而宿主进程没有重启 —— 页面里是「新 bundle 实例 + 旧实例已 dispose 的控制器 / 旧按钮上已死的监听」。
|
|
141
|
-
恢复动作:**重启宿主 + 硬刷新页面**(重启后 host 0.1.22、bundle 200 非空、两处 ↻ 点击均正常触发 `apply`)。
|
|
142
|
-
|
|
143
|
-
配套约定:
|
|
144
|
-
|
|
145
|
-
- 交付前检查三件事:宿主版本 == bundle 版本;`/plugins/<entry>/client.js` 返回 200 且非空;行上的动作按钮真的点得动。
|
|
146
|
-
- 组件在 `dispose` 之后会主动早退(不唤醒已退休的控制器),所以混合态表现为**静默无响应**而不是报错 —— 这是刻意的设计,不是 Bug;遇到它先重启宿主再判断。
|
|
147
|
-
- 跨端(host / client)不兼容改动必须 bump 三处版本号(`package.json` + 宿主半侧 + 浏览器半侧)并跑该仓库的全部门禁。
|
|
148
|
-
- 本契约的 §2(slot order 分配)与 §4(隐藏归因)属于三个注入型组件的**共享面**:改其中一侧,必须同时检查另外两侧不受影响;组合矩阵(`dsh-as-aistudio/test/combination.test.js`)是这条规则的回归网。
|
|
149
|
-
## 10. 跨插件运行时契约:dsh-edit-turn → dsh-rerun-turn
|
|
150
|
-
|
|
151
|
-
这是**唯一一条两个组件之间真实存在的运行时依赖**,也是唯一一条不走 DOM、只走回环 HTTP 的依赖。写在契约里,
|
|
152
|
-
是因为它跨越两个仓库、两个维护者,任何一侧单独改动都不会让另一侧的测试变红。
|
|
153
|
-
|
|
154
|
-
流程(`dsh-edit-turn` 0.2.12+ 的提示词编辑器「重跑」按钮):
|
|
155
|
-
|
|
156
|
-
1. 按钮**只在探测到 rerun-turn 挂载时**出现:不带 `sessionId` 请求 `GET /dsh-rerun-turn/state`,
|
|
157
|
-
按 **400 / 405 = 装着、404 = 没装** 判定;
|
|
158
|
-
2. 点击后先 `POST /dsh-edit-turn/apply` 就地保存改写(不调模型),
|
|
159
|
-
3. 紧接着链式 `POST /dsh-rerun-turn/apply { sessionId, seq }`,其中 `seq` 取自 rerun-turn `/state` 的
|
|
160
|
-
`replies[]`(匹配被编辑那一轮的 `turn`、取 `seq` 最大者);
|
|
161
|
-
4. rerun-turn 侧的 `planRerun` 沿 `source.kind = plugin:dsh-edit-turn` 的就地替换链读**活节点**,
|
|
162
|
-
于是重跑用改后的措辞生成。
|
|
163
|
-
|
|
164
|
-
双向边界:
|
|
165
|
-
|
|
166
|
-
- edit-turn **只**走 rerun-turn 的公开回环路由,不碰对方的 client 半侧或 DOM;
|
|
167
|
-
- 反过来,**纯 dsh-edit-turn(没装 rerun-turn)没有任何重跑入口** —— 编辑器只有「取消 / 保存」。
|
|
168
|
-
|
|
169
|
-
不许改的形状(回归测试:`dsh-rerun-turn/test/contract.test.js`,16 例,已做变异验证):
|
|
170
|
-
|
|
171
|
-
| 形状 | 约束 |
|
|
172
|
-
| --- | --- |
|
|
173
|
-
| 挂载探测 | 不带 `sessionId` 的 `GET /state` 必须仍答 400;改成 404 按钮会静默消失 |
|
|
174
|
-
| 目标列表 | `/state` 持续返回完整的 `replies[{seq, turn}]` |
|
|
175
|
-
| 调用形状 | `POST /apply` 只要求 `sessionId` + (`seq` \| `messageId`),**不得新增必填参数** |
|
|
176
|
-
| 载荷 | edit-turn 不传文本;未知字段必须被忽略而不是 400 |
|
|
177
|
-
| 错误码 | `not-rerunnable` / `already-retired` / `busy` / `rerunning` / `stale` / `session-not-found` / `session-not-active` / `invalid` 机读且稳定(edit-turn 原样提示给用户) |
|
|
178
|
-
| 链式解析 | `planRerun` 继续跟随就地替换链取活文本 |
|
|
179
|
-
|
|
180
|
-
**给改这两个包的 agent**:动路由、`planRerun` 或错误码之前,先在 `dsh-rerun-turn` 跑
|
|
181
|
-
`node --test test/contract.test.js`;把探测状态的 400 改成 404 会让 2 例转红,给 `/apply` 加一个必填
|
|
182
|
-
`confirmToken` 会让 5 例转红 —— 破坏契约会在本地就暴露,而不是等用户发现按钮点不动。
|
|
183
|
-
|
|
184
|
-
## 11. 自包含架构(2026-10-02 重写,2026-10-04 改为四条目行)
|
|
185
|
-
|
|
186
|
-
用户要求「插件列表里只有 AI Studio 一行」。平台的清单服务(同一份 dsh_plugin_packages 也喂给模型)
|
|
187
|
-
收的是**包身份集合**:先按 !entry.options.group && !entry.disabled && entry.fiber?.state === 2 取活跃行
|
|
188
|
-
(@deepseek-ai/dsh-plugin-package-inventory-deepseek/lib/index.js:100),每条行经 barePackageName() 解析
|
|
189
|
-
回它所属的包,再按 name + version 去重。于是有两条硬约束:
|
|
190
|
-
|
|
191
|
-
1. **行名不能是组件自己的包名**,否则那个包成为新的身份,列表立刻多一行;
|
|
192
|
-
2. **行名必须是本包的子路径**:barePackageName('dsh-as-aistudio/edit') === 'dsh-as-aistudio',
|
|
193
|
-
解析回本包、与自己的行去重 —— 四条组件行因此不占列表行(@linxin666/dsh-web-all 同款:
|
|
194
|
-
它 19 条声明只占 1 行)。
|
|
195
|
-
|
|
196
|
-
而详情页的「包含的组件」读的是另一件事:bundle 的 patch 里 insert 的每一行
|
|
197
|
-
(@deepseek-ai/dsh-plugin-manager/lib/index.js:1864 declaredRows)。要让四个组件在那里出现,
|
|
198
|
-
它们就必须真的是本包 patch 里的行 —— 这正是 2026-10-04 的改动:宿主半侧的运行时 ctx.plugin
|
|
199
|
-
换成四条补丁行,行名是子路径、真正的包名写在 config.plugin 里,由 src/shell.js 挂载。
|
|
200
|
-
|
|
201
|
-
| 部件 | 位置 | 说明 |
|
|
202
|
-
| --- | --- | --- |
|
|
203
|
-
| patch | cordis.patch.yml | 插 5 行:本包自己(裸包名,带 ./client)加四条 dsh-as-aistudio/<后缀> |
|
|
204
|
-
| 组件身份 | package.json dependencies | 普通依赖,不是 profile bundle |
|
|
205
|
-
| 宿主半侧 | src/shell.js | 组件行读 config.plugin,await import 后 ctx.plugin(等价于组件自己的行) |
|
|
206
|
-
| 浏览器半侧 | src/client.js | 单一大 bundle(生成物),只由本包那一行下发 |
|
|
207
|
-
| 内联来源 | src/vendor/*.js | tools/vendor.mjs 从组件源码逐字剥离 factory |
|
|
208
|
-
| 缝合器 | tools/build.mjs | studio 加四个 factory 合成一个 bundle |
|
|
209
|
-
| 状态 | src/index.js | /api/dsh-as-aistudio/status:hostMounted 从 Loader 行 fiber 状态读 |
|
|
210
|
-
|
|
211
|
-
三条设计红线:
|
|
212
|
-
|
|
213
|
-
1. 宿主半侧不内联。宿主代码对列表不可见,复制它只会多出一份要维护的东西;组件行导入真正的包,
|
|
214
|
-
组件的路由、回滚、重放逻辑仍是唯一正本。
|
|
215
|
-
2. 宿主半侧也不许自己挂。四个组件已由四条行挂载,host 再 ctx.plugin 一次就是同进程挂两遍,
|
|
216
|
-
路由必冲突;host 只回答状态。
|
|
217
|
-
3. 浏览器半侧必须内联。bundle 是按 Loader 行下发的(/plugins/<行id>/client.js),且只有精确包说明符
|
|
218
|
-
会被客户端模块扫描器收进 boot graph —— 四条子路径行被跳过,组件也不会各自多出一份浏览器源。
|
|
219
|
-
|
|
220
|
-
状态与界面:hostMounted 只在行 fiber 的 state === 2 时为真(关掉的行、缺包、起失败各有自己的 reason);
|
|
221
|
-
浏览器半侧挂载前先读一次这道状态,只画 hostMounted 为真的组件,宿主答不上来时按「未知」全挂。
|
|
222
|
-
|
|
223
|
-
防漂移:副本由工具生成、带 sha256 戳,node tools/vendor.mjs --check / node tools/build.mjs --check
|
|
224
|
-
只读校验,测试在副本与组件源不一致时失败。手工编辑 src/vendor/* 或 src/client.js 是禁止的。
|
|
225
|
-
|
|
226
|
-
实测(2026-10-02 旧行结构,隔离实例只装本包 tarball):composed 184 行里组件行 0;
|
|
227
|
-
GET /dsh-rerun-turn/state 返回 400(edit-turn 的挂载探测契约未破);boot graph 66 条里组件条目 0;
|
|
228
|
-
served bundle 200 且含四个 factory。换成四条行之后,同一套门禁要补一条:四条行 fiber 必须 active,
|
|
229
|
-
/api/dsh-as-aistudio/status 才会给出 hostMounted 4/4。
|
|
230
|
-
|