完善项目工作台入口与账户兑换码

修复 DirectProject 提交时的项目快照空值类型错误将运行中项目列表移入窗口标题栏并支持展开查看增加项目内打开项目目录按钮在账户资产条中直接显示兑换码入口并保留兑换弹窗补充相关测试、类型检查与产品文档
2026-09-16 01:54:29 +08:00
parent 9722442b44
commit d650bf9b74
18 changed files with 712 additions and 34 deletions
@@ -111,6 +111,10 @@

 2026-08-23：项目开发工作台取消顶部账户资产预留空间，资源管理主视窗与 Agent 对话从窗口顶端铺开；泥点余额 / 充值入口复用既有账户组件并放置在 Agent 对话标题栏右上角，对话标题在该视窗顶部居中。

+2026-09-16：项目内工具栏增加“打开项目目录”入口，资源管理与运行页签均可使用；入口复用现有本地项目目录打开命令，不新增项目状态或文件访问链路。
+
+2026-09-16：客户端标题栏账户资产条在传入兑换能力时直接显示“兑换码”按钮；兑换弹窗和账号生命周期校验继续复用现有实现。
+
 - 项目工作台继续保留左侧平台导航、中央主视窗、右侧 Project Supervisor 和底部专业 Agent 状态栏四区结构；主站图片编辑器只作为视觉语言和共享画布组件的事实源，不把其素材库侧栏、账号业务或云端项目外壳整体搬入客户端。
 - 平台主题事实源固定为 `packages/shared/src/theme.css`。画布通用 chrome 固定落在 `@genarrative/image-canvas-react`，主站与 Tauri 必须直接 import 同一组件和作用域样式；客户端不得复制 `src/components/image-editor/`，也不得导入主站完整 `src/index.css`。
 - 第一批共享 chrome 固定覆盖画布动作按钮、工具栏、工具分组和分隔符。按钮的默认、悬停、键盘焦点、选中、禁用和主次色语义由共享层表达；宿主只提供图标、文案、事件与业务禁用条件。
@@ -29,7 +29,7 @@ Milestone: `【里程碑】Direct回合跨页面生命周期与运行中项目

 1. Rust：扩展活动回合注册表并暴露只读快照命令，配定向用例（进入 / 进度 / 终态移除 / 多项目并存）。
 2. 前端：接入快照读取，实现“重新进入项目 → 恢复忙碌态与进度 → 以快照 sequence 续接 → 阻止并发提交”。
-3. 前端：在左上角空白区域挂载“正在运行的项目”面板，复用既有组件与设计 token。
+3. 前端：在窗口标题栏挂载“正在运行的项目”下拉入口；标题栏只显示最后开始的项目，展开后按开始时间列出全部项目，复用既有组件与设计 token。
 4. 报错归类：按审计结论修正会误导的映射，逐条加回归用例；真实权限拒绝保持原提示。
 5. 文档：主规范与共享记忆同步；里程碑验收后删除临时计划文件。

@@ -7,7 +7,7 @@ Parent Spec: `docs/technical/【技术方案】AI游戏创作智能体App实施

 ## 目标

-离开项目界面不再等于“回合消失”：后台继续跑的 Direct 回合必须能被前端重新发现并续接进度，同一项目在回合结束前不允许再发起第二条付费回合；壳层左上角提供“正在运行的项目”面板，列出当前确有在跑回合的项目并可点击进入。
+离开项目界面不再等于“回合消失”：后台继续跑的 Direct 回合必须能被前端重新发现并续接进度，同一项目在回合结束前不允许再发起第二条付费回合；壳层窗口标题栏提供“正在运行的项目”下拉入口，常态显示最后开始的项目，展开后列出当前确有在跑回合的全部项目并可点击进入。

 ## 边界

@@ -22,7 +22,7 @@ Parent Spec: `docs/technical/【技术方案】AI游戏创作智能体App实施
 - 重新进入有在跑回合的项目后：界面进入“正在处理”、显示最近一次进度、以快照 `sequence` 续接后续事件；回合结束前提交第二条需求不会真正发起第二条付费回合。
 - 回合结束（completed / failed）后：忙碌态解除、可以再次发送；不重复追加助手消息。
 - 无在跑回合的项目：行为与今天一致（可正常发送，不出现额外提示或阻塞）。
- 左上角面板：列出所有在跑项目，按 `startedAt` 升序，显示项目名（缺失时回退目录名）与状态/时长，点击进入对应项目；没有在跑回合时不渲染面板外壳。
+- 窗口标题栏入口：常态只显示最后开始的项目，点击后按 `startedAt` 升序列出所有在跑项目，显示项目名（缺失时回退目录名）与状态/时长，点击进入对应项目；没有在跑回合时不渲染入口。
 - 快照读取失败不得阻断发送、不得显示成业务失败。
 - 已修的错误映射不回归：`direct-codex-turn-already-running:` 与历史同义中文正文都归一到“仍在处理这个项目的上一条需求”；真正的 `项目权限策略拒绝执行：<command>` 仍显示审批提示。

@@ -1407,6 +1407,6 @@ DirectProject、Agent Runtime、Provider、app-server、内置 MCP、命令执

 Direct 回合的所有权属于进程内项目身份锁，不属于当前页面。离开工作台或切换到首页时，正在运行的回合继续执行；重新进入项目时，前端先读取同一份只读活动回合快照，再通过 Thread Manager 订阅 bootstrap 和后续事件恢复忙碌态、进度与未完成回复。活动回合结束后移除快照并解除发送阻断；没有活动回合的项目保持原有发送行为。

-壳层左上角的“正在运行”面板只呈现活动 Direct 回合快照，按开始时间排序，显示项目名、状态、活动时长并允许进入对应项目。快照读取失败只显示读取失败并保留上一份结果，不得改写成权限、审批或业务失败；面板不建立第二份运行真相。应用重启后的恢复、取消入口和非 Direct Agent 项目不在本合同内。
+壳层窗口标题栏的“正在运行”下拉入口只呈现活动 Direct 回合快照：常态只显示最后开始的项目，展开后按开始时间排序，显示全部项目的项目名、状态、活动时长并允许进入对应项目。快照读取失败只显示读取失败并保留上一份结果，不得改写成权限、审批或业务失败；入口不建立第二份运行真相。应用重启后的恢复、取消入口和非 Direct Agent 项目不在本合同内。

 活动回合快照命令是进程内 Tauri 只读命令，不进入公共 API 或持久化协议；字段包含 `projectPath / projectName / turnId / status / activity / startedAt / updatedAt / sequence`，状态和序号与既有 Direct 回合进度事件一致。