nx-sk 0.7.1 → 0.8.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 本文件格式参考 [Keep a Changelog](https://keepachangelog.com/)，中文正文。
 
+## [0.8.1] - 2026-10-15
+
+### Added
+
+- **条目里的附件字段框支持拖拽上传**：把文件（可多个）直接拖进 `file` 字段框即上传并追加到列表，悬停时虚线描边提示（与「附件」中心同一套视觉语言）；超过 `maxItems` 上限时拖入会明确提示。之前只有「附件」中心页支持拖拽。
+
+## [0.8.0] - 2026-10-13
+
+### Added
+
+- **`file` 字段支持多附件：值 = 附件 id 的列表**。一个字段可以挂**多个**附件（简历多版本、头像多张、证书多份）——CLI 逗号分隔（`--set 简历附件=f_aaa,f_bbb`）或 `--data` 传 JSON 数组；面板字段控件改成**列表**：一次**多选**上传、从附件库逐个追加、逐行移除（下载 / 复制路径照旧）。
+  - **新写入统一存数组**（哪怕只有一个）——`entry get --json` 与导出里 `file` 字段的值形状一致；**历史单值字符串原样兼容**（读、反查、搜索、面板编辑都按「单元素列表」处理），不做数据迁移，下次在面板编辑保存后统一成数组。
+  - 反查 / 搜索 / 渲染全部按列表走：列表里的**任一**附件都能被 `file get` 反查到「被引用」；按**任一**附件名都能搜到条目；`entry get` 里多个附件各占一行（附件名 + 物理路径）。
+  - 数量上限复用 `maxItems`（与 `tags` 同一套属性与报错口径，默认不限）；未登记的键写入 `f_` 形态的值会自动登记成**附件字段**（而不是文本 / tags）。
+
 ## [0.7.1] - 2026-10-13
 
 ### Changed

package/README.md

@@ -173,15 +173,17 @@ nx-sk file restore f_xxxx                        # 可逆：移回原始位置
 nx-sk file restore f_xxxx --to "D:\资料" --copy  # 或导出副本到指定目录
 ```
 
-**附件怎么被条目引用**：条目的 `file` 字段存的就是**附件的 id**。id 全局唯一，
-所以每条条目各有各的附件、互不串台；同一份原件也能被多条条目引用（sha256 去重后是同一条）。
+**附件怎么被条目引用**：条目的 `file` 字段存的是**附件 id 的列表**——一个字段可以挂**多个**
+附件（简历多版本、头像多张）。id 全局唯一，所以每条条目各有各的附件、互不串台；
+同一份原件也能被多条条目引用（sha256 去重后是同一条）。
 **上传 / 选择发生在栏目条目的字段里**（求职 → 张三 → 「简历附件」直接上传或从库里选），
 不在附件中心做指派：
 
 ```bash
 FID=$(nx-sk file add --path "D:\简历\张三-简历.pdf" --json | 取 id)
-nx-sk entry update 张三 --set resumeFile=$FID   # 字段值就是附件 id
-nx-sk entry get 张三 --section job              # 该字段随即显示附件名与物理路径
+nx-sk entry update 张三 --set resumeFile=$FID       # 挂一个（存成单元素数组）
+nx-sk entry update 张三 --set resumeFile=$FID,f_xxx # 逗号分隔挂多个
+nx-sk entry get 张三 --section job              # 每个附件各占一行：附件名 + 物理路径
 nx-sk file get $FID                             # 反查「被引用：求职 / 张三 / 简历附件」
 ```
 
@@ -265,7 +267,7 @@ nx-sk skill get nx-sk 10-sections-entries   # 裸名 → references/10-sections-
 ## 开发
 
 ```bash
-pnpm test        # = lint + build + 冒烟（99 项断言） + 单测（127 项）
+pnpm test        # = lint + build + 冒烟（104 项断言） + 单测（132 项）
 ```
 
 | 目录 | 职责 |

package/assets/nx-sk/SKILL.md

@@ -16,12 +16,16 @@ description: 本机个人资源管理器——栏目化存储个人信息（求
 
 ## 核心不变量
 
-1. **栏目 = 一组同构条目 + 一份字段台账。台账是数据，不是代码。**
-   字典随栏目存在 store 里，所以 agent 与面板看到的字段永远一致。
-   **它不拦写入**：`--set 任意键=值` 一律能存，没见过的键会自动登记（键名就是它本身，
-   中文也可以）。台账的用处是「模板建议 + 你实际写过什么」，不是门禁。
-   *违反会怎样*：如果把它做成门禁，用户每换一个表单就要先改一次 schema ——
-   而那正是「只想存个 kv」时最不想付的成本。
+1. **结构归栏目，值归条目：栏目持有「固定的结构」，条目只装「值」。**
+   每个栏目持有一份**字段台账**（分组 + 字段：key / 中文标签 / 类型 / 是否密文 / 填写策略），
+   它是**数据不是代码**、随栏目存在 store 里，所以 agent 与面板看到的字段永远一致——
+   「这个栏目有哪些字段」永远只有一个答案，在栏目里；条目里的每一把键都能在那儿找到。
+   **台账不拦写入**：`--set 任意键=值` 一律能存，没见过的键会**自动登记**进台账
+   （键名就是它本身，中文也可以）——写新字段不必先改 schema，但**必须登记**：
+   没进台账的值，面板按台账渲染时**看不见**（像「存了却没生效」）。
+   台账的用处是「模板建议 + 你实际写过什么」，不是门禁。
+   *违反会怎样*：反过来把它做成门禁，用户每换一个表单就要先改一次 schema ——
+   而那正是「只想存个 kv」时最不想付的成本；而不登记就往条目里塞值，存了也看不见。
 
 2. **一条 action 同时声明 CLI 与 HTTP。** 面板上能做的，CLI 都能做；两边参数名、错误码一致。
    *违反会怎样*：只能靠字符串匹配猜错误，无法可靠分支。
@@ -77,12 +81,14 @@ nx-sk file open f_xxxx                          # 系统默认程序打开原件
 ```
 
 求职条目里的「简历附件 / 头像图片 / 成绩单 / 证书扫描件」是 `file` 字段，
-它的值就是**附件 id**（全局唯一 → 各条目互不串台；同内容去重后是同一条，可被多条条目共享）：
+它的值是**附件 id 的列表**——一个字段可以挂**多个**附件（简历多版本、头像多张）
+（id 全局唯一 → 各条目互不串台；同内容去重后是同一条，可被多条条目共享）：
 
 ```bash
-nx-sk entry update 张三 --set resumeFile=f_xxxx   # 字段值 = 附件 id
-nx-sk entry get 张三 --section job                # 字段随即显示附件名与物理路径
-nx-sk file get f_xxxx                             # 反查「被引用：求职 / 张三 / 简历附件」
+nx-sk entry update 张三 --set resumeFile=f_aaa,f_bbb   # 逗号分隔挂多个（也接受 --data 传数组）
+nx-sk entry update 张三 --set resumeFile=f_aaa         # 只挂一个（存下来也是单元素数组）
+nx-sk entry get 张三 --section job                # 每个附件各占一行：附件名 + 物理路径
+nx-sk file get f_bbb                              # 反查「被引用：求职 / 张三 / 简历附件」
 ```
 
 **上传 / 选择发生在栏目条目里**（Web 的表单字段可直接「上传文件」或从库里选）；

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

@@ -11,8 +11,12 @@ store.json（~/nx-sk/store.json 或 $NX_SK_STORE）
 └─ entries[]                条目：id(e_xxx) / section / title / tags[] / values{字段key: 值} / 时间戳
 ```
 
-- 一个**栏目** = 一组同构条目 + 一份字段字典（`groups[]` 分组、`fields[]` 字段定义）。
-- 一个**条目** = 一行数据，值放在 `values` 里，键是字段 `key`。
+- **结构与值分家**：栏目持有**结构**（`groups[]` 分组 + `fields[]` 字段定义），条目只持有**值**
+  （`values{字段 key: 值}`）。所以「这个栏目有哪些字段」永远只有一个答案，在栏目里；
+  条目里的每一把键都能在那儿找到。
+- 一个**栏目** = 一组同构条目 + 一份字段字典（**固定的结构**）。
+- 一个**条目** = 一行数据，值放在 `values` 里，键是字段 `key`；写台账里没有的键会**自动登记**
+  （见第五节）——**登记过的键面板才渲染得出来**，没登记的值在界面上看不见。
 - 定位方式都放宽：栏目与条目**都接受 id 或名字**。条目名重名时报 `CONFLICT` 让你改用 id。
 
 ## 二、栏目命令（集合资源，五操作齐备）
@@ -116,11 +120,11 @@ nx-sk section update job --fields @fields.json
 ```
 
 字段定义支持：`key`（字母开头）、`label`、`type`（`text|textarea|number|date|month|bool|select|tags|secret|file`）、
-`group`、`hint`、`options`（候选项）、`sensitive`（true 则密文落盘）、`maxItems`（tags 上限）、
+`group`、`hint`、`options`（候选项）、`sensitive`（true 则密文落盘）、`maxItems`（tags / file 上限）、
 `fill`（填写策略，见下）。
 
-> `type: 'file'` 是**附件字段**：值存的是一个**附件 id**（不是路径），导入原件、附件库台账、
-> 以及「文件统一放 `~/nx-sk/files/`」的完整口径见 `40-files`。
+> `type: 'file'` 是**附件字段**：值 = 附件 id 的**列表**（一个字段可挂多个；不是路径），
+> 导入原件、附件库台账、以及「文件统一放 `~/nx-sk/files/`」的完整口径见 `40-files`。
 
 > `select` 的 `options` 是**候选项不是白名单**：真实值（如某个少数民族）不在候选里也允许写入。
 

package/assets/nx-sk/references/40-files.md

@@ -9,12 +9,12 @@
 ```
 ~/nx-sk/files/<分类>/            二进制原件（真实文件，移动/复制进来的）
 ~/nx-sk/store.json 的 files[]    台账：id / name / rel / ext / bytes / sha256 / 标签 / 备注
-~/nx-sk/store.json 的 entries[].values[<file字段>] = f_xxxx   ← 链接：字段值就是附件 id
+~/nx-sk/store.json 的 entries[].values[<file字段>] = [f_xxxx, …]   ← 链接：字段值 = 附件 id 列表（可挂多个）
 ```
 
 - 一个**附件** = 一次导入的原件 + 一条台账记录。物理文件永远以台账 `rel` 为准。
-- 条目里的 `file` 字段（如 `resumeFile` / `avatar`），**值就是附件 id**（形如 `f_xxxx`）。
-  id 全局唯一 → 各条目的附件空间天然隔离；同一个原件（sha256 相同）**去重**后是同一条，
+- 条目里的 `file` 字段（如 `resumeFile` / `avatar`），**值就是附件 id 的列表**（形如 `[f_xxxx, …]`；
+  一个字段可挂多个）。id 全局唯一 → 各条目的附件空间天然隔离；同一个原件（sha256 相同）**去重**后是同一条，
   可被多条条目共享，不重复占空间。
 - **上传 / 选择发生在栏目条目里**；「附件」中心只负责统一展示与库存管理，不做指派。
 
@@ -49,24 +49,29 @@ nx-sk file add --path C:\扫描\成绩单.pdf --tags 成绩单 --note "教务处
 - 同 sha256 的文件直接复用已有记录（返回 `duplicated`），不会重复占空间。
 - `file add --dry-run` 只计算落点与校验，不移动、不写台账。
 
-## 四、链接：`file` 字段值 = 附件 id
+## 四、链接：`file` 字段值 = 附件 id 的**列表**（可挂多个）
 
-条目**不复制文件**，只存一个附件 id。把 id 写进栏目里 `file` 类型的字段，链接就建立了：
+条目**不复制文件**，只存附件 id。把 id 写进栏目里 `file` 类型的字段，链接就建立了；
+**一个字段可以挂多个附件**（简历多个版本、头像多张、证书多份），值是 id 的数组：
 
 ```bash
 # 先拿到附件的 id（file add 的输出 / file list --json 里的 files[].id）
 nx-sk file add --path "D:\简历\张三-简历.pdf" --category resume
 
-nx-sk entry update 张三 --set resumeFile=f_xxxx   # 字段值 = 附件 id
-nx-sk entry get 张三 --section job                # 该字段随即显示附件名与物理路径
+nx-sk entry update 张三 --set resumeFile=f_aaa,f_bbb   # 逗号分隔 = 挂两个（也可用 --data 传 JSON 数组）
+nx-sk entry update 张三 --set resumeFile=f_aaa          # 只挂一个（存下来也是单元素数组）
+nx-sk entry get 张三 --section job                # 每个附件各占一行：附件名 + 物理路径
 
 # 反查：这个附件被哪些栏目 / 条目 / 字段引用
-nx-sk file get f_xxxx
+nx-sk file get f_bbb
 #   被引用: 求职 / 张三 / 简历附件
 ```
 
-求职条目里的「简历附件 / 头像图片 / 成绩单 / 证书扫描件」就是 `file` 字段。
-**别用文件名或路径去填** —— 值只认附件 id；填了别的东西条目侧会显示成「未解析」。
+- 求职条目里的「简历附件 / 头像图片 / 成绩单 / 证书扫描件」就是 `file` 字段。
+- **别用文件名或路径去填** —— 值只认附件 id；填了别的东西条目侧会显示成「未解析」。
+- 需要限制个数时给字段配 `maxItems`（与 `tags` 同一套；不配 = 不限）。
+- 老数据里存的**单个 id 字符串**原样兼容：读、反查、搜索、面板编辑都按「单元素列表」处理，
+  不需要迁移；下一次在面板里编辑该字段保存后，会统一成数组。
 
 ## 五、还原（可逆）
 
@@ -92,7 +97,8 @@ nx-sk file restore f_xxxx --to "D:\资料"          # Web 上传件没有原始
 - **组织方式由栏目驱动、不预定义分类**：筛选片按「哪些栏目在引用附件」动态生成（外加「未引用」），
   每张卡片显示被哪个栏目 / 条目 / 字段引用；
 - 编辑弹窗可改名称 / 分类 / 标签 / 备注（改分类或文件名时物理原件随之移动）；
-- 条目表单里的 `file` 字段可直接「上传文件」或从库里选一个，保存即建立链接。
+- 条目表单里的 `file` 字段是**列表**：文件可直接**拖进字段框**（可多选）、点「上传文件」多选、
+  从库里逐个追加、逐行移除；保存即建立链接。
 
 ## 七、看不到 `file` 上传字段 / 条目里解析不到附件
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nx-sk",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "description": "nx-sk · 本机个人资源管理器（server-cli-web 骨架）：栏目化存储个人信息与大模型密钥，CLI 与 Web 同源，敏感字段密文落盘。",
   "type": "module",
   "bin": {

package/src/core/attachments.js

@@ -127,6 +127,26 @@ export function normalizeFileRecord(raw) {
   };
 }
 
+/**
+ * 一个 `file` 字段的值 → 附件 id 数组（**全仓库唯一的归一化入口**）。
+ *
+ * 字段可以挂**多个**附件：新写入统一存数组（哪怕只有一个）；历史数据里的单值是
+ * 字符串，读的时候按「单元素列表」看待——所以这里两种情况都要吃。
+ * 去空、去重、保序：同一个附件在一个字段里出现两次没有意义。
+ */
+export function fileIdsOf(value) {
+  const raw = value === null || value === undefined
+    ? []
+    : (Array.isArray(value) ? value : [value]);
+  const out = [];
+  for (const x of raw) {
+    const s = String(x ?? '').trim();
+    if (!s || out.includes(s)) continue;
+    out.push(s);
+  }
+  return out;
+}
+
 /** 附件定位：id 优先，其次唯一文件名。 */
 export function findFileRecord(store, ref) {
   const key = String(ref ?? '').trim();
@@ -140,8 +160,9 @@ export function findFileRecord(store, ref) {
 
 /**
  * 反向链接：哪些条目的 `file` 字段引用了这个附件。
- * 条目里 `file` 字段的值 = 附件 id（或唯一文件名），所以按记录反查即可。
- * 附件中心据此显示「被哪些栏目 / 条目 / 字段用到」——**完全由栏目驱动**，不预定义结构。
+ * 条目里 `file` 字段的值 = 附件 id（或唯一文件名）；一个字段可挂多个，
+ * 所以这里按 `fileIdsOf` 逐个成员判断——列表里的**任一** id 都能反查到，
+ * 同一个（条目, 字段）只出一条。附件中心据此显示「被哪些栏目 / 条目 / 字段用到」。
  */
 export function fileReferences(store, rec) {
   if (!rec) return [];
@@ -152,9 +173,9 @@ export function fileReferences(store, rec) {
     for (const e of store.entries || []) {
       if (e.section !== sec.id) continue;
       for (const f of fileFields) {
-        const v = String(e.values?.[f.key] ?? '').trim();
-        if (!v) continue;
-        if (findFileRecord(store, v) !== rec) continue;
+        const ids = fileIdsOf(e.values?.[f.key]);
+        if (!ids.length) continue;
+        if (!ids.some((id) => findFileRecord(store, id) === rec)) continue;
         out.push({
           sectionId: sec.id, sectionTitle: sec.title,
           entryId: e.id, entryTitle: e.title,

package/src/core/fields.js

@@ -128,11 +128,11 @@ const JOB_FIELDS = [
   f('acceptAdjustment', '是否接受调剂', 'bool', 'job', { hint: '是否接受岗位或城市调剂' }),
   f('jobNote', '求职备注', 'textarea', 'job', { hint: '补充说明' }),
 
-  // —— 附件资料（统一附件库；值 = 附件 id，直接在字段里上传或从附件库选一个） ——
-  f('resumeFile', '简历附件', 'file', 'files', { kind: 'doc', hint: '简历 PDF/Word 原件；在本字段直接上传，或从附件库选一个' }),
-  f('avatar', '头像图片', 'file', 'files', { kind: 'image', hint: '证件照/头像图片原件' }),
-  f('transcript', '成绩单', 'file', 'files', { kind: 'doc', hint: '在校成绩单原件' }),
-  f('certificateScan', '证书扫描件', 'file', 'files', { kind: 'doc', fill: 'optional', hint: '获奖/资格证书扫描件（不必填）' }),
+  // —— 附件资料（统一附件库；值 = 附件 id 的**列表**，一个字段可挂多个，直接在字段里上传或从附件库选） ——
+  f('resumeFile', '简历附件', 'file', 'files', { kind: 'doc', hint: '简历 PDF/Word 原件；可传多个（不同版本/岗位），在本字段直接上传或从附件库选' }),
+  f('avatar', '头像图片', 'file', 'files', { kind: 'image', hint: '证件照/头像图片原件；可传多张' }),
+  f('transcript', '成绩单', 'file', 'files', { kind: 'doc', hint: '在校成绩单原件；可传多个学期' }),
+  f('certificateScan', '证书扫描件', 'file', 'files', { kind: 'doc', fill: 'optional', hint: '获奖/资格证书扫描件；可传多份（不必填）' }),
 
   // —— 其他 ——
   f('religion', '宗教信仰', 'text', 'extra', { hint: '没有就写「无」' }),

package/src/modules/entries/service.js

@@ -103,11 +103,17 @@ function normalizeValue(def, raw) {
     return list;
   }
   if (type === 'file') {
-    // 值 = 附件 id（或唯一文件名）。id 全局唯一，天然做到「各条目附件互不串台」；
-    // 同一份原件被多条条目引用也没问题（sha256 去重后是同一个 id）。
+    // 值 = 附件 id（或唯一文件名）的**列表**：一个字段可以挂多个附件（简历传多个版本、
+    // 头像多张）。id 全局唯一，天然做到「各条目附件互不串台」；同一份原件被多条条目引用
+    // 也没问题（sha256 去重后是同一个 id）。
+    // **新写入统一存数组**（哪怕只有一个）——形状一致，下游不必到处判「是串还是表」；
+    // 历史数据里的字符串单值读时由 fileIdsOf 按单元素处理，不做迁移。
     // 不校验存在性——附件可能被还原/删掉，前端按「引用的附件不存在」展示。
-    const s = String(raw).trim();
-    return s === '' ? null : s;
+    const list = att.fileIdsOf(Array.isArray(raw) ? raw : String(raw).split(/[,，、;；]+/));
+    if (def.maxItems && list.length > def.maxItems) {
+      throw badInput(`字段「${def.label}」最多 ${def.maxItems} 项，收到 ${list.length} 项`);
+    }
+    return list.length ? list : null;
   }
   const s = String(raw);
   return s.trim() === '' ? null : s;
@@ -136,8 +142,21 @@ async function prepareValue(section, def, raw, current) {
  * 18 位的身份证号 / 长数字 ID 超过 2^53，推成数字会**静默丢精度**。
  * 值仍是字符串，所以「直接存 kv」不会因为类型推断损坏数据。
  */
+// 值像不像附件 id（`f_xxxx`）。用来推断「写了一个没登记过的键」该登记成什么类型：
+// `--set 简历附件=f_abc` / `--set 简历附件=f_a,f_b` 应当登记成**附件字段**，
+// 而不是一个普通文本字段或 tags。
+const looksLikeFileId = (x) => typeof x === 'string' && /^f_[0-9a-z]+$/i.test(x.trim());
+
 function inferFieldType(raw) {
-  if (Array.isArray(raw)) return 'tags';
+  if (Array.isArray(raw)) {
+    if (raw.length && raw.every(looksLikeFileId)) return 'file';
+    return 'tags';
+  }
+  if (looksLikeFileId(raw)) return 'file';
+  if (typeof raw === 'string') {
+    const parts = raw.split(/[,，、;；]+/).map((x) => x.trim()).filter(Boolean);
+    if (parts.length && parts.every(looksLikeFileId)) return 'file';
+  }
   if (typeof raw === 'boolean') return 'bool';
   const s = String(raw).trim().toLowerCase();
   if (BOOL_TRUE.includes(s) || BOOL_FALSE.includes(s)) return 'bool';
@@ -183,10 +202,12 @@ export async function listEntries({ section, q } = {}) {
     if (!viewers.has(sec.id)) viewers.set(sec.id, await sensitiveViewer(sec, list.filter((x) => x.section === sec.id)));
     const item = serializeEntry(sec, e, { decrypt: viewers.get(sec.id) });
     if (q) {
-      // file 字段值是附件 id，把解析出的附件名也加进搜索文本，才能按「简历/成绩单」搜到条目
+      // file 字段值是附件 id（可能挂多个），把解析出的附件名都加进搜索文本，
+      // 才能按「简历/成绩单」搜到条目
       const fileNames = sec.fields
         .filter((f) => f.type === 'file')
-        .map((f) => att.findFileRecord(store, e.values?.[f.key])?.name || '');
+        .flatMap((f) => att.fileIdsOf(e.values?.[f.key])
+          .map((id) => att.findFileRecord(store, id)?.name || ''));
       const hay = [item.title, sec.title, ...fileNames,
         ...Object.values(item.values).map((v) => (v === null ? '' : Array.isArray(v) ? v.join(',') : String(v)))]
         .join('\n').toLowerCase();
@@ -204,18 +225,19 @@ export async function getEntry(ref, { mask, section } = {}) {
   if (!sec) throw notFound(`条目 ${entry.id} 指向的栏目已不存在: ${entry.section}`);
   const decrypt = await sensitiveViewer(sec, [entry]);
   const serialized = serializeEntry(sec, entry, { mask: !!mask, decrypt });
-  // 附带 file 字段引用的附件信息：键 = 字段值（即附件 id / 文件名），值为名称 / 路径 / 链接
+  // 附带 file 字段引用的附件信息：键 = 字段值（附件 id / 文件名），值为名称 / 路径 / 链接。
+  // 一个字段可挂多个附件，所以逐个 id 建表。
   const files = {};
   for (const f of sec.fields.filter((x) => x.type === 'file')) {
-    const ref = serialized.values[f.key];
-    if (!ref) continue;
-    const rec = att.findFileRecord(store, ref);
-    if (!rec) continue;
-    const links = att.fileLinks(rec);
-    files[ref] = {
-      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 ref of att.fileIdsOf(serialized.values[f.key])) {
+      const rec = att.findFileRecord(store, ref);
+      if (!rec) continue;
+      const links = att.fileLinks(rec);
+      files[ref] = {
+        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,
+      };
+    }
   }
   return { ...serialized, sectionTitle: sec.title, mask: !!mask, files };
 }
@@ -518,6 +540,21 @@ export function renderEntryList(d) {
   return lines.join('\n');
 }
 
+/**
+ * 一个字段值渲染成几行文本。
+ * - 附件（`file` 字段，值可能是 id 列表）：解析成「附件名　物理路径」，**几个占几行**
+ * - 其它数组（tags 之类）：仍旧一行、顿号连接——不要顺手把它们也拆成多行
+ */
+function valueLines(d, v) {
+  const asFile = (x) => (d.files && d.files[x] ? `${d.files[x].name}　${d.files[x].path}` : null);
+  if (Array.isArray(v) && v.length && v.every((x) => asFile(x))) return v.map(asFile);
+  const one = asFile(v);
+  if (one) return [one];
+  if (Array.isArray(v)) return [v.join('、')];
+  if (typeof v === 'boolean') return [v ? '是' : '否'];
+  return [String(v)];
+}
+
 export function renderEntryGet(d) {
   const c = d.completeness || {};
   const lines = [
@@ -527,11 +564,9 @@ export function renderEntryGet(d) {
   ];
   for (const [k, v] of Object.entries(d.values)) {
     if (v === null) continue;
-    if (d.files && d.files[v]) {
-      lines.push(`  ${k.padEnd(24)} ${d.files[v].name}　${d.files[v].path}`);
-      continue;
-    }
-    lines.push(`  ${k.padEnd(24)} ${Array.isArray(v) ? v.join('、') : (typeof v === 'boolean' ? (v ? '是' : '否') : String(v))}`);
+    const rendered = valueLines(d, v);
+    lines.push(`  ${k.padEnd(24)} ${rendered[0]}`);
+    for (const extra of rendered.slice(1)) lines.push(`  ${' '.repeat(24)} ${extra}`);
   }
   if (d.missing.length) {
     lines.push('', `未填（${d.missing.length}）: ${d.missing.map((m) => `${m.label}(${m.key})`).join('、')}`);

package/src/web/frontend/components/fieldEditor.jsx

@@ -36,61 +36,126 @@ function AutoTextarea({ value, onChange, minRows = 2, placeholder, disabled, max
 }
 
 /**
- * file 字段控件：值 = 附件 id。
- * **上传 / 选择就发生在这里**（栏目条目的字段里）——「文件在栏目中链接」；
- * 「附件」中心只负责统一展示与库存管理，不在这里做指派，也不预定义任何槽位。
+ * 字段值 → 附件 id 数组。
+ * 一个 `file` 字段可挂**多个**附件：新写入统一存数组，历史数据里的单值是字符串
+ * （读时按单元素处理）。前端不能 import core，所以这里自带一份同口径的归一化。
+ */
+function toIds(value) {
+  const raw = value === null || value === undefined ? [] : (Array.isArray(value) ? value : [value]);
+  const out = [];
+  for (const x of raw) {
+    const s = String(x ?? '').trim();
+    if (s && !out.includes(s)) out.push(s);
+  }
+  return out;
+}
+
+/**
+ * file 字段控件（**多值**）：值 = 附件 id 的列表，一个字段能挂多个附件
+ * （简历多版本、头像多张……）。
+ *
+ * **上传 / 选择就发生在这里**（「文件在栏目中链接」）；「附件」中心只负责统一展示与
+ * 库存管理，不在这里做指派，也不预定义任何槽位。
+ * 列表逐行显示：缩略图/扩展名徽标 + 名称（内联预览）+ 下载 + 复制物理路径 + 移除；
+ * 底部是添加入口（可**多选**上传、或从库里选一个追加）。
  */
 export function FileFieldControl({ def, value, onChange }) {
   const { toast, guard, patchUi } = useStore();
   const [data, setData] = useState(null);
+  const [dragOver, setDragOver] = useState(false);
   const uploadRef = useRef(null);
-  const id = value || '';
+  // dragenter/dragleave 在子元素间穿梭时会成对触发，用深度计数避免「还没离开就熄掉高亮」
+  const dragDepth = useRef(0);
+  const ids = toIds(value);
+  const max = Number(def.maxItems) || 0;
+  const full = max > 0 && ids.length >= max;
 
   const load = useCallback(async () => {
     try { setData(await listAttachments()); } catch { /* 附件库读不到时仍可上传 */ }
   }, []);
   useEffect(() => { load(); }, [load]);
 
-  const current = (data?.files || []).find((f) => f.id === id) || null;
+  const all = data?.files || [];
+  const byId = (id) => all.find((f) => f.id === id) || null;
+  const available = all.filter((f) => !ids.includes(f.id));
 
   const upload = guard(async (fileList) => {
-    const file = fileList?.[0];
-    if (!file) return;
-    const content = await fileToDataUrl(file);
-    const r = await api('/api/files', { method: 'POST', body: { content, name: file.name } });
-    onChange(r.id);
-    toast(r.duplicated ? '库中已有相同文件，已直接引用' : '已上传并关联');
+    const picked = [...(fileList || [])];
+    if (!picked.length) return;
+    if (full) { toast(`「${def.label}」最多 ${max} 个附件，先移除一个`, 'bad'); return; }
+    const next = [...ids];
+    let duplicated = 0;
+    for (const file of picked) {
+      const content = await fileToDataUrl(file);
+      const r = await api('/api/files', { method: 'POST', body: { content, name: file.name } });
+      if (next.includes(r.id)) { duplicated += 1; continue; }
+      next.push(r.id);
+    }
+    onChange(next);
+    const added = picked.length - duplicated;
+    toast(duplicated
+      ? `已上传并关联 ${added} 个；${duplicated} 个库里已有，直接引用`
+      : `已上传并关联 ${picked.length} 个`);
     setData(await refreshAttachments());
   });
 
+  const add = (id) => { if (id && !ids.includes(id)) onChange([...ids, id]); };
+  const removeAt = (id) => onChange(ids.filter((x) => x !== id));
+
+  // 拖拽文件进字段框 = 直接上传并追加（与「附件」中心同一套手感）
+  const onDrop = guard(async (e) => {
+    dragDepth.current = 0;
+    setDragOver(false);
+    await upload(e.dataTransfer?.files);
+  });
+
   return (
-    <div className="file-picker">
-      {current ? (
-        <div className="file-preview">
-          {current.isImage
-            ? <img src={current.url} alt={current.name} />
-            : <span className="ext-badge" style={{ fontSize: 13, width: 40, textAlign: 'center' }}>{current.ext ? current.ext.slice(1).toUpperCase() : 'FILE'}</span>}
-          <a className="file-preview-name grow" href={current.url} target="_blank" rel="noreferrer" title={current.displayPath}>{current.name}</a>
-          <a className="btn small ghost" href={current.downloadUrl}>下载</a>
-          <Copyable className="hint" text={current.path} title="点击复制物理路径">路径</Copyable>
-          <button type="button" className="btn small ghost" onClick={() => onChange('')}>清除</button>
-        </div>
-      ) : null}
+    <div
+      className={`file-picker ${dragOver ? 'drag' : ''}`}
+      onDragEnter={(e) => { e.preventDefault(); dragDepth.current += 1; setDragOver(true); }}
+      onDragOver={(e) => e.preventDefault()}
+      onDragLeave={() => { dragDepth.current -= 1; if (dragDepth.current <= 0) { dragDepth.current = 0; setDragOver(false); } }}
+      onDrop={onDrop}
+    >
+      {ids.map((id) => {
+        const rec = byId(id);
+        if (!rec) {
+          return (
+            <div className="file-preview" key={id}>
+              <span className="hint bad grow">引用的附件已不存在（{id}）—— 重新上传，或移除。</span>
+              <button type="button" className="btn small ghost" onClick={() => removeAt(id)}>移除</button>
+            </div>
+          );
+        }
+        return (
+          <div className="file-preview" key={id}>
+            {rec.isImage
+              ? <img src={rec.url} alt={rec.name} />
+              : <span className="ext-badge" style={{ fontSize: 13, width: 40, textAlign: 'center' }}>{rec.ext ? rec.ext.slice(1).toUpperCase() : 'FILE'}</span>}
+            <a className="file-preview-name grow" href={rec.url} target="_blank" rel="noreferrer" title={rec.displayPath}>{rec.name}</a>
+            <a className="btn small ghost" href={rec.downloadUrl}>下载</a>
+            <Copyable className="hint" text={rec.path} title="点击复制物理路径">路径</Copyable>
+            <button type="button" className="btn small ghost" onClick={() => removeAt(id)}>移除</button>
+          </div>
+        );
+      })}
+      {!ids.length ? <span className="hint">还没有附件。</span> : null}
       <div className="file-pick-row">
-        <select value={id} onChange={(e) => onChange(e.target.value)}>
-          <option value="">（未选择：从附件库选一个）</option>
-          {(data?.files || []).map((f) => <option key={f.id} value={f.id}>{f.name}</option>)}
+        <select value="" disabled={full || !available.length} onChange={(e) => add(e.target.value)}>
+          <option value="">{available.length ? '（从附件库选一个，选中即追加）' : '（库里没有可再选的附件）'}</option>
+          {available.map((f) => <option key={f.id} value={f.id}>{f.name}</option>)}
         </select>
-        <button type="button" className="btn small" onClick={() => uploadRef.current?.click()}>上传文件</button>
+        <button type="button" className="btn small" disabled={full} onClick={() => uploadRef.current?.click()}>上传文件</button>
         <button type="button" className="btn small ghost" onClick={() => patchUi({ view: 'files' })}>附件中心</button>
         <input
           ref={uploadRef}
           type="file"
+          multiple
           style={{ display: 'none' }}
           onChange={(e) => { upload(e.target.files); e.target.value = ''; }}
         />
       </div>
-      {id && !current ? <span className="hint bad">引用的附件已不存在（{id}）—— 重新上传，或清除。</span> : null}
+      {full ? <span className="hint">已达上限（{max} 个）：先移除一个，或把字段的 maxItems 调大。</span> : null}
       {def.hint ? <span className="hint">{def.hint}</span> : null}
     </div>
   );

package/src/web/frontend/styles.css

@@ -384,6 +384,8 @@ a.file-name:hover { text-decoration: underline; }
 
 /* ── 字段里的附件选择器 ─────────────────────────────── */
 .file-picker { display: flex; flex-direction: column; gap: 4px; }
+/* 拖文件悬停在字段框上：与「附件」中心同一套视觉语言（虚线描边 + 浅底） */
+.file-picker.drag { outline: 2px dashed var(--ink); outline-offset: -4px; background: var(--soft); }
 .file-picker .file-pick-row { display: flex; flex-wrap: wrap; gap: 6px; align-items: center; }
 .file-picker select { flex: 1; min-width: 120px; }
 .file-preview {

package/src/web/public/assets/{files-2kd_BT_X.js → files-DMIKmyJN.js}

@@ -1 +1 @@
-import{a as l}from"./index-Dzp1e1hp.js";let r=null;function o(n=!1){return!n&&r||(r=l("/api/files").then(e=>e).catch(e=>{throw r=null,e})),r}function i(){return r=null,o(!0)}function u(n){return new Promise((e,a)=>{const t=new FileReader;t.onload=()=>e(t.result),t.onerror=()=>a(new Error("读取文件失败")),t.readAsDataURL(n)})}export{u as f,o as l,i as r};
+import{a as l}from"./index-DpX9p_OX.js";let r=null;function o(n=!1){return!n&&r||(r=l("/api/files").then(e=>e).catch(e=>{throw r=null,e})),r}function i(){return r=null,o(!0)}function u(n){return new Promise((e,a)=>{const t=new FileReader;t.onload=()=>e(t.result),t.onerror=()=>a(new Error("读取文件失败")),t.readAsDataURL(n)})}export{u as f,o as l,i as r};