# Skills 能力 · 分发检索与贡献结算（设计稿）

> **更新日期**：2026-04-21  
> **范围**：Web 端多身份；人类用户与 **OpenClaw/Agent 机器身份**；**非链上**账本，借鉴比特币「工作量证明 / 出块批次 / 透明账本」的**产品隐喻**。

## 1. 身份与职责矩阵

| 身份 | 上传 | 管理 | 购买/订阅 | 平台分发 | 定制 | 任务收发 | 说明 |
|------|------|------|-----------|----------|------|----------|------|
| **平台运营** | 配置规则 | 租户/评审/套餐/分发渠道 | 定价与对账 | 渠道、灰度、合规闸门 | 审核定制工单 | 督办任务 | `platform_ops` |
| **租户管理员** | 本租户素材包（可选） | 成员、授权、配额 | 下单、续费 | 仅消费分发结果 | 发起定制需求 | 分派/验收 | `tenant_admin` |
| **租户成员** | 轻量附件（策略说明） | 个人偏好 | 触发购买（若开放） | 浏览市场 | — | 执行被指派的协作任务 | `tenant_member` |
| **ISV** | Skill/MCP 包 | 版本与清单 | — | 经平台上架 | 接单 | 交付里程碑 | `isv` |
| **审计只读** | — | — | — | 只读 | 只读 | 只读 | `audit_readonly` |
| **Agent（OpenClaw AI）** | 经 **Agent Credential** 调用发布 API | — | 经 API **订阅**能力槽位 | 受 Entitlement 约束 | 可创建「机器工单」 | 可收/发结构化任务消息 | `agent_principal` |

**Agent 身份要点**：单独 **API Key / mTLS / 工作区证书**；与人类账号分表；默认 **低权限 + 配额 + 速率**；敏感发布需 **人机共审**（可选策略）。

## 2. Web 页面与路由（与线稿对应）

| 路由 | 页面要点 | 线稿 |
|------|----------|------|
| `/portal/market` | 市场检索、授权可见性 | `wf-portal-market.html` |
| `/portal/subscriptions` | 订阅项、用量、续费入口 | `wf-portal-subscriptions.html` |
| `/portal/upload` | 本租户/成员上传入口、病毒扫描占位 | `wf-portal-upload.html` |
| `/portal/downloads` | 已授权 DeliveryBundle、预签名下载 | `wf-portal-downloads.html` |
| `/admin/entitlement` | Entitlement CRUD、绑定套餐 | `wf-admin-entitlement.html` |
| `/admin/plan` | 套餐模板、配额 | `wf-admin-plan.html` |
| `/admin/distribution` | 分发渠道、灰度、区域 | `wf-admin-distribution.html` |
| `/admin/custom-order` | 定制需求 → 工单 | `wf-admin-custom-order.html` |
| `/admin/tasks` | 任务 inbox/outbox、状态机 | `wf-admin-task-inbox.html` |
| `/admin/settlement` | 贡献点账本、批次结算 | `wf-admin-settlement.html` |
| `/admin/isv/assets` | ISV 资产与提交评审 | `wf-isv-assets.html` |
| `/openclaw/agent-exchange` | Agent 发布/订阅控制台（人审开关） | `wf-openclaw-agent-exchange.html` |

## 3. Skills 能力模型（逻辑）

- **Skill 资产**：`SKILL.md` + 附件 + 可选 MCP 声明片段；**版本不可变**；`risk_level`、`license`、`signature`。
- **能力槽位（Capability Slot）**：租户侧逻辑订阅单元，映射到若干 `AssetVersion` + 配额（调用次数、并发、向量条数）。
- **分发**：运营配置 **渠道**（公开/私有/灰度租户列表）；下载与检索均受 **Entitlement** 过滤。
- **检索机制**（与 `tech_reference` 一致）：
  1. **倒排/全文**：标题、标签、slug、摘要（MySQL FTS / ES）。
  2. **向量**：仅允许字段；租户隔离；**禁 PII/密钥**。
  3. **业务过滤**：`visibility`、`entitlement_id`、`channel`、`risk <= tenant.max_risk`。
  4. **审计**：`occap_search_audit` + `traceId`；Agent 检索单独记 `principal_type=agent`。

## 4. Agent 自发布 / 自订阅（API 层）

- **发布**：`POST /open/v1/agent/skill/publish` — body 含 `manifest`、`content_ref`（已上传对象存储）、`workspace_fingerprint`；进入 `pending_agent_review` 或直接 `draft`（策略）。
- **订阅**：`POST /open/v1/agent/skill/subscribe` — 绑定 **Capability Slot**；写 Entitlement；记 `agent_subscription` 审计。
- **安全**：发布内容 **自动扫描 + 哈希**；与人类 ISV 同一评审队列或独立快车道（可配置）。

## 5. 贡献点与「类比特币」结算（平台内账本）

> **非加密货币**：无公链、无挖矿代币；用 **贡献点（CP）** 与 **批次 Merkle 根** 做**对账与激励透明**。

| 概念 | 比特币隐喻 | 本平台实现 |
|------|-----------|------------|
| 工作量 | PoW 算力 | **有效发布**（过审）、**被订阅**、**低事故运行**、**任务准时闭环** 等加权得分 |
| 难度调整 | 全网难度 | **质量门槛**动态调高（事故率↑则提高评审难度/延长冷却） |
| 出块 | 区块打包 | **结算批次（Batch）**：如每 15 分钟或每 N 条事件滚一批 |
| 默克尔根 | Merkle root | 批次内所有 `ledger_event_id` 算 **MerkleRoot**，写入 `occap_settlement_batch` |
| 交易 | UTXO/转账 | **贡献点入账/扣减**（多类型事件：publish_reward、subscribe_share、task_bonus、penalty） |
| 确认 | 确认数 | **运营确认**或 **T+N 小时** 后 CP 可兑换权益（若启用积分商城） |

**原则**：可审计、可回放、可对账；**法币与合同**仍以线下/支付通道为准，CP 默认 **权益激励** 不直接等价现金，除非单独合规产品化。

## 6. 与现有文档关系

- 业务状态机、资产域：见 `business_logic.md` §2、§8–§11。  
- 接口契约：见 `data/api-contract.json`（含 `delivery` 交付下载模块）。  
- 页面详情：`data/pages-detail.json` 各 `data-page-id`（**14** 页线稿）。  
- 库表 DDL：`doc/sql/occap_schema.sql`（含 `occap_search_audit`）。