diff --git a/.task/feature-docx-paper-preview.md b/.task/feature-docx-paper-preview.md new file mode 100644 index 00000000..65699add --- /dev/null +++ b/.task/feature-docx-paper-preview.md @@ -0,0 +1,28 @@ +# feature/docx-paper-preview 任务卡 + +任务主记录:https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/196 ;状态:进行中;owner:weichen + +## 基线与授权 + +- 权威仓:ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git;目标分支:main;R0(initial_base_sha)= eaae87e635ce31570159637cfe400f099b4daf5b +- 工作区:/home/weichen/projects/Agent-System-Dev-wt-feature-docx-paper-preview(worktree);分支:feature/docx-paper-preview +- 授权与交付终点:实现 docx 纸面原貌预览(令牌、样式、栏宽缩放、测试、浏览器核对、子仓与 Dev PR)。合入 main 与 task-finish 等所有者合入后执行。不改写历史、不改分支保护、不发布版本。 + +## 目标与非目标 + +- 目标:docx 预览固定白纸黑字,保留文档自带样式,窄预览栏整页等比缩小,全屏栏宽足够时保持 100%。 +- 受影响:`DESIGN.md`;UI 仓 tokens/ui.css/FilePreview;Frontend 仓 styles.css、previewsetup、previewfit。 +- 非目标:mammoth 与伪 docx 文本回退仍走主题化 `.doc-viewer`;不改 `renderAsync` 的分页选项;不改 xlsx/pptx 的解析路径。 + +## 同步记录 + +| 节点 | sync_base_sha | tested_head_sha | checked_at | +|---|---|---|---| +| 启动 | eaae87e635ce31570159637cfe400f099b4daf5b | eaae87e635ce31570159637cfe400f099b4daf5b | 2026-10-05T03:54:31Z | +| 同步前验收 | eaae87e635ce31570159637cfe400f099b4daf5b | 10eaaeb8dc4f0e869847d3874a90793be3dfedf9 | 2026-10-05T04:03:56Z | + +## 结果与验证(完成后填写) + +- 结果:UI `b14c9c0`(https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-UI/pulls/35)增加 `--paper` / `--paper-ink` 并允许预览加载器返回清理函数;Frontend `9badbb1`(https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Frontend/pulls/44)把 docx 页画到纸面令牌上并按栏宽缩放。 +- 验证:UI `npx vitest run` 84 通过、`npx tsc --noEmit` 通过;Frontend `npm test` 81 通过、`npx tsc -b` 通过。`make test` 于 2026-10-05 在本 worktree 通过(boundaries、pins、libs、core、backend、frontend 81、ui 84、agent-command)。浏览器核对页:深色窄栏 420px 纸面 `rgb(255,255,255)`、默认墨色 `rgb(0,0,0)`、标题保留文档蓝 `rgb(31,78,121)`、红句保留 `rgb(192,0,0)`,缩放 `matrix(0.496222)`(页宽 794);浅色主题纸面与墨色不变;墨绿主题底座 `rgb(224,224,219)`、纸面仍白;栏宽 998px 时 `transform=none`(100%)。 +- 影响与剩余项:深色主题下 docx 正文恢复可读。mammoth 与伪 docx 文本回退仍走主题化排版。合入权在所有者,合入后才能 task-finish。 diff --git a/DESIGN.md b/DESIGN.md index 75655853..19637ce9 100644 --- a/DESIGN.md +++ b/DESIGN.md @@ -75,6 +75,17 @@ Agent-System-Dev 是桌面优先、Web 兼容的 AI 工作台。界面应**冷 | `--accent` | `#165f49` | 交互强调(翠绿) | | `--primary` / `--primary-foreground` | `#082d4f` / `#f3f8f5` | 主按钮 | +### 2.6 文档纸面(主题不变量) + +Office 分页预览是**内容**,不是界面。纸面与默认墨色固定,三套主题同值: + +| 令牌 | 值 | 用途 | +|---|---|---| +| `--paper` | `#ffffff` | docx 页、幻灯片等文档纸面 | +| `--paper-ink` | `#000000` | 纸面上没有自带颜色的文字的默认墨色 | + +规则:保留文档自己的字号、颜色、表格和图片样式。禁止用 `--bg` / `--text` 等主题令牌覆盖这些内联样式。界面只负责纸面周围的底座(`--bg-inset`)和按栏宽等比缩放。 + ## 3. 字号标尺(唯一字号体系) 全局唯一可调变量 `--ui-font-size`(默认 14px),派生: diff --git a/modules/frontend b/modules/frontend index eb6502f0..9badbb1f 160000 --- a/modules/frontend +++ b/modules/frontend @@ -1 +1 @@ -Subproject commit eb6502f0effd0d02d8a131930fbe60e61d651657 +Subproject commit 9badbb1f85f4af4464561ba5fb311297847e972e diff --git a/modules/ui b/modules/ui index 6b2589c1..b14c9c0e 160000 --- a/modules/ui +++ b/modules/ui @@ -1 +1 @@ -Subproject commit 6b2589c19873719c1c203ef7feb542b20a56799a +Subproject commit b14c9c0e0d744af1b8997b03bcd91701a67822bf