nx-sk 0.20.0 → 0.23.0

package/CHANGELOG.md

@@ -2,6 +2,171 @@
 
 本文件格式参考 [Keep a Changelog](https://keepachangelog.com/)，中文正文。
 
+## 0.23.0 (2026-10-31)
+
+**应用壳换成可停靠的工作区（Notion 式目录树 + FlexLayout）；看板视图落地；条目有了块级 AI 的「提议 → 审 → 应用/拒绝」流；栏目结构在面板里可自己搭。**
+
+壳是「面板的布局由你自己摆」：栏目只从目录树进，布局跨会话恢复。
+AI **不自带大模型**——提议由调用方（agent 或外部模型）交进来，人只做评审。
+**栏目结构**（分组 + 字段）过去只有命令行能改：面板连建一个分组都要回 CLI 或换模板——
+于是「这个栏目长什么样」这件事面板说了不算。这次把四个分组操作与两个字段操作做成
+action（面板与 CLI 同一份），面板「编辑栏目」里直接可改。
+
+### Added
+
+- **Notion 式工作区壳**：
+  - 顶栏只留全局动作（品牌 / 存储 / 打码 / ＋面板 / 撤销重做 / 设置 / 刷新）；
+    **栏目 tab 从顶栏移除**——栏目只从目录树进，两处入口必然分叉。
+  - 目录树：栏目 + 分组 + 条目子节点；**拖拽重排与嵌套**（第一次拖动把「从旧导航配置
+    推断出的树」固化成显式 `settings.navTree`，之前始终只读推断、不写回）；
+    隐藏的栏目收在树底（一键恢复，数据不动）。
+  - 布局 = FlexLayout 模型：面板可拖到任意一边拆分、弹出成浮窗；布局存
+    localStorage（`nx-sk-ui.workspace`），跨会话恢复；撤销/重做按「整段拖拽 = 一步」。
+  - 深链升级为两段：`#/栏目` 开该栏目的数据库面板，`#/栏目/条目` 再定位到条目；
+    栏目 / 条目缺失时明确提示是哪一级没了。
+  - 正文块支持拖拽排序（块头把手）；数据库面板即工作区里的一块面板，可与其他面板并列。
+- **看板视图**：列 = select 字段的候选值；**拖卡 = 写操作**，等于 `entry update --set 字段=值`；
+  空值与候选外的值落「未分组」列，不静默丢，「未分组」不是落点。
+- **块级 AI（提议 → 审 → 应用/拒绝）**：
+  - CLI：`entry ai list | suggest | apply | reject`（HTTP 同名路由）。
+    `suggest` 收 `--from @proposal.json`（AI 给出的**最终正文**）与 `--prompt`（指令留痕），
+    只落一条 pending；`apply` 才写 store；`reject` 只删文件。
+  - **pending 落 `~/nx-sk/pending/`（运行态）**：不进 `store.json`、不进导出包、不进迁移副本
+    ——里面对 secret 块是明文，落进数据面就等于写进备份与导出面。删目录即清空。
+  - diff 是**字符级**的：`same / del / ins` 三段，面板上红删绿增；容器块的改动由子块表达
+    （不把父块一起报成改动）；secret 块只报「变了」，明文不经面板接口。
+  - **冲突检测**：pending 记每块应用前的 `baseHash`（服务端算），块被改过 → `CONFLICT`，
+    一个字都不写；`--force` 才覆盖。没有差异的提议返回 `noop`，不留空的待审。
+  - secret 块的差异按**明文**比对（store 里是密文、提议里是明文），否则一个没动的密钥
+    会被报成「密文块已变更」。
+- **表格 / 清单：行与列都能拖**（Notion 那种手感）：拖**表头**搬列、拖行尾的 ⠿ 搬行，
+  松手前一条**插入线**告诉你落在哪（只高亮整行说不清「会插到哪」）。排序算法单独一个
+  `reorderAt`（插入位语义，有单测）——差一的表现是「拖到第二行结果跑到第三行」。
+  整行不做 `draggable`：那会跟单元格里选文本打架，把手是唯一的拖拽入口。
+  ↑↓ / ←→ 保留但**悬停才浮出**，行内操作键统一收成 16px 小图标键（密集表里的按钮
+  不该抢内容的注意力）；entrylist 那颗「正常大小的删除按钮」也换成了小图标键。
+- **降级运行的主动提示**：store 由更新版本写入时，`bootstrap` 与 `health`（CLI 输出与 JSON）
+  会明确说明「磁盘版本 > 当前版本，写入会被拒」——不等用户改一次被 BLOCKED 才知道。
+- **栏目结构在面板里可自己搭**：分组能增删改序，字段能改名 / 换组 / 换类型 / 换位置。
+  - **分组骨架**：`section update --add-group / --rename-group / --move-group / --remove-group`。
+    改名可以**连 id 一起换**（组里字段的 `group` 引用跟着改，不会整组从表单里消失）。
+    三条规矩全是**拦下来**而不是悄悄做：id 重复报 `CONFLICT`（不覆盖同名分组）、
+    **非空分组不给删**（报 `BLOCKED` 并列出是哪几个字段）、内置「原始资料」分组不给删。
+  - **字段级改动**：`section update --set-field`（标签 / 类型 / 分组 / 提示 / 必填策略）
+    与 `--move-field`（在自己分组内上下挪）。**key 不可改**——值按 key 存在条目里，
+    改 key 等于让已有值读不出来；要换就新增字段再搬值。
+  - **面板**：「编辑栏目」弹窗里两块——「分组」（id / 名字就地改、↑↓ 换序、空组才能删）
+    与「字段字典」（每行可改标签 / 类型 / 分组 / 提示 / 必填策略，组内 ↑↓，删除）。
+    一次改动一次落盘（每次改动都要过后端校验，出错时知道是哪一步），改完立刻回读。
+    清单类字段（`entrylist` / `table`）的**类型置灰**：列是字段自己的结构，
+    就地换类型等于换一个字段——要建就在「新增字段」里连列一起建。
+  - 每次改动都把**新旧值**打进输出（`字段 phone：分组 contact → reach`），
+    不再只说「已更新栏目 job：fields」——那种输出改错了没法回溯。
+
+### Fixed
+
+- **导入会把打码的密钥块加密存盘**（与 0.19 字段路径同类缺陷）：导入包里的 `******`
+  占位会被当成真密钥加密落盘。现在值清空待重填，并在预览里计数与警告；
+  导出预览的掩码统计同步扩到块。
+- **表格/看板视图把详情列挤成一条竖缝**（S2 起的老缺陷，列多的栏目才暴露）：
+  表格列的 flex 基准用的是内容宽度（75 列 ≈ 7300px），行溢出时按基准比例收缩，
+  详情列被抽走全部溢出量。现在表格列 basis 为 0（「拿剩余空间」），
+  横向滚动交给表格与看板自己的 overflow。
+- **布局里的空面板组自愈**：拖动/关闭面板可能留下空 tabset，FlexLayout 会把它原样
+  存盘、恢复时渲染成一块白板。现在存盘与恢复两端都剪掉空面板组——
+  已经存坏的布局**刷新即自愈**，不用点「重置布局」。
+
+## 0.22.0 (2026-10-31)
+
+**原始资料的 text 底层改为 markdown：图片内嵌在正文里，图文不再分家。**
+
+聊天记录是图文混排的——把文字存成一条、图存成另一个附件条目，等于把一段话拆得没头没尾。
+所以 `text` 直接以 markdown 为底层：`![说明](f_xxx)` 内嵌附件库的图、`![说明](https://…)` 直接外链，
+正文照旧原样存（面板上的修改是人显式点了「编辑」）。
+
+### Added
+
+- **抽屉收集即排版**：粘贴框变成 markdown 收集器——图片直接 **Ctrl+V** 或**拖进编辑器**（自动上传
+  附件库并在光标处插入引用）、「插入图片」按钮选文件；图片内嵌显示，其它文件以可点链接内嵌。
+  拖拽两条路语义不同：拖**编辑器** = 插进正文，拖**左栏清单** = 入袋成附件条目。
+- **text 条目可显式编辑**：正文面板加「编辑 / 保存修改」（就地更新——是人点的保存，
+  「原文不改写」的纪律不破）；正文渲染走与 md 字段同一台机器（图片解析 / 外链 / 点击放大 / 任务勾选）。
+- 导出/导入：资料袋正文里内嵌的图片引用计入**引用扫描**（随包带走）并在导入时**重映射**到新库 id
+  （`sourceImageIds` 一处实现，打包与完整性检查共用）。
+- CLI：`source get` 的 text 用 `rewriteMdImages` 还原成 `[图片: 说明] 本地路径`（外链标注「外链」）；
+  标题推断与摘要压掉图片语法（`![截图](f_x)` 不再当标题、摘要里是 `[图: 说明]`）。
+
+### Compatibility
+
+- **老数据不用迁移**：普通文字本来就是合法 markdown（段落 + 换行），渲染层无缝接管；
+  `--set source='随手记'`、`source add --text` 的用法全部不变。
+
+## 0.21.0 (2026-10-30)
+
+**条目有了块正文（`entry.body`）；栏目有了数据库视图（`section.views`）。**
+
+块是「递归的内容单元」，视图是「同一批数据的多种投影」。两者都**只加可选键**，
+老 store 一个字节不用改；反方向的降级被显式拦住（见 Changed）。
+
+### Added
+
+- **块正文**：`entry.body: Block[]`，七种叶块（段落 / 标题 / 图文 / 表格 / 清单 / 附件 / 密钥）
+  与两种容器块（内嵌栏目 `section` / 分栏 `column`，容器块的编辑随下一版）。
+  - CLI：`entry block add | update | move | remove | remove-many`、`entry body <ref> [--mask]`；
+    HTTP 同名路由，**一条 action 双端**（面板与 CLI 走同一份 service）。
+  - 详细页下半部分是块面板：双击编辑文本块、表格块复用表格字段的同一台机器（公式/统计照旧）、
+    密钥块与 secret 字段同一条 AES-256-GCM 路径，打码态**只读**（把星号写回去等于把星号存成密钥）。
+  - 块随导出包往返；file 块里的附件 id 计入引用扫描（`file cleanup` 不会误删）；
+    md 块里的贴图随包重映射。
+- **数据库视图**：`section.views` / `section.defaultView`。
+  - CLI：`section view list | add | update | remove | set-default`（HTTP 同名路由）。
+  - **缺省视图是推断的、不落盘**：非 KV 栏目给「表格 / 精简 / 看板」，KV 栏目给「KV」；
+    第一次改视图才固化（并把当时生效的那套一起写进去，chips 不会凭空消失）。
+  - 投影只存 `key/width/hidden`，标签与类型回查字段字典；引用的字段被删 → 列还在，
+    表头写「已删字段」、单元格「—」（不炸、也不静默消失）。
+  - 面板：栏目页顶部视图 chips + 表格视图（横向投影，密文列在表格里一律打码）。
+    看板**渲染**随下一版（配置与 action 已可用）。
+- **Notion 式工作区壳**（S3）：
+  - 顶栏只留全局动作（品牌 / 存储 / 打码 / ＋面板 / 撤销重做 / 设置 / 刷新）；
+    **栏目 tab 从顶栏移除**——栏目只从目录树进，两处入口必然分叉。
+  - 目录树：栏目 + 分组 + 条目子节点；**拖拽重排与嵌套**（第一次拖动把「从旧导航配置
+    推断出的树」固化成显式 `settings.navTree`，之前始终只读推断、不写回）；
+    隐藏的栏目收在树底（一键恢复，数据不动）。
+  - 布局 = FlexLayout 模型：面板可拖到任意一边拆分、弹出成浮窗；布局存
+    localStorage（`nx-sk-ui.workspace`），跨会话恢复；撤销/重做按「整段拖拽 = 一步」。
+  - 深链升级为两段：`#/栏目` 开该栏目的数据库面板，`#/栏目/条目` 再定位到条目；
+    栏目 / 条目缺失时明确提示是哪一级没了。
+  - 正文块支持拖拽排序（块头把手）；数据库面板即工作区里的一块面板，可与其他面板并列。
+- **块级 AI（提议 → 审 → 应用/拒绝）**（S4）：
+  - CLI：`entry ai list | suggest | apply | reject`（HTTP 同名路由）。
+    `suggest` 收 `--from @proposal.json`（AI 给出的**最终正文**）与 `--prompt`（指令留痕），
+    只落一条 pending；`apply` 才写 store；`reject` 只删文件。
+  - **nx-sk 不自带大模型**：提议由调用方（agent 或外部模型）产出后交进来。这样
+    「agent 走 CLI」与「人在面板上审同一条 pending」是同一套语义，不需要第二个 AI 入口。
+  - **pending 落 `~/nx-sk/pending/`（运行态）**：不进 `store.json`、不进导出包、不进迁移副本
+    ——里面对 secret 块是明文，落进数据面就等于写进备份与导出面。删目录即清空。
+  - diff 是**字符级**的：`same / del / ins` 三段，面板上红删绿增；容器块的改动由子块表达
+    （不把父块一起报成改动）；secret 块只报「变了」，明文不经面板接口。
+  - **冲突检测**：pending 记每块应用前的 `baseHash`（服务端算），块被改过 → `CONFLICT`，
+    一个字都不写；`--force` 才覆盖。没有差异的提议返回 `noop`，不留空的待审。
+  - secret 块的差异按**明文**比对（store 里是密文、提议里是明文），否则一个没动的密钥
+    会被报成「密文块已变更」。
+
+### Changed
+
+- **`STORE_VERSION` 3 → 4**。只加可选键、无迁移函数；但**老版本读 v4 store 后写入会被拒**
+  （`BLOCKED`：「store 由更新版本的 nx-sk 写入」）。不拦的话，老版本的白名单归一会把
+  `body` / `views` 静默抹掉，且版本号相同、无从警告。
+- **导出包 `formatVersion` 1 → 2**（包里多了 `entries[].body` 与 `section.views`）。
+  老版本读到新包会明确报「版本过新，请先升级」，而不是把两个键静默丢掉。
+  导入时视图只在「新建栏目」或「目标没配过视图」时应用——目标已有视图说明用户自己配过，不覆盖。
+
+### Fixed
+
+- **表格字段的敏感列导出为明文**（0.19 起的老缺陷）：`plainValues` 没有 table 分支，
+  导出包里是密文 blob，跨机器导入永远解不开。现在与其它敏感字段同一口径（包里明文，保护靠口令）。
+- 块面板在 `bootstrap` 后渲染崩溃（注释与函数声明粘连导致 TDZ）。
+
 ## 0.20.0 (2026-10-30)
 
 **栏目管理重构成树；初始化不再播种一堆场景栏目，改播一个「字段样例」说明书。**

package/README.md

@@ -168,8 +168,24 @@ CLI 与 API 同源，skill 驱动 agent**。落到具体功能上：
 | `nx-sk entry remove-many <ids>` | 批量删条目（ids 逗号分隔）；找不到的跳过并报告，一个都找不到才报错 |
 | `nx-sk section templates` | 内置模板（job / secret / projects / internships / campus / deploy / platform / thesis） |
 | `nx-sk section sync <id> [--dry-run]` | 按模板**补齐**本栏目缺的分组与字段（只增不改不删）——模板演进后让老栏目追上 |
+| `nx-sk section update <id> --add-group / --rename-group / --move-group / --remove-group` | 改**分组骨架**：新增 / 改名（可换 id，字段引用跟着改）/ 上下挪 / 删（空的才让删） |
+| `nx-sk section update <id> --set-field / --move-field` | 改**字段**：改标签 / 类型 / 分组 / 提示 / 必填策略，组内上下挪（key 不可改）。面板「编辑栏目」同源 |
 | `nx-sk entry list \| get \| add \| update \| remove` | 条目 CRUD（PATCH 语义） |
 | `nx-sk entry fields [--section job]` | 字段字典 —— 填之前先看这个，别猜字段名 |
+| `nx-sk entry block add <ref> --type <段落\\|标题\\|图文\\|表格\\|清单\\|附件\\|密钥> [--data @x.json] [--after <块id>]` | 追加**块正文**（`entry.body`，可选键）；详细页下半部分同源 |
+| `nx-sk entry block update <ref> <块id> [--data @x.json]` | 改块（PATCH 语义）；密钥块在打码态下写回会被拒（星号不能存成密钥） |
+| `nx-sk entry block move <ref> <块id> --to <index>` | 移动块（拖拽落点 = 一次 move） |
+| `nx-sk entry block remove \\| remove-many <ref> <块id…>` | 删块；批量时找不到的跳过并报告 |
+| `nx-sk entry body <ref> [--mask]` | 读块正文（人读渲染；`--mask` 只作用于密钥块） |
+| `nx-sk entry ai suggest <ref> --prompt "改短一点" --from @proposal.json [--block <块id>]` | 生成一条**AI 提议**：只落 pending，不写 store。`--from` 是 AI 给出的最终正文（nx-sk 不自带大模型） |
+| `nx-sk entry ai list <ref>` | 看待审提议（新的在前）。pending 是运行态，不进 store、不进导出包 |
+| `nx-sk entry ai apply <pendingId> [--block <块id>] [--force]` | 应用提议（**唯一会写 store 的一步**）；块被改过 → `CONFLICT`，`--force` 才覆盖 |
+| `nx-sk entry ai reject <pendingId>` | 拒绝提议：删掉 pending 文件，数据一个字不动 |
+| `nx-sk section view list <id>` | 列视图配置；**没配过时给缺省推断**（表格/精简/看板，标 provisional，不落盘） |
+| `nx-sk section view add <id> --type table\\|board\\|kv [--title 名] [--columns 姓名,状态] [--groupby 字段] [--sort 字段:desc]` | 新增视图（第一次 add 把当前生效的推断视图一起固化，chips 不会凭空消失） |
+| `nx-sk section view update <id> <viewId> [--title] [--columns] [--sort] [--set col.字段.width=120]` | 改视图；列宽拖拽结束 = 一次 update |
+| `nx-sk section view remove <id> <viewId>` | 删视图；删光回到缺省推断态（`defaultView` 一并清掉） |
+| `nx-sk section view set-default <id> <viewId>` | 设缺省视图（写 `section.defaultView` —— 是数据，不是面板设置） |
 | `nx-sk file list \| get \| add \| update \| remove` | 附件 CRUD（原件在 `~/nx-sk/files/`，同内容去重） |
 | `nx-sk file add --path <文件> [--copy] [--category C]` | 导入附件：**默认移动原件**，`--copy` 仅复制 |
 | `nx-sk file list [--section <栏目\|none>] [--q 关键字]` | 列附件：按「哪些栏目在引用」筛选（`none` = 未引用）；返回栏目汇总与存储目录 |

package/assets/nx-sk/SKILL.md

@@ -263,9 +263,11 @@ nx-sk entry table 周报 --field 任务表
 
 原始资料袋（`type: 'source'`）——**每个栏目都自带一个**的「乱入区」。值 = 一组资料条目
 （`{id, kind, name, text|fileId|url, addedAt, note, mapped}`；kind = text / file / url）。
-杂乱资料（邮件、截图、PDF 摘录、手抄的表）先**原样**丢进袋里，之后由 agent 或人
+杂乱资料（邮件、聊天记录、截图、PDF 摘录）先**原样**丢进袋里，之后由 agent 或人
 按栏目字段字典整理进上面的字段——「先乱入、后整理」因此成立：没有这个袋子，
 用户只有两个坏选择：把乱数据硬塞进结构化字段（把结构搞脏），或干脆不存（信息丢了）。
+**text 的底层是 markdown**：聊天记录图文混排，图片直接写进正文
+（`![说明](f_xxx)` / 外链 `![说明](https://…)`），图和文不分家——形状见 [[15-special-fields]]。
 
 ```bash
 nx-sk source list                       # 各栏目的袋概况

package/assets/nx-sk/references/10-sections-entries.md

@@ -105,7 +105,64 @@ nx-sk entry get 张三 --json
 - 身份证号、手机号、紧急联系人电话这类字段，写之前跟用户确认一次来源。
 - 每次批量写之前先 `--dry-run`。
 
-## 五、扩字段字典（不写代码）
+## 五、块正文与 AI 提议（entry.body / entry ai）
+
+条目除了结构化字段还有**块正文**（`entry.body`，可选键）：段落 / 标题 / 图文 / 表格 / 清单 /
+附件 / 密钥七种叶块，加内嵌栏目（`section`）与分栏（`column`)两种容器块。
+
+```bash
+# 建块 / 看块
+nx-sk entry block add <ref> --type paragraph --data '{"text":"第一段"}'
+nx-sk entry block list <ref>          # secret 块默认原文，--mask 打码
+nx-sk entry block update <ref> <块id> --data @块.json
+nx-sk entry block move <ref> <块id> --to 0
+
+# AI 提议：**AI 永不直接改数据**
+#   ① 你（agent / 外部模型）产出提议正文 = 该条目的最终块数组
+#   ② suggest 只落一条 pending（~/nx-sk/pending/，运行态，不进 store / 导出包）
+#   ③ 人或你在面板/CLI 上 apply（才写 store）或 reject（只删文件）
+nx-sk entry ai suggest <ref> --prompt "把自我介绍改短" --from @proposal.json
+nx-sk entry ai list <ref>
+nx-sk entry ai apply <pendingId>      # 块被改过 → CONFLICT，--force 才覆盖
+nx-sk entry ai reject <pendingId>
+```
+
+**纪律**：
+
+- proposal.json 是 `{"blocks":[…]}` 或直接块数组；给**最终正文**，不是补丁。
+- 建议先 `nx-sk entry block list <ref> --json` 拿现正文再改，块 id 保持不变
+  （同 id 不同内容 = 一次「修改」，出现新 id = 「新增」，缺了的 id = 「删除」）。
+- 密钥块在提议里是明文——pending 落在本机运行态目录（0600），这是有意设计；
+  但**不要**把 pending 文件内容贴进对话或日志。
+- 应用前想留底就先 `transfer export`（apply 写 store，与手改同一条边界）。
+
+## 六、数据库视图（section.views / section view）
+
+视图是**同一批条目的多种投影**：表格（列 = 字段投影）、精简（两列）、看板（按 select 字段分列）、
+KV 栏目的键值面。配置存在 `section.views` / `section.defaultView`（可选键）。
+
+```bash
+nx-sk section view list <id>            # 没配过时给缺省推断（provisional: true，不落盘）
+nx-sk section view add <id> --type board --title 按状态 --groupby status
+nx-sk section view update <id> <viewId> --set col.状态.width=180 --sort 状态:desc
+nx-sk section view set-default <id> <viewId>
+nx-sk section view remove <id> <viewId>
+```
+
+**语义**：
+
+- **缺省视图是推断的、不落盘**：非 KV 栏目给「表格 / 精简 / 看板」，KV 栏目给「KV」。
+  第一次改视图才固化（把当时生效的那套推断视图一起写进去——只写用户新建的那条，
+  其余 chips 会凭空消失）。`views: []` 与「没配过」行为一致，都走推断。
+- 投影只存 `key / width / hidden`；标签与类型回查字段字典。引用的字段被删 → 列还在，
+  表头写「已删字段」、单元格「—」（不炸、也不静默消失）。
+- **看板的拖卡 = 写操作**：等于 `entry update --set <groupby字段>=<列值>`；
+  空值与候选外的值落「未分组」列——展示可以，**不是拖拽落点**（拖进去等于写一个不存在的值）。
+- **没有筛选 DSL**（`--filter` 明确不做）：存一个不生效的配置比没有更糟。
+- 视图随导出包往返；导入只在「新建栏目」或「目标没配过视图」时应用——
+  目标已有视图说明用户自己配过，不静默覆盖（预览里给警告）。
+
+## 七、扩字段字典（不写代码）
 
 **最省事的做法：直接写。** 字典里没有的键会自动登记（键名就是它本身），类型按值推断
 （`是/否` → bool，数组 → tags，其余 → text）。
@@ -151,7 +208,8 @@ nx-sk section update job --fields @fields.json
 > `type: 'entrylist'` 是**结构清单字段**：值 = 行对象的**数组**，行数不限（变长）；列（子字段）
 > 在字段定义的 `fields` 里声明。适合「一个条目挂多组 链接/账号/密码」这类密集结构——
 > tags 存不了结构，拆成多个字段又不知道会有几组。声明 `sensitive: true` 的列与顶层敏感字段
-> 同一条边界：密文落盘、默认原文、`--mask` 打码。面板渲染成密集迷你表，直接增删行。
+> 同一条边界：密文落盘、默认原文、`--mask` 打码。面板渲染成密集迷你表，直接增删行，
+> **拖行尾的 ⠿ 调行序**（行内操作键是小图标键，不抢内容的注意力）。
 >
 > ```bash
 > # 建字段（面板「新增字段」选「结构清单」会预填 名称/链接/账号/密码(密文) 四列）
@@ -170,6 +228,7 @@ nx-sk section update job --fields @fields.json
 > 还能有**计算列**（JS 表达式）与**表尾统计**。最根本的差别是**结构归数据**：列定义、行、公式、
 > 统计配置全部存在**条目值里**（`{v, columns, rows, totals?, summary?}`），字段定义里的 `columns`
 > 只是「新建时的初始列」。所以「这一条想多一列」不必改 schema，也不影响同栏目其它条目。
+> 面板上**行与列都能拖**：拖表头搬列、拖行尾的 ⠿ 搬行（松手前有插入线）。
 >
 > ```bash
 > nx-sk section update mysec --add-field '{"key":"tasks","label":"任务表","type":"table"}'
@@ -198,6 +257,37 @@ nx-sk section update job --fields @fields.json
 
 > `select` 的 `options` 是**候选项不是白名单**：真实值（如某个少数民族）不在候选里也允许写入。
 
+### 栏目结构：分组也是数据，面板里就能改
+
+栏目 = 分组（`section.groups`）+ 字段字典（`section.fields`），两样都只是**数据**：
+分组是条目表单里的小标题，**顺序就是它们出现的先后**。面板「编辑栏目」里能直接增删改序，
+CLI 用同一批 action —— 不存在「哪一边功能少一点」。
+
+```bash
+nx-sk section update job --add-group '{"id":"contact","title":"联系信息"}'
+nx-sk section update job --rename-group '{"id":"contact","title":"联系方式"}'
+nx-sk section update job --rename-group '{"id":"contact","title":"联系方式","newId":"reach"}'  # 换 id：组里字段的 group 跟着改
+nx-sk section update job --move-group '{"id":"reach","dir":"up"}'
+nx-sk section update job --remove-group reach                        # 空组才能删
+nx-sk section update job --set-field '{"key":"phone","label":"手机号","group":"reach"}'
+nx-sk section update job --move-field '{"key":"phone","dir":"up"}'   # 在自己的分组内换位置
+```
+
+每次改动都会把**新旧值**打进输出（`字段 phone：分组 contact → reach`）——
+「已更新栏目 job：fields」这种输出等于没说，改错了没法回溯。
+
+三条规矩，全是**拦下来**而不是悄悄做：
+
+| 规矩 | 为什么 |
+| --- | --- |
+| 分组 id 唯一 | 重复报 CONFLICT，绝不覆盖同名分组（改名用 `--rename-group`） |
+| 非空分组不给删 | 字段上挂着每个条目的值；先把字段挪走（改它的「分组」）或删掉 |
+| 字段 key 不可改 | 值按 key 存在条目里，改 key = 已有值读不出来。要换就新增字段再搬值 |
+
+另外两条边界：内置的「原始资料」分组与字段**删不掉**（每个栏目自带，删了下回读又补回来）；
+清单类字段（`entrylist` / `table`）的列是字段自己的结构，所以**不提供就地换类型**——
+要建就在「新增字段」里连列一起建。
+
 ### 填写策略 `fill`：有些格子填了反而减分
 
 不是每个格子都值得填。应届生的「上一家公司」、政治面貌为「群众」时的「入党时间」——
@@ -235,13 +325,24 @@ nx-sk entry get 张三
 > ② 两者都**不要**出现在「还缺什么」的清单里；③ 用户说「这个不用填」时，
 > 用 `--fill <字段>=avoid` 记下来，而不是靠下一轮上下文记住。
 
-## 六、Web 面板
-
-`nx-sk serve` → 每个栏目一个 tab，共用同一个条目视图：
-
-- 左侧条目列表（带完整度），右侧按分组渲染的字段表单；
-- 密文字段默认显示原文；「打码显示（投屏/截图时用）」勾选等价于 `--mask`（选择持久化在 localStorage）；
+## 八、Web 面板
+
+`nx-sk serve` 打开的是**可停靠的工作区**（Notion 式壳），不是一栏一页：
+
+- **目录树**（左侧面板）：栏目 + 分组 + 条目子节点。拖拽重排与嵌套——第一次拖动会把
+  「从旧导航配置推断出的树」固化成显式 `settings.navTree`（`settings get` 里
+  `navTreeSource: explicit`，之前始终 `inferred` 只读不写回）；隐藏的栏目收在树底，一键恢复。
+- **布局 = FlexLayout 模型**：数据库 / 资料 / 文件 / 导出 / 设置都是面板，可拖到任意一边拆分、
+  弹出成浮窗；布局存 localStorage（`nx-sk-ui.workspace`），跨会话恢复，顶栏可撤销/重做。
+- **两段深链**：`#/栏目` 开该栏目的数据库面板，`#/栏目/条目` 再定位到条目；
+  栏目 / 条目缺失时明确提示是哪一级没了。
+- 栏目页（数据库面板）顶部是**视图 chips**（表格 / 精简 / 看板 / KV，见 §六）；
+  左侧条目列表带完整度，右侧按分组渲染的字段表单。
+- 密文字段默认显示原文；顶栏「打码」等价于 `--mask`（选择持久化在 localStorage）；
+- **栏目结构自己能搭**：栏目面板里点某个栏目的「编辑」，弹窗里分组可新增 / 改名（含换 id）/
+  上下挪 / 删（空的才让删），字段可改标签 / 类型 / 分组 / 提示 / 必填策略、组内上下挪、删除
+  —— 一次改动一次落盘，与 CLI 的 `--add-group` 等是同一批 action（见 §七「栏目结构」）。
 - 保存是 **PATCH**：只有被你改动过的字段才会发出去（面板会显示「N 处改动」）；
-- 每个页面底部会派生显示该模块的 CLI 等价命令（可点击复制）。
+- 详细页下半部分是**块面板**（见 §五），AI 提议是评审条：渲染 diff + 应用 / 拒绝。
 
 面板上没有 CLI 做不到的事——两边共享同一套 action 声明。

package/assets/nx-sk/references/15-special-fields.md

@@ -13,8 +13,8 @@
 
 | type | 值形状 | 结构（列）归谁 | 面板怎么编 | 读它 |
 | --- | --- | --- | --- | --- |
-| `table` | `{v, columns, rows, totals?, summary?}` | **数据自己**（字段定义只给初始列） | 表格控件 + 「列设置」 | `entry table` / `entry get` |
-| `entrylist` | `[{列key: 值}, …]` | 字段字典的 `fields` | 密集迷你表（直接增删行） | `entry get` |
+| `table` | `{v, columns, rows, totals?, summary?}` | **数据自己**（字段定义只给初始列） | 表格控件 + 「列设置」；**拖表头搬列、拖行尾 ⠿ 搬行** | `entry table` / `entry get` |
+| `entrylist` | `[{列key: 值}, …]` | 字段字典的 `fields` | 密集迷你表（直接增删行，**拖 ⠿ 调行序**） | `entry get` |
 | `md` | 一段 markdown 字符串 | — | 图文编辑器（Ctrl+V 贴图） | `entry get`（图片还原成路径） |
 | `file` | `[附件id, …]` | 字段字典的 `kind` / `maxItems` | 附件选择器（上传 / 从库里选） | `entry get`（附件名 + 物理路径） |
 | `source` | `[{id, kind, name, text\|fileId\|url, addedAt, …}]` | 内置（每个栏目自带一个） | 底部折叠条 → 右侧抽屉 | `source get` |
@@ -120,6 +120,21 @@
 默认值只在**新增行**时用（面板「添加行」按列的 `default` 预填），不会回头改已有行；
 字段级的默认是：初始列 + 表尾自动统计（数字 sum / 勾选 countTrue）+ 列类型默认 text。
 
+### 面板上怎么调顺序（拖）
+
+排序是表格最常见的编辑动作之一，所以**行与列都能拖**，不用去点箭头：
+
+- **搬列**：直接拖**表头**（表头里没有输入框，不会跟选词打架）；「列设置」里每列前面的 ⠿
+  也能拖，效果一样。
+- **搬行**：拖行尾的 ⠿。整行 `draggable` 不这么做——那会跟单元格里选文本冲突
+  （想选一段字结果把行拖走了），所以把手是唯一的拖拽入口。
+- 松手前会有一条**插入线**落在上/下半（行）或左/右半（列）的位置：线在哪就插到哪。
+  只高亮「这一行」是做不到这件事的。
+- ↑↓ / ←→ 保留（鼠标悬停在行上才浮出来），键盘与「就挪一格」的场景仍然走得通；
+  行内操作键统一是 16px 的小图标键——密集表里的按钮不该抢内容的注意力。
+
+`entrylist` 的行同理（拖 ⠿），删除键也从「一颗正常大小的按钮」换成了小图标键。
+
 ### 常见错 → 改法
 
 | 报错 | 改法 |
@@ -156,6 +171,10 @@
 ## `source` 原始资料袋
 
 - 每个非 KV 栏目自带一个：杂乱资料先**原样**入袋（不改写），之后按字段字典整理。
+- **`text` 的底层是 markdown**——聊天记录图文混排，图和文不能分开存：
+  正文里直接写 `![说明](f_xxx)`（附件库的图）或 `![说明](https://…)`（外链图）；
+  面板抽屉里图片 Ctrl+V / 拖进编辑器就自动上传并插入引用。
+  普通文字本来就是合法 markdown，老数据不用迁移。
 - 不计完整度（`fill: optional`）；袋里是明文，**敏感内容不要进袋**。
 
 ## `secret` 密文

package/assets/nx-sk/references/60-transfer.md

@@ -74,9 +74,14 @@ bundle.json              包清单：包含哪些栏目、整体口令说明
 sections/<id>.zip        每个栏目一个上面的单栏目包（逐栏目复用同一套逻辑）
 ```
 
-- 只打包**条目实际引用**的附件：`file` 字段的 id + `md` 正文里的 `![…](f_x)`。
+- 只打包**条目实际引用**的附件：`file` 字段的 id + `md` 正文里的 `![…](f_x)` + `file` **块**里的 id。
 - 导入时附件按 **sha256 去重**：本机已有同一份文件就复用，不会存两份。
-- 条目里的旧 file id 会**自动重映射**到新 id（`file` 字段数组与 md 图片引用都改）。
+- 条目里的旧 file id 会**自动重映射**到新 id（`file` 字段数组、`file` 块与 md 图片引用都改）。
+- 包版本（`manifest.formatVersion`）：**2** 起，包里多 `entries[].body`（块正文）与
+  `section.views`（视图配置）。老版本读到 2 号包会明确报「版本过新」，
+  不会把这两个键静默丢掉；manifest 里**没有这个键**（0.20 及更早的包）视为 1 号包——
+  无正文/无视图，照常导入。
+- 导入时视图配置只在「新建栏目」或「目标没配过视图」时应用——目标已有自己的视图就不覆盖（预览里会提示）。
 - `import-new` 会看包结构自动判断是单栏目包还是整库包，不用手动挑命令。
 
 ## 口令加密（transfer 层）
@@ -102,8 +107,9 @@ sections/<id>.zip        每个栏目一个上面的单栏目包（逐栏目复
 包里**恒为明文**，保护只靠口令 —— 没有「打码 / 明文」二选（0.11.0 之前的 `--no-secrets` 已移除）。
 要发给别人的包就设口令；不设口令的包自己收好，别当分享件用。
 
-读取侧仍兼容旧打码包：遇到 `******` 会跳过该字段并计数，不会把打码串当新密码存进去。
-导入后敏感字段用**本机 vaultKey** 重新加密落盘，与手填的字段没有区别。
+读取侧仍兼容旧打码包：遇到 `******` 会跳过该字段并计数，不会把打码串当新密码存进去；
+**密钥块**同一条口径——打码的密钥块保留、值清空待重填（预览会统计「密钥块打码 N 个」）。
+导入后敏感字段与密钥块用**本机 vaultKey** 重新加密落盘，与手填的没有区别。
 
 ## 限制与坑
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-sk",
-  "version": "0.20.0",
+  "version": "0.23.0",
   "description": "nx-sk · 本机个人资源管理器（server-cli-web 骨架）：栏目化存储个人信息与大模型密钥，CLI 与 Web 同源，敏感字段密文落盘。",
   "type": "module",
   "bin": {
@@ -18,11 +18,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/ZHLX2005/nx-sk.git"
+    "url": "https://github.com/On-DevPlan/nx-sk.git"
   },
-  "homepage": "https://github.com/ZHLX2005/nx-sk#readme",
+  "homepage": "https://github.com/On-DevPlan/nx-sk#readme",
   "bugs": {
-    "url": "https://github.com/ZHLX2005/nx-sk/issues"
+    "url": "https://github.com/On-DevPlan/nx-sk/issues"
   },
   "packageManager": "pnpm@9.12.0",
   "nxSk": {
@@ -37,12 +37,23 @@
     "dev:serve": "node bin/nx-sk.mjs serve --no-open",
     "build": "vite build && node scripts/link-local.mjs --auto",
     "start": "pnpm run build && node bin/nx-sk.mjs serve",
+    "proto:dev": "vite --config plan/block-refactor/prototype/vite.config.js",
+    "proto:build": "vite build --config plan/block-refactor/prototype/vite.config.js",
+    "loop:on": "node scripts/rp-loop.mjs on",
+    "loop:off": "node scripts/rp-loop.mjs off",
+    "loop:status": "node scripts/rp-loop.mjs status",
+    "loop:log": "node scripts/rp-loop.mjs log",
+    "loop:cancel": "node scripts/rp-loop.mjs cancel",
     "lint": "eslint .",
     "test:unit": "node --test",
     "test:smoke": "node tests/smoke.mjs",
     "test": "pnpm run lint && pnpm run build && pnpm run test:smoke && pnpm run test:unit"
   },
   "dependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "flexlayout-react": "0.11.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-markdown": "^10.1.0",

package/src/core/attachments.js

@@ -136,6 +136,24 @@ export function normalizeFileRecord(raw) {
  * 0.8.0 之前 `--set` 不拆逗号），所以字符串统一按分隔符拆开。
  * 去空、去重、保序：同一个附件在一个字段里出现两次没有意义。
  */
+/** 块正文里的附件引用：file 块的 id 列表 + md 块正文里的图片 id。 */
+function blockFileRefs(entry) {
+  const out = [];
+  const walk = (blocks) => {
+    for (const b of blocks || []) {
+      if (b.type === 'file' && Array.isArray(b.files)) {
+        for (const id of fileIdsOf(b.files)) out.push(id);
+      }
+      if (b.type === 'md' && typeof b.text === 'string') {
+        for (const id of mdImageIds(b.text)) out.push(id);
+      }
+      if (b.children) walk(b.children);
+    }
+  };
+  walk(entry.body);
+  return out;
+}
+
 export function fileIdsOf(value) {
   const raw = value === null || value === undefined
     ? []
@@ -173,7 +191,11 @@ export function findFileRecord(store, ref) {
  *      图片是**内嵌在 markdown 里**的，和 file 字段一样是正式引用。
  *   3. `source` 字段 —— 原始资料袋里 kind='file' 的 item（袋是溯源的锚点：
  *      字段值是从这份原件整理出来的，原件被删，溯源就成了空话）。
- * 同一个（条目, 字段）只出一条。附件中心据此显示「被哪些栏目 / 条目 / 字段用到」。
+ *   4. **块正文**（v4）—— `file` 块里挂的附件、`md` 块正文里贴的图。
+ *      块是条目正文的一部分，正式程度与字段相同；漏扫它 = 「只在块里挂过」的附件
+ *      会被 cleanup 判成未引用然后删掉（真实事故的块版）。
+ * 块引用出一条（fieldKey 记块 id）；其余同一条（条目, 字段）只出一条。
+ * 附件中心据此显示「被哪些栏目 / 条目 / 字段 / 块用到」。
  */
 export function fileReferences(store, rec) {
   if (!rec) return [];
@@ -221,6 +243,17 @@ export function fileReferences(store, rec) {
           .map((x) => x.fileId);
         if (ids.length && hits(ids)) push(f);
       }
+      // ④ 块正文（v4）：file 块 + md 块。命中就出一条，fieldKey 记块 id、fieldLabel 记块类型。
+      const blockHits = blockFileRefs(e);
+      if (blockHits.length && hits(blockHits)) {
+        const which = (e.body || []).some((b) => b.type === 'file'
+          && fileIdsOf(b.files).some((ref) => hits([ref]))) ? 'file 块' : 'md 块';
+        out.push({
+          sectionId: sec.id, sectionTitle: sec.title,
+          entryId: e.id, entryTitle: e.title,
+          fieldKey: 'body', fieldLabel: which,
+        });
+      }
     }
   }
   return out;

package/src/core/paths.js

@@ -61,6 +61,17 @@ export function migrationDir() {
   return join(appHome(), 'migrate');
 }
 
+/**
+ * 块级 AI 的 pending 目录：`~/nx-sk/pending/`（一个 pending 一个文件）。
+ *
+ * **运行态，不是数据**：不进 store.json、不进导出包、不进迁移副本。
+ * 理由见设计 §14.4——pending 里可能有明文密钥（AI 提议的 secret 块），
+ * 落进 store 就等于把它写进了备份与导出面。删掉这个目录即清空全部待审提议。
+ */
+export function pendingDir() {
+  return join(appHome(), 'pending');
+}
+
 export function vaultKeyFile() {
   return join(appHome(), '.vaultkey');
 }

package/src/core/render.js

@@ -108,6 +108,15 @@ export function displaySensitive(raw, { mask = false, decrypt } = {}) {
   }
 }
 
+/** 块正文（v4）的展示形态：secret 块的值走与敏感字段**同一条** displaySensitive 边界。 */
+export function displayBlocks(blocks, { mask = false, decrypt } = {}) {
+  return (blocks || []).map((b) => {
+    if (b.type === 'secret') return { ...b, value: displaySensitive(b.value, { mask, decrypt }) };
+    if (Array.isArray(b.children)) return { ...b, children: displayBlocks(b.children, { mask, decrypt }) };
+    return b;
+  });
+}
+
 /**
  * 条目的**唯一序列化出口**（面板、`entry list`、`section dump` 共用一份）。
  * 两个出口各写一遍序列化，迟早会分叉成「CLI 看得到、面板看不到」。
@@ -147,6 +156,10 @@ export function serializeEntry(section, entry, { mask = false, decrypt } = {}) {
     tags: entry.tags || [],
     createdAt: entry.createdAt,
     updatedAt: entry.updatedAt,
+    // 块正文（v4）：可选键——没有块就不带这个键（别让老条目凭空多出一个空数组）
+    ...(Array.isArray(entry.body) && entry.body.length
+      ? { body: displayBlocks(entry.body, { mask, decrypt }) }
+      : {}),
     completeness: {
       filled: c.filled,
       total: c.total,