49 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	4b4173dd42	fix(channel): M41 r1 复审三条 —— telegram 构造分支、QQ 改 MaskQuery、删两处死上限 ... P2-1 telegram doJSON 的**请求构造**失败分支：http.NewRequestWithContext 解析失败的 err 同样是 *url.Error（里面是整条 /bot<token>/… 地址），而 poll.go 的 long poll failed 会原样落日志。改成与传输层分支同形：trace.HostOf(endpoint) + callCause。 P2-2 qq_obv11 connectClient 的成功 INFO 从 maskAccessTokenQuery 换成 trace.MaskQuery：后者认得 access%5Ftoken / token / api_key / 签名参数 / userinfo， 且保留 EscapedPath（路径可读）与不截断。maskAccessTokenQuery 仍被 sanitizeConnectReason 使用，未成死代码。 P2-3 删掉 maxEnvelopeMessageRunes / maxDescriptionRunes（各 200）：trace.RedactText 内部已 truncate 到 maxSummaryRunes=80，这两层永不命中，注释口径与实际不符。改为 直接 return trace.RedactText(压平空白)，注释写明 80 rune 由 RedactText 负责。 用例（全部变异打红，逐条验证）：telegram 构造分支 token、QQ 八形态凭据矩阵 （含四种 maskAccessTokenQuery 漏掉的形态 + 路径可读反向断言）、两处 80 rune 上限。	2026-10-26 13:58:19 +08:00
AskaEth	0f9251b983	fix(channel): 渠道适配器与出站工具的上游响应体/带凭据 URL 不再进日志与错误（M41） ... 接 M38 的 18 条真泄漏里「渠道适配器 + 出站工具」这一族（#10 #11 #12 #13 #15 #16）。 只动日志与 error 文字：发送/接收、解析口径、重试次数一个都没改。 - httpclient.do：非 2xx 不再把 512B 响应体原文拼进 error，改 trace.UpstreamError （状态/体积/sha256 前缀）+ 信封 code/message（RedactText + 200 rune）；error 里的 target 改 trace.HostOf，并剥掉 *url.Error 外壳（它带整条地址） - telegram doJSON：4xx 只解 error_code/description（清洗 + 截断），体其余字段不拼； 传输错误只留来源 —— Bot API 把 token 写在地址路径里 - weixin_ilink doJSON：4096B 体 ⇒ trace.UpstreamError，rawURL ⇒ mediafetch.HostOf； uploadOnce 剥掉预签名上传地址（encrypted_query_param），重试日志补来源主机 - qq_obv11 connectClient 成功 INFO：改走同包已有的 maskAccessTokenQuery （OneBot 惯例把 ?access_token= 写进 remote_url） - plugins/tools/io http 拦截日志：改记 trace.HostOf + 原因码，不记原 URL、也不记错误 原文（解析失败时它包着 *url.Error） 每条都有能变异打红的用例：QQ/iLink 预签名地址的哨兵、三处 4xx 体哨兵、 user:pass@ 与 query 凭据；八处变异逐条验证变红。	2026-10-26 13:47:56 +08:00
AskaEth	b504df01e0	feat(channel): 出站消息 id 采集（可选 seam + qq_obv11 两分支取回） ... 「接她的话」缺的 A 层：平台给她自己那条出站消息分配的 id，此前在解析的那一刻 就被丢掉（HTTP 只校 retcode、WS 写完不等回声、契约层没有 id 出口）。 - internal/channel/adapter/outbound.go（新）：SendReceipt/SendOutcome/SendIDStatus + 可选接口 OutboundReceiptAdapter + 调用方入口 SendWithReceipt。**不加进 PlatformAdapter** —— 四个未接线适配器与全部桩实现一行不改（向后兼容硬指标）； 也不用回调：id 是某一次投递的属性，必须随那次投递返回。 - qq_obv11：HTTP 从响应信封 data.message_id 取；WS 登记 send_msg 的 echo 等待者 （复用 probe.go 的 action 等待表与 routeActionResponse，不另开通道）。取不到 一律空 id + 三态可分辨（reported/absent/unreported），绝不编造。 - send_msg echo 键改用单调计数器（旧 UnixNano 在 Windows 时钟粒度下会撞键， 撞键即拿不到自己的回执）。 - 既有 SendMessage/SendProactive 路径行为不变（wantReceipt=false 不等待）。 验收：go build ./... + go vet ./... + go test ./... 全绿（cmd/cyrene、internal/webui 的 setup 失败是 worktree 缺 dist 的既有环境限制，base 同样失败）。	2026-10-13 20:38:12 +08:00
AskaEth	b26bc55a15	feat(channel): 消息契约加「她自己账号 id / 是否在叫她」结构化判据并接线 qq_obv11 ... 契约（internal/channel/adapter）：UnifiedMessage 新增三个字段 —— SelfID（她自己在该 平台的账号 id）、MentionAll（是否 @全体，design/26 §2.4 的 mention_all）、AddressedToMe （本条是否指向她本人）；判据的唯一出处是新增的 MentionedSelf（结构化 id 精确比对， 空 selfID 一律 false）与 AddressedToSelf（私聊恒 true；群聊 = 点名她或 @全体； 平台未给 SelfID ⇒ fail-closed）。全程不匹配正文文本。 接线（plugins/channels/qq_obv11）：新增 addressed.go，把事件里早已解出、此前只用于 debug 日志与 notice 判定的 self_id 接进 toUnified，并从 at 段解出 @全体（qq=all）， 在 ChannelType 判定之后统一回写三个字段。 design/18 §2 触发① 的旧口径「Mentions 非空」= @谁不论（实测群 672432767 里 @别人两次 被回）；本片让消费侧（light.go:142，归 M12）能改用 AddressedToMe || MentionAll。 既有字段 Mentions/ReplyToID/ReplyToText 语义与形状不变。 测试：qq_obv11 十种帧形态（私聊/@她/@别人/@全体/无@/CQ 形态/fail-closed/纯回复） 逐条断言；adapter 侧覆盖 MentionedSelf 与 AddressedToSelf。变异自证：判据改回 「Mentions 非空」⇒ group_mention_other 红；摘掉 selfId 接线 ⇒ group_mention_me 红。	2026-10-13 20:17:56 +08:00
AskaEth	b4d55f412e	fix(channel): 连接动作不再乐观 —— 适配器自报连接态三态 + 面板如实呈现 ... 根因：adminChannelOpen 在 ch.Connect 返回 nil 后硬编码 connected=true。而 Connect 返回 nil 只说明「这次调用没有致命失败」—— ws+client 首连失败刻意非致命（OneBot 实现可能比 Cyrene 后启动），ws+server 则只需监听就绪，两种情况 IsConnected() 都是 false。前端又只按「请求成功」写死「已连接」，于是管理面把「后端受理了」说成「渠道连上了」。 改法：三态口径落在适配器自己身上（connected/pending/ready，internal/channel/adapter 的纯函数 ConnectStateOf 判定 + ConnectSignals 结构化入参，避免两个 bool 接反），qq_obv11 实现 ConnectOutcome 并记住脱敏后的失败原因；网关经类型断言探测（与 accountStatusAware/rescanAware 同套路，核心 sdk.Channel 契约刻意不扩展），只做映射不猜 transport/mode。 线上投影：open/close 响应与 GET /admin/channels 的平台行/账号行各新增 pending/ready/reason 三个可选键（零值即整键缺席，同 NeedsRescan/LastError 口径）；既有四键逐字不变，未实现该状态面的平台输出逐字节不变。close 报真实 IsConnected()，断开也不乐观。 凭据边界：reason 三层脱敏（形状级 → 已知明文替换 → 剥 access_token= 查询参数），日志同样只用脱敏串。 验收：主会话亲自复跑 go build/vet 全绿、全树 go test 无 FAIL、目标三包 test 全绿、前端 tsc --noEmit 干净、esbuild 逻辑测试 34+46 checks 全过；主会话亲自变异摘掉第 3 层脱敏实现，发现原两条脱敏用例其实钉不住它（值恰好等于已知明文/被形状级顺带吃掉）⇒ 补一条钉住它独有窗口的用例（短值+紧邻空白），变异下必红、还原后绿。	2026-10-13 19:38:56 +08:00
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	ba17820040	feat(channels): QQ 非消息事件全枚举投递 + systemnotice 补 request/interaction/unknown 类 ... - 适配器不再整类丢弃：notice/request/meta_event/message_sent/未知 post_type/JSON 解析失败( decode_error ) 一律归一化投递并留痕 - notice 映射补 group_ban/sub_type 全枚举，未知类型走 NoticeUnknown 兜底（fail-safe 只登记、绝不猜、绝不放行） - 不投影 flag/comment/file/duration；归一化 DEBUG 只记结构（脱敏，变异实测可打红） - 传输层端到端已覆盖（真实 http+server 上报路径：加好友请求/心跳/未知类型） - ⚠️ 主人 2026-10-05 决定「先不连 QQ」（风控）⇒ 本片为通用红线（绝不静默丢弃）+ 现成证据链，QQ 侧后续增量工作暂停	2026-10-05 13:47:27 +08:00
AskaEth	b82870f41e	fix(channels): QQ 适配器接上注入 logger（帧取证复活）+ 兜底不再静默降级（Warn 说明 Debug 会被丢）	2026-10-05 12:53:17 +08:00
AskaEth	e1bd7c3009	fix(channels): 探活失败不再静默 + 回执信封校验（杜绝把失败谎报成账号离线）+ echo 唯一化	2026-10-05 12:29:34 +08:00
AskaEth	a79fe9684e	feat(channels): QQ 账号 get_status 主动探活（复用既有 action 通道 / 状态变化才记日志 / AccountStatus 与 WS 连通分开）	2026-10-05 12:10:34 +08:00
AskaEth	f44114301e	feat(channels): 微信入站媒体脱敏取证日志（形状行记 ref 来源+host、结局行记 err_kind；不记 URL/query/密钥）	2026-10-05 12:07:18 +08:00
AskaEth	5139945bfe	feat(channels): 非消息事件接入（notice 归一化 + 传入前审查，fail-safe 静默）与入站脱敏帧日志/日志轮转 ... - notice：adapter 归一化 seam + 结构化分类 + 净化（ANSI/控制/零宽/双向字符、200 runes 截断） + fail-safe 写死为「静默」（未装配审查/超时/失败 ⇒ 仅登记、不驱动 loop） - 身份面零改动：notice 发送者恒 RoleSystem + SenderID=system - 复用策略四的同一个审查模型（Options.Review），未另造第二套 - 入站帧脱敏 DEBUG（post_type/message_type/sub_type/self_id/user_id/sender_id/group_id/段类型/at 目标） - ctrl.bat 启动前归档轮转（保留 20 份）+ bash 侧改追加（不再重启即截断）	2026-10-05 11:55:05 +08:00
AskaEth	2b6750b821	docs(channels): 再修 3 处注释里的 design/08 引用（其中 -14 口径无对应节 ⇒ 改指对照清单）	2026-10-05 11:31:14 +08:00
AskaEth	e792baa316	docs(channels): 修正 6 处指向已不存在 design/08 节号的注释（只改注释）	2026-10-05 11:29:54 +08:00
AskaEth	e852e60af9	docs(channels): media_key 注释指向修正（design/08 §3.3 已不存在 → §4 weixin-ilink 条目）	2026-10-05 11:26:02 +08:00
AskaEth	b73a1276c6	feat(channels): IM 入站图片接线（纯图片不再被丢 / data URI 进模型视图 / 诚实提示 / 来源白名单）	2026-10-05 11:22:26 +08:00
AskaEth	6a545badbd	feat(channels): IM 入站图片采集层（图片白名单 + 微信图片来源 + 复用 vision 内联入口） ... - mediafetch 新增**图片白名单**（扩展名 + **字节嗅探兜底**；与文档/音频**三份名单互不污染**）， 取回/裁决/上限全部走既有 Fetch（**来源白名单 deny-by-default** + 逐跳重定向校验 + 边读边限 + 超时） ⇒ 没有新造第四份取回实现 - 微信：给图片 URL 配来源白名单（沿用该渠道 CDN 根口径） - vision 的 `data:` URI 内联入口为**只读复用**（未改 vision 一行） - **行为变更**：图片现在**会**被尝试取回（**字节嗅探是唯一裁决权** —— 不是图片字节就不写 `Data`）； 其它渠道尚无图片来源白名单 ⇒ 由 deny-by-default 拒绝（**安全**，只是暂读不到，走诚实降级）—— 故同步更新了 kook 的既有测试（原断言「图片保持既有路径 = 不取回」已随口径演进） - ⚠️ **`channelbridge` 一个字没碰**（接线点在切片报告 §7），等监工接线 + 补其它渠道白名单 - 测试：3 个新文件；变异 5 条	2026-10-05 11:04:41 +08:00
AskaEth	d532eb3fcd	fix(session,qq-obv11): 修「判主好了、会话车道没跟上」（QQ 私聊没镜像进主会话） ... 真因（agent-221 用三条独立证据推翻了「SenderID 为空」的假设）：ev.UserID 有值； owner.yaml 的 qq 条目是 10:37:57 才加的（此前那几条判陌生人属**正确的 fail-closed**）； 而热重载成功后仍不对 —— 因为 internal/channel/session/manager.go 的 GetOrCreate 对**已绑定的渠道直接返回缓存会话**：判主门槛用新 actor 会过（所以她会回话）， 但**车道用的是缓存的旧会话**（Owner=false ⇒ 不镜像进 Web 主会话、MemWritable=false、 落盘 actor_role 永不更新）。 修：缓存命中但 ActorRole 与本次解析不一致 ⇒ rebindLocked 刷新车道 + 同步落盘 （updateActorRoleSQL）；persist 的 INSERT OR IGNORE 后读回落盘车道、不一致就地纠正 （覆盖上一轮进程留下的旧行）；落盘失败只 WARN（不因记账失败丢主人消息）； **身份变化不搬家、不换 session id**；车道只来自 ResolveActor 的结构化白名单判定。 QQ 适配器（防御加固，非本次真机 bug 的修复）：senderIDOf 兜底链 顶层 user_id → sender.user_id；并用完整论证钉住「**群聊绝不能用 ChannelID 兜底**」（否则群里任何人 可顶群号冒充主人）；顺手体检：自己发的消息（post_type=message_sent）与 meta_event 已被 handlePayload 过滤。为守 ≤500 行把 id/字符串小工具拆到 ids.go。 测试：session/ownerlane_test + qq/ownerlane_test 新增用例（含「群号等于主人号时 陌生人不得借群号冒充」「群聊发送者 id 缺失时 SenderID 必须为空而非群号」「白名单 热重载后车道立刻刷新且 session id 不变」「白名单移除后立即退回，不是单向提权」 「跨进程继承的旧行被就地纠正」）。 变异 5 条（去 sender.user_id 兜底 / 群聊用群号当 SenderID / 命中却判 unknown / 还原缓存直返 / 去掉旧行纠正），每条先确认可编译、贴红行、还原复绿（md5 逐字节校验）。	2026-10-05 10:53:05 +08:00
AskaEth	8c437866e7	feat(qq-obv11): client 模式首连失败不再致命（复用既有重连循环 + 指数退避） ... 痛点：mode=client 时首次拨号失败会让 Connect 直接返回 error ⇒ 渠道起不来； 而「连上后再断」本来就有重连。⇒ 把 readLoop 的入口条件放宽为「conn==nil 也算」， **不新造第二套循环**。 新增 reconnect.go：退避 2s → ×2 → 上限 60s、抖动 ±25%（具名常量），失败计数跨 Connect 与 readLoop 共享。 ws_client：新增 connectFirstClient —— 可重试失败只记 WARN 并返回 nil； 配置缺失（remote_url 空）仍致命（闸门口径不变）。 connected 语义不许撒谎：始终由真实连接决定；HealthCheck 未连上返回 ErrNotConnected； 仅 http 传输保留「已装配即可服务」旧口径（逐字未改）。 ctx 感知等待（sleepCtx）+ 等待后复查 ctx ⇒ Disconnect 能立即中止，不泄漏 goroutine。 server 模式与 http 三端行为逐字不变（既有用例零改动全绿 + TestServerModeUnaffectedByClientRetry）。 测试：client_retry_test.go(428) + reconnect_test.go(83)，用可注入 dialer + gate 通道造确定性时序。 变异 5 条（首连 fail-fast / 退避无上限 / 取消失效 / 未连上就报已连 / 抖动未接线）。 诚实边界：60s 上限对聊天渠道可能偏慢（改 30s 是一行常量）；仓库内仍存第二份指数退避 （wsutil.Backoff 无抖动能力，收敛需改 internal/**，本切片禁碰）。	2026-10-05 10:12:23 +08:00
AskaEth	7d2ff74cfc	test(telegram): 补语音内联回归测试（上一条语音切片提交时被 grep 过滤漏掉）	2026-10-05 08:37:23 +08:00
AskaEth	a918819878	feat(channels,voice): IM 各渠道语音消息可被读到（全渠道云端 ASR + 临时熔断） ... 采集面：mediafetch 新增 inline_voice.go（音频白名单，与 documents.ExtAllowed 互不污染； 复用既有来源白名单 / 逐跳校验 / 边读边限 / 超时）；四个适配器零改动。 消费面：channelbridge 在流水线最前端把「语音字节 → 文本」归一并写回 msg.Content； inbound.go 的丢空判据放宽为「无文本且无可用媒体」。 微信优先平台自带转写（Content 非空 ⇒ 不调 ASR，不重复付费）。 降级（主人定的两层）：新增 voice/outcome.go 的 STTOutcome 识破静默档位； errors.go 分类鉴权失败/欠费/限流（CircuitWorthy）；voice_breaker.go 临时熔断 + 退避（TTL 恢复）； 无论是否熔断，消息面都落一行中文诚实提示（绝不静默、绝不留空消息）。 独立短超时：VOICE_STT_TIMEOUT_SEC（默认 20s，同步 .env.example）。 kook 不再把 CDN 地址写进 Content（地址仍在 Media[].URL）。 设计先行：design/06 §1.1/§1.2、design/08 §4.1、design/24 §1.3/§4.2、开源对照清单。 变异 5 条（静默档位不带 Cause / Transcribed 误判 / 熔断恒放行 / ChatText 退化 / 平台文字判据取反）。 诚实边界：实施时官方音频规格尚未抓到 ⇒ MaxVoiceBytes 自定 5 MiB（保守）、采样率仍 16 kHz； 官方规格随后已抓到（10 MB / 5 min；格式含 amr、无 silk），对齐留待下次改动。	2026-10-05 08:32:37 +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	3be70f8232	feat(channels): 适配器入站内联附件字节（telegram/kook/qq_obv11/weixin_ilink） ... - 新增 internal/channel/mediafetch：来源白名单（deny-by-default，支持 *.suffix） + 逐跳重定向校验 + 边读边限 + 超时；只回来源主机，绝不回完整 URL - 四渠道各自 media.go 接通入站内联：只从平台载荷给出的引用取回字节 （telegram file_id→getFile→file_path 形态校验；kook CDN；qq 文件段 url； weixin cdnURL + AES-ECB 解密） - 常量全部复用既有来源：documents.ExtAllowed / DefaultMaxBytes / MaxPerMessage - channelbridge 诚实提示文案改为对「渠道只给远程引用」与「代取失败」两种成因都成立 - 18 个测试函数（含四渠道「正文里的 URL ⇒ 0 次命中」红线反证、端到端进模型可见视图） - 变异验证：去掉尺寸上限 ⇒ 四渠道红（含修正后不再是假绿的 weixin 超量用例）	2026-10-04 22:13:17 +08:00
AskaEth	9253fef92a	feat(qq_obv11): OneBot v11 四端齐备（裁决 1.4 / 12.4.1） ... - 四端＝ws×client / ws×server（原有，补语义注释）+ **http×client**（新增 http_client.go： 调 OneBot HTTP API、请求-响应、retcode 判成败、token 只走 Authorization 头）+ **http×server**（新增 http_server.go：监听 listen_addr 收上报、fail-closed 鉴权、10MiB 体上限） - 配置面：适配器新增 transport / api_base_url / report_path（json tag 沿用既有口径）； env 兜底 CHANNEL_QQ_OBV11_{TRANSPORT,API_BASE_URL,REPORT_PATH}；**默认值＝现状**（ws+server） - 出站分流：session.go 发送路径按 transport 走 WS 写帧或 HTTP POST（不改它则 HTTP 端无法出站） - 端口豁免边界：http+server 沿用 AGENTS §9 已登记的同一豁免（design/13 §0 原文即含 HTTP server）， 且 listen_addr 为空时报错、**绝不开端口**（与 ws 侧同名校验成对） - 关键取舍（已上报）：OneBot 的 HTTP 是「动作 + 上报」两半，mode 决定**哪一半必需**、 另一半给齐字段就一并启用 ⇒ 单个适配器即可「收上报 + 回消息」，四端仍各自可独立选择与测试 - 复核：build/vet 绿 + qq_obv11/cmd 包测试绿 + `-race` 干净；10 条新用例（HTTP 两端全部用本地 httptest 假 OneBot，未连真实 QQ）；变异 3 条（伪造 retcode 成功 / 去掉上报鉴权门 / 默认值翻 http）已还原 - 未接：get_group_list（后续）、无 token 时放行（与既有 ws_server 一致，如需 fail-closed 请裁决）	2026-10-04 13:58:18 +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	af8591b78a	fix(channel,user): owner 车道只认白名单，堵住群主/伪造 role 冒充主人（裁决 06.4.2/06.4.3/06.4.4） ... - 适配器只描述平台身份：qq_obv11 的 owner/admin 一律上报 RoleMember，不再上报 RoleOwner - session 层唯一判主点只认白名单（owner.yaml Accounts ∪ 每渠道 adminIds），nil 档案 fail-closed 拒绝 - 新增「每渠道管理员层」：channels.json ChannelAccount.adminIds[] → runtimeconfig.AdminIDs → OwnerProfile.SetPlatformAdmins（整体替换语义，热重载后移除的 id 立即失效） - 组合根接线：启动即播种、面板保存先灌白名单再重载适配器（cmd/cyrene/wire_channels.go + 4 条端到端单测） - 06.4.3 节流与参与度状态按会话独立计数（ConversationKey 三处统一，空会话 GC）；06.4.4 未知平台主动发言保守默认 1 条/分钟	2026-10-04 12:07:40 +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	8d44bba14a	fix(weixin_ilink): 换码阈值5s->60s——码未过期一律复用,防前端高频login-qr砍确认会话	2026-09-08 01:49:20 +08:00
Aska	c515de28bf	fix(weixin_ilink): 已扫待确认不重新取码 + scaned 状态暴露 + 扫码链路日志 ... StartLogin 换码保护: 当 runLogin 观测到 wire 状态已进入 scaned/scaned_but_redirect/need_verifycode(confirmingPhase)时, 复用当前 loginSession 的 QR 而不重新 fetchQRCode/cancel 旧 poll, 避免 45s 自动刷新/恢复前台把已扫未确认的会话砍掉导致微信 confirm 丢失。 仍保留 qrReuseWindow: 未扫描(等待中)且超窗口才重取, 保留显式刷新二维码要新码。 runLogin 补 case scaned: setLoginState(LoginStatusWaiting, loginScannedDetail), 沿用 Waiting 不新增破坏性状态; 顺带在会话上记录 wire phase 供 StartLogin 判别。 可观测性: fetchQRCode 取码成功记 get_bot_qrcode ok(url 脱敏, 不含 qrcode), pollQRStatus 状态变化才记 get_qrcode_status(status), completeLogin/failLogin/ completeBindedRedirect 记结果; 均不落 qrcode/bot_token/user_id。 failLogin 修正: 被 re-mint superseded 的旧会话不再 clobber 新会话状态(不置 failed)。 新增测试: scaned 暴露到 LoginStatus; scaned 超窗口复用 QR 不重取; 等待中超窗口 重取; 日志脱敏断言。	2026-09-08 01:12:59 +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	bef398d47a	fix(weixin): 二维码回退用qrUrl生成 + 每次点击重新发全新码(修'过期') ... 用户实测: qrcode原始串编码微信扫出纯字符串(qrcode得用qrUrl liteapp链接); 过期的真正原因 是复用旧二维码(微信码有效期极短)。修: 二维码改回用 qrUrl(liteapp链接)生成; StartLogin 把复用窗口从90s降到5s(仅防连点),否则每次'扫码登录/刷新'都取消旧会话重发全新码——永远新鲜可扫。 build/vet/test+前端build 全绿,已部署。	2026-09-07 21:54:08 +08:00
Aska	a9dfae4d5f	fix(weixin): 扫码QR超时自动重发——修'二维码过期'(旧码被幂等返回) ... StartLogin 幂等会一直返回同一二维码，但微信bot绑定码有效期极短；此前测试触发过一次登录 会话，旧码过了有效期,用户刷新仍拿到它→扫即'过期'。修: loginSession 加 startedAt, 超过 qrRefreshTTL(90s) 时 StartLogin 取消旧会话并重发新鲜二维码(panel'刷新二维码'永远可扫)。 重启清除内存中旧会话。build/test绿,已部署.	2026-09-07 21:41:43 +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	c4fe5a0cfd	fix(kook): 私聊(临时会话)以对端用户为回复目标——修'不能是自己'40000 ... KOOK 临时私聊里用户→bot 事件的 target_id=bot 自己、author_id=对端用户；原 ChannelID= target_id(bot id)，导致回复发给自己→KOOK 40000 不能是自己。修：非群聊时 ChannelID=发送者 (对端)id，回复即发给对端、每 DM 独立会话。加 TestToUnified_PrivateDmUsesPeerAsChannelID。 build/vet/test 全绿, 已重建部署.	2026-09-07 20:09:32 +08:00
Aska	db8465f68b	fix(kook): 丢弃自我回声消息，防 bot 把自己的回复当入站用户消息 ... KOOK 网关会把 bot 自己发的消息又推回给 bot(author_id=bot uid)，导致 bot 把自己的 回复当成入站用户消息处理(循环/浪费token)。toUnifiedMessage 计算 senderID 后调用 isSelf(senderID) 比对 a.botID(user/me 解析出的 bot 账号 id)，命中即返回 ok=false 丢弃。 - identity.go: 新增 isSelf(并发安全,botMu) - message.go: self-echo 丢弃 + debug 日志 - message_test.go: TestToUnified_DropsSelfEcho 验收: go build/vet/test ./... 全绿	2026-09-07 18:38:15 +08:00
Aska	5ec4c9814d	feat(kook): P2 KOOK 专属页+后端 admin 端点(design/17 §2/§4) ... 后端(KOOK REST, 复用 httpclient WithAuthScheme(Bot), token不打印): - kook/admin.go(新): ListFriends/HandleFriendRequest/DeleteFriend/BlockFriend/ ListUserChats/CreateUserChat/ListDirectMessages - kook/admin_guild.go(新): ListGuilds/ListGuildChannels/ListGuildUsers/ListChannelMsgs/SendTestMessage - gateway/admin_channels_platform.go(新): kookAdmin(反射解包namedAdapter命中内嵌PlatformAdapter) + 4 handler + adminKookView聚合(子项失败记errors不伪造) - server.go 注册 4 条 ownerAuth 路由: /view /friends /friend/handle /message/test - admin.go/admin_write_channel_config.go: AdminChannelAccount 加 Capabilities 前端(KOOK 专属页): - KookPanel.tsx(新): 好友&申请/服务器/频道/成员/私信会话/发消息测试卡片 - AdapterDetailPage.tsx: platform==='kook' 渲染 KookPanel, 否则通用 - types.ts/api.ts: KOOK 类型 + adminChannelPlatformView/Friends/FriendHandle/MessageTest 文档: Docs/api-client.md 新增4端点契约(owner-only)+capabilities+v0.17 验收: go build/vet/test ./... 全绿 + npm run build 97模块全绿; 零新依赖 注: api.ts/types.ts 集中契约文件>500行属既有结构(未新增违规); KOOK其余REST方法留能力面待用	2026-09-07 18:19:31 +08:00
Aska	c1bd740f7c	fix(kook): KOOK 机器人鉴权用 Authorization: Bot <token> 而非 Bearer ... httpclient 硬编码 Bearer，导致 KOOK bot token 被当 OAuth2 用户令牌发， / gateway/index 返回 401『登录环境异常』。按 KOOK reference 鉴权规范， 给共享 httpclient 增加可配置 authScheme（默认 Bearer），KOOK 用 Bot。 - httpclient: 新增 WithAuthScheme 选项 + authScheme 字段，do() 按 scheme 组装 - kook/adapter: 装配时传 WithAuthScheme("Bot") - 同步修正 config.go 注释与 send/identity 测试断言	2026-09-07 16:59:53 +08:00
Aska	65091f6497	feat: KOOK自动获取bot身份 + action/narration剥出气泡 + 渠道配置表单回填 ... agent-116 KOOK token即用+自动获取: - kook/identity.go: Connect 调 GET /user/me 拿 bot 身份(bot_id/bot_username/bot_nickname), 失败容错 - 渠道列表 enrichAccountsWithBot 附 bot 身份; base_url空用默认/receive_mode默认ws(只填token可跑) agent-117 action/narration 剥出气泡(主人需求: 动作/旁白不进气泡,按位置上/下): - parseContent.splitBubble(content)->{body,head,tail}: body=纯文本(去标签), head=开头/中间action/narr(气泡上), tail=结尾(气泡下) - renderContent 只渲染text(去内联灰斜体); chat.tsx BubbleNotes 泡外 ＊动作/旁白＊ 灰斜体小字(气泡外依附), SplitChatBubble 先剥splitBubble再splitParagraphs(body), <p>/\n\n/毛玻璃/SourceLabel不破坏 - 注: 非chat mode renderContent 现在丢弃action/narr(可接受) Channels 配置表单回填(修save后输入框空): - openConfig 从 data.accounts[0].config 回填 token(掩码提示)/base_url/平台字段/黑白名单/限流, 不再硬清空 全仓 build/vet/test绿+前端build绿	2026-09-07 15:31:14 +08:00
Aska	617157262b	feat(channel): KOOK Webhook(WH) 接收模式——与 WS 配置切换(ReceiveMode) ... - kook.Config 加 ReceiveMode("ws"默认/"webhook") + WebhookPath(默认/webhook/kook) + WebhookVerifyToken + WebhookEncryptKey(AES-256-CBC) - 按权威文档(Reference/kaiheila webhook.md)实现: 无X-Signature HMAC, 真实校验=d.verify_token比对(不匹配403)+可选AES解密+zlib解压+challenge回显 - webhook.go: InboundHandler+WebhookPath, POST→zlib解压→AES解密→verify_token校验→challenge回显→归一UnifiedMessage→SetMessageHandler; WS模式Connect不拨网关仅标记connected - channelbridge/webhookAdapter 接口改用 WebhookPath(); WebhookHandlers 收KOOK WH(ws模式跳过); 既有webhook通道补WebhookPath照常挂载 - namedAdapter 转发InboundHandler/WebhookPath; kook env兜底 +4个CHANNEL_KOOK_*键 - 测试: verify_token 403/challenge/zlib/AES往返/WebhookPath按模式/WH不拨gateway/WebhookHandlers收KOOK; 全仓build/vet/test绿 - 待真token端到端实测(需主人提供CHANNEL_KOOK_TOKEN+开发者后台切WebHook配回调URL)	2026-09-07 14:10:03 +08:00
Aska	764d592859	feat(channel): KOOK 渠道适配器 + 框架兼容增强(wsutil/httpclient) ... - plugins/channels/kook: config/adapter/gateway/websocket/send/message/errors — 实现 PlatformAdapter 13方法 - WS 有状态网关: 取gateway地址→连WS→信令0/1/2/3/4/6 + 30s心跳/6s超时 + resume(拼接sn/session_id) + 指数退避重连 - 收事件: 信令0 → UnifiedMessage(word注 channel_type/type/target_id/extra.author→字段) - 发消息: /message/create(频道) + /direct-message/create(私聊,修正正确端点,非user-chat) + Bearer鉴权 - 注册 channels.go + CHANNELS_JSON 多账号 + channelbridge.configured 加 kook(bot_token非空才连) - 框架增强: internal/channel/adapter/wsutil(连接管理/心跳/重连/resume骨架,复用gorilla,KOOK用上) + httpclient(Bearer+envelope归一,KOOK用) - 全仓 go build/vet/test 绿, 零新依赖(复用餐gorilla), 未动telegram/qq/weixin/webhook契约 - §4.6 隔离/黑白名单/第三方边界未破坏 注: KOOK WS/WH 双模式待补(ReceiveMode), 实测需主人提供 CHANNEL_KOOK_TOKEN	2026-09-07 12:01:35 +08:00
Aska	9c2a37c4ac	feat: 管理面板补齐(RAG导入/记忆添加/会话接history/诚实表述) + design/16 §4.6 IM多会话隔离+第三方身份+黑白名单 ... agent-98 面板批次: - 会话管理面板改接 history.ListSessions(主web+次级) + 新建次级会话按钮 - 记忆面板手动添加入口 POST /admin/memories(owner) - 知识库真正实现 IndexDocument(分块+落projectindex) + POST /admin/rag 导入端点 - 三面板空态诚实表述(去除'后端M10+提供') - RAG嵌入降级到keyword/line(无直属embedder,不伪造语义,符合红线) agent-99 design/16 §4.6: - model.Message.SenderName + 迁移0006 sender_name 列 - 第三方身份边界: session.ResolveActor判定(非LLM猜) + [第三方·昵称]前缀(不改源content) - 群聊/陌生人落独立sess-xxx(persistIsolated),不写主会话,不广播 - 黑/白名单(allowGroups/denyGroups/allowUsers/denyUsers)最前拦截,不进LLM - 多账号 CHANNELS_JSON 配置 + 每平台多实例 - 管理只读 GET /admin/channels/{platform}/messages(该平台非主人消息流) 实机验证(JWT): 会话管理返回主会话web / 记忆添加成功 / RAG导入documents非空+Cyrene命中; 后端build/vet/test全绿 + 前端build绿	2026-09-07 05:13:36 +08:00
Aska	88dc12466d	feat(channels/weixin_ilink): 微信 iLink 渠道插件（扫码登录+长轮询+游标+context_token+AES-128-ECB 媒体+24h 主动推送窗口）	2026-09-06 06:49:35 +08:00
Aska	7831b0ea1b	feat(channels/qq_obv11): OneBot v11 渠道插件（正/反 WS 双模式 + CQ 媒体 + 限频，stdlib 自研 WS）	2026-09-06 06:46:43 +08:00
Aska	f9f5a78a02	feat(channels/telegram): Telegram 渠道插件（Bot API 长轮询/Webhook + file_id 媒体 + 主动推送强）	2026-09-06 06:38:13 +08:00
Aska	0b036645bb	feat(channels/webhook): 入站回调渠道插件（JSON/Form 解析 + HMAC 签名 + InboundHandler 供 gateway 挂载，主动推送不支持）	2026-09-06 06:37:16 +08:00