用途
Broker Vocabulary 提供一套对所有券商都通用的术语，用来命名一个系统拥有何种接入路径、在不借用某一厂商措辞的前提下建模订单的生命周期，以及判断一个关于交易场所的说法究竟有多少可信度。
它存在的理由是：券商知识通常按厂商分别撰写，读起来仿佛每个问题都是独一无二的。但大多数问题并非如此。会话排他性、为人类设计的登录、会说谎的连接标志、证明不了任何事情的 place 调用，以及人人重复却无人测量的事实，都是接入路径的属性，会在彼此毫无共同点的券商之间反复出现。
五种接入原型
| 原型 | 含义 |
|---|---|
| direct-api | 云端 API，本机没有厂商组件 |
| local-terminal | 厂商应用在本地运行，持有会话，可能自行处理订单 |
| vendor-gateway | 厂商运营的网关或协议引擎，通常需要认证 |
| bridge | 位于平台与券商之间的第三方软件，双方都不运营它 |
| in-platform | 运行在厂商自有应用内部的代码 |
在设计任何东西之前先命名原型。它决定什么必须运行、什么会随什么一起消亡，以及你可用的恢复方案是哪一种。厂商不等于原型：同一个券商可能对某个产品是 direct-api，对另一个产品是 local-terminal（access-archetypes.md 以 IBKR 作为反例），因此要说明你所在路径的原型，而不是厂商名称。在此前提下，Interactive Brokers 和 MetaTrader 5 在本市场所记录的路径上都是 local-terminal，这正是它们的运维问题相同的原因。共享原型可以迁移运维经验，但不能迁移事实。
第二条轴线独立于原型，区分单一券商主体与多券商平台主体——后者在同一软件背后坐着许多相互独立的券商。IBKR 是单一券商，MetaTrader 5 是多券商平台，在某个券商上测得的事实甚至不保证对同一平台上的下一个券商成立。
证据
关于交易场所行为的说法按证据阶梯排序，从你自己的探测记录一直排到搜索引擎或 AI 摘要——后者在任何强度上都不算证据。该阶梯共有六个等级，仓库中每一条关于券商行为的说法都带有三种来源标签之一：MEASURED、DOCUMENTED 或 ASSUMED。
参考材料
- access-archetypes.md：五种原型、它们之间变化的内容（会话状态、影响范围、你必须保持存活的东西、各自新增的故障面）、区分单一券商与多券商平台的第二条轴线，以及两个已集成券商在两条轴线上的位置。
- order-lifecycle-reference-model.md：以谁确认了什么为键的参考状态机、可以拒绝订单的三个层、三个标识符以及取消或替换后仍然存活的部分、一次成功的 place 调用证明了什么，以及如何把厂商的词汇映射到本模型。
- session-and-recovery.md：三种会话排他性机制、无人在环的认证、会说谎的连接标志、出现间隙后对地面真相的核对，以及必须持久化的内容。
- evidence-and-probes.md：证据阶梯、来源标签、如何设计一个能回答问题的探测，以及演示环境无法解决的那些问题类别。
添加厂商技能
本插件中新增的厂商技能（与 ibkr 和 mt5 并列）要通过使用这套词汇而非另造一套来获得其位置。它应包含四个部分，形状与现有两个厂商技能一致：Quick start（让人今天就能跑起来的少数几个决策）、Key decision points（默认值与何时偏离，以表格呈现）、Symptoms to entry points（从用户看到的现象到解释它的参考文件的表格）、Reference materials（每个参考文件覆盖什么，让读者无需打开多个文件就能选对）。
无论章节结构如何，有两件事贯穿每个厂商技能。第一，对任何重要事实标明来源：它是在真实账户上测得的、从文档中读取并引用的，还是假设的。未标记的说法读起来比实际更确定，读者无法分辨哪个事实值得信任、哪个值得复核。第二，把厂商自己的订单状态和订单类型词汇显式映射到 order-lifecycle-reference-model.md 的名称上，而不是默默使用厂商的措辞、让读者自己去翻译。ibkr 和 mt5 都带有一张做这件事的表格，遵循它们的形状即可。