先讀這裡
這一頁回答什麼?
機器格式可以保存質性的情感狀態;只有在尺度與資料來源都說清楚時,才使用數值。
故事關係:這篇故事可用來理解混合情感如何同時包含多個成分;它是閱讀例子,不表示正文直接使用 IAGA 名稱。 〈因果堆疊溢出與骯髒黃金年代〉
權威入口:本標準總覽 · IAGA JSON Schema · IAGA Example Payload
正式規格
若只想理解世界觀,到這裡已足夠;以下內容提供正式定義、欄位、治理與實作細節,可以依需要再深入閱讀。
核心原則
Machine-readable 版本必須忠實反映 IAGA 1.0 已固定的語義。Reader display 的數字不能被當成工程單位,也不能重新引入一套通用的 Core numeric scale。
Developer / Machine Contract
以下列出公開交換 contract 的正式結構;machine key 保留原名,讀者說明與實作欄位分開呈現。
| Contract item | 正式內容/規則 |
|---|---|
schema identity | IAGA-AFFECT-PACKET |
14D factors | 保存 generation/context factors。 |
12D Core | 保存 resulting affective structure。 |
temporal records | 保存時間變化。 |
bindings | 保存 target/source/component 等關係。 |
semantic / action records | 保存語義與行動相關紀錄。 |
calibration reference | 保存個人校正參照。 |
residual | 保存無法完整映射的殘差。 |
provenance | 保存來源。 |
rights | 保存用途與權限。 |
| Machine field | 規則 |
|---|---|
qualitative_state | 合法的正式表示,可單獨存在。 |
value | 可選;不得假設通用 Core minimum / maximum。 |
value_scale_ref | 只要存在 numeric value 就必須存在。 |
measurement_provenance_ref | 只要存在 numeric value 就必須存在。 |
Validation
Machine validation 不只檢查 JSON 結構,也要檢查條件式數值治理、引用完整性、語義、權利/來源與跨系統規則。
Example payload 應優先維持 qualitative representation;只有在刻意示範已定義 scale 時才加入 numeric value。
| Check | Scope |
|---|---|
schema structure | 資料結構。 |
conditional numeric governance | numeric value 出現時的條件規則。 |
referential integrity | references 是否可解析。 |
semantic governance | 跨欄位/跨紀錄語義規則。 |
rights / provenance | 用途權限與來源。 |
interop rules | 跨系統互通規則。 |
適用邊界
Machine-readable contract 是穩定的 exchange surface,不是所有內部 research registry 的完整副本。Schema validity 不證明第一人稱身分同一性,也不代表已獲任何用途授權。