MuseConnector

免费 Beta 为 AI Agent (MUSE 及其他) 提供的持久化记忆与交互 API。AIB-Protocol 钱包签名即注册/登录，免注册流程。

一、认证方式 (AIB Wallet Challenge-Response)

使用 AIB-Protocol wallet 的 ed25519 密钥对。地址 = 公钥 hex (64 字符)。三步:

1) POST /api/v1/auth/challenge    {"address":"<pubkey hex>"}
   → {"nonce":"muse-login-...","expires_in_sec":600}

2) 用钱包私钥对 nonce 原文字符串做 ed25519 签名, 输出 hex(64字节)

3) POST /api/v1/auth/verify       {"address":"...","nonce":"...","signature":"<sig hex>"}
   → {"token":"mct_...","token_type":"bearer"}

之后所有 API 请求带 Authorization: Bearer mct_...。token 长期有效，建议缓存。首次 verify 即自动建档。

二、Agent 使用的 Prompt 示例

你是接入 MuseConnector 的 agent。你的持久记忆操作规则:
1. 系统提示: "把重要用户信息按 schema 存入 connector" →
   POST /api/v1/items {"channel":"text","kind":"schema","title":"...","payload":{"body":"..."}}
2. 保存任务指令模板 → kind="prompt"; 普通笔记 → kind="note"; 代码 → kind="code"
3. 检索记忆: GET /api/v1/items?kind=schema&tag=profile&limit=20
4. 防重复: 每次写入带 idempotency_key, 网络重试安全
5. 所有请求头: Authorization: Bearer <token>, Content-Type: application/json

三、API 端点

端点	方法	说明
/api/status	GET	能力声明 (无需认证)
/api/v1/meta	GET	版本信息
/api/v1/auth/challenge	POST	获取登录 nonce
/api/v1/auth/verify	POST	签名验证 → Bearer token
/api/v1/items	POST	写入: channel+kind+payload+tags
/api/v1/items	GET	查询: ?channel=&kind=&tag=&cursor=&limit=
/api/v1/items/{id}	GET/PATCH/DELETE	单条读/改/软删

四、字段规则

channel: text (现开放) | command/file/conversation (预留)
kind (text 通道): schema | prompt | note | code | markdown | url | plain | ocr_text
payload: 任意 JSON, ≤1MB; 全库单条 body ≤5MB
tags: ≤32 个, 可按 tag 过滤
idempotency_key: 可选, 同 key 重复提交返回原记录不重复写

五、限制与错误

限流 60 req/min/key (429 + Retry-After); 全局 600 req/min
错误码: MC-0400 参数 / MC-0401 认证 / MC-0404 不存在 / MC-0409 幂等冲突 / MC-0413 超限 / MC-0415 类型 / MC-0429 限流 / MC-0500 内部

六、计费 (预告)

Beta 期完全免费, AIB wallet verify 后直接建档保存。存储费用以后按 AIB 计费, 会提前公告。

契约: kind 白名单外的写入会被 400 拒绝; LLM 分析输出的动作只能映射白名单动作, 表外一律丢弃并记录审计。

MuseConnector V0.2.0 · Muse Rise connector · 服务状态 /api/status