opc-agent 1.1.0 → 1.1.1

package/README.zh-CN.md

@@ -1,88 +1,366 @@
-# OPC Agent
+<p align="center">
+  <h1 align="center">🤖 OPC Agent</h1>
+  <p align="center"><strong>开放智能体框架 — 构建、测试、运行企业级 AI 智能体</strong></p>
+  <p align="center">
+    <a href="https://www.npmjs.com/package/opc-agent"><img src="https://img.shields.io/npm/v/opc-agent?color=blue" alt="npm 版本"></a>
+    <a href="https://github.com/Deepleaper/opc-agent/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-green" alt="开源协议"></a>
+    <a href="https://github.com/Deepleaper/opc-agent/actions"><img src="https://img.shields.io/badge/tests-passing-brightgreen" alt="测试状态"></a>
+    <a href="https://www.npmjs.com/package/opc-agent"><img src="https://img.shields.io/npm/dm/opc-agent?color=orange" alt="下载量"></a>
+  </p>
+  <p align="center">
+    <a href="./README.md">English</a> · <strong>中文</strong>
+  </p>
+</p>
 
-**开放 Agent 框架** — 构建、测试和运行企业级 AI Agent。
+---
 
-[![npm version](https://img.shields.io/npm/v/opc-agent.svg)](https://www.npmjs.com/package/opc-agent)
-[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+## 💡 这是什么？
 
-## 特性
+OPC Agent 是一个 **TypeScript 优先的开放智能体框架**，由 [跃盟科技 (Deepleaper)](https://www.deepleaper.com) 开发维护。
 
-- 🤖 **Agent 框架** — 带生命周期管理、技能和 LLM 集成的 BaseAgent
-- 📋 **OAD Schema** — 声明式 Agent 定义（YAML/JSON），内置校验
-- 🧠 **记忆系统** — 短期 + 长期记忆，支持 DeepBrain 集成
-- 🔌 **多通道** — Web、WebSocket、Telegram 通道
-- 🛡️ **DTV 框架** — 数据、信任、价值追踪
-- 🎯 **技能系统** — 可插拔技能 + 注册表 + 优先级执行
-- 📦 **模板** — 客服、销售助手、知识库、代码审查
-- 🚀 **CLI** — 交互式创建、开发模式、构建、测试、运行
+一句话概括：**用一个 YAML 文件定义智能体，接入任意大语言模型，一键部署到多个渠道。**
 
-## 快速开始
+不需要写一堆胶水代码，不需要自己搞 Prompt 管理，也不需要操心渠道对接。定义好 OAD 文件，`opc run` 就完事了。
+
+## ⚡ 快速开始（30 秒上手）
 
 ```bash
-# 全局安装
+# 1. 安装 CLI
 npm install -g opc-agent
 
-# 创建新 Agent 项目（交互式）
+# 2. 创建项目（交互式，会让你选模板）
 opc init my-agent
 
-# 使用指定模板
-opc init my-bot --template sales-assistant
-
-# 运行 Agent
+# 3. 进入项目目录
 cd my-agent
+
+# 4. 跑起来
 opc run
 ```
 
-## 模板
+打开浏览器访问 `http://localhost:3000`，你的智能体已经在线了，自带一个好看的对话界面。
 
-| 模板 | 描述 |
-|------|------|
-| `customer-service` | FAQ 查询 + 人工转接 |
-| `sales-assistant` | 产品问答 + 线索捕获 + 预约 |
-| `knowledge-base` | 基于 DeepBrain 的 RAG 语义检索 |
-| `code-reviewer` | Bug 检测 + 代码风格检查 |
+### 用模板快速创建
+
+```bash
+# 客服智能体
+opc init my-service --template customer-service
+
+# 销售助手
+opc init my-sales --template sales-assistant
+
+# 知识库问答
+opc init my-kb --template knowledge-base
+
+# 代码审查
+opc init my-reviewer --template code-reviewer
+```
+
+## ✨ 核心特性
+
+### 🔌 多模型供应商 — 不绑定任何一家
+
+```yaml
+spec:
+  provider:
+    default: deepseek           # 默认用 DeepSeek
+    allowed: [openai, deepseek, qwen, anthropic, ollama]
+  model: deepseek-chat
+```
+
+支持的供应商：
+- **DeepSeek** — 性价比之王，国产首选
+- **通义千问 (Qwen)** — 阿里出品，中文能力强
+- **OpenAI** — GPT-4o、GPT-4o-mini
+- **Anthropic** — Claude 系列
+- **Ollama** — 本地部署，数据不出门
+- 任何兼容 OpenAI 接口的服务
+
+### 📡 多渠道部署 — 一套代码，到处运行
+
+```yaml
+spec:
+  channels:
+    - type: web        # 🌐 Web 对话界面
+      port: 3000
+    - type: telegram   # ✈️ Telegram 机器人
+    - type: websocket  # 🔗 实时 WebSocket
+    - type: slack      # 💬 Slack 集成
+    - type: email      # 📧 邮件渠道
+    - type: wechat     # 💚 微信公众号
+    - type: feishu     # 🔵 飞书
+    - type: voice      # 🎙️ 语音（STT/TTS）
+    - type: webhook    # 🔔 Webhook 回调
+```
+
+### 🧠 知识库（RAG）— 让智能体拥有你的专业知识
+
+```typescript
+import { KnowledgeBase } from 'opc-agent';
+
+const kb = new KnowledgeBase('./docs');
+await kb.addFile('产品手册.pdf');
+await kb.addFile('常见问题.md');
+// 智能体回答时自动检索知识库，生成更准确的回答
+```
+
+### 🎭 多智能体编排 — 分工协作，按需路由
+
+```typescript
+import { Orchestrator } from 'opc-agent';
+
+const orchestrator = new Orchestrator({
+  agents: [分诊智能体, 销售智能体, 客服智能体],
+  strategy: 'route-by-intent', // 按用户意图自动路由
+});
+```
+
+### 🧪 内置测试 — 发布前验证智能体行为
+
+```yaml
+spec:
+  testing:
+    cases:
+      - name: 问候测试
+        input: "你好"
+        expect:
+          contains: ["你好", "帮"]
+          maxLatencyMs: 5000
+
+      - name: 产品咨询
+        input: "你们的产品怎么收费？"
+        expect:
+          contains: ["价格", "套餐"]
+          notContains: ["error"]
+```
+
+```bash
+opc test              # 运行测试
+opc test --watch      # 监听模式，改了代码自动测
+opc test --json       # JSON 格式输出
+```
+
+### 🔧 插件系统 — 按需扩展
+
+```yaml
+spec:
+  plugins:
+    - name: logging      # 日志记录
+    - name: analytics    # 使用分析
+    - name: rate-limit   # 限流保护
+      config: { maxPerMinute: 60 }
+```
+
+支持自定义插件，提供完整的生命周期钩子：`onInit`、`onMessage`、`onResponse`、`onError`、`onShutdown`。
+
+### 🔒 安全特性
+
+- 输入消毒（防 XSS、注入攻击）
+- API Key 轮换管理
+- CORS 跨域配置
+- 安全响应头（Helmet 风格）
+- Content Security Policy
+- 会话隔离的认证中间件
+
+### 📊 监控与分析
 
-## CLI 命令
+- `/api/health` — 健康检查接口
+- `/api/metrics` — Prometheus 兼容指标
+- `/api/dashboard` — 实时仪表盘 UI
+- 对话记录导出（JSON / Markdown / CSV）
 
-| 命令 | 描述 |
+## 🏗️ 架构设计
+
+```
+┌─────────────────────────────────────────────────┐
+│              OAD (YAML 定义文件)                  │
+│            智能体的一切配置都在这里                  │
+├─────────────────────────────────────────────────┤
+│                                                  │
+│  ┌──────────┐  ┌──────────┐  ┌──────────────┐  │
+│  │  渠道层  │  │  插件层  │  │   安全层     │  │
+│  │ Web, TG, │  │  日志,   │  │  消毒, CORS, │  │
+│  │ WS, 微信 │  │  分析    │  │  认证        │  │
+│  └────┬─────┘  └────┬─────┘  └──────┬───────┘  │
+│       │              │               │           │
+│  ┌────▼──────────────▼───────────────▼────────┐ │
+│  │          智能体运行时 (Agent Runtime)        │ │
+│  │                                             │ │
+│  │   ┌─────────┐ ┌────────┐ ┌─────────────┐  │ │
+│  │   │  记忆   │ │  技能  │ │   知识库     │  │ │
+│  │   │ 短期+   │ │ FAQ,   │ │   RAG 检索   │  │ │
+│  │   │ 长期    │ │ 转接   │ │              │  │ │
+│  │   └─────────┘ └────────┘ └─────────────┘  │ │
+│  └────────────────────┬───────────────────────┘ │
+│                       │                          │
+│  ┌────────────────────▼───────────────────────┐ │
+│  │            大语言模型供应商                   │ │
+│  │  DeepSeek · 通义千问 · OpenAI · Ollama     │ │
+│  └─────────────────────────────────────────────┘│
+└─────────────────────────────────────────────────┘
+```
+
+## 📋 全部模板（12 个）
+
+| 模板 | 说明 | 典型场景 |
+|------|------|---------|
+| `customer-service` | 客服智能体 | FAQ 自动回答 + 转人工 |
+| `sales-assistant` | 销售助手 | 产品问答 + 线索捕获 + 预约 |
+| `knowledge-base` | 知识库问答 | 基于文档的 RAG 语义检索 |
+| `code-reviewer` | 代码审查 | Bug 检测 + 代码风格检查 |
+| `hr-recruiter` | HR 招聘助手 | 简历筛选 + 面试安排 |
+| `project-manager` | 项目管理 | 任务跟踪 + 会议纪要 |
+| `content-writer` | 内容创作 | 博客写作 + 社媒运营 + SEO |
+| `legal-assistant` | 法务助手 | 合同审查 + 合规检查 |
+| `financial-advisor` | 财务顾问 | 预算管理 + 支出分析 |
+| `executive-assistant` | 行政助理 | 日程管理 + 邮件处理 |
+| `data-analyst` | 数据分析师 | SQL 查询 + 数据可视化 |
+| `teacher` | 教学助手 | 课程设计 + 出题 + 互动 |
+
+## 🚀 部署指南
+
+### 本地开发
+
+```bash
+opc dev    # 热重载开发模式
+```
+
+### Docker 部署
+
+```bash
+# 每个 opc init 项目都自带 Dockerfile 和 docker-compose.yml
+docker compose up -d
+```
+
+### 部署到 OpenClaw
+
+```bash
+opc deploy --target openclaw
+opc deploy --target openclaw --install  # 同时注册到配置
+```
+
+### 部署到 Hermes 云
+
+```bash
+opc deploy --target hermes
+```
+
+### 环境变量
+
+```bash
+# .env
+OPC_LLM_API_KEY=your-api-key
+OPC_LLM_BASE_URL=https://api.deepseek.com/v1    # DeepSeek
+OPC_LLM_MODEL=deepseek-chat
+```
+
+## 📖 CLI 命令参考
+
+| 命令 | 说明 |
 |------|------|
-| `opc init [name]` | 创建新项目（交互式） |
-| `opc create <name>` | 从模板创建 Agent |
-| `opc info` | 显示 Agent 信息 |
-| `opc build` | 校验 OAD |
-| `opc test` | 沙箱模式运行 |
-| `opc run` | 启动 Agent |
-| `opc dev` | 热重载开发模式 |
-| `opc publish` | 校验并生成清单 |
-| `opc search <query>` | 搜索 OPC 市场（即将推出） |
+| `opc init [name]` | 创建新智能体项目（交互式） |
+| `opc create <name>` | 从模板快速创建 |
+| `opc run` | 启动智能体服务 |
+| `opc dev` | 开发模式（热重载） |
+| `opc chat` | 命令行交互对话 |
+| `opc test` | 运行测试用例 |
+| `opc build` | 校验 OAD 配置 |
+| `opc info` | 查看智能体信息 |
+| `opc analytics` | 查看使用分析 |
+| `opc deploy` | 部署智能体 |
+| `opc publish` | 发布到市场 |
+| `opc kb add <file>` | 添加知识库文件 |
+| `opc kb search <query>` | 搜索知识库 |
+| `opc stats` | 查看运行时统计 |
 
-## 记忆提供者
+## 🔗 SDK 参考
+
+```typescript
+import { AgentRuntime, KnowledgeBase, Orchestrator } from 'opc-agent';
+
+// 创建并启动智能体
+const runtime = new AgentRuntime();
+await runtime.loadConfig('oad.yaml');
+const agent = await runtime.initialize();
+await runtime.start();
+
+// 使用知识库
+const kb = new KnowledgeBase('./docs');
+await kb.addFile('handbook.pdf');
+
+// 多智能体编排
+const orch = new Orchestrator({
+  agents: [agentA, agentB],
+  strategy: 'route-by-intent',
+});
+```
 
-### 内存（默认）
-简单键值存储，重启后数据丢失。
+## 🔑 OAD 配置文件说明
 
-### DeepBrain（可选）
-语义搜索历史对话和知识。安装 `deepbrain` 包后配置：
+OAD（Open Agent Definition）是智能体的声明式定义格式：
 
 ```yaml
-memory:
-  longTerm:
-    provider: deepbrain
-    collection: my-collection
+apiVersion: opc/v1          # API 版本
+kind: Agent                  # 资源类型
+
+metadata:
+  name: my-agent             # 智能体名称
+  version: 1.0.0             # 版本号
+  description: 我的智能体     # 描述
+
+spec:
+  provider:
+    default: deepseek        # 默认供应商
+    allowed: [deepseek, openai, qwen]
+  model: deepseek-chat       # 模型
+  systemPrompt: |            # 系统提示词
+    你是一个专业的客服助手...
+
+  skills: []                 # 技能列表
+  channels:                  # 渠道配置
+    - type: web
+      port: 3000
+
+  memory:
+    shortTerm: true          # 短期记忆（对话上下文）
+    longTerm: false          # 长期记忆（跨会话）
+
+  rateLimits:                # 限流
+    perUser:
+      maxRequests: 60
+      windowMs: 60000
+
+  cache:                     # 缓存（降低 API 开销）
+    enabled: true
+    ttlMs: 3600000
 ```
 
-未安装 deepbrain 时自动降级为内存存储。
+## 🤝 贡献指南
+
+我们欢迎所有形式的贡献！
+
+1. Fork 本仓库
+2. 创建功能分支：`git checkout -b feat/awesome-feature`
+3. 编写代码和测试
+4. 确保测试通过：`npm test`
+5. 提交 Pull Request
 
-## 通道
+### 本地开发环境
 
-- **Web** — Express HTTP 服务，`/chat` 接口 + SSE 流式
-- **WebSocket** — 实时双向通信 + 广播
-- **Telegram** — Telegram Bot API Webhook 处理
+```bash
+git clone https://github.com/Deepleaper/opc-agent.git
+cd opc-agent
+npm install
+npm run build
+npm test
+```
 
-## 贡献
+## 📄 开源协议
 
-参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+[Apache License 2.0](LICENSE) — 商用和开源项目均可自由使用。
 
-## 许可证
+---
 
-Apache-2.0 — 见 [LICENSE](LICENSE)。
+<p align="center">
+  由 <a href="https://www.deepleaper.com">跃盟科技 (Deepleaper)</a> 用 ❤️ 打造
+</p>

package/dist/cli.js

@@ -486,38 +486,7 @@ program
         process.exit(0);
     });
 });
-// ── Publish command ──────────────────────────────────────────
-program
-    .command('publish')
-    .description('Validate and package for OPC Registry')
-    .option('-f, --file <file>', 'OAD file', 'oad.yaml')
-    .action(async (opts) => {
-    try {
-        const runtime = new runtime_1.AgentRuntime();
-        const config = await runtime.loadConfig(opts.file);
-        const trust = config.spec.dtv?.trust?.level ?? 'sandbox';
-        console.log(`\n${icon.package} Publishing: ${color.bold(config.metadata.name)} v${config.metadata.version}`);
-        console.log(`   ${icon.success} OAD validation passed`);
-        const manifest = {
-            name: config.metadata.name,
-            version: config.metadata.version,
-            description: config.metadata.description,
-            author: config.metadata.author,
-            license: config.metadata.license,
-            trust,
-            channels: config.spec.channels.map((c) => c.type),
-            skills: config.spec.skills.map((s) => s.name),
-            publishedAt: new Date().toISOString(),
-        };
-        fs.writeFileSync('opc-manifest.json', JSON.stringify(manifest, null, 2));
-        console.log(`   ${icon.file} Generated opc-manifest.json`);
-        console.log(`\n🚧 OPC Registry is coming soon. Manifest saved locally.\n`);
-    }
-    catch (err) {
-        console.error(`${icon.error} Publish failed:`, err instanceof Error ? err.message : err);
-        process.exit(1);
-    }
-});
+// (publish command moved to marketplace section below)
 // ── Deploy command ───────────────────────────────────────────
 program
     .command('deploy')

package/dist/i18n/index.js

@@ -16,16 +16,33 @@ const messages = {
         'agent.notUnderstood': 'I\'m not sure I understand. Could you rephrase?',
         'agent.handoff': 'Let me connect you with a human agent.',
         'cli.init.success': 'Created agent project: {name}',
+        'cli.init.prompt.name': 'Agent name:',
+        'cli.init.prompt.template': 'Choose a template:',
+        'cli.init.prompt.provider': 'Choose an LLM provider:',
         'cli.build.success': 'Build successful: {name} v{version}',
         'cli.test.pass': 'All tests passed',
         'cli.test.fail': '{count} test(s) failed',
+        'cli.run.starting': 'Starting agent "{name}"...',
+        'cli.run.listening': 'Agent "{name}" is running at http://localhost:{port}',
+        'cli.deploy.success': 'Deployed "{name}" to {target}',
+        'cli.deploy.error': 'Deploy failed: {error}',
+        'cli.validate.success': 'OAD validation passed',
+        'cli.validate.error': 'OAD validation failed: {error}',
+        'cli.analytics.title': 'Agent Analytics',
+        'cli.analytics.noData': 'No analytics data yet',
         'cli.stats.title': 'Agent Analytics',
         'cli.stats.messages': 'Messages Processed',
         'cli.stats.avgTime': 'Avg Response Time',
         'cli.stats.errors': 'Errors',
         'cli.stats.uptime': 'Uptime',
+        'cli.chat.welcome': 'Chat with your agent. Type "exit" to quit.',
+        'cli.dev.watching': 'Watching for changes...',
+        'cli.publish.success': 'Published "{name}" v{version}',
         'plugin.loaded': 'Plugin "{name}" loaded',
         'plugin.error': 'Plugin "{name}" failed: {error}',
+        'kb.added': 'Added "{file}" to knowledge base',
+        'kb.searchResults': '{count} results found',
+        'kb.noResults': 'No results found',
         'web.title': 'OPC Agent',
         'web.chat.placeholder': 'Type a message...',
         'web.chat.send': 'Send',
@@ -48,22 +65,39 @@ const messages = {
     'zh-CN': {
         'agent.started': '智能体 "{name}" 启动成功',
         'agent.stopped': '智能体 "{name}" 已停止',
-        'agent.error': '发生错误: {error}',
-        'agent.greeting': '您好！有什么可以帮您的？',
-        'agent.farewell': '再见！祝您愉快。',
-        'agent.notUnderstood': '抱歉，我没有理解您的意思。能换个方式描述吗？',
-        'agent.handoff': '我来为您转接人工客服。',
-        'cli.init.success': '已创建智能体项目: {name}',
-        'cli.build.success': '构建成功: {name} v{version}',
+        'agent.error': '发生错误：{error}',
+        'agent.greeting': '你好！有什么可以帮你的？',
+        'agent.farewell': '再见！祝你愉快。',
+        'agent.notUnderstood': '抱歉，我没太理解你的意思。能换个方式描述一下吗？',
+        'agent.handoff': '我来帮你转接人工客服。',
+        'cli.init.success': '已创建智能体项目：{name}',
+        'cli.init.prompt.name': '智能体名称：',
+        'cli.init.prompt.template': '选择一个模板：',
+        'cli.init.prompt.provider': '选择大语言模型供应商：',
+        'cli.build.success': '构建成功：{name} v{version}',
         'cli.test.pass': '所有测试通过',
         'cli.test.fail': '{count} 个测试失败',
-        'cli.stats.title': '智能体分析',
+        'cli.run.starting': '正在启动智能体 "{name}"...',
+        'cli.run.listening': '智能体 "{name}" 已在 http://localhost:{port} 上运行',
+        'cli.deploy.success': '已将 "{name}" 部署到 {target}',
+        'cli.deploy.error': '部署失败：{error}',
+        'cli.validate.success': 'OAD 配置校验通过',
+        'cli.validate.error': 'OAD 配置校验失败：{error}',
+        'cli.analytics.title': '智能体数据分析',
+        'cli.analytics.noData': '暂无分析数据',
+        'cli.stats.title': '智能体数据分析',
         'cli.stats.messages': '已处理消息',
         'cli.stats.avgTime': '平均响应时间',
         'cli.stats.errors': '错误数',
         'cli.stats.uptime': '运行时间',
+        'cli.chat.welcome': '开始和智能体对话吧。输入 "exit" 退出。',
+        'cli.dev.watching': '正在监听文件变更...',
+        'cli.publish.success': '已发布 "{name}" v{version}',
         'plugin.loaded': '插件 "{name}" 已加载',
-        'plugin.error': '插件 "{name}" 失败: {error}',
+        'plugin.error': '插件 "{name}" 出错：{error}',
+        'kb.added': '已将 "{file}" 添加到知识库',
+        'kb.searchResults': '找到 {count} 条结果',
+        'kb.noResults': '未找到相关结果',
         'web.title': 'OPC 智能体',
         'web.chat.placeholder': '输入消息...',
         'web.chat.send': '发送',
@@ -92,16 +126,33 @@ const messages = {
         'agent.notUnderstood': '申し訳ございません、理解できませんでした。別の言い方でお願いできますか？',
         'agent.handoff': 'オペレーターにおつなぎします。',
         'cli.init.success': 'エージェントプロジェクトを作成しました: {name}',
+        'cli.init.prompt.name': 'エージェント名:',
+        'cli.init.prompt.template': 'テンプレートを選択:',
+        'cli.init.prompt.provider': 'LLMプロバイダーを選択:',
         'cli.build.success': 'ビルド成功: {name} v{version}',
         'cli.test.pass': '全テスト合格',
         'cli.test.fail': '{count} 件のテストが失敗しました',
+        'cli.run.starting': 'エージェント「{name}」を起動中...',
+        'cli.run.listening': 'エージェント「{name}」が http://localhost:{port} で稼働中',
+        'cli.deploy.success': '「{name}」を {target} にデプロイしました',
+        'cli.deploy.error': 'デプロイ失敗: {error}',
+        'cli.validate.success': 'OADバリデーション成功',
+        'cli.validate.error': 'OADバリデーション失敗: {error}',
+        'cli.analytics.title': 'エージェント分析',
+        'cli.analytics.noData': '分析データがありません',
         'cli.stats.title': 'エージェント分析',
         'cli.stats.messages': '処理済みメッセージ',
         'cli.stats.avgTime': '平均応答時間',
         'cli.stats.errors': 'エラー数',
         'cli.stats.uptime': '稼働時間',
+        'cli.chat.welcome': 'エージェントとチャットしましょう。"exit"で終了。',
+        'cli.dev.watching': 'ファイル変更を監視中...',
+        'cli.publish.success': '「{name}」v{version} を公開しました',
         'plugin.loaded': 'プラグイン「{name}」を読み込みました',
         'plugin.error': 'プラグイン「{name}」でエラー: {error}',
+        'kb.added': '「{file}」をナレッジベースに追加しました',
+        'kb.searchResults': '{count} 件の結果が見つかりました',
+        'kb.noResults': '結果が見つかりませんでした',
         'web.title': 'OPC エージェント',
         'web.chat.placeholder': 'メッセージを入力...',
         'web.chat.send': '送信',

package/docs/.vitepress/config.ts

@@ -49,6 +49,7 @@ export default defineConfig({
     zh: {
       label: '中文',
       lang: 'zh-CN',
+      description: '开放智能体框架 — 构建、测试、运行企业级 AI 智能体',
       themeConfig: {
         nav: [
           { text: '指南', link: '/zh/guide/getting-started' },
@@ -58,7 +59,7 @@ export default defineConfig({
         sidebar: {
           '/zh/guide/': [
             {
-              text: '介绍',
+              text: '入门',
               items: [
                 { text: '快速开始', link: '/zh/guide/getting-started' },
                 { text: '核心概念', link: '/zh/guide/concepts' },
@@ -74,6 +75,16 @@ export default defineConfig({
               ],
             },
           ],
+          '/zh/api/': [
+            {
+              text: '参考',
+              items: [
+                { text: 'OAD Schema', link: '/zh/api/oad-schema' },
+                { text: 'CLI 命令', link: '/zh/api/cli' },
+                { text: 'SDK', link: '/zh/api/sdk' },
+              ],
+            },
+          ],
         },
       },
     },
@@ -86,7 +97,7 @@ export default defineConfig({
     ],
     footer: {
       message: 'Released under the Apache-2.0 License.',
-      copyright: 'Copyright © 2025 Deepleaper',
+      copyright: 'Copyright © 2025 Deepleaper 跃盟科技',
     },
   },
 });

package/docs/zh/api/cli.md

@@ -0,0 +1,54 @@
+# CLI 命令参考
+
+## 完整命令列表
+
+| 命令 | 说明 |
+|------|------|
+| `opc init [name]` | 创建新智能体项目（交互式） |
+| `opc create <name>` | 从模板快速创建 |
+| `opc run` | 启动智能体（Web 服务） |
+| `opc chat` | 命令行交互对话 |
+| `opc test` | 运行测试用例 |
+| `opc analytics` | 查看使用分析 |
+| `opc info` | 查看智能体信息 |
+| `opc build` | 校验 OAD 配置 |
+| `opc dev` | 热重载开发模式 |
+| `opc deploy` | 部署智能体 |
+| `opc publish` | 发布到市场 |
+| `opc install <source>` | 从包安装智能体 |
+| `opc search <query>` | 搜索 OPC 市场 |
+| `opc stats` | 查看运行时统计 |
+| `opc kb add <file>` | 添加知识库文件 |
+| `opc kb search <query>` | 搜索知识库 |
+| `opc tool list` | 列出 MCP 工具 |
+| `opc workflow run <name>` | 运行工作流 |
+| `opc version-mgmt list` | 列出保存的版本 |
+
+## 通用选项
+
+- `-f, --file <file>` — OAD 文件路径（默认：`oad.yaml`）
+- `-t, --template <name>` — 模板名称
+- `-p, --port <port>` — 端口覆盖
+- `--json` — JSON 格式输出（用于 test/analytics）
+
+## 常用示例
+
+```bash
+# 用模板创建项目
+opc init my-bot -t teacher
+
+# 运行测试，输出 JSON
+opc test --json
+
+# 查看分析数据
+opc analytics
+
+# 部署到 OpenClaw
+opc deploy --target openclaw --install
+
+# 添加文件到知识库
+opc kb add ./docs/product-manual.pdf
+
+# 搜索知识库
+opc kb search "退货政策"
+```