字典
AIMO 字典是分类法中所有有效代码的权威列表。它为每个代码提供完整的定义,包括标签、描述和生命周期信息。
什么是字典
字典提供了所有 AIMO 分类法代码的完整、机器可读的集合。它包含:
- 8个维度下的所有91个代码
- 标签和定义(语言包中有翻译)
- 生命周期元数据(状态、引入版本、弃用、删除)
- 代码使用的范围说明和示例
字典实现:
- 证据模板:代码在 EV 模板中用于对AI系统进行分类
- 验证器:验证器检查所有代码是否存在于字典中
- 覆盖映射:代码实现与外部框架和法规的映射
!!! info "单一事实来源(SSOT)" 字典的 SSOT 是:
- **结构**:`data/taxonomy/canonical.yaml`(代码、状态、生命周期)
- **翻译**:`data/taxonomy/i18n/*.yaml`(每种语言的标签、定义)
CSV 文件是用于分发的**生成工件**。请参阅 [发布](../../releases/index.md) 进行下载。
列模式
规范字典使用 18列(语言中立结构):
标识列(5)
| # | 列 | 必需 | 描述 | 示例 |
|---|---|---|---|---|
| 1 | standard_id |
是 | 标准标识符 | AIMO-STD |
| 2 | standard_version |
是 | SemVer 格式 | 0.1.0 |
| 3 | dimension_id |
是 | 两字母维度ID | FS, UC, DT |
| 4 | dimension_name |
是 | 维度名称 | Functional Scope |
| 5 | code |
是 | 完整代码 | UC-001 |
标签和定义列(4)
| # | 列 | 必需 | 描述 | 示例 |
|---|---|---|---|---|
| 6 | label |
是 | 代码标签(最多50字符) | General Q&A |
| 7 | definition |
是 | 代码定义(1-2句话) | General question answering... |
| 8 | scope_notes |
否 | 使用范围澄清 | Low to medium risk... |
| 9 | examples |
否 | 管道分隔的示例 | chatbot\|recommendation |
!!! note "翻译"
规范数据模型将翻译分离到语言包(data/taxonomy/i18n/*.yaml)中。每个语言包提供本地化的 dimension_name、label 和 definition 值。详情请参阅 本地化指南。
生命周期列(6)
| # | 列 | 必需 | 描述 | 示例 |
|---|---|---|---|---|
| 10 | status |
是 | active, deprecated, removed |
active |
| 11 | introduced_in |
是 | 添加的版本 | 0.1.0 |
| 12 | deprecated_in |
否 | 弃用的版本 | 1.2.0 |
| 13 | removed_in |
否 | 删除的版本 | 2.0.0 |
| 14 | replaced_by |
否 | 替代代码 | UC-015 |
| 15 | backward_compatible |
是 | true 或 false |
true |
治理列(3)
| # | 列 | 必需 | 描述 | 示例 |
|---|---|---|---|---|
| 16 | references |
否 | 外部参考 | ISO/IEC 42001 |
| 17 | owner |
否 | 负责方 | AIMO WG |
| 18 | last_reviewed_date |
否 | 上次审查(YYYY-MM-DD) | 2026-01-19 |
初始条目
当前字典版本是 v0.1.0,包含:
| 维度 | 名称 | 活跃代码 | 已弃用 | 总计 |
|---|---|---|---|---|
| FS | 功能范围 | 6 | 0 | 6 |
| UC | 用例类别 | 30 | 0 | 30 |
| DT | 数据类型 | 10 | 0 | 10 |
| CH | 渠道 | 8 | 0 | 8 |
| IM | 集成模式 | 7 | 0 | 7 |
| RS | 风险面 | 8 | 0 | 8 |
| OB | 结果/收益 | 7 | 0 | 7 |
| LG | 日志/记录类型 | 15 | 0 | 15 |
| 总计 | 91 | 0 | 91 |
!!! note "完整代码列表" 91个代码的完整列表可在生成的CSV工件中获取。此文档页面提供列定义和使用指南。有关详细的代码定义:
- **下载**:请参阅 [发布](../../releases/index.md) 获取每种语言的CSV文件
- **每种语言的CSV**:`artifacts/taxonomy/current/{lang}/taxonomy_dictionary.csv`
- **旧版 EN/JA 混合CSV**:`source_pack/03_taxonomy/legacy/taxonomy_dictionary_v0.1.csv`(已冻结,仅用于向后兼容)
更新政策
添加新代码
- 在维度内分配下一个可用编号(例如
UC-030之后是UC-031) - 将
status设置为active - 将
introduced_in设置为当前版本 - 将
backward_compatible设置为true - 提供标签和定义(将翻译添加到语言包)
修改现有代码
| 更改类型 | 允许 | 版本影响 |
|---|---|---|
| 定义澄清 | 是 | PATCH |
| 范围说明更新 | 是 | PATCH |
| 标签更改(含义保留) | 是 | MINOR |
| 含义更改 | 否 | 改为创建新代码 |
弃用代码
- 将
status设置为deprecated - 将
deprecated_in设置为当前版本 - 将
replaced_by设置为新代码(如适用) - 代码保持功能以实现向后兼容
- 在 scope_notes 中记录原因
删除代码
- 首先至少弃用一个 MINOR 版本
- 将
status设置为removed - 将
removed_in设置为当前 MAJOR 版本 - 代码对于新证据不再有效
兼容性政策
| 操作 | 版本影响 | 向后兼容 |
|---|---|---|
| 添加新代码 | MINOR | 是 |
| 弃用代码 | MINOR | 是 |
| 澄清定义 | PATCH | 是 |
| 删除代码 | MAJOR | 否 |
| 更改代码含义 | 不允许 | - |
如何使用
在证据模板中
每个 EV 模板包含一个8维代码表:
## AIMO 代码(8个维度)
| 维度 | 代码 | 标签 |
| --- | --- | --- |
| **FS** | `FS-001` | 最终用户生产力 |
| **UC** | `UC-001`, `UC-002` | 通用问答, 摘要 |
| **DT** | `DT-002`, `DT-004` | 内部, 个人数据 |
| **CH** | `CH-001` | Web UI |
| **IM** | `IM-002` | SaaS 集成 |
| **RS** | `RS-001`, `RS-003` | 数据泄露, 合规违规 |
| **OB** | `OB-001` | 效率 |
| **LG** | `LG-001`, `LG-002` | 请求记录, 审查/批准记录 |
在验证器中
验证器检查:
- 证据中引用的所有代码存在于字典中
- 代码格式匹配预期模式(
PREFIX-###) - 弃用的代码触发警告
- 已删除的代码被拒绝
扩展指南
组织可以用自定义代码扩展字典:
扩展前缀:
X-<ORG>-<DIM>-<TOKEN>
示例:X-ACME-UC-901 用于 ACME 公司的自定义用例代码。
扩展规则:
- 自定义代码不得与标准代码冲突
- 自定义代码应在本地扩展字典中记录
- 与外部方交换证据时,仅使用标准代码
下载
请参阅 发布 获取包含字典和相关文件的可下载包。