dsh-wecom-bot 0.2.1 → 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.
Files changed (50) hide show
  1. package/README.md +159 -54
  2. package/dist/client.js +1462 -613
  3. package/dist/host/bridge/commands.js +315 -48
  4. package/dist/host/bridge/commands.js.map +1 -1
  5. package/dist/host/bridge/directory.js +33 -10
  6. package/dist/host/bridge/directory.js.map +1 -1
  7. package/dist/host/bridge/format.js +23 -0
  8. package/dist/host/bridge/format.js.map +1 -1
  9. package/dist/host/bridge/index.js +219 -104
  10. package/dist/host/bridge/index.js.map +1 -1
  11. package/dist/host/bridge/interactions.js +2 -2
  12. package/dist/host/bridge/interactions.js.map +1 -1
  13. package/dist/host/bridge/notices.js +229 -46
  14. package/dist/host/bridge/notices.js.map +1 -1
  15. package/dist/host/bridge/outbox.js.map +1 -1
  16. package/dist/host/bridge/policy.js +16 -16
  17. package/dist/host/bridge/policy.js.map +1 -1
  18. package/dist/host/bridge/selection.js +1 -0
  19. package/dist/host/bridge/selection.js.map +1 -1
  20. package/dist/host/catalog.js +70 -7
  21. package/dist/host/catalog.js.map +1 -1
  22. package/dist/host/config.js +31 -12
  23. package/dist/host/config.js.map +1 -1
  24. package/dist/host/groups-view.js +308 -0
  25. package/dist/host/groups-view.js.map +1 -0
  26. package/dist/host/index.js +21 -11
  27. package/dist/host/index.js.map +1 -1
  28. package/dist/host/models.js +106 -0
  29. package/dist/host/models.js.map +1 -0
  30. package/dist/host/observation.js +53 -60
  31. package/dist/host/observation.js.map +1 -1
  32. package/dist/host/presets.js +49 -0
  33. package/dist/host/presets.js.map +1 -0
  34. package/dist/host/routes.js +76 -4
  35. package/dist/host/routes.js.map +1 -1
  36. package/dist/host/routing-store.js +349 -0
  37. package/dist/host/routing-store.js.map +1 -0
  38. package/dist/host/routing.js +71 -0
  39. package/dist/host/routing.js.map +1 -0
  40. package/dist/host/runtime.js +177 -7
  41. package/dist/host/runtime.js.map +1 -1
  42. package/dist/host/session-ops.js +100 -0
  43. package/dist/host/session-ops.js.map +1 -0
  44. package/dist/host/sessions.js +140 -0
  45. package/dist/host/sessions.js.map +1 -0
  46. package/dist/host/workspaces.js +154 -0
  47. package/dist/host/workspaces.js.map +1 -0
  48. package/dist/shared/protocol.js +23 -0
  49. package/dist/shared/protocol.js.map +1 -1
  50. package/package.json +2 -2
package/README.md CHANGED
@@ -2,8 +2,12 @@
2
2
 
3
3
  基于 [`@wecom/aibot-node-sdk` 1.0.7](https://cdn.jsdelivr.net/npm/@wecom/aibot-node-sdk@1.0.7/README.md) WebSocket 长连接的 DeepSeek Harness 本地插件,无需公网回调地址:
4
4
 
5
- - DSH 会话**本轮完成**、**需要你回答**或**请求权限**时,主动推送到企业微信;
6
- - 在企业微信里 `/sessions` 选会话,直接回复就能继续对话,还可 `/answer`、`/cancel`;
5
+ - **用户分组决定一切**:每个分组有自己的 Workspace、模型(含 effort)与 agent preset,成员(企微用户或群聊)的会话就建在那里;没被放进任何分组的人发消息会被告知"用户未授权,请联系管理员";
6
+ - **每个企业微信用户/群都有自己的专属 DSH 会话**:用户私聊时一人一个会话,群聊时整个群共享一个会话;
7
+ - DSH 会话**本轮完成**、**需要你回答**时,主动推送回**属于这个会话的那个聊天**;**工具调用审批只通知管理员**,管理员可在单聊里用验证码批准或拒绝;
8
+ - 在企业微信里直接发消息就能继续对话,还能 `/status`、`/compact`、`/delete`、`/answer`、`/cancel`、`/approve`;管理员另有 `/sessions`、`/use`、`/workspaces`、`/new`;
9
+ - **授权就是把人加进分组**:被拒绝的人会带着他发的消息出现在插件主页的「未授权用户」里,选中分组即完成授权(可顺手起个备注名),机器人会给他发一条"管理员已授权,可以开始使用了";
10
+ - 只有管理员能切换会话、选择默认 Workspace;分组、成员、备注、Workspace、模型、effort 与 preset 都能在插件主页上调整,每张卡片各存各的;
7
11
  - 每条企微消息的原始请求、回复和元数据写入 DSH home 下的 JSONL 日志。
8
12
 
9
13
  > 企业微信**智能机器人(API 模式 · 长连接)**使用 Bot ID + **Bot Secret**,不是群机器人 webhook key,也不是回调 Token/EncodingAESKey。请勿把 Secret 发进聊天或提交到仓库。
@@ -19,52 +23,131 @@ DSH 加载 `dist/` 中的构建产物:Host 入口 `dist/host/index.js`,浏
19
23
 
20
24
  **修改代码并重新构建后,需要重启 DSH 应用**:桌面版 profile 未开启 Host 源码热重载,禁用/启用插件不会替换已缓存的 Host 模块。接口已在 DSH `0.2.0-rc.2` 上核对。
21
25
 
26
+ ## 用户分组、成员与会话
27
+
28
+ 插件把"谁能跟机器人说话"和"他的会话建在哪里"合并成了一件事:**分组**。
29
+
30
+ | 概念 | 含义 |
31
+ | --- | --- |
32
+ | **分组** | 一份策略:一个 Workspace + 一个模型(含思考强度 effort)+ 一个 agent preset(默认的「默认分组」不可删除) |
33
+ | **成员** | 一个被授权的企微主体:私聊里的人(userid)或一个群聊(chatid) |
34
+ | **会话** | 成员在它所属分组的 Workspace 里拥有/共享的那个 DSH 会话 |
35
+ | **备注** | 给成员起的名字,设置后界面与 `/status` 都优先显示它,而不是企微 ID |
36
+ | **preset** | DSH 的 agent preset(决定这个会话能用哪些工具、带哪些提示段),只在**新建会话时**生效 |
37
+
38
+ - **授权 = 加入分组**:只有属于某个分组的成员(以及管理员)会得到回复。不在任何分组里的人发消息会收到一条固定回复「**🔒 用户未授权** · 请联系管理员把你加入分组后再试」,同时出现在插件主页的「未授权用户」卡片里,连同他最后一条消息的摘要;在那里选择分组、可选填备注并确认,就完成了授权,机器人随即给他发一条「管理员已授权,可以开始使用了」。
39
+ - **管理员始终可以发消息**:`adminUserIds` 里的人由 Config 直接信任,无需入组,会被隐式放进「默认分组」,因此刚装好插件也不会把自己锁在外面。
40
+ - **会话创建**:成员的会话为空时,收到下一条消息会在**其分组的 Workspace** 里新建一个 DSH 会话并立即提交消息;会话已归档或已删除时会自动换一个新的。想主动换一个:发 `/delete`(再 `/delete confirm`)或在插件主页点成员行尾的「归档会话」——归档后下一条消息就按分组当前的 Workspace、模型与 preset 新建会话。
41
+ - **默认分组的 Workspace**:留空即插件自带目录 `<DSH home>/wecom-bot/workspace`(自动创建并注册到侧边栏,标题「企业微信」);也可以选一个已存在的目录。
42
+ - **模型与 effort 属于分组**:分组选定模型(与思考强度 effort)后,会在创建会话时安装为会话级模型,也适用于该分组已存在的会话;留空表示跟随 DSH 当前默认模型。插件调用 DSH 的 `sessionController.selectModel` 设置会话级模型后会**把 DSH 默认模型恢复原状**,所以配置插件不会改变你在 DSH 界面新建会话时用的默认模型。
43
+ - **preset 属于分组,且是一次性的创建事实**:成员的新会话会按分组的 preset 组装(这个部署没有可选的 preset 时跟随 DSH 默认)。改分组的 preset 只影响**此后新建的会话**——DSH 不允许改写已经开始过一轮的会话,想换 preset 就归档当前会话(成员行尾的「归档会话」,或 `/delete`)。
44
+ - **换 Workspace 会换会话**:分组的 Workspace 一改,该分组成员记录的会话 id 会被清空,下一条消息在新目录里重新建会话(否则"分组的 Workspace"就是一句空话)。
45
+ - **删除分组会取消授权**:删掉一个分组时,组内成员一并被移出(不删 DSH 里的会话),他们会重新出现在「未授权用户」里,需要时再授权一次。这是刻意的:删除分组绝不应该悄悄把成员升级到默认分组的 Workspace。
46
+ - 新会话在**第一次提交消息之前是"空会话"**,DSH 侧边栏会暂时不显示它,提交第一条消息后就正常出现;管理员刚用 `/new` 建出的会话可以直接用,不必等它显示出来。
47
+
22
48
  ## 在插件主页配置
23
49
 
24
- 打开 **设置 → 插件 → `dsh-wecom-bot`** 的 bundle 主页。页面自上而下:
50
+ 打开 **设置 → 插件 → `dsh-wecom-bot`** 的 bundle 主页。页面只有五张卡片,默认显示的尽量少,需要什么点什么;**每张卡片各存各的**,底部的「保存配置」已经去掉了:
25
51
 
26
- 1. **状态栏**:连接状态(在线 / 连接中 / 认证失败 / 被其他连接替换…)与本次启动以来的消息、拒绝、提交、推送计数。
27
- 2. **访问范围提示**:任一白名单留空都会醒目提示其含义。
28
- 3. **① 连接机器人(仅有的两项必填)**
29
- - **Bot ID**
30
- - **Bot Secret**:保存到 DSH 凭据库(引用名 `WECOM_BOT_SECRET`),插件 Config 只记录引用名;保存后不回显,留空表示保持不变。
31
- 4. **② DSH 会话范围**:通过 DSH Session API 读取,与 DSH 侧边栏一致地**按 Workspace 分组**;每行先显示**会话名称**,再显示 Session ID;**已归档、子代理、空白会话不显示**。支持搜索(名称 / ID / 工作区)、按工作区一键全选、仅看已选。已勾选但后来被归档或删除的会话单独列出,可一键移除。
32
- 5. **③ 企业微信来源**:列出最近 24 小时**真正给机器人发过消息**的 userid 与会话 ID(单聊为对方 userid,群聊为 chatid),**包括被白名单拒绝的**,并标注“上次被拒绝 / 已接受”、最近时间与消息数;勾选即加入白名单,也可手动添加。
33
- 6. **④ 高级设置**(默认折叠):远程审批、等待企微回复的秒数、私有化部署的 `wss://` 地址、JSONL 日志开关与保留天数、日志目录。
52
+ ![插件主页:连接、用户分组、未授权用户、管理员、高级设置五张卡片](https://raw.githubusercontent.com/lastorder/dsh-wecom-bot/main/preview/settings.png)
34
53
 
35
- 底部操作栏显示是否有未保存更改,提供「放弃更改」「保存配置」。
54
+ 每个人的详情(类型、企微 ID、可编辑的备注,以及他的会话、移动分组、移出分组)都在**点小图标弹出的窗口**里;列表本身只负责看:
36
55
 
37
- ### 访问控制:留空 = 全部允许
56
+ ![点人员行左侧的小图标,弹出人员详情](https://raw.githubusercontent.com/lastorder/dsh-wecom-bot/main/preview/settings-dialog.png)
38
57
 
39
- | 白名单 | 勾选后 | 留空时 |
40
- | --- | --- | --- |
41
- | DSH 会话 | 只能操作勾选的会话 | 可操作所有未归档会话(子代理/空白会话始终不可操作) |
42
- | 企微会话 | 只接受这些单聊/群聊的消息,通知也只发到这里 | 接受任何会话;通知只发给**曾经通过授权**的会话 |
43
- | 企微用户 | 只接受这些 userid 的消息 | 任何人 |
58
+ 归档一个成员的会话只要一次确认;确认后下一条消息会按分组当前的配置新建会话:
59
+
60
+ ![归档会话前的确认弹窗](https://raw.githubusercontent.com/lastorder/dsh-wecom-bot/main/preview/settings-archive.png)
61
+
62
+ 全新安装(还没有任何成员、任何管理员)时整页只有折叠的标题行,一屏放得下:
44
63
 
45
- **三项都留空时,任何能给机器人发消息的人都能读取回复并向你的 DSH 会话下指令(可能触发命令执行与文件修改)。** 建议:只勾选自己的 userid 与自己和机器人的单聊,再只勾选需要远程操作的会话。群聊中的通知对全体群成员可见。
64
+ ![全新安装时的插件主页](https://raw.githubusercontent.com/lastorder/dsh-wecom-bot/main/preview/settings-empty.png)
46
65
 
47
- 被拒绝的消息**不会收到任何回复**(不暴露机器人存在),但会出现在「企业微信来源」列表供你审核。ID 列表只保存 ID、计数和最近一次判定,不保存消息正文;驻留内存,每类最多 200 条,DSH 重启后清空。状态接口注册在 DSH Connection Fetch 通道(`/api/wecom-bot/state`),只有已登录的 DSH 页面可访问。
66
+ 1. **① 连接机器人**(仅有的两项必填)
67
+ - **Bot ID**
68
+ - **Bot Secret**:保存到 DSH 凭据库(引用名 `WECOM_BOT_SECRET`),插件 Config 只记录引用名;保存后不回显,留空表示保持不变。
69
+ - 改了任意一项,卡片底部才出现「保存 / 放弃」;保存成功会短暂显示「已保存。」,不会留下常驻提示。
70
+ 2. **② 用户分组**:每个分组是一张可折叠的卡片,标题行给出「N 位成员 · Workspace · 模型 · effort · preset」的概览,每一项都带自己的标签(例如 `模型 DeepSeek Reasoner · effort 高 · preset PTC`);跟随 DSH 默认的模型与 preset 标成 `(DSH 默认)` 并写出实际生效的名字。**点击标题行才展开**成员列表:
71
+ - 行尾的「**编辑**」点下去会**变成「保存」**:名称、Workspace、模型、effort、preset 一次性组成一份草稿,点「保存」才提交(旁边有「取消」放弃)。默认分组没有删除按钮。effort 下拉只在所选模型支持思考强度时可选,preset 列表来自 DSH 的 preset registry(这个部署没挂 registry 时只有「跟随 DSH 默认」)。
72
+ - **添加分组**会立刻建一个默认名字的分组,并**直接打开它的完整编辑框**——不用先起名再编辑。
73
+ - **每个成员一行**:左边是**彩色小图标**(蓝色=个人,琥珀色=群聊,右下角带一支铅笔表示可点)、名字(没有备注时才是企微 ID)、管理员标记,然后依次是**会话名**(含运行指示与状态)、**preset**、**当前模型**、**effort**、**上下文占用**(如 `12.3k / 128k(10%)`),行尾是「**归档会话**」。**只有那个小图标**会打开人员详情;文字上不再写"个人/群聊"。
74
+ - 添加成员不再有单独的按钮:给机器人发消息的人在「未授权用户」里授权,就是加成员的唯一入口。
75
+ - **这里的改动立即生效,不需要点保存**。
76
+ 3. **③ 未授权用户**:给机器人发过消息、但不在任何分组里的人,按时间倒序,附带最后一条消息的摘要;点「加入分组」选择分组(可填备注)并确认,即完成授权,机器人会给他发一条授权提示。**列表只在内存中**,重启 DSH 后清空(授权本身是持久化的)。这里同样优先显示备注名。
77
+ 4. **④ 管理员**:管理员列表用的是同一套人员行——点小图标弹出人员详情(类型、企微 ID、所属分组、备注),**备注即时生效**、与分组成员共用同一个名字;「移除管理员」在详情窗口底部,**加入或移出管理员都要点这张卡片的「保存」**。
78
+ - 列表为空时显示一个「添加管理员」按钮;不为空时卡片右上角有一个「添加」。两者打开同一个**带搜索框的已知用户列表**:候选人是未授权用户和已授权成员,**优先显示备注名**、没有备注才显示企微 ID;找不到时也可以直接按 userid 添加。
79
+ - 「可接收通知的 Workspace」**默认折叠**,展开后是勾选列表。配置留空(默认)时**全部勾选**、表示不收窄范围;取消勾选某个 Workspace 后,保存的就是剩下勾选的那些路径,全勾回去又回到留空。只有归档会话的 Workspace 也会列出来(除非已被删除)。
80
+ 5. **⑤ 高级设置**(默认折叠):远程审批、等待企微回复的秒数、私有化部署的 `wss://` 地址、JSONL 日志开关与保留天数、日志目录;同样自带「保存 / 放弃」。
81
+
82
+ > 截图由 `pnpm run preview` 用样例数据离屏渲染生成(`--dark` 深色版 `preview/settings-dark.png`、`--advanced` 展开通知范围的版本 `preview/settings-advanced.png`、`--dialog` 人员详情窗口、`--picker` 添加管理员窗口 `preview/settings-picker.png`、`--archive` 归档确认窗口),改页面后重新跑一次即可更新。
83
+
84
+ ### 授权与权限边界
85
+
86
+ - 只有**分组里的成员**和**管理员**能让机器人干活;其它人发来的消息不会提交给 DSH,只会收到「用户未授权」并在「未授权用户」里留一行。
87
+ - 普通用户**永远只能访问自己名下的那个会话**:`/sessions`、`/use`、`/new`、`/workspaces`、引用通知跳转都会被拒绝,也不会收到别人会话的通知。自己的会话可用 `/compact` 压缩上下文、用 `/delete`(再 `/delete confirm`)归档。
88
+ - **管理员**(`adminUserIds`)可以:`/sessions` 按 Workspace 列出会话、`/use` 切换自己要操作的会话、`/workspaces` 选一个默认 Workspace、`/new` 在那个 Workspace 新建会话并切换过去、`/reset` 回到自己的专属会话、引用任意通知直接跳转到那个会话;并按 `adminWorkspaces` 接收这些 Workspace 中**所有会话**的通知(留空 = 全部 Workspace)。**工具调用审批只发给管理员**,群聊和普通用户的单聊永远收不到审批请求。
89
+ - **管理员命令只能在单聊里发送**:群聊里的会话是所有人共用的,`/new`、`/workspaces`、`/sessions`、`/use`、`/reset`、`/approve`、`/deny` 在群里一律被拒绝(回「管理员命令只能在单聊中使用」,不会被执行);`/compact`、`/delete` 在群里只有管理员能用,群成员发会被回「需要管理员权限」。
90
+ - 管理员配置在插件主页的「④ 管理员」中维护,也可以直接改 Config 的 `adminUserIds` / `adminWorkspaces`。
91
+ - 撤销授权有两种方式:在成员详情窗口底部点「移出分组」,或删掉整个分组。两者都不会删除 DSH 里已有的会话,也不会忘记这个人的备注。
92
+ - **备注属于人,而不是属于某次授权**:它和分组、成员一起保存在 `bindings.json` 里,但独立于授权——移出分组、删掉分组、甚至从未进过分组的管理员,备注都还在,下次授权同一个人时自动恢复显示。
93
+
94
+ ### 内存里保留了什么
95
+
96
+ - 「未授权用户」列表:被拒绝主体的 ID、次数、最近时间,以及**最后一条消息的摘要**(单行、最多 120 字)。这是为了让管理员能认出敲门的人是谁。
97
+ - **被接受的正常消息不保留正文**;只有被拒绝的消息会留下摘要。
98
+ - 所有这些都只驻留内存(最多 200 条、24 小时过期),DSH 重启即清空;**分组与成员是持久化的**,不受影响。
99
+
100
+ 状态与分组接口注册在 DSH Connection Fetch 通道(`/api/wecom-bot/state`、`/api/wecom-bot/routing`),只有已登录的 DSH 页面可访问。
48
101
 
49
102
  ## 企业微信指令
50
103
 
51
- | 指令 | 作用 |
52
- | --- | --- |
53
- | `/help` | 查看命令 |
54
- | `/sessions` | 按工作区列出可操作的会话,带序号、名称、运行状态和 ID 前缀(最多 30 条) |
55
- | `/use <序号 \| 会话ID前缀>` | 选择会话;序号来自你最近一次 `/sessions`,ID 前缀至少 6 位且需唯一。白名单只有一个会话时自动选中 |
56
- | 引用(回复)DSH 发来的某条通知 | 把之后的消息(含斜杠命令)直接定位到那条通知所属的会话,覆盖此前的 `/use` 选择——每条通知末尾都带着可点的提示行 |
57
- | 直接发送文字 | 提交到选中的会话(`mode: queue`);未选择时会直接回复带序号的会话列表 |
58
- | `/status` | 当前选择与待处理请求 |
59
- | `/cancel` | 停止选中会话正在运行的回合 |
60
- | `/answer <验证码> [题目ID] <选项序号或文字>` | 回答 DSH 的提问;只有一道题时可省略题目 ID;多选用 `1,3` |
61
- | `/approve <验证码>`、`/deny <验证码>` | 远程审批(需在高级设置中开启,且只能在已授权用户的单聊中使用) |
62
- | `/whoami` | 查看自己的 userid 与当前会话 ID |
63
-
64
- - 完成通知只包含该回合**最后一条助手文字**,不外发推理、工具参数或附件;子代理会话的回合不推送。非“正常完成”的回合(取消、出错)只在有企微消息在等它时推送。
104
+ | 指令 | 作用 | 谁可以用 |
105
+ | --- | --- | --- |
106
+ | `/help` | 查看命令 | 所有人 |
107
+ | `/status` | 当前会话的完整状态:会话名、Workspace、preset、模型、effort、上下文占用、第几轮/共几步、运行状态、分组、绑定与待处理请求 | 所有人 |
108
+ | `/compact` | 压缩当前会话的上下文(把较早的历史折成一条摘要),回复合并了多少条历史、释放了多少 tokens | 所有人(群聊需管理员) |
109
+ | `/delete` | 归档当前会话:**会清空它的记忆**,下一条消息按分组当前配置新建会话。先回一条警告,再发 `/delete confirm` 才执行 | 所有人(群聊需管理员) |
110
+ | `/cancel` | 停止当前会话正在运行的回合 | 所有人 |
111
+ | `/answer <验证码> [题目ID] <选项序号或文字>` | 回答 DSH 的提问;只有一道题时可省略题目 ID;多选用 `1,3` | 所有人 |
112
+ | `/approve <验证码>`、`/deny <验证码>` | 远程审批(需在高级设置中开启,且只能在**管理员**的单聊中使用) | 仅管理员(单聊) |
113
+ | `/whoami` | 查看自己的 userid、所属分组与管理员身份 | 所有人 |
114
+ | `/new` | 在**你的默认 Workspace** 里新建一个会话并切换过去(新会话用 DSH 默认模型与 preset,不继承任何分组) | 仅管理员(单聊) |
115
+ | `/workspaces` | 列出 DSH 的 Workspace 与序号,以及你当前的默认 Workspace;`/workspaces 序号` 选定,`/workspaces 0` 取消限定 | 仅管理员(单聊) |
116
+ | `/sessions` | 按 Workspace 列出可切换的会话,带序号、名称、运行状态和 ID 前缀(最多 30 条);选了默认 Workspace 时只列它下面的会话 | 仅管理员(单聊) |
117
+ | `/use <序号 \| 会话ID前缀>` | 切换自己要操作/接收通知的会话;序号来自你最近一次 `/sessions`,ID 前缀至少 6 位且需唯一 | 仅管理员(单聊) |
118
+ | `/reset` | 放弃切换,回到自己的专属会话 | 仅管理员(单聊) |
119
+ | 引用(回复)DSH 发来的某条通知 | 把之后的消息(含斜杠命令)直接定位到那条通知所属的会话 | 仅管理员(单聊) |
120
+ | 直接发送文字 | 提交到当前会话(`mode: queue`) | 所有人 |
121
+
122
+ - 没有权限时回复「**🔒 需要管理员权限**」;管理员命令发在群聊里回复「**🔒 管理员命令只能在单聊中使用**」,两者都不会静默失败。
123
+ - 完成通知只包含该回合**最后一条助手文字**,不外发推理、工具参数或附件;子代理会话的回合不推送。非"正常完成"的回合(取消、出错)只在有企微消息在等它时推送。
65
124
  - 提问在企微等待(默认 60 秒)期间 DSH 页面不显示该提问,超时后回到 DSH 页面;**计划审阅与带详细内容的提问只能在 DSH 页面处理**。
66
125
  - 验证码为 6 位一次性随机码,绑定到具体的那次提问/审批,过期或旧码无法重放。
67
- - **引用定位的原理**:企业微信的引用回调只回传被引用消息的内容,不回传它的 ID,所以每条通知末尾都带一行 `/use <会话ID片段>` 的提示;插件在收到引用时从这段被回传的文字里把 ID 片段抠出来,按 `/use` 同样的规则解析成会话。无法解析(比如引用了一条无关消息,或该会话已不再允许操作)时什么都不会改变,继续按你当前的选择处理。
126
+ - **`/delete` 是归档而不是删除文件**:DSH 没有删除会话的 API,归档会让这个会话不再被继续、历史不再进入任何请求,效果就是"记忆清零、下一条消息新开会话";JSONL 会话文件仍留在磁盘上,需要时到 DSH 页面查看。
127
+ - `/new` 建出的会话属于"管理员自己开的会话",不挂任何分组,所以模型与 preset 跟随 DSH 默认;想用某个分组的配置,就让那个分组的成员去用。
128
+ - **`/compact` 用的是 DSH 自己的压缩能力**(`ctx.get('compaction').compactNow`),压缩的是当前会话的历史;会话正忙时会拒绝并说明原因。
129
+ - **引用定位的原理**:企业微信的引用回调只回传被引用消息的内容,不回传它的 ID,所以每条通知末尾都带一行 `/use <会话ID片段>` 的提示;插件在收到引用时从这段被回传的文字里把 ID 片段抠出来,按 `/use` 同样的规则解析成会话。无法解析(比如引用了一条无关消息,或该会话不在你的 Workspace 范围内)时什么都不会改变。
130
+
131
+ ### 消息排版
132
+
133
+ 命令回复与通知都由同一套模板生成([`notices.ts`](src/host/bridge/notices.ts)),结构固定、一眼能扫:
134
+
135
+ ```markdown
136
+ **🔄 已切换到《Alpha 任务》**
137
+
138
+ - **Workspace**:dsh-workpet
139
+ - **会话 ID**:`session-1ab2cd3ef4…`
140
+
141
+ 现在直接发送消息即可继续该会话;发送 `/reset` 可以回到自己的专属会话。
142
+ ```
143
+
144
+ - 第一行是 `**🏷 标题** · 《会话名》`——谁在说话、哪件事、属于哪个会话;命令名用 **粗体**,ID 与可以照抄的命令用 `行内代码`;
145
+ - 上下文(Workspace、用时、步数、`/cancel` 提示)放在引用块(`>`)里;
146
+ - 明细一律是扁平的 `- **字段**:值`,**不用表格、不用嵌套列表**(企业微信的 Markdown 渲染器不支持,会原样输出);
147
+ - 每条与会话有关的通知末尾都带 `引用(回复)这条消息,或发送 /use <会话ID片段>`,引用它就能继续那个会话;
148
+ - 所有来自 DSH 的字符串(会话标题、工具名、提问文字)都会把 Markdown 元字符换成同形字符,不会被渲染成链接、@ 提及或标签。
149
+
150
+ 发送 `/help` 即可在企业微信里看到全部命令。
68
151
 
69
152
  ## JSONL 对话日志
70
153
 
@@ -75,9 +158,9 @@ DSH 加载 `dist/` 中的构建产物:Host 入口 `dist/host/index.js`,浏
75
158
  ```json
76
159
  {"ts":"…","seq":42,"level":"info","event":"round.complete","roundId":"…","outcome":"turn-ended",
77
160
  "chatId":"zhangsan","userId":"zhangsan","chatType":"single","msgId":"…",
78
- "sessionId":"…","sessionTitle":"修复登录 Bug","workspace":"my-app","requestId":"…",
161
+ "sessionId":"…","sessionTitle":"修复登录 Bug","workspace":"企业微信","requestId":"…",
79
162
  "request":{"msgtype":"text","text":"帮我修复登录"},
80
- "response":{"replies":["已提交到《修复登录 Bug》…"],"reason":"completed","assistant":"已修复……","notifiedChats":["zhangsan"]},
163
+ "response":{"replies":["**🚀 已提交给 DSH** · 《修复登录 Bug》…"],"reason":"completed","assistant":"已修复……","notifiedChats":["zhangsan"]},
81
164
  "metadata":{"turn":3,"model":{"provider":"…","model":"…"},"steps":4,"toolCalls":{"bash":2},"turnDurationMs":51234},
82
165
  "timing":{"receivedAt":"…","submittedAt":"…","completedAt":"…","totalMs":53012}}
83
166
  ```
@@ -88,18 +171,31 @@ DSH 加载 `dist/` 中的构建产物:Host 入口 `dist/host/index.js`,浏
88
171
 
89
172
  | event | 内容 |
90
173
  | --- | --- |
91
- | `wecom.message` | 收到的原始回调帧(含被拒绝的消息)与访问判定 |
92
- | `wecom.quote` | 引用定位的解析结果:抠出的 ID 片段(`hint`)、命中的 `sessionId`,或未解析时的原因(`outcome`) |
174
+ | `wecom.message` | 收到的原始回调帧(含被拒绝的消息)与访问判定(`reason: unauthorized`) |
175
+ | `wecom.quote` | 引用定位的解析结果:抠出的 ID 片段(`hint`)、命中的 `sessionId`,或未解析时的原因(`outcome`,如 `not-admin`) |
93
176
  | `wecom.reply` | 被动回复的原始请求(streamId、内容)与服务器回执 |
94
177
  | `dsh.prompt` | 提交给 DSH 的原始请求与返回值 / 错误 |
95
178
  | `dsh.turn.end` | 回合结束原因、助手文字、模型、步数、工具调用统计 |
96
179
  | `wecom.send` | 主动推送的原始请求体与回执 |
97
- | `wecom.notify.skipped`(`warn`) | 该 Session 本可以推送通知,但目前没有任何已知的合格接收人——多数情况是插件刚重载或 DSH 刚重启,清空了"谁最近发过消息"的名单,而此后还没人发过新消息;`reason` 标注是哪类通知(`turn-complete`/`question`/`approval`) |
180
+ | `wecom.notify.skipped`(`warn`) | 该会话没有任何成员,也不在任何管理员的通知范围内,因此无人可通知 |
181
+ | `binding.session.created` / `binding.session.replaced`(`warn`) | 为一个成员创建了新会话(含所属分组);或原会话已归档/不可用而换了新会话 |
182
+ | `binding.session.reset`、`session.created`、`wecom.selection` | `/delete` 或页面归档会话、首次路由、管理员切换会话 |
183
+ | `dsh.session.archive` / `dsh.session.compact` / `dsh.session.create` | 归档会话、上下文压缩(条数与 tokens)、管理员 `/new` 新建会话 |
184
+ | `wecom.session.new` / `wecom.session.delete` / `wecom.workspace.select` / `wecom.authorized` | 管理员新建会话、归档自己的会话、选择默认 Workspace、页面授权某人后给她发提示 |
185
+ | `binding.store.error` / `binding.view.error`(`warn`) | 分组文件读写或读取分组视图失败(`stage: version` 表示文件版本不认识、已挪到 `bindings.json.v<版本>`) |
98
186
  | `dsh.question*` / `dsh.approval*` | 提问、审批及其答复 |
99
187
  | `connection.phase`、`config.applied`、`wecom.sdk` | 连接状态变化、生效配置(不含 Secret)、SDK 日志 |
100
188
 
101
189
  Secret 值、`secret`/`token`/`authorization` 等字段、`response_url`、媒体 `url` 与 `aeskey` 一律脱敏。日志包含对话原文,请按敏感数据管理;不需要时可在高级设置中关闭。
102
190
 
191
+ ## 升级
192
+
193
+ - Config 里的 `chatIds`、`allowedUserIds`、`defaultWorkspace`、`defaultProvider`、`defaultModel`、`defaultReasoningEffort` **都已移除**(0.4.x)。这些字段留在 profile 配置里不会报错,只是被忽略——授权改由「用户分组」决定,Workspace 与模型改由分组持有。
194
+ - **升级后请到「用户分组」里把默认分组的 Workspace / 模型重新设一遍**:旧 Config 的值不会自动迁移(第一版会保留默认分组的插件自带目录)。
195
+ - 需要重新授权:旧的 `allowedUserIds` / `chatIds` 白名单不再生效,所以升级后**所有人都不在分组里**。让他发一条消息,然后到「未授权用户」里把他加进分组;或者先把他加进「管理员」,管理员无需入组即可使用。
196
+ - **绑定文件没有迁移**:`<DSH home>/wecom-bot/bindings.json` 的 `version` 现在是**发布线**而不是递增计数(当前 `"0.4"`,包含分组 + 成员 + 备注 + 管理员各自的默认 Workspace);只有换到新的次版本线并改动布局时它才会变。每位管理员的偏好存成对象(`"adminDefaults": { "<userid>": { "workspace": "<路径>" } }`),以后加字段不用再换文件形状。别的版本号——包括 0.4.1 写下的整数 `5`——不会被猜测着读,而是被改名成 `bindings.json.v<版本>` 放好,插件从空状态开始。想留用旧文件的内容,照里面的 userid/chatid 在页面上重新加一次即可。重启 DSH 后如果「未授权用户」里出现了原来的成员,说明旧文件被放到一边了,重新授权一次即可。
197
+ - 0.3.0 里的 `sessionIds`(更早的会话白名单)早已被忽略,可以手动从 profile 配置里删掉。
198
+
103
199
  ## 已知限制
104
200
 
105
201
  - **群聊必须 @ 机器人**:企业微信只会把 @ 了机器人的群消息推给它,没 @ 的消息服务器那一层就不转发——插件连回调帧都收不到,无法处理。这是平台限制,不是插件的开关。
@@ -116,37 +212,46 @@ Secret 值、`secret`/`token`/`authorization` 等字段、`response_url`、媒
116
212
 
117
213
  ```text
118
214
  src/
119
- shared/protocol.ts Host 与页面共享的常量和状态接口类型
215
+ shared/protocol.ts Host 与页面共享的常量、分组/成员/模型/状态接口类型
120
216
  host/ DSH Host 插件(Node ESM,tsc → dist/host)
121
- index.ts 入口:Config、inject、apply
122
- config.ts Config schema 与规范化
217
+ index.ts 入口:Config、inject、apply(注册两个已认证接口)
218
+ config.ts Config schema 与规范化(策略:连接、管理员、高级开关)
123
219
  runtime.ts 宿主生命周期编排:配置/凭据变化时重建连接;唯一的 session/event 监听
220
+ routing-store.ts 分组 + 成员 + 备注 + 每位管理员的默认 Workspace:<DSH home>/wecom-bot/bindings.json(原子写、私有权限、只认当前版本)
221
+ routing.ts 成员 → 会话路由(分组的 Workspace/模型 + 成员自己的会话)
222
+ sessions.ts 会话供给:创建会话、安装模型、描述会话状态
223
+ session-ops.ts 需要 DSH 服务的三个操作:归档会话、压缩上下文、在指定 Workspace 新建会话
224
+ workspaces.ts 默认/自定义 Workspace 的解析与注册
225
+ models.ts DSH 模型目录与「安装会话级模型后恢复默认模型」
226
+ presets.ts DSH 的 agent preset 名单(分组表单的选项、写入前的校验)
227
+ groups-view.ts 配置页的分组表格(读取 + 校验并应用编辑)
124
228
  bridge/ 一条企微连接:
125
- index.ts 组装、入站处理、通知/提问/审批
229
+ index.ts 组装、入站处理、授权、路由、通知/提问/审批
126
230
  inbound.ts 回调帧校验与防重放
127
- policy.ts 三组白名单
128
- directory.ts 可操作会话(目录 ∩ 白名单)与 /use 解析
129
- commands.ts 斜杠命令
231
+ policy.ts 授权(= 分组成员资格)+ 管理员判定
232
+ directory.ts 管理员可操作会话(目录 ∩ Workspace 范围)与 /use 解析
233
+ commands.ts 斜杠命令(/status、/compact、/delete、/sessions、/use、/workspaces、/new 等)
130
234
  interactions.ts 提问/审批等待与验证码
131
235
  notices.ts 消息模板
132
236
  outbox.ts 主动推送队列
133
- selection.ts 每人的会话选择
237
+ selection.ts 管理员的会话切换
134
238
  format.ts 文本工具
135
239
  catalog.ts 按 Workspace 分组的 Session 目录(与侧边栏一致)
136
- observation.ts 见过的企微用户/会话(含被拒绝)
240
+ observation.ts 内存中的发信人:成员活跃度 + 被拒绝者及其消息摘要
137
241
  rounds.ts 每条消息的一轮记录 → round.complete
138
242
  turns.ts 从 Session 日志汇总一个回合
139
243
  journal.ts JSONL 日志、DSH home 解析、脱敏
140
244
  status.ts 连接状态与计数
141
- routes.ts 已认证的状态接口
245
+ routes.ts 已认证的状态与分组接口
142
246
  client/ 插件主页(React TSX,esbuild → dist/client.js)
143
247
  index.tsx 注册到 plugins.bundle.config
144
- components/ 状态栏、风险提示、凭据、会话选择、来源选择、高级设置
145
- hooks.ts / api.ts Config 表单、凭据、状态接口
146
- model.ts 纯函数:草稿、差异、校验、筛选
248
+ components/ 状态栏、凭据、用户分组、未授权用户、管理员、高级设置(人员行为 ui.tsx 的 PersonRow/PersonDialog,分卡片保存用 SaveBar)
249
+ hooks.ts / api.ts Config 表单、凭据、状态接口与分组提交
250
+ model.ts 纯函数:草稿、差异、校验、模型/preset/effort/上下文标签、分组/成员操作
147
251
  styles.ts 基于 DSH 主题变量的样式
148
252
  scripts/build-client.mjs 打包为 DSH 浏览器模块格式(React 与 DSH UI 组件由宿主提供)
149
- test/ node:test:Host 单元测试、页面渲染测试(react-test-renderer)
253
+ scripts/preview.mjs 用样例数据离屏渲染配置页(preview/*.png)
254
+ test/ node:test:Host 单元测试、分组存储、页面渲染测试(react-test-renderer)
150
255
  ```
151
256
 
152
257
  真实企业微信端到端送达需要本人在插件主页输入 Bot ID/Secret 后,用真实账号收发消息验证;平台限制以真实回执为准。