WeClaw v2.0.0

WeClaw 2.0.0 将微信桥接重构为 Codex 专用程序。Python 后端通过异步 stdio JSON-RPC 连接官方 Codex App Server，本地管理页面使用 Vue 3、TypeScript 和腾讯 TDesign。微信侧按腾讯官方 iLink 协议实现，账号、会话、任务和审批共用持久化状态。

本版内容

• 固定官方运行时 openai-codex-cli-bin==0.162.1，移除 codex exec 执行链、第三方 Agent 和通用路由；保留桥接启动、停止、状态、登录、发送与迁移命令。
• 管理页面提供微信账号、持续聊天、执行计划与输出、文件差异、任务中断与追加指令、审批追问、模型、Skills 和 MCP 状态。
• 保存官方 thread ID 和历史归属，支持恢复、命名、分叉、归档及上下文压缩；任务按线程排队，结果以官方完成事件为准。
• 审批答复绑定 Bot、用户、线程与请求编号；非法权限响应不能抢占请求，重复和过期答复不再提交。
• 消息和同步游标同事务落盘，持久化去重和回复上下文；结果不明的任务暂停核对，不自动重复执行。
• 图片使用原生 Codex 图片输入；文件和视频保留为附件。图文拆分配对、图片/文件回传及授权路径检查已接入。
• 默认保留腾讯官方支持的部分 Markdown，无需开关。模型、历史和主动文字统一过滤一次；图片单独回传，代码围栏示例不上传。
• 本地认证、来源校验、登记附件 ID、路径/网络/大小限制和日志脱敏；新发行包不包含旧 Go 二进制、本地审计日志或运行凭证。

升级须知

这是一次主要版本迁移。源码开发需要 Python 3.13、uv 和 Node.js 24；发行物为 Python wheel、源码包和 checksums.txt。官方 Codex 运行时由依赖自动提供，不需要全局 npm Codex 安装。

新状态目录为 ~/.weclaw/v2。先使用迁移命令备份和导入旧配置、账号凭证、同步游标与线程映射，再在页面选择旧线程对应的 Bot。相同账号所有者不能代替 Bot 归属确认。原状态、旧安装和官方 Codex 历史保留用于回退。

start 在前台运行，默认关闭微信轮询；真实收发使用 start --wechat。正式切换前必须停止旧轮询者，确保同一 Bot 只有一个消费者。Windows 安装和任务计划切换是独立步骤，详见 安装与迁移说明 和 切换／回退说明。

模型与认证继续由官方 CODEX_HOME 管理。兼容默认保留 danger-full-access 与 approval_policy=never，执行拥有当前用户的文件与命令权限；启用微信前应核对接入用户，需要审批时调整对应线程策略。

/api/send 需要管理员认证和有效会话上下文，多账号有歧义时必须指定 account_id；图片使用 media_url。旧无鉴权接口和 Go 自动更新程序不再适用于新版。

验证记录

• 本地 Python 184 项通过、1 项跳过，Ruff 通过；跳过项为 Windows 当前用户无权创建符号链接。
• 前端 15 项单元测试、14 项桌面／窄屏浏览器测试，类型检查与构建通过。
• wheel/sdist、实际安装文件 SHA-256 和 Docker 初次切换构建检查通过。发布工作流会重新执行检查并生成发行物，托管运行结果见 GitHub Actions。
• Markdown 的 1,148 个输入与腾讯官方算法文字结果一致，13 项独立离线集成检查覆盖一次过滤、分块、空正文和媒体边界。
• 真实 App Server 问答、旧线程恢复、重启续聊、隔离目录写入及临时审批批准／拒绝已验证。
• 微信原线程文字续聊、PNG/TXT 回传、TXT 入站读取和图文配对后的左右颜色识别复测已取得实际界面证据；任务计划启动后的文字执行已验证。
• Markdown 主动发送已确认 HTTP 成功、outbox 已发送和正文保留；微信界面的逐项渲染检查因用户停止 Computer Use 而未完成。

已知限制

• 验收环境中的第二个 Bot 凭证失效且已暂停，尚未完成两个 Bot 同时业务验收。
• 长文字过滤后每 3,500 字符分块，不丢字符；跨消息代码围栏暂不自动补闭合。不同微信客户端的显示能力可能不同。
• Skills、MCP 的认证／表单／工具执行和全部审查目标未逐一业务验收；状态发现不等于工具执行成功。
• 真实语音和视频收发未完整验收；视频仅作为附件，不声明模型原生视频理解。
• 早先一次图片任务出现上游响应流中断，后续复测成功不等于已证明瞬态问题永久消除。

更细的协议来源和能力边界见 官方功能对照 与 验证记录。