← 返回首页

字典系统与运行时选项

# anenreo 字典系统

## 目标

字典系统把状态、类型、来源、情绪、附件种类、时间精度等可枚举选项从页面源码中移出，形成由 PostgreSQL 持久化、PC 配置中心维护、Web 与移动端运行时共同读取的统一选项来源。

## 数据边界

- `dictionary_definition`：保存字典编码、中文名称、系统保护标记、发布状态和修订号。
- `dictionary_item`：保存字典项编码、中文标签、排序、启停、图标、颜色和扩展元数据。
- 系统字典不可删除；用户字典允许增删改，但仍受 ownerId、乐观锁和审计约束。
- 隐私等级等安全枚举在运行时仍由代码实施硬性约束，字典只能提供展示和选择，不能放宽安全规则。

## 运行链路

```text
字段定义.dictionaryCode
        ↓
DictionaryService
        ↓
Web DynamicDictionarySelect / MobileDictionaryPicker
        ↓
保存字典项 code，而不是保存页面中文文案
```

字典项修改后，动态表单重新请求即可读取新选项；不需要重新编译前端。

- 普通业务快照只返回已发布、已启用且具有可读展示名的选项。明显技术编码若仍以自身作为标签，将从运行时选择器隐藏；PC 配置中心使用 `includeDisabled=true` 仍可查看并补齐。
- 已发布字典新增或修改启用项时，技术编码必须配置独立中文业务标签；如暂时不能配置，应保持停用。稳定 `value` 不会因此被改写或删除。

## PC 配置中心

`/settings/dictionaries` 支持：

- 新建用户字典；
- 修改名称和说明；
- 新增、修改、排序、启停字典项；
- 查看系统字典保护状态；
- 在字段设计器中选择字典。

## 安全与测试

- API 始终按当前用户隔离；系统字典可读但不能被普通删除。
- 字典编码和项目编码在所有者范围内唯一。
- 修改携带 revision，防止多个页面静默覆盖。
- 自动测试必须覆盖系统字典保护、用户字典 CRUD、排序、停用以及动态表单实时消费。
- 自动测试必须覆盖技术值与中文标签分离、未配置标签不进入普通运行时快照，以及草稿字典不进入普通业务选择器。


## 2026-10-02 第三批图像复核补充

PC 字典仅对启用状态 success-soft 徽章局部覆写为主题正文前景，原成功软背景保留；禁用状态继续沿用原 neutral 分支。此项来自 f207ad73 实际画面与源码关联，不修改字典值、启用命令或权限。颜色计算、Nuxt 类合并及源码合同已执行，本次修复后的真实浏览器复验仍为 not_run。


## 2026-10-02 第十批字典切换与恢复

字典管理按选择代次隔离 A→B→A 的迟到快照和错误；加载时隐藏旧字典项，项目操作核对当前字典上下文。读取失败与空数据分开，通过 AppStatePanel 的 actions 插槽显式重试。写入单飞并锁定控件与处理器，新建清除旧 revision；已确认写入的回执先保留，后续目录 GET 失败时保持写入冻结，仅允许读取恢复，不重放写命令。删除最后一个字典清理选择；会话变化或卸载阻止迟到回调和后续读取。

编译并挂载实际组件、合成 HTTP/Nuxt/uni 控件的本地回归不等于真实浏览器、设备、API 或数据库验收。真实浏览器复验与新增截图仍 not_run，Catalog 的 24 项 implemented_local、168 项 partial 不变。

R08 设置分层（编码阶段）

R08 CFG-001：保留字典搜索及稳定值合同，加宽选项编辑区，图标、颜色和JSON元数据按需展开。既有字典编码和选项稳定值在编辑页面锁定，显示名仍可独立修改；停用历史值的解释和服务端保护不变。本轮仅完成客户端调整；真实保存、权限、冲突、双端截图及可访问性由统一验收执行，尚未计为业务验收通过。

2026-10-25 只读定义与引用迁移补验

只读账号的字典定义改为带名称、稳定编码、说明、范围和状态的语义定义列表；不再把合法可读内容放入inert表单。只读账号不展示选项编辑侧栏；搜索、目录切换和普通已发布快照仍可用，停用项与编码迁移继续要求schema:write。服务端权限与owner条件没有放宽。

在显式一次性PostgreSQL 17数据库完成多角色HTTP拒绝、零业务副作用及真实审计故障回滚。引用迁移样本包含字段、已发布表单、动态记录和不可变历史：迁移不重写这些引用，新旧编码读取同一字典，稳定业务值不变，迁移后可按旧字段继续保存。PC专用迁移界面与独立事件/快照回读已留证，完整多链迁移和原生设备仍单列待验。

本轮修复43项注释门禁，13个涉及文件去注释语法树保持一致。详细结果及边界见_work/handoff/uiux-production-20261025-phase5/REPORT.md；测试库与临时访问规则均已清理，不连接开发库执行故障注入，不提升70项或Catalog整体完成状态。

2026-10-25 十四批第2批多跳与命名空间

字典创建仅将owner/code现有唯一约束和历史编码保留触发器的PG23505映射为409；主键和未知数据库/审计故障仍传播。历史码和当前码竞争都保留既有命名空间锁与数据库裁决，不新增别名引擎或迁移。

真实PG8项通过：顺序多跳、旧回执精确重放、两个字典争新码及创建争迁移码、owner隔离、二跳审计异常回滚、字典归档与重新发布、24字段/48记录含12归档引用的历史保持。此样本不构成容量或跨库升级证明。

PC预览绑定当前字典id/revision/code及目标编码，旧preview迟到不能重新启用确认；fieldCount只表示当前直接引用旧码，不包括更早历史别名。成功核对后保留不可变事件old→new、原revision、编号和时间，后续字典变化不改写原回执。原32项加新增6项及导航共53项通过。

阶段证据位于_work/handoff/uiux-production-14batches-20261025/agent-dictionary-multihop；PC实际多跳浏览器及完整移动/真机、规模与跨库升级分别验收。