界面原型与预览
原型设计稿是交付物,覆盖桌面端八屏与手机端四屏。风格与产品气质一致:品牌橙 #e16531(取自 logo)主色、暖中性底色、亮暗双主题。源文件(HTML+共享设计系统 prototypes.css)在仓库 docs/design/prototypes/,截图在 docs/src/public/screenshots/。
每屏均可加 ?theme=dark 参数查看深色版;首页轮播的右上角按钮可切换截图主题。
桌面端
| 屏幕 | 说明 |
|---|---|
| 未登录直连态 | 零配置:UDP 广播自动发现同网段终端;会话标注「仅存本机 · 不入归档」;无对话=列表态长方形面板(不摆聊天面板),点好友展开对话 |
| 好友列表 | 协作态下的纯好友列表(布局令列表态):组织架构通讯录分组、搜索好友/工号、在线数统计;点好友展开对话,再点当前好友或 ✕ 关回列表态 |
| 登录协作态 | 长连接在线、全量归档;服务端不可达时状态徽标显式回落提示 |
| 单聊 | 归档起点「归档自 X 时刻」、跨态会话「未归档」不可关闭、撤回仅显示层(原文留存) |
| 群聊 | 公告、@提醒、成员管理;群消息同样全量归档 |
| 组织架构 | 部门树、成员卡片、汇报链路、直属上级、可见性策略提示 |
| 文件传输 | 点对点直传不经服务端、断点续传、元数据入归档 |
| 归档检索 | 管理台:人员+时间+关键词检索、撤回原文留存标记、查阅日志、导出留证 |
未登录直连态
实况截图:双实例同机互发现(UDP 2425;2026-10-10 原型走查 rail 面落地后 重摄,浅/深配平)。布局令(2026-10-08):无对话= 「左菜单+好友列表」长方形列表态,不摆聊天面板——启动/关会话即此态; 点好友后右侧展开对话(点好友或点标题栏 ✕ 回列表态),展开态实况见下方 第三、四张(真实客户端窗口,test_mode_switch 布局腿程序化抓取,深色随 2026-10-09 补摄)。




好友列表
实况截图(协作态列表态,2026-10-09 补摄、2026-10-10 浅色重摄+深色补齐, 同日 rail 面走查后随批重摄):登录协作态、未开会话=「左图标栏+消息列表」 长方形列表态(不摆聊天面板)——局域网设备分组(在线数统计)+「最近联系」 分组(未读/在线标识、星标置顶随常用联系人)+「群聊 · 服务端归档」分组; 搜索栏按昵称/账号/IP/群名过滤;点好友展开对话、再点当前好友或 ✕ 关回 列表态(真实客户端窗口,test_mode_switch 布局腿程序化抓取)。如实更正: 2026-10-09 首轮入库的「浅色」实为深色抓图——测试切暗腿的还原缺陷(system 档判暗兜底回读已被染暗的调色板,还原又落回深色),浅图带暗入库;本轮修 抓取机制(还原改显式回亮色)后浅色重摄、深色一并补齐。


原型稿:浅色与深色各一(协作态好友列表设计稿,保留备查)。


登录协作态
实况截图:协作单聊互发文本——「最近联系」分组带在线标识与末条时间,行首 标注「协作 · 已归档」,送达回执「已送达对方 ✓」入状态栏(2026-10-10 rail 面走查后重摄,浅/深配平)。


单聊
实况截图:直连单聊互发文本——外出气泡品牌橙靠右、来访气泡靠左,行首标注「直连·仅本机」,顶部常驻「消息不进归档」横幅(2026-10-10 rail 面走查后重摄,浅/深配平)。


群聊
实况截图:服务端群会话(bob 授 group_creator 特权后建群拉 alice)——群 消息经服务端扇出并全量归档,侧栏「群聊 · 服务端归档」分组带群人数与归档 标识(2026-10-10 rail 面走查后重摄,浅/深配平)。


组织架构
实况截图:组织架构对话框独抓(部门/成员树),画面不含窗口 chrome,不随 2026-10-10 rail 面改版,核对后沿用。


文件传输
实况截图:直连文件通道真实收发——主窗发整目录(「[文件夹] 开始发送/发送 完成」系统行)+对端发文件(「[文件] 已接收」系统行含落盘路径),跨态直连 会话按归档自行口径标注(2026-10-10 rail 面走查后重摄,浅/深配平)。


归档检索
实况截图:服务端 CLI 终端输出(检索命中的归档表),无窗口 chrome,不随 2026-10-10 rail 面改版,核对后沿用。


功能对话框(八屏预览集外)
以下功能界面为对话框级,不在桌面八屏预览集内(需入轮播预览集另立走查单, 当前仍不占十二席之一)。两者实况由各自对话框冒烟腿程序化抓取(真服务端 进程+真实数据面,浅/深各一配平,2026-10-11 补摄):
任务清单对话框(R27-1):自建/完成/提醒+他人分配(同群/同部门互派); 2026-10-10 补日历视图(月历标到期日+点日筛选该日到期,默认收起) 与关窗后台驻留(关窗=hide 不销毁,30s 轮询与提醒常驻通知中心)。
实况截图:清单台账六项(自建/提醒行、
[x]完成态、🌐 直通链接与模板键 外部条目)+日历视图展开态(到期日品牌橙标注、点日筛选该日到期)+外部 任务登记与拉取面(test_task_dialog冒烟腿程序化抓取)。

群工具对话框:群任务建/认领/完成;2026-10-10 补截止提醒 (due_ms,30s 轮询到点经通知中心 IMPORTANT 强提醒)。
实况截图:投票页台账三票(进行中·匿名多选、到点自动关票、改票覆盖的记名 台账)+发起区(主题/选项、截止/匿名/多选勾选、投改票、截止投票); 接龙与群任务两页同窗内标签切换(
test_group_tools_dialog冒烟腿程序化 抓取)。

手机端
| 屏幕 | 说明 |
|---|---|
| 初始化向导 | 第一步即域名/服务器地址(必填+连通性校验),未完成不能进入主界面(R17) |
| 会话列表 | 移动端全部为协作态,不出现任何免登录入口(R18) |
| 聊天 | 已读回执、文件卡片、归档状态随手可见 |
| 我 | 设备管理、桌面端单点在线说明、留存策略展示 |
初始化向导
实况截图(Android,T6.3):首次启动强制进入服务器地址设置页,填写域名/IP(可带端口,缺省 24360)并连通校验(PING→PONG)通过后才放行登录——未完成初始化不出现任何可聊天界面(R17)。深色补摄(2026-10-10 深色主题走查,walkthrough-18 同源)。


原型稿:浅色与深色各一。


会话列表
实况截图(Android,T6.3):登录成功后的主界面——协作态唯一入口,无任何免登录形态(R18)。深色补摄(2026-10-10 深色主题走查,walkthrough-19 同源)。


会话列表屏实况(Android,2026-10-09 走查补摄):会话列表带未读角标、发起会话 输入框(对端账号)、文件助手/退出登录入口;真实服务端下发(webhook 通知镜像) 落会话并计未读——浅色(上)/深色(下)各一(walkthrough-08/11 同源)。


原型稿:浅色与深色各一(保留备查)。


聊天
聊天页实况(Android,2026-10-09 第二轮补摄):真实人对人互发——zhangsan 离线 发给 lisi、lisi 登录收离线后在线回复,双向气泡(对端行+「我」行,各带时间) 全链实录:离线投递→登录送达(未读角标)→在线回复(服务端受理并归档,SQLite messages 表核实);浅色(上)/深色(下)各一(walkthrough-14/16 同源)。 发送路径(BUG-006 修复后)实测不崩、受理即渲染。富交互实录:长按消息即出系统 选择工具栏+「已复制」toast(walkthrough-15 入档)。如实注明:回复/表情/ 滚动加载等入口 Android 端尚未实现(T6.3 范围外),无图可摄;另图中对端消息的 服务端归档恰触发新登记的 BUG-007(msg_id 撞车静默吞档,投递不受影响),见 BUGS.md。


原型稿:浅色与深色各一(保留备查)。


我
Android 实况(2026-10-11 走查,walkthrough-20/21 同源):账号卡组织资料 (ORG_QUERY 拉真实姓名/部门/职务)、本机设备指纹、本地缓存清理、通知入口、 关于、切换服务器/退出登录;服务端设备台账/登录记录/留存策略查询面协议未开, 屏内如实标「未接入」,不留假数据。浅色(上)/深色(下)各一。


原型稿:浅色与深色各一(保留备查)。


原型源文件
原型为纯 HTML+CSS(无框架依赖),浏览器直接打开即可交互查看:
- 桌面端:desktop-direct(列表态:无对话不摆聊天面板)· desktop-direct-chat(点好友后对话展开)· desktop-friends(协作态好友列表·列表态)· desktop-collab · desktop-chat · desktop-group · desktop-org · desktop-files · desktop-search
- 手机端:mobile-init · mobile-sessions · mobile-chat · mobile-me
功能实现后,本页截图将逐步替换为客户端实况截图。当前进度(2026-10-10 预览核验轮更新):BUG-007 实施批(42c4b46,服务端撞 id 消歧+移动端 seq 台账)无界面变化;全部既有实况不做重摄、改为像素级 核验为当前——test_live_shots+test_mode_switch 重跑再生的 14 张桌面实况对入库版逐张比对,差异 均为消息时钟与临时路径文字(0.00%–0.39%,UI 结构零差异),锁屏验收图本轮重跑字节级一致,紧急弹窗 验收图与 test_notify 再生抓图像素级一致,docs 全站截图引用 38 处零缺失;剩余原型稿均如实标注 (「我」屏未建、备查稿保留)。此前口径(2026-10-10 复核轮更新):2026-10-10 原型走查 rail 面落地 rail 面落地(左图标导航栏,b92de8a)后,桌面端五屏实况重摄浅/深配平——直连列表态/单聊/登录协作态/ 群聊/文件传输(test_live_shots 程序化驱动真实服务端+双直连实例+对端协作引擎抓取,逐张目检);组织 架构(对话框独抓)与归档检索(服务端 CLI 终端输出)画面不含窗口 chrome、不随 rail 改版,核对后沿用; 好友列表屏分组描述随 rail 批改名同步更正(「协作会话 · 服务端归档」→「最近联系」+「群聊 · 服务端归 档」)。2026-10-10 功能落地复核轮:rail 后落地的六项提交逐项核对——聊天日界线 (3f95bdd,聊天历史按日插「── yyyy-MM-dd ──」分日系统行)为桌面聊天渲染,重摄轮 (0ca8d81)摄于该提交之后、实况已含日界线,手机端未触及(仅改 main_window.cpp); 任务提醒常驻(d870898,任务对话框关窗 hide 后台驻留、30s 轮询与提醒常驻通知中心)、 任务日历视图(1141677,月历标到期日+点日筛选)、群任务截止提醒(41f31ce,due_ms +30s 轮询到点 IMPORTANT)三者均为对话框级新界面,不在八屏预览集内、不影响既有 实况,已如实补注(见上「功能对话框(八屏预览集外)」节);BUG-005 收口(fbfe6ef, 测试假设修正)与 BUG-007 设计(37b89a0,设计文档)无界面变化。全部既有 live-/ layout-/mobile-live-* 实况核对沿用不重摄。此前的进度口径:桌面端八屏已全部替换为实况截图(浅/深各一,真实客户端在 Xvfb 下拍摄,逐张目检非原型稿);未登录直连态已随布局令(2026-10-08)重摄为「列表态」实况(浅/深各一,Xvfb 双实例互发现拍摄),「会话展开态」实况浅/深各一补齐(点好友后,test_mode_switch 布局腿程序化抓取,深色本轮切暗补摄);好友列表屏实况浅/深各一(协作态列表态,登录后经生产 ✕ 路径关回列表态抓取——局域网设备+「协作会话·服务端归档」两分组,test_mode_switch 布局腿程序化抓取;浅色 2026-10-10 重摄更正——2026-10-09 首轮入库误为深色抓图,抓取机制还原缺陷已修,深色同轮补齐);手机端初始化向导与登录成功主界面为 Android 实况(T6.3 模拟器走查,与 apps/android/docs/walkthrough-0*.png 同源;深色随 2026-10-10 深色主题走查补齐,walkthrough-18/19 同源);会话列表屏与聊天屏本轮补 Android 实况浅/深各一(2026-10-09 模拟器 android-34+本机 serve 走查,与 walkthrough-08/09/10/11 同源)——聊天屏实况 2026-10-09 第二轮已换真实人对人互发(离线投递→登录送达→在线回复全链,BUG-006 修复后实测不崩;长按复制富交互入档,walkthrough-14/15/16 同源,详见上「聊天」小节);「我」屏 Android 未建、iOS 代码-only——暂仍为原型稿并如实标注。鸿蒙端(T6.2 桌面矩阵项,工具链/证书/真机未备受阻;鸿蒙手机版 T6.6 代码-only+CI,编译腿待 OHOS 工具链)不为其承诺实况截图。2026-10-10 首页轮播实况化轮:文档站首页(docs/src/index.md)界面预览轮播十二席中十一席由原型稿渲染换为客户端实况截图(桌面八屏+手机初始化向导/会话列表/聊天;「我」屏 Android 端未建仍原型稿),轮播组件(ShowcaseCarousel.vue)改定高等比 contain 适配实况件离散宽高比(0.45–1.67),四张无后缀浅色实况件统一命名补 -light(layout-friends/mobile-live-init/mobile-live-sessions/mobile-live-chat,抓取腿与本文档引用同步);原型渲染件保留在库备查。2026-10-11 对话框实况轮: 「功能对话框(八屏预览集外)」两节补齐实况——任务清单对话框与群工具对话框 各浅深一(live-task-dialog[-dark]/live-group-tools[-dark],由 test_task_dialog/test_group_tools_dialog 冒烟腿程序化抓取:真服务端+ 真实数据面,任务台账六项含日历展开态与外部任务拉取面、投票台账三票含匿名 多选与到点自动关票;抓取腿照 test_live_shots grab_pair 式,亮暗各一、抓完 显式回亮)。八屏预览集与轮播十二席口径不变(十一席实况+「我」屏原型稿), 鸿蒙端承诺外维持前令。2026-10-11「我」屏实况轮:Android「我」屏落地( 5e213ba,MeActivity——账号卡接 ORG_QUERY/ORG_DATA 组织资料;设备管理/登录 记录/留存策略协议无查询面,屏内如实标「未接入」),android-34 模拟器+本机 serve 走查实况浅/深各一(walkthrough-20/21 同源,入 apps/android/docs/), 首页轮播 mobile-me 席由原型稿渲染换实况(mobile-live-me[-light|-dark])。 八屏预览集不变,轮播十二席全实况收口;鸿蒙端承诺外维持前令。