From 2c3f4cfbc91ce97010591764b435d6197cd634bc Mon Sep 17 00:00:00 2001 From: Linghong Date: Wed, 7 Oct 2026 19:27:50 +0800 Subject: [PATCH] =?UTF-8?q?=E5=88=A0=E9=99=A4=E5=B7=B2=E9=AA=8C=E6=94=B6?= =?UTF-8?q?=E7=9A=84=E7=BE=8E=E6=9C=AF=E5=8C=85=E4=B8=B4=E6=97=B6=E8=AE=A1?= =?UTF-8?q?=E5=88=92?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 删除美术包生成需求入参修正的里程碑与实施计划。 删除图集实际产物与语义识别的里程碑与实施计划。 主规范去掉已完成的真实出图视觉验收门禁措辞。 --- ...计划】AGC图集实际产物与语义识别-2026-10-05.md | 51 ------------------- ...计划】AGC美术包生成需求入参修正-2026-10-05.md | 25 --------- ...碑】AGC图集实际产物与语义识别-2026-10-05.md | 44 ---------------- ...碑】AGC美术包生成需求入参修正-2026-10-05.md | 33 ------------ ...案】AI游戏创作智能体App实施计划-2026-06-24.md | 2 +- 5 files changed, 1 insertion(+), 154 deletions(-) delete mode 100644 docs/project-memory/plans/【实施计划】AGC图集实际产物与语义识别-2026-10-05.md delete mode 100644 docs/project-memory/plans/【实施计划】AGC美术包生成需求入参修正-2026-10-05.md delete mode 100644 docs/project-memory/plans/【里程碑】AGC图集实际产物与语义识别-2026-10-05.md delete mode 100644 docs/project-memory/plans/【里程碑】AGC美术包生成需求入参修正-2026-10-05.md diff --git a/docs/project-memory/plans/【实施计划】AGC图集实际产物与语义识别-2026-10-05.md b/docs/project-memory/plans/【实施计划】AGC图集实际产物与语义识别-2026-10-05.md deleted file mode 100644 index 6bd4592a1..000000000 --- a/docs/project-memory/plans/【实施计划】AGC图集实际产物与语义识别-2026-10-05.md +++ /dev/null @@ -1,51 +0,0 @@ -# AGC 图集实际产物与语义识别实施计划 - -- Version: 3 -- Status: Implemented, Awaiting Acceptance -- Date: 2026-10-05 -- Parent Spec: [里程碑](./【里程碑】AGC图集实际产物与语义识别-2026-10-05.md) - -## 顺序与边界 - -1. 删除 AGC schema、解析、错误枚举、options 及新请求中的数量参数；旧身份材料仅用于活动账本查找。 -2. 按源资源摘要与序号保存切片，普通清单与总图正确关联；严格事务快照与恢复白名单支持实际集合，旧固定合同只读兼容。 -3. 修正完成结果白名单以保留模式和网格参数，历史无声明零片结果返回告警；修改美术包回执、复用、重生成快照和结果投影，接受带告警的零切片；保留原完整性、身份、CAS 和预算限制。 -4. 返回完整资源身份及路径标注预览，同步提示词、随包 skill、主规范和共享记忆。 -5. 跑生成、事务恢复、Direct 重生成与工具契约相关测试；Rust check，prompt/skill 检查，编码和文档索引检查。 - -按实现、定向验证、边界复核分段检查，每段约 30 分钟；仅影响上述验收的问题扩大修改。失败时保留旧账本和事务现场，不调用付费 Provider 试错。回滚为本轮客户端代码与说明变更；已落盘的新集合需由支持动态合同的版本读取，不能降级为旧四片判断。 - -## 验证证据 - -- `cargo test --locked --offline --bin genarrative-ai-game-creator-shell canvas_generation_tests`：118 项通过。 -- 同一测试可执行文件的 Direct runtime、tool bridge、MCP、external_generation_state_tests 定向分组：93/44/32/6 项通过。 -- `cargo test --locked --offline --test runtime_prompt_bundle_build --test prompt_source_boundaries`：24 项通过。 -- `cargo check --locked --offline --bin genarrative-ai-game-creator-shell`、`cargo fmt --check` 通过。 -- `npm run skill-pack:check --prefix apps/ai-game-creator-shell`、`npm run check:doc-index`、按变更列表运行 `npm run check:encoding`、`git diff --check` 通过。 -- 用户安装 PyYAML 6.0.3 后，使用 `python3` 重跑通用 skill `quick_validate.py`，随包 `taonier-art-assets` 校验通过（`Skill is valid!`）。 -- 回环 HTTP 测试在允许监听端口的环境运行；真实付费 Provider 与视觉试玩未运行。 - -具体条款与证据见对应里程碑。 - -## 2026-10-06 验收缺口修正 - -- 第二次调用的续生成与完成判据已修复。范围为 Direct 美术包编排、结果构造、对应 Rust 测试和文档。 -- 先删除已有基础图时返回两图的分支；已有图集阶段账本优先进入原恢复逻辑，没有账本才查询可恢复资源，查询错误直接返回。 -- 美术包结果构造返回 Result，固定返回三张通过现有校验的主图；保持零切片告警和原有错误传递，补齐失败明确基础图保留状态。 -- 新增五项回归，仅覆盖只生成缺失图集、prepared/accepted/已保留结果恢复、身份冲突或账本损坏、查询或生成失败，以及两图包不能返回完成；验证实际 POST 数量、冻结请求与基础图文件/登记不变。零片/多片和图片校验边界复用已有覆盖。 -- 定向运行 Direct runtime、canvas generation、tool bridge / MCP 测试及 Rust 检查；运行格式、文档索引、编码和 diff 检查。每段约 30 分钟检查一次范围，不调用真实付费 Provider、不修改用户项目现场。回滚仅涉及本次代码与文档，无持久化格式迁移。 - -### 本次验证证据 - -- `cargo test --locked --offline --bin genarrative-ai-game-creator-shell direct_runtime -- --test-threads=1`：106 项通过，含五项新增回归。 -- 同一测试可执行文件的 `canvas_generation_tests`、`direct_tool_bridge`、`mcp` 分组：118 / 44 / 53 项通过。 -- `cargo check --locked --offline --bin genarrative-ai-game-creator-shell` 通过；现有编译告警未在本轮扩大处理。 -- 修改文件的 rustfmt、编码、文档索引与 diff 检查通过。HTTP 夹具只访问本机回环端口；未调用真实 Provider，也未修改用户项目现场。 - -## 删除重生成末尾多余的参考图检查 - -- 用户已评审并授权删除请求参考 ID 与规范图原始资源 ID 的直接相等要求；保留图集完成结果的资源、对象、任务身份核对。 -- 删除生成账本辅助函数的该参数和比较分支，收口唯一调用方；不引入替代检查或持久化迁移。 -- 删除专门构造不同参考 ID 并要求失败的过期测试步骤；让已有正常完成、崩溃恢复测试使用重新登记的规范图绑定，覆盖本次实际故障，不增加低价值测试。 -- 在约 30 分钟内完成局部修改、定向验证与边界复核；运行 Direct runtime 与 canvas generation 回归、Rust check、格式、编码、文档索引和 diff 检查。不调用付费 Provider、不修改用户项目现场；回滚仅涉及本次局部代码和说明。 -- 验证完成：Direct runtime 106 项、canvas generation 118 项通过，包含改用上传绑定的原完成重放与中断恢复用例；无新增测试用例。Rust check、修改文件 rustfmt、编码、文档索引与 diff 检查通过；未调用真实 Provider，未改写用户项目。 diff --git a/docs/project-memory/plans/【实施计划】AGC美术包生成需求入参修正-2026-10-05.md b/docs/project-memory/plans/【实施计划】AGC美术包生成需求入参修正-2026-10-05.md deleted file mode 100644 index ec58f12bb..000000000 --- a/docs/project-memory/plans/【实施计划】AGC美术包生成需求入参修正-2026-10-05.md +++ /dev/null @@ -1,25 +0,0 @@ -# AGC 美术包生成需求入参修正实施计划 - -- Version: 1 -- Status: Implemented, Awaiting Acceptance -- Date: 2026-10-05 -- Parent Spec: [里程碑](./【里程碑】AGC美术包生成需求入参修正-2026-10-05.md) - -## 修改顺序 - -1. 在 canvas_generation 的既有美术包专用入口显式传递调用用途，独立组装新图集请求的描述数组；复用 media 提示词来源，保留原 brief 意图和冻结请求路径。 -2. 同步必要的工具说明与 taonier-art-assets skill，更新随包摘要及共享排障记忆。 -3. 用 HTTP 夹具验证美术包与普通入口请求和旧任务恢复；定向测试描述边界。 -4. 完成普通 Rust 目标检查、定向 Rust 测试、runtime_prompt_bundle_build、prompt_source_boundaries、skill-pack:check、check:doc-index、check:encoding 和 diff 检查；记录实际证据与限制。 - -## 检查点与风险 - -首轮以 45 分钟完成请求修改与定向验证为检查点；仅测试失败或验收缺口扩展范围。旧请求按持久快照恢复，不能修改原幂等身份或借升级新建付费操作。付费 Provider 验证不在本地夹具中执行。 - -## 回滚 - -回退本次客户端请求组装和随包文案即可；没有服务端、工具参数或持久化 schema 迁移，已冻结的新旧请求继续按原快照恢复。 - -## 验证完成 - -按计划完成美术包入口隔离、描述数组组装、共享文案、skill 摘要与主规范同步。53 项定向 Rust 测试、普通构建检查和文档 / 编码 / 差异门禁通过，逐项证据见里程碑。没有执行真实付费生成；本次不修改服务端、brief 长度合同或切片处理。 diff --git a/docs/project-memory/plans/【里程碑】AGC图集实际产物与语义识别-2026-10-05.md b/docs/project-memory/plans/【里程碑】AGC图集实际产物与语义识别-2026-10-05.md deleted file mode 100644 index 8a9eb7a71..000000000 --- a/docs/project-memory/plans/【里程碑】AGC图集实际产物与语义识别-2026-10-05.md +++ /dev/null @@ -1,44 +0,0 @@ -# AGC 图集实际产物与语义识别 - -- Version: 3 -- Status: Implemented, Awaiting Acceptance -- Date: 2026-10-05 -- Parent Spec: [AGC 实施计划](../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md#2026-08-23-direct-codex-美术包显式重生成与切片投影) - -## 范围与评审 - -用户已确认客户端范围并指示开工；按已讨论方案复核入口、持久化、恢复和 Agent 说明后实施。此前生成需求入参工作已有定向验证，用户指示继续第三项；本轮不改变其请求内容合同。 - -必须移除客户端数量参数及按顺序赋义，按实际产物返回完整身份和可查看图片。风险项为动态集合事务、旧活动账本恢复与零切片告警；可选的自动语义分类、补切工作流不实施。服务端 API 与 OpenAPI 不变。 - -2026-10-06 用户复核发现复用两张基础图时跳过缺失图集、并将不完整包返回 completed；续生成与完成判据已修复。随后用户明确要求删除第三次显式重生成末尾错误的参考资源 ID 相等检查，保留任务完成结果核对。本次继续修正同一里程碑验收缺口，不改输入长度校验，不增加参考图恢复工作流。 - -## 验收 - -1. 美术包及普通新请求完全不含 sliceCount；工具不接受该参数，保留模式和网格参数。 -2. 0/2/4/6 个有效切片均按实际结果保存；零片保留有效总图并告警，身份或文件不可信仍拒绝。 -3. 中性路径按源图隔离，无按序用途字段；两个工具提供全部资源身份及可定位预览。 -4. Agent 说明明确内容要求不是严格数量或用途保证，先看图再处理；本地产物通过既有工具登记。 -5. 完成账本保留切分声明，历史零切片账本缺少声明时带告警保留总图；事务与重生成恢复核对动态集合；旧固定事务、旧用途文件和旧已付费请求继续可恢复且不增加生成 POST。 -6. 定向测试、Rust 检查、提示词与 skill 包、文档索引、编码及 diff 检查通过；真实 Provider 未验证部分明确记录。 -7. 已有规范图和背景图但缺图集时，仅补齐图集；已有请求优先恢复原身份，无请求才只读查找并按需生成。查询失败、身份冲突或账本损坏不能触发新的生成。 -8. 整包只有三张主图有效才返回 completed；图集失败保留已有基础图并返回明确错误，零切片和实际多切片仍按原合同交付。恢复用例证明无新增付费请求，基础图的文件和登记保持不变。 -9. 规范图重新登记导致请求参考 ID 与原始资源 ID 不同时，整包正常完成和中断恢复均可收口；仍核对本轮图集完成结果，不改变账本格式或触发重新生成。 - -## 验收证据 - -| 条款 | 结果与证据 | -| --- | --- | -| 1 新请求与工具合同 | HTTP 夹具断言普通/美术包新请求完全不含 sliceCount；MCP schema 和解析拒绝旧工具参数，模式及网格字段保留 | -| 2 实际数量与零片 | `spritesheet_commits_actual_slice_sets_and_isolates_ordinary_outputs` 覆盖普通与严格提交的 0/2/4/6 片；零片总图、告警及回执可读；已有透明度、身份、像素和预算测试继续通过 | -| 3 路径与投影 | 同一夹具验证目录隔离、真实总图路径及无用途别名；`art_result_returns_all_resources_and_labels_bounded_previews` 验证九项身份完整、七张有界预览逐项标注及剩余路径 | -| 4 Agent 说明 | 工具与随包 skill 改为看图识别、按实际内容处理；skill-pack:check 与提示词测试通过 | -| 5 恢复与兼容 | 新旧请求三种状态及旧输出槽 HTTP 夹具保留原正文/幂等身份，已受理任务无新生成 POST；动态事务中断恢复、路径白名单、原固定合同与 Direct 重生成回归通过；动态包复用和快照漂移检测覆盖 0/2/4/6 片 | -| 6 工程检查 | 生成组 118、Direct 运行时 93、工具桥 44、MCP 32、账本 6、提示词 24，共 317 项 Rust 测试通过；cargo check、rustfmt、skill 包、文档索引、变更文件编码及 diff 检查通过 | -| 7 补齐与恢复（2026-10-06） | 五项新增回归覆盖只生成缺失图集、三种请求状态恢复、查询/生成失败、身份冲突/账本损坏和完成判据；断言只提交所需图集请求，已受理或已有结果不新增生成 POST，基础图文件与登记不变 | -| 8 完成与保留（2026-10-06） | 两图包结果构造返回错误；图集失败返回原原因及基础图保留状态；已有零片/多片、图片校验与重生成测试继续通过。此次 Direct 106、生成 118、工具桥 44、MCP 相关 53 项通过，Rust check、格式、编码、文档索引和 diff 检查通过 | -| 9 删除参考图 ID 重复比较（2026-10-06） | 原完成重放及严格提交中断恢复用例改用不同原始/上传资源 ID 的规范图绑定，两条路径均完成；删除旧的参考 ID 不同即失败断言。Direct 106、生成 118 项通过，cargo check、格式、编码、文档索引和 diff 检查通过；没有新增测试用例或调用真实 Provider | - -使用本地 HTTP 夹具验证生产入口，没有调用真实付费 Provider，也没有客户端视觉试玩；这些测试不证明素材语义正确。用户安装 PyYAML 6.0.3 后，使用 `python3` 重跑通用 skill `quick_validate.py`，随包 `taonier-art-assets` 校验通过（`Skill is valid!`）；仓库 skill 包完整性检查和提示词/随包 skill 回归也已通过。原无参数全仓编码命令受沙箱子进程限制，按真实变更文件列表重跑通过。 - -实现等待视觉与产品验收，PR 保持草稿。本轮服务端与 OpenAPI 无修改。 diff --git a/docs/project-memory/plans/【里程碑】AGC美术包生成需求入参修正-2026-10-05.md b/docs/project-memory/plans/【里程碑】AGC美术包生成需求入参修正-2026-10-05.md deleted file mode 100644 index 41dce4bfe..000000000 --- a/docs/project-memory/plans/【里程碑】AGC美术包生成需求入参修正-2026-10-05.md +++ /dev/null @@ -1,33 +0,0 @@ -# AGC 美术包生成需求入参修正 - -- Version: 1 -- Status: Implemented, Awaiting Acceptance -- Date: 2026-10-05 -- Parent Spec: [AGC 实施计划](../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md#2026-08-23-direct-codex-美术包显式重生成与切片投影) - -## 目标与范围 - -让美术包核心图集实际提交的 `iconDescriptions` 包含 brief 与现有内容、风格和排布要求。用户已确认此前方案并指示开工；实现前复核入口隔离、冻结请求恢复和服务端纯色底处理边界，评审通过。 - -必须完成请求组装、Agent 可见说明、定向测试和文档同步。风险项是普通图标入口串用模板、超长描述与重复付费恢复。范围外保留 brief 长度契约调整、固定四片和用途识别、重生成授权措辞及服务端行为修改。 - -## 验收标准 - -1. 新美术包图集的真实 HTTP 请求保留 brief，并在有效字段中包含内容、风格与间距要求；参考与比例/尺寸仍由正式字段承载。 -2. 普通图标入口保持原文单项提交，规范图与背景生成参数不变。 -3. 新增描述满足 API 条数、单条、总字符与字节限制；不截断或拆分用户原文。 -4. 旧 prepared 请求保持原 POST 字节及幂等键；accepted / 已完成请求不新建付费请求，brief 变化仍拒绝冒充同一意图。 -5. 工具参数无新增；工具说明、随包 skill 与主规范一致。提示词、skill 包、编码及差异检查通过；真实 Provider 效果独立标记。 - -## 证据 - -| 验收项 | 证据 | -| --- | --- | -| 新请求与普通入口隔离 | `art_package_spritesheet_posts_requirements_but_ordinary_icons_keep_original_text` 经生产生成入口和本地 HTTP 夹具检查真实请求及重复调用，已通过 | -| 原文与 API 边界 | `art_package_descriptions_keep_the_entire_brief_within_api_limits`、`art_package_description_limits_include_separators_and_utf8_bytes`，覆盖 200/201 码点、100/101 条、2000 字符及 6144 字节边界，已通过 | -| 旧任务恢复 | `art_package_spritesheet_recovers_old_requests_without_injecting_new_requirements` 覆盖 prepared / accepted / legacy-completed 三种旧单条请求；正文与幂等键不变，重复调用不新增生成 POST，已通过 | -| 相关回归 | 美术包过滤组 9 项、普通图标/背景/恢复/skill 包过滤组 20 项，全部通过 | -| 提示词与普通构建 | `runtime_prompt_bundle_build` 18 项、`prompt_source_boundaries` 6 项及 `cargo check --locked --offline --bin genarrative-ai-game-creator-shell` 通过 | -| 文档与资源 | skill-pack:check、check:doc-index、变更文件编码、rustfmt 和差异检查通过 | - -总计 53 项 Rust 测试通过。本地 HTTP 夹具需要监听回环端口，沙箱限制后已在获准的沙箱外环境重跑通过。真实客户端 / 付费 Provider 整包生成未执行；这些证据证明请求传输与恢复，不保证生成图片的视觉质量。后续客户端切片工作由独立规范覆盖。 diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md index d69c358ae..db5a31802 100644 --- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md +++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md @@ -1637,7 +1637,7 @@ game-project/ - 本地事务按固定合同文件与本次实际切片集合冻结快照、提交及恢复，保留摘要、真实 alpha、可见像素、唯一身份、项目归属、资源预算和 CAS 校验。重生成的旧快照包含实际旧切片；历史固定集合事务仍可恢复，不重写旧账本或请求体。普通调用升级前携带数量的活动请求必须在新 POST 前被定位并继续使用原身份；多个可能候选时失败关闭，不能任选或重复付费。 - 图集完成结果账本保留响应的 `sliceMode/gridX/gridY`，以支持同身份重放。历史账本已丢失切分声明且返回零切片时，声明无法用于证明切片方式；保留有效总图并明确告警，不因此重发生成。存在实际切片时仍要求切分声明一致。 - 两个工具都返回总图、完整切片路径、全部资源身份、告警以及有界预览。每张预览明确绑定路径，列出未内嵌预览的路径，Agent 使用现有图片查看能力继续检查。可验证的本地处理产物经现有导入工具登记；游戏语义绑定放在游戏工程中。 -- 验收覆盖新 HTTP 请求完全省略数量字段、0/2/4/6 张切片、不同图集目录隔离、完整资源投影、旧账本零新增生成 POST、动态集合事务恢复与路径白名单；真实 Provider 视觉质量独立验收。 +- 验收覆盖新 HTTP 请求完全省略数量字段、0/2/4/6 张切片、不同图集目录隔离、完整资源投影、旧账本零新增生成 POST、动态集合事务恢复与路径白名单。 - 美术包核心图集的新请求必须把 brief 原文与客户端的素材内容、风格和排布要求共同写入 `iconDescriptions`。内容覆盖当前玩法需要的玩家主体及状态、目标或收集物、障碍或场景元素、反馈特效；各素材独立排布并留出切分间距，沿用规范图的轮廓、材质、色板与光照。描述条数和内容类别不代表切片数量或返回顺序。规范图通过 `referenceId`、比例和尺寸通过正式参数传入；透明结果由服务端纯色底生成与抠图提供，不向模型追加直接生成透明背景的要求。`generationInputs.artSpec` 仅保留描述性上下文，不能作为要求已进入生成提示词的证据。 - Agent 在普通图集的 `prompt` 和美术包的 `brief` 中，需求明确时须列出各项素材的数量、状态及独立排布与留白要求；数量未确定时不编造。数量用于表达生成目标，不构成服务端切片数量保证，也不赋予返回顺序语义；生成后仍须看图确认实际切片内容与用途。工具参数说明与随包 skill 使用同一口径。