docs: 同步子分组开关与 v18 迁移

HANDOFF.md

@@ -10,7 +10,7 @@ Stash 已从「只读本地导航站」升级为**可登录、可配置、可编
 - `/admin` 设置页（页头滚动信息 / 首页卡片 / 归类 / 侧栏 / 资料 / 系统）；
 - 条目就地编辑（Drawer + 乐观锁）；
 - 分区新增/删除、**条目新增/删除（可选分区与分组）**、分组（子分类）新建/改名/删除、侧栏子分类配置、浏览/点赞/分享/跳转；
-- 数据库自动迁移到 **v17**；
+- 数据库自动迁移到 **v18**；
 - 前端 100% 使用组件库 `@stash/ui`（v0.3.1，42 个组件）。
 
 当前数据库**已设置管理员密码**（2026-10-30 由使用者设置）；忘记密码按 §6 删除 `admin` 行即可回到首次设置。
@@ -99,9 +99,9 @@ README.md                     运行、路由、库结构、登录说明
 | --- | --- |
 | 页头滚动信息 | 启用开关、速度 8–120、条目增删/排序、标签与色调、占位符 `{count}` `{project}` `{status}` |
 | 首页卡片 | 显示/隐藏、标题覆盖、预览条数、顺序、**新增分类**、**删除分类**（不可删的显示灰色按钮） |
-| 内容 | 弹窗新增应用/海报/图文条目（选分区；应用类可选分组或「直属分区」）；列表逐条编辑（含换分区/分组）与删除 |
-| 分区 | 分区类型（应用/海报/图文）、标题、图标、色条、预览条数；**应用类**可管理分组与首页卡片预览分组，海报/图文保持平铺 |
-| 侧栏导航 | 分类显示/隐藏、顺序、删除/新增；**应用类**的子分组单独显隐与排序，并可直接新建；空分组不在侧栏出现 |
+| 内容 | 弹窗新增应用/海报/图文条目（选分区；开启子分组的分区可选分组或「直属分区」）；列表逐条编辑（含换分区/分组）与删除 |
+| 分区 | 分区类型（应用/海报/图文）、标题、图标、色条、预览条数、**「子分组」开关**；开关打开时管理分组与首页卡片预览 |
+| 侧栏导航 | 分类显示/隐藏、顺序、删除/新增；开启子分组的分区可显隐/排序/新建分组；空分组不出现在侧栏 |
 | 资料 | 头像 URL、名称、角色、简介、位置（应用到侧栏资料卡） |
 | 系统 | 修改密码（清空所有会话）、下载备份（VACUUM INTO 快照） |
 
@@ -143,7 +143,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,blockNodeKey}  需登录
+PATCH  /api/categories/{id}     {title,icon,barColor,kind,previewLimit,emptyText,blockNodeKey,allowGroups}  需登录
 POST   /api/categories/{id}/groups {id,title}           需登录，仅应用分区
 DELETE /api/categories/{id}                             需登录，级联，local 不可删
 PATCH  /api/groups/{id}         {title,showInSidebar}   需登录
@@ -155,7 +155,8 @@ GET    /api/backup              SQLite 快照附件         需登录
 ## 5. 数据库与迁移
 
 - 文件：开发态在 `target/debug/data/stash.db`；可用 `--root` / 数据目录覆盖（见 `config.rs`）。
-- 当前 `PRAGMA user_version = 17`；`schema::migrate` 逐级升级：0 建全量、15→16→17、更高版本拒绝启动。
+- 当前 `PRAGMA user_version = 18`；`schema::migrate` 逐级升级：0 建全量、15→16→17→18、更高版本拒绝启动。
+- `node.allow_groups` 是「允许子分组」开关（与类型无关）；老库升级时应用类默认开启，其余默认关闭，已有分组的非应用分区自动开启。
 - 主要表：`node`、`entry`、`entry_tag`、`section_block`、`admin`、`session`、`setting`、`audit`。
 - `entry.updated_at` 用于编辑乐观锁；`setting` 表 `key='site'` 存站点 JSON。
 - **设置/内容都是 SQLite**：备份用 `/api/backup`，恢复需停机替换文件。
@@ -197,7 +198,7 @@ GET    /api/backup              SQLite 快照附件         需登录
 | 多用户/角色 | 未做，当前单管理员 |
 | 分区编辑 UI | 已支持标题/图标/色条/类型/预览条数（`PATCH /api/categories/{id}`）；改类型会自动迁移条目 |
 | 条目移动 | 编辑弹窗里可直接换分区 / 分组（`PATCH /api/items/{key}` 的 `nodeKey`） |
-| 分组管理 | 只有**应用类**分区可建组/改名/显隐/删除（删除级联组内条目）；海报/图文平铺；分组拖拽排序未做 |
+| 分组管理 | 由分区的「子分组」开关控制（与类型无关）；关闭时条目平铺、分组内容不丢；分组拖拽排序未做 |
 | 登录限流 | 进程内计数，重启清空 |
 
 ## 10. 约定与坑