docs: features gap analysis for upcoming feature work

[zhumin-zizhu]

Summary

新增 docs/features-gap.html —— 一份 DingTalk Channel 的功能 Gap 综合提案，与 Discord / Telegram / Feishu / Slack 4 个成熟 channel 插件做完整横向对标，整理出 14 项主 gap (#1-#14) + 2 项补充 gap (#15-#16)。

合入这份提案的目的是给后续工作建一个统一的索引与依据：每个 feature 在动工前都能查到它属于哪个 gap、平台支持到什么程度、对标插件是怎么做的、应该落在哪个优先级。后续 issue / PR 都可以直接 refs docs/features-gap.html#gap-NN，避免再次重复"这功能要不要做 / 平台支不支持"的讨论。

主要内容

• 每条 claim 带证据等级：CONFIRMED（本仓库代码 / SDK 源码已用） / DOCUMENTED（官方文档原文） / COMMUNITY（社区共识） / UNVERIFIED（公开页面抓不到）
• 平台 API 全部锚定到 file:line：本仓库 src/* 行号、node_modules/dingtalk-stream@2.1.4 SDK、apifox 端点页、官方 developerpedia 协议页
• 对标 openclaw extensions：approvalCapability / conversationBindings / pairing.text / directory adapter / collectAuditFindings / doctor / dedup / message tool actions 等都有 file:line 对照
• 优先级建议：P0 fix: enable DingTalk cron message delivery via outbound handler #1/V2 #2、P1 V2 #3/Restore dingtalk: prefix to From/To fields #4/fix: Peer ID registry, proactive message fallback & outbound fixes #12/建议：建立微信/钉钉讨论组，方便项目协作 #13/钉钉收不到消息 #14、P2 Add Markdown formatting support to sendProactiveMessage #6/Add DingTalk interactive card API with streaming updates and rate limiting #7/Implement dmPolicy allowlist enforcement for direct messages #11、P3 error #8/DingTalk SendMessage Issue with webhook #9/dmPolicy: "allowlist" 配置不生效，未授权用户仍可对话 #10/clawdbot更名为openclaw，插件是否支持openclaw #16、不做 Create feat/development branch from v2.0 tag #5、待验证 [Bug] pure text message should be recontructured #15
• 不要做的事清单：避免后续把已证伪的论断（errcode 88 不是限流、机器人 fire-forgot 已 protocol 明示、24h 撤回是单聊明示 / 群聊未提等）当成需求

后续如何使用

• 立项时按 gap 编号引用：在 issue / PR 标题里写 feat: gap-03 ...
• 一项 gap 内的子任务可以拆成多个 PR 增量推进，提案不要求一次到位
• 对 UNVERIFIED 项，先做"前置研究清单"里对应的核实工作再动代码

其中文档中的建议仅为初步调研后的建议,可能有一定的非合理性,一切以后续实现feature实际为主

Test plan

纯文档，无运行逻辑：

• 浏览器打开 docs/features-gap.html 能正确渲染（含 sticky TOC、矩阵表、callout、mockup）
• 资源路径 docs/features-gap/assets/styles.css 引用正常
• 全文 file:line 引用与现行代码 / openclaw 主干 / node_modules/dingtalk-stream@2.1.4 全部已核验
• 钉钉官方 protocol / apifox 端点的原文引用全部由 WebFetch 拉到证据

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

本 PR 新增 docs/features/features-gap.html 和配套样式文件，是一份针对 DingTalk Channel 与 Discord / Telegram / Feishu / Slack 四个成熟插件的横向对标分析，整理出 16 项功能缺口（#1–#16）并给出证据等级标注、优先级建议及参考来源。

• 文档结构完整：涵盖能力对照矩阵、每条 gap 的现状/实现建议/验收标准，以及"不要做"事项清单，每个平台 API claim 均锚定到 file:line 或可点击 URL。
• 各 gap 的 TOC 分组、section badge 与行动优先级表格中的优先级标注在当前 HEAD 已保持一致；引用链接均使用 HTTPS。

Confidence Score: 5/5

纯文档变更，不含任何可执行逻辑，合入风险极低。

本次变更仅新增 HTML 文档和 CSS 样式文件，不涉及任何运行时代码。内容结构完整，各 gap 的优先级标注、证据等级及参考链接均已核验一致，仅发现面包屑路径显示有误（不影响文件实际渲染或链接跳转）。

无需特别关注的文件，仅 features-gap.html 中面包屑路径有一处小错误。

Important Files Changed

Filename	Overview
docs/features/features-gap.html	新增 DingTalk Channel 功能 Gap 综合提案（16 项 gap），内含 TOC、能力对照矩阵、优先级表格、证据等级标注及参考来源。面包屑路径与文件实际位置不符（docs/features-gap → docs/features/features-gap），其余内容结构清晰、优先级标注一致。
docs/features/assets/styles.css	新增文档共享样式表，包含 CSS 自定义属性（颜色、字体、圆角）、响应式布局、证据徽章、聊天框 mockup 等样式。无逻辑问题，路径相对引用正确。

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    P0["P0 · 核心缺口"]
    P1a["P1 · 体验与运维"]
    P1b["P1 · Agent UX"]
    P2["P2 · 健壮性与观测"]
    P3["P3 · 生态扩展 / 按需研究"]
    SUPP["补充 Gap（待验证 / 不做）"]

    P0 --> G01["#01 Interactive & Approval"]
    P0 --> G02["#02 Doctor & Audit"]

    P1a --> G03["#03 Edit / Recall Message"]
    P1a --> G04["#04 Throttling"]
    P1b --> G12["#12 Message Tool Actions"]
    P1b --> G13["#13 Conversation Binding"]
    P1b --> G14["#14 Live Directory"]

    P2 --> G06["#06 持久化 Dedup"]
    P2 --> G07["#07 Snapshot 指标增强"]
    P2 --> G11["#11 入站事件探查"]

    P3 --> G08["#08 启动 Stagger"]
    P3 --> G09["#09 SaaS 工具集"]
    P3 --> G10["#10 机器人菜单"]
    P3 --> G16["#16 TTS Capability"]

    SUPP --> G05["#05 Recall-based Draft（不做）"]
    SUPP --> G15["#15 Pairing Adapter（待验证）"]

    G01 --> G03
    G02 --> G07
    G03 --> G12
    G04 --> G07

Loading

Prompt To Fix All With AI

Fix the following 1 code review issue. Work through them one at a time, proposing concise fixes.

---

### Issue 1 of 1
docs/features/features-gap.html:156
面包屑路径与文件实际路径不符。文件位于 `docs/features/features-gap.html`，但面包屑显示的是 `docs / features-gap`，缺少中间层级 `features`，会让读者误以为文件在 `docs/` 根目录下。

```suggestion
        <p class="breadcrumb">openclaw-channel-dingtalk / docs / features / features-gap</p>
```

_{Reviews (3): Last reviewed commit: "docs(proposal): rename features-gap/ dir..." | Re-trigger Greptile}

[zhumin-zizhu]

感谢 Greptile review，3 处问题已在 commit bbe2bf4 全部修复：

Issue 1 · gap-05 TOC 错归 P1（实际 P3 / 建议不做）

TOC 把 gap-05 移到新增的「补充 Gap（待验证 / 建议不做）」组，与 section badge / 优先级表格 / 状态总览的 Do not implement 全部对齐。

Issue 2 · gap-08 三处冲突 + gap-11 TOC 低估

• gap-08：section badge 从 P2 · 健壮性 改为 P3 · 按需开（默认关），TOC 也从「P2 · 健壮性与观测」移到「P3 · 生态扩展 / 按需研究」组。现在四处来源（TOC / 状态总览 Later / section badge / 优先级表格 P3）一致。
• gap-11：TOC 从「P3 · 生态扩展」移到「P2 · 健壮性与观测」，与 section badge P2 / 优先级表格 P2 / 状态总览 Now (recall/read) + Later 对齐。

顺手把 gap-16 也从「补充 Gap」移到 P3 组（它本身就是 P3），「补充 Gap」组现在只留 gap-05 和 gap-15 两个真正"待验证 / 不做"的项。

Issue 3 · developerpedia HTTP/HTTPS 混用

全文 8 处 http://opensource.dingtalk.com/developerpedia/... 已全部 sed 升级为 https://（lines 943 / 951 / 1241 / 1602 / 1603 / 2120 / 2121 / 2122）。

最终 TOC 分组

P0 · 核心缺口                    01, 02
P1 · 体验与运维                  03, 04
P1 · Agent UX 新增主 gap         12, 13, 14
P2 · 健壮性与观测                06, 07, 11
P3 · 生态扩展 / 按需研究         08, 09, 10, 16
补充 Gap（待验证 / 建议不做）    05, 15