Merge remote-tracking branch 'origin/master' into codex/agc-renderer-io-downshift

docs/project-memory/shared-memory/decision-log.md

@@ -1,5 +1,78 @@
 # 决策记录
 
+## 2026-09-28 速览卡只承载概览、范围与设计入口
+
+- 速览卡帮助读者快速理解游戏及本次范围，分类、支柱、循环与目标玩家可融入概述；不复制系统拆分、具体参数、素材数量、完整排除清单或验证计划，不设固定字数或必填章节。
+- 仅在概览内容或入口变化时维护，只链接已有且有用的文档；影响方向或当前范围的重要未决问题简述并引用详细位置。注入说明与样例同步清理，概念阶段必需产物路径、资源登记及审批合同不变，已有用户项目不自动改写。详见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-28 TDD 验证按需去重，范围外内容不自动规划
+
+- 验收判据与必要场景在对应分册完整写一次，其他位置引用并补充独有要求；总册汇总重要结论和缺口，不复制清单。必要数值验算保留，不重复行为状态推演，也不能代替运行验证。
+- 实际构建、交付约束与设计验收条件保留；测试脚本、顺序、截图数量和工具由施工方安排。性能目标与专门验证须有实际依据，未执行不得记录通过。
+- 当前采用值不自动登记调优待办；具体体验疑虑按需验证，不默认制作对照版本。架构和 TDD 对范围外内容只说明必要边界，已确定的后续计划或影响当前设计的要求按需补充，不自动承诺里程碑及扩展实现。TDD 独立施工、四份产物与关键缺口判据不变。详见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-28 TDD 明确设计要求，内部实现由施工方决策
+
+- 保留“只看本套 TDD 就能完成当前范围实现”：写全设计要求、内容与数值、实际工程约束和验收条件，施工方无需回查 GDD 或猜测关键设计。代码组织、算法、内部接口、数据结构、配置载体及资源命名和打包由施工方决定，未预定这些选择不构成策划缺口。
+- 已有工程契约、数据与资源格式、明确交付要求仍须遵循；实现建议不作为唯一方案，不增加逐项登记或用户确认。固定规则不要求配置化，也不禁止施工方使用配置；不承诺尚未定义的模式或开关。文档统一使用“施工方”称谓。
+- TDD 总纲、三分册规则、四模板、四样例及上游交接同步这一边界；样例仍保留真实的玩法、内容、数值与表现缺口，未执行验证不写通过。四文件、资源登记、技术范围、阶段审批与已有项目产物均不变。当前合同见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-28 架构与系统按行为组织协作，减少重复展开
+
+- 系统拆分以有用的独立规则边界为依据，简单职责可合并，不因变量、操作不同或未来替换而增加系统和协作层。架构保留职责、关键协作与共享约束，数据归属和文档位置可合写。
+- 完整流程在主要负责的系统文档展开，参与方写自身接收、处理和返回，按需引用；行为已说明的协作与反馈不再另表复述。规则、相关模板与样例同步，关键顺序、失败处理及 TDD 独立施工要求保留，已有项目产物不自动改写。当前合同见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-28 数据分册按数据形态组织，避免重复列值
+
+- 少量参数合写含义与当前值，同结构多条内容可分列共用属性说明和完整记录；文案集中列一次，其他位置引用唯一权威定义，共用规则集中说明，派生值只保留计算关系。内部字段与配置载体由施工方决定，实际数据契约按需保留。
+- 数据模板、写作规则及样例采用同一口径，当前范围完整内容、数值、文案与验算要求不变。当前合同见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-28 策划文档密度按项目需求与复杂度安排
+
+- 常驻提示词统一要求按项目需求、规模和复杂度组织内容；模板与样例仅供参考，章节和字段按需增减、合并，简单内容简述，复杂或易歧义处充分展开，不为填模板增加设计或重复论证。
+- 精简保留当前阶段判断与后续实现所需信息，TDD 可独立指导当前范围实现的标准不变。当前合同见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-27 TDD 按施工信息简化，验收对象为策划案
+
+- 保留“只看本套 TDD 就能完成当前范围实现”的标准。文档、数据引用与必要验算须完整自洽；保留实际构建与交付约束、验收判据及必要场景，具体测试安排由施工方决定，不要求游戏或素材在策划案验收前已经完成，未执行不得记录通过。
+- 技术选型限定在 Game Agent 已支持的 Web、Unity、Godot、Cocos Creator 范围，不逐框架说明支持程度；新 Web 使用 npm + Vite，二维使用 Phaser 4.2.1，三维按需求选型，预览与导出读取 dist。已有工程不因模板自动迁移。
+- 收编可重组内容，来源版本集中维护；取消固定编写顺序、能力清单、建表步骤、条件架构、检查分级及资产生产台账。数据保留完整内容、数值、文案与验算；美术保留表现要求、对象与状态、用途及实际接入约束；四份必需产物、资源登记与阶段审批不变。
+- 星露谷 TDD 样例统一首个日常原型，具体参数是示例假设，当前施工缺口如实标明，不能将局部算术或未核验的原作资料当作完备证据。当前合同见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-27 系统文档按实际行为展开
+
+- 系统层围绕触发、规则、状态变化、结果与协作组织内容，取消固定十二节、编号追溯、统一取舍表和枚举表达要求；类型规则与模板按需使用，不为填模板添加机制或预设玩法。
+- 十二类资料保留领域问题，职责和数据归属遵循实际架构；UI 维护自身交互与临时状态，正式玩法校验和结算归对应系统。跨系统行动明确成功、失败与中断后的结果。
+- 已定规则、单位和参数留在系统文档，TDD 按相关内容收编并补齐，不依赖固定交接章节；Sxx、产物路径与审批合同保持不变。战斗样例区分暂定原型、撤退与倒下后果及规格缺口，TDD 继续以当前范围可独立施工为完成标准。
+- 当前规则见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-27 系统架构按职责与协作组织
+
+- 架构保留系统编号、职责、权威数据归属、文档位置、实现范围和验证，取消固定系统数量、P0 必需性、统一图表与分类、逐轮变更记录。双向交互按含义与更新顺序判断，不以图上有环自动要求重切。
+- 同一事实由明确的权威方维护；只读副本、派生视图和快照说明来源及更新或恢复方式。必要的规则与参数可在架构明确，由系统文档展开、TDD 收编补齐。
+- `project/03_systems/...` 是策划文档映射，不决定代码目录。系统与 TDD 的直接引用按实际范围衔接，TDD 仍须写全当前施工所需规格；星露谷首个原型包含基础采集，单日选择与多日成长分别验证，样例缺口如实列明。
+- 当前规则见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-27 顶层设计按实际玩法展开
+
+- 顶层说明游玩过程、关键规则与反馈、资源与进展、选择后果和版本范围；取消固定循环层级、回报数量、资源消耗链、日历节奏和失败档位，允许说明玩法所需的具体参数。
+- 原型范围依据验证问题确定，与完整版本范围分开；验证可结合观察、玩家反馈和指标，预期与已验证结论分清。
+- 架构按顶层已有内容检查玩法覆盖，可拆分、合并能力范围并由多个系统协作，不依赖固定循环图、独立定稿章节或逐项映射。TDD 自足性、产物路径和审批合同保持不变。
+- 当前规则见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-27 概念设计按内容组织，取消固定填写程序
+
+- 概念层先利用已有对话与资料，按实际缺口补问；模板和样例按需参考，不强制参照、固定句式、字数、唯一卖点、六项锚点或调性编号。
+- 概念明确核心体验、主要吸引力和重要边界。设计原则帮助判断方向，不代替具体分析；必要的数值、操作或界面信息可以用于说明概念，规模按实际团队与项目条件确定。
+- 规则、模板、样例及下游引用同步调整：重要取舍与视觉设计依据按具体内容或章节引用，不要求张力编号或 T 原则；TDD 继续保留来源版本及完整施工规格。现有产物路径与审批合同不变。
+- 当前规则见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
+## 2026-09-27 策划共享文档按用途和内容变化维护
+
+- 分析文档按需保留重要取舍依据，决策台账集中待处理事项，对话摘要仅在用户需要时维护，速览卡仅随概览内容变化更新；取消概念至系统分册中的重复状态、连续编号和多处登记流程。TDD 同步取消逐项代决登记，规格直接写入 TDD，未决问题解决后补齐正文并关闭待办。
+- 保留“只看 TDD 就能完成当前范围实现”的标准，以及内容收编、来源版本、变更同步和施工所需清单；影响当前实现的关键问题未解决时不能宣称完备。文件路径与现有审批存在性检查不变，不增加内容校验，不批量改写已有项目文件；旧 `resources/SKILL.md` 合并总稿已删除，现役规则由全局提示词、阶段上下文及资源目录登记的分册承接。
+- 当前维护规则见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。
+
 ## 2026-09-22 UI 编辑器预览画布补上右键拖拽平移，节点菜单改为右键抬起弹出
 
 - 背景：预览画布此前只有中键与空格+左键平移，右键整段留给节点操作菜单（`UiTreeRenderer.onContextMenu` 直接弹 `UiNodeContextMenu`）。这次要补右键拖拽平移，并要求"拖拽过就不许再触发右键菜单"。实测（Linux Chromium 151 / Firefox 151，真实 X11 输入）确认 `contextmenu` 在**按下**瞬间触发，且原生菜单一旦弹出，页面之后收不到任何 `pointermove` / `pointerup` / `mouseup` / `auxclick`，所以"先让菜单弹、拖拽时再关"在浏览器层面不可行；headless 没有原生菜单，Playwright 复现不出该行为。macOS 的 `contextmenu` 在 mouseup 触发（本容器无法实测），但同一条实现路径对两种时序都成立。同一次实测：键盘菜单键触发的是 `button: -1`，所以"只认按钮 2"的拦截天然把键盘菜单留给原有节点菜单路径。