跳转至

字典

AIMO 字典是分类法中所有有效代码的权威列表。它为每个代码提供完整的定义,包括标签、描述和生命周期信息。

什么是字典

字典提供了所有 AIMO 分类法代码的完整、机器可读的集合。它包含:

  • 8个维度下的所有91个代码
  • 标签和定义(语言包中有翻译)
  • 生命周期元数据(状态、引入版本、弃用、删除)
  • 代码使用的范围说明和示例

字典实现:

  1. 证据模板:代码在 EV 模板中用于对AI系统进行分类
  2. 验证器:验证器检查所有代码是否存在于字典中
  3. 覆盖映射:代码实现与外部框架和法规的映射

!!! 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_namelabeldefinition 值。详情请参阅 本地化指南

生命周期列(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 truefalse 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`(已冻结,仅用于向后兼容)

更新政策

添加新代码

  1. 在维度内分配下一个可用编号(例如 UC-030 之后是 UC-031
  2. status 设置为 active
  3. introduced_in 设置为当前版本
  4. backward_compatible 设置为 true
  5. 提供标签和定义(将翻译添加到语言包)

修改现有代码

更改类型 允许 版本影响
定义澄清 PATCH
范围说明更新 PATCH
标签更改(含义保留) MINOR
含义更改 改为创建新代码

弃用代码

  1. status 设置为 deprecated
  2. deprecated_in 设置为当前版本
  3. replaced_by 设置为新代码(如适用)
  4. 代码保持功能以实现向后兼容
  5. 在 scope_notes 中记录原因

删除代码

  1. 首先至少弃用一个 MINOR 版本
  2. status 设置为 removed
  3. removed_in 设置为当前 MAJOR 版本
  4. 代码对于新证据不再有效

兼容性政策

操作 版本影响 向后兼容
添加新代码 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` | 请求记录, 审查/批准记录 |

在验证器中

验证器检查:

  1. 证据中引用的所有代码存在于字典中
  2. 代码格式匹配预期模式(PREFIX-###
  3. 弃用的代码触发警告
  4. 已删除的代码被拒绝

扩展指南

组织可以用自定义代码扩展字典:

扩展前缀:

X-<ORG>-<DIM>-<TOKEN>

示例:X-ACME-UC-901 用于 ACME 公司的自定义用例代码。

扩展规则:

  1. 自定义代码不得与标准代码冲突
  2. 自定义代码应在本地扩展字典中记录
  3. 与外部方交换证据时,仅使用标准代码

下载

请参阅 发布 获取包含字典和相关文件的可下载包。

相关页面