Skip to content

DevTools 时序探针层(M1):写入日志 / flush 轨迹 /事件流 / 组件树快照 - #31

Merged
ShiningRay merged 1 commit into
mainfrom
feat/devtools-m1-probes
Sep 15, 2026
Merged

ShiningRay merged 1 commit into
mainfrom
feat/devtools-m1-probes

Conversation

@ShiningRay

Copy link
Copy Markdown
Owner

内容

M1 探针层,衔接 GOALS.md P1-8 与 PLAN-react-gap T-B3(数据层验收,UI 由 citrine-devtools 仓承接)。

  • lib/citrine/debug/ 四探针(write_log / flush_trace / event_stream / tree)+ 共享环形缓冲 Debug::Ring,全部 prepend 实现、内核零改动
  • 对外入口四件套:Citrine.debug_write_log / debug_flush_trace / debug_event_stream / debug_component_tree + FlushCounter 关联键
  • prod_check needles 3 → 14 项;新增 test/debug_prod_check_test.rb 静态双向守门(新增探针自动纳入断言)
  • 设计/计划文档:docs/DESIGN-devtools.md、docs/PLAN-devtools.md

验证

  • 340 runs / 1093 assertions 全绿(基线 280 + 新增 60)
  • rake prod_check:14 项 needle 在真实 Opal 产物中缺席,反向注入验证非空转
  • 红线:显式 require 才加载,生产构建不含埋点;平台无关核心零 Opal 依赖

备注

工作区另有 fix/dispatch-callable-kwargs 分支(f636518)为未合并 WIP,本 PR 不含;本分支基于最新 origin/main。

- debug/ 子目录四探针:SignalWriteLog / FlushTrace / EventStream / ComponentTree,
  全部 prepend 实现、内核零改动,require citrine/debug 才加载(生产零埋点)
- 共享环形缓冲 Debug::Ring(默认 500 条,容量可调)
- Citrine.debug_write_log / debug_flush_trace / debug_event_stream / debug_component_tree
  四个对外入口 + FlushCounter 关联键(事件→flush 链归因)
- prod_check needles 3 → 14 项,新增 test/debug_prod_check_test.rb 静态双向守门
- docs/DESIGN-devtools.md(分层架构/协议/红线)+ docs/PLAN-devtools.md(M1–M5 计划)
- 340 runs / 1093 assertions 全绿;rake prod_check 真实编译反向注入验证

衔接 GOALS.md P1-8 与 PLAN-react-gap T-B3(数据层已验收,UI 由 citrine-devtools 仓承接)
@ShiningRay
ShiningRay merged commit dbe7d2c into main Sep 15, 2026
10 checks passed
@ShiningRay
ShiningRay deleted the feat/devtools-m1-probes branch September 15, 2026 15:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant