OPC Vault 如何工作
从意图输入到结果交付，了解 Cortex 引擎、三层资产模型、钱包计费与合同系统的完整运作逻辑
什么是 OPC Vault
OPC Vault 是一人公司的 AI 操作系统。它解决的核心问题是：个人创作者的能力长期被低估，且难以变现。
一个独立开发者、设计师或研究员，可能拥有高度专业化的工作流、独特的分析框架、或反复验证过的 AI 提示工程。这些能力过去只能靠接单、出课、写作来间接变现——门槛高、效率低、规模化困难。
OPC Vault 让这些能力变成可以被他人直接调用的数字资产：
- →API 化 — 你的 Skill/Agent 获得专属 opc_xxx 端点，按次调用
- →资产化 — 四级授权定价（personal / team / commercial / exclusive）
- →市场化 — 在 OPC Vault 平台对外展示，其他用户可直接购买调用
- →合同化 — Outcome Contract 支持承接定制项目，资金托管，里程碑交付
一句话定位：把你的专业能力变成可被他人调用、按次计费、甚至可签合同的数字服务。
Cortex 如何工作
Cortex 是 OPC Vault 的意图引擎。你用自然语言描述想要完成的事，Cortex 负责理解、规划、执行，全程 SSE 流式输出，实时可见。
四步执行链路
意图分类
LLM 将输入分类为三种类型：QUERY（信息查询）、PLAN（执行规划）、EXECUTE（直接执行）。类型决定后续处理路径的复杂度。
语义检索
使用 pgvector 扩展在 PostgreSQL 中进行 1536 维向量检索，cosine similarity 阈值 > 0.5。匹配结果按相关度排序，输出最合适的 Capability 候选列表。
执行计划生成
LLM 基于检索结果生成分阶段执行计划，每阶段绑定具体的 Capability（Skill/Agent/Workflow），估算时间和成本，用户可预览后确认。
SSE 流式执行
每个执行步骤通过 Server-Sent Events 实时推送进度到前端。你可以看到每一步的开始、中间状态、完成时间和输出摘要，直到最终结果交付。
三层资产模型
OPC Vault 将个人能力抽象为三层资产，每层有独立的创建方式、定价机制和授权模型：
内容层
将你的知识沉淀为结构化内容资产。上传后系统自动提取语义向量，使其可被 Cortex 检索引用。定价方式：单次访问授权或订阅制。
适合：研究报告、教程文档、设计稿、播客录音等。
代码层
将可复用的代码工具发布为授权资产。支持四级许可定价：Personal（个人使用）、Team（团队共享）、Commercial（商业授权）、Exclusive（独家购买）。
适合：自动化脚本、API 封装库、浏览器插件、数据处理工具等。
智能层（核心）
最高价值层。将你的 AI 工作流封装为可被直接调用的 Capability。购买后自动获得 opc_xxx 专属端点，支持 API 直连或 Cortex 意图触发。
Skill：单一功能（音频转写、摘要生成）。Agent：多步推理工作流。Bundle：多个 Skill/Agent 的能力组合包。
钱包与计费
OPC Vault 使用内置钱包系统处理 Capability 的按量计费，支持 Outcome Contract 资金托管。以下是核心设计决策的说明：
钱包精度：Decimal(20,0) CENTS
钱包余额以「分（CENTS）」为最小单位存储，使用 PostgreSQL Decimal(20,0) 类型，完全避免浮点数精度误差。¥1 = 100 CENTS。这一设计参考了 Stripe 等支付系统的最佳实践。
按量计费流程
每次调用 Capability 时，系统从调用方钱包扣除 Capability 创作者设定的价格（以 CENTS 结算），实时记录到 ExecutionFlow 表。扣款在调用发起时原子性完成，无需每次经过 Stripe，适合高频低额场景。
Outcome Contract 资金托管
承接定制项目时，委托方预付约定金额至平台托管账户（escrow）。资金在合同期间锁定，不可单方面提取。每个里程碑完成后，创作者提交交付物，委托方确认后自动释放对应份额到创作者钱包。
API Key 安全：SHA-256 + AES-256-GCM
参考 GitHub PAT 的设计：API Key 明文仅在创建时展示一次，之后仅存储 SHA-256 哈希（用于索引查找）和 AES-256-GCM 加密后的密文（用于恢复原始 key 以便调用外部服务）。密钥无法从数据库逆推，丢失需重新生成。
三步上手
注册账号
完成基本信息填写，创世期内无需审核，注册即入驻。填写你的专业领域和能力标签，帮助 Cortex 更精准地匹配你的能力。
创建第一个 Capability
进入 Vault → 资产管理 → 新建 Capability。选择类型（Skill / Agent / Bundle），填写描述、定价和授权级别。系统自动为你生成 opc_xxx 调用端点。
开启 Cortex 意图模式
进入 Vault 主界面，在意图输入框中描述你想要完成的任务。Cortex 会检索你和其他创作者的 Capability 库，自动生成执行计划并等待你确认。