Jarvis

Collectible Semantic Model

概念 snapshot：2026-08-17。本文中的「当前」指文末记录的 candidate baseline，不声明今天的 CSM stable version；机器合同与升级以独立 CSM repo 的 pinned release / commit 为准。

定位

Collectible Semantic Model（CSM）是 LYNCA 面向 collectible domain 的 shared understanding language。它让 frontier model、Runtime、engineer 和未来的 Collector Agent 使用同一套资产语义理解收藏品，并且能够说明：一个判断来自什么 evidence、确定到什么程度、还有什么没有被解决。

在 OCS 中，CSM 是 collectible domain semantic layer：

OCS 保存 CSM 对组织认知的意义、关键概念、边界和使用方式。
`LYNCA-OS/lynca-csm` 保存 versioned semantic specification、machine-readable contracts、validators 和 release history。
Runtime 调用 frontier model、web tools 和 provider API，执行 CSM contract。
csmdata 保存 frozen benchmark assets 和 Founder-approved golden evidence。

OCS 不复制 CSM 的全部 contract，也不成为第二个 CSM authority。发生语义细节冲突时，应回到经过治理的 CSM core documents 和 pinned release；OCS 本文负责帮助组织理解和正确使用它。

为什么 CSM 属于 OCS

LYNCA 的长期 memory layer 不能只记住文件、对话和操作记录。它必须知道收藏资产“是什么”，哪些概念不能混淆，以及什么证据足以支持一个判断。

CSM 为 OCS 提供了这层 domain cognition：

把图像、OCR、label、checklist、Registry、marketplace reference 和 human review 转化为可审计的 asset understanding。
把 collectible truth 与 marketplace wording、search optimization 和 UI presentation 分开。
让 uncertainty、conflict 和 abstention 成为合法状态，而不是被完整度目标掩盖。
为未来 Collector Agent 建立不可绕过的 evidence 与 fabrication boundary。

核心产物：Fragmented CSM Asset State

CSM 的输出不是一段 prose，也不是 marketplace listing。它首先形成一个尚未被目标语言组合的 fragmented Asset State，包含三层：

Canonical fragments：通过当前 closed canonical language 表达的重要 collectible understanding。
Recognized auxiliary attributes：真实、被识别、但不属于 canonical language 的属性。它们默认不可组合；只有被明确标记为 PROFILE_GOVERNED，并且被 versioned Composer profile 映射时，才可进入特定输出。
Unresolved information：不可读、证据不足、存在冲突、缺失或不适用的信息。它们必须保持 unresolved，不能靠猜测补齐。

这三层共同保护一件事：recognition 不会自动把所有 observation 变成 canonical truth。

当前 canonical language

当前 CSM candidate 使用 csm-canonical-fields-v3，包含 15 个 closed canonical fields：

语义组	Canonical field	核心含义
Identity	`year`	收藏品的发行、赛季或产品年份，不自动等于版权年、事件年或 slab date。
Identity	`ip_sport`	赋予资产身份语境的 sport、IP、game、franchise 或 collectible domain。
Identity	`language`	当语言影响资产身份时，记录收藏品本身的语言。
Identity	`manufacturer`	制造或发行收藏品的主体，不是 grader、team、league 或 licensor。
Identity	`product`	证据支持的完整 product、series 或 product-family identity。
Identity	`subject`	收藏品展示或命名的 person、character、object 或 primary entity。
Design	`card_name`	Product 内用于区分 card/design 的名称；无独立命名的 base card 不强行填写。
Design	`card_number`	checklist、collector、design 或 source-set identifier；与限量编号分开。
Rarity	`descriptive_rarity`	SP、SSP、Case Hit 等命名式稀有度。
Rarity	`numerical_rarity`	当前 physical copy 上有证据支持的 production numbering，例如 `17/50` 或 `/50`。
Variant	`release_variant`	card-facing layout、orientation、image 或 named design variation。
Variant	`print_finish`	有证据支持的 parallel、surface、color、foil、refractor 或 print treatment。
Variant	`special_stamp`	未被 rarity 或 finish 覆盖的 promotion、tournament、staff、prize 等特殊印记。
Condition	`grading_info`	结构化 grader、card grade、autograph grade 和 grade type；不包含 certification number。
Expression	`description`	受治理、受 evidence 约束、可被 Composer 使用的 descriptive fragments，不是自由文本。

关键 field boundaries

set 不是 canonical field。来源中的 set/checklist label 只能在证据支持时解析为 product 或 card_name，否则保持 auxiliary 或 unresolved。
search_optimization 不是第 16 个 canonical field；它属于 Runtime Composer language。
card_number 与 numerical_rarity 不可混用。TCG 中的 086/070 可能是 checklist number；non-TCG 当前实体上的 04/10 可能是 production numbering。
release_variant 不包含 FOTL、Hobby、Retail、Asia、Choice 等 packaging / sales configuration。
bare color 只是 print_finish evidence，不自动证明 Gold Wave、Gold Shimmer 等市场名称。
grading certification number 是 physical-instance auxiliary attribute，不进入 grading_info。
description 不是把无法归类的内容塞进去的 escape hatch。

Collectible Understanding 流程

0. Route classification

首先区分 TCG、NON_TCG 或 LOT。同一个 slash number、layout 或 product phrase，在不同 route 中可能具有不同含义。

Lot 不是一张混合身份的普通 Asset State。它包含两个或更多被独立解析和验证的 single-asset states，共享 lot language 由 Runtime Composer 后续推导。

1. Admit evidence

先声明允许使用的 evidence inventory，例如 original images、OCR、grading label、official sources、approved Registry、marketplace reference 或 reviewed human assertion。每个 source 应有 identity 与 content digest；未被 admitted 的来源不能被引用。

2. Recognize

识别当前资产可见的 words、numbers、subject、logos、stamps、signature、patch、grading label、surface、finish、layout，以及 front/back/multi-view 的关系。Recognition 产生 observation，不自动产生 truth。

3. Resolve identity

根据 field meaning 和 contextual evidence 比较 plausible interpretations，解决 Product、Card Name、Card Number、Numerical Rarity、Release Variant、Print Finish 等 field-level questions，并拒绝与当前实体冲突的 reference。

4. Build fragmented state

把 supported understanding 写入 15 fields，把真实但 noncanonical 的属性保留为 auxiliary，把不能安全解决的信息保留为 unresolved。

5. Audit

同一个结果应支持两种 audit view：

Recognition view：识别了哪些 canonical / auxiliary fragments，它们来自哪些 evidence。
Identity Resolution view：为什么选择这些 canonical interpretations，哪些候选被拒绝或仍未解决。

两种 view 解释同一个 asset truth，不创造两个 truth sources。

五层 identity reasoning

CSM 使用五个 identity layers 帮助 reasoning，但它们不是新增 canonical fields：

Asset / product family：例如 2023 Topps Chrome。
Catalog / design identity：通常由 Subject、Card Name、Card Number 和 checklist evidence 支持。
Variant identity：Release Variant、Print Finish、rarity、Language、Special Stamp 等共同表达的版本。
Graded-asset identity：当前 slab 和 grading state。
Physical-instance identity：当前这一份实体，例如 serial numerator 和 certification number。

这套分层防止 reference evidence 越界。相似卡或 Registry 可以帮助确认 family、design 或 variant，但不能证明当前 copy 的 numerator、grade 或 certification number。

Evidence、certainty 与 provenance

Contextual authority

Evidence 的 authority 针对具体问题，而不是全局通用：

original image 决定当前实体上实际存在什么；
可读且可信的 grading label 决定当前 slab 的 grading state；
official checklist / release material 可支持 product identity 和 checklist structure；
approved Registry 可辅助 canonical decomposition，但必须与当前实体兼容；
marketplace reference 可帮助理解 collector language 和 discovery，不因普遍出现就成为 truth；
explicit、attributable、within-scope 的 human review 可以解决对应 field。

更强的 context 也不能推翻当前 physical item。来源冲突时，应保留 conflict 或 abstain。

Certainty states

系统至少要区分：

Supported：证据足以支持 canonical value。
Candidate：解释 plausible，但尚未被解决。
Conflicted：admitted evidence 支持不兼容的解释。
Withheld：可能存在该值，但报告它需要猜测。
Absent / Not applicable：证据支持不存在，或该问题不适用。

Unresolved reason 还应区分 absent、unreadable、insufficient evidence、conflicted 和 not applicable。Unknown 不等于 empty；empty 也不是 fabrication permission。

Provenance

每个 populated field 应能追溯到 supporting sources。Derived value 还应保留其 observation 和 rule lineage。一个结果如果不能解释“为什么知道”，就不应被当作稳定 organizational knowledge。

Absolute fabrication boundary

任何 accuracy、completion、title quality 或 commercial goal，都不能允许系统输出当前 evidence 不支持的 collectible fact。

需要特别保护的原则：

Canonical before commercial。
Evidence before claim。
Field boundaries are meaning。
Physical-copy facts stay anchored to the current item。
Supporting information does not silently expand the language。
Evaluation tolerance is not evidence permission。

一个答案即使碰巧正确，只要生成过程没有 admitted evidence 支持，仍可能属于 fabrication。

Composer boundary

CSM 回答：

> 这个 collectible 是什么？

Composer 回答：

> 对这个目标，应选择哪些已经被支持的信息，以什么顺序和形式表达？

Composer 可以 select、order、normalize、abbreviate、remove redundancy、应用 character budget，并生成 marketplace title、grading summary、collector search 或 agent search language。

Composer 不得：

发明缺失值；
为了文案效果把 phrase 移入错误 field；
把 marketplace prevalence 当作 identity proof；
覆盖当前 physical item 的 evidence；
因 target format 不方便而修改 CSM；
消费 NON_COMPOSABLE auxiliary attribute。

例如 Autograph、Rookie Indicator、Patch、Relic 可在 evidence 支持时成为 PROFILE_GOVERNED auxiliary attributes，由指定 eBay Composer 映射为 Auto、RC、Patch、Relic。这不会把 Search Optimization 变成 canonical field。

Governed learning loop

CSM 可以演进，但不能在线自我改写：

runtime observations / reviewed feedback
-> retained evidence
-> aggregation + provenance + privacy checks
-> recurring failure hypothesis
-> semantic review
-> CSM change proposal
-> frozen evaluation
-> versioned release
-> explicit Runtime upgrade and canary

关键治理规则：

单次 user edit、marketplace title 或 model response 只是 learning observation，不自动成为 semantic truth。
database 可以保存 evidence，但不是自动 semantic authority。
canonical field、field-specific evidence authority、golden answer、fabrication gate 和 stable release acceptance 属于 Founder-gated semantic decisions。
calibration 只能先生成 versioned shadow candidate；激活需要显式 review 和 consumer decision。
Runtime 必须 pin exact CSM version 或 commit，不能跟随 unversioned moving branch。

对 Collector Agent 的约束

未来 LYNCA 为客户培养 Collector Agent 时，Agent 至少必须遵守：

先声明和识别 admitted evidence，再生成 claim。
输出可审计的 fragmented Asset State，而不是只给一个流畅答案。
每个 canonical fragment 保留 evidence lineage 和 certainty。
不知道、看不清、证据冲突时，明确 abstain 或 unresolved。
把 target-specific listing、search 或 presentation 留给 Composer。
把用户 correction 记录为 learning evidence，不直接改写 canonical language。
不允许客户 Runtime、商业目标或 provider behavior 绕过 CSM fabrication boundary。

因此，Collector Agent 的长期差异化不只是“认识更多卡”，而是能在客户自己的 evidence、Registry、review 和 memory 中形成可信、可追溯、可演进的 collectible cognition。

OCS、CSM、Runtime 与 data 的边界

Layer	Owns	Does not own
OCS	组织为什么采用 CSM、关键概念、跨系统关系、长期 memory 与 governance context	CSM machine contracts、provider execution、production database
CSM	collectible language、field boundaries、evidence rules、Composer contracts、versioned semantic evolution	auth、queue、storage、provider dispatch、production deployment
Runtime	model / tool execution、storage、workflow、Composer execution、deployment	改写 CSM truth、静默修改 golden evidence
`csmdata`	frozen benchmark assets、content hashes、Founder-approved golden evidence	Runtime experiment、generated output、语义规则本身

CSM 与 Runtime、OCS、benchmark data 保持独立，不是组织割裂，而是为了让 semantic truth、execution、organizational memory 和 evaluation evidence 不互相污染。

Source snapshot 与继续阅读

本文于 2026-08-17 从 LYNCA-OS/lynca-csm 提炼。读取的 semantic baseline 为 f834c1e（0.4.0-alpha.0 candidate core），并参考当前 governance candidate d35eefd。该 snapshot 不是稳定版本声明；后续使用仍应 pin 已确认的 exact release / commit。

核心来源：

csm/00-core-definition.md
csm/10-canonical-language.md
csm/20-collectible-understanding.md
csm/25-identity-layers.md
csm/30-evidence-and-certainty.md
csm/35-field-evidence-authority.md
csm/40-composer-boundary.md
csm/50-evolution.md
docs/architecture.md
docs/learning-loop.md
governance/decisions/DP-0002-founder-authority-consumer-and-pai.md

README.md