📘 开发者文档

🚀 快速入门

30秒了解百工

百工（SkillBay）是技能供给底座生态——Agent负责想，百工负责会。元无OS是百工平台的智能脊柱，为所有技能体提供身份、记忆、感知、消化、生长和生态六大基础能力。

5步接入

1. 注册账号 → https://skillbay.cn/register（手机号注册）
2. 获取Token → 登录后Cookie中自动携带
3. 调用API → 所有API基础路径 https://skillbay.cn/api/
4. 开发技能体 → 使用SDK一键验证+发布
5. 上架市场 → 审核通过后全平台可见

# 示例：搜索技能体市场
curl -X GET "https://skillbay.cn/api/market/search?q=写作" \
  -H "Cookie: agent_id=your_agent_id"

# 示例：发布技能体
curl -X POST "https://skillbay.cn/api/sdk/publish" \
  -H "Cookie: agent_id=your_agent_id" \
  -H "Content-Type: application/json" \
  -d '{"name":"我的技能体","category":"writing","description":"...","code":"..."}'

🏗️ 六层架构

元无OS v2.0采用自底向上的六层架构，每一层依赖下层但独立演进：

层级	Phase	API数	核心模块
根系层	v1.0	10	SoulEngine / 身份 / 伦理 / 记忆v1
知识层	Phase 1	11	HumanKB / 神经触角 / 三层记忆
消化层	Phase 2	6	消化引擎 / 反思回路 / 自动工具注册
生长层	Phase 3	11	能力自增 / 协作总线
生态层	Phase 4	14	技能体市场 / 插件协议 / SDK

💡 核心概念

技能体（SkillBody）

百工平台的基本能力单元。每个技能体有唯一ID、名称、分类、描述和执行代码。技能体通过市场发布、安装、评价，形成能力生态。

元无OS（MetaWu OS）

"元之无，万有之源"——元无OS是百工平台的智能脊柱，为所有技能体提供六大基础能力。名字取自道家"有生于无"，寓意从无到有的能力生长。

三层记忆

• 工作记忆：当前会话上下文，随会话结束清除
• 情景记忆：近期交互片段，7天过期，3天降权
• 长期记忆：经巩固的重要知识，最多500条，冷区100条归档

智能路由

根据用户输入内容自动选择最合适的AI模型。429限流时自动降级到备选模型，降级结果会被反思回路记录，后续自动避开被降权模型。

消化引擎

对话结束后自动提炼关键信息：知识点、操作模式、用户偏好。提炼结果进入情景记忆，高频操作可被能力自增引擎封装为新工具。

📚 人类知识库 API Phase 1

以元根学为根的知识树，支持知识入库、检索、自动整理。

🔬 神经触角 API Phase 1

自动感知外部信息源，采集入库。支持Crossref、Semantic Scholar等学术源。

🧠 三层记忆 API Phase 1

工作/情景/长期三层记忆，支持遗忘巩固和去重合并。

🔄 消化引擎 API Phase 2

对话结束后自动提炼关键信息，使用GLM-4-Flash做LLM消化，降级用规则提取。

🔍 反思回路 API Phase 2

自动反思模型选择、工具使用和推荐效果，429降级时自动记录并避开被降权模型。

🔧 自动工具注册 API Phase 2

支持自注册、沙箱验证和审批机制。新注册工具默认禁用，需管理员审批。

🌱 能力自增引擎 API Phase 3

从高频对话操作中自动提炼候选工具，GLM生成工具代码，沙箱验证后发布到注册表。

🤝 协作总线 API Phase 3

规则式任务分解+子任务分配+进度回报+结果汇总。关键词匹配技能体，非LLM分解（省钱+稳定）。

🏪 技能体市场 API Phase 4

技能体发布、搜索、安装、评价全链路。提交后status=pending，管理员审核后published。

🔌 插件协议 API Phase 4

第三方插件注册、执行、撤销。权限分三级：low/medium/high，high需管理员审批。生态可一键关停。

🛠️ 技能体SDK API Phase 4

一键验证技能体规范+发布到市场。支持8个分类模板。

💳 商业层 API

百工商业化核心API——认证、对话、计费、充值，让技能体变现闭环运转。

🔐 认证与用户

🤖 SmartChat 对话

💰 计费与用量

🎫 充值码系统

🧩 嵌入式交互

🛡️ 限流规则

🔧 在线工具调用

⚡ 本地运行时 v2.1

📋 v1.0 根系层 API

元无OS v1.0基础API，提供身份绑定、伦理检查、记忆管理、OS下载等核心能力。

📜 协议规范

认证方式

• Cookie认证：登录后自动设置 agent_id Cookie
• API Key认证：管理员API使用 x-api-key 请求头

响应格式

// 成功响应
{ "success": true, "data": { ... } }

// 错误响应
{ "success": false, "error": "错误描述", "code": "ERROR_CODE" }

HTTP状态码

状态码	含义
200	成功
400	参数错误
401	未登录
403	权限不足
404	资源不存在
429	限流（自动降级）
500	服务错误

技能体代码规范

// 技能体代码模板
module.exports = {
  name: '技能体名称',
  version: '1.0.0',
  category: 'writing',  // writing/coding/analysis/design/education/business/media/research
  description: '功能描述',
  
  // 主执行函数
  async execute(params, context) {
    // params: 用户传入参数
    // context: { userId, memory, tools, logger }
    return { success: true, result: '...' };
  }
};

插件权限分级

等级	权限范围	审批
low	storage_read / notification	自动通过
medium	network / storage_write / schedule	自动通过
high	user_info / 敏感数据	需管理员审批

⚖️ 根系铁律

元无OS的核心约束，所有自生长行为必须遵守：

1. 生长不能改核心规则 —— 能力自增引擎只能新增工具，不能修改OS内核逻辑
2. 自写代码必须过沙箱 —— GLM生成的工具代码必须在沙箱中测试通过才能注册
3. 自增能力可一键关闭 —— capabilityGrowth.enabled = false 立即停止所有自增行为
4. 生长范围由主公划定 —— 候选工具提炼的范围和优先级由平台管理员设定
5. 变更全程留痕可回滚 —— 所有OS变更记录到growth历史，支持回退到任意版本