@aiyiran/myclaw 1.1.175 → 1.1.176

package/CLAUDE.md

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

package/assets/myclaw-artifacts.js

@@ -424,7 +424,7 @@
       '__teacher__.json',
       '__teacher-view__.html',
       '__任务__.html',
-      '__debug-data__.js',
+      '--debug-data--.js',
       'USER.md',
       'TOOLS.md',
       'SOUL.md',
@@ -757,11 +757,21 @@
     var OFFICE_EXTS = ['ppt', 'pptx', 'doc', 'docx', 'xls', 'xlsx'];
     var isOffice = OFFICE_EXTS.indexOf(assetExt) !== -1;
 
-    // 压缩包 / 二进制：无法预览，直接下载真实文件（带正确文件名，避免下成无扩展名的 "file"）。
-    // 本地走同源 /api/file，靠 a[download] 强制文件名；远程走 CDN，URL 末段已是真实文件名。
-    var DOWNLOAD_EXTS = ['zip', 'rar', '7z', 'tar', 'gz', 'tgz', 'bz2', 'xz', 'apk', 'exe', 'dmg', 'bin', 'iso'];
+    var VIDEO_EXTS = ['mp4', 'webm', 'mov', 'avi', 'mkv'];
+    var isVideo = VIDEO_EXTS.indexOf(assetExt) !== -1;
+    var isHtml = assetExt === 'html' || assetExt === 'htm';
+
+    // 下载分流：只有「塞进 iframe 也打不开、过去会被浏览器下成无名 file」的
+    // 二进制 / 压缩包类型才走常规下载（带真实文件名）。能在 iframe 里渲染的
+    //（文本 / json / 代码 / 图片 / PDF / 视频 / HTML…）一律保持预览。
+    var DOWNLOAD_EXTS = [
+      'zip', 'rar', '7z', 'tar', 'gz', 'tgz', 'bz2', 'xz', 'zst',
+      'exe', 'msi', 'dmg', 'pkg', 'deb', 'rpm', 'apk',
+      'bin', 'iso', 'ttf', 'otf', 'woff', 'woff2'
+    ];
     if (DOWNLOAD_EXTS.indexOf(assetExt) !== -1) {
       var fileName = asset.name || (asset.path || '').split('/').pop() || 'download';
+      // 本地走同源 /api/file，靠 a[download] 强制文件名；远程走 CDN，URL 末段已是真实文件名。
       var dlUrl = isRemote()
         ? previewUrl
         : MYCLAW_API_BASE + '/api/file?path=' + encodeURIComponent(getWorkspaceId() + '/' + asset.path) + '&t=' + Date.now();
@@ -1158,10 +1168,6 @@
         'background: #fff',
       ].join(';');
 
-      var VIDEO_EXTS = ['mp4', 'webm', 'mov', 'avi', 'mkv'];
-      var isHtml = assetExt === 'html' || assetExt === 'htm';
-      var isVideo = VIDEO_EXTS.indexOf(assetExt) !== -1;
-
       if (isVideo) {
         // <video> 元素支持 range 请求，流式加载，可拖拽进度条，不用 iframe
         // 远程环境：走 CDN（带宽快，不受本机出口限制）

package/assets/myclaw-inject.js

@@ -328,7 +328,7 @@
   function buildTestDonePrompt(keepLogs) {
     var lines = ["我刚才已经完成了测试。"];
 
-    lines.push("请你读取调试数据文件 debug/__debug-data__.js，它是一行 `window.__DEBUG_DATA__ = {...}` 的赋值，里面的 events 数组就是完整运行现场。");
+    lines.push("请你读取调试数据文件 debug/--debug-data--.js，它是一行 `window.__DEBUG_DATA__ = {...}` 的赋值，里面的 events 数组就是完整运行现场。");
 
     lines.push("");
     lines.push("请帮我判断：我们之前的问题是否已经修复。");
@@ -562,14 +562,14 @@
     function buildDebugPrompt() {
       var lines = [];
 
-      lines.push("调试数据文件：debug/__debug-data__.js");
+      lines.push("调试数据文件：debug/--debug-data--.js");
       lines.push("");
       lines.push("学生描述：" + (state.description || "（未填写）"));
       lines.push("");
       lines.push("请从学生描述里提取：我做了什么、发生了什么、我的预期是什么。");
       lines.push("");
       lines.push("如何阅读调试数据（按下面抓重点，别东翻西找）：");
-      lines.push("1. 读调试数据文件 debug/__debug-data__.js，它是一行 `window.__DEBUG_DATA__ = {...}` 的赋值，里面的 events 数组就是完整运行现场。");
+      lines.push("1. 读调试数据文件 debug/--debug-data--.js，它是一行 `window.__DEBUG_DATA__ = {...}` 的赋值，里面的 events 数组就是完整运行现场。");
       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，还原“做了什么 → 触发了什么”的因果链，确认重现路径。");
@@ -666,7 +666,7 @@
 
     function buildLogPrompt() {
       var lines = [];
-      lines.push("目前的信息如下：debug/__debug-data__.js");
+      lines.push("目前的信息如下：debug/--debug-data--.js");
       lines.push("我要解决一个问题：" + state.problem);
       lines.push("");
       lines.push("请优先添加 console.log，文字要清楚，适合小学生看懂。");

package/package.json

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

package/server/debug_record.py

@@ -5,20 +5,20 @@ debug_record.py
 把前端收集到的 currentDebugRecord 落盘成两个文件，供学生/老师/AI 查看。
 
 【架构：数据与渲染分离】
-- __debug-data__.js   —— 每次覆盖写。内容是 `window.__DEBUG_DATA__ = {规范化后的记录}`。
+- --debug-data--.js   —— 每次覆盖写。内容是 `window.__DEBUG_DATA__ = {规范化后的记录}`。
                      这是**唯一数据源**：既喂前端渲染，也给 AI 直接读。
 - 调试日志.html —— 恒定的“壳”。包含 CSS + 前端渲染器 JS，运行时动态加载
-                     __debug-data__.js 并渲染。内容不随数据变化，因此同步循环不会
+                     --debug-data--.js 并渲染。内容不随数据变化，因此同步循环不会
                      反复把它当成“更新”重传。
 
 为什么这么拆：
 1. HTML 壳恒定 → 哈希不变 → 不再被同步误判为更新（根除循环上传问题）。
-2. AI 读的是纯数据 __debug-data__.js，信噪比高，不掺样式。
+2. AI 读的是纯数据 --debug-data--.js，信噪比高，不掺样式。
 3. 渲染逻辑在前端，改样式不用动 Python、不用重启同步进程。
 
 服务端职责（本文件）：
 - 接收 / 校验 / normalize 记录
-- 写出 __debug-data__.js 和 调试日志.html
+- 写出 --debug-data--.js 和 调试日志.html
 渲染职责（前端，在 HTML 壳的内联 JS 里）：
 - 读 window.__DEBUG_DATA__，渲染小结 / 线索 / 运行回放 / 原始数据
 
@@ -65,7 +65,7 @@ ERROR_EVENT_TYPES = {
 
 
 # =============================================================================
-# 2. 保存层：写 __debug-data__.js + 恒定的 调试日志.html 壳
+# 2. 保存层：写 --debug-data--.js + 恒定的 调试日志.html 壳
 # =============================================================================
 
 
@@ -74,7 +74,7 @@ def save_debug_record(record: Dict[str, Any], debug_dir: Path) -> Dict[str, str]
     落盘调试记录。
 
     写两个文件：
-    - __debug-data__.js     每次覆盖，内容 = window.__DEBUG_DATA__ = {normalized record}
+    - --debug-data--.js     每次覆盖，内容 = window.__DEBUG_DATA__ = {normalized record}
     - 调试日志.html 恒定壳（内容不变），负责加载并渲染上面的数据
     """
     debug_dir.mkdir(parents=True, exist_ok=True)
@@ -83,7 +83,7 @@ def save_debug_record(record: Dict[str, Any], debug_dir: Path) -> Dict[str, str]
 
     # 数据文件：每次覆盖
     data_js = "window.__DEBUG_DATA__ = " + safe_json_for_js(normalized_record) + ";\n"
-    data_path = debug_dir / "__debug-data__.js"
+    data_path = debug_dir / "--debug-data--.js"
     write_text_atomic(data_path, data_js)
 
     # HTML 壳：内容恒定（不含数据）。每次都写没关系——内容一致，
@@ -206,7 +206,7 @@ def assert_safe_id(value: str, field_name: str) -> None:
 
 
 # =============================================================================
-# 4. record / event 规范化（数据清洗留在服务端，输出进 __debug-data__.js）
+# 4. record / event 规范化（数据清洗留在服务端，输出进 --debug-data--.js）
 # =============================================================================
 
 
@@ -391,7 +391,7 @@ def safe_json_for_js(value: Any) -> str:
 # 这个函数返回的内容**不随数据变化**，是纯静态的“壳”：
 #   - <style> 页面样式
 #   - 前端渲染器 JS（事件转写 / 错误解释 / 线索提取 / DOM 渲染）
-#   - 运行时动态加载 __debug-data__.js?t=<时间戳> 绕开 CDN 缓存
+#   - 运行时动态加载 --debug-data--.js?t=<时间戳> 绕开 CDN 缓存
 # 渲染逻辑是从原 Python 函数（format_replay_event / simplify_error_message /
 # extract_clues / render_*）逐一移植过来的 JS 版本。
 #
@@ -719,13 +719,13 @@ def render_shell_html() -> str:
 
     // 动态加载数据，带时间戳绕开 CDN 缓存（壳恒定，数据每次新）
     var s = document.createElement("script");
-    s.src = "__debug-data__.js?t=" + Date.now();
+    s.src = "--debug-data--.js?t=" + Date.now();
     s.onload = function () {
       try { render(window.__DEBUG_DATA__); }
       catch (e) { document.getElementById("dynamic").textContent = "渲染失败：" + (e && e.message); }
     };
     s.onerror = function () {
-      document.getElementById("dynamic").textContent = "调试数据加载失败（__debug-data__.js）";
+      document.getElementById("dynamic").textContent = "调试数据加载失败（--debug-data--.js）";
     };
     document.head.appendChild(s);
   })();