参伍术语表
本页用于查询参伍术语:中英文名称、对应的代码标识及含义。带链接的术语另有专门页面 详细说明,其余术语以本页和 API 文档中的定义为准。
编写参伍文档时,请在中英文中分别使用表中的规范写法,代码标识保持原样,并避免使用最后
一张表中标为已弃用的写法。首次出现时可以同时给出英文或代码名,例如模拟插件
(simulation plugin)或决策票据(DecisionTicket)。仓库中的
docs/terminology.md
是术语的权威来源,本页与之同步。
产品与运行时边界
Section titled “产品与运行时边界”| 中文规范写法 | English | 代码或 API | 含义与使用位置 |
|---|---|---|---|
| 参伍 | Canwu | Canwu |
产品名,也是对外 API 的主要入口;不要把品牌名当作普通名词翻译。 |
| 无界面历史模拟引擎 | headless historical simulation engine | — | 参伍的产品类别;负责模拟历史世界,不负责画面、音频和正式产品界面。 |
| 模拟内核 | simulation core | canwu-sim |
持有可变权威状态、调度、结算、持久化与重放的私有运行时。 |
| 上层应用 | host application | — | 嵌入参伍的游戏、研究工具、服务、客户端或智能体系统;中文不使用“主机程序”。 |
| 对外 API | public API | canwu-api |
应用代码应从这里接入;版本兼容性也以这里为准。 |
| 模拟运行 | simulation run | run_id |
具有独立身份、输入、状态和证据的一次连续执行。 |
| 场景 | scenario | Scenario |
创建模拟时使用的初始世界和配置。 |
| 权威状态 | authoritative state | SimulationSnapshot |
由参伍持有并验证,作为承诺、持久化和重放基础的状态。 |
| 真值 | ground truth | — | 权威状态中的事实,无论某个角色是否知道。 |
| 角色相对视图 | actor-relative view | CanwuViewer, ViewerContext |
根据一个角色的知识和权限(authority)生成的读取结果,不会暴露全知状态。 |
| 只读快照 | read-only snapshot | WorldSnapshot |
供受信任读取使用的脱离运行时状态值,不是实时可变引用。 |
| 模拟粒度 | simulation granularity | SimulationGranularity |
内核的领域无关粒度:aggregate、group、actor。CM 应在自己的整合包中映射为 Population、Special Group、Character。 |
| 聚合层 | aggregate | SimulationGranularity::Aggregate |
粗粒度的人口、经济或区域状态;上层应用可以将其映射为 Population。 |
| 群体层 | group | SimulationGranularity::Group |
有边界的社会、制度、军事或组织群体;上层应用可以将其映射为 Special Group。 |
| 角色层 | actor | SimulationGranularity::Actor |
具有知识和权限的个人或其他主体;上层应用可以将其映射为 Character。 |
时间、输入与结算
Section titled “时间、输入与结算”| 中文规范写法 | English | 代码或 API | 含义与使用位置 |
|---|---|---|---|
| 现实时间 | wall time | — | 上层应用实际经历的时间,不直接写入模拟状态。 |
| 模拟时间 | simulation time | SimTime, SimDuration |
由参伍结算、可确定表示的时间。 |
| 表现时间 | presentation time | — | 客户端动画与插值时间,可以是小数,但不属于权威状态。 |
| 命令 | command | Command, CommandEnvelope |
经过结构、前置条件和权限校验后改变权威状态的类型化请求。 |
| 领域命令 | domain command | Command::Plugin |
由领域整合定义并经公开规范入口验证的类型化意图。 |
| 规范化输入 | canonical ingress | IngressRecord |
命令、通信、信息和调度系统共用的持久化确定性输入路径。首次出现时可附英文。 |
| 准入 | admission | — | 决定哪些待处理输入进入某个边界的过程和切点;它不是 ingress 的同义词。 |
| 插件输入撤回 | plugin ingress cancellation | cancel_plugin_ingress, IngressPayload::PluginCancellation |
在到期之前终止撤回一项仍在排队的插件输入,并作为独立日志记录保存;被撤回的输入永远不会被准入,也不会发生回滚。 |
| 撤回权限 | cancellation authority | IngressCancellationAuthority |
撤回排队插件输入的主体:上层应用撤回自己提交的公开数据包,所属插件以注册许可撤回其内部数据包类型,或由安排该输入的插件的边界系统撤回。只有签发者可以撤回。 |
| 调度工作 | scheduled work | — | 具有确定模拟到期时间和插入顺序的工作。 |
| 结算边界 | boundary | BoundaryRequest, BoundaryRecord |
一次经过验证、要么全部提交要么整体回滚的结算:准入工作,按固定阶段运行系统,记录证据。 |
| 结算阶段 | settlement phase | BoundaryPhase |
固定边界执行顺序中的一个位置,不代表一套独立结算算法。 |
| 原子提交 | atomic commit | — | 一次性应用边界中所有通过验证的变化,避免暴露部分状态。 |
| 回滚 | rollback | — | 边界失败时同时恢复状态、证据、计数器和随机位置。 |
| 转移清单 | transition manifest | TransitionManifest, BoundaryDirective::RegisterTransitionManifest |
协调插件为一次多所有者转移作出的声明,列出参与插件、预期记录版本和唯一的就绪边界。参与者在该边界第 10 阶段用 StageTransitionWrite 暂存写入;清单之外的第 10 阶段指令不受影响。 |
| 转移审计 | transition audit | TransitionAuditRecord |
内核在第 11 阶段对本边界就绪的每份清单所做的检查。清单仅被部分参与者暂存,或预期版本不符,都会使整个边界失败;没有任何参与者暂存的清单则过期。提交或过期的结果作为只读边界证据,供第 12 阶段系统读取。 |
| 中文规范写法 | English | 代码或 API | 含义与使用位置 |
|---|---|---|---|
| 插件 | plugin | — | 泛称;可能与 Codex 等工具插件混淆时必须加限定词。 |
| 模拟插件 | simulation plugin | SimulationPlugin |
实现公开插件契约并注册到参伍运行时的执行单位;其名称、版本和语义哈希标识加载与精确重放所需的可执行语义。 |
| 模拟领域扩展 | domain extension | — | 建立在公开引擎契约上的可选领域交付包,可包含一个或多个插件、领域类型、schema、命令、查询和辅助 API;没有要求实现的 DomainExtension trait。 |
| 模拟模块 | simulation module | — | 面向人的完整模拟能力名称,例如“社会传播模拟模块”;它可以由一个领域扩展及其插件实现,但本身不是引擎契约。 |
| 文化系统 SDK | culture system SDK | canwu-culture |
已正式发布的可选文化编写、编译与生命周期扩展,建立在 canwu-society 之上;负责校验内容并生成确定性执行计划,不进入模拟内核。 |
| 法律制度化 | legal institutionalization | canwu-law |
位于文化等社会证据下游的实验性扩展:推进法律程序,经控制者决策记录待处理法律意图,并在插件边界内原子写入法律渊源、规则和不可变版本;文化不能直接写入法律状态。 |
| 法律渊源版本 | legal source version | LegalSourceVersion |
不可变的法律渊源记录,可表示制定文书、判决、协议、习惯认可结论、法律承受表或其他由内容配置的法律主张依据。 |
| 法律规则 | legal rule | LegalRule |
一项有界规范规则的稳定身份与可变 head;其不可变变更保存在 LawVersion 记录中。 |
| 法律版本 | law version | LawVersion |
绑定稳定 LegalRule 的仅创建、不可变规范变更记录,保存确切渊源与前序引用、规范关系、适用范围、生效与效力状态以及证据;执行情况另行建模。 |
| 法律记录引用 | legal record reference | LegalRecordRef |
分片法律运行时中法律对象的精确 kind 与身份;法律插件拥有自己的对象/版本语义,并分别持久化 plan、directory、shard 与 archive-head 记录,因此它不是内核 DomainRecordVersionRef。 |
| 文化目标代际引用 | cultural target generation reference | CulturalTargetGenerationRef |
法律提案或版本引用的精确目标与 generation,防止退休或重新激活把旧证据静默绑定到新一代。 |
| 文化执行计划 | compiled culture plan | CompiledCulturePlan |
从文化定义编译出的外部不可变、绑定内容哈希的运行时计划,包含紧凑 ID、反向索引、预算和生命周期策略。 |
| 休眠目标 | dormant target | Dormant |
没有参与人口或已准入工作的文化目标;它离开热结算索引,但保留显式重新激活描述。 |
| 退休目标 | retired target | Retired |
从动态热状态移除的文化目标;历史身份和证据仍通过墓碑与归档契约保留。 |
| 文化结算插件 | culture boundary plugin | CultureBoundaryPlugin |
在引擎内完成文化结算的插件形式:每月第 7 阶段系统消费已准入的接触信号批次,保存文化状态,并把 society 生命周期变化交给 society 插件;society 插件仍是唯一写入者。一次运行只能在它与由上层应用驱动的 CulturePlugin 流程之间二选一。 |
| 接触信号批次 | exposure signal batch | CultureExposureSignalBatch, culture_exposure_v1 |
信息或通信提供方在解决访问与解释之后产生的有界、带证据的报告,说明哪些 cohort 接触了某一文化目标代际;它在之后的边界准入。 |
| cohort 人口校准 | cohort headcount rebase | CohortHeadcountRebaseV1, cohort_headcount_rebase_v1 |
把 cohort 人口重置为所引用外部存量记录的规范化输入;输入准入时,该记录必须是当前版本。下一次 Daily society 结算会按确定性的整数最大余数法,按比例重算每个分布。 |
| 表决权重 | vote weight | ProcedureStageDefinition::seat_weights |
某席位的选票在程序阶段中所占的整数权重;未列出的席位权重为 1。quorum 与 threshold 都按权重合计;否决是席位权力,从不加权。 |
| 表决单元 | unit block | ProcedureStageDefinition::block_of_seat |
程序阶段中作为一个整体表态的一组席位,其立场取组内席位的加权多数;双方加权票数相等或没有计入选票的单元不表态。 |
| 单元门槛 | block threshold | ProcedureStageDefinition::block_threshold |
带表决单元的阶段除满足加权席位规则外,还须有多少个表决单元取 For 立场才能通过。 |
| 决定票席位 | casting seat | casting-seat:<seat> tie-break |
程序平局规则指定的席位:取 For 与 Against 的单元数相等时,该席位自己的 For 票可以增加一个 For 单元。该席位必须属于每个带表决单元的阶段;status-quo 平局规则则不增加单元。 |
| 征询阶段 | consultation stage | ProcedureStageKind::Consultation |
仅供咨询的程序阶段。其席位收到标注为 advisory 的票据,选票作为参与证据保存,但从不计入结果;阶段在截止时间完成,并开启下一阶段。 |
| 技术模拟扩展 | technology simulation extension | canwu-technology |
处理技术修订、证据、本地能力、实施、按用途采用和传播机会的可选通用扩展,不是全局科技树。 |
| 外部传播来源 | external transmission source | ExternalTransmissionSourceV1 |
模拟之外的实践传播来源,例如地图外的师傅;以初始场景中的内容记录和声明的可靠度代替实时能力记录,并由目的地开启传播机会。 |
| 历史研究插件 | historical research plugin | canwu-history-research |
记录研究者对证据所作有界评估的可选模拟插件,不会改变基础技术真值。 |
| 命令插件 | command plugin | register_command() |
注册带 schema 校验命令及其处理器的模拟插件。 |
| 边界系统 | boundary system | BoundarySystemContract |
在结算阶段运行,并声明读取、写入、资源与随机范围的系统。 |
| 领域 schema | domain schema | DomainRecordType |
插件所拥有领域数据的版本化结构契约;代码相邻的中文正文保留 schema。 |
| 领域记录 | domain record | DomainRecord |
由插件拥有并持久化,而非属于通用世界模型的类型化领域状态。 |
| 插件组件 | plugin component | PluginComponentRecord |
通过声明的键与可见性附加的插件自有组件状态。 |
| 插件语义环境 | plugin semantic environment | PluginDescriptor |
加载或精确重放时必须匹配的插件身份、版本和语义哈希集合。 |
| 参考内容包 | reference content pack | — | 由第一方或下游提供的版本化、带命名空间、可序列化领域定义、场景数据、本地化和来源信息包;它向领域扩展提供内容,不是内核子系统或求解器。 |
| 参考整合包 | reference integration | — | 使用对外 API 将通用领域能力映射到小型世界、生产、信息或社会模型的可替换实现;可以包含运行时插件和上层应用适配代码。 |
| 入门套件 | starter kit | — | 将兼容的参考内容包和参考整合包组合成完整纵向切片的可运行上层应用与组合示例;它是参考代码,不是特权引擎路径。 |
| 财政模拟扩展 | fiscal simulation extension | canwu-fiscal |
通用财政程序领域扩展;负责法规、地区采纳、核算、授权、减免、凭证、审计、聚合与持有人相对知识报告,不负责资源余额与转移。 |
| 历史财政语境 | fiscal historical context | FiscalHistoricalContext |
用于判断活动时期和改革候选的显式历史年份与模式;只通过规范化输入改变,不会自动实施改革。 |
| 财政覆盖单元 | fiscal coverage cell | FiscalCoverageCell |
一个“时期 × 地区 × 机制”单元,通过确定性优先级解析为有支持、原型回退、明确未知或不适用。 |
| 财政执行凭证 | fiscal execution receipt | FiscalExecutionReceiptPacket |
引用精确类型化适配结果版本的结算请求;准入后的凭证从这些结果派生外部观察到的数量与处置。在单个财政运行时状态内,每个精确版本和每个 (证据种类,外部操作 ID) 组合最多结算一张凭证;凭证不拥有资源真值。 |
| 代理角色 | acting actor | FiscalAuthorityBinding::acting_actor |
只有当权限依据仍是其记录的当前版本时,才可为某个授权绑定执行财政行动的第二个角色;常设授权角色不受影响。 |
| 权限依据 | authority basis | FiscalAuthorityBinding::authority_basis, MovementOrderRequestV1::authority_basis |
授予权限的精确应用记录版本,其记录种类须由所属插件声明。它可以授予财政授权绑定中的代理角色权限,也可以授权一条移动命令(MovementOrderRequestV1)移动所有者以外的对象。核验时它必须是其记录的当前版本;该记录出现新版本或退役后,财政授权随之结束。 |
| 资源模拟扩展 | resource simulation extension | canwu-resource |
可选的守恒数量扩展,负责精确资源/单位版本、账户、受保护底线、需求、预留、分配、转移、验收交付、消费、损耗、履约和确定性凭证;不拥有货币或市场。 |
| 生产模拟扩展 | production simulation extension | canwu-production |
可选的生产资产扩展,负责工艺、地点、设施、产能、工单、在制品、执行、项目和产出结算;生产地点形态与要求是版本化数据,不是统一建筑等级。 |
| 资源能力阶段 | resource capability stage | ResourceCapabilityStage, ResourceCapabilityRevision |
带生效期的修订记录,把某项资源放在从潜在储量到交付验收之间的某个阶段:潜在、已观测或勘查、已探明、技术上可开采、在产地点、路线可达、已交付验收。每条修订都引用其模型卡。 |
| 受保护存量底线 | protected stock floor | ProtectedFloorPolicyRevision |
把种子、口粮或应急库存排除在普通分配之外的版本化政策;只有另行授权的行动才能突破。 |
| 账户损耗 | account-level loss | ResourceOperationRequestV1::RecordLoss |
不经转移、直接从单个账户扣减并引用原因的损耗;计入守恒中的已准入损耗,不动用已预留存量,除非明确允许,否则遵守受保护底线。 |
| 原子交换 | atomic exchange | ResourceOperationRequestV1::BeginExchange, ResourceExchangeTermsV1 |
两项转移的发起在同一个结果下一起准入或一起拒绝。每条交换腿的完成租约由其来源保管人持有,并绑定到双方约定条款的摘要;之后两项转移独立结算。 |
| 本地验收 | local acceptance | ResourceTransferDispositionV1::AcceptLocal |
当两个账户声明相同的地点范围时,不经运输执行即可结算尚未发运的转移,并引用精确的交接记录。 |
| 地点范围 | place scope | ResourceAccount::place_scope |
由上层应用在场景安装账户时声明、不可更改的账户存量地点标识;引擎从不推断它,未声明时不能本地验收。 |
| 动用授权 | access grant | ResourceAccessGrantV1, ResourceDemandSourcePolicyV1::Granted |
授权保管人引用精确权限证据作出的记录化同意:被授权方可在有效期内、在上限以内动用授权方某一精确资源与单位版本的存量。每次扣减都由被授权方自己的完成租约授权,不会回退到其他账户。 |
| 在制品 | work in progress | WorkInProgress |
已进入尚未完成的生产执行,并绑定精确工艺、设施、资源和证据的投入;既不是可用库存,也不是已结算产出。 |
| 实际产出 | realized output | realized_output_per_mille, realization_evidence |
生产执行完成时以工艺名义产出的千分比表示的产出,按向下取整缩放后进入产出结算;任何非名义比例都需要工艺版本声明种类的精确证据记录。 |
| 移动生命周期扩展 | movement lifecycle extension | canwu-movement, MovementPlugin |
负责运输记录生命周期的可选扩展:准入移动命令、在到期时结算路段、分配运力池,并发布持有人相对的移动报告。事故、危险及其随机抽样仍属于应用系统。 |
| 军事模拟扩展 | military simulation extension | canwu-military |
可选的军事领域扩展,负责部队、行动、战斗、占领、军事知识,以及由其他领域结算并确认的待处理效果;不是通用战斗模型。 |
| 军事补给参考消费者 | force-supply reference consumer | canwu-force-supply-reference |
可替换的整合包,证明军事后勤可以消费公共资源 API,同时只拥有军队本地需求、战备、短缺后果和征发 saga;不是通用战斗模型。 |
| 本地稀缺度投影 | local scarcity projection | LocalScarcityProjection |
脱离式、持有人绑定的读取模型,解释可观察供给、需求、缓冲、路线可达性、安全与政策;不声称存在价格。 |
| 价格压力投影 | price-pressure projection | PricePressureProjection |
只有存在合格的价格证据和版本化解释规则时才生成的脱离式读取模型;既不形成市场,也不结算交易。 |
证据、随机性与持久化
Section titled “证据、随机性与持久化”| 中文规范写法 | English | 代码或 API | 含义与使用位置 |
|---|---|---|---|
| 事件 | event | SimEvent |
权威证据中的可序列化因果记录,不是 UI 通知。 |
| 因果关系 | causality | CauseRef |
解释事件或变化为何发生的已记录关系。 |
| 相关标识 | correlation ID | correlation_id |
将同一权威因果根产生的记录归为一组的稳定标识。 |
| 随机流 | random stream | RandomStreamKey |
由已声明机制拥有的具名、版本化确定性随机来源。 |
| 抽样证据 | draw evidence | RandomDrawRecord |
一次确定性随机抽样所记录的流、范围、操作和结果。 |
| 随机决策策略 | random decision policy | DecisionPolicyKind::Random |
由声明过的边界系统使用可重放抽样证据结算的有界票据选择器,不是通用世界事件生成器。 |
| 决策选项权重 | decision option weight | DecisionOptionWeight |
将一个有界抽样映射到票据既有选项的规范 option ID 与非负整数权重。 |
| 操作定址随机抽样 | operation-keyed random draw | random_sample_for_operation |
按稳定 cause、operation ID、目标、occurrence、purpose 和随机流身份定址的抽样,使重试与重放不会消费另一份结果。 |
| 评估轨迹 | evaluation trace | EvaluationTraceRecord, BoundaryDirective::RecordEvaluationTrace |
有界的边界证据,逐项说明某条应用规则如何为一个对象得出一个整数结果。它不属于状态;持有人只能通过 CanwuViewer::evaluation_traces 读取关于自身实体的轨迹,或者在轨迹评估之前其账本就已得知的对象的轨迹。 |
| 资源预留 | reservation | ReservationRequest |
分配前对守恒资源池提出的声明式申请。 |
| 需求来源策略 | demand source policy | ResourceDemandSourcePolicyV1 |
在稀缺资源分配前选择合格供给账户:匹配资源池中的账户、由申请者保管的有界精确账户列表,或在动用授权下列出的授权方账户。只有 Granted 形式带有跨保管人的权限,且仅限于该授权。 |
| 资源分配 | allocation | ReservationAllocation |
在供给约束下确定性结算竞争申请的结果。 |
| 可见性 | visibility | StateVisibility |
控制状态和证据可以到达哪些读取者的策略。 |
| 快照 | snapshot | SimulationSnapshot |
恢复时必须完整校验的持久化状态映像。 |
| 检查点 | checkpoint | SimulationCheckpoint |
可与后续日志证据衔接的已验证紧凑基础状态。 |
| 检查点日志 | checkpoint journal | CheckpointJournal |
检查点和后续证据的组合,用于紧凑持久化与恢复。代码相邻正文可直接使用类型名。 |
| 精确重放 | exact replay | replay_from_journal() |
从已记录输入与证据重建并验证同一次运行,不重新调用外部选择。 |
| 平行现实 | alternative reality | — | 从共同的先前状态选择不同的输入形成新的平行现实,不是精确重放。 |
| 派生分支 | fork | fork() |
从现有时点复制出的独立模拟,可接收新输入;指 API 时保留 fork。 |
| 状态承诺 | state commitment | CommitmentRoots |
绑定权威状态或证据、供校验使用的密码学承诺。 |
| 语义哈希 | semantic hash | semantic_hash |
描述插件行为的稳定值,用于拒绝不兼容的加载或重放环境。 |
| 精确领域记录版本 | exact domain-record version | DomainRecordVersionRef, domain_record_version() |
同时绑定领域记录身份、版本和建立来源;当前记录更新后,历史证据仍保持原有含义。 |
角色、知识与决策
Section titled “角色、知识与决策”| 中文规范写法 | English | 代码或 API | 含义与使用位置 |
|---|---|---|---|
| 角色 | actor | PersonId |
其知识和权限会约束视图或行动的人物或世界内主体。 |
| 人物可用性 | person availability | PersonAvailability |
某个人物的核心生存状态与人身状态,只能由声明过的边界系统修改。未存活、被拘押或被俘的人物不能签发命令、作出决策,也不能作为控制者的权限人物;没有记录时视为存活且自由。 |
| 生存状态 | life state | LifeState |
Alive、Dead 或 Missing;人物可用性的一部分。 |
| 人身状态 | custody state | CustodyState |
Free、Detained、Hostage、Captive、Hiding 或 Exile;人物可用性的另一部分。默认只有 Detained 和 Captive 会阻止准入。 |
| 人物创建 | person creation | BoundaryDirective::CreatePerson, PersonDraft |
第 7 阶段根据应用草稿和来源证据创建人物、由引擎分配 ID 的指令。回执把该 ID 绑定到提出创建的插件、系统和相关标识;新人物从下一边界起可见。 |
| 角色知识 | actor knowledge | ActorKnowledge |
某一角色知道的内容及来源、可信度和时间,与真值分开保存。 |
| 报告 | report | EventKind type "report_dispatched" |
在更新角色知识前,在角色之间签发或送达的信息。 |
| 持有人相对知识 | holder-relative knowledge | KnowledgeHolderRef, KnowledgeReadCut |
在精确读取切面上从某个人、机构、官署或其他持有人账本读取的事实,不能改读全知状态。 |
| 持有人规划快照 | holder planning snapshot | planning_snapshot_from_holder_knowledge, KnowledgeReadCutDigest |
只用某个持有人账本在读取切面上声明的端点和连接构建的路由 PlanningSnapshot,同时返回读取集摘要,证明规划读取了什么。 |
| 通信 | correspondence | CorrespondenceOperation |
把定向通信需求与信息投递,以及必要的物理或信号运输组合起来的流程。 |
| 受托承运人 | delegated carrier | delegate_carrier_v1, InitiateCorrespondenceRequest::carrier_delegation |
发送者以外、以自己的委托命令接受承运的承运人;其声明指明发送者,并覆盖每次派发。规划读取承运人的账本,引擎不会把承运人的任何知识发布给发送者。 |
| 承运人扣押 | carrier seizure | CorrespondenceIncidentKind::CarrierSeized |
承运人连同信件被他人夺走的事故。与截取不同,它会终止投递尝试:终态扣押交接之后,运输执行只能由其所有者关闭,只有承运持有人会收到尝试报告。 |
| 真伪判定 | authenticity finding | AuthenticityFinding |
解读信息的持有人作出的判断,绑定到所解读 representation 的精确版本,说明是否接受其声称的来源,并附依据和置信度。伪造被识破的概率仍由应用抽样决定。 |
| 改道 | reroute | ItineraryRevision |
因灾害或路线知识变化,为同一个投递尝试建立后继行程。 |
| 外部条件 | external condition | ItineraryRevisionReason::ExternalCondition |
引用应用所有的条件记录精确正数版本及应用标签的改道原因;运输只记录引用,不解释条件本身。 |
| 投递重试 | delivery retry | DomainReference 角色 "previous_attempt" |
终态失败后新建的后继投递尝试,不是对旧 attempt 的改道。 |
| 移动命令 | movement order | MovementOrder, MovementOrderRequestV1 |
一条已准入、不可变的意图:沿规划路线把一个或多个移动主体从起点移到终点。canwu-movement 通过其 Order 操作准入移动命令,并创建对应的运输执行;移动所有者以外的主体需要权限依据。 |
| 人员群体 | persons group | MovementSubjectRole::PersonsGroup |
作为一个整体移动的一群人所对应的移动主体,以正数人数作为数量;其身份通常是应用领域记录。 |
| 扣押交接 | seizure handoff | HandoffKind::Seizure |
行程之外的主体夺取保管权时形成的交接,记录夺取方身份。终态扣押以失败路段同时作为起止路段,保管权离开行程,此后运输执行只能由其所有者关闭。背后的事件和权限仍属于应用系统;其余交接均为计划交接。 |
| 运力池 | capacity pool | TransportCapacityPoolV1 |
由一个持有人提供、在时间窗口内可以互换的运输能力数量,例如渡船班次或驿马。已确认和已消耗的预订占用它;每次变化都会推进其修订号,便于分配证据引用。 |
| 预订分配 | booking allocation | allocate_capacity_bookings, CapacityBookingAllocationEvidenceV1 |
针对某一运力池修订、结果与输入顺序无关的纯函数分配:按优先级、窗口开始时间、平局决胜键、准入序号和预订标识依次处理请求,每项预订要么全额确认,要么记录原因后失败。它从不抢占已确认的运力。 |
| 投影 | projection | — | 不暴露权威领域状态而生成的角色范围物化表示。 |
| 权限 | authority | CommandAuthority |
发出命令或执行动作的已验证权利;authoritative state 应译为“权威状态”。 |
| 签发者 | issuer | Issuer |
命令声明的来源身份;权限验证决定该身份是否可以行动。 |
| 控制者 | controller | DecisionControllerBinding |
绑定到席位、负责作出决策的实体或过程;代码相邻正文可附 controller。 |
| 席位 | seat | seat_id |
可以绑定控制者的稳定决策角色。 |
| 决策策略 | policy | DecisionPolicy |
从当前选项中作出选择的人类、外部服务、LLM 或确定性评估器。 |
| 前置规则效用策略 | guarded utility policy | GuardedUtilityPolicy |
组合策略:有序前置规则可以选择、推迟或排除选项;加权效用为其余选项评分;可选的随机平局决胜处理分数接近的最高选项。其语义哈希把配置绑定到控制者。 |
| 决策阶段 | decision stage | DecisionStage |
组合策略中产生决定的阶段(Guard、Utility 或 Random),与触发的前置规则一起记录在决策轨迹上;它与结算阶段无关。 |
| 随机平局决胜 | random tie-break | DecisionOutcome::PendingRandom |
控制者须显式启用的路径:前置规则效用策略只列出分数接近的最高选项,再由边界系统以一次均匀的操作定址随机抽样从中选择。 |
| 决策票据 | decision ticket | DecisionTicket |
请求一个控制者从带版本的当前有效选项中选择的持久化对象。 |
| 前序票据 | parent ticket | DecisionTicket::parent_ticket |
新票据所接续的终态票据:可以是同一决策者的票据(例如为另一控制者重新开启的已取消票据),也可以是经席位继任接续的票据。该关联会复制到新票据的决策轨迹上。 |
| 席位继任 | seat succession | DecisionControllerBinding::seat_id, DecisionTicket::parent_ticket |
从终态票据到新票据的接续关系:新票据的指定控制者与原票据的控制者绑定同一个非空席位,因此继任者可以接续前任的决策,而不必是同一决策者。 |
| 决策选项 | decision option | DecisionOption |
决策票据提供的一个候选选择。 |
| 决策尝试 | decision attempt | DecisionAttemptRecord |
一条已准入决策请求的权威记录,写明该请求被接受还是被拒绝。请求可以是注册控制者,也可以是开启票据、替换票据选项、解决票据或取消票据。 |
| 决策轨迹 | decision trace | DecisionTrace |
用于解释和重放的评分、证据、策略身份、所选选项与结果。 |
| 规范写法 | 已弃用或受限替代写法 | 范围与迁移说明 |
|---|---|---|
| 模拟内核 / simulation core | kernel |
受限:产品和接入文档使用 模拟内核 与 simulation core;kernel 可继续用于架构和内部实现说明。 |
| 上层应用 / host application | 主机程序 / host program | 已弃用:嵌入参伍的游戏、服务、客户端、研究工具或智能体系统统一使用 上层应用 与 host application。 |
| 对外 API / public API | public facade | 已弃用:接入边界和整体 API 表面统一使用 public API。 |
| 模拟插件 / simulation plugin | 运行时模拟插件 / runtime simulation plugin;模拟规则插件 / domain plugin | 受限:仅在区分运行时插件与 Agent 工具,或说明插件领域角色时使用长写法;它们不是独立插件类别。 |
| 结算边界 / boundary | transaction, settlement boundary | 已弃用:参伍的验证单元英文统一使用 boundary,与 settle_boundary 和 BoundaryPhase 一致;中文规范写法仍为 结算边界。 |
| 平行现实 / alternative reality | 反事实分支 / counterfactual branch;branch(因不同输入形成新因果运行时) | 已弃用:不同输入形成的新因果现实统一使用 平行现实 与 alternative reality;API 操作和复制出的模拟继续使用 fork。 |
| 权限 / authority | permission(指 CommandAuthority 时) |
受限:已验证的行动权统一称为 权限 与 authority;独立的运行策略上下文继续使用 permission profile。 |
新增或重命名公开概念时,应在同一改动中更新仓库术语表和本页的中英文版本。只有在 对应的专题页面已经存在时才添加链接;在此之前,本术语表本身就是该词的公开定义。