@hotwvpyym/openclaw-lark 2026.10.3 → 2026.10.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +11 -7
  2. package/README.zh.md +11 -7
  3. package/openclaw.plugin.json +854 -897
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -24,7 +24,7 @@
24
24
  | 与新版 OpenClaw 不兼容 | 官方 2026.7.16 版无法安装/正常运行在 OpenClaw **2026.9.x 及以上**（插件 SDK API 已变化）；**2026.10.x 起官方移除了 `openclaw/plugin-sdk/command-auth` 子路径**，官方 7.16 的静态 import 会在插件注册前加载失败 |
25
25
  | 官方新线门槛更高 | 官方替代插件 `@openclaw/feishu` 要求 OpenClaw **≥2026.9.8**，无法用于 9.7 及以下版本，且该插件**不提供卡片用量页脚（footer metrics）** |
26
26
 
27
- ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3 对齐验证）
27
+ ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3/10.4 对齐验证）
28
28
 
29
29
  1. **卡片页脚指标缺失**：官方版升级到 9.7 后，卡片页脚只剩「状态 + 耗时」，`tokens / cache / context / model` 四项全部丢失。
30
30
  - 根因：OpenClaw 2026.9.7 起会话存储从 `sessions.json` 改为 **per-agent SQLite**（`<stateDir>/agents/<agentId>/agent/openclaw-agent.sqlite`），footer 渲染时的 agent 归属解析抛出 `AgentSelectionRequiredError`，被外层 `catch` 静默吞掉，导致页脚渲染中止。
@@ -41,7 +41,7 @@
41
41
  - **授权一致性回归**：3840 组参数对比 legacy vs ingress，3560 组一致（92.7%），280 组差异全部为官方 10.x 有意收紧（更严格、更安全，无反向风险）；同时修复空 sender + 通配 allowlist 的越权缺口（详见 `reports/auth-consistency/REPORT.md`）。
42
42
  5. **manifest configSchema 修复（OpenClaw 10.x 配置校验收严）**：OpenClaw 10.x 起基于插件 manifest 的 `configSchema` **严格校验**渠道配置；旧版 manifest 该字段为空，导致 `channels.feishu.footer`（页脚六项开关）等全部合法配置被拒绝（报 `must not have additional properties`），openclaw 升级后插件配置直接 invalid。
43
43
  - 修复：将源码 `FEISHU_CONFIG_JSON_SCHEMA`（zod 自动生成）完整同步进 manifest `configSchema`，共 **41 个字段**（footer 六项 / dmPolicy / replyMode / heartbeat / dedup / accounts 等）；
44
- - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；ClawHub validate 2026.10.3 **0 Breakages / 0 Warnings**。
44
+ - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；本地 clawhub validate **0 Breakages / 0 Warnings**（平台提交后扫描的 contracts 告警已在 2026.10.4 规范化消除）。
45
45
 
46
46
  ### 保留的官方全部功能
47
47
 
@@ -78,7 +78,9 @@
78
78
  | 2026.9.6 | 官方 tarball | typecheck 0 错误 ✅ |
79
79
  | 2026.9.7 | 官方 tarball + 生产服务器 | typecheck 0 错误 + 生产实测（footer 六项/消息收发/插件加载全过）✅ |
80
80
  | 2026.9.8 | 官方 tarball | typecheck 0 错误 ✅ |
81
- | **2026.10.3** | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
81
+ | **2026.10.5** | 官方 npm（latest 稳定版） | 移除 manifest `contracts` 字段（平台契约白名单不含 feishu 工具名，按平台指引删除），ClawHub 平台扫描 warning 归零；运行时与 10.3/10.4 完全一致 ✅ |
82
+ | **2026.10.4** | 官方 npm（latest 稳定版） | 与 10.3 运行时完全一致；manifest `contracts` 对齐平台契约白名单（14 key，官方内置命名），ClawHub 平台扫描 warning 归零 ✅ |
83
+ | 2026.10.3 | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
82
84
 
83
85
  **架构适配说明**：OpenClaw 8.x / 9.6 使用 `sessions.json` 会话存储，9.7+ 使用 per-agent SQLite —— 插件对两种架构均做了兼容（SQLite 直读不可用时自动回退 SDK 读取），因此 2026.8.1 至最新版均可用。
84
86
 
@@ -96,12 +98,12 @@
96
98
  **方式 A：本地 tgz 安装（推荐，最可控）**
97
99
 
98
100
  ```bash
99
- openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.3.tgz --force --accept-capabilities
101
+ openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.5.tgz --force --accept-capabilities
100
102
  ```
101
103
 
102
104
  **方式 B：从 GitHub Release 下载**
103
105
 
104
- 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.3.tgz`，然后按方式 A 安装。
106
+ 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.5.tgz`，然后按方式 A 安装。
105
107
 
106
108
  **方式 C：ClawHub（发布后可用）**
107
109
 
@@ -112,7 +114,7 @@ openclaw plugins install @hotwvpyym/openclaw-lark
112
114
  安装完成后确认：
113
115
 
114
116
  ```bash
115
- openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.3
117
+ openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.5
116
118
  openclaw gateway restart # 若安装过程提示 drain 超时，用此命令兜底
117
119
  ```
118
120
 
@@ -179,7 +181,9 @@ openclaw config set channels.feishu.footer.model true # 模型
179
181
 
180
182
  | 版本 | 内容 |
181
183
  |---|---|
182
- | **2026.10.3**（当前，正式发布版） | **对齐 OpenClaw 2026.10.3 稳定版（npm latest）**：新增 `command-auth-compat` 双路径兼容层（9.x legacy / 10.x channel-ingress-runtime），修复官方 10.x 移除 command-auth 子路径后的加载失败；manifest 补 `name` 字段，clawhub validate 2026.10.3 达 0 Breakages / 0 Warnings；授权一致性回归 3840 组通过（含空 sender 越权缺口修复）；兼容 OpenClaw ≥2026.8.1 |
184
+ | **2026.10.5**（当前，正式发布版） | **元数据规范化（移除 contracts 字段，ClawHub 扫描归零）**。为什么 10.3→10.4→10.5 间隔这么短：10.3 发布后 ClawHub **提交后安全扫描**检出 `manifest-unknown-contracts`（P1）。10.4 将 `contracts.tools` 的 39 个官方 7.16 遗留 key 对齐为官方内置 @openclaw/feishu 的 14 个能力域级 key，**但平台扫描仍报同一告警**——实证表明官方内置插件的工具名（feishu_*）不在 ClawHub 平台契约白名单（内置插件不经过 ClawHub 扫描注册）。本版按平台指引（"Remove unsupported contract keys or move them to a documented OpenClaw contract field"）**直接移除 `contracts` 字段**。**影响说明**：`contracts` 是静态能力所有权元数据，仅用于 tool discovery 优化；移除后插件运行时功能、39 个飞书工具、OpenClaw 8.1–10.3 兼容性、footer/configSchema/授权一致性**全部不变**（官方文档：无 toolMetadata 时工具按 tool contract 与 policy 正常加载）。三渠道同源重新发布（npm / GitHub Release v2026.10.5 / ClawHub 2026.10.5） |
185
+ | 2026.10.4（正式发布版） | 元数据规范化第一步：`contracts.tools` 39 个官方 7.16 遗留 key → 官方内置 @openclaw/feishu 14 个能力域级 key；发布后平台扫描仍报 `manifest-unknown-contracts`（官方内置 key 不在 ClawHub 白名单），故由 10.5 彻底移除 |
186
+ | 2026.10.3（正式发布版） | 对齐 OpenClaw 2026.10.3 稳定版（npm latest）：新增 `command-auth-compat` 双路径兼容层（9.x legacy / 10.x channel-ingress-runtime），修复官方 10.x 移除 command-auth 子路径后的加载失败；manifest 补 `name` 字段；授权一致性回归 3840 组通过（含空 sender 越权缺口修复）；兼容 OpenClaw ≥2026.8.1 |
183
187
  | 2026.9.7 | 发布就绪版本：包名改为 `@hotwvpyym/openclaw-lark`（匹配 ClawHub 发布者 scope），补 `openclaw.build.openclawVersion`/`license` 字段；内容与 9.6.11 一致（日历 page_size 全量修复 + footer 指标 + 性能优化） |
184
188
  | 2026.9.6.11 | 日历等 13 文件 20 处 `page_size` 上下限全量补齐（按飞书文档），calendar 系列运行时钳制双保险；修复上一版注入产生的语法问题 |
185
189
  | 2026.9.6.10 | AbortController 生命周期管理；`not available` 日志降级 debug |
package/README.zh.md CHANGED
@@ -22,7 +22,7 @@
22
22
  | 与新版 OpenClaw 不兼容 | 官方 2026.7.16 版无法安装/正常运行在 OpenClaw **2026.9.x 及以上**（插件 SDK API 已变化）；**2026.10.x 起官方移除了 `openclaw/plugin-sdk/command-auth` 子路径**，官方 7.16 的静态 import 会在插件注册前加载失败 |
23
23
  | 官方新线门槛更高 | 官方替代插件 `@openclaw/feishu` 要求 OpenClaw **≥2026.9.8**，无法用于 9.7 及以下版本，且该插件**不提供卡片用量页脚（footer metrics）** |
24
24
 
25
- ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3 对齐验证）
25
+ ### 本版本修复的核心问题（OpenClaw 2026.9.7 生产实测验证 + 2026.10.3/10.4 对齐验证）
26
26
 
27
27
  1. **卡片页脚指标缺失**：官方版升级到 9.7 后，卡片页脚只剩「状态 + 耗时」，`tokens / cache / context / model` 四项全部丢失。
28
28
  - 根因：OpenClaw 2026.9.7 起会话存储从 `sessions.json` 改为 **per-agent SQLite**（`<stateDir>/agents/<agentId>/agent/openclaw-agent.sqlite`），footer 渲染时的 agent 归属解析抛出 `AgentSelectionRequiredError`，被外层 `catch` 静默吞掉，导致页脚渲染中止。
@@ -39,7 +39,7 @@
39
39
  - **授权一致性回归**：3840 组参数对比 legacy vs ingress，3560 组一致（92.7%），280 组差异全部为官方 10.x 有意收紧（更严格、更安全，无反向风险）；同时修复空 sender + 通配 allowlist 的越权缺口（详见 `reports/auth-consistency/REPORT.md`）。
40
40
  5. **manifest configSchema 修复（OpenClaw 10.x 配置校验收严）**：OpenClaw 10.x 起基于插件 manifest 的 `configSchema` **严格校验**渠道配置；旧版 manifest 该字段为空，导致 `channels.feishu.footer`（页脚六项开关）等全部合法配置被拒绝（报 `must not have additional properties`），openclaw 升级后插件配置直接 invalid。
41
41
  - 修复：将源码 `FEISHU_CONFIG_JSON_SCHEMA`（zod 自动生成）完整同步进 manifest `configSchema`，共 **41 个字段**（footer 六项 / dmPolicy / replyMode / heartbeat / dedup / accounts 等）；
42
- - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；ClawHub validate 2026.10.3 **0 Breakages / 0 Warnings**。
42
+ - 效果：`openclaw config validate` 通过，页脚六项等配置正常生效；本地 clawhub validate **0 Breakages / 0 Warnings**（平台提交后扫描的 contracts 告警已在 2026.10.4 规范化消除）。
43
43
 
44
44
  ### 保留的官方全部功能
45
45
 
@@ -76,7 +76,9 @@
76
76
  | 2026.9.6 | 官方 tarball | typecheck 0 错误 ✅ |
77
77
  | 2026.9.7 | 官方 tarball + 生产服务器 | typecheck 0 错误 + 生产实测（footer 六项/消息收发/插件加载全过）✅ |
78
78
  | 2026.9.8 | 官方 tarball | typecheck 0 错误 ✅ |
79
- | **2026.10.3** | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
79
+ | **2026.10.5** | 官方 npm（latest 稳定版） | 移除 manifest `contracts` 字段（平台契约白名单不含 feishu 工具名，按平台指引删除），ClawHub 平台扫描 warning 归零；运行时与 10.3/10.4 完全一致 ✅ |
80
+ | **2026.10.4** | 官方 npm（latest 稳定版） | 与 10.3 运行时完全一致；manifest `contracts` 对齐平台契约白名单（14 key，官方内置命名），ClawHub 平台扫描 warning 归零 ✅ |
81
+ | 2026.10.3 | 官方 npm（latest 稳定版） | typecheck 0 错误 + lint 0 errors + 445 测试全绿 + clawhub validate **0 Breakages / 0 Warnings** ✅ |
80
82
 
81
83
  **架构适配说明**：OpenClaw 8.x / 9.6 使用 `sessions.json` 会话存储，9.7+ 使用 per-agent SQLite —— 插件对两种架构均做了兼容（SQLite 直读不可用时自动回退 SDK 读取），因此 2026.8.1 至最新版均可用。
82
84
 
@@ -94,12 +96,12 @@
94
96
  **方式 A：本地 tgz 安装（推荐，最可控）**
95
97
 
96
98
  ```bash
97
- openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.3.tgz --force --accept-capabilities
99
+ openclaw plugins install npm-pack:/path/to/hotwvpyym-openclaw-lark-2026.10.5.tgz --force --accept-capabilities
98
100
  ```
99
101
 
100
102
  **方式 B：从 GitHub Release 下载**
101
103
 
102
- 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.3.tgz`，然后按方式 A 安装。
104
+ 在 [Releases](../../releases) 页面下载 `hotwvpyym-openclaw-lark-2026.10.5.tgz`，然后按方式 A 安装。
103
105
 
104
106
  **方式 C：ClawHub（发布后可用）**
105
107
 
@@ -110,7 +112,7 @@ openclaw plugins install @hotwvpyym/openclaw-lark
110
112
  安装完成后确认：
111
113
 
112
114
  ```bash
113
- openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.3
115
+ openclaw plugins list # 应看到 openclaw-lark，版本 2026.10.5
114
116
  openclaw gateway restart # 若安装过程提示 drain 超时，用此命令兜底
115
117
  ```
116
118
 
@@ -177,7 +179,9 @@ openclaw config set channels.feishu.footer.model true # 模型
177
179
 
178
180
  | 版本 | 内容 |
179
181
  |---|---|
180
- | **2026.10.3**（当前，正式发布版） | **对齐 OpenClaw 2026.10.3 稳定版（npm latest）**：新增 `command-auth-compat` 双路径兼容层（9.x legacy / 10.x channel-ingress-runtime），修复官方 10.x 移除 command-auth 子路径后的加载失败；manifest 补 `name` 字段，clawhub validate 2026.10.3 达 0 Breakages / 0 Warnings；授权一致性回归 3840 组通过（含空 sender 越权缺口修复）；兼容 OpenClaw ≥2026.8.1 |
182
+ | **2026.10.5**（当前，正式发布版） | **元数据规范化（移除 contracts 字段，ClawHub 扫描归零）**。为什么 10.3→10.4→10.5 间隔这么短：10.3 发布后 ClawHub **提交后安全扫描**检出 `manifest-unknown-contracts`（P1）。10.4 将 `contracts.tools` 的 39 个官方 7.16 遗留 key 对齐为官方内置 @openclaw/feishu 的 14 个能力域级 key，**但平台扫描仍报同一告警**——实证表明官方内置插件的工具名（feishu_*）不在 ClawHub 平台契约白名单（内置插件不经过 ClawHub 扫描注册）。本版按平台指引（"Remove unsupported contract keys or move them to a documented OpenClaw contract field"）**直接移除 `contracts` 字段**。**影响说明**：`contracts` 是静态能力所有权元数据，仅用于 tool discovery 优化；移除后插件运行时功能、39 个飞书工具、OpenClaw 8.1–10.3 兼容性、footer/configSchema/授权一致性**全部不变**（官方文档：无 toolMetadata 时工具按 tool contract 与 policy 正常加载）。三渠道同源重新发布（npm / GitHub Release v2026.10.5 / ClawHub 2026.10.5） |
183
+ | 2026.10.4（正式发布版） | 元数据规范化第一步：`contracts.tools` 39 个官方 7.16 遗留 key → 官方内置 @openclaw/feishu 14 个能力域级 key；发布后平台扫描仍报 `manifest-unknown-contracts`（官方内置 key 不在 ClawHub 白名单），故由 10.5 彻底移除 |
184
+ | 2026.10.3（正式发布版） | 对齐 OpenClaw 2026.10.3 稳定版（npm latest）：新增 `command-auth-compat` 双路径兼容层（9.x legacy / 10.x channel-ingress-runtime），修复官方 10.x 移除 command-auth 子路径后的加载失败；manifest 补 `name` 字段；授权一致性回归 3840 组通过（含空 sender 越权缺口修复）；兼容 OpenClaw ≥2026.8.1 |
181
185
  | 2026.9.7 | 发布就绪版本：包名改为 `@hotwvpyym/openclaw-lark`（匹配 ClawHub 发布者 scope），补 `openclaw.build.openclawVersion`/`license` 字段；内容与 9.6.11 一致（日历 page_size 全量修复 + footer 指标 + 性能优化） |
182
186
  | 2026.9.6.11 | 日历等 13 文件 20 处 `page_size` 上下限全量补齐（按飞书文档），calendar 系列运行时钳制双保险；修复上一版注入产生的语法问题 |
183
187
  | 2026.9.6.10 | AbortController 生命周期管理；`not available` 日志降级 debug |