2799 Commits

Author	SHA1	Message	Date
k88936	a723d10ce3	回退列表工具 offset 上限的收窄，agc_list_registered_assets 恢复无上限 ... - 回退 4e5adb2a3：page 的 max_offset 恢复成 Option<usize>，删掉 TOOL_PAGE_MAX_OFFSET 常量 - agc_list_registered_assets 传 None（offset 无上限，与它原本的行为一致），agc_list_project_files / agc_list_account_assets 仍传原来的 Some(500) - agc_list_registered_assets 的 inputSchema offset 去掉 maximum: 500，恢复到原公开入参范围 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge:: 41 passed / 0 failed	2026-10-01 15:56:49 +08:00
k88936	75d9e25634	首尾换行回到按空白裁剪，不再当控制字符报错 ... - 回退 3f70c6911 的收紧：optional_text 恢复成先 trim、再查 is_control - prompt 末尾带 \n（\r\n 等）视为普通首尾空白裁掉，与首尾空格同口径；中间的控制字符仍然报 has_control_characters - 测试改为断言行尾换行被接受且裁成 "生成过场"，另加一条中间换行仍被拒的断言 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge:: 41 passed / 0 failed	2026-10-01 15:56:12 +08:00
k88936	7c67a6fcc0	agc_generate_image 的 kind 传了非字符串不再静默当成 image ... - bridge_image_generation_kind 原来用 and_then(Value::as_str)…unwrap_or("image")：{"kind":true}、{"kind":5}、{"kind":[]} 都会被当成 image 继续生成；空串也会被静默当默认值 - 改成按 schema 语义区分：缺省与显式 null 用默认 image；字符串按原值走 canonical 校验（空串/未知值走 KindUnsupported）；其它类型返回新的 GenerateImageError::KindNotText { got } - 测试补四条断言：kind=true 报「kind 必须是字符串」、kind="" 报「不是受支持的素材类型」、缺省与 null 仍解析为 image 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge:: 41 passed；agent:: tests::project:: 1078 passed（两条失败为既有 flaky：art_director_request_exposes_canvas_only_for_the_keyed_owner_route / background_agent_runtime_can_generate_platform_art_asset，单独重跑通过）	2026-10-01 15:39:56 +08:00
k88936	3f70c69119	首尾的控制字符不再被 trim 静默吞掉，统一按控制字符报错 ... - optional_text 原来先 trim 再查 is_control：`"prompt\n"`、`"\tprompt"` 这类落在首尾的控制字符被静默裁掉、当成合法值，而同一个字符出现在中间却会报错 - 改成先按原串查控制字符，再用 trim 做空值与长度判定：控制字符在哪个位置都报 has_control_characters - 纯空白值（"\n\t"、" "）仍然算空值、报原来的 empty 错误；首尾的普通空格仍按原样裁掉 - 测试补三条断言：prompt 末尾带 \n 必须被拒、纯空白 brief 仍报空、brief 首尾普通空格仍会被裁剪 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent:: 953 passed / 0 failed	2026-10-01 15:18:02 +08:00
k88936	66e4ece692	入参给了非字符串值时按字段报类型错，不再混进「不能为空」 ... - ToolTextField 增加 not_text(got)，optional_text 在 as_str() 失败时返回它；原来数字/布尔/数组/对象会和空串、null 一起落到 field.empty()，{"prompt":5} 报成「prompt 不能为空」 - 9 个工具 enum 按字段各加一个 NotText 变体（KindNotText、PromptNotText、AspectRatioNotText…），文案形如「生成图片失败：aspectRatio 必须是字符串，当前是「5」。」，仍是一 case 一变体、文案写在变体上 - GenerateImageTextField 改为实现 ToolTextField，删掉 generate_image_optional_text / generate_image_required_text 这两份与共享实现重复的拷贝，generate_image 改走 optional_text / required_text - 空串 / null / 缺省仍按原来的空值语义处理，只有「有值但不是字符串」换成类型错 - 新增 non_text_field_values_report_a_type_error_instead_of_an_empty_value 覆盖 create_or_derive、prepare_game_art、generate_image 三条路径 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge:: 41 passed；全量 agent:: 952 passed（唯一失败 concurrent_distinct_frozen_root_steers_create_only_one_replacement 是既有 flaky，单独重跑通过）	2026-10-01 15:01:20 +08:00
k88936	4e5adb2a30	分页 offset 上限收成必填参数与单一常量，三个列表工具口径一致 ... - arguments::page 的 max_offset 由 Option<usize> 改成 usize：调用点必须显式给出上限，不能靠漏传 Option 变成无上限 - 新增 TOOL_PAGE_MAX_OFFSET = 500（与 agc_list_project_files / agc_list_account_assets 的 inputSchema offset.maximum 一致），三个列表工具统一传它；agc_list_registered_assets 原来传 None（无上限），现在同样收敛到 500 - agc_list_registered_assets 的 inputSchema offset 同步补 maximum: 500，保持 schema 与校验一致（这是一个公开入参范围的收窄） - 只改 offset 边界来源；limit 默认值与上限、分页语义不变 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent:: 952 passed / 0 failed	2026-10-01 14:41:17 +08:00
k88936	1359c7c2b3	去掉 list_registered_assets 的 kind 错误里那份会漂移的示例清单 ... - KindNotManifestClass 原文案列举 9 个示例 kind，而真实白名单是 GameCreationAppAssetKind 的 19 个值，枚举演进后没人会回来同步这句 - 按「不维护第二份清单」的口径，文案只保留「必须用 canonical kind」，取值示例由 kind 参数的 schema description（direct-tools.json 的 agc_list_registered_assets.parameters.kind）承担 - 只改文案，判定逻辑不变 验证：cargo check --bin genarrative-ai-game-creator-shell --tests 通过	2026-10-01 14:37:03 +08:00
k88936	0d21f838ed	生成图片的允许值与边界提成常量，校验与诊断文案共用同一份 ... - 新增 GENERATE_IMAGE_ASPECT_RATIOS / _IMAGE_SIZES / _SLICE_MODES 与 grid 轴、sliceCount 的 MIN/MAX 常量，放在 direct_tool_bridge 的 GENERATE_IMAGE_ARGUMENTS 旁 - generate_image_input 的 aspectRatio / imageSize / sliceMode / grid 轴区间 / sliceCount 区间校验改为读常量；generate_image/error.rs 的对应文案也改为读同一批常量（KindUnsupported 早已从 PLATFORM_ART_ASSET_GENERATION_KINDS 派生，这次把其余几组对齐） - 只改取值来源，判定范围与文案取值不变 - 未纳入本次：commands.rs 的 LOCAL_PROJECT_ASSET_ASPECT_RATIOS/_IMAGE_SIZES 与 agent_native_tools.rs 的 canvas.asset_generate schema 仍是各自的副本（面向非 agent 的栏目画布入口），统一它们属于另一次改动 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge:: agent::direct_tools_mcp:: 71 passed	2026-10-01 14:35:53 +08:00
k88936	235adde72c	联网搜索响应超限的诊断带上实际收到的字节数 ... - WebSearchError::ResponseTooLarge 原来只记 max_bytes，用户只看到「超过上限 524288 bytes」，不知道实际多大 - 两个构造点都已拿到真实大小：content_length() 与 bytes.len() + chunk.len()，变体加 got_bytes 并写进文案 - 判定与两个构造点位置不变，仅补上实际值 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge::tests::search_parser_accepts_only_bounded_public_https_results 通过	2026-10-01 14:14:29 +08:00
k88936	23a111985a	联网搜索 maxResults 非整数的诊断上限改为随变体携带，不再写死 5 ... - WebSearchError::MaxResultsNotInteger 原文案把上限写死成「1 到 5」，同一份文件里 MaxResultsOutOfRange 却是从 DIRECT_TOOL_BRIDGE_MAX_SEARCH_RESULTS 取 {max}；常量一改，两条诊断就会自相矛盾 - 变体加上 max: u64，构造点传 DIRECT_TOOL_BRIDGE_MAX_SEARCH_RESULTS as u64，文案改成「1 到 {max}」 - 只影响这一条诊断的取值来源，判定区间不变 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge::tests::search_parser_accepts_only_bounded_public_https_results 通过	2026-10-01 14:11:27 +08:00
k88936	b2d01ef8c1	write_file 入参形状校验收进 write_file_input，MCP 预检不再漏掉未知字段 ... - 其它 *_input 解析器都先调 ToolArgumentsRejection::check，只有 write_file_input 没有；工具桥路径靠 bridge_write_file_with_permit 里另一次 check 兜住，但独立客户端 MCP 预检 validate_write_file_arguments 只调 write_file_input，带未知字段的入参能通过预检、要等回客户端桥才被拒 - 在 write_file_input 开头补上同一份 check（path/content 白名单），两个入口共用一条规则；写文件门禁里的那次 check 保留，保证「先查形状、再过权限」的现有顺序不变 - 测试补一条：{"path":"game/index.html","content":"…","unexpected":1} 必须被 validate_write_file_arguments 拒绝 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge:: 40 passed；agent::direct_tools_mcp::tests::tool_catalog_preserves_reviewed_resource_contracts 通过	2026-10-01 14:08:52 +08:00
k88936	c9e4a7e397	美术准备模式缺省时直接构造 ReuseOrCreate，去掉生产路径的 expect ... - art_preparation_mode 在 mode 缺省时走 from_tool_value(None).expect("default art preparation mode")，依赖「None 必然映射为 ReuseOrCreate」这条隐式不变式 - 缺省值就是 ReuseOrCreate，直接返回该变体即可；显式传入 mode 的解析路径不变，少一条潜在 panic 分支 - bridge_argument_bounds_are_deterministic 断言缺省模式仍为 ReuseOrCreate，继续通过 验证：cargo check --bin genarrative-ai-game-creator-shell --tests；cargo test -- agent::direct_tool_bridge::tests::bridge_argument_bounds_are_deterministic 通过	2026-10-01 14:03:43 +08:00
k88936	822e89bdc0	生成图片的 gridX/gridY 解析不再把超大整数截断成合法网格 ... - generate_image_grid_axis 原来用 `value as u32`，u64 直接截断：4294967297（2^32+1）会变成 1，随后 1..=32 的区间校验把这个巨大输入当成合法网格静默接受 - 改成 u32::try_from，超出 u32 的值直接落到 GridAxisNotInteger 拒绝分支，不再依赖截断后的值 - 补一条回归测试：gridX=4294967297 必须被拒绝，gridX=4/gridY=4 仍通过 验证：cargo test --bin genarrative-ai-game-creator-shell -- agent::direct_tool_bridge::tests::generate_image_grid_axis_rejects_values_beyond_u32 通过	2026-10-01 14:00:03 +08:00
k88936	28f6ddc7dc	去掉权限策略不可用诊断里重复的「读取项目权限策略失败」前缀 ... - ProjectPermissionRejection::PolicyUnavailable 的 cause 来自 read_project_permission_policy_at，本身多数已带「读取/解析项目权限策略失败：」，包装文案再拼一次会得到「读取项目权限策略失败，无法确认……：读取项目权限策略失败：…」 - 包装文案只保留「无法确认该动作是否被允许，本次操作未执行：」，cause 原样保留；判定与变体结构不变 验证：cargo check --bin genarrative-ai-game-creator-shell --tests 通过	2026-10-01 13:53:06 +08:00
k88936	6788a75ca6	分页 limit 的诊断改成「非负整数」，与 offset 保持一致 ... - ToolPageRejection::LimitNotInteger 原文案说 limit「必须是整数」，但负数（如 -1）走到这个分支时本身就是整数，读起来自相矛盾 - 解析用的是 as_u64，真实约束是非负；文案改成与 OffsetNotInteger 相同的「非负整数」，只改措辞，判定与变体结构不变 验证：cargo check --bin genarrative-ai-game-creator-shell --tests 通过	2026-10-01 13:52:52 +08:00
k88936	cf90d7a8db	修正美术重生成「已绑定另一项美术重生成请求」文案里多余的「稳定」 ... - prepare_game_art/error.rs 的 BoundToAnotherBrief 变体描述的是当前客户端回合已绑定另一项美术重生成请求，「稳定」是残留错译，会让模型误以为存在「稳定/不稳定」两种请求 - 只改这一处用户可见文案，判定逻辑与变体结构不变 验证：cargo check --bin genarrative-ai-game-creator-shell --tests 通过	2026-10-01 13:52:29 +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	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	41c3dea3fd	Refactor: Add client turn attribution to tool diagnostics and enhance test coverage ... - Introduced `active_client_turn_id` for client turn attribution in diagnostics. - Updated error tracking to include `clientTurnId` in tool failure events. - Added test cases to validate behavior with and without bound client turns.	2026-09-30 17:40:02 +08:00
k88936	8a4e3cbcdd	Merge remote-tracking branch 'origin/master' into feat/msg-queue-to-rust	2026-09-30 16:55:37 +08:00
k88936	28b64cf25a	DirectProject 待发消息条目改为事件投影，放行时重投影 canonical 与 prompt ... - queue.rs：PendingTurn 退化成 queue.enqueued 的投影（new / from_event / enqueued_event 往返），删掉 canonical_user_item 与 prompt 两个宿主私有产物字段 - thread_manager/mod.rs：删 StoredEvent.pending（append_inner 并回 append）；pending_turns 改为一次事件折叠（有 queue.enqueued、没有配对 queue.removed），容量、判重、remove、claim 全读这一次折叠；mark_queue_events_cleanable 删掉“产物还在就不回收”的防御 - dispatch.rs：放行的 canonical = serde_json::to_value(&pending.user_item)，prompt = direct_codex_user_item_to_prompt(&pending.user_item)——不写盘、不读 manifest、不重跑校验 - user_input.rs：入队只造条目本身，不再冻结 prompt / canonical 形状 - wire.rs：queue.enqueued 注释改为“这条事件就是这条待发消息的全部事实” - 验证：cargo test -- thread_manager::（62 passed，单线程跑进程级计数器用例）、-- agent::（948 passed，另一条 design_runtime 用例为既有并发 flaky，单跑通过）、-- direct_runtime:: analytics:: direct_codex_user_item（182 passed）、npx vitest run appSurface/directThreadChat/directHistoryPaging/directProjectTurn（249 passed）	2026-09-30 16:37:06 +08:00
k88936	0270cd601e	DirectProject 埋点成绩改由宿主结算，删掉候选/settle 两阶段与 analyticsAttemptId ... - analytics/run.rs：删 Request::DirectCandidate / Request::Settle 与 settle()；direct_finished 改收放行代次，终态再读一次 identity_generation，不同则整条不记，相同则直接落 Request::Terminal - analytics/store.rs：删 pending_runs / pending_run_bytes 与两条候选分支（连带 16 条上限），run_request 不再需要字节预算参数 - analytics/gui.rs + main.rs：删 settle_direct_run_analytics 命令与注册 - 放行侧：kick_queue_dispatch 在读 claim 之后读一次平台会话代次并随整轮传下去；user_input 命令不再收 analyticsAttemptId，队列条目不再持有埋点句柄 - 渲染层：删 beginDirectRunAnalytics、句柄表与结算 effect、settle 调用与命令参数；删除 tests/directRunAnalytics.test.ts，appSurface 两处断言同步 - 判据口径随放行搬家：从“发送时与终态同代”改成“放行时与终态同代”，入队后放行前的账号切换不再丢弃成绩 - 验证：cargo test -- analytics::（45 passed，含新增的直写与代际变化两条）、cargo test -- agent::（949 passed）、analytics_real_file_write 用例、npx vitest run tests/appSurface.test.ts（194 passed）、相关 chat/direct 单测 139 passed、typecheck 通过	2026-09-30 16:25:05 +08:00
k88936	15a495dc29	DirectProject 引用解析文本随条目持久化，prompt 投影拆成 freeze 与纯折叠 ... - AgcResourceReference 增加 resolved_text：入队冻结时写入素材摘要 + UI 设计文档代码上下文，此后随条目持久化；缺省合法（旧历史照样解析），序列化时不写 None - wire.rs 新增 freeze_direct_codex_user_item（校验 + 算片段 + 写盘 + 冻结进 part + 判空），direct_codex_user_item_to_prompt 改为只读条目自身事实的纯折叠（零 IO、零校验、无失败出口） - wire 投影与 turn input 优先读 resolved_text，缺省才退回按当前 manifest 现算摘要；历史回读依旧不产生写副作用 - user_input.rs 入队侧改用 freeze，prompt 由冻结条目折叠得出 - 生成绑定 DirectCodexUserContentPart 增加可选 resolvedText	2026-09-30 16:07:46 +08:00
kdletters	110f088d41	修复 Jenkins 发布流水线与 macOS 包门禁 ... - 转义 Stdb Publish GString 内的 shell 命令替换，避免 Jenkinsfile 加载时 Groovy 编译失败 - 为 Stdb Publish 暂存清理命令补充生产运维回归门禁 - 抽离 macOS 包内容策略并放行随包 Claude Agent SDK 的受控 node_modules - 违规资源现在会输出具体相对路径，并补充包内容白名单单测与排障记录	2026-09-30 16:01:21 +08:00
k88936	f121257cca	线程管理器归位 agent/thread_manager：去掉 Direct 前缀，按职责拆文件 ... - 四个 direct_* 文件移入 agent/thread_manager：wire.rs（运行态事件契约）、queue.rs（待发消息队列规则）、dispatch.rs（放行与占用）、mod.rs（管理器主体与对外入口） - 类型去掉 Direct 前缀：ThreadEvent / ThreadManager / ThreadItem / ThreadFileChange / ThreadDeltaKind / ThreadRequestKind / PendingTurn / QueueRemovalReason / QueueRemovalOutcome / DispatchedTurn / TurnReservation / TurnIdentity / StaleTurnRelease / ConsumeResult / SubscriptionBootstrap / ActiveTurn / ActiveTurnSnapshot - 对外函数改名：subscribe_thread / consume_thread / unsubscribe_thread / append_thread_event / enqueue_pending_turn / remove_pending_turn / claim_pending_turn / update_active_turn / list_active_turns / complete_turn / complete_turn_if_reserved / active_turn_id_at / read_turn_identity / stale_turn_for_release / thread_id_for_project - 生成绑定跟着改名（DirectThreadEvent→ThreadEvent 等十个文件为 rename），前端八处 import 同步；Tauri 命令名与前端 IPC 契约不变 - 定向验证：cargo test agent::（945 passed，另两条并发用例为既有 flaky、重跑通过）、npx vitest run appSurface/directThreadChat/directHistoryPaging（247 passed）、typecheck 通过	2026-09-30 15:47:22 +08:00
k88936	888c249ffd	Merge branch 'master' into feat/msg-queue-to-rust	2026-09-30 14:37:25 +08:00
kdletters	fb130d1847	新增 AGC 模型 Agent 模式与 Claude Agent SDK sidecar ... 后台模型目录增加 codex/cc 执行模式绑定，旧目录缺省兼容 Codex AGC 客户端按模型绑定路由 Codex app-server 或 Claude Agent SDK sidecar 随包携带 Node runtime、Claude Agent SDK 与匹配平台 Claude runtime 补充模型配置、客户端选择、运行时适配、MCP 取消和定向测试 同步 AGC 模型配置规范、里程碑计划与共享决策记录	2026-09-30 14:07:25 +08:00
k88936	d538c6e9c9	Merge remote-tracking branch 'origin/master' into feat/msg-queue-to-rust	2026-09-30 13:37:14 +08:00
k88936	131026795a	合并 origin/master：待发消息队列归宿主叠加 master 的 active-turns 广播与保活下沉 ... - direct_runtime/mod.rs：保留本分支「Thread Manager 是活动回合唯一事实源」（direct_active_turn_id_at）， 丢掉 master 的 DirectTaonierActiveInvocationGuard 第二份进程内表；master 的美术背景路由改动全部保留 - direct_thread_manager.rs：双方都保留——本分支的待发队列 / 容量上限 / 残留回合兜底释放， 与 master 的 emit_direct_active_turns_changed 广播、unsubscribe、update_active_turn 返回「是否真的变了」 - useDirectProjectChatController.ts：保留本分支入队化逻辑，采纳 master 的 rawMessage 小重构与保活下沉 - direct_turn_dispatch.rs：会话保活改挂放行占用（DirectTurnReservation._session_keepalive）， 随占用释放即停，等价承接 master 放在调用身份守卫里的保活意图 - 保留本分支对 direct-execution-production-fixture.mjs 的删除（--direct-codex-chat CLI 已退役，夹具无入口） - 连带退役 scripts/run-agc-direct-execution-fixture.mjs 与 npm run check:agc-direct-execution-fixture（只服务该夹具） - 文档同步：ADR / 09-24 实施计划 / decision-log 记录上述退役，09-16 与 09-18 里程碑、pitfalls 的夹具命令标注为已退役	2026-09-30 13:35:14 +08:00
k88936	e221543947	终止钮按 canStopTurn 显示：队列非空不再顶出终止按钮 ... - `useDirectProjectTurnStatus` 新增派生判据 `canStopTurn`（`nativeRunning || commandInFlight`）与共享的 `canStopDirectProjectTurn`，写清它与 `displayBusy` 的分工：前者回答"终止这一脚踢给谁"，后者回答"界面能不能声称空闲" - composer 的发送钮 / 终止钮按 `canStopTurn` 换；`busy` 继续管模型 / 附件 / 语音这些与当前这轮冲突的控件 - `cancelTurn` 的受理判据改用同一个函数：显示与受理同源，不再出现"按钮在、点了说没有回合" - `displayBusy` 保持三者并集不变（卡片仍要早于首个 token 显示"正在处理"） - 测试：`directProjectTurnStatus` 补 `canStopTurn` 用例；appSurface 补"只有待发消息、没有回合在跑时不显示终止钮"（撤掉修复会红）	2026-09-30 13:11:45 +08:00
k88936	9f04940c6d	整包工作流恢复只在需要恢复时才取整轮任务锁 ... - `recover_direct_taonier_regeneration_workflow_at` 先做只读判据（复用 `direct_taonier_regeneration_workflow_requires_recovery_at`），不需要恢复就直接返回 - 真要动手才取 `direct-codex-art`，并在锁下重读一次判据（以锁下那一份为准） - 原来无条件取锁：正在跑的整包重生成整轮持有它，入队会先同步阻塞约 1 秒再被 `HostStateUnavailable` 拒掉 - 实施计划补一行说明，与 ADR §6"入队不取整轮持有的锁"对齐 - 测试：新增用例"整包重生成在跑（锁被占）时不需要恢复的入队路径不取锁"，撤掉修复会红	2026-09-30 13:04:49 +08:00
k88936	51e4811344	残留回合兜底释放改成 Thread Manager 里的原子动作 ... - `DirectThreadManager::release_stale_turn` 在同一个临界区里做完"校验 → 解除占用 → 写 aborted 终态" - 判据不满足（没有活动回合 / 身份对不上 / 没过启动窗口）一个字都不写，占用与事件都保持原样 - 拆成"先校验后释放"两次取锁会让并发认领插进中间，清掉新那一轮的占用并给老回合补假终态 - `direct_stale_turn_for_release` 降级成"调用原子出口 + 把结果翻成人话"，文案与对外语义不变 - 兜底终态改由 Thread Manager 写，身份取被释放那一轮自己的 clientTurnId，删掉 app-server 侧的建事件助手 - 测试：管理器侧新增"校验与释放是一个动作"用例；运行时侧用例补上"拒绝时零写入 / 通过时占用与终态一起落地"	2026-09-30 12:55:07 +08:00
k88936	e0ca5ad9b9	前端 bootstrap 用例补齐：在跑的那一轮与在队条目同时还原 ... - `directThreadChat.test.ts` 队列投影分组里新增一条：bootstrap 同时带 `turn.started` 锚点与两条 `queue.enqueued` - 断言 `turnRunning` / `turnUserItemId` / `pendingTurns` 三者同时正确，而不是各测一半 - 只加用例，不改实现	2026-09-30 12:43:32 +08:00
k88936	d341a9be13	补中途加入者的合并快照用例 ... - 新增 `late_subscriber_sees_the_running_turn_and_the_pending_queue_together` - 钉住：正在跑那一轮的 `turn.started` 锚点（带开口条目身份）与还排着的 `queue.enqueued` 同时进 bootstrap，顺序按事件序 - 原有用例各覆盖一半（一条只测队列、一条只测锚点），这条覆盖两者同时存在的中途加入场景	2026-09-30 12:43:20 +08:00
kdletters	39823b05c1	修复Jenkins release渠道测试环境污染 ... 固定发布构建单测使用dev渠道，避免继承Jenkins的release环境变量。 记录Mac构建在Windows目标测试中读取NSIS配置失败的根因与排障口径。	2026-09-30 12:00:13 +08:00
kdletters	b7862288d0	移除AGC正式渠道产品名后缀 ... - release 渠道复用正式产品名陶泥儿，安装包与更新归档不再包含 Release 文本。 - 保留 release identifier 与 release-win/release-mac 更新分区，更新渠道身份回归测试。 - 同步客户端发布、运维与项目记忆文档。	2026-09-30 11:51:03 +08:00
k88936	75f9bbacb1	入队前先判容量：满了不再做工程准备 ... - `direct_thread_manager` 新增只读的 `direct_pending_turn_count`（管理器 `pending_turn_count` + 模块级封装） - `enqueue_direct_codex_turn_typed` 在前置条件之后、工程准备之前先做一次容量预判，满队直接返回 `QueueFull` - 工程准备是分钟级、会在磁盘留产物的活，为注定收不下的消息先做它没有意义；权威判据仍是入队临界区里的检查 - 补一条管理器用例钉住这个只读口径：只数在队条目，认领 / 取消后立刻跟着变	2026-09-30 11:50:38 +08:00
k88936	a83ed01313	删掉重复且永不成立的项目切换守卫 ... - `runTurn` 的 catch 里同一判据写了两遍，两处之间只有同步代码、没有 await，`projectPathRef.current` 不可能变 - 保留 await 之后那一遍，删掉其后永远不会成立的第二遍 - 不改行为：守卫效果由前一处完整覆盖	2026-09-30 11:45:44 +08:00
k88936	25cec7955a	取消失败提示改成普通分支，去掉嵌套三元 ... - `cancelPendingTurn` 里三路结果（不在队 / 已放行 / 已取消）改用 if / else 表达 - 已放行那一路的说明注释挪到对应的分支上 - 不改任何文案与行为	2026-09-30 11:44:36 +08:00
k88936	20126ead0c	注释用词统一：入队半 / 放行半 改成 入队侧 / 放行侧 ... - `codex_app_server/mod.rs` 两处、`direct_runtime/mod.rs`、`direct_thread_queue.rs`、`direct_runtime/user_input.rs` 各处的简体表述统一 - 同步实施计划文档里的同一处措辞，保持词汇一致 - 只改措辞，不改任何行为	2026-09-30 11:43:21 +08:00
k88936	f4558475a0	取消待发消息时清掉它的埋点句柄 ... - 控制器在 `remove_direct_project_pending_turn` 返回 `removed` 时删除该 `clientTurnId` 的埋点句柄 - 被取消的待发消息永远不会放行、也就不会有自己的 `turn.completed`，句柄留着只会泄漏 - 留着还会挤进"身份缺失"的兜底结算候选（挑认领表里最早那一条），把下一次结算算到没跑过的回合头上 - 补一条 appSurface 用例钉住这条不变式：回放没有身份的失败终态时，兜底结算只落到还能收口的那一条	2026-09-30 11:42:57 +08:00
k88936	3e8954548a	测试替身对齐宿主的按身份判定：alreadyDispatched 只认正在跑那一条 ... - hostQueue 记录被放行的 clientTurnId，cancel 只在身份一致时回 alreadyDispatched，其余回 notFound - 与宿主 remove_pending_turn（按 active_turn.turn_id 比对）保持一致，避免复用该替身时掩盖 notFound 分支	2026-09-30 11:33:42 +08:00
k88936	4e8b269816	删掉 TurnAlreadyRunning：入队化后没有并发撞单的生产点 ... - 删 DirectTurnError::TurnAlreadyRunning 变体，以及 is_reportable / Display 的对应分支与专属用例 - 前端 directTurnEnqueueFailureNotice 删掉 turnAlreadyRunning 分支；ts-rs 绑定同步删除该变体 - 结构化载荷用例的样本换成 queueFull，本地说明用例的文案样本换成队列已满提示	2026-09-30 10:39:53 +08:00
k88936	ecac9d8e15	DirectProject 调用身份归 Thread Manager：删掉第二份进程内守卫表 ... - 新增 Thread Manager 的只读身份入口：DirectTurnIdentity + read_direct_turn_identity，占用仍只由终态出口解除 - 五个身份读者（执行会话、工具桥、校验预约、上下文预取、付费美术重生成）改读 direct_active_turn_id_at - 删 DirectTaonierActiveInvocationGuard / DIRECT_TAONIER_ACTIVE_INVOCATIONS / DirectActiveTurnView 与只读探测 - 删 release_stale_direct_taonier_active_invocation，改为 direct_stale_turn_for_release 只做前置校验（身份一致 + 启动窗口），释放仍由 complete_direct_thread_turn + kick_direct_queue_dispatch 完成 - DirectStaleTurnReleaseReason 取代 DirectTaonierStaleGuardReason；终止兜底的注释与文案改成占用口径 - 放行不再另取调用身份：认领时已在 Thread Manager 登记，删掉认领后的守卫进入与失败分支 - 新增前置判据用例 stale_cancel_releases_the_occupancy_and_dispatches_the_next_pending_turn，并补背景拨时测试钩子 - 集成用例改用 DirectTurnReservation::accept_for_test 建占用，不再进守卫	2026-09-30 10:39:32 +08:00
k88936	25f3e41623	CLI 与夹具退役：DirectProject 只剩入队一个命令入口 ... - cli.rs 删 CliCommand::DirectCodexChat 变体、project_path_mut 分支、--direct-codex-chat 解析与派发 - direct_runtime/mod.rs 删 run_direct_game_creator_turn_at 与 run_direct_game_creator_turn_at_with_creation_type - 删 scripts/direct-execution-production-fixture.mjs（CLI 唯一消费者） - user_input.rs 模块注释改成"唯一的命令入口"，不再承诺 CLI 分工 - 顺带删掉只剩测试在用的 direct_turn_error_boundary_text，判据只剩 direct_turn_enqueue_failure 一处 - 三条命令边界测试改打 direct_turn_enqueue_failure(...).message，覆盖不变 - 文档：09-22 里程碑把 --direct-codex-chat 从"范围外（保留）"改成退役项，两份 Direct 技术方案的 CLI 承诺删掉， 09-23 ADR 的"CLI 保持 await"标为口径反转，decision-log 追加口径修正，实施计划标注第 4 步落地	2026-09-30 10:25:38 +08:00
k88936	0534e9c678	前端收口：待发消息队列改由事件投影驱动，退役本地队列机器 ... - 新增 conversation/directPendingTurns.ts：入队/移除两个纯函数，不判上限、不排期、不排序 - reducer 新增 queue.enqueued / queue.removed 分支，折成 pendingTurns 投影 - chip 文案派生搬到 pendingTurnChipLabel.ts，删除 chatComposerQueue.ts 整套本地队列实现 - controller 退役 queuedTurns / queueSequenceRef / completionPendingRef / busyBaselineTurnCountRef 与看门 counts effect；取消 chip 改调 remove_direct_project_pending_turn 按 typed 结果说话 - 埋点句柄按 clientTurnId 存表，回合终态按本轮开口条目身份结算 - turnBusy 改名 commandInFlight 并收窄成 IPC 在飞；忙态 = 原生在跑 ∨ IPC 在飞 ∨ 待发消息非空 - 提交改成等命令的入队结果：用户自己能改的入队失败保留草稿，其余按已交出处理 - 测试：队列投影单测、入队只发一次 IPC、IPC 在飞挡住第二次提交、满队保留草稿、取消已放行条目 - 文档：实施计划标注第 0–3 步落地并补第 3 步细则，ADR 的埋点与退役面口径改成落地后的写法	2026-09-30 10:20:37 +08:00
lhk229	716aad24d9	Merge branch 'master' into opt/hide-docs-name	2026-09-29 22:46:45 +08:00
kdletters	8315d5660a	后台公共组件收口到共享组件库并统一列表实现 ... - packages/shared/src/components/admin/ 新增 16 个后台共享组件（AdminPage/AdminPanel/AdminButton/AdminAlert/AdminTable/AdminField/AdminInfoList/AdminTagList/AdminPagination/AdminListPanel/AdminDialog 等）与随组件的 admin.css，经 @genarrative/shared/components 导出 - AdminListPanel 统一列表外壳：columns + renderRow、加载两口径（empty/line）、空态三态（state/text/row）、toolbar 与 pagination 槽位、showEmpty 判据、surface=plain（弹窗内列表） - AdminListPanel 新增列头排序（sortable/sortValue/sortDescription）：正序→倒序→不排序循环、同步 th[aria-sort]、稳定排序 - AdminDialog 统一弹窗外壳（遮罩/标题行/关闭动作/role=dialog/aria-modal/Esc/点遮罩关闭/初始聚焦/as=form），12 处各页自写弹窗全部改用它 - AdminFormat 新增 formatAdminDateTime/formatAdminDate，删除 7 份重复的本地时间格式化实现，修掉列表里裸 ISO 时间 - 21 个文件里 26 处列表全部迁到 AdminListPanel（24 处 columns 形态、2 处弹窗内 plain），页内已无手写表头或 AdminTable 当 children 的写法；累计 45 个可排序列 - 页面壳归一：错误报告补 AdminPage wide + AdminPageHeading，详情弹窗移出列表面板；模板管理列表从共享 ui Table 换成 AdminTable - 样式收口：公共组件规则随组件进入共享 styles，清理 admin.css 重复按钮/面板规则，.admin-tag 与 .admin-table th 改 nowrap，埋点用户列参考按钮紧跟本行并留行距，错误报告修版心 - 新增 scripts/admin-web-fake-api.mjs 本地假 API（含 overview/dashboard/tracking/error-reports/feature-gates/邀请码/兑换码/任务/充值/项目工程/AGC 模型与模板/游戏/账号/用户详情夹具），用于本地核对渲染 - docs 同步：共享基础组件库与展示页（后台组件层/列表排序/收敛范围/本地核对）、decision-log 与 pitfalls 记录迁移口径、排序边界与踩坑 - 验证：npm run admin-web:typecheck、npx vitest run apps/admin-web packages/shared/src/components/admin（26 files / 244 tests）、npm run check:encoding、git diff --check、prettier、eslint 全部通过	2026-09-29 22:39:41 +08:00
suzmii	2cc7df8074	修复 DirectProject 流式正文逐 delta 脱敏吃掉段尾换行导致 Markdown 结构损坏 ... - prompt_context.rs：sanitize_error_context 改为 split_inclusive('\n') 逐段处理并原样保留行终止符，「逐段脱敏」与「整段脱敏」同形（CRLF 仍归一成 LF，私钥块整行吞掉的旧口径不变） - codex_app_server/mod.rs：新增 direct_thread_delta_sanitization_preserves_line_breaks，钉住逐段脱敏 == 整段脱敏，去掉 split_inclusive 即红 - pitfalls.md：记入本次排障（含 chunk 起点路径误判这一同源未修缺陷）	2026-09-29 21:30:44 +08:00