nx-sk 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -4,6 +4,38 @@
 
 ## [Unreleased]
 
+## 0.17.0 (2026-10-25)
+
+**附件不再靠下拉框挑，孤儿附件能一键清，改动不用翻到页底才保存。**
+
+三处都是「长栏目 / 附件多了以后，原来的做法开始难受」逼出来的：
+
+### Added
+
+- **附件库选择面板**（字段里的 `file` 字段）：点「从附件库选…」打开的是
+  **可搜索的面板**，不是原生下拉框——库里几十个附件时，下拉框根本没法挑。
+  - **关键字搜索**：按名称 / 备注 / 标签过滤（Esc 关闭）；
+  - **未引用优先**：没有任何条目引用的原件排在前面（刚导入还没挂上去的就在最上面），
+    已被引用的排在后面并标注「已被 N 处引用」——仍然可选（同一原件可被多条条目共享）；
+  - 点一行即**追加**到本字段，可连点多个；已挂上的会从列表里消失。
+- **`nx-sk file cleanup`**：一键清理**未被任何条目引用**的附件（孤儿附件），
+  物理原件一并删除、不可撤销。判据与附件中心的「未引用」筛选片**完全同一套**
+  （`fileReferences` 为空）——两套判据会出现「筛选片里看不到、清理却删了」这种吓人的不一致。
+  有 `--dry-run`（先列清单）；没有可清的返回 `skipped`（不是失败）。
+  面板上：附件中心工具条「清理未引用（N）」，点了弹确认并报清数量。
+- **条目表单的保存按钮固定在右上角**：有改动时表单顶栏出现「N 处改动未保存 · 保存」，
+  且顶栏**吸顶**（`position: sticky`）——长栏目滚到一半也看得见保存，不必翻到表单最底。
+  底部的保存按钮保留；关标签页前会拦一下（`beforeunload`），改到一半不留神关掉不丢改动。
+
+### Changed
+
+- 字段里的 `file` 附件选择从原生 `<select>` 换成选择面板（原来只能在一堆选项里肉眼找）。
+
+### 测试
+
+- 新增用例：`file cleanup` 只删未被引用的附件，被引用的原样留下（物理文件也在），
+  试运行不动台账，反复清理不伤被引用的附件。
+
 ## 0.16.0 (2026-10-23)
 
 **凭据自动化：账号密码跟着场景走，直接渲染成配置文件。**

package/README.md

@@ -150,13 +150,14 @@ CLI 与 API 同源，skill 驱动 agent**。落到具体功能上：
 | `nx-sk routes [--module M] [--http "POST /api/entries"]` | 命令 ↔ 路由双向对照 |
 | `nx-sk section list \| get \| add \| update \| remove` | 栏目 CRUD |
 | `nx-sk section dump <id> [--mask]` | **一个栏目的全部信息**：字段台账 + 全部条目 + 每个条目的未填清单 |
-| `nx-sk section templates` | 内置模板（job / secret / projects / internships / campus / deploy） |
+| `nx-sk section templates` | 内置模板（job / secret / projects / internships / campus / deploy / platform / thesis） |
 | `nx-sk section sync <id> [--dry-run]` | 按模板**补齐**本栏目缺的分组与字段（只增不改不删）——模板演进后让老栏目追上 |
 | `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/`，同内容去重） |
 | `nx-sk file add --path <文件> [--copy] [--category C]` | 导入附件：**默认移动原件**，`--copy` 仅复制 |
 | `nx-sk file list [--section <栏目\|none>] [--q 关键字]` | 列附件：按「哪些栏目在引用」筛选（`none` = 未引用）；返回栏目汇总与存储目录 |
+| `nx-sk file cleanup [--dry-run]` | **一键清理未被任何条目引用的附件**（孤儿附件，物理原件一并删）；`--dry-run` 先看清单 |
 | `nx-sk file restore <id> [--to DIR] [--copy]` | **可逆**：移回原始位置并撤销台账；`--copy` 只导出副本 |
 | `nx-sk file content <id>` | 浏览器链接（内联预览 / `?download=1` 下载）；CLI 打印物理路径 |
 | `nx-sk file open <id>` | 用系统默认程序打开原件 |
@@ -238,6 +239,8 @@ node assets/nx-sk/scripts/render-config.js /tmp/e.json ./docker-compose.local.ym
 nx-sk file add --path "D:\简历\张三-简历.pdf"   # 默认移动原件进库
 nx-sk file list                                  # 台账：按栏目汇总 + 被引用情况
 nx-sk file list --section none                   # 只看还没有条目引用的
+nx-sk file cleanup --dry-run                     # 一键清理未引用附件：先看会删哪些
+nx-sk file cleanup                               # 真删（物理原件一起删，不可撤销）
 nx-sk file restore f_xxxx                        # 可逆：移回原始位置、撤销台账
 nx-sk file restore f_xxxx --to "D:\资料" --copy  # 或导出副本到指定目录
 ```
@@ -245,6 +248,16 @@ nx-sk file restore f_xxxx --to "D:\资料" --copy  # 或导出副本到指定目
 **附件怎么被条目引用**：条目的 `file` 字段存的是**附件 id 的列表**——一个字段可以挂**多个**
 附件（简历多版本、头像多张）。id 全局唯一，所以每条条目各有各的附件、互不串台；
 同一份原件也能被多条条目引用（sha256 去重后是同一条）。
+
+面板上的三处配合：
+
+- **字段里挑附件**：点「从附件库选…」打开的是**可搜索的选择面板**（不是下拉框）——
+  按名称 / 备注 / 标签过滤，**未引用的排在前面**（刚导入还没挂上去的原件就在最上面），
+  点一行即追加，可连点多个。
+- **附件中心一键清理**：「清理未引用（N）」删掉所有没有任何条目引用的附件
+  （判据与「未引用」筛选片同一套），物理原件一并删除，操作前弹确认。
+- **条目表单的保存按钮固定在右上角**：有改动时顶栏出现「N 处改动未保存 · 保存」，
+  长栏目滚到一半也看得见，不必翻到表单最底；关标签页前还会拦一下。
 **上传 / 选择发生在栏目条目的字段里**（求职 → 张三 → 「简历附件」直接上传或从库里选），
 不在附件中心做指派：
 

package/assets/nx-sk/SKILL.md

@@ -174,11 +174,21 @@ nx-sk key remove OPENAI_KEY               # 删除，不可撤销 → 先 nx-sk
 nx-sk file add --path "D:\简历\张三-简历.pdf"  # 默认把原件移动进库（--copy 仅复制）
 nx-sk file list                                 # 台账：按栏目汇总 + 被引用情况
 nx-sk file list --section none                  # 只看还没有条目引用的
+nx-sk file cleanup --dry-run                    # 一键清理未引用附件：先看会删哪些
+nx-sk file cleanup                              # 真删（物理原件一起删，不可撤销）
 nx-sk file restore f_xxxx                       # 可逆：移回原始位置并撤销台账
 nx-sk file restore f_xxxx --to DIR --copy       # 或导出副本、库中保留
 nx-sk file open f_xxxx                          # 系统默认程序打开原件
 ```
 
+**面板上对应三处**（用户在点，不必 agent 教，但知道行为更省事）：
+
+- 字段里挑附件：点「从附件库选…」是**可搜索的选择面板**，**未引用的排在前面**，
+  点一行即追加到本字段；
+- 附件中心：**「清理未引用（N）」**一键删掉所有没人引用的附件（判据与「未引用」筛选片同一套）；
+- 条目表单：**保存按钮固定在右上角**，有改动时顶栏出现「N 处改动未保存 · 保存」，
+  长栏目滚到一半也看得见（底部也还有一个）。
+
 求职条目里的「简历附件 / 头像图片 / 成绩单 / 证书扫描件」是 `file` 字段，
 它的值是**附件 id 的列表**——一个字段可以挂**多个**附件（简历多版本、头像多张）
 （id 全局唯一 → 各条目互不串台；同内容去重后是同一条，可被多条条目共享）：
@@ -286,7 +296,7 @@ nx-sk setting set --set 'navGroups=[]'   # 清空 = 全部栏目恢复平铺
 
 | ref                     | 何时读取                                                                                                                                                                                |
 | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `00-design`           | 想搞懂**心智模型**时——栏目=结构、条目=数据、内置字段是什么、动态栏目 + 动态条目怎么用、四个聚合点在哪儿、密文边界，以及**东西该往哪儿放**                                        |
+| `00-design`           | 想搞懂**心智模型**时——栏目=结构、条目=数据、内置字段是什么、动态栏目 + 动态条目怎么用、四个聚合点在哪儿、密文边界，以及**东西该往哪儿放**                                 |
 | `10-sections-entries` | **动手填/改信息时必读**——栏目与条目的完整命令、AI 补全个人信息的推荐流程、字段字典怎么扩、读命令与写命令的参数陷阱                                                              |
 | `20-secrets`          | 密文机制、密钥从哪来（环境变量 vs 本机密钥文件）、KV 表的语义、什么时候会解不开                                                                                                         |
 | `30-credentials`      | **做凭据自动化时读**——凭据归属哪个栏目、多组账号怎么建清单、跨栏目台账、把凭据渲染成 compose / k8s / .env 的完整流程与安全边界                                                  |

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

@@ -30,13 +30,30 @@
 | 打开 | `nx-sk file open <id>`（本机默认程序） |
 | 还原 | `nx-sk file restore <id> [--to DIR] [--copy]` |
 | 删除 | `nx-sk file remove <id>` |
+| **清理未引用** | `nx-sk file cleanup [--dry-run]` |
 
 - `file list --section <栏目>` 只看「被某栏目引用」的附件；`--section none` 只看**还没有任何条目引用**的。
 - `file content` 是浏览器链接：内联预览，加 `--download` 强制下载；CLI 侧打印物理路径与链接。
 - 所有写命令都支持 `--dry-run`；`file remove` 连物理原件一起删**不可撤销**——
   只想「拿出原件、库里留着」应该用 `file restore --copy`。
 
-## 三、导入：默认移动，`--copy` 才复制
+## 三、一键清理未引用的附件（孤儿附件）
+
+附件库是「导入即进库」：批量导入 SOP 截图、临时传一份再删，都会留下**没人引用的原件**——
+既占空间，又在附件中心混在真资料里。逐个删是折磨。
+
+```bash
+nx-sk file cleanup --dry-run    # 先看会删哪些（名字 / 体积 / 物理路径）
+nx-sk file cleanup              # 真删：物理原件一并删除，不可撤销
+```
+
+- 判据与「未引用」筛选片**完全同一套**：没有任何条目的 `file` 字段引用它、正文里也没有引用它的图。
+  两套判据会出现「筛选片里看不到、清理却删了」这种吓人的不一致。
+- 被引用的附件**一律不动**；同一个原件可以被多条条目共享，所以「已被引用」不是删除理由。
+- 不可撤销：要留底就先 `nx-sk transfer export`。
+- 面板上：附件中心工具条有「清理未引用（N）」，点了弹确认，报清数量。
+
+## 四、导入：默认移动，`--copy` 才复制
 
 ```bash
 nx-sk file add --path "D:\简历\张三-简历.pdf"          # 默认把原件**移动**进库（原件不再留在原地）
@@ -49,7 +66,7 @@ nx-sk file add --path C:\扫描\成绩单.pdf --tags 成绩单 --note "教务处
 - 同 sha256 的文件直接复用已有记录（返回 `duplicated`），不会重复占空间。
 - `file add --dry-run` 只计算落点与校验，不移动、不写台账。
 
-## 四、链接：`file` 字段值 = 附件 id 的**列表**（可挂多个）
+## 五、链接：`file` 字段值 = 附件 id 的**列表**（可挂多个）
 
 条目**不复制文件**，只存附件 id。把 id 写进栏目里 `file` 类型的字段，链接就建立了；
 **一个字段可以挂多个附件**（简历多个版本、头像多张、证书多份），值是 id 的数组：
@@ -73,7 +90,7 @@ nx-sk file get f_bbb
 - 老数据里存的**单个 id 字符串**原样兼容：读、反查、搜索、面板编辑都按「单元素列表」处理，
   不需要迁移；下一次在面板里编辑该字段保存后，会统一成数组。
 
-## 五、还原（可逆）
+## 六、还原（可逆）
 
 ```bash
 nx-sk file restore f_xxxx                         # 移回**原始位置**并撤销台账（默认）
@@ -89,7 +106,7 @@ nx-sk file restore f_xxxx --to "D:\资料"          # Web 上传件没有原始
 - Web 上传进来的附件没有「原始位置」，还原时必须给 `--to`。
 - 还原/删除都不留本地备份；删之前先 `transfer export` 导一份——见 `60-transfer`。
 
-## 六、Web 面板
+## 七、Web 面板
 
 `nx-sk serve` → 顶部「附件」页：
 
@@ -99,10 +116,24 @@ nx-sk file restore f_xxxx --to "D:\资料"          # Web 上传件没有原始
 - **两种引用都算已引用**：`file` 字段里选了本附件，或 `md` 字段正文里写了
   `![说明](f_xxx)`（外链图片 `https://…` 不算，它本来就不在附件库里）。
 - 编辑弹窗可改名称 / 分类 / 标签 / 备注（改分类或文件名时物理原件随之移动）；
+- **「清理未引用（N）」**：一键删掉所有没有任何条目引用的附件（判据与「未引用」筛选片同一套），
+  物理原件一并删除，操作前弹确认；
 - 条目表单里的 `file` 字段是**列表**：文件可直接**拖进字段框**（可多选）、点「上传文件」多选、
   从库里逐个追加、逐行移除；保存即建立链接。
 
-## 七、看不到 `file` 上传字段 / 条目里解析不到附件
+### 字段里的附件选择器（可搜索 + 未引用优先）
+
+点「从附件库选…」打开的是**选择面板**，不是下拉框：
+
+- **可搜索**：按名称 / 备注 / 标签过滤（库里几十个附件时，下拉框根本没法挑）；
+- **未引用优先**：没有任何条目引用的原件排在前面（刚导入还没挂上去的就在最上面），
+  已被引用的排在后面并标注「已被 N 处引用」——仍然可选（同一原件可被多条条目共享）；
+- 点一行即**追加**到本字段，可以连点多个；已挂上的会从列表里消失（它已经在这个字段里了）。
+
+> 附件 id 是**全局唯一**的：同一个原件被两个条目挂上，两边指的是同一条记录。
+> 「已被 N 处引用」说的就是这件事，不是「不能选」。
+
+## 八、看不到 `file` 上传字段 / 条目里解析不到附件
 
 1. **栏目里没有这类字段** —— 栏目字段台账是**持久化数据**：栏目实例化时深拷贝模板字段，
    此后独立演化，模板**后来**新增的字段不会自动回溯到已建栏目。用

package/package.json

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

package/src/modules/entries/view.jsx

@@ -162,6 +162,19 @@ export default function SectionView({ sectionId }) {
     await reload();
   });
 
+  // 改到一半关标签页 = 改动全丢。浏览器只允许弹一句「确定要离开吗」，
+  // 拦不住也改不了文案，但至少别让未保存的改动无声消失。
+  useEffect(() => {
+    if (!dirty.count) return undefined;
+    const onBeforeUnload = (e) => {
+      e.preventDefault();
+      e.returnValue = '';
+      return '';
+    };
+    window.addEventListener('beforeunload', onBeforeUnload);
+    return () => window.removeEventListener('beforeunload', onBeforeUnload);
+  }, [dirty.count]);
+
   // 「直接存 kv」的入口：敲一行 字段=值 回车即写入，字典里没有的键会自动登记
   const quickAdd = guard(async () => {
     if (!draft) { toast('先新建一条条目', 'bad'); return; }
@@ -443,7 +456,9 @@ export default function SectionView({ sectionId }) {
             <div className="card"><Empty>左边选一条，或新建一条</Empty></div>
           ) : (
             <div className="card">
-              <div className="colhead">
+              {/* 顶栏固定在窗口右上角：长栏目滚到一半也能看见「保存」——
+                  否则改完一个字段要翻到表单最底点保存，翻页越多越容易漏保存。 */}
+              <div className="colhead sticky-head">
                 <span
                   className="crumb grow nowrap"
                   title="点击复制条目定位（栏目›条目 + id + CLI 命令，贴给 agent 即可修改）"
@@ -456,6 +471,12 @@ export default function SectionView({ sectionId }) {
                 </span>
                 <span className="muted mono">{draft.id}</span>
                 {current ? <Tag kind={current.missing.length ? '' : 'strong'}>完整度 {current.completeness.ratio}%</Tag> : null}
+                {dirty.count ? (
+                  <>
+                    <span className="hint nowrap">{dirty.count} 处改动未保存</span>
+                    <button type="button" className="btn small" onClick={save} title="保存当前条目的改动">保存</button>
+                  </>
+                ) : null}
               </div>
 
               <div className="field wide pad" style={{ borderBottom: '1px solid var(--soft-2)' }}>

package/src/modules/files/index.js

@@ -76,6 +76,15 @@ export default {
       run: (ctx) => service.removeFile(ctx.ref, ctx),
       render: (d) => service.renderFileChange(d),
     },
+    {
+      id: 'file.cleanup',
+      cli: ['file', 'cleanup'],
+      http: ['POST', '/api/files/cleanup'],
+      summary: '一键清理**未被任何条目引用**的附件（孤儿附件，物理原件一并删除，不可撤销）',
+      flags: { 'dry-run': { type: 'boolean', hint: '只列出会删哪些，不真删' } },
+      run: (ctx) => service.cleanupUnreferenced(ctx),
+      render: (d) => service.renderFileCleanup(d),
+    },
     {
       id: 'file.content',
       cli: ['file', 'content'],

package/src/modules/files/service.js

@@ -177,6 +177,40 @@ export async function removeFile(ref, patch = {}) {
   return { status: 'ok', removed: { id: target.id, name: target.name, category: target.category } };
 }
 
+/**
+ * 一键清理**未被任何条目引用**的附件（孤儿附件）。
+ *
+ * 判据与「附件中心」的「未引用」筛选片**完全同一套**（`fileReferences` 为空）：
+ * 没有任何条目的 file 字段引用它、正文里也没有引用它的图。
+ *
+ * 为什么值得一键做：附件库是「导入即进库」，批量导入 SOP 截图、临时传一份再删
+ * 都会留下孤儿——它们既占空间，又在附件中心混在真资料里。逐个删是折磨。
+ *
+ * 不可撤销（物理原件一起删），所以：
+ *   - 面板侧先弹确认，列出将删的数量与体积；
+ *   - CLI 侧有 --dry-run，先看清单再动手。
+ */
+export async function cleanupUnreferenced(patch = {}) {
+  const dryRun = patch['dry-run'];
+  const store = await loadStore();
+  const orphans = store.files.filter((rec) => !fileReferences(store, rec).length);
+  if (!orphans.length) {
+    // 已经是期望状态（没有孤儿）→ skipped，不是失败
+    return { status: 'skipped', count: 0, removed: [], reason: '没有未引用的附件' };
+  }
+  const brief = orphans.map((r) => ({
+    id: r.id, name: r.name, category: r.category, bytes: r.bytes, path: displayPath(fileRecordAbs(r)),
+  }));
+  if (dryRun) {
+    return { status: 'skipped', dryRun: true, count: orphans.length, wouldRemove: brief };
+  }
+  // 先删物理文件（失败即抛，台账不动）——不能出现「台账没了、文件还在」的中间态
+  for (const rec of orphans) await deletePhysical(rec);
+  const ids = new Set(orphans.map((r) => r.id));
+  await mutateStore((s) => { s.files = s.files.filter((x) => !ids.has(x.id)); });
+  return { status: 'ok', count: orphans.length, removed: brief };
+}
+
 /** CLI 的 file content：给出物理路径与链接（不直接吐二进制，终端里没法看）。 */
 export async function contentInfo(ref, { download } = {}) {
   const store = await loadStore();
@@ -271,6 +305,19 @@ export function renderFileChange(d) {
   return `已更新附件 ${d.name}（${d.id}）`;
 }
 
+export function renderFileCleanup(d) {
+  if (d.dryRun) {
+    const lines = [`试运行（未落盘）：将清理 ${d.count} 个未引用的附件`];
+    for (const r of d.wouldRemove || []) lines.push(`  ${r.id}  ${r.name}　${fmtBytes(r.bytes)}`);
+    lines.push('确认无误后去掉 --dry-run 即可执行。');
+    return lines.join('\n');
+  }
+  if (d.status === 'skipped') return `没有未引用的附件，无需清理`;
+  const lines = [`已清理 ${d.count} 个未引用的附件（物理原件一并删除，不可撤销）`];
+  for (const r of d.removed || []) lines.push(`  ${r.id}  ${r.name}　${fmtBytes(r.bytes)}`);
+  return lines.join('\n');
+}
+
 export function renderContent(d) {
   return `${d.name}（${d.id}）\n路径: ${d.displayPath}\n浏览器链接: ${d.url}${d.download ? d.downloadUrl : ''}`;
 }

package/src/modules/files/view.jsx

@@ -174,6 +174,30 @@ export default function FilesView() {
     await reload();
   });
 
+  /**
+   * 一键清理**未引用**的附件（孤儿附件）。
+   *
+   * 判据与「未引用」筛选片同一套：没有任何条目的 file 字段引用它、正文里也没有引用它的图。
+   * 逐个删是折磨 —— 批量导入 SOP 截图、临时传一份再删，都会留下这种孤儿。
+   * 物理原件一起删、不可撤销，所以先弹确认并说清数量。
+   */
+  const cleanup = guard(async () => {
+    const n = data?.unlinked || 0;
+    if (!n) return;
+    const ok = await dialog({
+      message: `清理 ${n} 个未被任何条目引用的附件？`,
+      detail: '物理原件会一起删除，不可撤销。\n想留底就先在「导出导入」页导一份。',
+      danger: true,
+      confirmText: '清理',
+    });
+    if (!ok) return;
+    const r = await api('/api/files/cleanup', { method: 'POST', body: {} });
+    toast(r.count ? `已清理 ${r.count} 个未引用的附件` : '没有未引用的附件');
+    await refreshAttachments();
+    await load();
+    await reload();
+  });
+
   if (err) {
     return <div className="pad stack"><div className="bad"><strong>附件库读不到</strong></div><pre className="block">{err}</pre></div>;
   }
@@ -206,6 +230,14 @@ export default function FilesView() {
           onChange={(e) => setQ(e.target.value)}
         />
         <button className="btn small ghost" onClick={load}>刷新</button>
+        <button
+          className="btn small ghost danger-ghost"
+          disabled={!data.unlinked}
+          onClick={cleanup}
+          title="删除所有没有任何条目引用的附件（物理原件一并删除，不可撤销）"
+        >
+          清理未引用{data.unlinked ? `（${data.unlinked}）` : ''}
+        </button>
         <button className="btn small ghost" onClick={openPathImport}>本机路径导入</button>
         <button className="btn small" onClick={() => pickerRef.current?.click()}>上传文件</button>
         <input

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

@@ -84,9 +84,13 @@ export function FileFieldControl({ def, value, onChange }) {
   // 附件多的时候不把表单撑长：默认只露 5 行，窗口内上下滚动；需要看全时一键展开
   const [expanded, setExpanded] = useState(false);
   const uploadRef = useRef(null);
+  // 附件库选择器：默认收起，点开才搜索 / 挑选（表单是给人填的，不是给人翻附件库的）
+  const [pickerOpen, setPickerOpen] = useState(false);
+  const [pickQuery, setPickQuery] = useState('');
   // dragenter/dragleave 在子元素间穿梭时会成对触发，用深度计数避免「还没离开就熄掉高亮」
   const dragDepth = useRef(0);
   const ids = toIds(value);
+  const idsKey = ids.join(',');
   const max = Number(def.maxItems) || 0;
   const full = max > 0 && ids.length >= max;
 
@@ -97,9 +101,37 @@ export function FileFieldControl({ def, value, onChange }) {
   }, []);
   useEffect(() => { load(true); }, [load]);
 
-  const all = data?.files || [];
+  const all = useMemo(() => data?.files || [], [data]);
   const byId = (id) => all.find((f) => f.id === id) || null;
-  const available = all.filter((f) => !ids.includes(f.id));
+  // 本字段还没挂的附件
+  const available = useMemo(
+    () => all.filter((f) => !idsKey.split(',').includes(f.id)),
+    [all, idsKey],
+  );
+  // **未引用优先**：附件中心刚导入、还没挂到任何条目的原件排在前面。
+  // 理由：选附件时最常要的正是「刚传的那几个」；已被别处引用的往后排，
+  // 仍然可选（同一个原件可以被多条条目共享）。
+  const ordered = useMemo(() => {
+    const free = [];
+    const used = [];
+    for (const f of available) (f.usedBy?.length ? used : free).push(f);
+    return [...free, ...used];
+  }, [available]);
+  // 关键字搜索：名称 / 备注 / 标签
+  const matched = useMemo(() => {
+    const q = pickQuery.trim().toLowerCase();
+    if (!q) return ordered;
+    return ordered.filter((f) => [f.name, f.note, ...(f.tags || [])]
+      .join('\n').toLowerCase().includes(q));
+  }, [ordered, pickQuery]);
+
+  // Esc 关掉选择器
+  useEffect(() => {
+    if (!pickerOpen) return undefined;
+    const onKey = (e) => { if (e.key === 'Escape') setPickerOpen(false); };
+    window.addEventListener('keydown', onKey);
+    return () => window.removeEventListener('keydown', onKey);
+  }, [pickerOpen]);
 
   const upload = guard(async (fileList) => {
     const picked = [...(fileList || [])];
@@ -175,10 +207,15 @@ export function FileFieldControl({ def, value, onChange }) {
         </div>
       ) : null}
       <div className="file-pick-row">
-        <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"
+          disabled={full || !available.length}
+          onClick={() => setPickerOpen((v) => !v)}
+          title="从附件库挑附件（可搜索；未引用的排在前面）"
+        >
+          从附件库选…
+        </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' }); window.location.hash = '#/files'; }}>附件中心</button>
         <input
@@ -189,6 +226,36 @@ export function FileFieldControl({ def, value, onChange }) {
           onChange={(e) => { upload(e.target.files); e.target.value = ''; }}
         />
       </div>
+      {pickerOpen ? (
+        <div className="file-pick-panel">
+          <div className="file-pick-search">
+            <input
+              autoFocus
+              value={pickQuery}
+              placeholder="按名称 / 备注 / 标签搜索附件"
+              onChange={(e) => setPickQuery(e.target.value)}
+            />
+            <span className="hint nowrap">{matched.length} / {available.length}</span>
+            <button type="button" className="btn small ghost" onClick={() => setPickerOpen(false)}>关闭</button>
+          </div>
+          {matched.length ? (
+            <div className="file-pick-list">
+              {matched.map((f) => (
+                <button type="button" key={f.id} className="file-pick-item" onClick={() => add(f.id)} title="点击追加到本字段">
+                  {f.isImage
+                    ? <img src={f.url} alt="" />
+                    : <span className="ext-badge" style={{ fontSize: 12, width: 34, textAlign: 'center' }}>{f.ext ? f.ext.slice(1).toUpperCase() : 'FILE'}</span>}
+                  <span className="file-pick-name grow nowrap">{f.name}</span>
+                  <span className="hint nowrap">{f.usedBy?.length ? `已被 ${f.usedBy.length} 处引用` : '未引用'}</span>
+                </button>
+              ))}
+            </div>
+          ) : (
+            <div className="hint pad">没有匹配的附件。换个关键字，或先「上传文件」。</div>
+          )}
+          <div className="hint pad">未引用的排在前面；点一行即追加到本字段（可连续点多个）。</div>
+        </div>
+      ) : 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

@@ -423,7 +423,6 @@ a.file-name:hover { text-decoration: underline; }
 /* 拖文件悬停在字段框上：与「附件」中心同一套视觉语言（虚线描边 + 浅底） */
 .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 {
   display: flex; align-items: center; gap: 8px;
   border: var(--border); border-radius: 6px; padding: 4px 8px;
@@ -436,6 +435,54 @@ a.file-name:hover { text-decoration: underline; }
 }
 .file-preview .file-preview-name:hover { text-decoration: underline; }
 
+/* 附件库选择器：可搜索 + 未引用优先（不是原生下拉——库里几十个附件时没法挑） */
+.file-pick-panel {
+  border: var(--border);
+  border-radius: 8px;
+  background: var(--paper);
+  overflow: hidden;
+}
+.file-pick-search {
+  display: flex; align-items: center; gap: 6px;
+  padding: 6px 8px;
+  border-bottom: var(--border);
+  background: var(--soft);
+}
+.file-pick-search input { flex: 1; min-width: 0; }
+.file-pick-list { max-height: 260px; overflow: auto; }
+.file-pick-item {
+  display: flex; align-items: center; gap: 8px;
+  width: 100%;
+  padding: 4px 8px;
+  border: 0;
+  border-bottom: var(--border);
+  background: var(--paper);
+  color: var(--ink);
+  font: inherit;
+  font-size: var(--fs-core);
+  text-align: left;
+  cursor: pointer;
+}
+.file-pick-item:last-child { border-bottom: 0; }
+.file-pick-item:hover { background: var(--soft); }
+.file-pick-item img {
+  width: 28px; height: 28px; object-fit: cover;
+  border-radius: 4px; border: var(--border); background: #fff;
+}
+.file-pick-name { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+
+/* 条目表单顶栏固定：长栏目滚到一半也看得见「保存」 */
+.card > .colhead.sticky-head {
+  position: sticky;
+  top: 0;
+  z-index: 5;
+  height: auto;
+  min-height: var(--row-h);
+  padding: 4px 14px;
+  background: var(--paper);
+  box-shadow: 0 1px 0 var(--soft-2);
+}
+
 /* ── 栏目管理（设置页）：拖拽编排 + 显隐 ─────────────────────
    结构用版面表达、改结构用拖拽表达——所以这里只有把手、输入框与两个动作，
    没有一排 上移/下移/移除 按钮（按钮越多越看不出「现在是什么结构」）。 */

package/src/web/public/assets/{files-Cc9BanTT.js → files-CYxBsvjL.js}

@@ -1 +1 @@
-import{a as l}from"./index-B1tuW-Bw.js";let n=null,o=0;const u=1500;function c(t=!1){return!t&&n&&Date.now()-o<u||(o=Date.now(),n=l("/api/files").then(e=>e).catch(e=>{throw n=null,e})),n}function d(){return n=null,c(!0)}function h(t,e){const a=Array.isArray(t)?t:[],r=(Array.isArray(e)?e:[]).filter(Boolean);if(!r.length)return a;const s=new Set(r.map(i=>i.id));return[...r,...a.filter(i=>!s.has(i.id))]}function m(t){return new Promise((e,a)=>{const r=new FileReader;r.onload=()=>e(r.result),r.onerror=()=>a(new Error("读取文件失败")),r.readAsDataURL(t)})}export{m as f,c as l,h as m,d as r};
+import{a as l}from"./index-BhVJGdcz.js";let n=null,o=0;const u=1500;function c(t=!1){return!t&&n&&Date.now()-o<u||(o=Date.now(),n=l("/api/files").then(e=>e).catch(e=>{throw n=null,e})),n}function d(){return n=null,c(!0)}function h(t,e){const a=Array.isArray(t)?t:[],r=(Array.isArray(e)?e:[]).filter(Boolean);if(!r.length)return a;const s=new Set(r.map(i=>i.id));return[...r,...a.filter(i=>!s.has(i.id))]}function m(t){return new Promise((e,a)=>{const r=new FileReader;r.onload=()=>e(r.result),r.onerror=()=>a(new Error("读取文件失败")),r.readAsDataURL(t)})}export{m as f,c as l,h as m,d as r};