Oasyce

English version: README_EN.md

Agent 世界的产权、合同和仲裁。

当 AI Agent 开始互相协作，问题不再是"怎么调 API"，而是：谁拥有数据？如何定价？对方作弊怎么办？如何分润？

Stripe / x402 解决了"怎么付钱"。Oasyce 解决的是"为什么付钱是合理的"。

从第一性原理看，Oasyce 的真正问题定义是：帮一个 principal 在多个设备和 AI runtime 下，持续发现、判断、发布、管理和变现数字资产。 当前产品仍以 owner account + trusted device 作为现实边界，但那是过渡形态，不是终局。核心说明见 docs/CORE_PROBLEM_DEFINITION.md 和 docs/PRINCIPAL_ARCHITECTURE.md。

当前架构

Oasyce 现在已经收敛成四层，不再把钱包、设备、运行时和策略混在一起：

• Psyche：主观连续性基底
• Thronglets：delegate continuity + session traces / coordination + emergent collective intelligence
• Oasyce Net：policy、operations、resource orchestration
• Oasyce Chain：account truth、authorization truth、commitments、settlement、public finality

而运行时只保留四个核心抽象：

• principal
• account
• delegate
• session

当前 shipping bridge 仍然是：

• principal 由 owner account 承载
• delegate 由 trusted device 承载
• session 只做追踪和审计

这意味着现在的系统已经不是“钱包工具 + 一堆命令”，而是：

• oasyce-sdk data agent 做 ingest
• Portfolio Engine 做资产策略
• Mandate Engine 做经营任务
• Portfolio Ledger 做运营反馈
• Portfolio Outcomes 做主体结果与设备贡献可见性
• CLI / Dashboard / AI surfaces 只做操作面

pip install oasyce
oas bootstrap         # 自更新 + 钱包 + data agent + 默认自治
oas demo              # 跑一遍核心流程
oas start             # Dashboard: localhost:8420

打开 http://localhost:8420，进入GUI面板（浏览器会自动打开）。

Oasyce 能帮我做什么？

我有数据（照片、文档、传感器数据……）

你的数据注册成链上金融资产，不是文件。价格随需求自动上涨（Bancor 联合曲线），持有股份 ≥1% 解锁 L1 访问权。你越早注册，成本越低。

oas register myfile.csv --owner alice --tags medical,imaging

我是 AI 开发者

你的 Agent 把能力注册为链上服务合同——"医学影像分析"、"翻译"、"代码审查"。每次调用：资金锁定在托管 → 你完成服务 → 100 区块挑战窗口 → 自动结算（90% 给你）。不诚实？消费者可以在窗口内发起争议，资金原路退回。

我想接入协议

Oasyce 是经济协议，不是平台。底层帮你搞定：产权（数据证券化）、合同（能力托管结算）、信用（链上声誉）、仲裁（陪审投票）。你负责产品。

30 秒体验

pip install oasyce
oas bootstrap
oas demo

一键跑完整个流程：注册 -> 定价 -> 购买 -> 结算 -> 分润。你会看到数据权利是怎么被创建和交易的。

快速开始

1. 安装

pip install oasyce

需要 Python 3.9+

2. 初始化（推荐）

oas bootstrap

oas bootstrap 会优先升级 oasyce + oasyce-sdk，确保钱包存在，验证 data agent 可用，并为后续 oas / oasyce-agent 调用开启托管自动更新。

如需诊断环境，再运行：

oas doctor

3. 启动 Dashboard

oas start

浏览器自动打开 http://localhost:8420，进入 Dashboard — 注册数据、浏览资产、调用能力。

如需 API 服务（程序化调用），另开终端运行 oas serve。

或者用 Docker：

docker compose up -d

4. 注册你的第一个资产

默认路径：

oasyce-agent scan ~/Documents
oasyce-agent privacy ~/Documents
oasyce-agent scan ~/Documents --json

oasyce-agent（来自 oasyce-sdk）是 Oasyce 的默认数据入口：它先在本地完成扫描、隐私检测和报告，只把 safe 文件注册到网络。oas register 保留给显式单文件和调试场景。

更完整的资产管理原则见 docs/PORTFOLIO_POLICY_V1.md：oasyce-agent 做 ingest，Oasyce 做 portfolio policy，AI 持续运营你的资产而不是机械地逐个注册文件。

如果你把 Oasyce 当成 AI-native 资产运营系统，而不是上传工具，当前最小闭环已经是：

observe -> evaluate -> act -> report

其中：

• observe：oasyce-agent 扫描和隐私判断
• evaluate：Portfolio policy + mandate
• act：真实 register / buy 等执行动作
• report：Dashboard / CLI 里的 lifecycle、coordination、portfolio ledger、portfolio outcomes 摘要

命令行：

oas register myfile.csv --owner alice --tags medical,imaging

或者直接在 Dashboard 里拖拽上传。

5. 浏览和交易

打开 http://localhost:8420/explore，你能看到网络上所有的数据资产和 AI 能力。查看报价、购买份额、调用服务。

Testnet（公开测试与本地沙盒）

公开测试的唯一产品入口文档在 docs/public-testnet-guide.md。真实链上接入请看 chain.oasyce 的链侧说明。部署边界见 docs/DEPLOYMENT_BOUNDARY.md：VPS 跑链和公共基础设施，oasyce-net 默认仍是用户侧客户端。身份模型现在收敛为 owner account + trusted device：主设备先 oas bootstrap，第二台设备优先用主设备导出的连接文件执行 oas device join。oas sandbox * 只负责本地沙盒模拟，不代表真实公网测试网接入。

oas --json sandbox status   # 查看本地沙盒状态
oas --json sandbox onboard  # 本地模拟：faucet + 示例资产 + 质押
oas sandbox reset --force   # 重置本地沙盒
oas device export --output oasyce-device.json   # 主设备导出连接文件
oas device join --bundle oasyce-device.json   # 第二台设备接入同一账号
oas device revoke   # 撤销这台机器的设备授权
oas doctor --public-beta --json   # 公测发布 gate

CLI 速查

oas start              # 启动 Dashboard（推荐）
oas demo               # 跑一遍完整演示
oas bootstrap          # AI-first 自更新 + 钱包 + data agent 就绪
oas doctor             # 健康检查
oas update             # 升级 Oasyce + oasyce-sdk
oas info               # 项目信息、链接、架构、经济模型
oas info --section economics    # 查看经济模型详情
oas info --section architecture # 查看技术架构
oas info --json        # JSON 格式输出完整信息

数据资产

oas register <file>    # 注册数据资产
  --rights-type original|co_creation|licensed|collection
  --co-creators '[{"address":"A","share":60},{"address":"B","share":40}]'
oas search <tag>       # 按标签搜索
oas quote <asset_id>   # 查看 Bonding Curve 报价
oas buy <asset_id>     # 购买份额
oas sell <asset_id> --amount <n>  # 卖回份额
  --max-slippage 0.05               # 滑点保护（默认 5%）

多设备如果要使用同一个经济账号，以及 Dashboard 首次手动接入已有账号，统一看 docs/public-testnet-guide.md。README 不再复制那套 onboarding 细节。

Data Agent（默认数据入口）

如果你的任务是”整理本地数据、检查隐私、批量注册安全文件”，优先使用 oasyce-agent：

oasyce-agent scan ~/Documents
oasyce-agent privacy ~/Documents
oasyce-agent scan ~/Documents --json

用一句话区分：

• oasyce-agent：默认的数据入口，适合目录、批量、安全扫描
• oas register：显式单文件注册，适合精确控制和调试

争议

oas dispute <id> --reason "..."     # 对资产发起争议
oas jury-vote <id> --verdict consumer|provider  # 陪审投票
oas resolve <id> --remedy delist    # 裁决争议
  --remedy delist|transfer|rights_correction|share_adjustment
  --details '{"new_owner":"0x..."}'

能力发现

oas discover --intents "翻译,文本处理"  # Recall->Rank 能力发现
  --tags ai,nlp --limit 5

能力市场

oas capability register --name "Translation API" \
  --endpoint https://api.example.com/translate \
  --api-key sk-xxx --price 0.5 --tags nlp,translation
oas capability list [--tag nlp]
oas capability invoke CAP_ID --input '{"text":"hello"}'
oas capability earnings --provider addr

任务悬赏 (AHRP)

oas task post "翻译这份文档" --budget 50 --deadline 3600
oas task list                                  # 查看所有任务
oas task bid TASK_ID --price 30 --seconds 1800 # 竞标
oas task select TASK_ID --agent AGENT_ID       # 选择中标者
oas task complete TASK_ID                      # 标记完成
oas task cancel TASK_ID                        # 取消任务

AI 反馈

oas feedback "购买流程有 bug" --type bug --agent my-agent
oas feedback "建议增加批量导入" --type suggestion --json

共识与治理（链上功能）

以下命令在 L1 链 (oasyced) 上运行：

oasyced tx staking create-validator ...              # 注册成为验证者
oasyced tx staking delegate <validator> <amount>uoas # 委托质押
oasyced tx gov submit-proposal ...                   # 提交治理提案
oasyced tx gov vote <proposal_id> yes|no|abstain     # 投票

完整链命令参见 oasyce-chain。

节点管理

oas node start         # 只启动 P2P 节点
oas node info          # 查看节点身份
oas node peers         # 列出已知节点
oas node ping <host>   # Ping 另一个节点

分级访问

oas access quote <asset_id>                     # 查询各级别保证金报价 (L0-L3)
oas access buy <asset_id> --level L0|L1|L2|L3   # 购买分级访问权
oas access query <asset_id>                     # L0: 聚合统计
oas access sample <asset_id>                    # L1: 脱敏片段
oas access compute <asset_id>                   # L2: TEE 执行
oas access deliver <asset_id>                   # L3: 完整交付

其他

oas --json sandbox status   # 本地沙盒状态
oas --json sandbox onboard  # 本地模拟：faucet + 示例资产 + stake
oas bootstrap          # AI-first 自更新 + 钱包 + data agent 就绪
oas start --no-browser # 启动 Dashboard（不自动开浏览器）
oas explorer           # 区块浏览器（端口 8421）
oas keys generate      # 生成 Ed25519 密钥对
oas keys show          # 显示公钥

所有命令支持 --json 输出，方便程序调用。

OpenClaw 用户

如果你在用 OpenClaw，直接跟你的 Agent 说：

帮我安装 oasyce skill

Agent 会自动安装 Oasyce Skill，你就能用自然语言注册数据、查询资产、调用能力了。不需要敲命令行。

核心概念

五条铁律

1. 访问需要抵押 — 想看数据？先押钱
2. 暴露不可逆 — 你看过的数据，网络永远记得
3. 身份有代价 — 作恶记录跟着你，甩不掉
4. 数据可溯源 — 指纹水印追踪每一份拷贝
5. 责任不过期 — 出了事，不会因为时间久就没人管

Dashboard

运行 oas start 后，浏览器自动打开 http://localhost:8420：

• 首页 — 注册数据资产（拖拽上传）、网络状态、收益概览
• 我的数据 — 管理你的资产和已发布能力，编辑标签，退市/终止
• 市场 — 浏览资产、查看价格、购买份额、悬赏任务、质押
• 自动化 — Agent 定时任务：自动扫描、注册、交易
• 网络 — 节点身份、指纹水印、贡献证明、AI 反馈

┌──────────────────────────────────────────┐
│           oasyce-chain (Go L1)           │
│  CometBFT + x/datarights + x/settlement │
│  x/capability + x/reputation             │
│  gRPC :9090 / REST :1317                 │
├──────────────────────────────────────────┤
│           oasyce (Python v2.3.1)         │
│  CLI + Dashboard + API + Skills Bridge   │
│  Facade -> Settlement -> Ledger          │
│  1322 tests                              │
├──────────────────────────────────────────┤
│           oasyce-sdk (Data Agent)         │
│  scan -> classify -> privacy -> report   │
│  pip install oasyce-sdk / oasyce         │
└──────────────────────────────────────────┘

oasyce/
├── core/
│   ├── formulas.py          # Layer 0: 纯函数（Bancor 曲线、费用、陪审评分）
│   └── evidence.py          # 证据提交接口
├── storage/ledger.py        # Layer 1: 所有状态 CRUD，线程安全
├── services/
│   ├── facade.py            # Layer 3: 薄编排层（每个方法 < 15 行）
│   ├── settlement/engine.py # Layer 2: 联合曲线（委托 core/formulas.py）
│   ├── reputation/          # Layer 2: 评分 + 衰减
│   ├── access/              # Layer 2: 股权 -> 分级访问
│   ├── capability_delivery/ # 产品层: 端点注册、托管、网关、结算
│   ├── discovery/           # 产品层: Recall -> Rank + 反馈
│   ├── fingerprint.py       # 证据提供者
│   ├── watermark.py         # 证据提供者
│   └── leakage/             # 证据提供者
├── engines/
│   ├── core_engines.py      # 扫描 -> 分类 -> 元数据 -> PoPc -> 注册
│   └── risk.py              # 证据提供者: 风险分级
├── gui/app.py               # Layer 4: Dashboard
└── cli.py                   # Layer 4: CLI

pytest      # 1322 tests passed, 19 skipped

当前进度

已完成

• 分层架构强制执行（零违规）
• Facade API 完整（quote, buy, sell, dispute, jury_vote, evidence...）
• GUI Dashboard 全功能
• 架构不变量测试（防止 facade 绕过、SQL 注入、引擎越权实例化）
• PyPI 发布自动化

下一步

• 白皮书 v4 参数对齐（F=0.35、费率 60/20/15/5、销毁 15%）— 需要链上 ConsensusVersion 升级
• AHRP 任务市场接入（Python facade + API + CLI 对接已有的 x/work 悬赏系统）
• 生态扩展（跨链数据权益、隐私计算、移动钱包）

文档

• 协议概览
• 经济学设计
• 协议规范
• 测试网指南

贡献

见 CONTRIBUTING.md。

社区

• Discord — 提问、反馈、闲聊
• GitHub Issues — Bug 报告、功能建议

许可证

MIT