nx-sk 0.20.0 → 0.23.1

package/CHANGELOG.md

@@ -2,6 +2,112 @@
 
 本文件格式参考 [Keep a Changelog](https://keepachangelog.com/)，中文正文。
 
+## 0.23.1 (2026-11-05)
+
+### Added
+
+- **`skill install --all`：一次装齐 `assets/` 下全部 skill，且直接覆盖**。范围取目录
+  扫描（事实源 `assets/<x>/SKILL.md`），不依赖分组表；覆盖隐式生效，不用再补 `--force`。
+  与 `[name]` 互斥；`--mode symlink` / `--dry-run` 对整批同样适用。
+
+## 0.23.0 (2026-10-31)
+
+**栏目结构在面板里可自己搭了：分组能增删改序，字段能改名 / 换组 / 换类型 / 换位置。**
+
+过去面板只能「加字段」，连建一个分组都要回 CLI 或换模板——于是「这个栏目长什么样」
+这件事实际上只有命令行能控制，面板就不是控制面板。这次把结构的四个分组操作与两个字段操作
+做成 action（面板与 CLI 同一份），面板「编辑栏目」里直接可改。
+
+### Added
+
+- **分组骨架**：`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」——那种输出改错了没法回溯。
+
+- **表格 / 清单：行与列都能拖**（Notion 那种手感）：拖**表头**搬列、拖行尾的 ⠿ 搬行，
+  松手前一条**插入线**告诉你落在哪（只高亮整行说不清「会插到哪」）。排序算法单独一个
+  `reorderAt`（插入位语义，有单测）——差一的表现是「拖到第二行结果跑到第三行」。
+  整行不做 `draggable`：那会跟单元格里选文本打架，把手是唯一的拖拽入口。
+  ↑↓ / ←→ 保留但**悬停才浮出**，行内操作键统一收成 16px 小图标键（密集表里的按钮
+  不该抢内容的注意力）；entrylist 那颗「正常大小的删除按钮」也换成了小图标键。
+
+## 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 已可用）。
+
+### 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,6 +168,8 @@ 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 file list \| get \| add \| update \| remove` | 附件 CRUD（原件在 `~/nx-sk/files/`，同内容去重） |

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

@@ -151,7 +151,8 @@ nx-sk section update job --fields @fields.json
 > `type: 'entrylist'` 是**结构清单字段**：值 = 行对象的**数组**，行数不限（变长）；列（子字段）
 > 在字段定义的 `fields` 里声明。适合「一个条目挂多组 链接/账号/密码」这类密集结构——
 > tags 存不了结构，拆成多个字段又不知道会有几组。声明 `sensitive: true` 的列与顶层敏感字段
-> 同一条边界：密文落盘、默认原文、`--mask` 打码。面板渲染成密集迷你表，直接增删行。
+> 同一条边界：密文落盘、默认原文、`--mask` 打码。面板渲染成密集迷你表，直接增删行，
+> **拖行尾的 ⠿ 调行序**（行内操作键是小图标键，不抢内容的注意力）。
 >
 > ```bash
 > # 建字段（面板「新增字段」选「结构清单」会预填 名称/链接/账号/密码(密文) 四列）
@@ -170,6 +171,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 +200,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`：有些格子填了反而减分
 
 不是每个格子都值得填。应届生的「上一家公司」、政治面貌为「群众」时的「入党时间」——
@@ -240,6 +273,8 @@ nx-sk entry get 张三
 `nx-sk serve` → 每个栏目一个 tab，共用同一个条目视图：
 
 - 左侧条目列表（带完整度），右侧按分组渲染的字段表单；
+- **「栏目」页的「编辑」弹窗能改整个结构**：分组可新增 / 改名（含换 id）/ 上下挪 / 删（空的才让删），
+  字段可改标签、类型、分组、提示、必填策略、组内上下挪、删除 —— 一次改动一次落盘；
 - 密文字段默认显示原文；「打码显示（投屏/截图时用）」勾选等价于 `--mask`（选择持久化在 localStorage）；
 - 保存是 **PATCH**：只有被你改动过的字段才会发出去（面板会显示「N 处改动」）；
 - 每个页面底部会派生显示该模块的 CLI 等价命令（可点击复制）。

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-sk",
-  "version": "0.20.0",
+  "version": "0.23.1",
   "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": {

package/src/core/source.js

@@ -7,7 +7,9 @@
 //   { id, kind, name, text?, fileId?, url?, addedAt, at?, note?, mapped?,
 //     superseded?, supersededBy?, supersedes? }
 //
-//   kind   text = 粘贴进来的文字；file = 附件库里的原件（fileId）；url = 一个网址
+//   kind   text = 粘贴进来的**markdown**（图片内嵌在正文里，`![说明](f_xxx)` / 外链
+//              `![说明](https://…)`——聊天记录图文混排，图和文不能分开存）；
+//          file = 附件库里的原件（fileId）；url = 一个网址
 //   name   人读的名字（用户可改），默认从内容推断
 //   mapped 整理去向：这条资料已经被同步到哪些字段 key（双向同步的锚点）
 //   at     **资料自身的时间**（如邮件时间）；缺省用 addedAt（入袋时间）
@@ -15,11 +17,12 @@
 //
 // 三条纪律写在代码里，不只是文档：
 //   1. **只增不删**——袋里的东西是原始证据，整理完也留着（要删由人显式做）。
-//   2. **原文不改写**——text 原样存，整理后的结果写进**字段**或写进新的一条，
-//      不就地改写原件（否则「原始」这个词就没意义了）。
+//   2. **原文不改写**——text 原样存（底层是 markdown；面板上改是**人显式**点了「编辑」），
+//      整理后的结果写进**字段**或写进新的一条，不就地改写原件（否则「原始」这个词就没意义了）。
 //   3. **冲突以新的为准，但旧的留痕**——同名即冲突（同一件事有了新版本）：
 //      时间新的那条是「当前版本」，旧的被标 `superseded` 但**仍留在袋里**。
 import { newId, nowIso } from './ids.js';
+import { mdImageIds, parseMdImages } from './mdimages.js';
 
 export const SOURCE_KINDS = ['text', 'file', 'url'];
 
@@ -47,12 +50,24 @@ export function sourceItemTime(item) {
   return Number.isFinite(t) ? t : 0;
 }
 
+/**
+ * 从一段 markdown 里推断人读标题：逐个非空行去掉图片语法后取第一个还有字的——
+ * 聊天记录的第一行常常**只是一张图**（`![截图](f_xxx)`），跳过它才能落到人话上。
+ */
+function firstLineTitle(text, fallback = '一段文字') {
+  for (const line of String(text || '').split('\n')) {
+    if (!line.trim()) continue;
+    const stripped = line.replace(/!\[([^\]]*)\]\(\s*[^)\s]+\s*\)/g, '').trim();
+    if (stripped) return stripped.slice(0, 40);
+  }
+  return fallback;
+}
+
 function inferName(item) {
   if (item.name) return String(item.name).trim();
   if (item.kind === 'url') return String(item.url || '').slice(0, 60);
   if (item.kind === 'file') return String(item.fileId || '附件');
-  const first = String(item.text || '').split('\n').find((l) => l.trim()) || '';
-  return first.trim().slice(0, 40) || '一段文字';
+  return firstLineTitle(item.text);
 }
 
 /**
@@ -170,15 +185,40 @@ export function currentSourceItems(items) {
   return (items || []).filter((x) => !x.superseded);
 }
 
-/** 一条 item 的人读摘要（CLI 一行一条、面板清单副标题都用它）。 */
+/**
+ * 一条 item 的人读摘要（CLI 一行一条、面板清单副标题都用它）。
+ *
+ * text 的底层是 **markdown**（图片内嵌在正文里，`![说明](f_xxx)` / `![说明](https://…)`）：
+ * 摘要里把图片语法压成 `[图: 说明]`——一行摘要里出现一串 `![截图](f_mvts…)` 没人读得下去。
+ */
 export function sourceItemSummary(item) {
   if (!isSourceItem(item)) return '';
   if (item.kind === 'url') return item.url || '';
   if (item.kind === 'file') return `附件 ${item.fileId}`;
-  const t = String(item.text || '').replace(/\s+/g, ' ').trim();
+  const t = String(item.text || '').replace(/!\[([^\]]*)\]\(\s*[^)\s]+\s*\)/g, (_m, alt) => `[图: ${alt || '图'}]`).replace(/\s+/g, ' ').trim();
   return t.length > 80 ? `${t.slice(0, 80)}…` : t;
 }
 
+/** 这条（或这袋）资料里内嵌的附件图片 id —— 打包导出与完整性检查都用它。 */
+export function sourceImageIds(items) {
+  const out = [];
+  const seen = new Set();
+  for (const item of items || []) {
+    if (!isSourceItem(item) || item.kind !== 'text' || !item.text) continue;
+    for (const id of mdImageIds(item.text)) {
+      if (seen.has(id)) continue;
+      seen.add(id);
+      out.push(id);
+    }
+  }
+  return out;
+}
+
+/** 正文里的 `![alt](f_xxx)` 引用（保序，含外链）。面板解析图片、CLI 渲染都用它。 */
+export function sourceItemImages(text) {
+  return parseMdImages(text);
+}
+
 /** 人读时间：优先资料自身的时间（at），否则入袋时间。 */
 export function sourceItemTimeLabel(item) {
   const raw = item?.at || item?.addedAt || '';

package/src/modules/entries/service.js

@@ -878,17 +878,26 @@ function sourceItemsOf(entry) {
 }
 
 /** 袋里引用的附件解析（名字 / 物理路径 / 链接）——否则只剩一串 f_xxx。 */
+/**
+ * source 涉及的附件：file item 指向的 + **text（markdown）正文里内嵌的** `![x](f_xxx)`。
+ * 渲染（面板解析图片 / CLI 把 id 还原成路径）与完整性检查都以这份为准。
+ */
 function sourceFiles(store, items) {
   const files = {};
-  for (const item of items) {
-    if (item.kind !== 'file' || !item.fileId || files[item.fileId]) continue;
-    const rec = att.findFileRecord(store, item.fileId);
-    if (!rec) continue;
+  const put = (id) => {
+    if (!id || files[id]) return;
+    const rec = att.findFileRecord(store, id);
+    if (!rec) return;
     const links = att.fileLinks(rec);
-    files[item.fileId] = {
+    files[id] = {
       id: rec.id, name: rec.name, ext: rec.ext, isImage: att.isImageExt(rec.ext),
       path: displayPath(att.fileRecordAbs(rec)), url: links.url, downloadUrl: links.downloadUrl,
     };
+  };
+  for (const item of items) {
+    if (item.kind === 'file' && item.fileId) put(item.fileId);
+    // text 的底层是 markdown：正文里内嵌的 `![x](f_xxx)` 也是正式引用
+    else if (item.kind === 'text' && item.text) for (const id of mdImageIds(item.text)) put(id);
   }
   return files;
 }
@@ -1123,7 +1132,10 @@ export function renderSourceGet(d) {
       const f = d.files?.[item.fileId];
       lines.push(`      ${f ? `${f.name}　${f.path}` : `附件 ${item.fileId}（库里已不存在）`}`);
     } else if (item.kind === 'text') {
-      for (const line of String(item.text).split('\n')) lines.push(`      ${line}`);
+      // text 的底层是 markdown：图片引用还原成「[图片: 说明] 本地路径」，外链标注「外链」——
+      // CLI 没法显示图，但读者要知道这里本来有图、图在哪。
+      const text = rewriteMdImages(item.text, (id) => d.files?.[id] || null);
+      for (const line of String(text).split('\n')) lines.push(`      ${line}`);
     } else if (item.kind === 'url') {
       lines.push(`      ${item.url}`);
     }

package/src/modules/sections/index.js

@@ -77,7 +77,7 @@ export default {
       id: 'section.update',
       cli: ['section', 'update'],
       http: ['PATCH', '/api/sections/:ref'],
-      summary: '改栏目（PATCH 语义：只改传入项）。字段台账可用 add-field / remove-field / fields / fill；--kv 标成 KV 表',
+      summary: '改栏目（PATCH 语义：只改传入项）。**整个结构都能改**：分组用 add-group / rename-group / move-group / remove-group，字段用 add-field / set-field / move-field / remove-field / fields / fill；--kv 标成 KV 表',
       args: ['ref'],
       flags: {
         title: { type: 'string' },
@@ -89,7 +89,13 @@ export default {
         fields: { type: 'json', hint: '整体替换字段字典' },
         groups: { type: 'json', hint: '整体替换分组' },
         'add-field': { type: 'json', hint: '{"key":"x","label":"X","type":"text"}，可重复' },
+        'set-field': { type: 'json', hint: '改已有字段：{"key":"phone","label":"手机号"}（key 不可改），可重复' },
+        'move-field': { type: 'json', hint: '{"key":"phone","dir":"up|down"}：在自己的分组内换位置，可重复' },
         'remove-field': { type: 'array', hint: '字段 key，可重复传（一次删一个）' },
+        'add-group': { type: 'json', hint: '{"id":"contact","title":"联系信息"}，可重复' },
+        'rename-group': { type: 'json', hint: '{"id":"contact","title":"联系方式"}，换 id 再加 "newId"，可重复' },
+        'move-group': { type: 'json', hint: '{"id":"contact","dir":"up|down"}，可重复' },
+        'remove-group': { type: 'array', hint: '分组 id，可重复。**非空不给删**，内置「原始资料」不可删' },
         fill: { type: 'kv', hint: '字段=normal|optional|avoid，可重复。optional 不必填、avoid 填了可能减分，两者都不计入完整度；改回照常填传 normal' },
         'dry-run': { type: 'boolean' },
       },