1界面总览
页面从上到下依次由以下区块组成，鼠标悬停在卡片上会有蓝色左边框高亮（与词句助手应用内的卡片一致）。
Logo + 外部搜索引擎搜索框 + 右侧按钮组：同步、绑定数据文件、清空、导出、导入、使用说明。
「工具」标签 + 新建、管理、分类下拉框、标签下拉框、站内搜索框，以及右侧六个统计胶囊。
「全部」+ 各分类芯片，单击筛选、双击重命名，过多时可展开 / 收起。
同样以芯片排列，单击按标签筛选；与分类筛选互斥，后点的那一个生效。
标题 + 分类徽标 + 内容预览 + 排序号 + 标签 + 使用次数 + 复制按钮；右上角是置顶 / 编辑 / 删除三个图标。
操作结果在右上角滑入提示，绿色成功、红色失败、橙色警告、蓝色信息，约 2.6 秒后自动消失，最多同时保留 3 条。
右下角悬浮圆形按钮，页面向下滚动后出现，点击平滑回到顶部。
2快速上手
三步开始使用：建一条词句 → 一键复制调用 → 绑定文件长久保存。
- 点击工具栏「新建」。
- 填写标题与词句内容（两项必填）。
- 可选填分类、标签、排序。
- 点击「保存」。
- 用搜索或芯片筛选找到词句。
- 点击卡片右下角「复制」。
- 使用次数自动 +1，今日 / 本月同步累加。
- 粘贴到任意对话或文档中。
- 在主浏览器点「绑定数据文件」。
- 选定一个本地 JSON 文件当作数据库。
- 此后改动自动写回该文件。
- 换浏览器时绑定同一文件并点「同步」。
首次打开有 4 条演示词句如「指定 md 代码块输出」「创建某某的 md 文档」「润色 I 普通」「高情商 I 回复」，可直接编辑或删除，用来熟悉操作。两种起步方式：一是用工具栏「新建」逐条添加；二是点导航栏「导入」，选择已有的 JSON 备份一次性灌入整套词句与分类 / 标签。
3词句管理
点击工具栏「新建」打开弹窗，填写以下字段后点「保存」。
| 字段 | 说明 |
|---|
| 标题 * | 词句的名称，例如「代码审查专家」。卡片左上角显示，过长时截断显示。 |
| 分类 | 下拉选择已有分类；点右侧 + 可现场新建。也可以留空，卡片上就不显示分类徽标。 |
| 标签 | 多个标签用加号 + 分隔，例如 代码 + 审查 + 优化；保存时自动登记进标签表。 |
| 词句内容 * | 完整正文，也是点「复制」时送进剪贴板的内容；卡片上显示预览。 |
| 使用次数 | 手动设置初始使用次数，默认为 0。 |
| 排序 | 数字越小越靠前；留空时按当前条数自动补号，排在已填序号之后。 |
| 创建时间 | 可手动指定；排序号相同时，创建时间越早越靠前。 |
排序规则列表顺序为：置顶优先 → 排序号升序 → 创建时间升序。想让某条永远在最前，用「置顶」比改排序号更直接。
点卡片右上角的铅笔图标打开编辑弹窗，标题变为「编辑词句」。改完点「保存」，列表与统计立即更新；写盘失败时会保留弹窗内容并提示重试，不会丢失输入。
点卡片右上角的垃圾桶图标，确认卡片里会带上词句标题，确定后永久移除（已绑定文件时也会同步删除）。写盘失败会自动还原该词句，不会留下半删状态。
点卡片右下角的复制图标，完整正文进入剪贴板，该词句使用次数 +1，并计入今日 / 本月 / 累计统计。复制优先用系统剪贴板，不可用时自动降级，两者都失败会给出中文提示。
点卡片右上角的图钉图标：置顶的卡片排在最前并带高亮边框，再点一次取消。置顶优先级高于排序号，长按高频词句时很好用。
4分类与标签
词句用「一个分类 + 多个标签」来组织：分类负责归类（一条词句只有一个），标签负责打点（可以有多个），上百条词句也能一眼定位。
- 点分类芯片只看该分类，点「全部」看所有词句。
- 点标签芯片筛选带该标签的词句。
- 分类与标签互斥：后点的那一个生效，另一个自动回到「全部」。
- 芯片名超过 6 个字会截断显示，不影响筛选。
- 双击分类或标签芯片进入输入态。
- 按 Enter 或点击别处确认，按 Esc 取消。
- 改名会同步更新所有词句上的该分类 / 标签。
- 重名时会弹确认卡片，确定后合并为同一个。
- 留空、超过 20 字、或用保留字「全部」都会提示失败。
- 在「新建 / 编辑词句」弹窗里点分类框右侧
+，输入名字回车即创建。
- 标签直接写进「标签」框，用
+ 分隔，保存时自动登记。
- 新建的名称会被登记保存，即使暂时还没有词句使用。
- 芯片过多时快捷栏可展开 / 收起，展开状态会被记住。
- 点工具栏「管理」，弹窗分「分类 / 标签」两个页签。
- 每行可直接改 ID 与名称，改 ID 数值即可调整排序（升序）。
- 顶部搜索框实时过滤；左下「新增」加行，右侧 × 标删。
- 标签行写
A + B 保存时会自动拆成两行。
- 保存时校验空名、重名、保留字与 ID 重复；失败会整体回滚。
删除分类 / 标签的连带效果在管理弹窗里删除，只会把该名称从所有词句上清除，词句本身保留（这一点与「搜索导航」删分类不同）。操作前留意行尾显示的「词句：N」。
名称规则分类 / 标签名最长 20 个字符；「全部」是系统保留名称，不能作为分类或标签名。旧版本里是纯字符串数组的注册表会在加载时自动补发 ID，无需手动迁移；排序与显示一律按 ID 升序。
5查找与筛选
- 在工具栏搜索框输入，边打边过滤，无需回车。
- 同时匹配标题、分类、标签三个维度，不区分大小写。
- 正文内容不参与搜索（有意排除，避免长正文干扰结果）。
- 没有任何匹配时，网格显示「没有匹配的数据」。
- 搜索框有内容时，搜索接管列表，暂时忽略分类 / 标签筛选。
- 被接管的快捷栏会淡出，并标注「（搜索中暂不生效）」。
- 清空搜索词后，原来的筛选立即恢复生效。
- 点搜索框右侧的 × 可一键清空并恢复全量列表。
- 下拉框与快捷栏始终同步，改哪边都一样。
- 选分类 → 标签回到「所有标签」；选标签 → 分类回到「所有分类」。
- 筛选条件不会保存，每次打开页面都重置为全部。
- 找不到就把两栏都点回「全部」。
- 导航左侧的搜索框：左边选引擎，右边输关键词。
- 内置 5 个引擎：必应、百度、360、夸克、神马。
- 按 Enter 直接在新标签打开搜索结果页。
- 选过的引擎会被记住，下次打开仍是它（默认必应）。
两个搜索框各管一段导航栏搜索框走外部搜索引擎，工具栏搜索框只在自己的词句库里找（且只搜标题 / 分类 / 标签）。词句少了先用前者查资料，词句多了后者更快。
6统计面板
工具栏右侧的六个统计胶囊实时更新，鼠标悬停会高亮。
高频使用次数最多的词句标题
词句词句总条数
总数累计复制次数
本月本月复制次数
昨日昨日复制次数
今日今日复制次数
| 胶囊 | 含义 | 数据来源 |
|---|
| 高频 | 使用次数最多的那条词句的标题（超过 18 字会截断加省略号） | 各词句 usage 字段的最大值，全为 0 时显示「-」 |
| 词句 | 当前词句总条数 | 列表条数（不受筛选影响） |
| 总数 | 所有词句累计使用次数之和 | usage 求和 |
| 本月 | 本月内复制的总次数 | 复制时累加，跨月重置 |
| 昨日 | 昨日复制的总次数 | 由「今日」跨天后滚动转入 |
| 今日 | 今日复制的总次数 | 复制时累加，跨天清零 |
只统计复制只有点「复制」把内容真正送进剪贴板才计数。新建、编辑、删除、置顶、切换筛选这些操作都不计入；内容为空的词句复制无效，也不会虚增计数。
7数据管理
点击导航栏「导出」并确认，下载 JSON 文件，文件名形如 词句数据-20261008-133000.json，含词句、分类 / 标签注册表与全部使用统计。
点「导入」选 JSON 文件 → 再次确认。导入将覆盖当前所有词句与分类 / 标签；结构不符时提示「无效的备份文件」，解析失败会说明具体原因。
点「清空」并确认，所有词句、分类 / 标签注册表与使用统计全部重置为空（不会回到演示数据）；已绑定文件时，文件内容也会一并清空。
不可恢复清空与导入覆盖都无法撤销。建议在这两个操作之前，先点「导出」留一份备份。
8本地文件同步 · 多浏览器共用一份数据
绑定一个本地 JSON 文件后，这个文件就成了你的「本地安全数据库」：数据不只躺在某个浏览器里，而是始终落在你自己掌控的文件上，换浏览器也能接着用。
- 点击导航栏「绑定数据文件」，选择一个 JSON 文件（如随包附带的
data.json）。
- 此后的每次新增、编辑、删除、复制都会自动写回该文件。
- 数据同时保存在：浏览器本地存储 + 这个 JSON 文件，双份不冲突。
- 文件放在本机任意路径、任意分区均可，全程不经过任何服务器。
- 用 Chrome、Edge、夸克、QQ 浏览器等打开同一个网页。
- 同样点「绑定数据文件」，选中同一个 JSON 文件（每个浏览器只需绑定一次）。
- 每次使用时点一下「同步」，文件里的最新数据就会拉进当前浏览器。
- 主浏览器 A 之后新增或删除的内容，在 B 里同步后立刻可见。
- 新建词句、编辑保存、删除词句
- 复制词句（使用次数 +1）
- 置顶 / 取消置顶
- 新建分类 / 标签
- 双击重命名分类 / 标签
- 管理弹窗里调整 ID、名称、增删
- 导入数据、清空数据
- 读取绑定文件的最新 JSON。
- 以文件内容为准替换当前浏览器的数据。
- 再写入本地存储、刷新统计并回写规范化后的数据。
- 因此「同步」永远以 JSON 文件为主，不会反向覆盖文件。
同一时间只在一个浏览器里改同步是「以文件为准」的单向覆盖。若 B 浏览器本地有未写回文件的改动，点同步会被文件内容替换掉。稳妥做法：在 B 里先点同步，再看 / 再复制；要改东西就回主浏览器 A 改。
每个浏览器都要绑定一次文件句柄保存在各自浏览器的 IndexedDB 中，互不共享。换浏览器、清理浏览数据后需要重新绑定；同一浏览器重启后通常会自动恢复绑定，偶尔会弹一次授权确认，允许即可。
浏览器要求绑定与同步基于 File System Access API，需最新版 Chrome 或 Edge。夸克、QQ 等若不支持，点击「绑定数据文件」会提示「浏览器不支持」，这类浏览器可用「导出 / 导入 JSON」作为替代方案。
9快捷键与其他操作
| 按键 | 功能 |
|---|
| Enter | 搜索引擎框：打开搜索结果；新建分类输入框：确认创建；芯片改名：确认新名称 |
| Esc | 关闭当前打开的弹窗 / 确认卡片，或取消正在进行的重命名、新建分类 |
| Tab / Shift+Tab | 弹窗内循环切换焦点（焦点不会跑到弹窗外） |
- 点击右上角 × 或右下「取消」。
- 点击弹窗外的半透明遮罩区域。
- 按键盘 Esc 键。
- 弹窗打开时页面主体不再跟随滚动；关闭后焦点会自动还给触发它的按钮。
页面向下滚动超过一定距离后，右下角出现圆形按钮，点击平滑滚动回顶部；回到顶部后按钮自动隐藏。
创建时间已保留
填写的创建时间无法识别，已保留原来的创建时间
10数据存储与屏幕适配
| 位置 | 用途 |
|---|
localStorage | 键名 prompt_vault_data_v2，保存词句、分类 / 标签注册表、使用统计 |
localStorage | 键名 prompt_vault_data_v2_ui，记住分类栏 / 标签栏的展开状态 |
localStorage | 键名 ext_selected_engine，记住导航栏搜索引擎偏好 |
localStorage | 键名 prompt_vault_data_v2_corrupt_backup，仅在存档损坏时备份原始内容 |
IndexedDB | 库名 prompt-vault-fs，仅在绑定文件后保存文件句柄 |
| 绑定的本地 JSON 文件 | 可选的持久化同步载体 |
| 屏幕宽度 | 布局 |
|---|
| 宽屏（> 1100px） | 导航一行铺开，词句卡片 4 列网格 |
| ≤ 1100px | 卡片网格收为 3 列 |
| ≤ 900px | 卡片网格收为 2 列 |
| ≤ 600px（手机） | 卡片单列；导航竖向排列，隐藏统计胶囊与导出 / 导入 / 同步 / 绑定 / 清空按钮 |
| ≤ 500px | 弹窗内的并排表单改单列 |
换浏览器 / 换设备本地存储与浏览器绑定，不会自动跨浏览器。两种迁移方式：一是「导出」得到 JSON，在另一台设备「导入」；二是把 JSON 文件放在本机任意路径下，让各浏览器都「绑定数据文件」，用「同步」拉取最新内容。
存档损坏不会覆盖原档本地存档解析失败或结构异常时，页面会载入示例数据并提示，原始内容会另存一份到 prompt_vault_data_v2_corrupt_backup，主档保持不动，便于排查与取回。