xiaozhi-client 1.9.3 → 1.9.4-beta.1

package/dist/shared-types/index.js

@@ -0,0 +1,36 @@
+// src/frontend/api.ts
+var MCPErrorCode = /* @__PURE__ */ ((MCPErrorCode2) => {
+  MCPErrorCode2["SERVER_NOT_FOUND"] = "SERVER_NOT_FOUND";
+  MCPErrorCode2["SERVER_ALREADY_EXISTS"] = "SERVER_ALREADY_EXISTS";
+  MCPErrorCode2["INVALID_SERVICE_NAME"] = "INVALID_SERVICE_NAME";
+  MCPErrorCode2["INVALID_CONFIG"] = "INVALID_CONFIG";
+  MCPErrorCode2["CONFIG_UPDATE_FAILED"] = "CONFIG_UPDATE_FAILED";
+  MCPErrorCode2["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+  MCPErrorCode2["ADD_FAILED"] = "ADD_FAILED";
+  MCPErrorCode2["REMOVE_FAILED"] = "REMOVE_FAILED";
+  MCPErrorCode2["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+  MCPErrorCode2["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+  return MCPErrorCode2;
+})(MCPErrorCode || {});
+
+// src/utils/timeout.ts
+var TimeoutError = class _TimeoutError extends Error {
+  name = "TimeoutError";
+  constructor(message) {
+    super(message);
+    this.name = "TimeoutError";
+    Error.captureStackTrace(this, _TimeoutError);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      stack: this.stack
+    };
+  }
+};
+export {
+  MCPErrorCode,
+  TimeoutError
+};
+//# sourceMappingURL=index.js.map

package/dist/shared-types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../packages/shared-types/src/frontend/api.ts","../../packages/shared-types/src/utils/timeout.ts"],"sourcesContent":["/**\n * 前端API响应相关类型定义\n */\n\nimport type { MCPServerConfig } from \"../config\";\n\n/**\n * MCP 服务添加请求接口（单服务格式）\n */\nexport interface MCPServerAddRequest {\n  name: string;\n  config: MCPServerConfig;\n}\n\n/**\n * MCP 服务批量添加请求接口（mcpServers 格式）\n */\nexport interface MCPServerBatchAddRequest {\n  mcpServers: Record<string, MCPServerConfig>;\n}\n\n/**\n * MCP 服务添加操作结果\n */\nexport interface MCPServerAddResult {\n  name: string;\n  success: boolean;\n  error?: string;\n  config?: MCPServerConfig;\n  tools?: string[];\n  status?: string;\n}\n\n/**\n * MCP 服务批量添加响应\n */\nexport interface MCPServerBatchAddResponse {\n  success: boolean;\n  message: string;\n  results: MCPServerAddResult[];\n  addedCount: number;\n  failedCount: number;\n}\n\n/**\n * MCP 服务状态接口\n */\nexport interface MCPServerStatus {\n  name: string;\n  status: \"connected\" | \"disconnected\" | \"connecting\" | \"error\";\n  connected: boolean;\n  tools: string[];\n  lastUpdated?: string;\n  config: MCPServerConfig;\n}\n\n/**\n * MCP 服务列表响应接口\n */\nexport interface MCPServerListResponse {\n  servers: MCPServerStatus[];\n  total: number;\n}\n\n/**\n * API 统一响应格式接口\n */\nexport interface ApiSuccessResponse<T = any> {\n  success: boolean;\n  data?: T;\n  message?: string;\n}\n\nexport interface ApiErrorResponse {\n  error: {\n    code: string;\n    message: string;\n    details?: {\n      serverName?: string;\n      config?: any;\n      tools?: string[];\n      timestamp: string;\n    };\n  };\n}\n\n/**\n * API 错误码枚举\n */\nexport enum MCPErrorCode {\n  // 服务相关错误\n  SERVER_NOT_FOUND = \"SERVER_NOT_FOUND\",\n  SERVER_ALREADY_EXISTS = \"SERVER_ALREADY_EXISTS\",\n  INVALID_SERVICE_NAME = \"INVALID_SERVICE_NAME\",\n\n  // 配置相关错误\n  INVALID_CONFIG = \"INVALID_CONFIG\",\n  CONFIG_UPDATE_FAILED = \"CONFIG_UPDATE_FAILED\",\n\n  // 连接相关错误\n  CONNECTION_FAILED = \"CONNECTION_FAILED\",\n\n  // 操作相关错误\n  ADD_FAILED = \"ADD_FAILED\",\n  REMOVE_FAILED = \"REMOVE_FAILED\",\n\n  // 系统错误\n  INTERNAL_ERROR = \"INTERNAL_ERROR\",\n  VALIDATION_ERROR = \"VALIDATION_ERROR\",\n}\n\n/**\n * 工具调用记录\n */\nexport interface ToolCallRecord {\n  /** 工具名称 */\n  toolName: string;\n  /** 原始工具名称（如果有的话） */\n  originalToolName?: string;\n  /** 服务器名称 */\n  serverName?: string;\n  /** 调用参数 */\n  arguments?: any;\n  /** 调用结果 */\n  result?: any;\n  /** 是否成功 */\n  success: boolean;\n  /** 调用耗时（毫秒） */\n  duration?: number;\n  /** 错误信息 */\n  error?: string;\n  /** 时间戳 */\n  timestamp?: number;\n}\n\n/**\n * 工具调用日志响应\n */\nexport interface ToolCallLogsResponse {\n  /** 日志记录列表 */\n  records: ToolCallRecord[];\n  /** 总数量 */\n  total: number;\n  /** 是否有更多数据 */\n  hasMore: boolean;\n}\n\n/**\n * API通用响应格式\n */\nexport interface ApiResponse<T = any> {\n  success: boolean;\n  data?: T;\n  error?: {\n    code: string;\n    message: string;\n    details?: any;\n  };\n}\n","/**\n * 超时处理相关类型定义\n */\n\n/**\n * 超时错误类型\n */\nexport class TimeoutError extends Error {\n  public override readonly name = \"TimeoutError\" as const;\n\n  constructor(message: string) {\n    super(message);\n    this.name = \"TimeoutError\";\n    Error.captureStackTrace(this, TimeoutError);\n  }\n\n  toJSON() {\n    return {\n      name: this.name,\n      message: this.message,\n      stack: this.stack,\n    };\n  }\n}\n\n/**\n * 超时响应接口\n */\nexport interface TimeoutResponse {\n  content: Array<{\n    type: \"text\";\n    text: string;\n  }>;\n  isError: boolean;\n  taskId: string;\n  status: \"timeout\";\n  message: string;\n  nextAction: string;\n}\n\n/**\n * 验证是否为超时响应\n */\nexport function isTimeoutResponse(response: any): response is TimeoutResponse {\n  return !!(\n    response &&\n    response.status === \"timeout\" &&\n    typeof response.taskId === \"string\" &&\n    Array.isArray(response.content) &&\n    response.content.length > 0 &&\n    response.content[0].type === \"text\"\n  );\n}\n\n/**\n * 验证是否为超时错误\n */\nexport function isTimeoutError(error: any): error is TimeoutError {\n  return !!(\n    error &&\n    error.name === \"TimeoutError\" &&\n    error instanceof TimeoutError\n  );\n}\n"],"mappings":";AAyFO,IAAK,eAAL,kBAAKA,kBAAL;AAEL,EAAAA,cAAA,sBAAmB;AACnB,EAAAA,cAAA,2BAAwB;AACxB,EAAAA,cAAA,0BAAuB;AAGvB,EAAAA,cAAA,oBAAiB;AACjB,EAAAA,cAAA,0BAAuB;AAGvB,EAAAA,cAAA,uBAAoB;AAGpB,EAAAA,cAAA,gBAAa;AACb,EAAAA,cAAA,mBAAgB;AAGhB,EAAAA,cAAA,oBAAiB;AACjB,EAAAA,cAAA,sBAAmB;AAnBT,SAAAA;AAAA,GAAA;;;AClFL,IAAM,eAAN,MAAM,sBAAqB,MAAM;AAAA,EACb,OAAO;AAAA,EAEhC,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,UAAM,kBAAkB,MAAM,aAAY;AAAA,EAC5C;AAAA,EAEA,SAAS;AACP,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,SAAS,KAAK;AAAA,MACd,OAAO,KAAK;AAAA,IACd;AAAA,EACF;AACF;","names":["MCPErrorCode"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xiaozhi-client",
-  "version": "1.9.3",
+  "version": "1.9.4-beta.1",
   "description": "小智 AI 客户端 命令行工具",
   "repository": {
     "type": "git",
@@ -15,12 +15,10 @@
     "ai"
   ],
   "type": "module",
-  "main": "dist/cli.js",
+  "main": "dist/backend/cli.js",
   "files": [
     "dist",
-    "docs",
     "templates",
-    "apps/frontend/dist",
     "README.md",
     "LICENSE"
   ],
@@ -29,8 +27,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "bin": {
-    "xiaozhi": "dist/cli.js",
-    "xiaozhi-client": "dist/cli.js"
+    "xiaozhi": "dist/backend/cli.js",
+    "xiaozhi-client": "dist/backend/cli.js"
   },
   "scripts": {
     "build": "pnpm run build:packages && pnpm run build:web && cross-env NODE_ENV=${NODE_ENV:-production} tsup --config config/tsup.config.ts",
@@ -52,9 +50,20 @@
     "duplicate:check": "jscpd apps/backend/",
     "docker:update-version": "node docker/scripts/update-version.js",
     "example": "node --loader ts-node/esm",
-    "docs:dev": "cd docs && mintlify dev",
+    "docs:dev": "cd docs && pnpm dev",
     "release": "npx release-it --config config/release-it.json",
-    "release:dry": "npx release-it --config config/release-it.json --dry-run"
+    "release:dry": "npx release-it --config config/release-it.json --dry-run",
+    "nx:lint": "nx run-many -t lint",
+    "nx:type-check": "nx run-many -t type-check",
+    "nx:test": "nx run-many -t test",
+    "nx:test:coverage": "nx run-many -t test:coverage --parallel=true",
+    "nx:build": "nx run-many -t build --parallel=false",
+    "nx:projects": "nx show projects",
+    "nx:graph": "nx graph",
+    "nx:affected": "nx print-affected",
+    "nx:backend": "nx run backend:build",
+    "nx:frontend": "nx run frontend:build",
+    "nx:docs": "nx run docs:build"
   },
   "dependencies": {
     "@coze/api": "^1.3.9",
@@ -85,6 +94,9 @@
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@codecov/vite-plugin": "^1.9.1",
+    "@nx/vite": "^22.3.3",
+    "@nx/vitest": "^22.3.3",
+    "@nx/workspace": "^22.3.3",
     "@release-it/conventional-changelog": "^10.0.1",
     "@types/node": "^24.3.0",
     "@types/node-fetch": "^2.6.12",
@@ -101,7 +113,7 @@
     "glob": "^11.0.3",
     "happy-dom": "^20.0.2",
     "jscpd": "^4.0.5",
-    "mintlify": "^4.0.423",
+    "nx": "^22.3.3",
     "release-it": "^19.0.4",
     "semver": "^7.7.2",
     "supertest": "^7.1.4",

package/apps/frontend/README.md

@@ -1,169 +0,0 @@
-# 小智客户端 Web UI
-
-这是小智客户端的 Web 配置界面，提供了一个现代化、直观的界面来管理 MCP 服务配置。
-
-## 功能特性
-
-- 🎨 **现代化设计**：基于 shadcn/ui 组件库，提供优雅的用户界面
-- 🔧 **可视化配置**：无需手动编辑 JSON 文件，通过界面即可完成所有配置
-- 🚀 **实时状态监控**：实时显示与小智服务器的连接状态
-- 📦 **MCP 服务管理**：支持添加、编辑、删除 MCP 服务，支持本地和 SSE 类型
-- ⚙️ **灵活的配置选项**：可调整心跳间隔、超时时间等连接参数
-- 🎯 **优秀的用户体验**：Toast 通知、确认对话框、平滑动画等
-
-## 技术栈
-
-- **框架**: React 18 + TypeScript
-- **构建工具**: Vite
-- **样式**: Tailwind CSS
-- **UI 组件**: shadcn/ui
-- **状态管理**: React Hooks
-- **通知系统**: Sonner
-- **图标**: Lucide React
-- **代码质量**: Biome (代码格式化和 linting)
-- **测试**: Vitest + React Testing Library
-
-## 开发指南
-
-### 安装依赖
-
-```bash
-pnpm install
-```
-
-### 开发命令
-
-```bash
-# 启动开发服务器
-pnpm dev
-
-# 构建生产版本
-pnpm build
-
-# 预览生产构建
-pnpm preview
-
-# 运行测试
-pnpm test
-
-# 运行测试（watch 模式）
-pnpm test:watch
-
-# 生成测试覆盖率报告
-pnpm test:coverage
-
-# 代码格式化
-pnpm format
-
-# 代码检查
-pnpm lint
-
-# 类型检查
-pnpm type:check
-
-# 运行所有检查并修复
-pnpm check:write
-```
-
-### 项目结构
-
-```
-web/
-├── src/
-│   ├── components/
-│   │   ├── ui/          # shadcn/ui 组件
-│   │   ├── ConfigEditor.tsx    # 配置编辑器
-│   │   ├── MCPServerList.tsx   # MCP 服务列表
-│   │   └── StatusCard.tsx      # 状态卡片
-│   ├── hooks/           # 自定义 React Hooks
-│   │   └── useWebSocket.ts     # WebSocket 连接管理
-│   ├── pages/           # 页面组件
-│   │   └── Dashboard.tsx       # 主控制台页面
-│   ├── types/           # TypeScript 类型定义
-│   ├── utils/           # 工具函数
-│   ├── App.tsx          # 应用主组件
-│   ├── main.tsx         # 应用入口
-│   └── index.css        # 全局样式
-├── public/              # 静态资源
-├── tests/               # 测试文件
-└── package.json         # 项目配置
-```
-
-### UI 组件说明
-
-#### StatusCard
-显示与小智服务器的连接状态，包括：
-- 连接状态指示器（连接中/已连接/已断开）
-- 最后活动时间
-- 重连按钮
-
-#### ConfigEditor
-配置编辑器，用于：
-- 编辑 MCP 接入点 URL
-- 调整连接参数（心跳间隔、超时时间等）
-- 管理 ModelScope API Key
-
-#### MCPServerList
-MCP 服务管理界面，支持：
-- 查看所有已配置的 MCP 服务
-- 添加新服务（支持 JSON 批量导入）
-- 编辑现有服务配置
-- 删除服务（带确认对话框）
-
-### 样式定制
-
-项目使用 Tailwind CSS 和 CSS 变量进行样式管理。主题颜色定义在 `src/index.css` 中：
-
-```css
-:root {
-  --background: 0 0% 100%;
-  --foreground: 222.2 84% 4.9%;
-  --primary: 222.2 47.4% 11.2%;
-  --destructive: 0 84.2% 60.2%;
-  /* ... 其他颜色变量 */
-}
-```
-
-### 添加新的 UI 组件
-
-如果需要添加新的 shadcn/ui 组件：
-
-```bash
-# 查看可用组件
-npx shadcn@latest add
-
-# 添加特定组件（例如 dialog）
-npx shadcn@latest add dialog
-```
-
-### 测试
-
-项目使用 Vitest 进行单元测试：
-
-```bash
-# 运行所有测试
-pnpm test
-
-# 运行特定测试文件
-pnpm test ConfigEditor
-
-# 生成覆盖率报告
-pnpm test:coverage
-```
-
-### 贡献指南
-
-1. Fork 项目
-2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
-3. 提交更改 (`git commit -m 'feat: 添加某个很棒的功能'`)
-4. 推送到分支 (`git push origin feature/amazing-feature`)
-5. 创建 Pull Request
-
-提交前请确保：
-- 所有测试通过 (`pnpm test`)
-- 代码通过格式检查 (`pnpm check:write`)
-- 类型检查通过 (`pnpm type:check`)
-
-## 许可证
-
-MIT License