docs(design): console IA implementation table (IA-1)
Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
1 parent
f38758bd26
commit
11c8cd4e0e
1 file changed
+52
@@ -217,3 +217,55 @@
|
||||
| API Key | 设置 Tab 与账户菜单同名两物 | 设置里只放签发给外部程序的 Key;浏览器 token 归账户与安全 |
|
||||
| 命名 | Pi 上游、下载与任务、来源/Feed/快照、工作流引擎 | Agent 上游、下载队列/业务任务、来源健康、引擎面板 |
|
||||
| 存储 | 8 个 settings key | 不变;新增 `SETTINGS_SECTIONS` 展示映射 |
|
||||
|
||||
## 6. 已实施对照表(IA-1:导航 / 路由 / 页面合并)
|
||||
|
||||
> 2026-09-28。设置页分区(§3.4、§3.5)由 IA-2 实施,不在本表。
|
||||
|
||||
### 6.1 侧栏(`components/console/nav.ts`)
|
||||
|
||||
| 组 | 项 → 路由 | 与方案的差异 |
|
||||
| --- | --- | --- |
|
||||
| 概览 | 首页 `/console`、待处理 `/console/inbox`(角标 = 未决数) | — |
|
||||
| 资源 | 站点工作台 `/console/sites`、来源健康 `/console/sources` | — |
|
||||
| 订阅 | 订阅 `/console/subscriptions`、收录策略 `/console/rules`、偏好标签 `/console/preferences` | 页名按术语表用"收录策略"(术语表不用"收录规则"),路由仍是 `/rules` |
|
||||
| 下载 | 下载队列 `/console/downloads`、下载计划 `/console/downloads/plans`、业务任务 `/console/tasks` | — |
|
||||
| 整理 | 媒体库、整理记录、文件管理 `/console/files`、身份与元数据 | 身份页页签沿用术语表的"待识别",没有改成"未识别" |
|
||||
| Agent | Agent 会话 `/console/agent` | 侧栏顶部的 Agent 唤出按钮与右下角悬浮按钮保留 |
|
||||
| 系统 | 设置、定时任务(W7-C)、引擎面板、审计日志 | 多出"定时任务"一项,共 19 项 |
|
||||
|
||||
- 当前项按 `findNavItem`(最长前缀)只高亮一项:`/downloads/plans` 不再同时点亮"下载队列"。
|
||||
- 折叠侧栏按组加细线分隔;手机抽屉复用同一份 `NAV_GROUPS`。
|
||||
- `settingsPath(section, anchor)`:页面跳设置一律用新分区名,IA-2 上线 `/settings/:section` 时只改这个函数。
|
||||
|
||||
### 6.2 路由与重定向(`routes/console/redirects.ts`)
|
||||
|
||||
| 旧 | 新 | 实现 |
|
||||
| --- | --- | --- |
|
||||
| `/console/tasks?tab=downloads` | `/console/downloads`(保留其余 query) | `tasks.tsx` clientLoader |
|
||||
| `/console/tasks?tab=plans` | `/console/downloads/plans` | 同上 |
|
||||
| `/console/tasks?tab=tasks` | `/console/tasks` | 同上 |
|
||||
| `/console/tasks/:id`(下载任务 ID) | `/console/downloads/:id` | `tasks.$id.tsx`:业务任务 404 时查下载任务,查到就跳转 |
|
||||
| `/console/subscriptions?tab=policies` | `/console/rules` | `subscriptions.tsx` clientLoader |
|
||||
| `/console/sources?tab=snapshots&siteId=x` | `/console/sites/x?tab=snapshots` | `sources.tsx` clientLoader;无 siteId 留在来源健康 |
|
||||
| `/console/settings?tab=*` | — | IA-2 |
|
||||
|
||||
`nav.test.ts` 断言每个导航项、每个重定向目标都在 `routes.ts` 里;冒烟(`scripts/smoke.mjs` 的 `REDIRECT_ROUTES`)逐条打开旧地址,确认落到新地址且 200。
|
||||
|
||||
### 6.3 页面合并 / 拆分
|
||||
|
||||
| 方案 | 落地 |
|
||||
| --- | --- |
|
||||
| 站点三处合一(C1) | 站点工作台页头"登记站点"(可选内置站点定义);站点详情 4 个页签:整理视图 / 原站视图 / 快照与 Feed / 账号(账号列表 + 凭证表单);来源健康只留站点健康总表与全部 Feed,站点名深链到详情"快照与 Feed" |
|
||||
| 下载 / 计划 / 业务任务分开(C2) | 原"下载与任务"三页签拆成三页;业务任务行点开抽屉,详情页 `/tasks/:id` 列概况、关联对象(对象、上级任务、引擎运行)、文件操作;下载详情时间线里的任务事件改链到业务任务详情 |
|
||||
| 缓存集中到下载队列(C3) | 下载队列页头"缓存水位":各卷水位条、在途/预留/可清理、"调整阈值"(跳设置)与"立即清理"(排队后跳到对应业务任务);首页"缓存水位""当前工作"两块链到下载队列 |
|
||||
| 收录策略与偏好互链(C6) | 两页页头互放链接;订阅页不再有页签 |
|
||||
| 身份判定只在待处理(C7) | 身份页"待识别"只读:详情抽屉只剩"重新识别",多候选 / 待确认的行标"已进待处理 →";页头"待确认身份"跳 `/inbox?kind=identity_ambiguous`;外部身份的锁定和别名维护保留 |
|
||||
| 列表页规范 | 下载队列、下载计划、业务任务、来源健康的筛选写进 URL query(`use-query-state.ts`),行点击开 DetailSheet |
|
||||
|
||||
### 6.4 遗留
|
||||
|
||||
- "没有匹配 / 查询失败"的待识别资源不生成待处理事项,身份页改为只读后没有手动指定入口;需要服务端为这两类也开待处理事项,或在作品详情补"指定资源"。
|
||||
- `components/agent/agent-conversation.tsx` 仍链到 `/console/tasks/:下载任务ID`(W7-B 范围),靠 `tasks.$id.tsx` 的兜底跳转可用,改成 `/console/downloads/:id` 可省一次 404 探测。
|
||||
- `components/agent/quick-goals.ts` 里的"待识别池"文案(W7-B 范围)。
|
||||
- 原站视图仍是占位。
|
||||
Reference in new issue
Block a user