854 lines
19 KiB
Markdown
854 lines
19 KiB
Markdown
# 微信式项目会话与聊天页规格
|
||
|
||
这份文档用于冻结“第一屏 = 微信式会话列表”的产品逻辑，避免后续开发时又回到“移动控制台首页”的方向。
|
||
|
||
视觉对标：
|
||
|
||
- 微信 iPhone 版会话列表页的核心结构
|
||
- 官方来源：[微信 App Store 页面](https://apps.apple.com/cn/app/id414478124)
|
||
|
||
适用范围：
|
||
|
||
- 手机 App 第一屏
|
||
- 设备页（对应微信通讯录位置）
|
||
- 我的页（对应微信“我”）
|
||
- 项目聊天页
|
||
- 主 Agent 置顶会话
|
||
- 项目会话列表
|
||
- 设备头像 / 协作群聊头像
|
||
- 手动置顶
|
||
- 项目目标
|
||
- 版本迭代记录
|
||
- 图片 / 视频 / 语音输入
|
||
- 消息转发
|
||
|
||
---
|
||
|
||
## 1. 首页定位
|
||
|
||
首页不是“主 Agent 聊天正文页”。
|
||
|
||
首页应该是：
|
||
|
||
- 一个微信式的会话列表页
|
||
- 列表中的每一条会话都代表一个“项目对话”
|
||
- 列表顶部固定一条 `主 Agent` 会话
|
||
- 用户点击任意一条会话，再进入该项目的具体对话页
|
||
|
||
一句话定义：
|
||
|
||
`第一屏 = 主 Agent 总会话 + 各项目会话列表`
|
||
|
||
底部导航要求：
|
||
|
||
- 第一项：`会话`
|
||
- 第二项：`设备`
|
||
- 第三项：`我的`
|
||
- 呈现方式：微信式扁平底栏，`图标在上 / 文案在下 / 激活项使用微信绿`
|
||
|
||
其中第二项 `设备` 对应微信中的“通讯录”位置。
|
||
第三项 `我的` 对应微信中的“我”。
|
||
项目入口不再占据底部一级导航，而是从 `会话` 首页进入。
|
||
|
||
---
|
||
|
||
## 2. 项目会话与设备项目文件夹的映射规则
|
||
|
||
每一个项目会话必须和设备端 GUI 界面里的项目文件夹一一对应。
|
||
|
||
映射规则如下：
|
||
|
||
1. 每台接入设备启动 `worker-daemon` 后，扫描并注册本机可见项目根目录。
|
||
2. 每个项目目录生成稳定的 `project_folder_key`。
|
||
3. 云端控制面把同名或同一仓库来源的文件夹，映射到同一个 `project_id`。
|
||
4. 主 Agent 不直接生成“虚拟项目名”，而是基于 `project_id` 做汇总。
|
||
5. 首页列表展示的项目会话标题，优先使用：
|
||
- 项目显式别名
|
||
- 仓库名 / 文件夹名
|
||
- 最后回退到 `project_id`
|
||
|
||
必须满足：
|
||
|
||
- 一个项目会话能追溯到具体设备上的具体文件夹
|
||
- 进入项目详情时，能看到这个项目当前挂在哪些设备上
|
||
|
||
---
|
||
|
||
## 3. 会话列表项类型
|
||
|
||
首页列表至少包含 3 类会话项：
|
||
|
||
### 3.1 主 Agent 会话
|
||
|
||
规则：
|
||
|
||
- 永远固定在最上面
|
||
- 永远视为置顶
|
||
- 不允许取消置顶
|
||
- 头像使用独立主 Agent 头像
|
||
- 最新摘要由主 Agent 汇总生成
|
||
|
||
展示字段：
|
||
|
||
- 标题：`主 Agent`
|
||
- 摘要：项目汇总、风险提醒、待确认事项
|
||
- 时间：主 Agent 最后一次完成汇总的时间
|
||
- 标签：`置顶`
|
||
|
||
### 3.2 单设备项目会话
|
||
|
||
规则：
|
||
|
||
- 一个项目当前只由一台设备执行
|
||
- 列表头像使用该设备独立头像
|
||
- 摘要使用该设备最近一次返回给主控的有效摘要
|
||
|
||
展示字段：
|
||
|
||
- 标题：项目名
|
||
- 摘要：`设备名 + 最新一句摘要`
|
||
- 右侧第一行：若已置顶则显示 `置顶`，未置顶留白
|
||
- 右侧第二行：该设备对这个项目的最后回传时间
|
||
- 右侧第三行：背景信息窗口余量指示器（圆环进度标记 + 百分比）
|
||
|
||
### 3.3 多设备协作项目会话
|
||
|
||
规则：
|
||
|
||
- 一个项目已经进入多设备协作
|
||
- 列表头像使用“组合头像”
|
||
- 逻辑上等价于微信中的群聊
|
||
|
||
展示字段：
|
||
|
||
- 标题：项目名
|
||
- 摘要：`设备A + 设备B + 最新一句协作摘要`
|
||
- 右侧第一行：留白，除非用户手动置顶
|
||
- 右侧第二行：参与设备中最后一次回传时间的最大值
|
||
- 右侧第三行：不显示剩余使用量
|
||
|
||
---
|
||
|
||
## 4. 头像规则
|
||
|
||
### 4.1 单设备头像
|
||
|
||
每台设备必须有自己独立头像。
|
||
|
||
建议最小字段：
|
||
|
||
- `device_id`
|
||
- `device_name`
|
||
- `device_type`
|
||
- `avatar_mode`
|
||
- `avatar_color`
|
||
- `avatar_label`
|
||
- `avatar_asset_url`
|
||
|
||
优先级：
|
||
|
||
1. 设备自定义头像
|
||
2. 系统生成头像
|
||
3. 文本缩写头像
|
||
|
||
建议默认缩写：
|
||
|
||
- `Mac Studio` -> `M`
|
||
- `Windows GPU` -> `W`
|
||
- `Cloud Worker` -> `C`
|
||
|
||
### 4.2 群聊式组合头像
|
||
|
||
当项目由多台设备协作时：
|
||
|
||
- 使用组合头像
|
||
- MVP 阶段支持 2 设备叠放头像
|
||
- 后续可扩展到 3~4 设备拼接头像
|
||
|
||
组合规则：
|
||
|
||
- 2 设备：左右叠放
|
||
- 3 设备：主头像 + 右上 / 右下
|
||
- 超过 3 台时：显示 2~3 个头像 + `+N`
|
||
|
||
排序规则：
|
||
|
||
- 优先主执行设备
|
||
- 再按最近活跃度排序
|
||
|
||
---
|
||
|
||
## 5. 列表排序规则
|
||
|
||
首页排序不能只是项目创建时间排序。
|
||
|
||
排序必须按以下优先级：
|
||
|
||
1. `主 Agent` 会话，永远第一
|
||
2. 用户手动置顶的项目会话
|
||
3. 未置顶项目，按 `latest_reply_at DESC`
|
||
|
||
其中：
|
||
|
||
- `latest_reply_at` = 该项目参与设备最后一次有效回传时间的最大值
|
||
- “有效回传”包括：
|
||
- 线程摘要
|
||
- 审计结论
|
||
- 运维修复结果
|
||
- 关键错误 / 告警事件
|
||
|
||
不应计入：
|
||
|
||
- 心跳包
|
||
- 纯监控噪声日志
|
||
- 无内容变化的重复状态刷新
|
||
|
||
---
|
||
|
||
## 6. 手动置顶规则
|
||
|
||
首页必须支持长按会话条置顶。
|
||
|
||
交互规则：
|
||
|
||
- 长按普通项目会话 -> 弹出操作菜单
|
||
- 菜单包含：
|
||
- `置顶`
|
||
- `取消置顶`
|
||
- `标记已读`
|
||
- `查看项目详情`
|
||
|
||
排序规则：
|
||
|
||
- 主 Agent 永远第一
|
||
- 用户置顶项目在主 Agent 之后
|
||
- 多个置顶项目按最近消息时间排序
|
||
|
||
注意：
|
||
|
||
- 主 Agent 不允许取消置顶
|
||
- 系统需要记录 `manual_pinned = true/false`
|
||
|
||
---
|
||
|
||
## 7. 首页列表项最小展示字段
|
||
|
||
每一条项目会话至少要有：
|
||
|
||
- `conversation_id`
|
||
- `conversation_type`
|
||
- `project_id`
|
||
- `project_title`
|
||
- `avatar_render_model`
|
||
- `latest_summary`
|
||
- `latest_reply_at`
|
||
- `manual_pinned`
|
||
- `context_budget_remaining_pct`
|
||
- `context_budget_indicator_style`
|
||
- `context_budget_level`
|
||
- `compaction_expected_at`
|
||
- `unread_count`
|
||
- `risk_level`
|
||
- `active_device_count`
|
||
|
||
可选增强字段：
|
||
|
||
- `device_names_preview`
|
||
- `audit_pending_count`
|
||
- `ops_alert_count`
|
||
- `compaction_risk`
|
||
- `must_finish_before_compaction`
|
||
|
||
---
|
||
|
||
## 8. 建议新增的数据对象
|
||
|
||
在现有 `projects / threads / thread_events` 之上，建议增加：
|
||
|
||
- `project_conversations`
|
||
- `project_conversation_items`
|
||
- `project_conversation_participants`
|
||
- `device_avatars`
|
||
- `conversation_pin_state`
|
||
|
||
### 8.1 `project_conversations`
|
||
|
||
核心字段：
|
||
|
||
- `conversation_id`
|
||
- `project_id`
|
||
- `conversation_type` (`master` / `single_device` / `multi_device`)
|
||
- `title`
|
||
- `latest_summary`
|
||
- `latest_reply_at`
|
||
- `manual_pinned`
|
||
- `sort_bucket`
|
||
|
||
### 8.2 `project_conversation_participants`
|
||
|
||
核心字段：
|
||
|
||
- `conversation_id`
|
||
- `device_id`
|
||
- `role`
|
||
- `is_primary`
|
||
- `last_reply_at`
|
||
|
||
### 8.3 `conversation_pin_state`
|
||
|
||
核心字段：
|
||
|
||
- `conversation_id`
|
||
- `pin_type` (`system` / `manual`)
|
||
- `pinned_by`
|
||
- `pinned_at`
|
||
|
||
---
|
||
|
||
## 9. 首页 UI 结构
|
||
|
||
建议结构：
|
||
|
||
1. 状态栏
|
||
2. 页面标题：`会话`
|
||
3. 搜索 / 说明条
|
||
4. 会话列表
|
||
5. 底部导航
|
||
|
||
会话列表项布局：
|
||
|
||
- 左侧：头像
|
||
- 中间：标题 + 最近摘要
|
||
- 右侧：三层信息轨
|
||
|
||
右侧三层信息轨规则：
|
||
|
||
- 第一层：`置顶` 标签；若未置顶则保留空白高度
|
||
- 第二层：最后一次有效会话时间
|
||
- 第三层：背景信息窗口余量指示器
|
||
- 群聊型项目会话不展示第三层额度信息
|
||
|
||
背景信息窗口余量指示器规则：
|
||
|
||
- 使用统一的小圆环进度标记 + 百分比数字
|
||
- 样式和设备端线程页保持一致，不允许手机端自行推导一套不同视觉
|
||
- 数据来源于设备端 `worker-daemon` 上报的线程上下文预算，而不是前端本地估算
|
||
- 指示器表达的是“当前线程在发生背景信息压缩前，还剩多少可安全使用空间”
|
||
- 该值越低，越需要主 Agent 在压缩前完成关键收尾、证据固化和线程交接
|
||
|
||
视觉要求：
|
||
|
||
- 更接近微信会话列表
|
||
- 不要做成项目管理后台
|
||
- 不要把大量设备、审计字段直接塞进首页列表
|
||
- 首页只保留最适合“扫一眼决定先点谁”的信息
|
||
- 对单设备项目允许展示轻量额度信息，但群聊型项目不显示额度
|
||
- 首页中的圆环指示器展示的是“线程上下文预算”，不是账号 5h / 7d 额度，两者不能混用
|
||
|
||
---
|
||
|
||
## 10.1 主 Agent 的上下文预算协作逻辑
|
||
|
||
这部分是整个系统里多线程协作的核心调度信号。
|
||
|
||
主 Agent 必须持续读取每个线程的：
|
||
|
||
- `context_budget_remaining_pct`
|
||
- `context_budget_level`
|
||
- `compaction_expected_at`
|
||
- `must_finish_before_compaction`
|
||
|
||
主 Agent 的默认策略：
|
||
|
||
- `safe`：`>= 60%`
|
||
- 允许继续正常推进任务
|
||
- `watch`：`40% ~ 59%`
|
||
- 不再给该线程追加大块背景信息
|
||
- 要求该线程开始产出阶段摘要
|
||
- `urgent`：`25% ~ 39%`
|
||
- 主 Agent 应优先让该线程完成当前原子子任务
|
||
- 同时预创建下一条接力线程和 handoff 摘要
|
||
- `critical`：`< 25%`
|
||
- 禁止继续扩张上下文
|
||
- 主 Agent 必须优先触发“压缩前收尾”
|
||
- 包括：补齐关键结论、未提交 patch、命令记录、测试结论、证据引用、未决问题
|
||
|
||
压缩前收尾的优先顺序：
|
||
|
||
1. 当前正在修改但尚未固化的代码和补丁
|
||
2. 解释问题所必需的命令、日志、文件路径和测试结果
|
||
3. 与下一线程交接有关的关键决策和未决问题
|
||
4. 硬件测试 / 多模态审计所需的证据引用
|
||
|
||
设计原则：
|
||
|
||
- 不要等发生 compaction 之后再补救
|
||
- 主 Agent 必须尽量在 compaction 之前完成关键任务或完成线程交接
|
||
- 首页会话列表里的圆环标记，必须能帮助用户和主 Agent 同时感知哪些项目最接近上下文风险边缘
|
||
|
||
---
|
||
|
||
## 10. 和整体系统设计的关系
|
||
|
||
这套首页设计不会改变整体架构，只改变第一屏的信息组织方式。
|
||
|
||
对应关系如下：
|
||
|
||
- `projects` 提供项目真相
|
||
- `threads` 提供线程真相
|
||
- `thread_events` 提供最近事件
|
||
- `worker_account_bindings` / `gptpluscontrol` 提供设备与账号状态
|
||
- `project_conversations` 负责把这些底层状态重组为“会话列表”
|
||
|
||
所以：
|
||
|
||
- 底层仍是多机多线程系统
|
||
- 首页表现层收敛成微信式会话列表
|
||
- 主 Agent 仍然是总入口
|
||
- 项目会话只是“主 Agent 汇总后暴露出来的二级会话壳”
|
||
|
||
---
|
||
|
||
## 11. 项目聊天页结构
|
||
|
||
点击首页任意项目会话后，进入“微信式聊天页”。
|
||
|
||
聊天页结构固定为：
|
||
|
||
1. 状态栏
|
||
2. 聊天页头部
|
||
3. 顶部能力入口
|
||
4. 消息流
|
||
5. 媒体 / 转发入口
|
||
6. 语音 / 文本输入区
|
||
|
||
页面要求：
|
||
|
||
- 尽量接近微信聊天详情页的层级和节奏
|
||
- 不显示底部 tab bar
|
||
- 重点是聊天，而不是后台字段
|
||
|
||
---
|
||
|
||
## 12. 顶部两个固定按钮
|
||
|
||
项目名称下面必须增加两个并列按钮。
|
||
|
||
布局要求：
|
||
|
||
- 同一行
|
||
- 横向总宽度 100%
|
||
- 两个按钮各占一半宽度
|
||
|
||
按钮定义：
|
||
|
||
- `项目目标`
|
||
- `版本迭代记录`
|
||
|
||
---
|
||
|
||
## 13. 项目目标规则
|
||
|
||
`项目目标` 的生成和维护规则：
|
||
|
||
- 初始目标由用户和主 Agent 沟通后创建
|
||
- 主 Agent 负责整理成结构化目标
|
||
- 用户允许手动编辑
|
||
- UI 以“圆形单选式完成标记”展示每一条目标
|
||
- 用户或主 Agent 将目标标记完成后，目标正文自动加删除线
|
||
- 主 Agent 根据项目目标做任务拆解、督促和规划
|
||
- 各线程都要以项目目标为约束执行开发和测试
|
||
|
||
建议数据对象：
|
||
|
||
- `project_goals`
|
||
- `project_goal_revisions`
|
||
- `project_goal_items`
|
||
- `project_goal_completion_logs`
|
||
|
||
核心字段：
|
||
|
||
- `project_id`
|
||
- `goal_title`
|
||
- `goal_body`
|
||
- `goal_order`
|
||
- `display_style` (`radio_checklist`)
|
||
- `completion_state` (`pending` / `completed`)
|
||
- `completed_by`
|
||
- `completed_at`
|
||
- `source` (`human` / `master_agent`)
|
||
- `is_active`
|
||
- `edited_by`
|
||
- `edited_at`
|
||
|
||
权限规则：
|
||
|
||
- 用户可编辑
|
||
- 用户可标记目标已完成
|
||
- 主 Agent 可整理和建议修改
|
||
- 主 Agent 可复核目标完成状态并修正排序
|
||
- 普通 worker 线程不能直接改项目目标
|
||
|
||
### 13.1 项目目标页交互
|
||
|
||
项目目标页必须明确体现以下交互：
|
||
|
||
- 每条目标左侧使用圆形单选式完成标记
|
||
- 标记完成后，当前目标正文自动加删除线
|
||
- 已完成目标显示 `已完成` 状态和完成时间
|
||
- 未完成目标显示 `进行中` 或 `待处理`
|
||
- 顶部仍保留 `编辑目标` 入口
|
||
- `编辑目标` 只允许用户和主 Agent 修改目标内容
|
||
- 普通 worker 线程只能读取，不可直接改写
|
||
|
||
---
|
||
|
||
## 14. 版本迭代记录规则
|
||
|
||
`版本迭代记录` 的生成和维护规则：
|
||
|
||
- 由主 Agent 监督各项目进程
|
||
- 定期自动汇报每一个版本号更新的内容
|
||
- 主 Agent 负责校验各线程提交上来的版本更新记录是否准确
|
||
- 版本迭代记录是只读记录
|
||
- 用户不能直接编辑版本记录正文
|
||
|
||
建议数据对象：
|
||
|
||
- `version_iteration_reports`
|
||
- `version_iteration_sources`
|
||
- `version_iteration_reviews`
|
||
|
||
核心字段：
|
||
|
||
- `project_id`
|
||
- `version_name`
|
||
- `change_summary`
|
||
- `source_thread_ids`
|
||
- `generated_by`
|
||
- `verified_by_master`
|
||
- `published_at`
|
||
|
||
权限规则：
|
||
|
||
- 主 Agent 可生成 / 复核 / 发布
|
||
- 用户可查看
|
||
- 用户不可直接改正文
|
||
- worker 线程只能提交候选更新，不可直接发布
|
||
|
||
---
|
||
|
||
## 15. 聊天能力范围
|
||
|
||
项目聊天页必须支持：
|
||
|
||
- 文本输入
|
||
- 语音输入
|
||
- 图片发送
|
||
- 视频发送
|
||
- 图片 / 视频 / 文本转发到其他聊天窗口
|
||
|
||
建议最小对象：
|
||
|
||
- `conversation_messages`
|
||
- `message_attachments`
|
||
- `message_forwards`
|
||
|
||
其中：
|
||
|
||
- `message_attachments` 支持 `image / video / file / voice`
|
||
- `message_forwards` 必须记录：
|
||
- `source_conversation_id`
|
||
- `target_conversation_id`
|
||
- `message_id`
|
||
- `forwarded_by`
|
||
- `forwarded_at`
|
||
|
||
---
|
||
|
||
## 16. 设备页规格
|
||
|
||
设备页对应底部第二个导航项，位置等价于微信的“通讯录”。
|
||
|
||
功能目标：
|
||
|
||
- 展示当前已接入设备
|
||
- 展示各设备登录账号
|
||
- 展示各设备当前运行项目
|
||
- 展示各设备剩余额度
|
||
- 支持新增设备
|
||
- 支持设备管理
|
||
|
||
### 16.1 页面结构
|
||
|
||
设备页结构固定为：
|
||
|
||
1. 状态栏
|
||
2. 页面标题：`设备`
|
||
3. 右上角 `+ 添加`
|
||
4. 长按操作提示
|
||
5. 设备列表
|
||
6. 底部导航
|
||
|
||
### 16.2 列表项最小字段
|
||
|
||
每一台设备至少展示：
|
||
|
||
- `device_name`
|
||
- `device_avatar`
|
||
- `account_display_name`
|
||
- `running_projects_summary`
|
||
- `quota_5h_remaining`
|
||
- `quota_7d_remaining`
|
||
- `device_status`
|
||
|
||
### 16.3 设备状态颜色
|
||
|
||
状态必须显式展示为圆点或小标记：
|
||
|
||
- 绿色：设备在线
|
||
- 红色：设备异常
|
||
- 灰色：设备掉线
|
||
|
||
建议枚举：
|
||
|
||
- `online`
|
||
- `abnormal`
|
||
- `offline`
|
||
|
||
### 16.4 新增设备
|
||
|
||
交互要求：
|
||
|
||
- 右上角点击 `+ 添加`
|
||
- 打开新增设备流程
|
||
- 可进入：
|
||
- 新设备绑定
|
||
- 登录引导
|
||
- token / pairing code 绑定
|
||
|
||
### 16.5 长按设备
|
||
|
||
长按任意设备条目，弹出操作菜单：
|
||
|
||
- `编辑设备名称`
|
||
- `编辑设备头像`
|
||
- `解绑设备`
|
||
|
||
### 16.6 建议新增数据对象
|
||
|
||
建议增加：
|
||
|
||
- `device_profiles`
|
||
- `device_status_snapshots`
|
||
- `device_project_bindings`
|
||
|
||
核心字段建议：
|
||
|
||
- `device_id`
|
||
- `device_name`
|
||
- `device_avatar_url`
|
||
- `device_type`
|
||
- `status`
|
||
- `account_id`
|
||
- `quota_5h_remaining`
|
||
- `quota_7d_remaining`
|
||
- `last_seen_at`
|
||
|
||
---
|
||
|
||
## 17. 我的页规格
|
||
|
||
我的页对应底部第三个导航项，位置等价于微信的“我”。
|
||
|
||
功能目标：
|
||
|
||
- 展示用户头像
|
||
- 展示账号名称
|
||
- 展示账号唯一二维码入口
|
||
- 展示账号与安全
|
||
- 展示设置
|
||
- 展示 `运维与修复` 入口
|
||
- 展示关于 / 版本号 / OTA 更新
|
||
|
||
### 17.1 页面结构
|
||
|
||
我的页结构固定为：
|
||
|
||
1. 状态栏
|
||
2. 用户信息头部
|
||
3. 功能列表
|
||
4. `关于` 及 OTA 红点
|
||
5. OTA 更新内容区
|
||
6. 底部导航
|
||
|
||
### 17.2 头部信息
|
||
|
||
头部至少展示：
|
||
|
||
- 用户头像
|
||
- 用户昵称 / 显示名
|
||
- 当前账号类型
|
||
- 右侧 `唯一二维码` 入口
|
||
|
||
二维码入口呈现规则：
|
||
|
||
- 放在头部信息卡的最右侧
|
||
- 以微信式小二维码图标呈现
|
||
- 与头像、昵称、账号类型处于同一个头部单元中
|
||
- 不再单独占一行文字说明
|
||
|
||
### 17.3 账号与安全
|
||
|
||
账号与安全页项的职责：
|
||
|
||
- 修改账号密码
|
||
- 设备安全管理
|
||
- 身份校验
|
||
|
||
MVP 要求：
|
||
|
||
- 当前先只冻结入口和字段
|
||
- 后续二级页再开发
|
||
|
||
### 17.4 设置
|
||
|
||
设置在当前版本只保留一级入口。
|
||
|
||
规则：
|
||
|
||
- 先展示
|
||
- 暂不开发二级页
|
||
|
||
### 17.5 关于与 OTA
|
||
|
||
关于项必须展示：
|
||
|
||
- 当前版本号
|
||
- 若有新 OTA，右侧显示红色 `OTA` 提示
|
||
|
||
点击后行为：
|
||
|
||
- 展示 OTA 更新内容
|
||
- 可触发 `立即 OTA`
|
||
|
||
### 17.6 OTA 更新内容区
|
||
|
||
更新内容区必须包含：
|
||
|
||
- 目标版本号
|
||
- 更新点摘要
|
||
- `立即 OTA` 按钮
|
||
|
||
建议新增数据对象：
|
||
|
||
- `user_profiles`
|
||
- `app_versions`
|
||
- `ota_updates`
|
||
- `ota_update_logs`
|
||
|
||
建议字段：
|
||
|
||
- `current_version`
|
||
- `target_ota_version`
|
||
- `has_ota_update`
|
||
- `ota_update_summary`
|
||
- `ota_update_status`
|
||
- `ota_triggered_at`
|
||
|
||
### 17.7 账号认证页
|
||
|
||
移动端必须补齐 3 个账号认证页面：
|
||
|
||
- `登录页`
|
||
- `注册页`
|
||
- `忘记密码页`
|
||
|
||
认证页规则：
|
||
|
||
- `登录页` 必须支持账号、密码、登录验证码
|
||
- `注册页` 必须支持账号、登录验证码、密码、确认密码
|
||
- `忘记密码页` 必须支持账号、登录验证码、新密码、确认新密码
|
||
- 3 个页面都要提供 `发送验证码`
|
||
- 登录验证码和找回验证码都必须进入后端校验链路
|
||
- 登录成功后才允许继续设备绑定与项目同步
|
||
- 重置密码成功后，旧设备登录态允许被系统要求重新校验
|
||
|
||
---
|
||
|
||
## 18. 已冻结的二级页面
|
||
|
||
为了避免开发时只做一级页壳子，下面这些二级页也已经纳入 UI 范围：
|
||
|
||
- `项目目标页`
|
||
- `版本迭代记录页`
|
||
- `转发到项目页`
|
||
- `添加设备页`
|
||
- `设备长按操作菜单`
|
||
- `账号与安全页`
|
||
- `关于 / OTA 页`
|
||
- `登录页`
|
||
- `注册页`
|
||
- `忘记密码页`
|
||
|
||
这些页面的目标是：
|
||
|
||
- 保持微信式的导航和扁平视觉
|
||
- 不把复杂系统状态直接做成后台面板
|
||
- 每个子页面都能对应明确的数据对象和入口来源
|
||
- 其中 `运维与修复` 必须作为 `我的` 页里的二级入口，不再作为底部一级导航
|
||
- `运维与修复` 内部再分为 `运维对话` 和 `审计对话` 两个子页
|
||
|
||
---
|
||
|
||
## 18. UI 上不直接暴露的后台逻辑
|
||
|
||
虽然聊天页外观接近微信，但底层仍然是多线程系统。
|
||
|
||
所以：
|
||
|
||
- 首页看到的是项目会话
|
||
- 聊天页看到的是主 Agent 汇总后的项目聊天流
|
||
- 底层真实 worker 线程、审计线程、运维线程仍继续工作
|
||
- 主 Agent 把底层线程状态整理成适合聊天页展示的消息
|
||
|
||
换句话说：
|
||
|
||
`UI 上是聊天，系统里仍然是多线程编排`
|
||
|
||
---
|
||
|
||
## 19. 当前 UI 原型对应
|
||
|
||
当前原型已按这套规则重绘整套核心页面：
|
||
|
||
- 主 Agent 置顶
|
||
- 单设备头像
|
||
- 双设备协作头像
|
||
- 手动置顶示例
|
||
- 会话按最近消息排序
|
||
- 项目聊天页双按钮
|
||
- 项目目标页圆形完成标记 + 自动划线
|
||
- 版本迭代记录只读展示
|
||
- 图片 / 视频 / 转发入口
|
||
- 语音输入入口
|
||
- 设备页第二导航位
|
||
- 设备在线 / 异常 / 掉线三种状态
|
||
- 右上角添加设备
|
||
- 长按设备管理提示
|
||
- 我的页第三导航位
|
||
- 账号与安全入口
|
||
- 设置入口
|
||
- 关于 + OTA 红点
|
||
- OTA 更新内容卡片
|
||
- 登录页 / 注册页 / 忘记密码页
|
||
- 登录验证码发送入口
|
||
|
||
对应文件：
|
||
|
||
- `/Users/kris/code/UI/.runtime/pencil/threads/ui-codex-ops-mobile/outputs/codex-ops-mobile-v1.pen`
|
||
- `/Users/kris/code/Talking/output/ui-codex-ops-mobile-v13/d5gpt.png`
|
||
- `/Users/kris/code/Talking/output/ui-codex-ops-mobile-v13/g8Qpr.png`
|
||
- `/Users/kris/code/Talking/output/ui-codex-ops-mobile-v13/CwqbE.png`
|
||
- `/Users/kris/code/Talking/output/ui-codex-ops-mobile-v13/i7IZ1.png`
|