12 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	353293e807	feat(im): 主动消息「没送达微信」现在说得清（原因码 + 三处可见） ... 主人原话：「可以，这有必要，不然我老是收不到」。真机日志： `backthink IM push failed … weixin_ilink: proactive push outside 24h window` —— 她的话**送进了 Web 活跃客户端，但没送进微信**，原因是**平台规则**（微信 iLink 只允许用户最后一条消息后 24h 窗口内主动推送），不是崩溃。 本片只做「如实说清」，不绕规则： - **原因码**：新增契约层分类件 `internal/channel/adapter/delivery.go` （`DeliveryCategory` + 4 个码 + 可选自描述接口 `DeliveryFailure` / 读取函数）， **沿用**既有 voice `Category(err)` 与 `SystemNoticeNormalizer` 的范式，**不造第二套枚举**； 平台码由产生错误的层声明：`weixin_ilink` 的 `ErrProactiveWindow` 自报 `proactive_window_closed`（哨兵文本与 `errors.Is` 判定**逐字未变**）。 - **三处可见**：① 结构化 WARN（补齐 category/channel/platform/route）； ② 审计 `backthink.push.im_undelivered`（与 `backthink.self_wake.*` 同族）； ③ 推送结果 `Detail` 追加稳定标签 `im_undelivered=<渠道>:<原因码>` —— 面板**已在 渲染 Detail**（`Backthink.tsx:185`）⇒ 主人现在就能看到，**无需改前端**。 - **不丢消息**：IM 路失败照旧走活跃客户端路，且**只在 Web 真送达时** `pushed=true`； 有测试钉住「IM 失败不影响另一条路」（同一条消息没被丢）。 - **不做的**：不重试刷屏、不换渠道冒充微信、不伪造送达、不新增 `.env` 键。 验收（主会话复跑 + 亲自变异）：**整树 `go build ./...` 通过**；4 个包 vet/测试全绿； 我用 -overlay 把 `ErrProactiveWindow` 退成裸 `errors.New` ⇒ weixin 包两条用例变红 （`category = "failed", want proactive_window_closed`），channelbridge/backthink 亦红。 ⚠️ 未落地的建议（已登记，未硬改）：给她的"推送回执"（`backthink_records` 加 `push_category`/`push_channel` 两列 + 下一轮注入只读一行）与面板结构化徽标 —— 红线：回执只能用来换渠道/换措辞/等窗口，**不得演变成绕平台规则**。	2026-10-07 10:59:22 +08:00
AskaEth	7505c46b70	feat(channel): 微信 iLink 账号状态三态（诚实口径） ... state ∈ 有效 / **被拒（需重扫）** / 未知；🔴 -14 是**被拒不是过期**，且**未知原因绝不 写成「过期」**（面板文案与错误码都如实）。三态判定为纯函数 + 三态各有用例。 ⚠️ 未做（如实登记）： 三态（每账号逐条三态）本片未做。	2026-10-06 09:03:44 +08:00
AskaEth	e792baa316	docs(channels): 修正 6 处指向已不存在 design/08 节号的注释（只改注释）	2026-10-05 11:29:54 +08:00
AskaEth	f8f2e9c54c	feat(weixin_ilink): 出站媒体走通（主人已批的三项） ... 按官方包 @tencent-weixin/openclaw-weixin 2.4.9 源码对齐： ① 上传由 PUT 改 POST；② 上传凭据读响应头 x-encrypted-param； ③ nativeMediaItem 改为官方 *_item.media.encrypt_query_param 嵌套形状（含 aes_key， 图片优先 image_item.aeskey）。 配合前一版已修的两点（入站按条密钥、媒体失败不阻断文本），机器人现在可主动发出文件/图片。 （逐项测试、变异红行与诚实边界见该切片报告）	2026-10-05 08:04:50 +08:00
AskaEth	6cb41a8794	fix(weixin_ilink): 入站按条密钥 + 出站上传地址（真机双 bug） ... Bug A（入站取不到字节）真因两层：① 引用位置错——真实在 `file_item.media.encrypt_query_param`，旧 mediaOf 只扫平铺 url/cdn_url； ② 密钥来源错——官方口径是**随每条附件下发**的 `*_item.media.aes_key` （图片优先 `image_item.aeskey`），旧代码却把整个 bot_token 当 base64 取尾 16 字节， 而真机 token 形如 `<id>@im.bot:<38hex>`，第 12 字符 `@` 处即非法。 （对照证据：官方包 @tencent-weixin/openclaw-weixin 2.4.9 源码，只读未入库； design/08 §3.3 的「token base64 尾 16 字节」据此判定为错误口径，待文档更正。） Bug B（出站）：① sendToOne 遇媒体构建失败直接 return ⇒ 连文本一起丢（改为逐条跳过 + 带来源 WARN；全部媒体失败仍发文本，无文本且全挂才诚实报错）；② getUploadURL 发空 body 且只认 4 个猜测键 ⇒ 补齐官方请求体字段 + 依次认 upload_full_url / upload_param。 测试：media_key_test（6 条，真机形态夹具 + 转义钉住）+ send_media_failure_test（6 条）。 变异 6 条（M-A1/A2/A3/B1/B3a/B3b）均先确认变异体可编译、贴红行、还原复绿。 诚实边界：出站媒体**仍发不出去**（PUT vs 官方 POST、响应头 x-encrypted-param、 nativeMediaItem 嵌套形状三项未做）—— 故意只修到「拿到上传地址」，不扩大切片。	2026-10-04 22:33:41 +08:00
AskaEth	95f97f5df3	docs(comments): 注释中文化 · plugins/channels/weixin_ilink（20 文件，纯替换） ... - 只翻注释/文档字符串：剥掉行尾注释后，每条「-」都有逐字节相同的「+」对应行（8 组，代码零改动） - 保留协议/线上标识符原文：errcode、bot_token、context_token、getupdates、binded_redirect、PKCS#7、ECB 等 - 术语对齐既有译法：owner→主人、peer→对端、long poll→长轮询、backoff→退避、sentinel error→哨兵错误 - 已知既有欠债（未顺手修）：login_reuse_test.go 在 HEAD 上就未 gofmt 干净；login_test.go 的 TestStartLogin_ScanStatusTransition 91 行 >80（HEAD 同为 91 行）	2026-10-04 12:29:05 +08:00
AskaEth	a51aadeef4	refactor(weixin-ilink): 措辞纠正 —「会话过期」→「会话被 iLink 拒绝」（零逻辑改动） ... 事实（主人 2026-10-03 确认）：iLink 的 bot token 是长期凭据（一个月前扫码的仍可用）；errcode=-14 是 iLink 侧拒绝/作废该会话，不是时间性过期；且至今未观测到真实 -14（当日全部日志 0 次）。此前代码把这些写成「过期」，属沿用的旧命名，现纠正。 - 纯改名/文案：ErrSessionExpired→ErrSessionRejected、errSessionExpired→errcodeSessionRejected、expired/expiredToken→rejected/rejectedToken、markExpired/expiredLocked/expiredState→markRejected/rejectedLocked/rejectedState；409 错误码 session_expired→session_rejected - 行为一字未改：显式标记 / Connect 不假 OK / 面板 needsRescan+lastError / 扫码或换新 token 即清除 全部保留 - 微信协议自身的「二维码过期」与 auth 的 JWT/refresh 过期一律未动（那些是真·时间性过期） - Docs/api-client v0.39 补事实说明；顺手收尾 3 处残留注释（admin.go / channelbridge/inbound.go / readloop_test.go）	2026-10-03 18:26:27 +08:00
AskaEth	cdc370dc82	feat(weixin-ilink,gateway): 会话过期显式化 — 不再静默变哑/假 OK 重连，面板可见「需重扫」 ... - 适配器新增过期状态机(plugins/channels/weixin_ilink/session_state.go)：getupdates/sendmessage/getuploadurl 收到 errcode=-14 即 markExpired（ERROR 仅一次，只带 bot_id，token 永不入日志），扫码登录拿到新 token 或配置换新 token 时清除（惰性比对） - Connect/HealthCheck 在过期时返回 ErrSessionExpired（可与 ErrNotConnected 区分）：不再对死 token 设 connected=true 报假成功；发送路径同样返回该错误而不是笼统 ErrNotConnected - 网关：POST /admin/channels/open 遇过期 → 409 session_expired + 明确文案（不再吞错回 200）；GET /admin/channels 摘要新增 needsRescan/lastError（经可选接口类型断言读取，取不到不伪造） - channelbridge：读循环非取消退出时把自身记账的 connected 置 false（热重载被替换者退出不抹掉新实例） - login/login_admin：过期时 StartLogin 允许重新出码、LoginStatus 如实报 failed（原先可能把死 token 当 confirmed 重新落盘） - Docs/api-client v0.39；新增 5 组测试 + 变异验证（去掉标记/恢复假成功/网关不填字段 均 FAIL）	2026-10-03 18:00:01 +08:00
Aska	f5950e4bde	feat(weixin_ilink): 扫码协议与腾讯官方对齐——POST local_token_list + iLink-App-Id/ClientVersion 头 + need_verifycode/redirect 状态机	2026-09-07 22:49:25 +08:00
Aska	3f2c981cf8	fix(weixin): 空token''连接''不再阻塞+409请先扫码登录；Connect空token返回ErrNeedsLogin ... 面板点''连接''此前触发阻塞式扫码(最长8min)不展示二维码→挂起。修: - weixin adapter Connect: 空token返回 ErrNeedsLogin(非阻塞), 扫码走独立 login-qr/login-status - adminChannelOpen: errors.Is(ErrNeedsLogin)→409'该渠道尚未登录:请先扫码登录再连接'(不再500/挂起) - login_test.go 改用 StartLogin/LoginStatus 驱动(与旧Connect阻塞行为解耦) build/vet/test 全绿, 已部署.	2026-09-07 21:06:10 +08:00
Aska	e037fab7d0	feat(weixin): 微信iLink扫码登录——面板触发+二维码显示+状态轮询+确认热连接 ... 适配器: login_admin.go(StartLogin 幂等取二维码/LoginStatus idle-waiting-confirmed-failed); login.go 重写 Connect 委托 StartLogin+等待,后台 runLogin 轮询,completeLogin/failLogin (锁序 loginMu->a.mu 不嵌套反向无死锁); adapter.go 加登录会话字段 网关: admin_channels_weixin.go(2 端点 login-qr/login-status owner+审计, confirmed 合并写回 channels.json 保留 base_url/cdn/黑白名单 + Reload 热重载连接; qrImage best-effort Base64, token 掩码) + server.go 路由 前端: WeixinLogin.tsx(token空→扫码按钮→二维码→1.5s轮询→confirmed提示已登录+显示bot_id), AdapterDetailPage 渲染, api/types 补类型 必需偏离(最小化): 允许空token的weixin账号被构建/持久化(channels.go+runtimeconfig移出 tokenRequiringPlatforms),否则空token账号无法注册调用StartLogin; 空token保持断开(configured 仍要求token非空),确认后才持久化连接——守红线。 测试: login_admin/admin端点用例; 后端 build/vet/test 全绿 + 前端 build 101模块绿.	2026-09-07 20:50:28 +08:00
Aska	88dc12466d	feat(channels/weixin_ilink): 微信 iLink 渠道插件（扫码登录+长轮询+游标+context_token+AES-128-ECB 媒体+24h 主动推送窗口）	2026-09-06 06:49:35 +08:00