1821 Commits

Author	SHA1	Message	Date
k88936	0e313405d6	修复：生成绑定校验不再用 prettier 改写生成文件 ... - scripts/check-generated-bindings.mjs：删掉生成后的 prettier 归一化，直接逐字节比较 ts-rs 原始输出 - .prettierignore 与 .eslintrc.cjs：四个 ts-rs 生成目录统一排除，禁止格式化工具二次改写 - .prettierrc.json：删除 contracts/generated 的 printWidth / singleQuote 覆盖 - .gitattributes：生成目录标 linguist-generated 并豁免 trailing-space，保证 git diff --check 通过 - 重新生成 AGC chat/generated 与 services/generated 的 51 个绑定，改为提交 ts-rs 原始输出（纯格式，语义不变） - docs/project-memory：记录生成绑定不再经 prettier 的口径，修正旧流程说明	2026-10-03 15:40:21 +08:00
lhk229	ae2d1a3a21	修复 AGC 生成准备依赖全量素材库的问题 (#592) ... 修复已有项目和素材目录绑定时，AGC 生成准备仍读取完整账户素材库、导致无关素材读取失败阻断生成的问题。 - 新增站内与 External v1 的单目录 GET，按主键读取并校验账号归属；复用目录 DTO，不读取素材列表或创建默认目录。 - 已有 binding 和 partial 恢复改为确认目标目录；首次建绑直接沿用稳定幂等创建，不再读取全库。 - 目录缺失、越权、超时、响应身份不符或会话切换时停止，保留恢复证据，不自动重建、不换键重发生成；已有生成账本继续沿用冻结快照恢复。 - 既有素材库与目录创建、修改、删除 API 合同保持不变，持久化表结构不变。同步 OpenAPI、生成绑定及技术文档。 验证： - AGC Rust：目录绑定 7 项、生成 94 项、资源编辑 60 项、抠图 5 项通过（目录绑定用例包含在生成组中）。 - api-server：External Editor 30 项、受保护路由矩阵 3 项通过。 - 真实隔离 SpacetimeDB：目录读取成功、空目录、缺失、越权、删除后缺失、只读不变，以及既有幂等/并发/孤儿检查通过。 - smoke 脚本测试 4 项通过；module 编译、生成绑定、87 张表 schema guard、DDD、编码、文档索引、定向 Rust 格式与 diff 检查通过。 - 已比较 OpenAPI：除新增单目录 GET 外，原有定义逐项保持一致。 验证限制：未完成独立 API `/healthz` 联调，本地隔离数据库与授权配置未就绪；启动尝试已停止并清理。未运行全量测试或真实付费生成。 发布顺序：先发布后端模块与 API，再发布新客户端；不提供全库回退。#574 的素材分页、筛选及按素材 ID 读取不在本 PR 范围内。 Closes #550 Reviewed-on: #592 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-10-03 14:48:54 +08:00
k88936	97e8f1b652	Merge remote-tracking branch 'origin/master' into feat/smoother-dialog-history	2026-10-02 19:20:53 +08:00
k88936	5092412d89	文档：同步 DirectProject 对话滚动契约与旧口径 ... - ADR 修正样式删除口径：.message-history-more 因策划对话仍在用而保留，后续项一并说明 - 历史技术方案去掉「必须显示显示更早的对话按钮」的过期要求，改为引用新 ADR 的入口形态 - 决策记录新增本次滚动契约、边界与验证口径 Co-authored-by: Junie <junie@jetbrains.com>	2026-10-02 17:54:15 +08:00
k88936	4246052bff	合并 origin/master 到 feat/typed-tool-error ... - 取 master 退役 DirectProject 工具调用与回合流账本（#560）：删除 direct_tool_calls / direct_turn_stream，direct_events 的回合更新收敛为状态与活动，不再广播 game-creator-direct-turn-update - 取 master 修复 AGC 文件列举被无关临时锁删除打断（#552）与素材导入 / 资源提交项目锁争用（#581） - 保留本分支 typed 工具错误口径：逐工具错误枚举、派发边界携带原始 error、工具返回不再软失败 - 保留本分支退役 AGC 独立 Agent Runtime / CLI 执行面的删除，继续删掉 master 侧 runtime_actions 等测试与入口 - 补齐 master 新增的 with_conversation_write_contention 测试助手，项目写锁调用统一为 acquire_project_write_lock_with_wait - 账户素材分页 offset 上限 500 的 schema、预检与行为对齐，越界 offset 返回 typed 错误并适配相关用例 - 错误事件结构体 message 保留调用方原文，脱敏只发生在落盘与应用日志边界	2026-10-02 16:18:50 +08:00
k88936	839051f532	退役AGC独立Agent Runtime与CLI执行面 ... - 删除 agent/runtime_driver、runtime_protocol、runtime_tools、runtime_actions、runtime_state、runtime_adapter、context_compaction、collaboration、delegation、goal 等自建 Runtime 执行面及专属测试与 fixture - CliCommand 收敛为 LlmStatus | EnvironmentCheck | PreviewServe，删除 --agent-run / --agent-task / --agent-goal-* / --agent-resume / --agent-context-compact 等 CLI 与 Tauri 命令白名单条目 - 外部 Runner 收缩为编辑器桥 RPC 与 runner.attach_gui_owner + GUI owner 参与锁 / watchdog，保留 --agent-runner - 前端删除 AgentRuntime* / AgentGoal* 状态与命令调用链，移除 agent-runtime real-e2e / steer / smoke / llm-transient-fault 脚本与对应 CI job - 内置工具错误收口为 typed error，抽取 agent/tool/error.rs 共享错误供各工具复用 - 新增 agent/redaction.rs、runtime_models.rs、json_sidecar.rs、task_lock.rs、process_identity.rs、art_manifest.rs、design_session.rs、direct_events.rs - 同步更新 ADR、decision-log、Runtime V1.1、App 实施计划、本地开发运维、pitfalls 与 CI 脚本	2026-10-02 15:23:12 +08:00
k88936	a9ecc3806d	文档清理已退役的 toolOutputTokenLimit 配置残留 ... - 删除 Runtime V1.1 文档中对 toolOutputTokenLimit 的对标、默认配置、observation 收紧与 MCP sidecar 绑定四处引用 - MCP 结果 sidecar 与模型 observation 描述改为不再依赖该已删字段 - 同步修正 decision-log 该配置项，只保留仍存在的 contextWindowTokens / autoCompactTokenLimit	2026-10-02 15:14:04 +08:00
k88936	f756b52d8c	Merge remote-tracking branch 'origin/master' into fix/wrong-report ... # Conflicts: # docs/project-memory/shared-memory/pitfalls.md	2026-10-02 13:56:47 +08:00
kdletters	e3b4127440	统一 AGC 失败兜底口径：兜底只用专用错误码与专用文案 ... 新增 homeCreationFailure 统一创建失败出口：宿主机器码 / IPC 失联 / 专用未分类兜底三种文案，宿主原始文本改为 appendWebviewLog 落 application.log 而不上屏 首页创建失败不再无条件覆盖成「创建未完成，请重试」，也不再写死「首条需求投递失败」指认某一步；工作区已建好时保留该事实并提供「已创建的工作区」恢复说法 宿主预检按真实原因分流浏览器验证错误码（browser-missing / launch-timeout / launch-failed / cancelled / browser-cleanup-failed / browser-environment-failed / evidence-failed / input-invalid / page-check-failed），未识别落回专用 web-preflight-unclassified 依赖准备收据保留宿主返回的真实失败码，不再一律写成 web-scaffold-preparation-failed 直连回合失败分类器 else 改为专用 runtime-unclassified，并补 sidecar-turn-timeout / sidecar-launch-failed / app-server-launch-failed / claude-code-failed 四个有证据的具体码 Codex CLI 与 Claude sidecar 的进程启动失败保留真实 OS 错误，不再报成「不支持 app-server 子命令」或「Node runtime 不可用」 更新检查新增结果型入口 checkForAppUpdateResult，「关于」页检查失败显示真实原因而不是「当前已是最新版本」 首页无码预检兜底文案不再写「请检查 Node/npm 或浏览器」这类未证实的候选原因 同步 pitfalls 六条与团队约定：兜底码/兜底文案规则、五项修复的现象根因处理验证、测试夹具编译修复记录 验证：vitest homeCreationFailure/homeWebPreflight/appUpdate/appSurface 共 215 passed；cargo test environment_check:: 19 passed、agent::runtime_error:: 5 passed、direct_failure_diagnostic 4 passed、tests::configuration:: 45 passed；cargo fmt --check、tsc --noEmit、npm run typecheck、check:encoding、git diff --check 通过	2026-10-02 13:07:00 +08:00
lhk229	98cb0d237e	修复固定试玩误判祖先指针穿透样式（#547） (#583) ... 关联 #547。 固定试玩将任意祖先的 `pointer-events:none` 累计为按钮禁用，导致覆盖层穿透、按钮恢复 `auto` 的合法布局在实际点击前被拒绝。现在只检查目标控件自身的计算样式；未覆盖的继承 `none` 仍拒绝，原有命中、可见性、disabled、aria-disabled、inert 和真实输入校验保持有效。 复用现有浏览器夹具，补充双视口穿透布局回归及九种不可用控件拒绝场景，并同步场景指纹快照、技术方案和共享排障记录。 验证： - 修复前真实 Chrome 在 desktop/mobile 均复现 start 被误判 disabled；修复后合法布局完整通过开始、主要操作和重开，sequence 从 0 到 3、最终 phase 为 ready。 - 浏览器模块单元测试：27 passed；14 个真实浏览器测试默认 ignored，其中本次显式执行并通过 4 个相关用例（新增 2 个，已有 2 个）。新增拒绝用例在双视口覆盖继承 none、目标 none、目标 none/子元素 auto、disabled、禁用 fieldset、aria-disabled、inert、隐藏和遮挡。 - rustfmt、编码检查、文档索引检查、git diff --check 通过；完成独立代码审查。 验证边界：未运行全量测试；当前工作区未找到现场游戏导出，尚未复核该游戏开始流程。generic 的 mobile 结果为移动视口下的真实鼠标输入，未进行真实触摸验收。 Reviewed-on: #583 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-10-02 12:56:55 +08:00
k88936	e4b15d3bbf	Merge remote-tracking branch 'origin/master' into fix/wrong-report ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md # docs/project-memory/shared-memory/pitfalls.md	2026-10-02 12:19:13 +08:00
kdletters	6bf57c1e51	AGC 把执行器与线协议拆成正交维度 ... AgcAgentMode 回退为仅 codex/cc，只表示执行器；新增 AgcModelProtocol 表示线协议 协议取值 openai_responses/openai_chat/anthropic，与执行器组合封闭并在校验时失败关闭 存量目录缺 protocol 时按执行器推导；历史误写的 agentMode=anthropic 读取时归一为 cc 后台 AGC 模型页拆成 Agent 模式与协议两列，新增协议下拉与对应测试 公开目录 /api/llm/models 与后台 DTO 同时下发解析后的 protocol 客户端持久化 selectedModelProtocol，选模型时按执行器推导兜底协议并校验组合 Codex wire_api 按协议在 responses/chat 间切换，不再硬编码 responses 同步 appSurface 与模型选择测试断言，补 protocol 字段 同步模型别名文档与后端架构文档的正交维度说明	2026-10-02 12:08:26 +08:00
k88936	62f1a80e87	文档：认证失败载体把载荷序列化进message ... - 更新 JS 侧载体 ADR：ClientAuthErrorWrapper 构造时把整份载荷 JSON.stringify 进 Error.message，上报事件拿到变体名与载荷，事件指纹按变体区分 - 记录 Tauri 缺陷抛真 Error 时序列化只有 {}，但上报链路对真 Error 优先用其自身 message/stack - 同步决策记录与技术方案的载体口径，不再写 Error.message 留空	2026-10-02 11:07:03 +08:00
lhk229	f2127a6489	修复 AGC 文件列举被无关临时锁删除打断（#552） (#580) ... 列举 `assets` 时，原实现先递归扫描整个项目，再过滤范围；`.agent/project.lock` 在枚举与读取元数据之间正常删除会使整次查询失败。 现在在读取条目元数据前裁剪目标范围与受保护路径，只遍历目标子树及必要祖先。枚举后消失的文件／目录仅跳过 `NotFound`，其余权限与 IO 错误仍返回；进入排队目录前复核符号链接与 Windows 重解析点。通用文件树保留原有可见范围，Agent 结果继续过滤、排序后分页。 通过通道协调真实项目写锁释放，确定性覆盖全量扫描的 TOCTOU 及定向 `assets` 扫描；另覆盖目录消失／类型变化、权限错误、私有路径、链接、引擎目录和分页。同步更新 AGC 契约与共享排障记录。 验证： - 15 条定向 Rust 测试通过：`cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell -- --test-threads=1 project_file_listing generic_file_tools local_project_file_commands external_listing` - 生产 Rust 检查通过：`cargo check --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell` - `npm run check:encoding`、`npm run check:doc-index`、`git diff --check` 通过。 - 本地验证在 Linux 执行，未运行 Windows 专属运行时验证；分页仍是实时观察，不承诺跨请求快照一致性。 Fixes #552 Reviewed-on: #580	2026-10-02 10:55:47 +08:00
lhk229	89d40c0836	修复素材导入与资源提交的项目锁争用 (#581) ... 修复 #551：本地素材导入、账户素材提交和资源编辑提交在 conversation.write 短暂持有项目锁时会立即失败。现在复用既有约 10 秒有界等待，并将同步取锁与提交放入阻塞线程池，等待期间异步 runtime 继续响应。 - 项目锁先于账号身份租约，等待后重新验证账号身份、导入权限及原 WritePermit；保留跨进程互斥、权限分类和持锁方诊断。 - 资源资产/版本提交和已完成结果清理保留 operation/project guard，取消异步等待不会提前释放仍在执行的提交互斥。超时保留原 operation、幂等键与 staging，恢复不重复远端生成。 - Runtime 素材导入与 UI workflow 切图登记也接入阻塞池，避免共享导入函数新增等待后阻塞这些调用方。同步更新 AGC 行为规范及共享记忆。 验证：163 项 Rust 定向测试通过，覆盖导入与资源编辑、Direct bridge、Runtime 导入、UI workflow、项目锁恢复和失败分类。包含同进程争用、单线程 runtime 心跳、并行 manifest/revision、账号切换、许可取消、完整超时后原 operation 恢复及取消后的 guard 生命周期。 ```sh cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell -- resource_editor:: commands::agent_asset_import_tests agent::direct_tool_bridge::tests tests::project_lock_recovery project::write_lock agent::runtime_tools::context::asset_import_input_tests ui_editor::agent_tools --test-threads=1 npm run check:rustfmt npm run check:encoding npm run check:doc-index git diff --check ``` 全部上述检查通过。Linux 本地未执行 Windows 专属删除挂起行为测试；未调用真实付费 Provider，远端链路使用既有 mock 测试和已下载账本恢复测试验证。没有 API/DTO/schema 变更或数据迁移。 Closes #551 Reviewed-on: #581 Co-authored-by: lhk <ink29535@proton.me> Co-committed-by: lhk <ink29535@proton.me>	2026-10-02 10:55:29 +08:00
k88936	9fe692ba87	文档：AGC认证错误改为顶层类别加类型化reason ... - 更新 AGC 命令错误结构化 ADR：顶层只放调用方要分流的类别，可枚举细分收进类型化枚举 reason 字段，不再拆成几十个顶层变体、也不用字符串 - 更新 AGC 认证失败 JS 侧载体 ADR：带载荷分支先 as 取具名类型，reason 是枚举时再 switch(payload.reason)，两处 default 都用 expectNever - 同步错误报告技术方案、README 索引、决策记录与踩坑的拍平变体口径	2026-10-02 02:42:15 +08:00
k88936	47392d13b8	文档：AGC认证错误收敛为拍平变体 ... - 更新 AGC 命令错误结构化 ADR：变体拍平不嵌套，无字段变体生成 { type }，有字段变体生成 { type } & 载荷类型 - 记录本地前置校验拿不到细分事实时不编字段，phoneNumberInvalid 保持无字段 - 更新 AGC 认证失败 JS 侧载体 ADR：无字段分支用固定文案，带载荷分支先 as 再读 serverMessage/status/detail - 更新错误报告技术方案与 README 索引，同步拍平变体与去 reason 口径 - 同步决策记录与踩坑：ts-rs 只写不删，变体改成无字段时要手动清孤立载荷文件	2026-10-02 02:23:51 +08:00
k88936	2a51f0b98c	文档：认证失败载体类改名 ClientAuthErrorWrapper ... - ADR、README、技术方案、决策记录与排障记忆统一新类名 - auth_session.rs 注释同步	2026-10-02 01:40:14 +08:00
k88936	45774f1c02	文档：认证失败载体的 error 字段标注 ClientAuthError 类型 ... - ADR、技术方案、决策记录同步 error 字段的显式类型标注	2026-10-02 01:37:37 +08:00
k88936	218fba95b0	文档：认证失败载体收敛为只持 error 字段的薄包装 ... - ADR 认证失败载体：ClientActionError 只保留 error 字段，不读 message、不塞 context、message 留空 - 技术方案与决策记录同步载体形状与 error.error 分流 - 排障记忆：判据改为全局 unhandledrejection 显式上下文	2026-10-02 01:35:10 +08:00
k88936	19c75e8167	文档：认证失败 JS 侧载体改用已有 ClientActionError ... - ADR 认证失败载体：删除手写 ClientAuthFailure 类，拒绝装进 ClientActionError，cause 即判别联合 - ADR 命令错误结构化：同步第 3 节对 JS 载体的描述 - 技术方案：认证命令封装形态改为 ClientActionError + cause - 决策记录：影响范围去掉 clientAuthFailure.ts - 排障记忆：载体、判据与关联文件路径同步	2026-10-02 01:22:55 +08:00
lhk229	ded9f13f02	Fix Issue 549 (#573) ... 账户素材超过 500 项时，AGC 曾在筛选和分页前直接拒绝整个素材库，导致查询、预览和指定 ID 导入不可用。本 PR 移除账户素材总量及账户分页 offset=500 的客户端限制，允许大库继续使用现有客户端筛选分页。 Closes #549 ## 实现范围 - 移除账户素材库原始条数超过 500 的拒绝，以及 MCP schema、桥接、Runtime 执行层和原生函数 strict schema 的账户分页 offset 上限。 - 保留单页最多 100 项、导入批次数量与下载体积、媒体类型、账号归属、权限及会话校验。项目文件查询的 offset 上限和绑定项目画布资源的数量上限保持原有契约。 - 账户素材 UI 列表、预览及指定 ID 导入同步恢复可用。 - 修复真实账户导入时，在持有身份租约期间重复读取会话互斥锁造成的自锁；写入前校验和覆盖写入过程的身份租约继续保留。 - 同步工具说明、技术方案与排障记录。服务端仍返回全库，传输和解析开销另由 #574 跟进，不作为本 PR 的验收前置条件。 ## 验收 以下已完成项表示本地自动化与代码核查通过，不代表线上真实账号验收。 - [x] 覆盖 500/501 项素材库解析；503 张静态图片及 1 项不支持媒体的模拟素材库可正常工作。 - [x] MCP 查询支持 limit=1、folderId、query 和 offset>500；nextOffset、末页、越界空页及默认每页 100 项符合现有契约。 - [x] 直接调用 Runtime 执行层时 offset=501 可查询；MCP schema 与参数校验一致，仍拒绝负数、非整数 offset 和 limit>100。这项不覆盖 Runtime 下发给模型的原生函数 schema。 - [x] Runtime 原生函数 asset.library.list 的 strict schema 允许 offset>500；实际下发的完整函数参数已验证 offset=501/600/10000、null 可用，负数/非整数偏移及超界页长拒绝。补丁已提交并推送：41e2cc0b5。 - [x] 共用读取链路的 UI 素材列表和预览在大库场景可用。 - [x] 指定有效 assetId 完成实际下载、本地文件写入及 manifest/revision 更新；重复导入保持幂等。 - [x] 模拟素材库中的不存在 ID 和不支持媒体被拒绝，且不改变 manifest；返回 Agent 的当前页元数据不泄露媒体地址、对象键或凭据。 - [x] 会话退出、账号切换、凭据刷新、身份租约和取消写入相关定向测试通过。 - [x] 工具说明、技术方案和共享排障文档已同步；项目文件与画布资源原有独立边界已核对保留。 - [ ] 真实平台账号联调：超过 500 项素材时查询、预览和导入，以及实际删除、跨账号、无权限素材的拒绝行为。 ## 验证证据 - 账户素材、导入、参数校验、项目文件、取消写入与平台会话定向 Rust 测试：33 项通过。 - runtime_prompt_bundle_build：17 项通过；prompt_source_boundaries：6 项通过。合计 56 项通过。 - Rust 格式检查、npm run check:encoding、npm run check:doc-index、git diff --check 通过。 - 以上 Rust 测试在快进 master 前运行；快进至 44f415d05 后已核对本次代码及工具文本与已测试版本一致，并再次通过编码、文档索引、差异检查和提交时 Rust 格式检查。 - 未运行全量测试，未做真实线上账号或付费操作验证。 初次修复提交：697f421e570606d0519f952a0a5689b5f639f902；原生函数 schema 审查补丁：41e2cc0b57b7f9f5faf06546c1f6108e88380ac3（已推送）。 - 审查补丁验证：24 项定向 Rust 测试通过，覆盖全部 agent_native_tools 测试、大库查询/导入和修正后的旧流式结果测试；格式、编码、文档索引、差异检查、提交及推送检查通过。本轮未重复全量测试，未做真实模型或线上账号调用。 Reviewed-on: #573	2026-10-01 20:55:28 +08:00
k88936	478b9c9891	文档先行：AGC 认证失败的 JS 侧载体与抛出时机 ... - 新增 ADR：认证命令统一经 invokeClientAuth 把结构化拒绝转成 ClientAuthFailure（payload 判别联合）；判定只写在 catch 子句里，系统变体原样抛出经 unhandledrejection 入池，default: expectNever 编译期挡住漏接变体 - 修订【ADR】AGC命令错误结构化与错误报告口径 §3 与后果：撤销"未识别变体上调是故意的"，改为编译期穷尽 - 技术方案同步认证命令的封装形态与两个 ADR 链接 - decision-log / pitfalls 记录第二轮口径：删除形状读取与文案回落层、Rust 失败不再降级成字符串 - docs/README.md 登记新 ADR	2026-10-01 20:33:47 +08:00
kdletters	d1f789cc10	AGC 支持 Anthropic 独立网关路由与后台协议选项 ... 新增平台 Anthropic 网关路由 /api/llm/anthropic/{*path}，复用账号 Router 凭据边界 OpenAI 侧规范路径改为 /api/llm/v1/responses 与 /api/llm/v1/chat/completions，旧路径保留兼容 baseUrl 不再携带路由与版本段，统一由协议自己拼 v1/<op> cc 执行器改走平台网关，ANTHROPIC_AUTH_TOKEN 复用平台会话，不再直连 Router 后台模型目录 agentMode 增加 anthropic，管理页与客户端契约同步 补齐三条路由埋点与静态段白名单，新增三条回归测试 同步后端架构文档、模型别名文档与排障记忆	2026-10-01 19:41:08 +08:00
k88936	2f51e043b7	文档先行：AGC 认证错误的 TS 形状改为每个变体一个具名载荷类型 ... - ADR §1 增加"每个变体一个具名载荷结构体 + ts-rs 生成 `{ type } & X`"的决策与代价 - ADR §3 说明 switch 分支里错误已窄化成具名类型 - 技术方案同步命令错误形状描述 - decision-log / pitfalls 记录形状约定：不手写这层类型、不再包派生分类与提示文案函数	2026-10-01 18:08:00 +08:00
JenkenB	97617608ba	修正 Web 预检错误分流	2026-10-01 17:54:53 +08:00
k88936	8fefd393b2	Merge remote-tracking branch 'origin/master' into fix/wrong-report ... # Conflicts: # docs/project-memory/shared-memory/decision-log.md	2026-10-01 16:51:37 +08:00
k88936	6a1973b0e3	Merge remote-tracking branch 'origin/master' into feat/typed-tool-error ... # Conflicts: # apps/ai-game-creator-shell/src-tauri/src/agent/direct_tools_mcp.rs # docs/project-memory/shared-memory/decision-log.md	2026-10-01 16:04:30 +08:00
k88936	bb9b0b4d6c	文档对齐：AGC 报告池入口改为调用方带上下文交付 ... - 修订 ADR §2/§3：真故障由调用方包成 ClientActionError 交给错误池，不再把 rejection 留在无人接手的 Promise 上 - 说明 408/5xx/网络判定发生在调用方 catch，shouldCaptureClientError 随本 ADR 删除 - 同步技术方案、decision-log、pitfalls 的重抛口径与影响文件清单	2026-10-01 15:24:42 +08:00
k88936	fe200598c0	文档先行：AGC 命令错误结构化与错误报告口径 ... - 新增 ADR：命令错误按具体变体结构化（ts-rs 导出）、报告池只收没人处理的错误、前端按 type 分流不匹配文案 - 更新【技术方案】AGC错误报告与诊断上传：采集口径改为"只收没有调用方处理的错误"，补命令变体分流与 clientApi 边界 - 更新共享记忆 decision-log：记录本次口径与影响范围 - 更新共享记忆 pitfalls：记录"输错密码被当成客户端缺陷上报"的现象、根因与判据 - 修正 DirectTurnError 模块注释中"命令边界只给字符串"的过期描述，改为结构化拒单载荷 - docs/README.md 登记新 ADR	2026-10-01 14:52:28 +08:00
k88936	9372845c35	内置工具失败改成 typed 错误穿出派发边界，事件带原始 error，软失败清零 ... - dispatch 返回 Result<Value, ToolCallError>：不再在工具内部吞掉错误再补一个失败 Value，handle_direct_tool_bridge 在唯一一处 match 里同时组装发给模型的内容与诊断 - 新增 ToolCallError { message, redact_limit, error, images }，error 直接存序列化后的 typed 错误；每个内置工具在自己的 agent/tool/<tool>/error.rs 定义 typed enum，共用 case（参数不是对象 / 未审核字段等）抽到 agent/tool/error.rs 的 ToolFailure - AgentRuntimeErrorEvent 增加 error 字段携带原始 typed 错误，schema 升到 agent-runtime-error.v3；应用日志详情行扩成 message=… error=… metadata=…，各带独立长度预算 - 软失败清零：import_account_assets、run_validation、browser_playtest、environment_check、apply_patch、editor_execute、cocos_execute 原先返回 Ok(失败载荷) 的分支改为 typed 错误，并把 status / dispatched / retryAllowed 等载荷带进错误，模型仍能看到 - 失败证据截图走 ToolFailure::attached_images 与 ToolCallError.images，截图放 #[serde(skip)] 字段，不混进诊断里的 error - bridge_tool_result 去掉 is_error 入参，isError 只在组装处按 Ok/Err 分支写一次；MCP 线上 isError 字段与校验不变 - 修正上一提交遗留的两处 rustfmt：direct_tools_mcp.rs、runtime_tools/context.rs（同一 workspace 整体格式门禁要求） - 同步更新技术方案文档字段表与共享记忆决策记录 验证：cargo check --bin genarrative-ai-game-creator-shell --tests 通过；cargo test --bin genarrative-ai-game-creator-shell -- agent:: 951 passed / 0 failed；npm run check:encoding、git diff --check 通过；Windows 专属 cocos/unity/godot 分支在 Linux 下临时去 cfg 交叉编译通过（无真实 Windows 构建）	2026-10-01 13:30:32 +08:00
k88936	cdb2223140	Merge branch 'master' into refactor/remove-toolcall.jsonl-legacy	2026-10-01 12:58:04 +08:00
k88936	c0e6396bad	Merge branch 'master' into refactor/remove-toolcall.jsonl-legacy	2026-10-01 11:55:43 +08:00
suzmii	bdab523a90	Merge branch 'master' into fix/agc-rust-staging-idempotency	2026-10-01 11:52:08 +08:00
lhk229	a344686b59	为后台项目工程新增按需全量同步时间排序 (#546) ... 新增按钮读取所选渠道全部项目并按同步时间降序、用户与项目 ID 升序展示 复用本地分页并支持全量刷新、恢复默认顺序、进度提示与取消读取 为全量读取增加超时、数量和游标边界，失败时保留原结果 补充三项关键交互测试并同步技术方案、运维说明与共享记忆 Reviewed-on: #546	2026-10-01 11:51:10 +08:00
k88936	4999653a5e	统一错误事件收成一个 message，去掉 public_text / recovery_hint / detail ... - AgentRuntimeErrorEvent 只留一个 message：产生失败的 typed 错误在失败现场写好的人类可读文案；persist_agent_runtime_error 由 10 个入参减到 8 个，agent_runtime_error_app_log_lines 同步收口 - 删掉 recovery_hint 与 detail 两个字段及其入参；开发者信息不另开字段，全部进 metadata：tool、脱敏 arguments、directTurn、dispatchDenied - 应用日志详情行由 hint=… summary=… detail=… metadata=… 收成 message=… metadata=…，身份行不变 - message 预算：sidecar 8 KiB、应用日志 1200 字符（取原来 detail 的预算，用户只上传 AppData 日志、拿不到 sidecar） - direct-codex 路径把 typed Display 全文作为 message；retryable / recovery_hint 仍由 typed DirectTurnError 判定，只留在前端要解析的 direct-codex-failure:v2 文案里 - runtime_state.rs 那条改为只记原始 error（投影后的用户文案已经写进 project.jsonl，不再存第二份） - 同步修正技术方案文档的字段表与共享记忆的决策记录	2026-10-01 10:55:26 +08:00
k88936	1dfe0dd8d4	内置工具错误改成每工具一个 typed enum，工具桥与 MCP 预检收口 ... - 每个内置工具在 agent/tool/<tool>/error.rs 定义自己的错误 enum：一个 case 一个变体，用户（以及转述给用户的模型）可见文案写在变体的 to_user_msg() 上，捕获处只调 to_user_msg() - 跨工具重复的 case（入参形状、项目权限门禁、分页、清单读取、资源登记完成投影、客户端 Direct 回合门禁、宿主执行门禁、未登记工具名）在 agent/tool/error.rs 定义一次，各工具用包装变体 + From 复用，不复制文案 - 工具失败诊断的 code 由「反推错误文案」改成稳定的工具名，开发者信息进 metadata：tool、脱敏 arguments、directTurn、dispatchDenied - 统一错误事件去掉 retryable 字段，AGENT_RUNTIME_ERROR_SCHEMA_VERSION 升到 agent-runtime-error.v2 - 独立客户端 MCP 的 validate_* 改成调用工具桥同一份入参规则，再用该工具 enum 的 to_user_msg() 渲染，删掉重复的字符串文案 - project/verification.rs 的项目权限策略判定改为返回 typed ProjectPermissionRejection（Denied / PolicyUnavailable） - 同步更新技术方案文档的字段表与共享记忆的决策记录	2026-10-01 10:51:50 +08:00
k88936	3611b1e4b9	修 emit 活动白名单漏项并统一宿主时钟 ... - runtime_driver/entrypoints.rs：emit 白名单补 host-review / error-feedback——DirectRuntime 实际会传这两个活动，漏项在 debug 构建 panic、release 构建静默丢掉整次进度回填 - runtime_driver/entrypoints.rs：updated_at 改用 direct_now_ms()，删掉内联 Unix-ms 计算，宿主只留一个时钟 - runtime_driver/entrypoints.rs：新增用例钉住 DirectRuntime 传过的全部活动值都在白名单内 - docs：工具调用卡片技术方案「背景与现状」补 superseded 说明，去掉失效的 src/app/types.ts:1090 指针 - 验证：cargo test --bin genarrative-ai-game-creator-shell agent::（930 passed / 0 failed / 5 ignored）、npm run check:encoding、npm run check:doc-index、git diff --check	2026-10-01 10:29:15 +08:00
suzmii	7e60484633	Merge remote-tracking branch 'origin/fix/agc-rust-staging-idempotency' into fix/agc-rust-staging-idempotency	2026-09-30 20:25:26 +08:00
suzmii	0bfc5768cc	修复AGC跨平台资源构建目标 ... 让Linux no-bundle smoke不再误用Windows随包资源目标。 统一dev与release的Cargo目标和feature解析，补充跨平台回归测试。 同步随包资源staging技术方案中的实际构建目标约定。	2026-09-30 20:24:23 +08:00
suzmii	0a2dffd8a0	Merge branch 'master' into fix/agc-rust-staging-idempotency	2026-09-30 19:44:06 +08:00
k88936	719db293d2	退役 DirectProject 工具调用与回合流账本 ... - agent/direct_tool_calls.rs、agent/direct_turn_stream.rs：整体删除，agent.rs 去掉模块声明与导出 - direct_runtime/mod.rs：删 DirectToolCallCollector、回合流节流器与全部落盘/发射调用点，observer 只回填 update_active_turn - codex_app_server/mod.rs：删 DirectCodexTurnObservation::ToolCall，AgentMessageSegment 结构体变体简化为元组变体，direct_tool_call_turn_id / direct_tool_call_now_ms 改名 - claude_code_cli.rs：删 tool_use / tool_result 采集分支与 DirectToolCall 构造 - main.rs、runtime_driver/entrypoints.rs：删 GameCreatorDirectTurnUpdateEvent 与 game-creator-direct-turn-update 事件，emit 收缩为 (status, activity) - thread_manager/wire.rs：新增 direct_now_ms，替代随 direct_tool_calls 删除的时钟函数 - docs：ADR、工具调用卡片技术方案、DirectProject 聊天真相源收敛里程碑与实施计划、pitfalls 旧路径同步到当前状态，decision-log 新增 2026-09-30 退役条目 - 未修（另开）：redact_absolute_path_tokens 的无语境绝对路径扫描仍会误伤 HTML 结束标签与嵌套 JSON 转义 - 验证：cargo test --bin genarrative-ai-game-creator-shell agent::（929 passed / 0 failed / 5 ignored）、npm run check:encoding、npm run check:doc-index、git diff --check	2026-09-30 19:42:13 +08:00
kdletters	66ff5bf4b7	隐藏扩展设置中的插件进程诊断信息 ... 移除内置插件卡片中的 lastError 展示 移除导入插件卡片中的 lastError 展示 补充扩展设置文档约定	2026-09-30 18:59:26 +08:00
lhk229	c6381f68e1	修复AGC壳CI缺少Claude SDK依赖安装 (#558) ... 为两条Rust测试lane及smoke任务补齐编译前npm安装 为Rust缓存预热补齐Claude SDK依赖安装 更新CI安装顺序验证及开发运维文档和共享记忆 Reviewed-on: #558 Co-authored-by: Linghong <ink29535@proton.me> Co-committed-by: Linghong <ink29535@proton.me>	2026-09-30 18:11:17 +08:00
suzmii	8be75e8e15	合并 origin/master（33 个提交）：DirectProject 入队化与事件投影 ... - 合并 origin/master（425fbcf63..9ee34809b），唯一冲突是共享决策日志两侧各插条目，取「两侧并存」 - 本轮 master 未触及随包资源声明、准备步骤与三份 tauri 配置，build.rs 只读校验保持不变 - 决策日志与踩坑记录同步两侧条目；docs/README.md 与项目索引按 master 收敛 - 构建期重新生成的 ts-rs 绑定经 prettier 归一后与 master 逐字节一致（合并未丢类型） - 校验：cargo test --no-run 全 target 通过、AGC 应用 vitest 191 files / 1889 tests passed、check-package-layout、prepare-bundled-resources 18 passed、check-config、check:encoding、prettier、cargo fmt --check 全绿	2026-09-30 17:38:35 +08:00
suzmii	b5a143c04f	合并 origin/master：随包资源仍由准备步骤生成，Claude Agent SDK sidecar 按同一架构归位 ... - 合并 origin/master（140 个提交），解决 4 处冲突：build.rs 取只读校验分支、package.json 同时保留 bundled-resources:test 与 check:generated-bindings、决策日志与踩坑记录两侧条目并存 - master 的构建期 staging（stage_bundled_claude_agent、prune_stale_codex_components）不进构建脚本；sidecar 改由声明与准备步骤产出 - package-layout.json 新增 claudeAgent section（锁定版本、sidecar 入口、上游 SDK 与平台原生运行时目标表、复制跳过规则），layoutVersion 递增到 2 - prepare-bundled-resources.mjs 新增 sidecar 整目录原子替换与缓存 key，复制规则按 section 参数化，Windows 真机 24 个文件、复跑命中缓存零写入 - package_layout.rs 新增 sidecar 只读校验（入口与仓库源码逐字节一致、上游包版本、可执行位、白名单外文件）与声明钉住用例 - build.rs 调用 sidecar 校验并导出 AGC_CLAUDE_AGENT_SDK_VERSION；claude_code_cli.rs 的 sidecar 身份串改用声明版本 - resources/claude-agent 映射从基线 tauri.conf.json 移到 windows/macos 平台配置，check-config.mjs 增加「基线不得声明 resources/**」守卫 - 修正 package_layout 的 Windows 路径期望用例（期望值改与实现同形，原用例在 Windows 必红） - 同步技术方案 §4.5/§4.9、共享决策日志与踩坑记录	2026-09-30 17:23:04 +08:00
k88936	dc7feec426	文档：DirectProject 队列条目事件投影、resolved_text 持久化与埋点归宿主收口 ... - ADR 状态改为 2026-09-30 落地完成，§2 补入队侧的“用户条目校验与冻结”，§5 埋点段去掉渲染侧 discard 与句柄表措辞 - ADR 词表收口：并发拒单/放行补拒单出口/放行期拒单三处改成入队失败与放行失败口径 - ADR §9 与实施计划同步归位后的符号名：active_turn_id_at、stale_turn_for_release、kick_queue_dispatch、complete_turn - 实施计划状态改为第 0–7 步全部落地，进度表第 6/7 步补落地说明与提交号，新增「2026-09-30 收口记录」 - 实施计划顶部路径口径补 thread_manager 之外去掉 direct_ 前缀的函数改名对照 - decision-log 2026-09-30 条目把“设计稿，尚未实施”换成落地提交链与验证结论，并补 09-24 条目指向落地证据	2026-09-30 16:39:45 +08:00
k88936	2b98b022c2	文档：待发消息条目改为事件投影、引用解析文本随条目持久化、埋点成绩归宿主 ... - ADR §3/§4/§5：在队条目 = 事件窗口里“有 queue.enqueued、没有配对 queue.removed”的折叠；队列事件不带 prompt、不带埋点身份，也没有宿主私有的第二类字段 - ADR §5/§9：引用 part 的解析文本写进自己的 resolved_text 并随条目持久化（缺省合法、旧历史照样解析），放行/历史回读/turn input 共用；放行读 identity_generation、终态比对后直写成绩，删掉候选/settle 两阶段与 attempt id - ADR 备选方案补 6–9 条（条目另存产物、整条 prompt、clientTurnId 兼作埋点身份、保留两阶段）与影响与代价（prompt 块顺序、埋点口径随放行搬家） - 实施计划：新增第 6 步（条目不再另存产物）、第 7 步（埋点成绩归宿主），落地进度表与状态同步；补 2026-09-30 文件路径口径 - decision-log：追加并修正 2026-09-30 条目（resolved_text 持久化、埋点链退役、不用 clientTurnId 兼作身份）	2026-09-30 15:48:38 +08:00
k88936	e70b338900	文档：DirectProject 待发消息条目改为事件投影，prompt 改为条目重投影 ... - ADR §3/§4/§5 与备选方案 6–8、影响与代价：删掉 StoredEvent.pending 的第二份产物，队列成员由事件折出；prompt 只在引用 part 上冻结算不出的片段（to_prompt_cache，宿主内存专用），canonical 形状与 prompt 放行时重投影；analyticsAttemptId 进 queue.enqueued - 实施计划：状态改第 0–6 步、落地进度表补第 6 步、新增「第 6 步：条目不再另存产物」的实现点与验收 - decision-log：追加 2026-09-30 修订条目（背景、三条决策、埋点身份的口径）	2026-09-30 15:20:39 +08:00
k88936	888c249ffd	Merge branch 'master' into feat/msg-queue-to-rust	2026-09-30 14:37:25 +08:00