opc-agent 4.1.24 → 4.2.0

package/package.json

@@ -1,66 +1,63 @@
-{
-  "name": "opc-agent",
-  "version": "4.1.24",
-  "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "bin": {
-    "opc": "dist/cli.js",
-    "opc-agent": "dist/cli.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "postbuild": "xcopy /E /I /Y src\\studio-ui dist\\studio-ui",
-    "test": "vitest run",
-    "dev": "tsc --watch",
-    "lint": "tsc --noEmit",
-    "setup": "opc setup",
-    "docs:dev": "vitepress dev docs",
-    "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs"
-  },
-  "keywords": [
-    "agent",
-    "ai",
-    "llm",
-    "framework",
-    "typescript",
-    "agent-framework"
-  ],
-  "author": "Deepleaper",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Deepleaper/opc-agent.git"
-  },
-  "dependencies": {
-    "agent-workstation": "^2.1.2",
-    "agentkits": "^2.0.1",
-    "commander": "^12.0.0",
-    "express": "^4.21.0",
-    "js-yaml": "^4.1.0",
-    "mammoth": "^1.12.0",
-    "pdf-parse": "^1.1.4",
-    "sql.js": "^1.14.1",
-    "ws": "^8.20.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.21",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.0",
-    "@types/sql.js": "^1.4.11",
-    "@types/ws": "^8.18.1",
-    "typescript": "^5.5.0",
-    "vitepress": "^1.5.0",
-    "vitest": "^2.0.0"
-  },
-  "peerDependencies": {
-    "deepbrain": "^2.0.5"
-  },
-  "peerDependenciesMeta": {
-    "deepbrain": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "opc-agent",
+  "version": "4.2.0",
+  "description": "Open Agent Framework — Build, test, and run AI Agents for business workstations",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "opc": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "xcopy /E /I /Y src\\studio-ui dist\\studio-ui",
+    "test": "vitest run",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "setup": "opc setup",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  },
+  "keywords": [
+    "agent",
+    "ai",
+    "llm",
+    "framework",
+    "typescript",
+    "agent-framework"
+  ],
+  "author": "Deepleaper",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Deepleaper/opc-agent.git"
+  },
+  "dependencies": {
+    "agent-workstation": "^2.1.2",
+    "agentkits": "^2.0.1",
+    "commander": "^12.0.0",
+    "express": "^4.21.0",
+    "js-yaml": "^4.1.0",
+    "mammoth": "^1.12.0",
+    "pdf-parse": "^1.1.4",
+    "ws": "^8.20.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.5.0",
+    "vitepress": "^1.5.0",
+    "vitest": "^2.0.0"
+  },
+  "peerDependencies": {
+    "deepbrain": "^2.0.5"
+  },
+  "peerDependenciesMeta": {
+    "deepbrain": {
+      "optional": true
+    }
+  }
+}

package/scripts/install.ps1

@@ -1,31 +1,31 @@
-# OPC Agent — Windows installer
-# Usage: irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/scripts/install.ps1 | iex
-
-Write-Host "🤖 Installing OPC Agent..." -ForegroundColor Cyan
-
-# Check Node.js
-if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
-    Write-Host "❌ Node.js is required. Install from https://nodejs.org (v18+)" -ForegroundColor Red
-    exit 1
-}
-
-$nodeVer = (node -v) -replace 'v','' -split '\.' | Select-Object -First 1
-if ([int]$nodeVer -lt 18) {
-    Write-Host "❌ Node.js 18+ required (found $(node -v))" -ForegroundColor Red
-    exit 1
-}
-
-Write-Host "📦 Installing opc-agent globally..."
-npm install -g opc-agent
-
-Write-Host "`n✅ OPC Agent installed!" -ForegroundColor Green
-Write-Host @"
-
-Quick start:
-  opc init my-agent
-  cd my-agent
-  npm install
-  opc chat
-
-Run 'opc doctor' to check your environment.
-"@
+# OPC Agent — Windows installer
+# Usage: irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/scripts/install.ps1 | iex
+
+Write-Host "🤖 Installing OPC Agent..." -ForegroundColor Cyan
+
+# Check Node.js
+if (-not (Get-Command node -ErrorAction SilentlyContinue)) {
+    Write-Host "❌ Node.js is required. Install from https://nodejs.org (v18+)" -ForegroundColor Red
+    exit 1
+}
+
+$nodeVer = (node -v) -replace 'v','' -split '\.' | Select-Object -First 1
+if ([int]$nodeVer -lt 18) {
+    Write-Host "❌ Node.js 18+ required (found $(node -v))" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host "📦 Installing opc-agent globally..."
+npm install -g opc-agent
+
+Write-Host "`n✅ OPC Agent installed!" -ForegroundColor Green
+Write-Host @"
+
+Quick start:
+  opc init my-agent
+  cd my-agent
+  npm install
+  opc chat
+
+Run 'opc doctor' to check your environment.
+"@

package/scripts/install.sh

@@ -1,40 +1,40 @@
-#!/bin/bash
-# OPC Agent — One-line installer
-# Usage: curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/scripts/install.sh | bash
-
-set -e
-
-echo "🤖 Installing OPC Agent..."
-
-# Check Node.js
-if ! command -v node &> /dev/null; then
-    echo "❌ Node.js is required. Install from https://nodejs.org (v18+)"
-    exit 1
-fi
-
-NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
-if [ "$NODE_VERSION" -lt 18 ]; then
-    echo "❌ Node.js 18+ required (found v$(node -v))"
-    exit 1
-fi
-
-# Install globally
-echo "📦 Installing opc-agent globally..."
-npm install -g opc-agent
-
-# Verify
-if command -v opc &> /dev/null; then
-    echo ""
-    echo "✅ OPC Agent installed successfully!"
-    echo ""
-    echo "Quick start:"
-    echo "  opc init my-agent"
-    echo "  cd my-agent"
-    echo "  npm install"
-    echo "  opc chat"
-    echo ""
-    echo "Run 'opc doctor' to check your environment."
-else
-    echo "⚠️  Installed but 'opc' command not found in PATH."
-    echo "Try: npx opc-agent --help"
-fi
+#!/bin/bash
+# OPC Agent — One-line installer
+# Usage: curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/scripts/install.sh | bash
+
+set -e
+
+echo "🤖 Installing OPC Agent..."
+
+# Check Node.js
+if ! command -v node &> /dev/null; then
+    echo "❌ Node.js is required. Install from https://nodejs.org (v18+)"
+    exit 1
+fi
+
+NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    echo "❌ Node.js 18+ required (found v$(node -v))"
+    exit 1
+fi
+
+# Install globally
+echo "📦 Installing opc-agent globally..."
+npm install -g opc-agent
+
+# Verify
+if command -v opc &> /dev/null; then
+    echo ""
+    echo "✅ OPC Agent installed successfully!"
+    echo ""
+    echo "Quick start:"
+    echo "  opc init my-agent"
+    echo "  cd my-agent"
+    echo "  npm install"
+    echo "  opc chat"
+    echo ""
+    echo "Run 'opc doctor' to check your environment."
+else
+    echo "⚠️  Installed but 'opc' command not found in PATH."
+    echo "Try: npx opc-agent --help"
+fi

package/templates/ecommerce-assistant/README.md

@@ -1,45 +1,45 @@
-# Ecommerce Assistant — 电商助手工位
-
-专为电商平台设计的 AI 导购与售后工位，覆盖商品推荐、订单查询、退换货处理全链路。
-
-## 快速开始
-
-```bash
-opc init --template ecommerce-assistant
-opc start
-```
-
-访问 http://localhost:3000 即可使用电商助手聊天界面。
-
-## 功能
-
-| 技能 | 说明 |
-|------|------|
-| product-search | 关键词/类目/价格区间商品搜索 |
-| order-query | 订单状态与物流实时查询 |
-| after-sale | 退换货受理与投诉处理 |
-| promotion | 个性化优惠券与促销推送 |
-| recommendation | 基于偏好的个性化商品推荐 |
-
-## 配置
-
-在 `oad.yaml` 中修改以下参数：
-
-- `spec.provider.default` — 切换 LLM 提供商（deepseek / openai / qwen）
-- `spec.model` — 指定模型版本
-- `spec.systemPrompt` — 定制品牌话术、商品范围和售后规则
-
-### 环境变量
-
-```bash
-OPC_LLM_API_KEY=your_key
-OPC_LLM_MODEL=deepseek-chat        # 可选，覆盖 oad.yaml 中的 model
-OPC_DEEPBRAIN_ENABLED=true         # 启用 DeepBrain 知识库增强（需全局安装 deepbrain）
-```
-
-## 推荐搭配
-
-- 将商品目录、售后政策、FAQ 上传至知识库（`/api/kb/upload`）
-- 开启 `OPC_DEEPBRAIN_ENABLED=true` 提升商品语义匹配精度
-- 通过 Dashboard（`/dashboard`）监控转化率、客满率和退单率
-- 结合 CRM 系统 Webhook 实现订单状态实时同步
+# Ecommerce Assistant — 电商助手工位
+
+专为电商平台设计的 AI 导购与售后工位，覆盖商品推荐、订单查询、退换货处理全链路。
+
+## 快速开始
+
+```bash
+opc init --template ecommerce-assistant
+opc start
+```
+
+访问 http://localhost:3000 即可使用电商助手聊天界面。
+
+## 功能
+
+| 技能 | 说明 |
+|------|------|
+| product-search | 关键词/类目/价格区间商品搜索 |
+| order-query | 订单状态与物流实时查询 |
+| after-sale | 退换货受理与投诉处理 |
+| promotion | 个性化优惠券与促销推送 |
+| recommendation | 基于偏好的个性化商品推荐 |
+
+## 配置
+
+在 `oad.yaml` 中修改以下参数：
+
+- `spec.provider.default` — 切换 LLM 提供商（deepseek / openai / qwen）
+- `spec.model` — 指定模型版本
+- `spec.systemPrompt` — 定制品牌话术、商品范围和售后规则
+
+### 环境变量
+
+```bash
+OPC_LLM_API_KEY=your_key
+OPC_LLM_MODEL=deepseek-chat        # 可选，覆盖 oad.yaml 中的 model
+OPC_DEEPBRAIN_ENABLED=true         # 启用 DeepBrain 知识库增强（需全局安装 deepbrain）
+```
+
+## 推荐搭配
+
+- 将商品目录、售后政策、FAQ 上传至知识库（`/api/kb/upload`）
+- 开启 `OPC_DEEPBRAIN_ENABLED=true` 提升商品语义匹配精度
+- 通过 Dashboard（`/dashboard`）监控转化率、客满率和退单率
+- 结合 CRM 系统 Webhook 实现订单状态实时同步

package/templates/ecommerce-assistant/oad.yaml

@@ -1,47 +1,47 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: ecommerce-assistant
-  version: 1.0.0
-  description: "电商助手工位 - 商品推荐、订单查询、售后服务一体化"
-  author: Deepleaper
-  license: Apache-2.0
-  marketplace:
-    certified: false
-    category: ecommerce
-spec:
-  provider:
-    default: deepseek
-    allowed: [openai, deepseek, qwen, gemini]
-  model: deepseek-chat
-  systemPrompt: |
-    你是一名专业的电商购物助手。
-    你帮助用户查询商品信息、比较价格、处理订单状态和售后问题。
-    根据用户需求推荐合适的商品，推送当前促销活动，并协助用户做出购买决策。
-    处理退换货申请时，需先核实订单信息，再按平台规则指引用户操作。
-    始终保持友好、热情、专业的服务态度。
-  skills:
-    - name: product-search
-      description: "搜索商品信息，支持关键词、类目、价格区间筛选"
-    - name: order-query
-      description: "查询订单状态、物流轨迹和预计送达时间"
-    - name: after-sale
-      description: "处理退换货申请、投诉受理和赔偿协商"
-    - name: promotion
-      description: "推送个性化优惠券、限时活动和会员权益"
-    - name: recommendation
-      description: "基于用户偏好和购买历史做商品推荐"
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm: true
-  knowledge:
-    enabled: true
-    deepbrain: auto
-  dtv:
-    trust:
-      level: sandbox
-    value:
-      metrics: [conversion_rate, customer_satisfaction, avg_order_value, refund_rate]
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: ecommerce-assistant
+  version: 1.0.0
+  description: "电商助手工位 - 商品推荐、订单查询、售后服务一体化"
+  author: Deepleaper
+  license: Apache-2.0
+  marketplace:
+    certified: false
+    category: ecommerce
+spec:
+  provider:
+    default: deepseek
+    allowed: [openai, deepseek, qwen, gemini]
+  model: deepseek-chat
+  systemPrompt: |
+    你是一名专业的电商购物助手。
+    你帮助用户查询商品信息、比较价格、处理订单状态和售后问题。
+    根据用户需求推荐合适的商品，推送当前促销活动，并协助用户做出购买决策。
+    处理退换货申请时，需先核实订单信息，再按平台规则指引用户操作。
+    始终保持友好、热情、专业的服务态度。
+  skills:
+    - name: product-search
+      description: "搜索商品信息，支持关键词、类目、价格区间筛选"
+    - name: order-query
+      description: "查询订单状态、物流轨迹和预计送达时间"
+    - name: after-sale
+      description: "处理退换货申请、投诉受理和赔偿协商"
+    - name: promotion
+      description: "推送个性化优惠券、限时活动和会员权益"
+    - name: recommendation
+      description: "基于用户偏好和购买历史做商品推荐"
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm: true
+  knowledge:
+    enabled: true
+    deepbrain: auto
+  dtv:
+    trust:
+      level: sandbox
+    value:
+      metrics: [conversion_rate, customer_satisfaction, avg_order_value, refund_rate]

package/templates/tech-support/README.md

@@ -1,43 +1,43 @@
-# Tech Support Agent — 技术支持工位
-
-专为 IT 支持团队设计的 AI 工位，覆盖软件故障、系统配置、网络问题等场景。
-
-## 快速开始
-
-```bash
-opc init --template tech-support
-opc start
-```
-
-访问 http://localhost:3000 即可使用技术支持聊天界面。
-
-## 功能
-
-| 技能 | 说明 |
-|------|------|
-| troubleshoot | 分步骤诊断和解决技术问题 |
-| knowledge-lookup | 查询技术文档与历史解决方案 |
-| ticket-create | 创建并跟踪技术支持工单 |
-| escalate | 升级复杂问题至专项团队 |
-
-## 配置
-
-在 `oad.yaml` 中修改以下参数：
-
-- `spec.provider.default` — 切换 LLM 提供商（deepseek / openai / qwen）
-- `spec.model` — 指定模型版本
-- `spec.systemPrompt` — 定制支持范围和话术风格
-
-### 环境变量
-
-```bash
-OPC_LLM_API_KEY=your_key
-OPC_LLM_MODEL=deepseek-chat        # 可选，覆盖 oad.yaml 中的 model
-OPC_DEEPBRAIN_ENABLED=true         # 启用 DeepBrain 知识库增强（需全局安装 deepbrain）
-```
-
-## 推荐搭配
-
-- 将内部技术文档、SOP、FAQ 上传至知识库（`/api/kb/upload`）
-- 开启 `OPC_DEEPBRAIN_ENABLED=true` 获得更精准的语义检索
-- 通过 Dashboard（`/dashboard`）监控首次解决率和平均响应时间
+# Tech Support Agent — 技术支持工位
+
+专为 IT 支持团队设计的 AI 工位，覆盖软件故障、系统配置、网络问题等场景。
+
+## 快速开始
+
+```bash
+opc init --template tech-support
+opc start
+```
+
+访问 http://localhost:3000 即可使用技术支持聊天界面。
+
+## 功能
+
+| 技能 | 说明 |
+|------|------|
+| troubleshoot | 分步骤诊断和解决技术问题 |
+| knowledge-lookup | 查询技术文档与历史解决方案 |
+| ticket-create | 创建并跟踪技术支持工单 |
+| escalate | 升级复杂问题至专项团队 |
+
+## 配置
+
+在 `oad.yaml` 中修改以下参数：
+
+- `spec.provider.default` — 切换 LLM 提供商（deepseek / openai / qwen）
+- `spec.model` — 指定模型版本
+- `spec.systemPrompt` — 定制支持范围和话术风格
+
+### 环境变量
+
+```bash
+OPC_LLM_API_KEY=your_key
+OPC_LLM_MODEL=deepseek-chat        # 可选，覆盖 oad.yaml 中的 model
+OPC_DEEPBRAIN_ENABLED=true         # 启用 DeepBrain 知识库增强（需全局安装 deepbrain）
+```
+
+## 推荐搭配
+
+- 将内部技术文档、SOP、FAQ 上传至知识库（`/api/kb/upload`）
+- 开启 `OPC_DEEPBRAIN_ENABLED=true` 获得更精准的语义检索
+- 通过 Dashboard（`/dashboard`）监控首次解决率和平均响应时间

package/templates/tech-support/oad.yaml

@@ -1,45 +1,45 @@
-apiVersion: opc/v1
-kind: Agent
-metadata:
-  name: tech-support
-  version: 1.0.0
-  description: "技术支持工位 - 处理用户技术问题、故障排查和解决方案推荐"
-  author: Deepleaper
-  license: Apache-2.0
-  marketplace:
-    certified: false
-    category: it-support
-spec:
-  provider:
-    default: deepseek
-    allowed: [openai, deepseek, qwen, gemini]
-  model: deepseek-chat
-  systemPrompt: |
-    你是一名专业的技术支持工程师。
-    你帮助用户解决技术问题，包括软件故障、系统配置、网络问题、硬件故障等。
-    回答时请保持专业、耐心，并提供清晰的步骤指引。
-    优先使用知识库中的已知解决方案。
-    如果问题无法远程解决，请指导用户联系线下支持或提交工单。
-  skills:
-    - name: troubleshoot
-      description: "诊断和解决技术问题，提供分步骤操作指南"
-    - name: knowledge-lookup
-      description: "查询技术文档、FAQ 和历史解决方案库"
-    - name: ticket-create
-      description: "为复杂问题创建技术支持工单并跟踪进展"
-    - name: escalate
-      description: "将高优先级问题升级到高级工程师或专项团队"
-  channels:
-    - type: web
-      port: 3000
-  memory:
-    shortTerm: true
-    longTerm: true
-  knowledge:
-    enabled: true
-    deepbrain: auto
-  dtv:
-    trust:
-      level: internal
-    value:
-      metrics: [resolution_time, first_contact_resolution, customer_satisfaction]
+apiVersion: opc/v1
+kind: Agent
+metadata:
+  name: tech-support
+  version: 1.0.0
+  description: "技术支持工位 - 处理用户技术问题、故障排查和解决方案推荐"
+  author: Deepleaper
+  license: Apache-2.0
+  marketplace:
+    certified: false
+    category: it-support
+spec:
+  provider:
+    default: deepseek
+    allowed: [openai, deepseek, qwen, gemini]
+  model: deepseek-chat
+  systemPrompt: |
+    你是一名专业的技术支持工程师。
+    你帮助用户解决技术问题，包括软件故障、系统配置、网络问题、硬件故障等。
+    回答时请保持专业、耐心，并提供清晰的步骤指引。
+    优先使用知识库中的已知解决方案。
+    如果问题无法远程解决，请指导用户联系线下支持或提交工单。
+  skills:
+    - name: troubleshoot
+      description: "诊断和解决技术问题，提供分步骤操作指南"
+    - name: knowledge-lookup
+      description: "查询技术文档、FAQ 和历史解决方案库"
+    - name: ticket-create
+      description: "为复杂问题创建技术支持工单并跟踪进展"
+    - name: escalate
+      description: "将高优先级问题升级到高级工程师或专项团队"
+  channels:
+    - type: web
+      port: 3000
+  memory:
+    shortTerm: true
+    longTerm: true
+  knowledge:
+    enabled: true
+    deepbrain: auto
+  dtv:
+    trust:
+      level: internal
+    value:
+      metrics: [resolution_time, first_contact_resolution, customer_satisfaction]