Merge pull request 'Deliver file previews, dual-dock placement, and reserved delete/fs capabilities' (#94) from feature/file-preview-caps into main

2026-09-30 17:21:30 +00:00
parent 978dc80817 f958bfb326
commit 2c8e1b8d57
12 changed files with 50 additions and 10 deletions
@@ -51,3 +51,4 @@
 | 同步前验收 | 0b0540e2d251ed6bee77e63fb1ed174dda3ddd41 | 888aa9471c0a6f6917eef1d4801e87b5c411cf6a | 2026-09-30T16:47:54Z |
 | 同步前验收 | 9f2a7fb4b806bb63f43c3ee759bdbb1ab1f97720 | 21a92441dce7787b8c3eaeaf731aad9a58215836 | 2026-09-30T16:49:57Z |
 | 同步前验收 | bb7f541d42dc6bd2609e59fed6760f22ed5c213e | dcb5bc0f727b5ceaf95b73b5ea514e63d9a89ae0 | 2026-09-30T17:17:46Z |
+| 同步前验收 | 978dc80817e7240f0a45a390ed2a6334041e84dd | 4eec51a954c1271729a3659544eb891f0181d8c2 | 2026-09-30T17:19:17Z |
@@ -0,0 +1,39 @@
+# feature/file-preview-caps 任务卡
+
+任务主记录：<PR 链接，task-finish 时填写>；状态：进行中；owner：weichen
+
+## 基线与授权
+
+- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 548ca2b3f1326f298b44cd4b6c94ef7e9d7bdaf8
+- 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-file-preview-caps（worktree）；分支：feature/file-preview-caps
+- 授权与交付终点：实施已裁定的预览方案（D1 引入 Office 依赖、D2 pptx 全保真、D3 OG 卡+可选内嵌、D4 右栏+弹窗双落位、D5 fs 仅配置开关）+ 删除入口回退（保留能力）+ fs 工具族实现不提供；实现+验证+PR 合入 main+gitlink 推进+卡闭合。
+
+## 目标与非目标
+
+目标（方案 docs/proposals/2026-09-30-file-preview-and-reserved-capabilities.md §3–§4）：
+1. @ui FilePreview 能力组件：格式矩阵分派 + 无依赖渲染器（md/图片/pdf/代码行号/数据等宽/二进制卡）+ Office loader 注入槽 + 插件 registerFilePreview + LinkPreviewCard。
+2. backend：GET /api/url-preview（SSRF 拨号时点校验 + 缓存 + 净化错误）；fs 工具族（fs_read/write/list，Hidden + runtime.fsTools 门禁 + <root>/<owner>/<conversation> 沙箱 + 穿越负例全拒 + 写文件登记工件）；ToolDesc.Hidden。
+3. frontend：四个预览依赖（动态 import 懒加载）；DocViewer 收敛为 FilePreview 容器；右栏"预览"页签（railPreview 双落位）；chip/面板行右栏预览动作；**删除按钮回退**（api.deleteArtifact 与后端端点保留，UI 不暴露）。
+
+非目标：Office 在线编辑；语法高亮（highlight.js 另行裁定）；服务端格式转换；fs 的 shell/exec 类操作；URL 预览的正文抓取（仅元数据）。
+
+## 同步记录
+
+| 节点 | sync_base_sha | tested_head_sha | checked_at |
+|---|---|---|---|
+| 启动 | 548ca2b3f1326f298b44cd4b6c94ef7e9d7bdaf8 | 548ca2b3f1326f298b44cd4b6c94ef7e9d7bdaf8 | 2026-09-30T16:17:43Z |
+
+## 结果与验证
+
+- 结果（子仓提交，均基于各自 main 顶端）：
+  - core 4d29301 ToolDesc.Hidden；ui fb76239 FilePreview 能力组件（45 tests）；backend 6d4ccfd url-preview + fs 工具族；frontend 594d151 装配+双落位+删除回退（33 tests）。
+  - D2 备选条款触发记录：pptx2html@0.3.4 module 入口 `./txml` 大小写错配（Linux 打包必炸），改用 pptx-preview@1.0.7（init(dom).preview(arrayBuffer) 全保真），已带证据写入 frontend 提交。
+- 验证：
+  - 各仓：core/backend/frontend/ui 全绿（go test ./...；vitest ui 45 + frontend 33；tsc 干净；构建产物确认主入口仅 +12KB，xlsx 430KB/pptx 1.2MB/jszip 98KB 为首次预览才加载的独立 chunk）。
+  - make test（Dev 组合）全绿。
+  - 服务端负例（严格实例，无放行标志）：/api/tools 无 fs_ 工具；url-preview 对 127.0.0.1/10.0.0.1/192.168.1.1 均回"目标地址被安全策略拒绝"，javascript: 回"仅支持 http/https"。
+  - 头链 Playwright 15/15（7 样例矩阵：csv/go 行号/png/pdf iframe/docx mammoth 正文/xlsx 双 sheet+pptx-preview stage；面板无删除按钮、7 行右栏预览动作；右栏预览页签激活+内容渲染+关弹层保留；chip 双动作）。
+- 影响与剩余项：
+  - fs 工具默认不可见不可调（runtime.fsTools 未开）；开启方式为配置/环境（设置页无开关，D5）。
+  - 删除能力保留于 API（DELETE /api/artifacts/{id}），UI 无入口；将来暴露可加管理开关。
+  - 代码预览无语法高亮；pptx 依赖较重（1.2MB chunk，仅首次预览 pptx 时加载）——如不可接受可回退大纲级（需再裁定）。