用途:pattern-debug 用于系统化调试 Pattern 错误,覆盖编译期与运行时问题。若涉及部署或 piece 问题,资料建议改用 cf 技能或阅读 skills/cf/SKILL.md。
主要能力:提供五步调试流程(docs/development/debugging/workflow.md)与错误参考矩阵(README.md);整理常见陷阱文档,如 quick.md、reactive-reference-outside-context.md、handler-inside-pattern.md、immediate-event-invocation.md;并给出浏览器控制台运行时调试工具,用于读取 cell 值、查看 VDOM、检测非幂等计算与 action schema 不匹配。
使用方式:先检查 TypeScript 错误,运行 deno task cf check pattern.tsx --no-run;将错误信息与文档矩阵匹配;再查陷阱文档;通过注释代码逐步缩小到最小复现;修复后运行测试验证。运行时可用 agent-browser eval 调用 commonfabric.readCell()、commonfabric.vdom.dump()、commonfabric.detectNonIdempotent(5000)、commonfabric.getLoggerFlagsBreakdown() 等;交互调试可用 commonfabric.subscribeToCell()、readArgumentCell({ path: ["items"] })、getLoggerCountsBreakdown()、getTimingStatsBreakdown()。
常见问题与限制:handler 应移到模块作用域;Writable/Default 类型需按写入与可空性选择;new Cell() 只接受静态数据;字符串 helper 报错时应按响应式值处理;action 需在 Output 中声明为 Stream 并用 .send() 触发;raw:map 不收敛需检查渲染期事件调用;computed() 包裹 JSX 会破坏条件渲染;瞬态 UI 状态需用 PerSession 等作用域;PerAny 仅作内层覆盖。作用域是数据作用域而非授权,不能替代 CFC/IFC 策略。资料未提供收费、价格、平台与效果信息。