docs: specify market toolbar redesign

2026-07-16 14:50:09 +08:00
parent 961fb33e9e
commit ca365b485a
1 changed files with 76 additions and 0 deletions
@@ -0,0 +1,76 @@
+# 传播指标筛选与批量操作重设计
+
+## 目标
+
+重设计星图达人市场页插件注入的工具栏红框区域。保留全部现有导出和批量能力，将它们按任务边界排列；将传播指标筛选改成独立的条件构建区，减少操作与筛选条件混排造成的阅读负担。
+
+本设计仅覆盖 `src/content/market/plugin-toolbar.ts` 生成的插件工具栏，不改变星图原生筛选区、后端接口、导出数据结构或批次提交协议。
+
+## 页面结构
+
+工具栏始终分为两行。
+
+### 第一行：导出与批量操作
+
+左侧展示结果计数，右侧可继续展示已有的导出状态。中间操作按以下顺序分成四组，组间使用细分隔线：
+
+1. **列表 CSV 导出**：`导出CSV` 紧邻导出范围下拉框。范围选项保持 `当前页`、`前5页`、`前10页`、`全部`、`自定义`，默认仍为 `前5页`；选择 `自定义` 后显示页数输入框。
+2. **已选达人数据导出**：`导出选中达人数据` 与 `选择字段` 相邻。字段配置自动保存，且仅影响该类达人数据导出。
+3. **星图 ID 导出**：保留 `按星图ID导出` 独立入口，打开既有的 ID 输入流程，不依赖当前列表勾选。
+4. **批次操作**：`提交批次` 是该行唯一的高强调主按钮；其余按钮维持次级强调。
+
+`导出CSV` 的范围只影响当前筛选结果的分页导出，不能影响“导出选中达人数据”或“按星图ID导出”。
+
+### 第二行：传播表现筛选
+
+第二行标题为“传播表现筛选”，标题旁展示已启用指标数。右侧提供“添加筛选指标”入口，打开既有指标目录；未启用的指标不显示空规则行。
+
+每条已启用规则包含指标名、`≥`、阈值输入、视频类型、更多选项和删除按钮。桌面端直接显示视频类型、指派范围与时间范围；窄屏端沿用“更多选项”收起次级控件的模式。
+
+当存在两条及以上规则时，显示 `AND` 关系说明：所有规则都达标才保留达人。
+
+## 默认状态
+
+首次加载时默认启用且仅启用一条规则：
+
+| 项目 | 默认值 |
+| --- | --- |
+| 指标 | 完播率 (`finishRate`) |
+| 阈值 | 留空，用户必须填写 |
+| 视频类型 | 星图视频 (`type: 2`) |
+| 指派范围 | 只看指派 (`onlyAssign: true`) |
+| 时间范围 | 近30天 (`range: 2`) |
+| 营销过滤 | 不排除营销 (`flowType: 0`) |
+
+互动率 (`interactionRate`) 初始时只出现在“添加筛选指标”目录中。添加后使用同一套独立规则结构与默认上下文；其阈值同样留空。
+
+启用规则但未填写阈值时，执行依赖传播指标筛选的导出或批次操作必须显示现有的阈值校验错误，不能静默移除该规则或改用未筛选结果。
+
+## 交互与状态
+
+- 点击“添加筛选指标”后，已添加指标显示“已添加”且不可重复添加。
+- 删除一条规则后，清空其阈值并恢复该指标在目录中的“添加”状态。
+- 规则新增或删除后，已选计数和 `AND` 说明立即同步。
+- 每次规则重新添加时，应用本设计规定的默认上下文，但不预填阈值。
+- 工具栏忙碌时，现有导出、批次、范围、字段和筛选控件均不可操作；操作完成后恢复。
+
+## 视觉原则
+
+- 使用克制的白底、灰色边界与星图现有的粉色强调色；不增加新的侧栏或浮层任务区。
+- 第一行优先服务导出和批量执行，第二行优先服务条件配置，避免两个工作流争夺同一行空间。
+- `提交批次` 与“添加筛选指标”可使用强调色；删除是低强调的图标操作；其他按钮为中性描边按钮。
+- 通过文本标签与图标共同表达“选择字段”和“按星图ID导出”，不以图标替代功能名称。
+
+## 验收标准
+
+1. 第一行完整保留 `导出CSV`、范围选择、`导出选中达人数据`、`选择字段`、`按星图ID导出` 和 `提交批次`，且导出范围仅与 `导出CSV` 相邻。
+2. 初始页面只显示一条完播率规则，选中计数为“已选 1 项”。
+3. 初始规则上下文为星图视频、只看指派、近30天；完播率阈值为空。
+4. 未填写阈值时，现有校验能阻止将该启用规则作为有效过滤条件继续执行。
+5. 互动率不会在默认界面占位，只有通过目录添加后才显示。
+6. 删除和重新添加指标后，规则默认上下文、目录状态和已选计数均正确同步。
+7. 窄屏下操作组可换行，筛选规则的次级条件不会溢出或与其他控件重叠。
+
+## 验证范围
+
+实现时更新工具栏 DOM 测试，覆盖默认完播率规则、默认 `SpreadInfoConfig`、空阈值校验、互动率目录添加/删除、导出范围与五个既有操作入口的保留。运行聚焦的市场工具栏测试、传播指标测试和项目构建。