A local-first multi-agent app development platform, built on PenguinHarness
docs(progress): 记下这轮(文件面板能直接看 Word 与 PDF,以及被另一条线收走的那半成品)
lmliheng0dae186329fc
diff --git a/docs/FORK-PROGRESS.md b/docs/FORK-PROGRESS.mdindex 9a073b98..d334a1b4 100644--- a/docs/FORK-PROGRESS.md+++ b/docs/FORK-PROGRESS.md@@ -18078,3 +18078,80 @@ key)、**4.1–4.3**(明令不动)、**5.6** / **5.10**(拍板 / 新依### 提交- 代码 + 用例 + changelog:**`73942f9f`**;本轮台账(本条、5.56 与上表那一行)另起一笔,与历次一致。+## 第一百五十轮:文件面板能看 Word 与 PDF(2026-10-28,用户点单)++### 起点:用户的一句「word,pdf文件不能预览,加预览功能」++- 这是一条**用户直接点单**的活,不是从上游挑的移植。开工时 `HEAD` = `3fec1d9b`;干到一半,自进化那条线+ (`sjaaj` 的会话 `session-2026-10-28-11-00-24-9ed815a0`)在**同一个工作树**里做了第一百四十八 / 一百四十九轮,+ 把这份半成品当成「被应用重启打断的遗留」`git stash push -u` 收进了 `stash@{0}`(它自己在第一百四十八轮+ 的开工自检里写清了,判据是 mtime 与 trace 的 abort,结论是「一条验证都没过」)。本轮从它留下的+ `tracked.patch` + `untracked/` 恢复了改动,继续做到门上全绿。+- 结论照旧留给后面:**这棵工作树是两条线共用的**,一条线的未提交改动会被另一条线在工作区清理时收走;+ 收工前要么提交,要么自己留底。++### 查证:PDF 其实不是「没有预览」这一种毛病++- 先在 Electron 43(桌面壳同一个引擎)里做 A/B:`webPreferences.plugins` 关着,`<iframe src="…pdf">`+ **照样渲染**(截图里页面内容清晰可见)——即「桌面壳没开 `plugins` 所以 PDF 看不了」这个假设是**错的**,+ 没有据此去改桌面壳。+- 在真服务 + 真浏览器里点开文件面板的 `报告.pdf`:iframe 方案能出页面,但这条路的成败**取决于客户端**:+ 浏览器自带阅读器缺失或设成「下载 PDF」时,面板里就是一块空白,和文件坏了长得一样。用户说的「不能预览」+ 最可能就是这种。+- Word 则是确凿的缺口:点开 `.docx` 得到「该类型不支持预览,请下载查看」(截图 `panel-before-设计稿.png`)。++### 做了什么++- **PDF 改成自己画**:`packages/web/src/features/chat/pdf-preview.tsx`(新增)用 `pdfjs-dist` 逐页画到+ 画布上,滚到眼前才画;宽度变化重画不拉伸;单页画布封顶 16MP、像素比封顶 2×;worker 单独成资源。+ 卸载时销毁 **loading task**(这个版本的文档对象没有 `destroy`,第一版就踩了:切文件时抛+ `TypeError: y?.destroy is not a function`,整块预览变空白)。+- **Word 由服务端解析**:`packages/server/src/services/docx-preview.ts`(新增)用已有的 `fflate` 只解+ `word/document.xml`,走标签写成 Markdown(标题按 `w:pStyle`/`w:outlineLvl`、列表按 `w:ilvl`、+ 粗斜体、GFM 表格、实体解码、转义 Markdown 语法字符、输出封顶 20 万字符);新路由+ `<base>/files/preview-text` 两种寻址都注册,`.doc` 回 415 `doc_legacy`、其他类型回 415+ `preview_unavailable`。前端 `doc` 预览只读(无编辑器、无源码视图)。+- **静态资源补 `.mjs`**:`packages/server/src/app.ts` 的 `CONTENT_TYPES` 没有 `.mjs`,pdf.js 的 worker 被+ 以 `application/octet-stream` 提供,浏览器拒绝执行模块脚本(控制台原话:+ `Failed to load module script: … non-JavaScript MIME type of "application/octet-stream"`)。这一条是+ 真浏览器里跑出来才发现的。+- 依赖:`packages/web/package.json` 新增 `pdfjs-dist@^6.4.299`(Apache-2.0;按+ `THIRD-PARTY-NOTICES.md` 的口径,打进包里的 npm 依赖不必另立条目)。++### 验证(都不是推测)++- 真服务(临时数据根 `/root/adelie-fork-data/r148-preview`,端口 **8976**)+ 真 Electron 窗口(Chromium+ 150 / Electron 43,`--remote-debugging-port` 后用 Playwright 的 CDP 连接驱动)+ 真文件(手写的+ `报告.pdf`、用户机器上的 `NEXUS-VISION_Pro_AI眼镜设计稿.docx`):+ - **改前**:`设计稿.docx` → 面板文字「该类型不支持预览,请下载查看」(`panel-before-设计稿.png`);+ `报告.pdf` 走 iframe。+ - **改后**:`报告.pdf` 面板里画出页面文字(`panel-final4-报告.png`);`设计稿.docx` 显示标题层级、+ 粗体、表格(`panel-final4-设计稿.png`);两者来回切换无 `pageerror`。画布像素另核过一次:+ 254×359 的画布上 424 个非白像素(`probe-pages.mjs`)。+ - 中途抓到的两个真缺陷都在这一轮修掉了:worker 的 MIME、`PDFDocumentProxy.destroy` 不存在。+- 单测:`packages/server/test/docx-preview.test.ts`(新增,9 例:Markdown 版式、列表缩进与表格、实体与转义、+ 只解正文部件、截断、拒绝非 docx、路由的 Markdown/ETag/no-store、两种 415、目录寻址、外人 404);+ `packages/web/test/workspace-tree.test.ts` 补 `docx` / `DOC` → `doc` 与只读浏览器的 `unsupported`。+- 门禁:`pnpm --filter @adelie/web typecheck` 与 `--filter @adelie/server typecheck` 均 **EXIT=0**;+ `oxlint` 0 警告 0 错误;改动文件 `prettier --check` 干净;server 全量 test 见下方 CI/门禁记录。+- 端口与数据根:只用 8976(服务)、9223–9225(Electron 调试口),3003 / 7364 / 7777 全程没碰;+ 临时文件落在 scratchpad 的 `electron-test/` 与 `/root/adelie-fork-data/r148-preview`。++### 没做 / 还差什么++- 会话**附件**(`[attached file: …]`,存在会话 scratchpad 里)仍然不能预览:那条路是附件横幅,+ 本来就只有静态文字,这一轮没有把它接到预览上;用户如果是在聊天里点附件,那是另一条改动。+- UI 包只读 `FileBrowser`(评估中心的用例浏览)里的 PDF 仍是 iframe —— 它不做解析请求,这一轮只改+ 文件面板。+- 桌面壳没有改:`plugins` 与 PDF 无关(上面 A/B 已证),不动它。+- `stash@{0}` 里是同一份半成品的历史快照(另一条线留的),本轮内容已在主线提交后失去意义,+ 留待下一轮确认后丢弃。+- **下一轮(用户本轮中途点单)**:学豆包应用的「多图像画板 + 悬浮快捷条」——用户发来截图,图片下浮着一条+ 胶囊工具栏(**编辑**〔带 Tab 键提示〕、**分图层**、**去背景**、**消除**、**扩图**、**变清晰**、+ **引用生成**、最右**下载**),图上有真实像素尺寸角标,右侧还并排着多张结果的缩略图。落点应在图片预览+ (文件面板图片、生成图片卡片)旁边;开工前先把「哪些动作我们能真做、哪些只能跳走」定清楚,别摆一排+ 做不了的按钮。++### 提交++- 代码 + 用例 + 文案 + 文档 + changelog 中英一对:**`e5f9aec6`**;本轮台账(本条)另起一笔,与历次一致。