docs: 交接文档同步跳转修复、子分类与归类管理
This commit is contained in:
+10
-7
@@ -7,13 +7,13 @@
|
||||
Stash 已从「只读本地导航站」升级为**可登录、可配置、可编辑内容的本地发布台**：
|
||||
|
||||
- 登录（单用户，argon2id + Cookie 会话）；
|
||||
- `/admin` 设置页（页头滚动信息 / 首页卡片 / 侧栏 / 资料 / 系统）；
|
||||
- `/admin` 设置页（页头滚动信息 / 首页卡片 / 归类 / 侧栏 / 资料 / 系统）；
|
||||
- 条目就地编辑（Drawer + 乐观锁）；
|
||||
- 分区新增/删除、浏览/点赞/分享/跳转；
|
||||
- 分区新增/删除/归类编辑、侧栏子分类配置、浏览/点赞/分享/跳转；
|
||||
- 数据库自动迁移到 **v17**；
|
||||
- 前端 100% 使用组件库 `@stash/ui`（v0.3.1，42 个组件）。
|
||||
|
||||
当前数据库里**没有管理员密码**，打开 8080 点「登录」是**首次设置密码**流程。
|
||||
当前数据库**已设置管理员密码**（2026-10-30 由使用者设置）；忘记密码按 §6 删除 `admin` 行即可回到首次设置。
|
||||
|
||||
## 1. 仓库与运行环境
|
||||
|
||||
@@ -99,7 +99,8 @@ README.md 运行、路由、库结构、登录说明
|
||||
| --- | --- |
|
||||
| 页头滚动信息 | 启用开关、速度 8–120、条目增删/排序、标签与色调、占位符 `{count}` `{project}` `{status}` |
|
||||
| 首页卡片 | 显示/隐藏、标题覆盖、预览条数、顺序、**新增分类**、**删除分类**（不可删的显示灰色按钮） |
|
||||
| 侧栏导航 | 显示/隐藏、顺序、删除分类、新增分类 |
|
||||
| 归类 | 每个分区的类型（应用/海报/图文）、标题、图标、色条、预览条数；改类型会自动迁移条目归属 |
|
||||
| 侧栏导航 | 分类显示/隐藏、顺序、删除/新增；应用类分区下的**子分类（分组）可单独显隐与排序** |
|
||||
| 资料 | 头像 URL、名称、角色、简介、位置（应用到侧栏资料卡） |
|
||||
| 系统 | 修改密码（清空所有会话）、下载备份（VACUUM INTO 快照） |
|
||||
|
||||
@@ -115,7 +116,7 @@ README.md 运行、路由、库结构、登录说明
|
||||
- 浏览：进入页面 `POST /api/items/{key}/view`，数字 +1；
|
||||
- 点赞：可切换，`POST /like`，localStorage 记住状态；
|
||||
- 分享：复制当前链接，Toast 反馈；
|
||||
- 跳转：`href` 为 `#` 时置灰。
|
||||
- 跳转：保存时规范化 `href`（`www.` 自动补 `https://`，拒绝 `javascript:` 等协议）；为空或 `#` 时按钮置灰。
|
||||
|
||||
## 4. HTTP API
|
||||
|
||||
@@ -139,6 +140,7 @@ POST /api/items/{key}/view
|
||||
POST /api/items/{key}/like {liked}
|
||||
|
||||
POST /api/categories {id,title,kind} 需登录
|
||||
PATCH /api/categories/{id} {title,icon,barColor,kind,previewLimit,emptyText} 需登录
|
||||
DELETE /api/categories/{id} 需登录，级联，local 不可删
|
||||
|
||||
GET /api/backup SQLite 快照附件 需登录
|
||||
@@ -187,7 +189,8 @@ GET /api/backup SQLite 快照附件 需登录
|
||||
| 图片上传 | 只支持 URL；上传需存储目录、大小/类型校验 |
|
||||
| 拖拽排序 | 用上移/下移按钮替代 |
|
||||
| 多用户/角色 | 未做，当前单管理员 |
|
||||
| 分区编辑 UI | 可新建/删除，但改标题/图标仍要改库（可后续补 `PATCH /api/categories/:id`） |
|
||||
| 分区编辑 UI | 已支持标题/图标/色条/类型/预览条数（`PATCH /api/categories/{id}`）；改类型会自动迁移条目 |
|
||||
| 子分类（分组）管理 | 侧栏可显隐/排序；还不能新建、改名、删除分组 |
|
||||
| 登录限流 | 进程内计数，重启清空 |
|
||||
|
||||
## 10. 约定与坑
|
||||
@@ -203,5 +206,5 @@ GET /api/backup SQLite 快照附件 需登录
|
||||
## 11. 新会话建议的下一步
|
||||
|
||||
1. 先跑 `cargo test` + 打开 8080 冒烟，确认基线；
|
||||
2. 若要继续产品化：分区编辑（标题/图标/色条）、回收站、图片上传、拖拽排序；
|
||||
2. 若要继续产品化：分组（子分类）的新建/改名/删除、回收站、图片上传、拖拽排序；
|
||||
3. 若要发布：确认 `stash-ui` 以 `file:` 引入的方式在发布构建里如何锁定版本（建议改为 git tag 依赖或构建前 `npm pack`）。
|
||||
|
||||
@@ -147,6 +147,13 @@ DELETE /api/items/:id
|
||||
|
||||
## 11. 实施记录
|
||||
|
||||
### P5（2026-10-30）
|
||||
|
||||
- **跳转修复**：保存条目时规范化 `href`（`www.zhihu.com` → `https://www.zhihu.com`，站内路径保留，`javascript:` / `data:` 等协议拒绝），前端渲染再做一次兜底；
|
||||
- **侧栏子分类**：`settings.sidebar` 增加 `hidden_groups` / `shown_groups` / `group_order`，侧栏 Tab 展示分组并支持单独显隐、上下移；
|
||||
- **归类页**：新增 `PATCH /api/categories/{id}`，`/admin` 的「归类」Tab 可改分区类型（应用/海报/图文）、标题、图标、色条、预览条数；切换类型时自动迁移条目与首页卡片指向；
|
||||
- 测试：54 passed（新增 href 规范化 3 例、分类更新 3 例）。
|
||||
|
||||
### P4（2026-10-29，收尾）
|
||||
|
||||
- 分区增删：`POST /api/categories`、`DELETE /api/categories/{id}`（需登录，级联内容，`local` 不可删），首页与侧栏共用；
|
||||
|
||||
Reference in New Issue
Block a user