Backlog / Prioritized TODO

用于持续跟踪 openclaw-channel-dingtalk 的任务优先级、推进顺序和治理项。

---

P0

1. 消息接收稳定性 / 长时间待机可靠性

相关 Issues：

任务：

• 跟进 #550 的 IPv6 路由异常排障方案：维护者倾向先用 NODE_OPTIONS=--dns-result-order=ipv4first、resolver/代理等宿主机层处理，暂不在插件层新增 OPENCLAW_DINGTALK_FORCE_IPV4 API；优先沉淀 troubleshooting 文档，若更多环境反复出现再评估代码兜底
  • #550 fix(http): allow opt-in IPv4-only HTTP agent for IPv6-broken environments（状态：已关闭未合并（维护者倾向宿主机层处理；CI 通过，Greptile 仅 P2 风格建议））

已完成：

• 复核现有稳定性问题是否仍可复现
  • #96 fix(dingtalk): harden inbound message handling（状态：合并）
  • #167 fix(dingtalk): clean up heartbeat timer on reconnect（状态：合并）
  • #183 fix(dingtalk): add stale lock cleanup on send path（状态：合并）
  • #249 improve DingTalk connection troubleshooting（状态：合并）
• 验证 #313 在“冷启动后立即主动发送”场景的稳定性
  • #313 fix: lazy-preload peer ID registry to fix 400 errors in delivery queue（状态：合并）
• 验证 #323/#325 后长待机与恢复窗口是否仍出现“间歇性收不到消息”（关联 #104 新增反馈）
  • #323 fix: increase health check interval/grace to prevent reconnect storm（状态：合并）
  • #325 test(connection-manager): align health check timings with new 60s/30s constants（状态：合并）
• 复核 #336 在低流量静默群聊下是否消除“空闲误重连”，并确认不影响真实断链恢复
  • #336 fix: avoid idle reconnects on quiet DingTalk stream connections（状态：要求修改，已关闭未合并）
• 跟进 #390 的 callback ack 时序修复方案，补齐 no-dedupKey 与 in-flight 分支 ACK 行为一致性回归
  • #392 fix: acknowledge DingTalk callback immediately to prevent redelivery（状态：合并）
• 跟进终态 FAILED 后 waitForStop 卡死导致无法自动恢复的问题，并确认修复已落地
  • #399 fix: resolve waitForStop on terminal FAILED state（状态：合并）
• 同步 #400 已关闭结论（关联 #399），后续仅保留旧版本存量告警观察

2. AI Card 发送链路一致性

相关 Issues：

任务：

• 复盘 #363 关闭未合并方案与当前主线差异，确认其风险点已被后续修复覆盖
  • #363 fix(card): prevent duplicate cards and disable unused block streaming（状态：已关闭未合并）
• 跟进 #357 升级后“卡片仅处理中”反馈，核对 cardRealTimeStream 默认值与迁移提示
• 跟进 #358/#541 的表格转换后续（是否移除历史 convertMarkdownTablesToPlainText 路径），补钉钉 markdown 表格分隔行提示与跨端渲染回归
• 跟进 #379 的“上游返回 0 字节时钉钉前端无错误反馈”场景，明确插件侧兜底提示与日志建议（/verbose on）边界
• 跟进 #407 的“card 模式下无回复 + ackReaction 不显示”现场，区分卡片发送链路异常与 thinking 反馈配置问题
• 跟进 #538 的 thinking-only assistant message 静默丢弃：先用 v3.6.1 复测；若仍可复现，评估 thinking 降级为 text 或显式“模型输出格式异常”提示，避免用户无感知
• 跟进 #551 的 AI Card 二次流式/合并回归：复核长输出与 Markdown 图片 file:// 场景下是否重复追加内容和重复发送图片，重点验证用户 2026-05-06 反馈的“删除图片引用容器组件 + 删除/替换下方 AI 流式富文本块”模板调整是否能同时保留图片发送与上方流式输出，并确认自定义卡片模板变量说明是否足够支撑用户侧实验
• 复核 #419 关闭结论：确认“会话锁外提前建卡/空 Done 卡片”修复是否已入 main；若未落地，按最小补丁重提
  • #418 fix: use dispatch counts to prevent empty "Done" card finalize（状态：已关闭未合并）

已完成：

• 跟进 #457 对 /reasoning on 与 /reasoning stream 的统一交付方案，确认多轮 assistant turn 与 finalize 边界在 card 模式稳定
  • #457 fix(card): unify reasoning-on and reasoning-stream block delivery（状态：合并）
• 回归媒体消息 仅媒体/仅文本/媒体+文本 的 deliver 组合行为（#321/#311）
  • #311 fix: deliver MEDIA attachments in inbound reply handler（状态：合并）
• 评估并实现 card.stream 节流/合并策略，降低限流风险（#318）
  • #179 hardening send path（状态：要求修改，已关闭未合并）
  • #191 serialize send pipeline with session-scoped dispatch lock（状态：合并）
• 复核 reasoning 重复堆叠修复是否稳定（#290/#291）
  • #291 fix(card): use replace mode for reasoning stream to prevent content duplication（状态：合并）
• 回归“多个 final chunk + 工具报错”场景，确认最终输出不会被吞（#326）
  • #326 feat: support multiple final chunk（状态：合并）
• 复核 #327 恢复后的 reply-stream 契约是否完整（cardUpdateMode=replace、payload.text 路径）
  • #327 fix(dingtalk): restore non-session inbound logic regressed by #307（状态：合并）
• 复核 #231 合并后的真实净变更与 #208 关闭结论是否一致，避免“状态已关闭但用户侧仍无错误提示”
  • #231 fix: don't suppress stop reason（状态：合并）
• 跟进 #311 的 review blocking 项，基于已 rebase 分支复核 deliver MEDIA 边界（入站回包/主动回复/卡片并行）
  • #311 fix: deliver MEDIA attachments in inbound reply handler（状态：合并）
• 复盘 #334 对 #295 的回滚影响，明确 async ack 是否保留为后续可选能力
  • #295 feat(dingtalk): 增加异步回执模式（状态：合并）
  • #334 Revert "feat(dingtalk): 增加异步回执模式"（状态：合并）
• 校验 #300/#335 的 markdown 表格兼容策略与默认值，避免不同钉钉客户端表现分叉
  • #300 feat(dingtalk): 优化 Markdown 表格发送兼容性（状态：合并）
  • #335 feat: add convertMarkdownTables config option（状态：合并）
• 跟进 #396 内置卡片模板与停止按钮方案，复核其与 message-context-store 主路径的一致性后再决定合入
  • #396 feat(card): built-in AI card template with stop button support（状态：已关闭未合并）
• 跟进 #444 重提的内置卡片模板 + 停止按钮方案，当前已合并入 main，后续重点转向与 v2 草稿方案的重叠收敛
  • #444 feat(card): built-in AI card template with stop button support（状态：合并）
• 跟进 #448/#480 的 AI Card v2 结构化 CardBlock[] 草稿方案，评估其与 #444 的重叠/替代关系后再决定推进路径
  • #448 refactor: AI Card v2 — structured CardBlock[] with preset template（状态：已关闭未合并）
  • #480 feat(card): implement card template v2 with rich block content and action btns（状态：合并）
• 跟进 #427 文本停止指令 pre-lock bypass 方案，补“空确认文本兜底 + 多次 deliver 文本选取”回归后再评估合入
  • #427 feat: bypass session lock for real-time stop command support（状态：合并）
• 跟进 AI Card finalize 收尾修复并回归“多轮 tool + final chunk + 首行重复”组合场景（#348/#350/#352）
  • #348 fix(card): use accumulated content for AI Card finalization（状态：合并）
  • #350 fix(card): fix AI Card streaming finalization bugs（状态：合并）
  • #352 fix(card): fix AI Card streaming finalization bugs（状态：合并）
• 回归 Markdown 模式分块回复被拆分问题，确认非卡片模式走单次投递（#360）
  • #361 fix(markdown): disable block streaming in markdown mode to prevent split messages（状态：合并）
• 复核 #368 reply strategy 重构后 card/markdown 投递行为与动态 reaction 装饰器兼容性
  • #368 refactor: extract ReplyStrategy interface for streaming reply dispatch（状态：合并）
• （拟完成，请评估）跟进 #513 的 session-recovery 卡片冻结问题：当前已补 markdown fallback 兜底，仍需在 Anthropic thinking recovery 实机路径确认第二轮恢复后的最终用户观感
  • #518 fix(card): deliver markdown fallback when session-recovery updates a finished card（状态：合并）
• 跟进 #543 的同会话并发建卡 guard：#543 已合并并补同步 in-flight guard、markdown 降级与并发回归，待一次真机快速连发验证
  • #543 fix(card): prevent duplicate card creation via synchronous in-flight guard（状态：合并）
• 跟进 #544 的主动推送 card final 空白问题：#546/#548 已修复 proactive block finalize 与 opened streaming lifecycle，待一次主动推送 + 打开态流式卡片真机回归
  • #546 fix(card): finalize proactive cards with block variables（状态：合并）
  • #548 fix(card): finalize opened streaming lifecycle（状态：合并）
• 同步 #531 stop 按钮未中止 underlying embedded run 的关闭结论：当前由 #495 回滚 AI Card v2 hybrid streaming 关闭，后续若重启 v2 卡片方案需重新验证 stop button 与 /stop 中止语义一致性
• 同步 #534 finalize 延迟反馈关闭结论：#548 已修复 opened streaming lifecycle finalization，仍将“慢 streaming PUT warn/timeout 可观测性”保留为后续卡片链路排障关注点

3. 文件上传 / 文件读取 / 文件预览 / 大文件链路

相关 Issues：

任务：

• 核对基础文件发送能力的当前边界
• 拆分文件上传、读取、预览、扩展名处理、大文件、钉盘访问子任务
• 为每个子任务补最小复现和验收标准
• 明确哪些属于补尾，哪些需要新增开发
• 复核 #315 场景在当前版本中的行为与诊断提示是否一致
  • #68 feat(dingtalk): implement file uploading with send image, video and file support（状态：要求修改，已关闭未合并）
• 评估 #298 的附件正文抽取边界（类型/长度/失败回退）与现有文件链路兼容性
  • #298 feat(dingtalk): 支持入站附件正文抽取（状态：合并）
• 跟进 #207 新增进展：robotCode 已配置仍失败，补充“企业认证/权限付费门槛”前置条件说明
• 将 #366 的“文本正常但文件发送失败”场景补充到文件链路最小复现矩阵，并对齐与 #207/#315 的同源性判断
• 合并 #270 的“仅文件占位符”现场日志，补齐“下载成功但提取失败”与“未落盘”两类分流排障步骤
• 跟进 #391 的钉盘自然语言检索诉求，明确“仅引用直发/文件名模糊搜索/全量语义搜索”分级能力与前置权限
• 跟进 #505/#482 的“原始文件名透传 / 文件名显示异常”回归，确认原始文件名已透传到 saveMediaBuffer 与消息上下文链路，并区分插件侧透传与钉钉落地文件重命名
  • #506 fix: forward original filename to saveMediaBuffer (#505)（状态：合并）
• 跟进 #397 的 sandbox 路径兼容缺口，sendMedia -> uploadMedia 已补齐 loadWebMedia 桥接能力
  • #398 fix: sandbox sendMedia fails for workspace files（状态：合并）
• 跟进 #411 恢复“附件抽取文本注入 inbound body”修复并确认 quotedRef 链路已补齐（file/audio/video + Step 0 下载）
  • #411 fix: 修复引用文件/音频/视频消息下载及附件文本注入（状态：合并）
• 补充 #415 单聊收文件失败最小复现：区分“单聊附件入站限制”与“提取/落盘链路异常”
• 跟进 #422 的“模型不会触发文件发送动作”反馈，补充提示词/动作能力边界说明与可复现样例
• 跟进 #430 群聊文件读取反馈：确认 #411 发布版本已覆盖“引用文件 + @Bot”路径，并补权限/时效性说明与版本提示
• 跟进 #442 入站附件下载超时阻塞问题，补“第二跳下载 timeout + host 日志”回归
  • #443 fix: add timeout and host logging for inbound media download（状态：合并）
• （拟完成，请评估）跟进 #452/#454 的 messaging 分域迁移 PR，确认 quoted-file-service 与 attachment-text-extractor 搬迁后文件链路回归覆盖完整
  • #452 refactor(messaging): move quoted file helpers into messaging（状态：合并）
  • #454 refactor(messaging): move attachment text extraction into messaging（状态：合并）

4. 图片 / 语音 / 媒体链路补强

相关 Issues：

任务：

• 回归本地图片发送
• （拟完成，请评估）跟进 #542 的富文本多图片入站链路：#545 已补 inbound-handler.ts 多媒体下载、上下文注入、sub-agent/quote 恢复与回归用例，待一次实机多图确认
  • #545 fix(inbound): download and pass all mediaPaths for multi-image rich text messages（状态：合并）
• 回归语音消息发送
• （拟完成，请评估）跟进 #516 的媒体类型判定回归：.mp3 默认按附件发送的修复已合入，仍需补一次 v3.5.3 升级后的文件/语音分流实机回归
  • #517 fix(media): default audio files to attachment instead of voice message（状态：合并）
• 回归入站媒体大小限制覆盖配置
• （拟完成，请评估）评估 AI Card 内媒体一体化展示是否值得推进
  • #181 add mediaMaxMb override for inbound media size limit（状态：合并）
  • #182 support local image sending（状态：合并）
  • #200 support asVoice for media messages（状态：合并）
  • #311 fix: deliver MEDIA attachments in inbound reply handler（状态：合并）
• 明确哪些项已完成、哪些项仍待开发
• 回归 Windows 绝对路径/相对路径下图片与文件发送（#316, #241）
• 跟进 #248 的 mediaUrl 路径归一化修复，并在 rebase 到最新 main 后回归远端 URL/本地路径分流
  • #248 fix(dingtalk): prepare mediaUrl in action send before upload（状态：合并）
• 针对 #333 增补 robotCode 缺失/错误时的启动校验与日志提示，避免仅出现 <media:image> 占位文本
• 明确 #351 的能力边界说明（客户端压缩 / API 不支持原图参数），在文档中补“可控项与不可控项”说明
• 跟进 #365 的图片占位符问题，修复 sampleImageMsg 参数与上传 mediaId 语义不匹配
• 将 #394 纳入图片入站回归矩阵，补充“仅识别为 [图片] 占位符”场景的格式/大小/日志采样
• 合并 #394 最新评论，补充“模型是否支持多模态”的前置检查与提示路径
• 跟进 #408 的 DM TTS 附件链路：区分 deliverMediaAttachments 与 sendMedia 路径，补“回复型语音附件”回归与降级提示
• 同步 #429 关闭结论：移除 [media_path:] 注入后，sandbox 模式媒体读取回归
  • #432 fix: remove [media_path:] body injection to fix sandbox media access（状态：合并）

---

P1

5. 引用消息 / chatRecord / 转发记录解析收口

相关 Issues：

任务：

• 梳理各 PR 的前后替代关系
  • #128 feat(dingtalk): support quoted messages（状态：合并）
  • #202 fix(dingtalk): improve quote and forward handling（状态：要求修改，已关闭未合并）
  • #209 fix(dingtalk): handle empty forward payload（状态：要求修改，已关闭未合并）
  • #210 fix(dingtalk): improve quote journal compatibility（状态：要求修改，已关闭未合并）
  • #233 quote/chatRecord/stream-card hardening（状态：要求修改，已关闭未合并）
  • #257 clarify empty chatRecord payload behavior（状态：合并）
• 明确引用消息解析的最终行为
• 明确 chatRecord 空内容提示策略
• 明确转发记录展示策略
• 做一次集中回归并沉淀结论
• 补充富文本 markdown/代码块引用场景回归，确认引用内容传递边界（#286）
• 跟进 #507 的 chatRecord 引用摘要修复，确认 repliedMsg.content.summary/title 会进入 quoted preview
  • #507 fix: parse chatRecord summary from repliedMsg content（状态：合并）
• 跟进 #503 的 quote visibility follow-up，确认群聊 quoted sender allowlist 不再串用 DM allowFrom，并统一布尔解析 helper
  • #503 fix(inbound): follow-up(#499) harden helper warning and quote visibility（状态：合并）
• 评估 #364/#371 的消息上下文持久化统一方案对 quote/chatRecord 的迁移兼容与回归面
  • #364 feat: unify message context persistence（状态：合并）
  • #371 fix: unify message context journaling scope（状态：合并）
• 落地 quotedRef 引用链并对齐 runtime reply context（#375/#377/#378）
  • #375 feat: add quotedRef-based reply reference chain（状态：合并）
  • #377 feat: translate quotedRef chain into runtime reply context（状态：合并）
  • #378 fix: remove undefined quotedPrefix in text message extraction（状态：合并）
• 跟进 #389 对 #377 的后续补丁（preview fallback/attachment excerpt/TTL），确认与现有 message-context-store 语义一致并已合入
  • #389 feat: inject quoted reply context for agent runtime（状态：合并）
• （拟完成，请评估）跟进 #401 quoted-only 回归修复的后续项：补 handler 层回归测试，并评估 QuotedRef-first 输入策略
  • #401 fix: fallback to quoted previewText when reply text is empty（状态：合并）
• （拟完成，请评估）跟进 #525 的 chatRecord 明细解析补强：已合并并覆盖 chatRecord/records/messages 三种别名、summary-only 平台边界与注释说明，待做一次引用消息 / chatRecord / 转发记录集中回归
  • #525 Handle detailed DingTalk chatRecord payloads（状态：合并）
• 跟进 #515 的 quoted chain 可见性收口：确认 allowlist/allowlist_quote 只保留连续可见 hop，避免 deeper blocked chain 继续泄漏到 runtime
  • #515 fix(inbound): trim blocked quoted chain context（状态：新（草稿，CI 通过））

6. 建立 Issue 提交标准化

任务：

• 新增 Bug report 模板
• 新增 Feature request 模板
• 新增 Regression report 模板
• 新增 Docs / onboarding 模板
• 统一必填字段：版本、部署方式、AI Card、messageType、复现步骤、预期/实际、日志、复现稳定性
• 建立标签标准：stability / streaming / media / files / ai-card / multi-agent / docs
• 在 README 或贡献文档中补提单说明

7. 建立 PR / Issue 自动化流程

相关参考：

• npm publish workflow

任务：

• 新增 PR Template
• 增加 Issue / PR labeler
• 增加 stale 自动提醒
• 增加 needs-info 自动提醒
• 增加 Closes #... / Refs #... 校验
• 增加 PR CI gate：type-check / lint / test
• 增加 release note automation
• 规划自动化分阶段落地顺序

---

P2

8. 多账号 / 多 agent / schema 与路由配置收敛

相关 Issues：

任务：

• 补齐配置示例
• 增加配置校验
• 优化启动时报错
• 补齐文档说明
• 跟进 #514 的多账号 schema 报错反馈：issue 已关闭，当前重点转为补 accounts.main/default 形态、遗留 corpId/robotCode 字段与缓存命中旧 schema 的迁移说明
• （拟完成，请评估）跟进 #528 的 clientSecret SecretInput 支持：已合并并补 env/file/exec 文档、占位符校验、配置态与 onboarding 回归，待发布后配置迁移验证
  • #528 feat: support SecretInput for DingTalk clientSecret（状态：合并）
• 吸收 #492 的“同一机器人按用户路由到不同 agent”案例：补 bindings.peer.id / direct staffId 示例，并明确这属于框架 routing 能力而非插件新增特性
• 跟进 #460 的多 agent 指令路由回归：复核 #478 在当前版本对 @agent /new、@agent /stop 与 /reasoning stream 的覆盖范围，并补最小复现与版本结论
• 区分 #530 的“用户直接 @agent 路由”与“Agent 间自主通信并回写群聊”两类诉求，明确前者已有能力边界、后者是否需要新的编排/回传方案
• 明确 session-alias 与框架 routing bindings 的职责边界（#307）
  • #307 feat(dingtalk): 支持 owner 控制群共享会话别名（状态：合并）
• 评估 @sub-agent 能力与现有路由模型整合方案（#317）
  • #132 多账号 schema / ControlUI 兼容相关（状态：合并）
  • #133 feat(dingtalk): add multi-account schema support（状态：合并）
  • #137 refactor(dingtalk): modularize channel implementation（状态：合并）
  • #317 feat(dingtalk): add @sub-agent basic support for group chat multi-agent scenarios（状态：合并）
• 复核 dashboard schema 渲染与 legacy key 归一化行为在 UI/Raw 配置路径的一致性（#304/#324）
  • #324 fix(config): resolve dashboard Unsupported schema node for #304（状态：合并）
• 跟进 #317 review blocking 项与“先暂缓”结论，冻结范围在基础路由能力并避免再次回归 #327 已修复的 inbound 能力
  • #317 feat(dingtalk): add @sub-agent basic support for group chat multi-agent scenarios（状态：合并）
  • #327 fix(dingtalk): restore non-session inbound logic regressed by #307（状态：合并）
• 排查并修复 #185 反馈的多 agent workspace 绑定异常（疑似默认 main 绑定导致配置失效）
• 补充 #185/#267 的“多账号配置是否生效”快速诊断步骤，减少重复提问
• 跟进 #354 的 peer.kind/peer.id 绑定案例：新增“staffId 配置正确仍不生效”反馈，补最小复现与 peerId/senderStaffId 对照日志诊断
• 吸收 #510 的配置追问：补充 allowFrom / groupAllowFrom / cid/... 的最小可用示例，并说明群聊白名单不命中时的排查步骤
• 复核 #356 的 schema 导入路径争议，确认 buildChannelConfigSchema 兼容策略后再决定是否合入
  • #356 fix: import buildChannelConfigSchema from plugin-sdk/discord（状态：已关闭未合并）
• 评估 #372 的 displayName 目标目录学习能力与既有 routing 规则的兼容性（命名冲突、跨群歧义、隐私边界）
  • #372 feat: add displayName-based target learning and resolution（状态：合并）
• 收敛 main 会话默认路由 owner 隔离，避免群聊流量意外接管私聊主会话（#382）
  • #382 fix(dingtalk): 限制 main 会话默认路由只被 owner 接管（状态：合并）
• 补齐群聊访问控制（allowlist/sender restriction/disabled）并确认 legacy allowFrom 兼容（#385）
  • #385 feat: group access control with per-group allowlist, sender restriction, and disabled policy（状态：合并）
• 跟进 #380 HTTP callback 多实例方案的 review 阻塞项（签名校验、TOPIC_CARD 回调行为、部署文档边界）
  • #380 feat(dingtalk): add HTTP callback mode for multi-instance deployment（状态：要求修改）
• （拟完成，请评估）跟进 #383 入站命令分发抽离重构，确认 command 域边界与现有 owner/session 命令回归覆盖
  • #383 refactor(dingtalk): 抽离入站命令分发逻辑（状态：合并）
• 跟进 #395 plugin-sdk API 对齐分支并完成兼容层回归（入口/类型导出/onboarding）
  • #395 refactor(dingtalk): Sync upstream plugin-sdk new API（状态：合并）
• 跟进 #472 的 scoped import 对齐收尾，确认 command-auth 测试 mock 与 peer dependency 约束后再合入
  • #472 fix(plugin-sdk): align scoped imports with latest sdk（状态：新）
• 跟进 #412 的 DM @sub-agent 路由方案，重点复核 DM richText/quoted 场景误触发与回归覆盖
  • #412 feat: support @mention sub-agent routing in DM (direct messages)（状态：合并）
• 跟进 #453 targeting 分域迁移，确认 group member store 搬迁后路由与缓存语义保持不变
  • #453 refactor(targeting): move group member store into targeting domain（状态：合并）
• 跟进 #420 私聊会话疑似误路由反馈：补 senderStaffId/senderOriginalId 冲突诊断日志与复现用例

9. 支持群聊 @人 / @all

相关 Issues：

任务：

• （拟完成，请评估）明确 @单人 需求范围
  • #317 feat(dingtalk): add @sub-agent basic support for group chat multi-agent scenarios（状态：合并）
• 明确 @多人 需求范围
• 明确 @all 需求范围
• 设计失败降级与兼容行为
• 整理 #288/#305 重复诉求，收敛为 #67 验收标准
• 同步 #486 的平台侧结论：明确“仅 @所有人”不会触发机器人回调，并补“同时 @机器人 / 改走 webhook”两条替代路径
• 跟进 #305 新增用户追问，补充当前版本可行配置与仍未覆盖场景的状态说明
• 跟进 #353 最新追问（是否排期），补当前“仅 @sender 能力”与“@指定成员待规划”状态说明
• 跟进 #417 的“触发全员工作通知”风险，补充 @all 防护说明与默认关闭/显式开启策略
• 合并 #522 的 AI Card 群聊可追溯诉求：明确应走 atUsers、引用原消息，还是与 #480 的卡片引用回复方案组合交付
• 明确 card 模式下 @sender 通知能力边界，避免与“@指定成员”诉求混淆（#369）
  • #369 feat: add cardAtSender option to @mention sender after card finalization（状态：合并）

10. 支持对话打断 / 取消任务

相关 Issues：

任务：

• 明确用户主动取消的交互形式
• 明确长任务中断机制
• 明确中断后状态回收方式
• 明确 UI / 提示语反馈
• 明确 ACP 最小可用范围（/acp spawn）及 status/steer/cancel 分阶段目标（#310）
• （拟完成，请评估）跟进 #508 的 /btw 旁路问答方案，确认“绕过 session lock + 强制 markdown + 不新建卡片”在实机卡片/群聊场景稳定
  • #508 feat(btw): bypass session lock for /btw side questions（状态：合并）
• 跟进 #489 的原生审批卡片方案，确认 approval callback / 文本命令回退 / origin surface 投递边界后再决定是否推进
  • #489 feat(approval): exec/plugin approval card with command session dispatch（状态：新（草稿，CI 通过））
• 评估 #427 的“停止指令绕过 session 锁”方案与现有卡片停止流程整合边界（避免空卡片 finalize）
  • #427 feat: bypass session lock for real-time stop command support（状态：合并）
• 同步 #531 AI Card stop button 中止语义反馈：issue 已随 #495 回滚 v2 hybrid streaming 关闭，后续若恢复卡片按钮驱动中止能力，需验证底层 embedded run abort 与卡片 finalize 状态一致

11. AI Card usage footer / thinking 展示行为可配置

相关 Issues：

任务：

• 明确 thinking 展示可配置项
• 明确 tool use 展示可配置项
• 明确 usage footer 展示策略
• 补齐默认值与文档说明
• （拟完成，请评估）评估卡片模板多参数/多按钮交互支持方案（#312）
  • #119 AI Card thinking/tool use streaming（状态：合并）
  • #214 make thinking message configurable（状态：合并）
• 明确 /reasoning stream 在钉钉通道的提示与降级策略（#320）
• 回归 reasoning 结束态在钉钉卡片上的收敛行为（#282）
  • #368 refactor: extract ReplyStrategy interface for streaming reply dispatch（状态：合并）
• 回归 /verbose on 下 tool result 流式展示在卡片模式的可见性（#322）
  • #322 fix: wire onToolResult to enable verbose tool streaming in card mode（状态：要求修改，已关闭未合并）
• 修复升级后未配置 ackReaction 时“无反馈”回归（#359）
  • #362 fix(config): add default ackReaction fallback to prevent silent upgrade regression（状态：合并）
• 复核 #332“思考中表情”在钉钉 UI 延迟显示场景下的撤回收敛行为与 API 调用成本
  • #332 feat(dingtalk): add native thinking reaction feedback（状态：合并）
• 跟进 #344 的 review blocking 项（冲突、默认值语义、media deliver 覆盖回归、超时设置），确认 ackReaction 对齐策略后再评估可合并性
  • #344 feat(dingtalk): add native thinking reaction feedback（状态：合并）
• 评估 #314 的“工具执行实时进度提示”与现有 thinking/usage 提示的职责边界及节流策略
  • #314 feat: real-time tool progress notifications during agent tasks（状态：合并）
  • #387 fix(types): remove redundant ackReaction union lint（状态：合并）
  • #388 test(inbound): align ack reaction cleanup expectations（状态：合并）
• 复盘 #314 合并后的会话隔离/kaomoji 兼容/状态机测试覆盖结论，沉淀回归清单
• 复盘 #367 关闭未合并方案与当前主线差异（模板变量契约、callback 入口边界、synthetic message 生命周期）
  • #367 feat: forward card action callbacks to AI with card variable update（状态：已关闭未合并）
• （拟完成，请评估）跟进 #383 入站命令分发重构的阻塞项（CI 失败 + ack reaction 重复/额外时延），确认不引入普通消息路径回归
  • #383 refactor(dingtalk): 抽离入站命令分发逻辑（状态：合并）
• 跟进 AI Card dynamic summary 默认行为，确认配置与展示不引入额外噪声
  • #384 feat: enable dynamic summary for AI cards（状态：合并）
• 复核 #374 的“无思考中反馈”现场是否已被 #362 完全覆盖（含用户配置位置错误场景）
• 跟进 #424 的 /verbose on 可见性反馈，区分“thinking 展示变更”与“工具链路输出被覆盖”两类问题
• 跟进 #428 的单时间线重构非阻塞 review 建议，确认 cardUpdateMode 类型收敛与兼容说明
  • #428 refactor: unify DingTalk AI Card verbose display into a single timeline（状态：合并）
• 跟进 #447 markdown 增量时间线方案，已合并，后续重点观察与 #428 单时间线语义一致性及回归反馈
  • #447 feat(markdown): stream incremental timeline segments（状态：合并）
• 同步 #446 已由 #447 替代并关闭，避免重复跟踪
  • #446 feat(markdown): stream incremental timeline segments（状态：已关闭未合并）
• （拟完成，请评估）跟进 #456 在单聊场景反馈的 /verbose 与 /reasoning 失效问题，复核 #447/#457 是否已完整覆盖（含卡片与 markdown 两种模式）
  • #447 feat(markdown): stream incremental timeline segments（状态：合并）
  • #457 fix(card): unify reasoning-on and reasoning-stream block delivery（状态：合并）

---

P3

12. 流式与响应时延

相关 Issues：

任务：

• 评估 20 秒延迟是否仅在超大规模部署下发生
  • #255 make stream keepAlive configurable and default off（状态：要求修改，已关闭未合并）
• 评估个人场景是否真的需要真流式
• 评估消息更新 API 配额消耗
• 评估低更新频率的替代方案
• 修复 chunk 模式仅显示增量字符的问题
• 给出“继续投入 / 保持现状”的结论
• 跟进 #416 的“分步骤执行但钉钉端最终一次性可见”反馈，明确是通道节流策略、上游 buffering 还是客户端展示限制
• 回归 #341 引入的实时流式开关与默认值，验证“时延改善 vs API 成本”是否达到可接受平衡
  • #341 feat(dingtalk): real-time stream update for card mode（状态：合并）
• 跟进 #414 最新讨论：核对 #447 是否已恢复 markdown 增量时间线，排查后续 card 修复是否造成 markdown 回退，并补真机复现记录与文档说明
• 跟进 #425 乱序反馈，补“卡片模式/markdown 模式/客户端顺序渲染差异”对照复现记录

13. README / 截图 / onboarding / 配置说明补齐

相关 Issues：

任务：

• （拟完成，请评估）补 README 截图
  • #175 docs: align README cardTemplateKey default（状态：合并）
  • #199 docs: align onboarding and runtime defaults（状态：合并）
• 补 onboarding 示例
• （拟完成，请评估）跟进 #537 的 DingTalk Device Flow 自动注册 onboarding：已合并并关闭扫码绑定诉求 #532，仍建议补一次手动扫码/失败回退实机验证
  • #537 feat(onboarding): add DingTalk Device Flow auto-registration to setup wizard（状态：合并）
  • #547 docs: sync user-facing docs with v3.6.0 features（状态：合并）
• 补配置说明
• 补常见问题
• 补排障说明
• 增补 400/protocol mismatch 常见排障示例与配置核对清单（#243/#303）
• 补充 dingtalk.docs.* gateway methods 的使用示例与权限/参数说明（#301）
  • #301 feat(dingtalk): 增加钉钉文档 gateway methods（状态：合并）
• 整合 #328 的多 bot 多 agent 绑定示例到 onboarding/FAQ，减少与 #317 相关配置误解
  • #328 docs: add multi-agent multi-bot binding guide for DingTalk（状态：合并）
• 补充 debug -> dwClientDebug 的迁移说明与兼容窗口说明（#337）
  • #337 refactor: deprecate legacy dingtalk debug config（状态：要求修改，已关闭未合并）
• 增补“钉钉上游能力边界”FAQ：项目管理接口、文档表格编辑、消息输出类型限制（#293/#340/#342）
• 增补“主动消息发送”FAQ 与前置条件（robotCode、会话预热、机器人类型权限、流式模式差异）（#144/#355）
• （拟完成，请评估）跟进 #527 的 dingtalk-connector.* Gateway RPC 兼容：已合并，后续仅需观察兼容 namespace 使用反馈与文档理解成本
  • #527 feat: add DingTalk connector Gateway RPC compatibility（状态：合并）
• 增补“定时/主动发送到指定群”说明（conversationId 直发 + displayNameResolution 能力与版本门槛）（#376/#372）
• 合并 #455 追问：补充 cron/jobs.json 中 conversationId: group:cid... 与 session_key 两种定向发送写法示例
• （拟完成，请评估）跟进 #519 的 CLI 子命令加载噪音：循环依赖已拆除，待补一次发布后 CLI 子命令真实安装路径回归确认噪音已消失
  • #521 fix: break 3 circular import cycles causing CLI RangeError（状态：合并）
• 合并 #520 的 SDK 兼容结论：明确 message send 在 PR #499 之后依赖 openclaw >= 2026.4.5，补版本矩阵、升级提示与低版本保护策略
• 增补“Markdown 表格渲染差异”说明（客户端差异 + 自定义机器人 vs 应用机器人；#192 已按 stale 治理关闭，#358 已关闭）
• 补充 gatewayToken 缺失/错误时的配置排障指引与默认回退行为说明（#370）
• （拟完成，请评估）跟进 #402/#404/#405 安装失败闭环：补版本兼容矩阵与升级指引，并同步已由 #406 修复的范围边界
  • #406 fix: avoid omitting openclaw during plugin install（状态：合并）
• 跟进 #413 的“插件内嵌 openclaw 目录”安装反馈：补充“全新安装仍可出现目录”的复现结论与清理/规避建议
• 基于 #226 2026-03-25 新线索（竞品疑似可读群聊）补一条能力边界说明：若无公开 API 支持则保持 wontfix，避免误导承诺
• 跟进 #421 的 Windows 路径报错反馈：在 FAQ 明确“旧版本（v2.x）升级到 v3.x”优先路径与校验步骤
• 跟进 #423/#426/#434/#435 安装失败反馈：补“安装方式 + OpenClaw 最低版本 + semver 兼容”检查清单
• 合并 #498/#502 的兼容性结论：确认 v3.5.3 已修复 telegram-core 导入缺失，但 qa-lab / install.runtime 安装噪音仍属上游 OpenClaw 打包问题，并补最低兼容版本与升级/回退指引
• 补充 #434/#435 最新进展：标注 clawhub 安装路径缺陷与 semver 紧急修复（b21e501）的适用边界，给出临时 git 安装指引
• （拟完成，请评估）跟进 #552 的 OpenClaw 2026.5.3+ 安装失败：#553 已合并并关闭 issue，后续同时回归 npm 包安装、本地 tarball 安装与源码目录安装路径，补充 scripts/ 仅开发使用且不随 npm/clawhub 包发布的说明
  • #553 fix(package): publish compiled OpenClaw runtime（状态：合并）
• 同步 #445 配置字段收敛（移除 corpId/agentId/robotCode）与 README/onboarding 更新，减少安装与升级期配置歧义
  • #445 refactor: remove dead config fields corpId, agentId, robotCode（状态：合并）
• 补充 cardAtSender 配置参考说明，确保字段类型、默认值与群聊 @sender 行为说明同步到 reference 文档
  • #529 docs: add cardAtSender to configuration reference（状态：合并）
• 评估 #393 的 structured real-device debug sessions 文档/脚本方案，决定合并范围与最小维护面
  • #393 feat: add structured real-device debug sessions（状态：新（草稿））

14. 群聊历史滚动摘要 /summary 命令

任务：

• 同步 #331 状态变更：PR 已关闭未合并，原范围拆分为 #440（message context metadata）与 #441（owner-only /summary）
  • #331 feat(dingtalk): add rolling summary history commands（状态：已关闭未合并）
• 跟进 #440 的基础能力拆分方案，确认 message-context metadata 暴露不引入跨会话串扰
  • #440 refactor(dingtalk): expose message context metadata for summary queries（状态：合并）
• 跟进 #441 owner-only /summary 命令实现，复核 owner 鉴权/历史窗口限制/帮助文本一致性
  • #441 feat(dingtalk): add owner-only summary history commands（状态：合并）
• 对齐 historyLimit 默认值语义（代码默认关闭 vs 注释默认 50）并补充文档
• 在 rebase 后复核 /summary 命令边界（owner 鉴权、token 成本、历史窗口与归档段限制）
• 跟进 #331 最新阻塞项：conversationId 归一化冲突导致历史聚合错路由，需统一 canonical key 策略
• 结合 #331 2026-03-22 最新更新复核“DM scope 统一 / 引用+附件 fallback / target-directory 测试矩阵”是否已消除阻塞项
• 合并 #331 2026-03-25 最新 review：reviewDecision=CHANGES_REQUESTED 仍未翻转，优先收敛 CL test 报错后再复核合并条件
• 同步 #331 2026-03-25 review 阻塞项：将 channel.ts 中新增 chatType/storePath 业务逻辑下沉至目标域并消除与 send-service 的重复推断
• 同步 #331 2026-03-26 最新进展：CI 通过但 CHANGES_REQUESTED 未解除，需逐条核对 reviewer 阻塞项是否全部关闭

---

Milestone 建议

Milestone A：基础可用性收敛

• 消息接收稳定性 / 长时间待机可靠性
• AI Card 发送链路一致性
• 文件上传 / 文件读取 / 文件预览 / 大文件链路
• 图片 / 语音 / 媒体链路补强

Milestone B：高频消息类型与治理能力补齐

• 引用消息 / chatRecord / 转发记录解析收口
• 建立 Issue 提交标准化
• 建立 PR / Issue 自动化流程

Milestone C：配置与体验增强

• 多账号 / 多 agent / schema 与路由配置收敛
• AI Card usage footer / thinking 展示行为可配置
• README / 截图 / onboarding / 配置说明补齐

Milestone D：增强能力与低优先级优化

• 支持群聊 @人 / @all
• 支持对话打断 / 取消任务
• 流式与响应时延

---

建议拆分顺序

第一阶段

• 消息接收稳定性 / 长时间待机可靠性
• AI Card 发送链路一致性
• 文件上传 / 文件读取 / 文件预览 / 大文件链路
• 图片 / 语音 / 媒体链路补强

第二阶段

• 引用消息 / chatRecord / 转发记录解析收口
• 建立 Issue 提交标准化
• 建立 PR / Issue 自动化流程

第三阶段

• 多账号 / 多 agent / schema 与路由配置收敛
• AI Card usage footer / thinking 展示行为可配置
• README / 截图 / onboarding / 配置说明补齐

第四阶段

• 支持群聊 @人 / @all
• 支持对话打断 / 取消任务
• 流式与响应时延

---

/btw bypass session lock — 验证 TODO (PR #508)

• DM /btw 这个函数为什么慢 while bot is idle → blockquote + answer rendered correctly
• DM /btw <question> while a main run is in PROCESSING → BTW answer arrives without waiting for main run
• Group @Bot /btw <question> while main run in PROCESSING → mention stripped from blockquote, sender nickname displayed
• /btw (no question) → openclaw usage error rendered with > [<sender>: ]/btw blockquote prefix (note: <side question> placeholder eaten by markdown — upstream issue openclaw/openclaw#62877)
• Long question (> 80 chars) → blockquote shows truncated form with …
• Card mode (messageType: card): /btw and /stop do NOT create orphan PROCESSING cards (createAICard hoist regression)
• After upgrading to openclaw with isBtwRequestText exported, BTW activates without channel config change