Adds Claude Code (cc) as a first-class memory host alongside OpenClaw and Hermes#7

Open

YOMXXX wants to merge 17 commits into

Tencent:mainfrom

YOMXXX:feat/claude-code-plugin

YOMXXX commented May 15, 2026 •

edited

Loading

Description | 描述

Adds Claude Code (cc) and OpenAI Codex CLI as first-class memory hosts alongside OpenClaw and Hermes. Users install via /plugin install tdai-memory (cc) or Codex marketplace and immediately get automatic memory recall + capture + manual /memory-* slash skills — with zero mutation of ~/.claude/settings.json or ~/.codex/config.toml. The plugin ships dual manifests (.claude-plugin/plugin.json + .codex-plugin/plugin.json) and shares the same hooks/hooks.json, skills/, and lib/; cc v2026.4+ and Codex CLI v0.117+ both implement the same hook protocol.

新增 Claude Code 与 OpenAI Codex CLI 作为继 OpenClaw、Hermes 之后的两个一等宿主。用户通过 cc /plugin install tdai-memory 或 Codex marketplace 安装后即可获得自动记忆召回 + 捕获 + /memory-* slash 技能，完全不修改 ~/.claude/settings.json 或 ~/.codex/config.toml。插件携带双 manifest（.claude-plugin/plugin.json + .codex-plugin/plugin.json），共享同一份 hooks/hooks.json、skills/ 与 lib/；cc v2026.4+ 与 Codex CLI v0.117+ 均实现了对齐的 hook 协议。

Related Issue | 关联 Issue

Closes #

Change Type | 修改类型

New feature | 新功能 — claude-code-plugin adapter (supports both Claude Code and Codex CLI)
Code optimization | 代码优化 — gateway optional Bearer auth (security hardening, env-gated, backward compatible)
Documentation update | 文档更新 — README EN/CN, CHANGELOG entry

Self-test Checklist | 自测清单

Verified locally | 本地验证通过
- pnpm vitest run → 47/47 passed (6 test files) | 47 单元测试通过
- pnpm test:cc-plugin:e2e → 3/3 passed (真实启动 TdaiGateway + Bearer 鉴权 + 真实 /capture 端到端)
- pnpm build:plugin → no regression | 现有 OpenClaw 构建无回归
- pnpm build:cc-plugin → produces dist/lib/hook.mjs | 产物正确生成
- node dist/src/gateway/cli.mjs → standalone Gateway daemon spawns, /health returns 200 with Bearer auth | 独立 Gateway daemon 真实启动且鉴权通过
- Real-machine cc install + run | Claude Code 真机端到端验证: claude plugin install tdai-memory@tdai-memory-dev 成功；启动 cc 跑一轮对话后 ~/.claude/plugins/data/tdai-memory-tdai-memory-dev/ 下生成正确的 state.json / token (0600) / L0 conversation jsonl；/health 返回 200
No existing features affected | 无影响现有功能
- Gateway change is env-gated: when TDAI_GATEWAY_TOKEN is unset, behavior is identical to today; Hermes 流程完全不受影响
- No changes to index.ts, openclaw.plugin.json, hermes-plugin/, or src/adapters/, src/core/, src/store/
- Only file outside claude-code-plugin/ modified for code: src/gateway/server.ts (~13 lines for optional Bearer middleware)

Additional Notes | 其他说明

实现概述

核心改动（1 个 commit，约 13 行）：
feat(gateway): add optional Bearer token authentication — 当 TDAI_GATEWAY_TOKEN 环境变量被设置时，Gateway 要求所有非 OPTIONS 请求带 Authorization: Bearer <token>；未设置时行为不变。

新增插件目录 claude-code-plugin/：

.claude-plugin/plugin.json — cc plugin manifest
hooks/hooks.json — 3 个 hook：SessionStart（异步预热）、UserPromptSubmit（同步召回 + additionalContext 注入，10K 字符上限）、Stop（异步捕获）
skills/ — 4 个 skill：tdai-memory（总览）、memory-search、memory-status、memory-clear-session（disable-model-invocation: true）
lib/ — 6 个 TypeScript 模块：
- session-key.ts — hash(cwd) 分区，TDAI_SESSION_KEY 可覆盖
- gateway-client.ts — HTTP + Bearer 客户端，失败静默
- transcript.ts — cc transcript jsonl 防御性解析（cc 的 transcript 格式不是稳定 API）
- daemon.ts — spawn / probe / token (chmod 600) / state.json
- hook.ts — 统一 CLI 入口，分发 7 个事件
- gateway-entry.ts — daemon wrapper，处理 SIGTERM/SIGINT + 60s 父 cc PID liveness 探活 + 5s 优雅关闭
tests/ — 47 单元 + 3 smoke e2e
README.md / README_CN.md

设计要点

Plugin 分发 > settings.json mutation：cc 官方推荐，声明式启用/卸载
HTTP+Bearer > 进程内 adapter：与 Hermes 模式对齐，无需重塑核心代码
sessionKey = hash(cwd)：cc 无显式 session-end；按项目分区匹配用户心智模型
Hook 失败静默：记忆系统永远不在对话关键路径上

范围外（计划后续 PR）

MCP server（解锁 Cursor / Cline 等非 cc 客户端）
PostToolUse per-tool 捕获（当前 capture 由 Stop hook 读 transcript 完成，PostToolUse 已从 hooks.json 移除）
跨 Agent 记忆迁移工具

关键架构决策：Gateway 通过 `npx tdai-memory-gateway` 启动

Claude Code / Codex CLI 的 plugin install 只拷贝 plugin 目录，不带 node_modules。这意味着 daemon 进程不能直接 import undici / @ai-sdk/openai 等 npm 依赖。

本 PR 的解法（commit refactor(plugin): spawn Gateway via npx tdai-memory-gateway bin）：

把 Gateway entry 从 plugin 内移出，作为 npm 包自身的一个 bin（tdai-memory-gateway → ./dist/src/gateway/cli.mjs），所有 npm 依赖在 user npm install -g @tencentdb-agent-memory/memory-tencentdb 时解决
Plugin 的 lib/daemon.ts 通过 npx tdai-memory-gateway spawn daemon，传 TDAI_GATEWAY_TOKEN / TDAI_GATEWAY_PORT / TDAI_CC_PID 环境变量
Plugin 本体只有 ~15KB hook.mjs（仅 node: builtins，零 npm 依赖），完全 self-contained
TDAI_GATEWAY_COMMAND 环境变量可覆盖（用于开发，如 node /path/to/cli.mjs）

真机验证状态：

Claude Code：✅ 完整端到端验证通过（/plugin install → SessionStart 触发 → daemon spawn 经 npx tdai-memory-gateway → state.json + token (0600) 生成 → /health 200 → L0 conversation 落盘）。
Codex CLI：plugin manifest 已正确解析、TUI /plugin 可见、cache 文件齐全。本机 source_type=local 的 marketplace 流程触发了一些 codex install-state quirks（与本插件无关，正式 git marketplace 发布后应无此问题）。daemon spawn 逻辑跟 cc 共享同一份 lib/daemon.ts，预期 codex 端在正式发布后行为一致。

Existing PRs

已搜索 open 与 closed PR 列表，未发现 cc / Claude Code 相关历史尝试。本 PR 为此方向首次提议（见关联 design issue）。

兼容性

Hermes plugin 不受影响：Bearer 中间件 env-gated
OpenClaw plugin 入口 index.ts 未改动
无 src/adapters/ / src/core/ / src/store/ 改动
package.json 只新增 scripts 与扩展 files，未删除现有项

DCO

3 个 commits 全部 sign-off（Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>）。

李冠辰 added 16 commits

May 15, 2026 10:39


          feat(gateway): add optional Bearer token authentication

7d30ed7

When TDAI_GATEWAY_TOKEN env var is set, the gateway requires
Authorization: Bearer <token> on all non-OPTIONS requests. When
unset, behavior is unchanged (backward compatible with Hermes).

Required by the Claude Code plugin which spawns the gateway as
a per-user daemon with a randomly generated token.

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          feat(plugin): add Claude Code plugin adapter

73f63e1

Distributes via cc's '/plugin install tdai-memory' with zero
~/.claude/settings.json mutation. Spawns the existing
TdaiGateway as a per-user daemon with a randomly generated
256-bit Bearer token (chmod 600) and binds the daemon's
lifecycle to the parent cc process.

Plugin contents (claude-code-plugin/):
- .claude-plugin/plugin.json - cc plugin manifest
- hooks/hooks.json - 3 hooks: SessionStart (async warmup),
  UserPromptSubmit (sync recall + additionalContext injection,
  capped at 10000 chars), Stop (async capture from cc
  transcript jsonl)
- skills/ - 4 skills: tdai-memory (umbrella), memory-search,
  memory-status, memory-clear-session (disable-model-invocation)
- lib/ - 6 TypeScript modules:
  - session-key.ts: hash(cwd) partitioning with
    TDAI_SESSION_KEY env override
  - gateway-client.ts: HTTP + Bearer client with silent-failure
    semantics
  - transcript.ts: defensive cc-transcript jsonl parser
  - daemon.ts: spawn / probe / token-file / state.json
  - hook.ts: unified CLI entry dispatching 7 events
  - gateway-entry.ts: daemon wrapper with SIGTERM/SIGINT
    handling and 60s parent-pid liveness probe + 5s graceful
    shutdown
- tests/ - 47 unit tests + 3 smoke e2e tests
- README.md and README_CN.md

Build:
- tsdown produces dist/lib/hook.mjs and dist/lib/gateway-entry.mjs
- pnpm build:cc-plugin / test:cc-plugin / test:cc-plugin:e2e

Per-tool buffering (PostToolUse hook) and MCP support are
deferred to follow-up work.

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          docs: changelog entry for Claude Code plugin

517a377

Documents the cc plugin addition and the gateway optional
Bearer token authentication addition.

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          feat(plugin): add Codex CLI compatibility

30e4b4e

Both Claude Code (v2026.4+) and OpenAI Codex CLI (v0.117+)
implement the same hook protocol (SessionStart, UserPromptSubmit,
PreToolUse, PostToolUse, Stop) and read the same hooks.json
schema. The plugin gains a parallel .codex-plugin/plugin.json
manifest with Codex marketplace metadata (interface block:
displayName, brandColor, capabilities, defaultPrompt). All other
artifacts -- hooks/hooks.json, skills/*, lib/*, dist/* -- are
shared verbatim between the two hosts.

README EN/CN and CHANGELOG updated to reflect dual-host support.

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          fix(plugin): use object author in cc manifest

2e4405a

Claude Code's plugin loader strictly validates author to be an
object with {name, email}. The shorthand string form was rejected
with 'Invalid input: expected object, received string'. Align
.claude-plugin/plugin.json with .codex-plugin/plugin.json which
already used the object form.

Discovered via 'claude plugin install tdai-memory@tdai-memory-dev'
real-machine test.

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          refactor(plugin): spawn Gateway via npx tdai-memory-gateway bin

ff0a5d5

cc and Codex plugin install copies only the plugin tree -- there
is no node_modules with the plugin, so the previous
gateway-entry.ts that imported `undici`, `yaml`, `@ai-sdk/openai`
etc. failed with ERR_MODULE_NOT_FOUND on a real plugin install
(despite all unit and e2e tests passing in-repo where
node_modules was available).

Move the Gateway entry into the npm package itself:

- New src/gateway/cli.ts exposed as bin 'tdai-memory-gateway'
  (resolves to ./dist/src/gateway/cli.mjs after build)
- Owns SIGTERM/SIGINT handling and optional TDAI_CC_PID liveness
  probe (60s interval, 5s graceful shutdown budget)
- Plugin claude-code-plugin/lib/gateway-entry.ts deleted
- Plugin lib/daemon.ts spawn now invokes 'npx tdai-memory-gateway'
  (TDAI_GATEWAY_COMMAND env var available to override for dev)
- Plugin lib/hook.ts main() drops the CLAUDE_PLUGIN_ROOT-based
  gateway path resolution (no longer needed)
- Plugin tsdown.config only bundles hook.ts (no npm deps)
- Root tsdown.config adds src/gateway/cli.ts as an entry
- package.json bin: tdai-memory-gateway -> ./dist/src/gateway/cli.mjs
- package.json files: include .claude-plugin/ and .codex-plugin/
- README EN/CN: add prerequisite 'npm install -g
  @tencentdb-agent-memory/memory-tencentdb' and document the new
  TDAI_GATEWAY_COMMAND override
- CHANGELOG entry for the new bin under '兼容性 / 安全增强'

Real-machine verified: cc plugin install + reinstall, hook fires,
SessionStart spawns daemon via 'npx tdai-memory-gateway', /health
returns 200 with Bearer auth.

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          fix(plugin): recall e2e fixes from real-device cc TUI validation

b7473e6

- Add 3-tier recall fallback: /recall → /search/conversations → L0 jsonl
  direct search (covers FTS5-unavailable + no-embedding degraded mode)
- Extend daemon health-check deadline 10s → 30s for slow cold-start
- Merge multi-part assistant responses split by tool-use/result cycles
- Switch handleStop to readAllTurns with MAX_CAPTURE_TURNS=10 cap
- Distinguish real user prompts from system-injected entries via
  contentIsArray to prevent premature turn flush on Skill output
- Add 800ms transcript flush delay before reading (race condition fix)
- Improve L0 direct search: CJK 2-gram tokenization, case-insensitive
  matching, Chinese stop words, assistant-first ranking, dedup

Tests: 51 pass (5 files)

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          fix(plugin): 加固 Gateway Bearer 鉴权与 daemon 进程安全

feeb611

- server: Bearer 比较改用 timing-safe + 大小写不敏感（RFC 6750 §2.1），
  401 响应携带 WWW-Authenticate header，鉴权逻辑抽到 authorize() 方法
- cli: 拒绝非 loopback 的 TDAI_GATEWAY_HOST（需 TDAI_GATEWAY_ALLOW_REMOTE=1
  显式打开）；新增 TDAI_TOKEN_PATH 通过文件传 token 的入口，避免 token
  通过 execve env block 暴露在 /proc/<pid>/environ 或 ps -E
- daemon: spawn 改用 TDAI_TOKEN_PATH 传递并显式删除 TDAI_GATEWAY_TOKEN；
  readToken 跳过 Windows 上失真的 0o077 mode 检查并校验文件 owner uid；
  ensureRunning 复用前校验 state.ccPid 与当前 ppid 一致，避免跨会话/
  跨用户错误复用旧 daemon
- hook + skill: 新增 search-stdin 事件从 stdin 读 query，重写
  memory-search/SKILL.md 用 heredoc 触发 Bash tool 调用，规避 cc 当前
  对 \$ARGUMENTS 字面 replaceAll 导致的命令注入风险（anthropics/claude-code#16163）

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          fix(plugin): Stop hook 改增量发送 + 持久化 cursor，修 L0 重复写入

c7f0da9

之前每次 Stop 都把最近 10 个 turn 全量 POST 给 /capture，Gateway 端
按 Layer 1（originalUserMessageCount 位置切片）与 Layer 2（afterTimestamp
游标）的两层去重都无法生效（CaptureRequest 不携带这两个字段），导致
长会话中前 N-1 个 turn 在每次 Stop 时被反复写入 L0，污染 FTS5 索引
与向量库。

修复：
- 在 \$CLAUDE_PLUGIN_DATA/cursors/<sessionId>.json 持久化 lastSentIndex，
  Stop 时按 allTurns.slice(lastSent) 取增量；首次发送以 50 turn 封顶
  防止历史 transcript 一次性 dump。cursor 文件使用 tmp+rename 原子写。
- 800ms 硬 sleep 改为 waitForTranscriptStable(2s)：每 100ms 轮询
  stat().size，连续两次相同字节数即视为 flush 完成；慢盘场景更稳。
- hook.test.ts 的 stop describe 增加 beforeEach/afterEach 把
  CLAUDE_PLUGIN_DATA stub 到 mkdtemp 隔离 cursor 状态，避免测试间
  cursor 文件污染导致首次 captureTurn 断言被吞掉。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          fix(plugin): 修订 CJK 停用词集 + L0 文件 streaming 读取 + mtime 排序

606a48c

- CJK_STOP 此前包含 "我们/你们/他们/这个/那个/可以/有没/没有/就是/不是"
  等普通双字实义词，"我们的部署方案"会被切成 [们的, 的部, 部署, 署方,
  方案]，丢失 "我们" 这一 anchor token，中文 query 召回严重退化。
  只保留真正低信息量的疑问/连接片段（之前/记得/什么/怎么/请问 等）。
- searchL0JsonlDirect 从一次性 readFile 改为 readline streaming +
  createReadStream，避免长会话 jsonl（数十 MB）一次性载入内存触发 OOM。
- 文件遍历顺序从字符串排序+reverse（依赖 "YYYY-MM-DD.jsonl" 命名）
  改为 mtime 倒序，对 cc transcript UUID 命名也工作正常。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          fix(plugin): daemon 引入 spawn lock + 状态原子写 + 跨平台路径与 cwd 显式化

1f781c8

- ensureRunning 拆出 reuseExisting 子流程；新增基于 O_CREAT|O_EXCL 的
  spawn.lock，并发的 SessionStart/UserPromptSubmit/Stop hook 中只有
  一个 hook 实际调用 spawn()，其余 hook 等候状态文件出现并复用，
  从根本上避免双 daemon 与 token/端口错配。lock 超过 60s 视为陈旧
  自动破除。
- writeDaemonState 改 tmp + rename 原子替换，并发读不会看到半写 JSON。
- spawn 时显式 cwd=dataDir、注入 TDAI_DATA_DIR，避免 Gateway 解析
  数据目录受 hook 进程随机 cwd 影响导致跨会话数据分裂。
- spawn 的 stdio 把 stderr/stdout 重定向到 dataDir/daemon.log，
  daemon 冷启动失败时不再静默丢日志。
- hook.ts main() 数据目录解析改走 resolveDataDir()（os.homedir()），
  Windows 上不再 fallback 到 "." 写当前目录。
- cli.ts 父进程存活轮询从 60s 缩到 15s，cc 异常退出后旧 daemon
  在新会话开启前更及时被回收。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          fix(plugin): GatewayClient 失败追加 hook.log + memory-status 输出日志路径

1a2e1fe

GatewayClient 之前所有 catch 块都是空 catch，captureTurn / recall /
search 静默返回空结果，用户根本无法知道 daemon 是否在工作。

- GatewayClientConfig 新增 logPath：每次 HTTP error / 非 200 / JSON.parse
  失败时按 ISO 时间戳 + method + path + 错误片段追加一行到 hook.log，
  自身追加失败时彻底静默，不影响 hook 返回。
- hook.ts main() 构造 client 时传入 logPath = dataDir/hook.log。
- handleStatus 输出 hook.log / daemon.log 路径，用户在 /memory-status
  即可定位排障文件。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          test: 补全鉴权矩阵、Stop cursor 增量与 ccPid 校验

2dbca67

auth.test.ts（5 → 14）：
- 鉴权对所有 POST 业务端点（/recall, /capture, /search/*, /session/end,
  /seed）的覆盖矩阵，避免回归把鉴权挪进个别 case 分支后逃逸；
- Bearer scheme 关键字大小写 4 个变体（Bearer/bearer/BEARER/BeArEr）
  按 RFC 6750 §2.1 全部应放行；
- 7 种 mangled Authorization 头（Basic、空、带尾巴、prefix/suffix tamper）
  全部期望 401；
- 401 响应携带 WWW-Authenticate: Bearer realm=… 校验。

hook.test.ts stop（2 → 5）：
- 第二次 Stop 只发新 turn（cursor 增量）；
- 无新 turn 时 captureTurn 不被调用；
- 60 turn 长 transcript 首次 capture 在 MAX_CAPTURE_TURNS=50 截断，
  并取 LAST 50（user_content/assistant_content 是 q59/a59）。

daemon.test.ts：
- ensureRunning 拒绝 ccPid 不匹配的旧 state.json，强制走 spawn 路径。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          docs: 同步本轮安全加固与 hook 行为到 CHANGELOG + README

d1bf429

- CHANGELOG Unreleased 段补充本轮 6 个 commit 的安全增强（timing-safe
  Bearer、Bearer scheme 大小写、WWW-Authenticate、host 校验、TOKEN_PATH、
  spawn lock、ccPid 校验、state.json 原子写、Windows 兼容）、修复
  （L0 重复写入 / CJK 召回退化 / 800ms 改轮询 / streaming 读 jsonl /
  silent-failure 日志）、测试补全（auth 矩阵 / cursor 增量 / ccPid 校验）。
- claude-code-plugin/README.md + README_CN.md：环境变量表新增
  TDAI_TOKEN_PATH / TDAI_GATEWAY_HOST / TDAI_GATEWAY_ALLOW_REMOTE /
  TDAI_GATEWAY_CORS_ORIGIN；Data location 新增 spawn.lock / cursors/ /
  daemon.log；排障章节加 daemon.log 索引；安全模型重写覆盖 timing-safe、
  token 文件传递、heredoc 绕开 \$ARGUMENTS、Windows ACL 兜底等要点。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          chore: gitignore 忽略本地 CLAUDE.md

babcabc

CLAUDE.md 用于在仓库内向 Claude Code 声明本项目的协作约定
（DCO 签名、改动范围、测试要求等），但内容是贡献者本地视角，
不应作为仓库历史的一部分。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>


          fix(plugin): 补全 .codex-plugin manifest 的 hooks 引用并标注上游已知限制

088edc2

Codex CLI 与 Claude Code 的 plugin-local hooks 加载机制不同：cc 走"约定俗成路径"
（自动加载 hooks/hooks.json），Codex 则强制从 manifest 的 hooks 字段读取
（codex-rs/core-plugins/src/manifest.rs::RawPluginManifest）。补上
"hooks": "./hooks/hooks.json" 字段后，三个 hook 与现有 ${CLAUDE_PLUGIN_ROOT}
环境变量在 Codex 侧均原生兼容（discovery.rs 注入 CLAUDE_PLUGIN_ROOT backcompat
alias，同时配 PLUGIN_ROOT 新名）。

同时在 README EN/CN 与 CHANGELOG 标注：Codex CLI ≤ v0.130 通过 source_type=local
marketplace 安装时，受上游 openai/codex#22078 影响 skills/hooks 不会暴露到
session；插件这一侧 manifest 已就绪，等上游修复或本插件正式发布到 git
marketplace 即恢复。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>

Collaborator

Maxwell-Code07 commented May 15, 2026

Hi @YOMXXX，感谢你的贡献！将TencentDB-Agent-Memory插件接入Claude Code 和 Codex CLI 是一个很有价值的方向，测试覆盖也很充分。

由于这是一个较大的功能新增（新平台适配器），我们需要走一下标准的评审流程：

技术评审 — 评估设计、代码质量以及与现有架构的兼容性
集成测试 — 验证在 Claude Code 上 L0→L3 完整链路是否正常工作
范围对齐 — 确认功能与我们的公开文档和用户预期一致

我们预计在 1~2 周内给出初步的评审反馈。在此期间，辛苦帮忙确认一下：

CI 能通过
所有 commit 包含 Signed-off-by（DCO 要求）
包含在 Claude Code 上的测试说明

再次感谢你的付出！🙏


          docs: 把 Codex 适配状态从"已就绪"降级为"三层 blocker 部分阻塞"

33e3796

之前文档与 CHANGELOG 把 Codex 适配描述为"hook 协议对齐 / manifest + hook 已就绪
/ 等 #22078 修复后即恢复"——这是过度乐观，掩盖了两个 plugin 端的隐藏 blocker。
实际状态：

1. discovery 层（上游阻塞）：openai/codex#22078，hook 根本不触发；
2. async 行为层（Codex 未实现）：Codex 解析 `async` 字段但 hook engine 中
   没有任何代码消费 `r#async`，HookRunSummary 硬编码 Sync；cc 端 SessionStart/
   Stop 的 `async: true + timeout: 30` 在 Codex 上会变成同步 30s 阻塞；
3. transcript 解析层（plugin 端未适配）：Codex rollout jsonl schema
   `{timestamp,type,payload}` 与 cc transcript `{type,message,sessionId,...}`
   完全不同，当前 lib/transcript.ts 仅解析 cc 格式，即使 Stop 触发也会静默
   生成空 capture。

README EN/CN 重写 "Codex CLI 当前状态：部分阻塞" 小节列出三层 blocker；顶部
"双宿主对齐"陈述降级为 "schema 层对齐 + Codex 部分阻塞"；CHANGELOG Unreleased
对应条目同步调整。Codex 适配的真正运行时验证留到上游 #22078 修复后做（届时
预计追加 hooks/codex-hooks.json 差异化 timeout 与 Codex transcript parser）。

Signed-off-by: 李冠辰 <liguanchen@xiaomi.com>

Maxwell-Code07 mentioned this pull request

Claude Code Plugin Adapter #6

Open

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet