boss/docs/superpowers/specs/2026-03-28-wechat-ui-restore-and-thread-group-chat-design.md

Boss 原生 Android 旧版 UI 全量还原与线程群聊设计

1. 背景

当前 Boss 原生 Android 客户端虽然已经回退到微信式一级结构，但页面视觉、主入口取舍、线程展示方式和会话模型仍然没有完全回到用户确认过的旧版 UI。

本次工作的目标不是回滚底层实现，也不是退回 WebView，而是在保留现有原生 Android、现有 API、现有登录恢复、OTA、设备绑定和主 Agent 执行链路的前提下，把前台页面和交互完整拉回旧版 UI 语言，并补齐新的线程会话与群聊规则。

本次以 design/exports/ui-codex-ops-mobile-v13/ 为唯一主视觉基准。图中出现的页面要求严格 1:1 还原；图中未出现但业务必须存在的页面，也必须延续同一套微信式轻界面、列表结构、按钮层级和信息密度，不能继续保留控制台式重面板风格。

2. 目标

本次改造完成后，APP 应满足以下目标：

1. 一级导航固定为 会话 / 设备 / 我的，整体视觉回到旧版导出图的白底、浅灰卡片、轻绿色强调风格。
2. 所有会话都按聊天工具模型理解，而不是项目卡片模型。
3. APP 中每一个聊天窗口，对应某个设备、某个 Codex 文件夹里的一个线程；同一文件夹下多个线程，在 APP 中显示为多个独立聊天窗口。
4. 会话列表主标题显示线程名；副信息指定位置显示线程所属文件夹名。
5. 会话列表每一项右下角增加动态小图标，只表达“当前后台使用数量”，不展示文字，不展示名称。
6. 线程名支持在 APP 内按微信最新逻辑修改，并同步回对应 Codex 线程。
7. 支持从聊天页右上角发起群聊，把不同设备里的不同线程拉进同一个独立群聊。
8. 群聊由主 Agent 发起和监督；开发任务状态下允许线程直接沟通，非开发任务状态下线程对话必须先经主 Agent 请求用户批准。
9. 主 Agent 与 审计对话 在会话首页固定置顶，但视觉上仍保持普通会话样式，只用顺序和轻量置顶标识区分。
10. 图中未出现但必须保留的页面，例如 AI 账号 / 技能 / 运维与修复 / 审计对话，也要落到同一套微信式轻界面，不允许继续长成控制台风格。

3. 非目标

本次不做以下事项：

1. 不回退到 WebView 壳路线。
2. 不回退当前原生 Android 架构、登录恢复、OTA、设备绑定和主 Agent 执行链路。
3. 不删除后端已有的线程预算、转发、运维、审计、AI 账号、Skill 等能力；只调整它们在前台的入口、视觉和层级。
4. 不在本次设计里细化主 Agent 的最终执行策略，只先定义群聊的发起、监督和审批框架。
5. 不恢复假的 9:41 / 5G / 电量 状态栏；状态栏由真机系统自己显示。

4. 视觉基准

4.1 主视觉来源

唯一主视觉来源：

• design/exports/ui-codex-ops-mobile-v13/

核心对照图：

• 会话首页：g8Qpr.png
• 聊天页：grcep.png
• 设备页：5iGU7.png
• 我的页：LQOJ0.png
• 登录页：i7IZ1.png
• 总览图：d5gpt.png

4.2 视觉原则

1. 以白底、浅灰面、圆角列表卡片、轻绿色主按钮为主。
2. 页面主体必须是内容本身，不允许再堆重统计卡片、监控面板或控制台摘要。
3. 顶部栏、列表、聊天输入区、轻按钮和 tab 结构必须尽量贴近旧版导出图。
4. 不恢复假的系统状态栏，也不恢复桌面预览卡片壳。
5. 图里存在的布局、间距、对齐、轻重层级，应优先向导出图靠拢，而不是向当前实现妥协。

5. 页面信息架构

5.1 一级导航

一级导航固定为：

1. 会话
2. 设备
3. 我的

底部 tab 常驻，不滚动隐藏，不做额外复杂入口。

5.2 主 UI 保留页面

主 UI 需要保留并统一到旧版视觉语言的页面包括：

• 登录
• 注册
• 忘记密码
• 会话首页
• 单线程聊天页
• 群聊页
• 项目目标
• 版本迭代记录
• 消息转发
• 设备首页
• 添加设备
• 我的首页
• 账号与安全
• 设置
• 关于
• 运维与修复
• 审计对话
• AI 账号
• 技能

5.3 主 UI 撤出的内容

以下内容不删除后端能力，但不再以控制台方式露出：

• 线程预算大面板
• handoff / 风险摘要大块说明
• 配额和监控式状态卡
• 审计、运维、转发、线程详情的大块控制台入口

它们若仍需存在，只能以轻量页面、列表项、二级入口或会话方式出现。

6. 会话模型

6.1 单线程会话

定义：

• 一个聊天窗口对应一个线程。
• 一个线程隶属于某个设备上的某个 Codex 文件夹。
• 同一文件夹下多个线程，在 APP 中显示为多个独立聊天窗口。

列表字段：

• 主标题：线程名
• 副信息指定行：文件夹名
• 预览行：最后一条消息
• 右上：最后一次对话时间
• 右下：动态小图标，表示当前后台使用数量

6.2 特殊会话

特殊会话包括：

• 主 Agent
• 审计对话

规则：

1. 固定置顶在会话首页顶部。
2. 视觉上与普通会话尽量一致。
3. 只通过顺序和轻量置顶标识区分。
4. 不做特殊大卡片。

6.3 群聊会话

定义：

• 群聊是独立会话，不覆盖或替换原来的单线程会话。
• 群成员可以来自不同设备、不同文件夹、不同线程。
• 群头像按微信逻辑显示多头像组合。

命名规则：

1. 创建群聊时自动生成默认群名。
2. 创建完成后允许修改群名。

7. 会话列表设计

会话列表按旧版导出图风格统一，核心规则如下：

1. 页面第一屏就是纯会话列表。
2. 主 Agent 和 审计对话 位于最上方。
3. 普通会话按聊天工具列表排列，不再掺杂控制台说明。
4. 每个会话 item 固定包含：
   • 左侧头像
   • 主标题：线程名或群名
   • 指定副信息行：文件夹名
   • 最后一条消息预览
   • 最后一次对话时间
   • 右下动态小图标，表示后台使用数量
5. 不再在列表主行显示线程预算、设备配额、风险摘要等重字段。

7.1 文件夹名显示位置

用户指定的文件夹名显示位置是聊天列表 item 中主标题下方的副信息行，位于最后一条消息预览之上或其同一信息层级位置，必须与用户给出的截图位置一致。

7.2 后台数量图标

规则如下：

1. 只显示动态小图标，不显示数字文本，不显示说明文本。
2. 图标位置在当前最后一次对话时间下方的右下区域。
3. 图标表达的是当前线程后台使用数量。
4. 不在列表里展示“后台窗口名”或“后台窗口描述”。

8. 聊天页设计

8.1 单线程聊天页

单线程聊天页按微信式聊天页构成：

1. 顶部栏：
   • 左返回
   • 中间标题：线程名
   • 右上角入口
2. 顶部轻入口：
   • 项目目标
   • 版本迭代记录
3. 中部主体：
   • 纯消息流
4. 底部输入区：
   • 文本输入为主
   • 图片 / 视频 / 转发作为轻入口

不允许在主聊天页继续出现：

• 运维大面板
• 线程预算块
• handoff 摘要块
• 控制台式状态卡

8.2 群聊页

群聊页整体结构与单线程聊天页保持一致，但：

1. 标题显示群名。
2. 头像显示群头像组合。
3. 右上角进入群资料页。
4. 群成员消息需区分来源线程。
5. 主 Agent 在群里承担发起和监督角色。

9. 改名逻辑

改名行为必须遵循微信最新逻辑，而不是长按改名、左滑改名等旧交互。

9.1 线程改名

流程：

1. 进入单线程聊天页。
2. 点击右上角进入会话信息页。
3. 在会话信息页中修改线程名。
4. 保存后同步更新：
   • APP 本地显示
   • 服务端状态账本
   • 对应 Codex 线程名称

9.2 群聊改名

流程：

1. 进入群聊页。
2. 点击右上角进入群聊信息页。
3. 在群聊信息页中修改群名。
4. 保存后更新群聊会话显示。

10. 群聊创建与沟通规则

10.1 发起方式

群聊创建从聊天页右上角 + 发起：

1. 从单线程聊天页点击右上角 +
2. 选择 发起群聊
3. 进入线程选择页
4. 选择任意设备里的任意线程
5. 自动创建一个新的独立群聊
6. 自动生成默认群名
7. 创建成功后进入新群聊页

10.2 群聊会话与原会话关系

规则：

1. 新建群聊后，原来的单线程会话保留。
2. 新群聊作为独立聊天窗口出现在会话列表。
3. 群聊不会覆盖原线程会话。

10.3 群聊治理规则

群聊中的线程协作遵循以下规则：

1. 开发任务过程中：
   • 允许不同线程直接在群聊内对话和协作。
2. 非开发任务状态下：
   • 线程之间不能直接自由对话。
   • 如需对话，必须先请求主 Agent。
   • 主 Agent 再向用户请求是否批准两个线程继续沟通。
   • 用户批准后，线程之间才可继续对话。

10.4 主 Agent 角色

主 Agent 在群聊中的角色是：

1. 群聊发起者
2. 群聊监督者
3. 线程间对话的规则执行者

本次先落会话结构、入口和规则，不在本次设计内细化主 Agent 的最终执行策略。

11. 深层页补齐策略

导出图未直接覆盖的页面，也必须统一到这套 UI 语言：

• AI 账号
• 技能
• 设置
• 账号与安全
• 运维与修复
• 审计对话
• 线程信息 / 会话信息 / 群聊信息
• 群聊成员选择页

补齐原则：

1. 统一白底、浅卡片、轻按钮风格。
2. 统一列表式、表单式和信息页结构。
3. 不再使用控制台式高密度状态块。
4. 即使信息复杂，也优先拆成列表项或二级页，而不是堆在一个页面里。

12. 返回逻辑与导航逻辑

12.1 一级导航

底部 tab 固定显示：

• 会话
• 设备
• 我的

12.2 返回规则

规则如下：

1. 从二级页返回，回到上一页。
2. 从聊天页返回，回到会话列表。
3. 从设备详情返回，回到设备列表。
4. 从我的二级页返回，回到我的首页。
5. 在根级 tab 页按返回时，先回 会话 tab。
6. 已在 会话 根页时，再按一次返回进入后台。

13. 数据与同步要求

13.1 线程与会话映射

必须建立清晰映射：

• 设备
• 文件夹
• 线程
• 会话窗口

要求：

1. 一个线程映射一个单线程会话。
2. 一个文件夹下多个线程映射多个独立会话。
3. 会话列表必须能拿到线程名、文件夹名、最后消息、最后时间、后台使用数量。

13.2 改名同步

线程改名必须同时影响：

1. APP 会话标题
2. 服务端状态
3. 对应 Codex 线程名称

13.3 群聊同步

群聊需要持久化：

1. 群聊 ID
2. 群名
3. 群成员线程列表
4. 群创建者
5. 群内规则状态
6. 是否为开发任务状态

14. 验收标准

本次工作完成后，必须满足以下验收条件：

1. 图中已有页面可与导出图逐页对照，达到 1:1 视觉还原级别。
2. 图中未出现但必须保留的页面，也统一成同一套微信式轻界面。
3. 会话列表主标题显示线程名，指定副信息位显示文件夹名。
4. 每个会话右下角都显示动态后台数量图标。
5. 主 Agent 和 审计对话 置顶，但视觉仍为普通会话。
6. 聊天页右上角遵循微信最新逻辑，支持进入信息页改名。
7. 线程改名后，Codex 对应线程也同步改名。
8. 支持从聊天页右上角 + 发起群聊。
9. 群聊为独立会话，保留原单线程会话。
10. 群聊支持自动命名、后续改名、群头像组合显示。
11. 开发任务状态与非开发任务状态下的线程沟通规则已落地。
12. 主聊天面、设备面、我的页不再出现控制台式大面板。

15. 风险与约束

1. 导出图是主视觉基准，但不是全部页面的完整交互稿，因此深层页需要在同一套风格内补齐，而不是照当前实现继续延展。
2. 线程名同步到 Codex 线程需要可靠的线程标识和回写能力，否则会产生 APP 名称与 Codex 名称不一致的问题。
3. 群聊引入后，单线程会话、群聊会话和主 Agent / 审计对话会并存，需要明确排序、置顶和未读规则。
4. 主 Agent 对线程间对话的审批与监督规则本次先定义边界，不在本次设计中进一步算法化。