From 063905ee5f6f2321ecdef9eab5b209fff53e1ae4 Mon Sep 17 00:00:00 2001 From: lhk Date: Mon, 5 Oct 2026 06:28:55 +0100 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20Direct=20=E9=87=8D?= =?UTF-8?q?=E6=9E=84=E6=89=8B=E5=8A=A8=E9=AA=8C=E6=94=B6=E4=B8=8E=E8=8C=83?= =?UTF-8?q?=E5=9B=B4=E7=A1=AE=E8=AE=A4=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 记录用户已完成手动 GUI 检查及 PR 已移除 WIP 明确视觉与玩法检查保持现状并清理后续调整的过期说明 同步主规范、里程碑、实施计划和共享决策记录 保留专项平台验证的证据边界，不记录此前 CI 失败 --- ...实施计划】Direct交付合同简化-2026-10-04.md | 18 ++++++++++++------ ...计划】Direct操作控制与租约简化-2026-10-03.md | 8 ++++++-- .../【里程碑】Direct交付合同简化-2026-10-04.md | 8 ++++---- ...程碑】Direct合同与租约机制重构-2026-10-03.md | 8 ++++---- .../shared-memory/decision-log.md | 8 +++++++- ...案】AI游戏创作智能体App实施计划-2026-06-24.md | 2 +- 6 files changed, 34 insertions(+), 18 deletions(-) diff --git a/docs/project-memory/plans/【实施计划】Direct交付合同简化-2026-10-04.md b/docs/project-memory/plans/【实施计划】Direct交付合同简化-2026-10-04.md index 9d0374d51..2696b2f48 100644 --- a/docs/project-memory/plans/【实施计划】Direct交付合同简化-2026-10-04.md +++ b/docs/project-memory/plans/【实施计划】Direct交付合同简化-2026-10-04.md @@ -2,8 +2,8 @@ | 字段 | 值 | | --- | --- | -| Version | 0.2 | -| Status | implemented（用户指令已授权实施；真实模型及 Windows smoke 待补） | +| Version | 0.3 | +| Status | implemented（用户指令已授权实施；用户手动 GUI 检查已完成，专项验证边界见下文） | | Date | 2026-10-04 | | Milestone | [Direct 交付合同简化](./【里程碑】Direct交付合同简化-2026-10-04.md) | @@ -34,7 +34,7 @@ - 从回合启动移除 `requires_new_web_contract` 的义务判定；删除运行模型中的 `requires_contract` 冗余门禁，正常结束只按实际有无合同分流；同步分析结果判定和测试夹具。 - 保留宿主环境预检与可信脚手架准备本身的现有入口，解除它们与合同义务的耦合；不得因删掉条件顺带删除正常建项所需准备或恢复已退役 CLI。 - 初次交付记录/可信脚手架事实仅在 Agent 主动注册时用于现有新 Web visual/gameplay 补充；重放注册复用冻结的 `newWebGame`，不重新计算或更改有效要求。 -- 系统提示使用明确条件：“当用户要求你制作、完成或交付游戏（例如‘做一个游戏’‘做一个可运行的游戏’）时，调用 agc_register_delivery_contract 登记本轮交付范围和验收项。”写明普通操作无需合同，不能因空项目或首次输入强制登记。宿主不新增词表匹配、分类器或缺合同兜底追问。 +- 系统提示使用明确条件：“当用户要求你制作、完成或交付游戏（例如‘做一个游戏’‘做一个可运行的游戏’）时，调用 agc_register_delivery_contract 登记本轮交付范围和验收项。”写明普通操作无需合同，提示不另设空项目或首次输入的免登记说明。宿主不新增词表匹配、分类器或缺合同兜底追问。 - 同步 `prompts/runtime/texts/direct.json` 的 hostDelivery/deliveryFeedback、`direct-tools.json`、`resources/agc-skills/agc-game-production-workflow/{SKILL.md,references/workflow-contract.md}` 、`agc-web-game-development/SKILL.md` 与 `agc-browser-playtest/SKILL.md`。仅调整合同相关指导，保持原语言与浏览器使用说明。 - 检查点：无合同可正常结束；只生图、不操作、普通修改均不被项目状态强制验收。真实模型是否遵循提示单独 smoke，不以字符串单测声称意图理解已验证。 @@ -59,7 +59,7 @@ - 回归覆盖里程碑全部条款，并更新仍使用退役合同的测试夹具；不要伪造浏览器证据来把普通聊天当成游戏成功验收。 - 真实/协议驱动运行时 smoke 验证：证据 ready 后继续操作和输出、正常完成后收尾、空项目无合同请求。Linux 与 Windows 结果分开记录；无真实模型/浏览器/平台环境时明确保留未验证项。 -- 将主规范的待实现目标融合回现行条款，删除过时 artifact/command、首次强制登记及中途封口描述，更新共享记忆。验收完成后清理本里程碑及实施计划；PR 保持 WIP，视觉/玩法后续议题不在本次实现。 +- 将主规范的待实现目标融合回现行条款，删除过时 artifact/command、首次强制登记及中途封口描述，更新共享记忆。验收完成后清理本里程碑及实施计划；用户已确认 PR 移除 WIP，视觉/玩法检查保持现状。 ## 验证命令 @@ -102,6 +102,12 @@ git diff --check | 异常终止 | ready 后中断仍返回中断报告；原预算、取消、旧许可、清理回归 | 通过 | | 恢复 | v1/v2 旧合同及终态、v2 无合同强制标记、未知字段、预算与旧活动操作；旧终态合同只查询历史 | 通过 | | AGC 补丁成功 | Windows bundled patch 回归增加 ready 后无变化补丁不封口断言 | 已编写，Linux 环境未运行 Windows 用例 | -| 提示一致性 | MCP schema、prompt bundle/source boundaries、技能 manifest 与内容校验 | 通过；真实模型多种语言的意图遵循待 smoke | +| 提示一致性 | MCP schema、prompt bundle/source boundaries、技能 manifest 与内容校验 | 通过；用户已确认手动 GUI 检查完成，未提供多语言意图专项用例明细 | -定向结果：`direct_` 376 passed、1 ignored（既有辅助夹具）；`codex_app_server::execution` 19 passed；完整响应协议回归 1 passed；`skill_pack` 7 passed；`runtime_prompt_bundle_build` 6 passed、`prompt_source_boundaries` 18 passed；Node 技能包测试 3 passed。`cargo check --locked`、修改文件 rustfmt、文档索引、编码与 diff 检查通过；编译仍有仓库既有告警。上述过滤器部分重叠，不相加为独立用例总数。初次沙箱运行的 loopback 绑定/Node 子进程失败已在具备对应权限的本地夹具中重跑；不把环境拒绝当作行为通过。Windows 和真实模型验收待补，因此暂保留里程碑与计划。 +定向结果：`direct_` 376 passed、1 ignored（既有辅助夹具）；`codex_app_server::execution` 19 passed；完整响应协议回归 1 passed；`skill_pack` 7 passed；`runtime_prompt_bundle_build` 6 passed、`prompt_source_boundaries` 18 passed；Node 技能包测试 3 passed。`cargo check --locked`、修改文件 rustfmt、文档索引、编码与 diff 检查通过；编译仍有仓库既有告警。上述过滤器部分重叠，不相加为独立用例总数。初次沙箱运行的 loopback 绑定/Node 子进程失败已在具备对应权限的本地夹具中重跑；不把环境拒绝当作行为通过。用户手动 GUI 检查已完成；Windows 专项验证明细尚未提供，暂保留里程碑与计划。 + +## 用户手动检查与范围确认（2026-10-05） + +- 用户确认已完成手动 GUI 检查，PR #608 已移除 WIP；这是用户提供的验收结果，本轮未重新运行 GUI。 +- 用户决定视觉与玩法检查保持现状，包括既有双端、固定场景及证据校验；不再将其调整列为本次重构的下一步。 +- 用户未提供检查平台或逐项用例明细，因此不将本次确认扩写为 Windows Job 完整子树退出、Windows 捆绑补丁用例或多语言意图专项测试全部通过。 diff --git a/docs/project-memory/plans/【实施计划】Direct操作控制与租约简化-2026-10-03.md b/docs/project-memory/plans/【实施计划】Direct操作控制与租约简化-2026-10-03.md index 3f6f20853..02f573d84 100644 --- a/docs/project-memory/plans/【实施计划】Direct操作控制与租约简化-2026-10-03.md +++ b/docs/project-memory/plans/【实施计划】Direct操作控制与租约简化-2026-10-03.md @@ -2,7 +2,7 @@ | 字段 | 值 | | --- | --- | -| Version | 0.2 | +| Version | 0.3 | | Status | implemented（2026-10-04 已实现；待 Windows 平台验收） | | Date | 2026-10-03 | | Milestone | [Direct 合同与租约机制重构：租约切片](./【里程碑】Direct合同与租约机制重构-2026-10-03.md) | @@ -99,7 +99,7 @@ git diff --check - 同步修改状态消费者、报告及相关提示，不留下运行时已经允许、提示仍命令 Agent 停止的矛盾。 - 实现按上述步骤保留可回退提交。回滚前结束自有回合并确认进程退出，核对账本版本可读性；不得通过删账本或重发远端请求完成回滚。 -本计划已实施，主规范和长期记忆已同步。以下证据来自本次实际运行；Windows 平台验收前保留本计划，PR #608 保持 WIP。 +本计划已实施，主规范和长期记忆已同步。以下证据来自本次实际运行；尚无专项证据的平台条目保留在本计划；用户于 2026-10-05 确认手动 GUI 检查已完成，PR #608 已移除 WIP。 ## 2026-10-04 实施与验证记录 @@ -136,3 +136,7 @@ git diff --check | 修改文件 rustfmt、文档索引、编码、`git diff --check` | 通过 | 未调用真实付费 Provider，没有修改工具调度或图片异步协议。Windows Job 子树退出及 Windows 捆绑 Codex 补丁运行需在目标平台补验；当前 Linux 证据不替代该验收。原有编译警告未作为本次重构范围扩展处理。 + +## 用户手动检查（2026-10-05） + +- 用户确认手动 GUI 检查已完成，PR #608 已移除 WIP；未提供平台及逐项用例明细，Windows 专项进程退出证明不据此标为通过。 diff --git a/docs/project-memory/plans/【里程碑】Direct交付合同简化-2026-10-04.md b/docs/project-memory/plans/【里程碑】Direct交付合同简化-2026-10-04.md index 700a50e8b..39baa5d64 100644 --- a/docs/project-memory/plans/【里程碑】Direct交付合同简化-2026-10-04.md +++ b/docs/project-memory/plans/【里程碑】Direct交付合同简化-2026-10-04.md @@ -2,11 +2,11 @@ | 字段 | 值 | | --- | --- | -| Version | 0.2 | -| Status | implemented（实现与定向验证完成；真实模型及 Windows smoke 待补） | +| Version | 0.3 | +| Status | implemented（实现与定向验证完成；用户手动 GUI 检查完成，Windows 专项证据单列） | | Date | 2026-10-04 | | Parent Spec | [Direct 合同规则](../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md#宿主验收与执行许可合同) | -| 关联 | WIP PR #608；问题 #518、#529 | +| 关联 | PR #608（用户确认已移除 WIP）；问题 #518、#529 | ## 交付结果与范围 @@ -40,4 +40,4 @@ ## 证据与剩余项 -具体文件、顺序、命令见[实施计划](./【实施计划】Direct交付合同简化-2026-10-04.md)。实现已完成，自动化与 Linux 子进程协议夹具证据见实施计划。以上勾选表示代码/定向测试条款通过，不代表真实模型的意图理解或 Windows 完整进程子树已验收。视觉/玩法设计评估保留给下一轮；未完成的平台 smoke 保留计划及 WIP 状态。 +具体文件、顺序、命令见[实施计划](./【实施计划】Direct交付合同简化-2026-10-04.md)。实现已完成，自动化与 Linux 子进程协议夹具证据见实施计划。以上勾选表示代码/定向测试条款通过，不代表真实模型的意图理解或 Windows 完整进程子树已验收。用户于 2026-10-05 确认手动 GUI 检查已完成、PR 已移除 WIP，并决定视觉/玩法检查保持现状。未提供平台及逐项用例明细，尚无专项证据的 Windows 条目继续保留在实施计划。 diff --git a/docs/project-memory/plans/【里程碑】Direct合同与租约机制重构-2026-10-03.md b/docs/project-memory/plans/【里程碑】Direct合同与租约机制重构-2026-10-03.md index c813bd37e..a11f4518f 100644 --- a/docs/project-memory/plans/【里程碑】Direct合同与租约机制重构-2026-10-03.md +++ b/docs/project-memory/plans/【里程碑】Direct合同与租约机制重构-2026-10-03.md @@ -2,7 +2,7 @@ | 字段 | 值 | | --- | --- | -| Version | 0.3 | +| Version | 0.4 | | Status | implemented（2026-10-04 已实现；Linux 定向验证通过，Windows 验收待补） | | Date | 2026-10-03 | | Parent Spec | [AI 游戏创作智能体 App 实施计划](../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md#direct-操作控制2026-10-04) | @@ -10,7 +10,7 @@ ## 本次交付与范围 -在现有 WIP PR #608 内规划租约重构：将普通操作控制收敛为回合、时间、并发及既有权限检查，消除单次操作失败造成的全局停顿。租约切片已按用户于 2026-10-04 的实施指令落地。验收以失败操作不阻塞无关工作、关闭后不能新增副作用为核心。 +在 PR #608 内实施租约重构：将普通操作控制收敛为回合、时间、并发及既有权限检查，消除单次操作失败造成的全局停顿。租约切片已按用户于 2026-10-04 的实施指令落地。验收以失败操作不阻塞无关工作、关闭后不能新增副作用为核心。 优先顺序：必须项为明确操作失败与回合控制的边界；风险项为取消、并发、旧回合归属及远端结果不确定；可选项为诊断呈现，按实现需要再决定。规范与计划已完成评审并实施；当前检查点是平台验收。用户于 2026-10-04 要求继续并实施[合同简化](./【里程碑】Direct交付合同简化-2026-10-04.md)，独立记录范围与验收，不将租约 Windows 待验收项视为已完成。 @@ -26,7 +26,7 @@ ## 合同工作的边界 -已确认后续提示 Agent 在用户要求制作、完成或交付游戏时创建合同，由 Agent 理解用户意图，宿主不按关键词或未交付脚手架自动要求登记；artifact/command 验收门禁将移除，视觉/玩法继续讨论。这些合同调整不纳入本次租约实现，唯一交叉项是解除普通操作的合同存在性门禁及同步清除与之矛盾的准入提示。 +已确认后续提示 Agent 在用户要求制作、完成或交付游戏时创建合同，由 Agent 理解用户意图，宿主不按关键词或未交付脚手架自动要求登记；artifact/command 验收门禁已在合同简化中移除；用户于 2026-10-05 决定视觉/玩法保持现状。这些合同调整不纳入本次租约实现，唯一交叉项是解除普通操作的合同存在性门禁及同步清除与之矛盾的准入提示。 本切片移除执行/返修批次，`maxRuns` 暂仅保留既有交付复核次数用途；交付复核不影响工具准入。时间预算数值和计时方式保持不变。保留回合预算防重置与必要恢复信息，旧活动租约不能迁移成新执行权限；未确认旧执行器退出时不能开启冲突执行。 @@ -47,4 +47,4 @@ ## 后续工作入口 -租约切片对应[实施与验证记录](./【实施计划】Direct操作控制与租约简化-2026-10-03.md)，其中记录定向验证证据与未验证项。稳定行为已同步主规范和共享记忆；Windows 验收前保留临时计划及 WIP 状态，合同工作另行规划和验收。 +租约切片对应[实施与验证记录](./【实施计划】Direct操作控制与租约简化-2026-10-03.md)，其中记录定向验证证据与未验证项。稳定行为已同步主规范和共享记忆；用户于 2026-10-05 确认手动 GUI 检查已完成、PR 已移除 WIP；临时计划仍保留尚无专项证据的平台条目。合同简化的实现与验收见关联记录。 diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index d038ce3c5..73c5c1847 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -9620,6 +9620,12 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在 - 合同自动检查只在模型正常结束响应后触发；删除操作结算与补丁成功触发的提前封口，状态查询保持只读评估。异常终止与预算耗尽仍独立处理，不以证据齐备覆盖失败事实。 - 提示 Agent 在用户要求制作、完成或交付游戏时登记合同，由 Agent 理解用户意图；首次输入也按同一用户意图条件登记，提示与技能不另设空项目或首次输入的免登记说明。无合同既不阻断普通操作，也不阻断正常结束。 -- 删除 artifact/command 合同要求及宿主自动补入项，保留普通文件、命令与构建能力。视觉/玩法的现有判据和证据真实性校验不改，仅在主动注册后应用原有新 Web 视觉/玩法补充；相关设计留待下一轮。 +- 删除 artifact/command 合同要求及宿主自动补入项，保留普通文件、命令与构建能力。视觉/玩法的现有判据和证据真实性校验不改，仅在主动注册后应用原有新 Web 视觉/玩法补充；用户于 2026-10-05 确认这两类检查保持现状。 - 旧未完成合同不得因过滤退役要求变成成功；保留旧预算、终态和操作身份，版本迁移与恢复有独立验收。 - 权威规则：[Direct 合同规则](../../technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md#宿主验收与执行许可合同)。运行时已实现；真实模型意图遵循与 Windows 验收按计划单列，不以协议夹具代替。 + +## 2026-10-05：Direct 重构手动 GUI 检查与范围收敛 + +- 用户确认手动 GUI 检查已完成，[PR #608](https://git.genarrative.world/git/GenarrativeAI/Genarrative/pulls/608) 已移除 WIP；删除要求该 PR 维持 WIP 的过期说明。 +- 视觉与玩法检查保持现状，包括既有双端、固定场景及证据真实性校验；本次不继续重构这两类要求。 +- 手动 GUI 确认与专项平台证据分别记录；未提供的 Windows 用例明细不推定为通过。 diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md index ea7213ab4..8be4d142b 100644 --- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md +++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md @@ -179,7 +179,7 @@ UI 编辑器的“分析参考图”步骤、Rust 命令 `suggest_ui_design_sema - 直接启动 Direct 工具桥的图片生成通知测试，须复用真实宿主执行会话夹具，再发起工具请求；继续验证资源提交后发出 manifest 失效通知，以及空提示词被参数校验拒绝且不发通知，不绕过执行许可门禁。 - 交付合同不参与普通工具准入。模型通过结构化工具登记本轮游戏交付的必需范围与验收项；合同非空、有界且只冻结一次。模型只能声明要求，不能提交“通过”作为证据。后续扩项留到新的用户回合。 - 当用户要求制作、完成或交付游戏时，由 Agent 理解意图并登记合同。首次输入也按同一用户意图条件登记；宿主不做关键词或 LLM 意图分类。无合同回合可以正常写入、执行、生成和验证，也可在必要清理后结束，不触发缺合同返修或生成游戏交付证明。系统提示、工具描述及随包技能遵循同一条件。 -- 新合同格式为 `agc-direct-delivery.v2`，只接受非空、有界的 visual/gameplay 要求。artifact/command 类型、初始文件变化摘要及 host-entry/host-build 已删除；普通文件、命令、构建和 agc_run_validation 工具及真实失败回执保留。主动登记新 Web 合同时，宿主沿用首次交付事实补充既有双端视觉/玩法底线并返回完整要求；未登记不补合同。冻结后同参重放复用 newWebGame，不重算范围。视觉/玩法设计本次不改，后续另行讨论。 +- 新合同格式为 `agc-direct-delivery.v2`，只接受非空、有界的 visual/gameplay 要求。artifact/command 类型、初始文件变化摘要及 host-entry/host-build 已删除；普通文件、命令、构建和 agc_run_validation 工具及真实失败回执保留。主动登记新 Web 合同时，宿主沿用首次交付事实补充既有双端视觉/玩法底线并返回完整要求；未登记不补合同。冻结后同参重放复用 newWebGame，不重算范围。用户于 2026-10-05 确认视觉/玩法检查保持现状，本次重构不继续调整这两类判据。 - 同一份双端玩法证据可同时满足视觉项，避免重复浏览器运行。视觉/玩法仍校验双端、固定场景及版本、当前运行指纹、报告与截图摘要；只有宿主真实验证回执有效，项目内自行写出的验证 JSON 无效。删除 artifact 要求不删除浏览器证据文件的防篡改校验。 - `validation.maxRuns` 保留已配置值，仅用于交付回复复核次数；普通执行成功、失败、取消和验证输入漂移均不消耗该次数。验证证据继续绑定输入，失败或漂移仅使相应证据不能证明交付；Agent 可以继续无关工作。 - `validation.maxExecutionSeconds` 默认 900，必须为正整数，是整个 clientTurnId 的累计执行时间上限，同回合重试不清零。并行操作分别计时累加，内置工具不与 app-server 的外层 MCP 事件重复计费。时间耗尽立即拒绝新执行、写入和付费扩项，保留最近证据与未完成项；Provider 的重试次数保持独立。