opc-agent 1.1.0 → 1.1.1

package/docs/zh/guide/templates.md

@@ -1,22 +1,84 @@
 # 模板
 
-OPC Agent 内置 13 个模板：
-
-| 模板 | 说明 |
-|------|------|
-| `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` | 数据分析 — 数据查询 + 可视化 |
-| `teacher` | 教师 — 课程计划 + 测验 |
+OPC Agent 提供 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 init my-agent -t teacher
+# 创建时指定模板
+opc init my-agent --template customer-service
+
+# 或者用简写
+opc init my-agent -t sales-assistant
+```
+
+## 客服智能体详解
+
+```yaml
+# customer-service/oad.yaml
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: customer-service
+  version: 1.0.0
+  description: "客服智能体：FAQ 查询 + 人工转接"
+spec:
+  provider:
+    default: deepseek
+  model: deepseek-chat
+  systemPrompt: |
+    你是一个友好、专业的客服助手。
+    帮助客户解答产品、订单、物流、退换货等问题。
+    回答要简洁、有帮助、有同理心。
+  skills:
+    - name: faq-lookup
+      description: "FAQ 知识库查询"
+    - name: human-handoff
+      description: "转接人工客服"
+  channels:
+    - type: web
+      port: 3000
+```
+
+## 自定义模板
+
+你可以基于现有模板修改，也可以从头创建：
+
+1. 编写 `oad.yaml` 定义智能体
+2. 继承 `BaseSkill` 实现自定义技能
+3. 将 `oad.yaml` + `README.md` 打包成一个目录
+
+```typescript
+import { BaseSkill } from 'opc-agent';
+import type { AgentContext, Message, SkillResult } from 'opc-agent';
+
+export class MySkill extends BaseSkill {
+  name = 'my-skill';
+  description = '我的自定义技能';
+
+  async execute(context: AgentContext, message: Message): Promise<SkillResult> {
+    // 你的技能逻辑
+    if (message.content.includes('关键词')) {
+      return this.match('这是我的回答', 0.9);
+    }
+    return this.noMatch();
+  }
+}
 ```

package/docs/zh/guide/testing.md

@@ -1,18 +1,88 @@
 # 测试
 
-详细说明请参考 [英文版](/guide/testing)。
+## 概览
+
+OPC Agent 内置了测试框架。你可以在 `oad.yaml` 或单独的 `tests.yaml` 中定义测试用例，用 `opc test` 一键运行。
+
+## 在 OAD 中定义测试
+
+```yaml
+spec:
+  testing:
+    cases:
+      - name: 问候测试
+        input: "你好！"
+        expect:
+          contains: ["你好", "帮"]
+          maxLatencyMs: 5000
+
+      - name: 产品咨询
+        input: "你们怎么收费？"
+        expect:
+          contains: ["价格", "套餐"]
+          notContains: ["error"]
+
+      - name: 空输入
+        input: ""
+        expect:
+          maxLatencyMs: 2000
+```
+
+## 独立测试文件
+
+在 `oad.yaml` 同目录创建 `tests.yaml`：
+
+```yaml
+cases:
+  - name: 冒烟测试
+    input: "你好"
+    expect:
+      maxLatencyMs: 10000
+
+  - name: FAQ 验证
+    input: "退货政策是什么？"
+    expect:
+      contains: ["退货", "退款"]
+```
 
 ## 运行测试
 
 ```bash
+# 运行测试
 opc test
+
+# JSON 格式输出
 opc test --json
+
+# 指定 OAD 文件
 opc test -f my-agent.yaml
+
+# 监听模式（改了代码自动重跑）
+opc test --watch
 ```
 
-## 部署
+## 测试报告
 
-```bash
-opc deploy --target openclaw
-opc deploy --target hermes
 ```
+═══════════════════════════════════════════
+  OPC Agent 测试报告
+═══════════════════════════════════════════
+
+  ✔ [通过] 问候测试 (245ms)
+  ✔ [通过] 产品咨询 (312ms)
+  ✘ [失败] 空输入 (5120ms)
+      → 延迟 5120ms 超过上限 2000ms
+
+───────────────────────────────────────────
+  总计: 3  通过: 2  失败: 1  耗时: 5677ms
+───────────────────────────────────────────
+```
+
+## 断言类型
+
+| 断言 | 说明 |
+|------|------|
+| `contains` | 回复必须包含这些字符串（不区分大小写） |
+| `notContains` | 回复不能包含这些字符串 |
+| `toolCalled` | 指定的工具必须被调用 |
+| `maxLatencyMs` | 响应必须在指定时间内完成 |

package/docs/zh/index.md

@@ -3,7 +3,7 @@ layout: home
 hero:
   name: OPC Agent
   text: 开放智能体框架
-  tagline: 构建、测试、运行面向业务工作站的 AI 智能体
+  tagline: 构建、测试、运行企业级 AI 智能体
   actions:
     - theme: brand
       text: 快速开始
@@ -12,16 +12,16 @@ hero:
       text: GitHub
       link: https://github.com/Deepleaper/opc-agent
 features:
-  - title: 🚀 快速开始
-    details: 2 分钟内创建智能体，内置 13 个模板
-  - title: 📝 OAD Schema
-    details: 基于 YAML 的声明式智能体定义
-  - title: 🔌 多渠道
-    details: Web、Telegram、Slack、微信、邮件、语音、WebSocket
-  - title: 🧪 测试框架
-    details: 在 OAD 中定义测试用例，opc test 运行
-  - title: 📊 分析
-    details: 跟踪消息、LLM 调用、工具使用和错误
-  - title: 🌍 国际化
-    details: 内置英文、中文、日文支持
+  - title: ⚡ 30 秒上手
+    details: 两条命令创建智能体，开箱即用，支持 12 个场景模板
+  - title: 📋 OAD 声明式定义
+    details: 用 YAML 文件定义智能体的一切：模型、技能、渠道、安全策略
+  - title: 📡 多渠道部署
+    details: Web、Telegram、Slack、微信公众号、飞书、WebSocket，一套代码到处运行
+  - title: 🧪 内置测试框架
+    details: 在 OAD 文件中定义测试用例，opc test 一键验证智能体行为
+  - title: 🔌 多模型支持
+    details: DeepSeek、通义千问、OpenAI、Anthropic、Ollama，不绑定任何一家
+  - title: 🧠 知识库 RAG
+    details: 添加文档自动构建知识库，智能体回答时语义检索增强
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opc-agent",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/cli.ts

@@ -520,41 +520,7 @@ program
     });
   });
 
-// ── Publish command ──────────────────────────────────────────
-
-program
-  .command('publish')
-  .description('Validate and package for OPC Registry')
-  .option('-f, --file <file>', 'OAD file', 'oad.yaml')
-  .action(async (opts: { file: string }) => {
-    try {
-      const runtime = new 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: any) => c.type),
-        skills: config.spec.skills.map((s: any) => 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 ───────────────────────────────────────────
 

package/src/i18n/index.ts

@@ -18,16 +18,33 @@ const messages: Record<Locale, I18nMessages> = {
     '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',
@@ -50,22 +67,39 @@ const messages: Record<Locale, I18nMessages> = {
   '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': '发送',
@@ -94,16 +128,33 @@ const messages: Record<Locale, I18nMessages> = {
     '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/tests/i18n.test.ts

@@ -9,7 +9,7 @@ describe('i18n', () => {
 
   it('should return Chinese messages', () => {
     setLocale('zh-CN');
-    expect(t('agent.greeting')).toBe('您好！有什么可以帮您的？');
+    expect(t('agent.greeting')).toBe('你好！有什么可以帮你的？');
     setLocale('en'); // reset
   });