fix: align channel runtime and settings UI

This commit is contained in:
lofyer
2026-08-09 21:54:25 +08:00
parent 66b098ae36
commit 1cc969317d
17 changed files with 288 additions and 1528 deletions
@@ -5,21 +5,21 @@
| 项目 | 内容 |
| --- | --- |
| 状态 | 已实施,待真实微信账号联调 |
| 版本 | 1.3 |
| 版本 | 1.4 |
| 日期 | 2026-08-09 |
| 适用产品 | GoodBuddy 桌面端 |
| 首期范围 | 微信 ClawBot、企业微信、钉钉的通道项目;微信文字、图片和文件 Ask 与 Execute |
## 1. 背景
GoodBuddy 已支持企业微信钉钉远程消息通道,但目前通道仅存在于设置页和后台服务中远程消息进入任务系统后,用户无法在项目与会话导航中持续、明确识别:
GoodBuddy 已企业微信钉钉和微信 ClawBot 远程消息通道纳入系统管理的通道项目。该信息架构解决了早期通道仅存在于设置页和后台服务中远程消息进入任务系统后无法持续、明确识别以下信息的问题
1. 消息来自哪个平台。
2. 当前正在与哪个发送者或群聊对话。
3. 远程执行任务使用哪个工作目录。
4. 执行请求、处理后端、工具调用和结果归属于哪个范围。
GoodBuddy 同时计划接入腾讯官方微信 ClawBot。微信 ClawBot 使用扫码授权,不使用 App ID 或 Secret,并需要在本机持续运行通信服务。微信消息既要支持只读对话,也要支持受控执行
腾讯官方微信 ClawBot 使用扫码授权,不使用 App ID 或 Secret,并由本机独立 Sidecar 持续运行通信服务。文字、图片和文件收发、只读对话与受控执行已经实现;真实微信账号的认证媒体端到端联调仍作为发布前手动验收
为避免把通道来源、发送者身份和执行范围混在一起,本功能使用“通道项目 + 远程会话”的两级结构:
@@ -38,7 +38,7 @@ GoodBuddy 同时计划接入腾讯官方微信 ClawBot。微信 ClawBot 使用
6. 微信 ClawBot 首期支持个人微信私聊中的文字、图片和文件;语音和视频后续支持。
7. 微信卡片可以配置默认“对话”或“执行”模式。
8. “对话”映射为 GoodBuddy `Ask`;“执行”映射为 `Execute`
9. 每个通道项目默认使用“模型连接”中的默认直连文本模型,也可以显式选择其他直连文本模型、OpenCode 或 Continue。
9. 每个通道项目默认使用“模型连接”中的默认直连文本模型,也可以显式选择其他直连文本模型、OpenCode 或 Continue。选择 OpenCode/Continue 时,通道只保存 Runtime 类型,并在每次远程请求开始时动态跟随“Agent Runtime”中的对应全局配置,不维护第二套模型来源或 Runtime 配置。
10. 远程 Execute 不显示通道专属请求级或逐工具确认;收到合法消息后立即按所选后端运行。
11. 任务仍受工作目录、Runtime 能力、沙箱、能力开关、直连模型工具安全策略和活动审计约束。
12. 停用或断开通道不得删除通道项目、远程会话、任务、活动或成果历史。
@@ -216,7 +216,7 @@ C:\Users\用户名 [选择目录]
通道项目
微信 ClawBot
[断开连接]
[断开本机绑定(危险操作)]
```
“对话 / 执行”是互斥状态,应使用语义化分段控件,不使用两个独立复选框。
@@ -243,14 +243,21 @@ C:\Users\用户名
每个通道项目提供相同的后端选择,不提供含义不明确的“自动”选项:
- 直连模型:默认选择“模型连接”中的默认文本连接;列出已配置的文本模型连接,不列出仅支持图像生成的连接。
- OpenCode:使用当前 OpenCode Runtime 及其模型来源
- Continue:使用当前 Continue Runtime 及其模型来源
- OpenCode:使用当前 OpenCode Runtime,并动态跟随“Agent Runtime”中的全局 OpenCode 模型来源、自有配置、程序路径和服务地址
- Continue:使用当前 Continue Runtime,并动态跟随“Agent Runtime”中的全局 Continue 模型来源、自有配置和程序路径
选择持久化在通道项目上。旧版本保存的 `auto` 选择在启动时迁移为当前默认
直连文本模型。模型连接删除、改为图片模型或凭据失效后,优先修复为默认或
首个可用文本模型;没有可用文本模型时,UI 明确提示用户完成模型配置或改选
Agent Runtime。远程会话每次收到新消息时记录本次项目选择。Execute 启动前
检查所选后端是否支持工具执行,并返回可处理的配置错误。
Agent Runtime。OpenCode/Continue 的通道项目只持久化 `provider`,旧版残留的
通道级 `profileId` 在修复时移除;全局 Agent Runtime 配置变更从下一条远程
请求开始生效。远程会话记录通道项目的逻辑后端选择,不复制全局配置或凭据。
Execute 启动前检查解析后的后端是否支持工具执行,并返回可处理的配置错误。
通道面板的后端说明必须明确显示“跟随 Agent Runtime 全局配置”,不得在消息
通道设置中重复展示 OpenCode/Continue 的模型来源、自有配置文件或程序路径。
“Agent Runtime > 高级设置”中的来源选项、条件配置卡和后续路径字段保持
`12px` 区块间距,不能出现卡片边框贴合或内容归属不清。
### 7.5 通道项目会话界面
@@ -261,6 +268,7 @@ Agent Runtime。远程会话每次收到新消息时记录本次项目选择。E
- 尚无远程会话时显示等待首条客户端消息的空状态和设置入口。
- 旧版本误建在通道项目中的普通本地会话不参与通道会话列表,但保留其数据。
- 远程会话底部说明客户端联动方式,只显示历史、任务和执行结果,不再提及已移除的审批流程。
- “任务与活动”页面按会话分组显示远程任务;所有分组首次进入时默认收起,包括进行中、失败和已完成状态,用户可通过原生展开控件查看明细。
### 7.6 微信扫码绑定
@@ -276,6 +284,10 @@ Agent Runtime。远程会话每次收到新消息时记录本次项目选择。E
需要配对数字时,在同一对话框中显示验证码输入。验证码不得写入日志或持久化。
绑定完成后显示“重新绑定”和“断开本机绑定”。“断开本机绑定”使用共享红色
危险操作样式,并持续说明该操作只清除本机凭据、不保证解除微信服务端授权,
也不删除通道项目、远程会话、任务、活动或成果历史。
### 7.7 企业微信和钉钉
企业微信和钉钉继续使用现有凭据表单、环境变量只读覆盖和连接测试,但增加:
@@ -306,12 +318,10 @@ channel + accountId + externalConversationId
### 8.2 新建上下文
首期支持以下方式创建新上下文:
- 微信发送 `/new`
- GoodBuddy 会话页面点击“新建远程会话”
新会话仍属于相同通道项目。旧会话保留并可搜索。
首期不提供手动“新建远程会话”入口,也不把通道项目中的全局“新建对话”
命令转为本地会话。客户端首条合法消息按稳定键自动创建远程会话,后续消息
继续复用该会话;未来如增加远程上下文重置命令,需要单独定义协议、去重和
历史保留语义
### 8.3 展示
@@ -357,7 +367,7 @@ channel + accountId + externalConversationId
Execute 消息通过身份、长度、去重和并发检查后:
1. 创建并立即启动远程执行任务。
2. 使用通道项目当前保存的消息处理后端。
2. 使用通道项目当前保存的逻辑处理后端OpenCode/Continue 在此时解析“Agent Runtime”中的对应全局配置
3. 将项目根目录作为本次 Runtime 工作目录。
4. 所选后端不支持工具执行时,不启动任务,并返回设置修复说明。
@@ -491,10 +501,11 @@ Main 到 Sidecar
产品区分:
- 停用:停止收发,保留本地绑定凭据。
- 断开本地连接:停止收发并清除本地凭据。
- 断开本机绑定:停止收发并清除本地凭据;入口使用红色危险操作样式
- 微信端解除绑定:只有腾讯提供并验证服务端撤销能力后才可承诺。
当前不得把本地清除描述为“已在微信端彻底解绑”。
当前不得把本地清除描述为“已在微信端彻底解绑”。断开后保留通道项目、
远程会话、任务、活动和成果历史。
## 12. 数据与契约建议
@@ -643,8 +654,11 @@ Renderer 快照只返回是否已配置和脱敏标识。
- [ ] 三个通道使用与模型设置一致的分段外观页签,并保留完整页签键盘语义。
- [ ] 三个面板均显示项目、根目录、消息处理后端、默认模式和连接状态。
- [ ] 微信卡片可以完成扫码、过期刷新、验证码和连接状态展示。
- [ ] “断开本机绑定”使用共享红色危险操作样式,并明确说明只清除本机凭据、不删除历史或承诺服务端解绑。
- [ ] 不显示“自动”后端;首次创建和旧版 `auto` 配置均落到默认直连文本模型。
- [ ] 直连模型只列出文本连接,OpenCode 与 Continue 可直接选择。
- [ ] 选择 OpenCode/Continue 时只保存 Runtime 类型,每次远程请求动态跟随“Agent Runtime”中的对应全局配置,通道页不出现第二套 Runtime 配置。
- [ ] Agent Runtime 高级设置的来源选项、条件配置卡和路径字段之间保持 `12px` 间距且无横向溢出。
- [ ] 默认 Execute 时持续显示目录范围和无逐次确认的风险说明。
- [ ] Renderer 无法读取任何微信 Token 或上下文令牌。
@@ -658,6 +672,7 @@ Renderer 快照只返回是否已配置和脱敏标识。
- [ ] 切换到通道项目不会创建普通本地会话。
- [ ] 通道项目隐藏“新建对话”和 `Ctrl+N`,全局快捷命令也不创建会话。
- [ ] 没有远程会话时显示等待客户端首条消息的空状态。
- [ ] “任务与活动”中的会话分组默认收起,进行中、失败和已完成状态行为一致。
- [ ] 微信图片和文件显示在对应远程消息中,附件消息无需附带文字。
- [ ] 支持的附件进入所选后端现有图片或文档上下文;不支持和超限附件返回明确提示。
@@ -709,6 +724,7 @@ Renderer 快照只返回是否已配置和脱敏标识。
### 阶段三:受控 Execute
- 通道项目处理后端选择与失效修复。
- OpenCode/Continue 通道后端动态跟随全局 Agent Runtime 配置。
- Execute Runtime 接入。
- 直连模型工具安全策略和活动关联。
- 结果回传、取消、超时和失败恢复。
@@ -741,10 +757,12 @@ Renderer 快照只返回是否已配置和脱敏标识。
- 消息去重、会话映射、并发和取消。
- Ask 工具拒绝。
- Execute 使用直连模型、OpenCode 和 Continue 的路由。
- OpenCode/Continue 通道只保存 Runtime 类型,并在 Ask 与 Execute 开始时解析当前全局 Agent Runtime 配置。
- Execute 不创建通道专属审批,直连模型禁止工具策略仍然生效。
- 模型连接删除后的通道后端选择修复。
- 发件箱投递失败不重复执行。
- 项目选择器、分段页签、后端选择、设置面板和扫码对话框的键盘与无障碍行为。
- Runtime 高级设置区块间距、微信断开危险按钮和任务活动默认折叠的 UI 回归。
- Windows、macOS、Linux 的默认用户目录和 Sidecar 关闭行为。
实现完成后运行: