GenarrativeAI/Genarrative
10
0
Fork 0
Code Issues 24 Pull Requests 7 Actions Packages Projects 1 Releases Wiki Activity

同步删除栏目大纲导航的权威文档：PRD 与技术方案改成总览卡片/所有资源/下一页口径

Browse Source 
- decision-log.md：新增「删除资源画布左侧的栏目大纲悬浮导航」决策，先记录查证结论（decision-log / pitfalls / PRD / 技术方案里此前只有要求保留该导航的条文，没有任何删除决策，本次是新决策），再写决策、语义变更、不做什么与变异验证结果。
- PRD：§阶段说明与 §7.2 验收两条不再写"大纲展示全部栏目""通过栏目大纲和滚轮访问全部栏目"，改为栏目大纲由「资源总览」的栏目缩略卡片承载、切栏目走总览卡片 +「所有资源」入口 + 页内「下一页」。
- 技术方案：目标、操作边界与验收共五处删掉"栏目大纲悬浮在画布左侧/只显示图标和栏目名称""点击大纲切页""分页大纲以悬浮 Dock 展示全部栏目"等条文，改成当前状态（左侧不再有悬浮导航）。
- pitfalls.md：补记一条 jsdom 坑——栏目页 fit key 需要非零可测量尺寸，jsdom 下恒为 0，所以"总览→栏目"往返会重新适配视口；进入栏目后应恢复上次 viewport 的用例在 jsdom 里必须避免这种往返，不要误判成产品回归、也不要去改 fit 逻辑。
This commit is contained in:
董羽秦
2026-09-11 13:54:27 +08:00
parent 29b99f213d
commit 399fcacb8e
4 changed files with 27 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md
+2 -2
View File
@@ -53,7 +53,7 @@
#### 3.3.1 资源管理三个串行阶段
1. 阶段一“资源卡本体化”：`dependency / type` 两种布局共用同一个资源卡组件和预览调度器。图片与安全 SVG 直接显示主体并保留透明棋盘底；图片卡按真实纵横比在统一边界内计算展示矩形，视频、音频、文档和项目版本继续使用稳定固定卡片。资源详情是叠加在原画板上的非模态独立卡片，以元数据、Rust 权威依赖关系和版本信息为主；打开详情不得卸载“按依赖 / 按类型 / 复位”等现役画布级动作、资源卡、依赖连线或重置 viewport、搜索和排序模式。
2. 阶段二“分区独立缩放”是历史实现；2026-08-22 起仅在项目完全没有任何资源投影时保留“按类型式分区展览”作为空态。任一栏目出现资源后，`dependency / type` 两种模式均切换为栏目分页画布，默认停留在固定栏目顺序中的第一个非空栏目；大纲展示全部栏目，空栏目计数为 0 且可打开空画布，不再提供分区高度、分区滚动和分区倍率操作。
2. 阶段二“分区独立缩放”是历史实现；2026-08-22 起仅在项目完全没有任何资源投影时保留“按类型式分区展览”作为空态。任一栏目出现资源后，`dependency / type` 两种模式均切换为栏目分页画布，默认停留在固定栏目顺序中的第一个非空栏目；栏目大纲以「资源总览」的栏目缩略卡片承载（左侧那条悬浮大纲导航已删除），空栏目仍可打开空画布，不再提供分区高度、分区滚动和分区倍率操作。
3. 阶段三“依赖布局聚类”（已完成）：仅在 `dependency` 模式中，按固定资源分类对当前 Rust 只读图返回的同类型精确引用边和同类型聚合任务流做弱连通分组；任务流以流节点连接其成员，绝不展开成资源笛卡尔积，但只作为布局邻近提示，不绘制虚线、不进入画布关系说明。`dependencyDepth` 是唯一横向层级权威；每个相关簇先按“最小深度 -> 最小稳定资源 ID”排序，再在同层进行固定两轮由左至右、由右至左的中位数扫描，平局回退稳定资源 ID；同 SCC/环成员保持连续，环后资源继续按 Rust 深度推进。孤立资源是稳定单例组，紧凑排在相关簇之后，簇之间保持固定留白。当前栏目内同类型精确引用参与布局并在该栏目 SVG 中显示；跨分类引用不参与布局，也不在分栏画布中强行连线。搜索只隐藏卡片及任一端点被隐藏的橙色精确引用边，不重算组或压缩坐标。历史 `manuallyPlaced=true` 坐标继续原样保留并参与自动坐标避让。聚类是可派生表现，不新增 manifest 字段、sidecar schema、SpacetimeDB 表或第二套依赖真相。
#### 3.3.2 本体化资源卡交互与性能合同
@@ -509,7 +509,7 @@ type ProjectAgentMudPointAttribution = {
4. 两个窗口基于同一 revision 执行资源自动协调写入时最多一个成功；失败方收到 `conflict` 与最新完整布局，界面不静默覆盖成功方结果。
5. 布局文件缺失的旧项目可以无迁移打开；损坏、未知 schema、身份冲突、超限和链接文件失败关闭，且原文件不被空布局覆盖。
6. 布局读写不改变 manifest、游戏项目 mutation revision、Runtime verification、Agent 权限与预览状态。
7. `1280×720` 最小横屏下完全空项目可通过分区展览查看全部栏目，非空项目可通过栏目大纲和滚轮访问全部栏目（包括空栏目），不出现页面级横向或纵向溢出，右侧对话和底部 Agent 状态栏保持可见；`1280×800` 继续作为默认窗口基线。
7. `1280×720` 最小横屏下完全空项目可通过分区展览查看全部栏目，非空项目可通过「资源总览」的栏目缩略卡片（含第 0 张「所有资源」）、「所有资源」汇总页和页内底部「下一页」访问全部栏目（包括空栏目），不出现页面级横向或纵向溢出，右侧对话和底部 Agent 状态栏保持可见；`1280×800` 继续作为默认窗口基线。
### 7.3 P1 资源依赖关系图验收