Skip to content

Latest commit

 

History

History
113 lines (77 loc) · 5.23 KB

File metadata and controls

113 lines (77 loc) · 5.23 KB

XManager 设计规范

本文是桌面端视觉与交互的单一来源。实现落在 crates/xmanager-tauri/src/theme.css(色板、字号、间距的 CSS 变量,移植自原 GPUI theme.rs 调色板)与 React 组件(crates/xmanager-tauri/src/components/)。

原则

  1. 一条主路径:发现 → 筛选 → 查看 → 内容库「删除选中」→ 确认一次(自动备份)→ 删除。
  2. 安全清理是可选复核盘:不必先「加入安全清理」才能删;需要再看一遍时再放进托盘。
  3. 状态用文字,不只靠颜色:危险操作同时用文案、步骤和确认。
  4. 即时反馈:筛选改完立刻更新列表;拉取参数单独标明「下次拉取才生效」。
  5. 确认一次即可:真删只弹一次应用内确认;挑选和删除后都留在内容库。

字体

角色 字号 行高 字重 字距意图 用途
Caption 12 18 Regular +0.2px 略松 辅助说明、chip、状态栏、快捷键
Body 13 20 Regular 0 正文、按钮、列表行
Label 13 20 Medium 0 区块标题、导航、强调按钮
Title 16 24 Semibold −0.2px 略紧 页标题
Display 20 28 Bold −0.2px 侧栏产品名

行高约为字号的 1.45–1.50,保证中西文混排不挤。

字体族:

平台 UI 等宽(推文 ID / 确认输入)
macOS .AppleSystemUIFont Menlo
Windows Segoe UI Consolas
Linux Noto Sans CJK SC DejaVu Sans Mono

不要在界面里混用第三套字号。新控件从 theme::type_caption / type_body / type_label / type_title 里选。

间距与控件

4px 节奏:

Token px 用途
space::XS 4 紧凑间隙、chip 内边距
space::SM 8 控件组、卡片内边距
space::MD 12 区块内边距、按钮水平 padding
space::LG 16 页边距
space::XL 24 大区块分隔
Token px
按钮高度 32
Chip 高度 28
圆角 SM / MD 4 / 6

宽屏导航约 220px。检查器默认 380px,可拖到 220–640px;仅在选中一条推文时占列,未选中时把宽度还给列表。Esc 或「关闭」收起检查器。

颜色

浅色为默认。语义色只走 theme.rs 的命名 token(TEXT / TEXT_MUTED / ACCENT / DANGER / SUCCESS / WARNING),不要在视图里写死 hex。正文与表面对比至少 4.5:1。

交互约定

筛选

  • 时间、类型、曝光、排序、Top-N、低曝光快捷:改完立即生效
  • 抽屉底部「下次拉取」:条数、是否含转发。只影响下一次「拉取并分析」。
  • 工具栏 chip 只显示改变结果的条件。默认「曝光最低 + 全部类型」不占 chip。
  • 「完成」只关抽屉;「清除筛选」恢复无限制并立刻重算。

内容库删除选中

  • 勾选优先;未勾选时,当前查看的一条也可删除(与加入安全清理相同的选中规则)。
  • 危险按钮 删除选中 在选中非空时可用。
  • 一次应用内确认:「将永久删除 N 条,不可恢复」+「确认」/「取消」。不要求逐条确认。
  • 确认后自动把 CSV 写到导出目录(开发时为仓库 exports/,打包后为用户配置目录下的 exports/;无文件选择器),再走现有 X 删除 API。
  • 删除后仍留在内容库,列表去掉已删行,并显示「删除结果:成功 N · 失败 M」。

加入安全清理

  • 可选复核:勾选优先;未勾选时,当前查看的一条也可加入。
  • 加入后不跳转,内容库顶部出现横幅:「去安全清理」或「继续挑选」。
  • 导航「安全清理」上的数字徽标同步增加。不必先加入才能删除。

安全清理

主按钮只有一个:删除 N 条(自动备份 + 预演 + 打开确认)。

确认面板只问一次:数量 + 不可恢复说明 +「确认删除」/「取消」。不再要求输入数量或 DELETE,也不再用「继续确认…」。

「另存 CSV/JSON」是可选副本。清空候选需点两次(清空 → 确认清空)。

预演和删除结果优先显示推文摘要,而不是原始 ID。

快捷键

作用
J / 下一条(并从其他页回到内容库)
K / 上一条
空格 勾选当前条
/ 打开筛选
1 2 3 内容库 / 洞察 / 清理
Esc 关确认 / 错误 / 抽屉 / 检查器

删除确认打开时,除 Esc 外不抢键。快捷键只写在底栏,不要在侧栏和检查器再重复一遍。

内容库列表

宽屏表只保留:勾选、类型、内容(两行)、日期(MM-DD)、曝光。点赞 / 收藏 / 比率只出现在检查器。点行打开检查器,再点同一行或 Esc 关闭。

顶部筛选卡右侧的「当前切片」数字点进去打开数据洞察。

数据洞察

统计和曝光直方图基于全部已同步推文,不是当前筛选结果。内容库的曝光上下限作为直方图上的「当前切片」高亮。点柱或常用切片会改筛选并回到内容库。本页不承担勾选、删除或完整推文表。