dsh-wecom-bot 0.5.0 → 0.5.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.md +41 -22
- package/dist/client.js +486 -281
- package/dist/host/bridge/commands.js +62 -17
- package/dist/host/bridge/commands.js.map +1 -1
- package/dist/host/bridge/directory.js +6 -8
- package/dist/host/bridge/directory.js.map +1 -1
- package/dist/host/bridge/index.js +113 -51
- package/dist/host/bridge/index.js.map +1 -1
- package/dist/host/bridge/interactions.js +61 -25
- package/dist/host/bridge/interactions.js.map +1 -1
- package/dist/host/bridge/notices.js +70 -3
- package/dist/host/bridge/notices.js.map +1 -1
- package/dist/host/bridge/outbox.js +11 -0
- package/dist/host/bridge/outbox.js.map +1 -1
- package/dist/host/bridge/policy.js +3 -4
- package/dist/host/bridge/policy.js.map +1 -1
- package/dist/host/bridge/selection.js +7 -0
- package/dist/host/bridge/selection.js.map +1 -1
- package/dist/host/catalog.js +24 -11
- package/dist/host/catalog.js.map +1 -1
- package/dist/host/groups-view.js +369 -156
- package/dist/host/groups-view.js.map +1 -1
- package/dist/host/interaction-transport.js +170 -0
- package/dist/host/interaction-transport.js.map +1 -0
- package/dist/host/journal.js +10 -3
- package/dist/host/journal.js.map +1 -1
- package/dist/host/routes.js +3 -0
- package/dist/host/routes.js.map +1 -1
- package/dist/host/routing.js +25 -12
- package/dist/host/routing.js.map +1 -1
- package/dist/host/runtime.js +81 -18
- package/dist/host/runtime.js.map +1 -1
- package/dist/host/sessions.js +33 -6
- package/dist/host/sessions.js.map +1 -1
- package/dist/host/store.js +107 -19
- package/dist/host/store.js.map +1 -1
- package/dist/host/turns.js +5 -0
- package/dist/host/turns.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -26,7 +26,7 @@ DSH 里的会话跑完一轮、需要你回答、或者需要审批工具调用
|
|
|
26
26
|
| 切到某个会话继续推进 | `/use <序号>`,或直接**引用**那条通知 |
|
|
27
27
|
| 开一个新会话 | `/new`(建在你用 `/workspaces` 选定的默认 Workspace 里) |
|
|
28
28
|
| 看当前会话的状态 | `/status`(模型、effort、preset、上下文占用、第几轮) |
|
|
29
|
-
| 放行 / 拒绝工具调用 | `/approve <验证码>` / `/deny
|
|
29
|
+
| 放行 / 拒绝工具调用 | `/approve <验证码>` / `/deny <验证码>`(默认启用,与 DSH 页面同时可处理) |
|
|
30
30
|
| 回答 DSH 的提问 | `/answer <验证码> <选项序号或文字>` |
|
|
31
31
|
| 停止正在跑的回合 | `/cancel` |
|
|
32
32
|
| 腾出上下文 / 清空记忆 | `/compact`、`/delete`(先回一条警告,再 `/delete confirm`) |
|
|
@@ -68,9 +68,11 @@ DSH 里的会话跑完一轮、需要你回答、或者需要审批工具调用
|
|
|
68
68
|
|
|
69
69
|
### 1. 安装插件
|
|
70
70
|
|
|
71
|
-
已发布到 npm:[`dsh-wecom-bot`](https://www.npmjs.com/package/dsh-wecom-bot)。在 DSH
|
|
71
|
+
已发布到 npm:[`dsh-wecom-bot`](https://www.npmjs.com/package/dsh-wecom-bot)。在 DSH 的「插件」里安装时**写上版本号**,例如 `dsh-wecom-bot@0.5.0`;本地开发时改成**这个仓库的绝对路径**(bundle 的 patch 会往 profile 里插入一条 `wecom-bot` 条目)。
|
|
72
72
|
|
|
73
|
-
|
|
73
|
+
> **只写包名会装成旧版本。** pnpm 11 起默认 `minimumReleaseAge: 1440`,只解析**发布满 24 小时**的版本([缓解供应链攻击](https://pnpm.io/zh/supply-chain-security));`pnpm add dsh-wecom-bot` 和 `dsh-wecom-bot@latest` 因此会静默选中「一天以前的最新版本」,而不是刚发布的那个。0.5.0 刚发布时这样装会得到 0.2.1 —— 一个根本不读 `settings.json` 的旧版本,装完机器人等于没有任何管理员和分组。写精确版本(`@0.5.0`)就能正常装:pnpm 会把这一条记进 profile 的 `pnpm-workspace.yaml`(`minimumReleaseAgeExclude`),这是官方允许的唯一放行方式。
|
|
74
|
+
|
|
75
|
+
安装完即时生效,不需要重启(bundle 会被直接应用到当前 profile)。但**改完插件代码重新构建之后必须重启 DSH**:桌面版 profile 未开启 Host 源码热重载,禁用/启用插件不会替换已缓存的 Host 模块。从本地路径安装换成 npm 包安装(或反过来)也属于同一种「模块换位置」,同样要重启一次。
|
|
74
76
|
|
|
75
77
|
### 2. 连接机器人
|
|
76
78
|
|
|
@@ -103,12 +105,13 @@ DSH 里的会话跑完一轮、需要你回答、或者需要审批工具调用
|
|
|
103
105
|
| **preset** | DSH 的 agent preset(决定这个会话能用哪些工具、带哪些提示段),只在**新建会话时**生效 |
|
|
104
106
|
|
|
105
107
|
- **授权 = 加入分组**:只有属于某个分组的成员(以及管理员)会得到回复。不在任何分组里的人发消息会收到一条固定回复「**🔒 用户未授权** · 请联系管理员把你加入分组后再试」,同时出现在插件主页的「未授权用户」卡片里,连同他最后一条消息的摘要;在那里选择分组、可选填备注并确认,就完成了授权,机器人随即给他发一条「管理员已授权,可以开始使用了」。
|
|
106
|
-
-
|
|
108
|
+
- **管理员权限与分组成员身份独立**:管理员无需入组就能在单聊里使用管理命令,**不会自动加入默认分组**。未入组且尚未选择会话时,普通消息会提示先用 `/new` 新建或 `/sessions` 查看并选择会话;也可在页面显式加入指定分组,再按该组的配置聊天。管理员名单保存在 `<DSH home>/wecom-bot/settings.json`,不在 DSH 的插件 Config 里;管理员出现在群聊里也不会自动授权那个群。
|
|
107
109
|
- **会话创建**:成员的会话为空时,收到下一条消息会在**其分组的 Workspace** 里新建一个 DSH 会话并立即提交消息;会话已归档或已删除时会自动换一个新的。想主动换一个:发 `/delete`(再 `/delete confirm`)或在插件主页点成员行尾的「归档会话」。
|
|
108
110
|
- **默认分组的 Workspace**:留空即插件自带目录 `<DSH home>/wecom-bot/workspace`(自动创建并注册到侧边栏,标题「企业微信」);也可以选一个已存在的目录。
|
|
109
|
-
-
|
|
111
|
+
- **分组决定默认模型与 effort,当前会话可以单独调整**:分组默认配置用于新建会话,以及没有单独覆盖的已有会话;留空表示跟随 DSH 默认模型。点击成员行里的模型或 effort,只调整**这个成员当前的 Session**,不会改同组其他人或分组默认值;替换或归档后新建的 Session 仍采用分组默认值。插件会恢复 DSH 的部署默认模型,不影响你在 DSH 界面新建会话。
|
|
110
112
|
- **preset 属于分组,且是一次性的创建事实**:成员的新会话会按分组的 preset 组装(这个部署没有可选的 preset 时跟随 DSH 默认)。改分组的 preset 只影响**此后新建的会话**——DSH 不允许改写已经开始过一轮的会话,想换 preset 就归档当前会话。
|
|
111
|
-
-
|
|
113
|
+
- **切回分组优先恢复旧会话**:切组会解除当前绑定、取消管理员临时选择,同时按“人员 × 分组”记住原 Session。回到之前的分组时,若它仍存在、未归档且 Workspace 一致,直接恢复原绑定及该 Session 的独立模型设置;没有可用历史时才在下一条消息创建。旧会话不迁移、删除或自动归档,备注不变;切组期间尚未提交的旧路由消息仍会被拦下,避免落进错误会话。记忆从此功能启用后开始,早先已经清空且没有绑定记录的 Session 不按标题猜测恢复。
|
|
114
|
+
- **换 Workspace 会换会话**:修改分组的 Workspace 会清空该组当前绑定及历史绑定候选;下一条消息在新目录里建会话。删组或移出成员也会清理相应的会话记忆,重新授权不会恢复之前撤销的绑定。
|
|
112
115
|
- **删除分组会取消授权**:删掉一个分组时,组内成员一并被移出(不删 DSH 里的会话),他们会重新出现在「未授权用户」里,需要时再授权一次。这是刻意的:删除分组绝不应该悄悄把成员升级到默认分组的 Workspace。
|
|
113
116
|
- 新会话在**第一次提交消息之前是"空会话"**,DSH 侧边栏会暂时不显示它,提交第一条消息后就正常出现;管理员刚用 `/new` 建出的会话可以直接用,不必等它显示出来。
|
|
114
117
|
- **机器人建的会话会自己命名**:标题是 `wecom-bot-<userid>`(单聊)或 `wecom-bot-<群聊 chatid>`,也就是这个会话属于谁;这是显式设置的标题,DSH 不会再拿第一句话去生成标题(也省掉一次模型调用)。它和会话里的内容无关,改名只影响侧边栏显示。
|
|
@@ -117,14 +120,22 @@ DSH 里的会话跑完一轮、需要你回答、或者需要审批工具调用
|
|
|
117
120
|
|
|
118
121
|
打开 **设置 → 插件 → `dsh-wecom-bot`** 的 bundle 主页。页面只有五张卡片,默认显示的尽量少,需要什么点什么;**每张卡片各存各的**,底部的「保存配置」已经去掉了:
|
|
119
122
|
|
|
120
|
-
> **什么时候会重连机器人**:只有**连接身份**变了才会 —— Bot ID、Bot Secret、WebSocket
|
|
123
|
+
> **什么时候会重连机器人**:只有**连接身份**变了才会 —— Bot ID、Bot Secret、WebSocket 地址。这三项之外的一切(管理员、通知范围、日志开关与保留天数)都写在插件自己的**一个文件**里:`<DSH home>/wecom-bot/settings.json`(`"version": "0.5"`),它同时装着设置块、分组、成员、备注和每位管理员的默认 Workspace。保存后**立即对运行中的机器人生效,不会断开正在进行的对话**;DSH 的插件 Config 里只剩 Bot ID 与 Secret 的引用名。
|
|
124
|
+
|
|
125
|
+

|
|
121
126
|
|
|
122
|
-
|
|
127
|
+
成员表格用标题行对齐各列,所有列居中。会话列只放一个状态按钮:点开先看名称与 Session ID,再决定是否跳转,不会在表格里误点离开页面:
|
|
123
128
|
|
|
124
|
-
|
|
129
|
+

|
|
130
|
+
|
|
131
|
+
点小图标打开精简详情(企微 ID、备注、可切换的所属分组等列表外信息),不会再重复列出表格已有的会话、模型与上下文:
|
|
125
132
|
|
|
126
133
|

|
|
127
134
|
|
|
135
|
+
全部分组折叠时,五个事实按固定列对齐;展开后由编辑表单接管,不再重复:
|
|
136
|
+
|
|
137
|
+

|
|
138
|
+
|
|
128
139
|
归档一个成员的会话只要一次确认;确认后下一条消息会按分组当前的配置新建会话:
|
|
129
140
|
|
|
130
141
|

|
|
@@ -137,19 +148,20 @@ DSH 里的会话跑完一轮、需要你回答、或者需要审批工具调用
|
|
|
137
148
|
- **Bot ID**
|
|
138
149
|
- **Bot Secret**:保存到 DSH 凭据库(引用名 `WECOM_BOT_SECRET`),插件 Config 只记录引用名;保存后不回显,留空表示保持不变。
|
|
139
150
|
- 改了任意一项,卡片底部才出现「保存 / 放弃」;保存成功会短暂显示「已保存。」,不会留下常驻提示。
|
|
140
|
-
2. **②
|
|
151
|
+
2. **② 用户分组**:每个分组是一张可折叠的卡片;折叠时标题行下方是**固定五列的信息网格**(成员、Workspace、模型、effort、preset,标签在上、值在下,值过长会换行而不是省略),每个分组在同一列显示同一项,便于上下对比;跟随 DSH 默认的模型与 preset 标成 `(DSH 默认)` 并写出实际生效的名字。**点击标题行才展开**成员列表,展开后信息网格收起到表单里,不再重复一遍:
|
|
141
152
|
- 行尾的「**编辑**」点下去会**变成「保存」**:名称、Workspace、模型、effort、preset 一次性组成一份草稿,点「保存」才提交(旁边有「取消」放弃)。默认分组没有删除按钮。effort 下拉只在所选模型支持思考强度时可选,preset 列表来自 DSH 的 preset registry(这个部署没挂 registry 时只有「跟随 DSH 默认」)。
|
|
142
153
|
- **添加分组**会立刻建一个默认名字的分组,并**直接打开它的完整编辑框**——不用先起名再编辑。
|
|
143
|
-
-
|
|
144
|
-
-
|
|
154
|
+
- **每个成员一行,列头统一标注**:成员、会话、preset、模型、effort、上下文、操作,每列居中,不在每行重复写字段名。人员用彩色小图标(蓝色=个人、琥珀色=群聊)、备注名和管理员标记表示。会话列只显示简短状态:**点击状态先弹出完整名称与 Session ID,再点「在 DSH 中打开」才跳转**,避免在表格里误点离开页面。模型和 effort 是常驻的下拉框,**点一次就能展开**,只影响当前 Session;不支持思考强度的模型不会提供无效选项。小图标仍打开人员详情,其中“所属分组”本身就是切换下拉框,不再另列“移动到分组”。归档会话是一个带边框的按钮,保留确认步骤。
|
|
155
|
+
- 分组卡片不再有单独的添加成员按钮:普通用户在「未授权用户」里授权;未入组的管理员也可在「④ 管理员」中点击「不在任何分组」加入。
|
|
145
156
|
- **这里的改动立即生效,不需要点保存**。
|
|
146
157
|
3. **③ 未授权用户**:给机器人发过消息、但不在任何分组里的人,按时间倒序,附带最后一条消息的摘要;点「加入分组」选择分组(可填备注)并确认,即完成授权,机器人会给他发一条授权提示。**列表只在内存中**,重启 DSH 后清空(授权本身是持久化的)。这里同样优先显示备注名。
|
|
147
158
|
4. **④ 管理员**:管理员列表用的是同一套人员行——点小图标弹出人员详情(类型、企微 ID、所属分组、备注),**备注即时生效**、与分组成员共用同一个名字;「移除管理员」在详情窗口底部,**加人、移除、改通知范围都不需要再点保存**:选中/移除即写入插件设置,**不会重连机器人**(决定是你当场做的,所以不用再点一次确认)。
|
|
148
159
|
- 列表为空时显示一个「添加管理员」按钮;不为空时卡片右上角有一个「添加」。两者打开同一个**带搜索框的已知用户列表**:候选人是未授权用户和已授权成员,**优先显示备注名**、没有备注才显示企微 ID;找不到时也可以直接按 userid 添加。
|
|
160
|
+
- 未入组的管理员,点击行内的「**不在任何分组**」展开分组下拉框;选择后**立即加入该分组**并收到授权通知,管理员权限与备注不变。仅打开或取消不会写入,也不会自动选中默认分组;成功后该行显示所属分组,下一条消息按该组的配置创建会话。
|
|
149
161
|
- 「可接收通知的 Workspace」**默认折叠**,展开后是勾选列表。配置留空(默认)时**全部勾选**、表示不收窄范围;取消勾选某个 Workspace 后,存的就是剩下勾选的那些路径,全勾回去又回到留空。只有归档会话的 Workspace 也会列出来(除非已被删除)。勾选/取消即生效。
|
|
150
|
-
5. **⑤
|
|
162
|
+
5. **⑤ 连接与日志**(默认折叠):私有化部署的 `wss://` 地址、JSONL 日志开关与保留天数、日志目录;自带「保存 / 放弃」。这一卡里**只有 WebSocket 地址**属于连接身份,保存它会重连机器人;日志设置即时生效,不需要重启 DSH。
|
|
151
163
|
|
|
152
|
-
> 截图由 `pnpm run preview` 用样例数据离屏渲染生成(`--dark` 深色版 `preview/settings-dark.png`、`--advanced` 展开通知范围的版本 `preview/settings-advanced.png`、`--dialog` 人员详情窗口、`--picker` 添加管理员窗口 `preview/settings-picker.png`、`--archive` 归档确认窗口),改页面后重新跑一次即可更新。
|
|
164
|
+
> 截图由 `pnpm run preview` 用样例数据离屏渲染生成(`--dark` 深色版 `preview/settings-dark.png`、`--collapsed` 全部折叠时的信息网格 `preview/settings-collapsed.png`、`--advanced` 展开通知范围的版本 `preview/settings-advanced.png`、`--session` 会话身份窗口、`--dialog` 人员详情窗口、`--picker` 添加管理员窗口 `preview/settings-picker.png`、`--archive` 归档确认窗口),改页面后重新跑一次即可更新。
|
|
153
165
|
|
|
154
166
|
## 授权与权限边界
|
|
155
167
|
|
|
@@ -163,17 +175,20 @@ DSH 里的会话跑完一轮、需要你回答、或者需要审批工具调用
|
|
|
163
175
|
|
|
164
176
|
## 通知、提问与审批
|
|
165
177
|
|
|
166
|
-
-
|
|
167
|
-
-
|
|
168
|
-
-
|
|
169
|
-
-
|
|
178
|
+
- **授权与分组通知**:新增管理员会收到「你已被设为管理员」单聊通知;首次加入分组会收到授权通知,切换分组会收到新分组名称与「目标分组有可用旧会话就恢复、否则下一条新建」的说明。重复保存不重复通知,同一批修改只通知最终有效的授权或分组变化。
|
|
179
|
+
- **实时变更边界**:提升或撤销管理员权限、调整通知范围立即生效,不重连。发送通知与提交答复前都检查当前权限和 Workspace 范围;已处理或已结束的交互不再发送排队中的可操作通知。
|
|
180
|
+
- **一轮跑完推给谁**:推给“属于这个会话的人”——成员的会话推给他那个聊天;管理员按 `adminWorkspaces` 范围接收这些 Workspace 里**所有会话**的通知(留空 = 全部)。通知范围内任何普通 Session 的提问、权限审批与错误终止都会通知管理员,不要求这个 Session 由企微创建或存在等待中的企微消息。
|
|
181
|
+
- **通知内容**:完成通知只带该回合最后一条助手文字,不外发推理、工具参数或附件;错误终止提供简短原因与回到会话的指引。子代理会话不推送,普通取消通知仍只发给有消息在等的聊天。
|
|
182
|
+
- **提问与审批双端同时处理**:DSH 页面从一开始就可以处理,企微不会独占等待。普通提问可用 `/answer <验证码> <选项序号或文字>` 回答;**计划审阅与带详细内容的提问仍在 DSH 页面处理**,管理员会收到提醒。工具审批默认启用,无需额外打开开关,且只允许通知范围内的管理员在单聊里用 `/approve`、`/deny`。
|
|
183
|
+
- **冲突规则**:DSH 页面、企微或多位管理员同时处理同一交互时,**第一个有效结果生效**,其他入口被取消或忽略;再次提交旧验证码会提示“已处理或请求已结束”,不会重复批准、拒绝或答题。共享接口不返回获胜者身份,因此企微的提交回执不承诺自己获胜。验证码绑定到具体交互,不能用于后来的新请求。
|
|
184
|
+
- **能力边界**:双端同时处理使用 DSH 的共享交互服务;没有该服务的部署只发送提醒并立即交给原生界面,不退回旧的“先等企微再显示 DSH”行为。
|
|
170
185
|
|
|
171
186
|
## 内存里保留了什么
|
|
172
187
|
|
|
173
188
|
- 「未授权用户」列表:被拒绝主体的 ID、次数、最近时间,以及**最后一条消息的摘要**(单行、最多 120 字)。这是为了让管理员能认出敲门的人是谁。
|
|
174
189
|
- **被接受的正常消息不保留正文**;只有被拒绝的消息会留下摘要。
|
|
175
190
|
- 所有这些都只驻留内存(最多 200 条、24 小时过期),DSH 重启即清空。
|
|
176
|
-
- **持久化的东西都在一个文件里**:`<DSH home>/wecom-bot/settings.json`(`"version": "0.5"`,权限 `0600`、原子写入)。它装着设置块(管理员、通知范围、WebSocket
|
|
191
|
+
- **持久化的东西都在一个文件里**:`<DSH home>/wecom-bot/settings.json`(`"version": "0.5"`,权限 `0600`、原子写入)。它装着设置块(管理员、通知范围、WebSocket 地址、日志开关与保留天数)、分组、成员(含各组的历史 Session 绑定与当前 Session 模型覆盖)、备注,以及每位管理员自己的默认 Workspace——不再有第二个状态文件。版本号对不上(或内容读不出来)的文件不会被猜测着读或就地覆盖,而是改名成 `settings.json.v<旧版本>`(读不出来的用 `settings.json.corrupt`)放在旁边,插件从空状态开始;想留用里面的内容,照它的 userid/chatid 在页面上重新加一次即可。
|
|
177
192
|
|
|
178
193
|
状态与编辑接口注册在 DSH Connection Fetch 通道(`/api/wecom-bot/state` 读取状态、`/api/wecom-bot/store` 应用页面上的一切修改),只有已登录的 DSH 页面可访问。
|
|
179
194
|
|
|
@@ -187,7 +202,7 @@ DSH 里的会话跑完一轮、需要你回答、或者需要审批工具调用
|
|
|
187
202
|
| `/delete` | 归档当前会话:**会清空它的记忆**,下一条消息按分组当前配置新建会话。先回一条警告,再发 `/delete confirm` 才执行 | 所有人(群聊需管理员) |
|
|
188
203
|
| `/cancel` | 停止当前会话正在运行的回合 | 所有人 |
|
|
189
204
|
| `/answer <验证码> [题目ID] <选项序号或文字>` | 回答 DSH 的提问;只有一道题时可省略题目 ID;多选用 `1,3` | 所有人 |
|
|
190
|
-
| `/approve <验证码>`、`/deny <验证码>` |
|
|
205
|
+
| `/approve <验证码>`、`/deny <验证码>` | 远程审批(默认启用,仅通知范围内**管理员**的单聊可操作,先到先得) | 仅管理员(单聊) |
|
|
191
206
|
| `/whoami` | 查看自己的 userid、所属分组与管理员身份 | 所有人 |
|
|
192
207
|
| `/new` | 在**你的默认 Workspace** 里新建一个会话并切换过去(新会话用 DSH 默认模型与 preset,不继承任何分组) | 仅管理员(单聊) |
|
|
193
208
|
| `/workspaces` | 列出 DSH 的 Workspace 与序号,以及你当前的默认 Workspace;`/workspaces 序号` 选定,`/workspaces 0` 取消限定 | 仅管理员(单聊) |
|
|
@@ -262,7 +277,7 @@ DSH 里的会话跑完一轮、需要你回答、或者需要审批工具调用
|
|
|
262
277
|
| `dsh.question*` / `dsh.approval*` | 提问、审批及其答复 |
|
|
263
278
|
| `connection.phase`、`config.applied`、`wecom.sdk` | 连接状态变化、生效的设置(不含 Secret;`connection: rebuilt` 表示重建了连接,`kept` 表示就地交给运行中的机器人)、SDK 日志 |
|
|
264
279
|
|
|
265
|
-
Secret 值、`secret`/`token`/`authorization` 等字段、`response_url`、媒体 `url` 与 `aeskey`
|
|
280
|
+
Secret 值、`secret`/`token`/`authorization` 等字段、`response_url`、媒体 `url` 与 `aeskey` 一律脱敏。日志包含对话原文,请按敏感数据管理;不需要时可在「连接与日志」中关闭。
|
|
266
281
|
|
|
267
282
|
## 构建、本地安装与升级
|
|
268
283
|
|
|
@@ -274,6 +289,10 @@ pnpm run preview # 可选:重新生成 README 里的设置页截图(需
|
|
|
274
289
|
|
|
275
290
|
DSH 加载 `dist/` 中的构建产物:Host 入口 `dist/host/index.js`,浏览器入口 `dist/client.js`。本地开发时在 DSH「插件」中以本目录绝对路径安装 bundle;改完代码重新构建后**重启 DSH**(Host 模块不热重载;只改客户端页面时,插件客户端热重载可用)。接口已在 DSH `0.2.0-rc.2` 与 `0.2.1-rc.2` 上核对。
|
|
276
291
|
|
|
292
|
+
把某个 profile 从「本地路径安装」换成「npm 包安装」(或反过来)时,插件的**解析路径变了**,而 DSH 的模块缓存仍指向旧路径:装好后条目会以 `failed to import: Cannot find package '@wecom/aibot-node-sdk' imported from …/learn/dsh-wecom-bot/dist/host/runtime.js` 这种形式失败,指向的其实是你本地仓库那个旧路径(它此时可能连 `node_modules` 都没有了)。在仓库里跑一次 `pnpm install` 修好本地依赖,然后**重启 DSH** 让条目从 profile 重新解析;同一路径上的普通版本变化(npm 0.4.2 → npm 0.5.0)不需要重启。
|
|
293
|
+
|
|
294
|
+
验证一个刚发布的版本时也请用精确版本号安装——裸包名会被 pnpm 的 24 小时窗口回落到旧版本(见「[安装插件](#1-安装插件)」)。
|
|
295
|
+
|
|
277
296
|
升级到新版本时没有手工迁移步骤:装上新的包,插件继续读同一个 `settings.json`(版本线没变就照原样用);唯一需要动手的情况是文件版本换到了新的次版本线,那时旧文件会被改名放到旁边(见「[内存里保留了什么](#内存里保留了什么)」),照里面的 userid/chatid 在页面上重新加一次即可。
|
|
278
297
|
|
|
279
298
|
## 已知限制
|
|
@@ -326,7 +345,7 @@ src/
|
|
|
326
345
|
routes.ts 已认证的两个接口:读取状态、应用页面上的设置/分组/成员修改
|
|
327
346
|
client/ 插件主页(React TSX,esbuild → dist/client.js)
|
|
328
347
|
index.tsx 注册到 plugins.bundle.config
|
|
329
|
-
components/
|
|
348
|
+
components/ 状态栏、凭据、用户分组、未授权用户、管理员、连接与日志(人员行为 ui.tsx 的 PersonRow/PersonDialog/SessionDialog,分卡片保存用 SaveBar)
|
|
330
349
|
hooks.ts / api.ts Config 表单(只有①连接用)、插件设置提交、凭据与状态接口
|
|
331
350
|
model.ts 纯函数:草稿、差异、校验、模型/preset/effort/上下文标签、分组/成员操作
|
|
332
351
|
styles.ts 基于 DSH 主题变量的样式
|