goodbuddy/docs/features/wechat-clawbot-channel-project-prd.md

远程消息通道项目与微信 ClawBot 集成 PRD

文档信息

项目	内容
状态	已实施，待真实微信账号联调
版本	1.4
日期	2026-08-09
适用产品	GoodBuddy 桌面端
首期范围	微信 ClawBot、企业微信、钉钉的通道项目；微信文字、图片和文件 Ask 与 Execute

1. 背景

GoodBuddy 已将企业微信、钉钉和微信 ClawBot 远程消息通道纳入系统管理的通道项目。该信息架构解决了早期通道仅存在于设置页和后台服务中，远程消息进入任务系统后无法持续、明确识别以下信息的问题：

1. 消息来自哪个平台。
2. 当前正在与哪个发送者或群聊对话。
3. 远程执行任务使用哪个工作目录。
4. 执行请求、处理后端、工具调用和结果归属于哪个范围。

腾讯官方微信 ClawBot 使用扫码授权，不使用 App ID 或 Secret，并由本机独立 Sidecar 持续运行通信服务。文字、图片和文件收发、只读对话与受控执行已经实现；真实微信账号的认证媒体端到端联调仍作为发布前手动验收。

为避免把通道来源、发送者身份和执行范围混在一起，本功能使用“通道项目 + 远程会话”的两级结构：

• 通道项目标识平台并确定默认工作目录、处理后端和默认模式。
• 远程会话标识具体发送者或群聊。
• 消息记录具体发送者和本次实际使用的模式。
• 任务与活动记录执行、工具调用和结果。

2. 已确认的产品决策

1. 微信 ClawBot、企业微信、钉钉分别对应一个系统管理的通道项目。
2. 三个通道项目在通道设置服务初始化时幂等创建，不等待用户完成连接配置。
3. Renderer 不直接创建通道项目。Main 进程保证项目存在，设置卡片首次展示时即可引用对应项目。
4. 通道项目默认根目录为当前操作系统用户目录。
5. 同一通道中的不同私聊用户或群聊分别建立独立远程会话。
6. 微信 ClawBot 首期支持个人微信私聊中的文字、图片和文件；语音和视频后续支持。
7. 微信卡片可以配置默认“对话”或“执行”模式。
8. “对话”映射为 GoodBuddy Ask；“执行”映射为 Execute。
9. 每个通道项目默认使用“模型连接”中的默认直连文本模型，也可以显式选择其他直连文本模型、OpenCode 或 Continue。选择 OpenCode/Continue 时，通道只保存 Runtime 类型，并在每次远程请求开始时动态跟随“Agent Runtime”中的对应全局配置，不维护第二套模型来源或 Runtime 配置。
10. 远程 Execute 不显示通道专属请求级或逐工具确认；收到合法消息后立即按所选后端运行。
11. 任务仍受工作目录、Runtime 能力、沙箱、能力开关、直连模型工具安全策略和活动审计约束。
12. 停用或断开通道不得删除通道项目、远程会话、任务、活动或成果历史。
13. 通道项目由系统管理，用户不能永久删除；用户可以修改其工作目录、处理后端和默认模式。

3. 目标

3.1 用户目标

• 在项目切换器中一眼识别微信、企业微信和钉钉来源。
• 在通道项目中区分不同发送者和群聊。
• 在设置卡片中完成连接、启停、处理后端、模式和工作目录配置。
• 通过微信进行只读问答或发起受控执行任务。
• 选择可信的执行后端，并查看完整执行记录。
• 保留通道关闭前后的历史上下文和审计记录。

3.2 产品目标

• 将远程通道纳入 GoodBuddy 现有 Project、Conversation、Task、Activity 和 Artifact 信息架构。
• 复用现有 ChannelService 的白名单、去重、并发、取消、输出限制和错误脱敏能力。
• 保持 Electron Main、Preload、Renderer 和不可信子进程之间的安全边界。
• 为后续语音、视频、多账号和更多通道提供稳定扩展点。

4. 非目标

首期不包含：

• 微信群聊。
• 微信语音和视频收发。
• 多个个人微信账号同时绑定。
• 通过微信临时扩大工具权限或安全策略。
• 主动群发、营销消息或任意联系人发现。
• 将微信会话自动合并进普通本地会话。
• 删除或迁移现有企业微信、钉钉历史数据。
• 把完整 OpenClaw Runtime 打包进 GoodBuddy。

5. 信息架构

5.1 项目分组

项目选择器增加“远程通道”分组：

普通项目
├─ 默认项目
└─ 用户创建的其他项目

远程通道
├─ 微信 ClawBot
├─ 企业微信
└─ 钉钉

每个通道项目持续显示连接状态：

• 未配置
• 已停用
• 正在连接
• 等待扫码
• 已连接
• 连接失败

通道状态不得只通过颜色表达。

5.2 项目、会话和消息关系

通道项目
  └─ 远程会话
       └─ 消息
            └─ 可选任务 / 活动 / 成果

职责划分：

层级	负责内容
通道项目	平台、连接状态、默认根目录、处理后端、默认模式
远程会话	平台账号、私聊用户或群聊、连续上下文
消息	具体发送者、本次实际模式、正文、时间和处理状态
任务与活动	Runtime、工具调用、执行结果和错误

5.3 会话命名

• 微信 ClawBot：优先使用已绑定用户昵称；不可用时显示“我的微信”。
• 企业微信私聊：优先使用平台显示名，否则显示脱敏发送者 ID。
• 钉钉私聊：优先使用平台显示名，否则显示脱敏发送者 ID。
• 群聊：使用群名称；每条消息仍显示具体发送者。
• 不得把原始 Token、上下文令牌或完整敏感标识作为会话标题。

6. 通道项目生命周期

6.1 自动创建

应用初始化通道设置服务时，Main 进程执行 ensureChannelProjects()：

1. 按稳定通道标识查找 weixin、wecom、dingtalk 对应项目。
2. 缺失时创建系统管理项目。
3. 已存在时复用，不重复创建。
4. 如果存在同名普通项目，不得按名称占用或修改该项目。
5. 创建失败时保留其他通道可用，并在设置快照中返回有界错误。

默认值：

通道	项目名称	根目录	处理后端	默认模式
weixin	微信 ClawBot	用户目录	默认直连文本模型	Ask
wecom	企业微信	用户目录	默认直连文本模型	Ask
dingtalk	钉钉	用户目录	默认直连文本模型	Ask

6.2 系统管理约束

• 通道项目不能从普通项目危险区永久删除。
• 停用通道不归档项目。
• 断开微信不删除项目和历史。
• 数据迁移或异常导致项目缺失时，下次初始化自动修复。
• 用户可以修改项目根目录、描述、处理后端和默认模式。
• 项目名称首期由系统管理，避免来源名称被改到不可识别；后续如允许自定义，必须持续显示通道徽标。

6.3 默认用户目录

通道项目默认使用操作系统用户目录。设置卡片必须显示完整目录，并在首次启用 Execute 时明确说明该范围可能包含桌面、下载、文档和其他私人文件。

如果根目录不存在、不可访问或不是目录：

• Ask 仍可在不读取本地文件的边界内工作。
• Execute 不得启动。
• 设置卡片显示就近错误和“选择目录”操作。

7. 设置页产品需求

7.1 导航

设置页标签由“企业通信”改为：

• 标题：消息通道
• 说明：微信 ClawBot、企业微信与钉钉

7.2 卡片通用结构

三个通道使用与模型设置一致的分段外观页签，并保留 tablist、tab、tabpanel、游标焦点和方向键语义。每次只显示一个 通道面板，窄窗口下页签单行横向滚动。

每个通道面板包含：

1. 通道名称和连接状态。
2. 启用开关。
3. 默认工作目录。
4. 消息处理后端。
5. 默认处理模式。
6. 对应通道项目。
7. 平台特有的连接配置。
8. 最近错误或连接状态。

示意：

微信 ClawBot                              已连接

已绑定账号：微信用户 ****8a3f
最近收到消息：今天 14:32

启用微信通道                              [开关]

默认处理模式
[ 对话 ] [ 执行 ]

默认工作目录
C:\Users\用户名                           [选择目录]

消息处理后端
[默认模型 · sonnet-5                   v]

通道项目
微信 ClawBot

[断开本机绑定（危险操作）]

“对话 / 执行”是互斥状态，应使用语义化分段控件，不使用两个独立复选框。

7.3 模式说明

• 对话：只读回答，不调用工具或修改内容。
• 执行：收到合法消息后立即交给所选后端，可在工作目录内调用已启用工具。

每个通道面板持续显示风险说明，不弹出一次性确认。默认 Ask 时也要说明白名单 发送者仍可通过 /execute 临时执行：

远程消息可能要求 GoodBuddy 读取或修改默认工作目录中的内容。
执行消息会立即交给所选后端，不再逐次弹窗确认。
请只连接可信账号，并将工作目录限制在必要范围。

默认工作目录：
C:\Users\用户名

7.4 消息处理后端

每个通道项目提供相同的后端选择，不提供含义不明确的“自动”选项：

• 直连模型：默认选择“模型连接”中的默认文本连接；列出已配置的文本模型连接，不列出仅支持图像生成的连接。
• OpenCode：使用当前 OpenCode Runtime，并动态跟随“Agent Runtime”中的全局 OpenCode 模型来源、自有配置、程序路径和服务地址。
• Continue：使用当前 Continue Runtime，并动态跟随“Agent Runtime”中的全局 Continue 模型来源、自有配置和程序路径。

选择持久化在通道项目上。旧版本保存的 auto 选择在启动时迁移为当前默认 直连文本模型。模型连接删除、改为图片模型或凭据失效后，优先修复为默认或 首个可用文本模型；没有可用文本模型时，UI 明确提示用户完成模型配置或改选 Agent Runtime。OpenCode/Continue 的通道项目只持久化 provider，旧版残留的 通道级 profileId 在修复时移除；全局 Agent Runtime 配置变更从下一条远程 请求开始生效。远程会话记录通道项目的逻辑后端选择，不复制全局配置或凭据。 Execute 启动前检查解析后的后端是否支持工具执行，并返回可处理的配置错误。

通道面板的后端说明必须明确显示“跟随 Agent Runtime 全局配置”，不得在消息 通道设置中重复展示 OpenCode/Continue 的模型来源、自有配置文件或程序路径。 “Agent Runtime > 高级设置”中的来源选项、条件配置卡和后续路径字段保持 12px 区块间距，不能出现卡片边框贴合或内容归属不清。

7.5 通道项目会话界面

通道项目是系统管理的远程消息范围，不允许创建普通本地会话：

• 切换到通道项目时，只显示由对应客户端消息创建的远程会话。
• 隐藏“新建对话”和 Ctrl+N 提示；收到全局新建会话命令时不创建记录。
• 尚无远程会话时显示等待首条客户端消息的空状态和设置入口。
• 旧版本误建在通道项目中的普通本地会话不参与通道会话列表，但保留其数据。
• 远程会话底部说明客户端联动方式，只显示历史、任务和执行结果，不再提及已移除的审批流程。
• “任务与活动”页面按会话分组显示远程任务；所有分组首次进入时默认收起，包括进行中、失败和已完成状态，用户可通过原生展开控件查看明细。

7.6 微信扫码绑定

未绑定时显示“绑定个人微信”。扫码对话框包含：

• 本地渲染的二维码。
• 扫码和手机确认步骤。
• 二维码剩余有效时间。
• 刷新和取消操作。
• 等待扫码、已扫描、需要验证码、已连接、已过期和失败状态。

二维码过期时不得继续接受旧扫码结果。

需要配对数字时，在同一对话框中显示验证码输入。验证码不得写入日志或持久化。

绑定完成后显示“重新绑定”和“断开本机绑定”。“断开本机绑定”使用共享红色 危险操作样式，并持续说明该操作只清除本机凭据、不保证解除微信服务端授权， 也不删除通道项目、远程会话、任务、活动或成果历史。

7.7 企业微信和钉钉

企业微信和钉钉继续使用现有凭据表单、环境变量只读覆盖和连接测试，但增加：

• 通道项目显示。
• 消息处理后端。
• 默认处理模式。
• 默认工作目录。
• 打开通道项目。

现有发送者白名单和群聊提及设置继续有效。

8. 远程会话需求

8.1 会话创建与复用

收到合法消息后，根据以下稳定键查找会话：

channel + accountId + externalConversationId

• 未找到时，在对应通道项目下创建远程会话。
• 已找到时继续使用现有会话。
• 微信私聊的 externalConversationId 首期可由绑定账号和发送者稳定标识组成。
• 不得仅按显示名称匹配会话。
• 消息重试不得创建重复会话或重复任务。

8.2 新建上下文

首期不提供手动“新建远程会话”入口，也不把通道项目中的全局“新建对话” 命令转为本地会话。客户端首条合法消息按稳定键自动创建远程会话，后续消息 继续复用该会话；未来如增加远程上下文重置命令，需要单独定义协议、去重和 历史保留语义。

8.3 展示

最近对话和聊天标题区显示：

• 通道图标和名称。
• 私聊用户或群聊名称。
• 当前连接状态。
• 默认模式。
• 未读状态。

每条远程消息记录实际模式：

• Ask
• Execute
• 执行中
• 已完成
• 失败

收到普通远程消息时不得强制切换当前页面。应增加未读标记和全局通知。

9. Ask 与 Execute

9.1 模式解析

每条消息的模式按以下优先级确定：

1. 显式 /ask 或“对话：”前缀使用 Ask。
2. 显式 /execute、/exec 或“执行：”前缀使用 Execute。
3. 没有前缀时使用通道项目的默认模式。

前缀仅用于选择模式，不进入发送给模型的正文。

9.2 Ask

• 在 Runtime 边界保持只读。
• 不提供工具授权回调，或所有工具请求返回拒绝。
• 不修改文件、数据库、系统状态或远程状态。
• 结果以有界文字返回原通道并写入远程会话。

9.3 Execute

Execute 消息通过身份、长度、去重和并发检查后：

1. 创建并立即启动远程执行任务。
2. 使用通道项目当前保存的逻辑处理后端；OpenCode/Continue 在此时解析“Agent Runtime”中的对应全局配置。
3. 将项目根目录作为本次 Runtime 工作目录。
4. 所选后端不支持工具执行时，不启动任务，并返回设置修复说明。

远程 Execute 不创建 GoodBuddy 通道专属请求确认或逐工具确认。安全边界由 发送者白名单、私聊限制、项目根目录、所选 Runtime、沙箱、能力开关和工具 安全策略共同提供。UI 必须持续说明该行为，不能让用户误以为仍会弹窗确认。 通道只回传最终结果或可操作的失败信息，不发送“执行已开始”等无操作价值的 中间状态消息。

9.4 工具控制

不同后端按现有行为运行：

• OpenCode 和 Continue 使用各自的工具系统、能力检查和沙箱配置。
• 直连模型只可调用已启用的内置工作区工具及已分配 MCP 工具。
• “Execute 自动授权已启用的工具”策略无需逐次确认；“禁止所有工具执行”策略拒绝所有直连模型工具调用。
• Runtime 沙箱模式继续有效。
• 任何工具结果都进入现有任务和活动审计。

9.5 结果回传

• 成功：回传有界文字结果。
• 当前任务生成的图片可以随最终结果回传；用户明确要求文件时，将当前任务的 有界文本结果生成为 Markdown 附件。
• 失败：回传经过脱敏、长度受限的用户可处理错误。
• 取消：回传“任务已取消”。
• 结果投递失败时保留发件箱记录并显示通道错误，不重复执行任务。

9.6 媒体与文件

• 单条微信消息最多接收或发送 4 个附件，解密后合计不超过 12MB。
• 入站仅处理官方图片和文件消息项。Sidecar 下载腾讯 CDN 内容并完成 AES-128-ECB 解密，Main 只接收有界字节、文件名、MIME 和大小。
• 图片进入现有视觉上下文；文本、代码、PDF 和 Office 文件进入现有不可信 文档上下文。不支持的类型显示可处理提示，不把原始 CDN 地址或密钥传给 Runtime。
• 入站附件元数据和有界预览写入远程会话，原始字节作为任务处理期间的临时上下文。
• 出站生成图片必须来自当前任务的 generated-image 事件。
• 出站文件只能由 Main 根据当前任务的最终文本结果生成，不接受 Runtime 路径， 不读取或发送任意现有工作区文件。
• 媒体发件箱在成功投递或达到重试上限后清除二进制负载。

10. 微信 ClawBot 通信架构

10.1 进程边界

微信通信运行在独立 Node Sidecar 中：

微信
  ↕ 腾讯 iLink HTTPS / CDN
微信 Sidecar
  ↕ 严格、有界、可验证的进程协议
Main ChannelDriver
  ↕
ChannelService
  ↕
GoodBuddy Runtime 与工具安全策略

禁止：

• 在 Renderer 中加载微信通信代码。
• 向 Renderer 暴露 Token、上下文令牌或原始腾讯响应。
• 把腾讯插件直接加载进 Electron Main。
• 运行 openclaw-weixin-cli 安装器。
• 仅为微信通道打包完整 OpenClaw。

10.2 Sidecar 能力

• 获取和刷新二维码。
• 轮询扫码状态。
• 提交一次性验证码。
• 加载内存中的加密解封凭据。
• 长轮询文字、图片和文件消息。
• 从腾讯 CDN 有界下载并解密图片和文件。
• 调用 getuploadurl，加密上传当前任务图片和文件，并发送媒体回复。
• 保持会话 context_token 和同步游标。
• 有界重试、退避、停止和异常退出。

10.3 协议扩展

现有 wechat-sidecar-protocol.ts 需要拆分为两个方向：

Sidecar 到 Main：

• status
• qr
• verification_required
• connected
• inbound_message，可包含有界图片或文件
• reply_result
• fatal_error

Main 到 Sidecar：

• start_login
• submit_verification
• start_account
• reply，可包含有界图片或文件
• cancel_reply
• disconnect
• shutdown

所有消息使用严格 Zod Schema、版本号、最大长度和关联 ID。协议拒绝未知字段。Token、Cookie、Session 和上下文令牌不得出现在普通状态或消息事件中。

11. 凭据与网络安全

11.1 凭据

• 微信 bot token 使用 Electron safeStorage 加密后保存在 Main 管理的设置文件。
• 上下文令牌由 Sidecar 运行时持有；如需跨重启保存，必须由 Main 加密持久化。
• 凭据不得出现在命令行参数、普通环境变量、stdout、Renderer IPC、通知或错误消息中。
• Sidecar 通过私有继承管道接收本次运行所需凭据。
• 安全存储不可用时不能完成微信绑定或启用通道。

11.2 网络

• 扫码入口固定为已审核的腾讯 HTTPS 主机。
• 服务端返回的 API 主机和重定向主机必须通过腾讯主机允许列表验证后才能携带 Token 请求。
• 不允许明文 HTTP 发送微信凭据。
• 全局“内网兼容模式”不得放宽微信凭据端点的 HTTPS 和主机验证。
• Sidecar 使用独立环境允许列表并显式启用证书验证，不继承 NODE_TLS_REJECT_UNAUTHORIZED=0、代理变量、Node 加载钩子或提供商凭据。
• 日志中的 URL 移除查询字符串，响应体对 Token 和上下文令牌脱敏。
• 媒体下载和上传只允许腾讯微信 HTTPS 主机，所有重定向逐跳重新校验。
• CDN 响应按流读取并在解密前后分别执行硬字节限制，不信任 Content-Length、 文件名、MIME、扩展名或服务端声明的原始大小。

11.3 断开与解绑

产品区分：

• 停用：停止收发，保留本地绑定凭据。
• 断开本机绑定：停止收发并清除本地凭据；入口使用红色危险操作样式。
• 微信端解除绑定：只有腾讯提供并验证服务端撤销能力后才可承诺。

当前不得把本地清除描述为“已在微信端彻底解绑”。断开后保留通道项目、 远程会话、任务、活动和成果历史。

12. 数据与契约建议

12.1 Project

为项目增加可向后兼容的来源字段：

type ProjectKind = 'user' | 'channel'
type ProjectChannel = 'weixin' | 'wecom' | 'dingtalk'

通道项目包含：

• kind: 'channel'
• channel
• runtimeSelection
• 稳定且唯一的通道绑定

现有项目迁移为 kind: 'user'。不得通过项目名称推断通道。

12.2 Conversation

增加远程会话映射，至少包含：

• conversationId
• projectId
• channel
• accountId
• externalConversationId
• conversationType
• 脱敏显示名
• 创建和最近消息时间

唯一约束：

channel + accountId + externalConversationId

12.3 Channel Settings

通道公开设置增加：

• projectId
• defaultWorkMode
• runtimeSelection
• rootPath
• status

微信私有设置增加加密字段：

• bot token
• bot/account ID
• 绑定用户 ID
• 经验证的 API base URL

Renderer 快照只返回是否已配置和脱敏标识。

12.4 任务来源

远程任务保留：

• 通道项目 ID。
• 远程会话 ID。
• 通道。
• 脱敏发送者。
• 实际工作模式。
• 实际消息处理后端。

任务队列可以复用 delegation 调度分类，但 UI 和活动审计必须依据通道项目与 远程会话持续显示真实通道来源，不得呈现为普通本地任务。

13. IPC 与 Preload

建议增加窄接口：

• 获取通道设置快照。
• 保存通道项目配置。
• 开始微信扫码。
• 刷新微信扫码。
• 提交微信验证码。
• 断开微信本地连接。
• 订阅微信连接状态。
• 打开对应通道项目。

所有 IPC：

• 使用共享 Zod Schema 验证。
• 验证可信 Renderer sender。
• 不接收 Renderer 提供的项目类型或通道身份作为可信事实。
• 不返回凭据。

14. 关键异常流程

14.1 项目重名

存在名为“微信 ClawBot”的普通项目时，仍创建独立通道项目，并通过通道类型而非名称识别。UI 可以显示同名，但必须有“远程通道”分组和微信徽标。

14.2 通道项目缺失

如果数据库异常或旧版本操作导致绑定项目缺失，Main 初始化时重新创建并修复设置引用。历史会话无法安全迁移时保留原归属并给出诊断，不静默丢弃。

14.3 连接中退出

• 取消二维码轮询。
• 清除内存验证码。
• 停止 Sidecar。
• 不保存未确认凭据。

14.4 执行期间断线

通道断开后不得启动新的 Execute。已开始的任务按现有取消策略处理，结果进入本地审计；恢复连接后不得自动重复执行。

14.5 重复消息

使用稳定平台消息 ID 去重。平台消息 ID 缺失时，使用账号、会话、发送者、时间和内容摘要构造有界稳定键。任务创建和回复必须共用同一个去重声明。

15. 可访问性与响应式

• 通道状态同时使用文字和图标。
• 三个通道使用共享 PageTabs 的 segmented 外观，保留页签语义和方向键切换。
• 模式选择使用语义化单选/分段控件和方向键。
• 消息处理后端使用持久标签和分组选项，并说明当前选择的实际行为。
• 二维码提供状态文字和备用刷新操作，但不把敏感二维码链接作为可复制文本。
• 验证码错误与输入框建立 aria-describedby 关联。
• 关闭对话框后焦点返回触发按钮。
• 窄窗口下卡片单列，二维码对话框保留 16px 外边距。
• 浅色、深色和 200% 文字缩放下可完成绑定、后端选择和保存。

16. 验收标准

16.1 通道项目

• 新安装首次启动后存在微信 ClawBot、企业微信和钉钉三个通道项目。
• 重启应用不会重复创建通道项目。
• 同名普通项目不会被占用或修改。
• 通道项目默认根目录为当前用户目录，默认模式为 Ask。
• 通道项目在项目选择器的“远程通道”分组中显示。
• 停用或断开通道不会删除项目和历史。
• 普通项目删除流程不能永久删除通道项目。

16.2 设置卡片

• 设置标签显示为“消息通道”。
• 三个通道使用与模型设置一致的分段外观页签，并保留完整页签键盘语义。
• 三个面板均显示项目、根目录、消息处理后端、默认模式和连接状态。
• 微信卡片可以完成扫码、过期刷新、验证码和连接状态展示。
• “断开本机绑定”使用共享红色危险操作样式，并明确说明只清除本机凭据、不删除历史或承诺服务端解绑。
• 不显示“自动”后端；首次创建和旧版 auto 配置均落到默认直连文本模型。
• 直连模型只列出文本连接，OpenCode 与 Continue 可直接选择。
• 选择 OpenCode/Continue 时只保存 Runtime 类型，每次远程请求动态跟随“Agent Runtime”中的对应全局配置，通道页不出现第二套 Runtime 配置。
• Agent Runtime 高级设置的来源选项、条件配置卡和路径字段之间保持 12px 间距且无横向溢出。
• 默认 Execute 时持续显示目录范围和无逐次确认的风险说明。
• Renderer 无法读取任何微信 Token 或上下文令牌。

16.3 会话

• 不同通道的消息进入不同通道项目。
• 不同发送者或群聊进入独立远程会话。
• 重复平台事件不会创建重复会话、消息或任务。
• 最近对话、聊天标题和消息均能识别通道与发送者。
• 收到普通消息不会强制切换当前页面。
• 切换到通道项目不会创建普通本地会话。
• 通道项目隐藏“新建对话”和 Ctrl+N，全局快捷命令也不创建会话。
• 没有远程会话时显示等待客户端首条消息的空状态。
• “任务与活动”中的会话分组默认收起，进行中、失败和已完成状态行为一致。
• 微信图片和文件显示在对应远程消息中，附件消息无需附带文字。
• 支持的附件进入所选后端现有图片或文档上下文；不支持和超限附件返回明确提示。

16.4 Ask

• 普通消息默认按卡片配置进入 Ask。
• Ask 在 Runtime 边界拒绝所有工具。
• 有界结果回传原通道并写入远程会话。

16.5 Execute

• 默认 Execute 或显式执行前缀会立即使用通道项目所选后端。
• 不显示通道专属请求级或逐工具确认。
• 直连模型、OpenCode 和 Continue 均按各自能力正确路由。
• 通道不发送“执行已开始”等中间占位消息，只发送最终结果或可操作失败。
• 任务使用对应通道项目根目录。
• Runtime、沙箱、能力和直连模型工具安全策略继续生效。
• 任务、活动、工具、成果和最终结果关联到通道项目与远程会话。

16.6 生命周期与安全

• Sidecar 异常退出不会导致 Main 崩溃，并有有界重启限制。
• 应用退出会取消长轮询并停止 Sidecar。
• 微信凭据使用系统安全存储加密。
• 任何普通日志、IPC、错误和通知中不存在凭据。
• Token 只发送到已审核的腾讯 HTTPS 主机。
• CDN 下载、上传和每次重定向只访问腾讯微信 HTTPS 主机。
• 入站和出站媒体最多 4 个、合计不超过 12MB，AES 密钥和 CDN URL 不跨越 Sidecar 边界。
• 只有当前任务生成图片或 Main 从本次最终文本生成的文件可以作为出站附件。

17. 实施阶段

阶段一：通道项目基础

• Project 数据迁移与通道类型。
• 三个通道项目幂等创建。
• 项目选择器“远程通道”分组。
• 三张设置卡片接入项目、目录和模式配置。
• 企业微信、钉钉消息建立独立远程会话。

阶段二：微信文字通道

• 微信 iLink Sidecar。
• 扫码、验证码、加密凭据和生命周期。
• 微信文字收发与稳定去重。
• 微信远程会话。
• Ask 模式。

阶段三：受控 Execute

• 通道项目处理后端选择与失效修复。
• OpenCode/Continue 通道后端动态跟随全局 Agent Runtime 配置。
• Execute Runtime 接入。
• 直连模型工具安全策略和活动关联。
• 结果回传、取消、超时和失败恢复。

阶段四：微信媒体

• 图片和文件 CDN 下载、AES 解密与有界上下文。
• 生成图片和 Main 生成的任务结果文件加密上传与回复。
• 远程会话附件展示和媒体发件箱清理。

阶段五：后续扩展

• 有界语音和视频。
• 多微信账号。
• 更细的项目路由。
• 已验证的微信端解除绑定。

18. 测试要求

至少覆盖：

• 数据迁移和通道项目幂等创建。
• 同名普通项目隔离。
• 设置 Schema 与 Renderer 脱敏快照。
• QR 状态机、过期、验证码和非法转换。
• Sidecar 双向协议未知字段、超长字段和凭据泄漏拒绝。
• 腾讯主机允许列表和重定向校验。
• CDN 媒体 AES 加解密、流式大小限制、声明大小校验和恶意重定向拒绝。
• 附件持久化展示、现有上下文接入、生成图片回传和任务成果目录隔离。
• 消息去重、会话映射、并发和取消。
• Ask 工具拒绝。
• Execute 使用直连模型、OpenCode 和 Continue 的路由。
• OpenCode/Continue 通道只保存 Runtime 类型，并在 Ask 与 Execute 开始时解析当前全局 Agent Runtime 配置。
• Execute 不创建通道专属审批，直连模型禁止工具策略仍然生效。
• 模型连接删除后的通道后端选择修复。
• 发件箱投递失败不重复执行。
• 项目选择器、分段页签、后端选择、设置面板和扫码对话框的键盘与无障碍行为。
• Runtime 高级设置区块间距、微信断开危险按钮和任务活动默认折叠的 UI 回归。
• Windows、macOS、Linux 的默认用户目录和 Sidecar 关闭行为。

实现完成后运行：

npm test
npm run typecheck
npm run lint
npm run build

19. 发布条件

满足以下条件后才可默认向用户提供微信 Execute：

1. 微信文字 Ask 全流程稳定。
2. UI 明确说明远程 Execute 会立即运行，且默认工作目录和处理后端始终可见。
3. 凭据不会进入 Renderer、日志或普通子进程参数。
4. Sidecar 网络目标和重定向已实施严格允许列表。
5. 通道项目和远程会话的来源标识在所有入口持续可见。
6. 任务重复投递不会导致重复执行。
7. 应用退出、断线和更新过程中不会留下失控执行，直连模型禁止工具策略不能被远程来源绕过。
8. 腾讯 iLink 独立宿主使用范围和本地断开语义已完成发布前确认。