@aiyiran/myclaw 1.1.161 → 1.1.164

package/CLAUDE.md

@@ -131,7 +131,9 @@ voice-output.js → voice-input.js → myclaw-tts.js
   │        │ 关闭预览时 POST {claw, workspace, entryFile, events...}
   ▼        ▼
 服务端（sync_workspace.py，本机 18800 / 远程经 nginx /sync）
-  ├─ 按 workspace 自行算目录，写 {workspace}/debug/debug-record.{json,html}
+  ├─ 按 workspace 自行算目录，写两个文件：
+  │     debug-data.js   ← 每次覆盖，window.__DEBUG_DATA__ = {规范化记录}（数据，喂渲染也给 AI 读）
+  │     debug-record.html ← 恒定壳，含 CSS + 前端渲染器，运行时加载 debug-data.js 渲染
   ▼
 同步循环 → 上传 CDN → 可展示给学生
 ```
@@ -142,7 +144,8 @@ voice-output.js → voice-input.js → myclaw-tts.js
 |------|------|------|--------|
 | **probe**（采集侧） | `assets/debug-probe.js` | 在 iframe 内采集现场，`postMessage` 上报 | traceId、workspace、上传、判因 |
 | **collector**（接收侧） | `assets/debug-collector.js` | 父页面收事件、攒记录、关闭时提交 | probe 注入、AI 修复、HTML 模板 |
-| **server**（落库侧） | `server/debug_record.py` | 算目录、校验、渲染 HTML、原子写盘 | 采集、CDN 上传（交给同步循环） |
+| **server**（落库侧） | `server/debug_record.py` | 算目录、校验、normalize、写 debug-data.js + 恒定 HTML 壳 | 采集、CDN 上传（交给同步循环） |
+| **renderer**（渲染侧） | HTML 壳内联 JS（`render_shell_html()` 里） | 读 `window.__DEBUG_DATA__`，渲染小结/线索/回放 | 数据清洗（服务端做） |
 
 ### 关键设计约束（改之前先读）
 
@@ -157,7 +160,10 @@ voice-output.js → voice-input.js → myclaw-tts.js
 
 5. **前端不传文件路径**。前端只传逻辑字段（claw / workspace / entryFile），**服务端自己算目录**。`claw` 不是路径层级，只用于跟本机 `CLAW_NAME` 校验防串写；真实路径是 `{openclaw_root}/{workspace}/debug/`。
 
-6. **落盘只留最新一份**：固定文件名 `debug-record.{json,html}`，每次覆盖。
+6. **数据/渲染分离，落盘两个文件**（固定文件名，每次覆盖）：
+   - `debug-data.js`：`window.__DEBUG_DATA__ = {...}`，唯一数据源（喂前端渲染 + 给 AI 直接读）。
+   - `debug-record.html`：**恒定壳**，内容不随数据变（哈希不变 → 同步不会反复当成更新）。壳内联 CSS + 渲染器 JS，运行时用 `debug-data.js?t=<时间戳>` 动态加载绕 CDN 缓存。
+   - ⚠️ 渲染逻辑（事件转写 / 错误解释 / 线索提取）现在在**前端 JS**（`render_shell_html()` 里），不在 Python。改文案/样式改这里，且因为壳恒定，AI 修 bug 应读 `debug-data.js` 而非 HTML。
 
 ### 接口
 

package/assets/myclaw-inject.js

@@ -555,14 +555,18 @@
       var rec = window.myclawLastDebugRecord;
       var lines = [];
 
+      // 调试数据现在落在 debug-data.js（window.__DEBUG_DATA__ = {...}），
+      // 与 debug-record.html 同目录。AI 直接读这个数据文件即可，不用读 HTML。
+      var dataFile = null;
       if (rec) {
         if (rec.debugRecordPath) {
-          lines.push("调试记录文件：" + rec.debugRecordPath);
-        } else if (rec.debugRecordUrl) {
-          lines.push("调试记录：" + rec.debugRecordUrl);
+          dataFile = rec.debugRecordPath.replace(/debug-record\.html$/, "debug-data.js");
         } else if (rec.workspace) {
-          lines.push("调试记录：" + rec.workspace + "/debug/debug-record.html");
+          dataFile = rec.workspace + "/debug/debug-data.js";
         }
+      }
+      if (dataFile) {
+        lines.push("调试数据文件：" + dataFile);
         lines.push("");
       }
 
@@ -570,12 +574,12 @@
       lines.push("");
       lines.push("请从学生描述里提取：我做了什么、发生了什么、我的预期是什么。");
       lines.push("");
-      lines.push("如何阅读调试记录（不要通读整个 HTML，按下面抓重点）：");
-      lines.push("1. 调试记录是一个 HTML 文件，完整事件数据在 <script id=\"debug-data\" type=\"application/json\"> 这段 JSON 里——只读这段，别看页面样式。");
-      lines.push("2. 先在事件里找 runtime-error / unhandledrejection / 以及 level 为 error 的 console 事件，它们是问题的起点。");
+      lines.push("如何阅读调试数据（按下面抓重点，别东翻西找）：");
+      lines.push("1. 读上面的调试数据文件 debug-data.js，它是一行 `window.__DEBUG_DATA__ = {...}` 的赋值，里面的 events 数组就是完整运行现场。（不要去读同目录的 debug-record.html，那只是给人看的渲染壳。）");
+      lines.push("2. 先在 events 里找 runtime-error / unhandledrejection / 以及 payload.level 为 error 的 console 事件，它们是问题的起点。");
       lines.push("3. 抓住报错事件的 message、stack、filename、lineno——直接定位到源码里出错的那个函数/那几行，只看相关代码段，不要通读整个作品文件。");
       lines.push("4. 再倒着看报错之前的 page-enter / click / keydown / console，还原“做了什么 → 触发了什么”的因果链，确认重现路径。");
-      lines.push("5. 如果没有任何报错（属于逻辑 bug），就对比【学生的预期】和事件里 console 输出 / 交互序列反映出的【实际行为】，差异处就是 bug。");
+      lines.push("5. 如果没有任何报错（属于逻辑 bug），就对比【学生的预期】和 events 里 console 输出 / 交互序列反映出的【实际行为】，差异处就是 bug。");
       lines.push("");
       lines.push("定位到根因后只做最小修复。修复后说明：问题原因、改了哪个文件的哪段代码、为什么这样改能解决。");
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiyiran/myclaw",
-  "version": "1.1.161",
+  "version": "1.1.164",
   "description": "",
   "main": "index.js",
   "bin": {