sec commit
This commit is contained in:
588
system-api/api-spec.json
Normal file
588
system-api/api-spec.json
Normal file
@@ -0,0 +1,588 @@
|
||||
{
|
||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||
"title": "多Agent系统API规范",
|
||||
"version": "1.0.0",
|
||||
"description": "多Agent协作系统的标准化接口定义",
|
||||
"created": "2026-03-31T14:41:00Z",
|
||||
"lastUpdated": "2026-03-31T14:41:00Z",
|
||||
|
||||
"interfaces": {
|
||||
"system": {
|
||||
"description": "系统级接口",
|
||||
"endpoints": {
|
||||
"info": {
|
||||
"path": "/api/system/info",
|
||||
"method": "GET",
|
||||
"description": "获取系统基本信息",
|
||||
"response": {
|
||||
"name": "string",
|
||||
"version": "string",
|
||||
"location": "string",
|
||||
"status": "string"
|
||||
}
|
||||
},
|
||||
"health": {
|
||||
"path": "/api/system/health",
|
||||
"method": "GET",
|
||||
"description": "检查系统健康状态",
|
||||
"response": {
|
||||
"status": "string",
|
||||
"components": "object",
|
||||
"timestamp": "string"
|
||||
}
|
||||
},
|
||||
"discover": {
|
||||
"path": "/api/system/discover",
|
||||
"method": "GET",
|
||||
"description": "发现系统可用功能",
|
||||
"response": {
|
||||
"commands": "array",
|
||||
"agents": "array",
|
||||
"projects": "array"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"command": {
|
||||
"description": "指令处理接口",
|
||||
"endpoints": {
|
||||
"parse": {
|
||||
"path": "/api/command/parse",
|
||||
"method": "POST",
|
||||
"description": "解析用户输入为系统指令",
|
||||
"request": {
|
||||
"input": "string",
|
||||
"context": "object"
|
||||
},
|
||||
"response": {
|
||||
"type": "string",
|
||||
"command": "string",
|
||||
"args": "array",
|
||||
"confidence": "number"
|
||||
}
|
||||
},
|
||||
"execute": {
|
||||
"path": "/api/command/execute",
|
||||
"method": "POST",
|
||||
"description": "执行系统指令",
|
||||
"request": {
|
||||
"command": "string",
|
||||
"args": "array",
|
||||
"options": "object"
|
||||
},
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"result": "object",
|
||||
"taskId": "string",
|
||||
"message": "string"
|
||||
}
|
||||
},
|
||||
"list": {
|
||||
"path": "/api/command/list",
|
||||
"method": "GET",
|
||||
"description": "列出所有可用指令",
|
||||
"response": {
|
||||
"basic": "array",
|
||||
"advanced": "array",
|
||||
"admin": "array"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"project": {
|
||||
"description": "项目管理接口",
|
||||
"endpoints": {
|
||||
"create": {
|
||||
"path": "/api/project/create",
|
||||
"method": "POST",
|
||||
"description": "创建新项目",
|
||||
"request": {
|
||||
"name": "string",
|
||||
"type": "string",
|
||||
"requirements": "string",
|
||||
"timeline": "string"
|
||||
},
|
||||
"response": {
|
||||
"id": "string",
|
||||
"name": "string",
|
||||
"status": "string",
|
||||
"taskId": "string"
|
||||
}
|
||||
},
|
||||
"list": {
|
||||
"path": "/api/project/list",
|
||||
"method": "GET",
|
||||
"description": "列出所有项目",
|
||||
"query": {
|
||||
"status": "string",
|
||||
"type": "string",
|
||||
"limit": "number"
|
||||
},
|
||||
"response": {
|
||||
"projects": "array",
|
||||
"total": "number",
|
||||
"page": "number"
|
||||
}
|
||||
},
|
||||
"get": {
|
||||
"path": "/api/project/{id}",
|
||||
"method": "GET",
|
||||
"description": "获取项目详情",
|
||||
"response": {
|
||||
"id": "string",
|
||||
"name": "string",
|
||||
"status": "string",
|
||||
"tasks": "array",
|
||||
"files": "array",
|
||||
"timeline": "object"
|
||||
}
|
||||
},
|
||||
"update": {
|
||||
"path": "/api/project/{id}",
|
||||
"method": "PUT",
|
||||
"description": "更新项目信息",
|
||||
"request": {
|
||||
"status": "string",
|
||||
"progress": "number",
|
||||
"notes": "string"
|
||||
},
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"updated": "object"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"task": {
|
||||
"description": "任务管理接口",
|
||||
"endpoints": {
|
||||
"create": {
|
||||
"path": "/api/task/create",
|
||||
"method": "POST",
|
||||
"description": "创建新任务",
|
||||
"request": {
|
||||
"projectId": "string",
|
||||
"title": "string",
|
||||
"description": "string",
|
||||
"assignee": "string",
|
||||
"priority": "string"
|
||||
},
|
||||
"response": {
|
||||
"id": "string",
|
||||
"title": "string",
|
||||
"status": "string",
|
||||
"created": "string"
|
||||
}
|
||||
},
|
||||
"assign": {
|
||||
"path": "/api/task/{id}/assign",
|
||||
"method": "POST",
|
||||
"description": "分配任务给Agent",
|
||||
"request": {
|
||||
"agent": "string",
|
||||
"deadline": "string"
|
||||
},
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"assignedTo": "string",
|
||||
"deadline": "string"
|
||||
}
|
||||
},
|
||||
"status": {
|
||||
"path": "/api/task/{id}/status",
|
||||
"method": "GET",
|
||||
"description": "获取任务状态",
|
||||
"response": {
|
||||
"id": "string",
|
||||
"status": "string",
|
||||
"progress": "number",
|
||||
"assignee": "string",
|
||||
"updates": "array"
|
||||
}
|
||||
},
|
||||
"complete": {
|
||||
"path": "/api/task/{id}/complete",
|
||||
"method": "POST",
|
||||
"description": "标记任务完成",
|
||||
"request": {
|
||||
"result": "object",
|
||||
"notes": "string"
|
||||
},
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"completedAt": "string",
|
||||
"nextTask": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"agent": {
|
||||
"description": "Agent管理接口",
|
||||
"endpoints": {
|
||||
"list": {
|
||||
"path": "/api/agent/list",
|
||||
"method": "GET",
|
||||
"description": "列出所有Agent",
|
||||
"response": {
|
||||
"agents": "array",
|
||||
"active": "array",
|
||||
"available": "array"
|
||||
}
|
||||
},
|
||||
"start": {
|
||||
"path": "/api/agent/{id}/start",
|
||||
"method": "POST",
|
||||
"description": "启动Agent",
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"agentId": "string",
|
||||
"status": "string"
|
||||
}
|
||||
},
|
||||
"stop": {
|
||||
"path": "/api/agent/{id}/stop",
|
||||
"method": "POST",
|
||||
"description": "停止Agent",
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"stoppedAt": "string"
|
||||
}
|
||||
},
|
||||
"status": {
|
||||
"path": "/api/agent/{id}/status",
|
||||
"method": "GET",
|
||||
"description": "获取Agent状态",
|
||||
"response": {
|
||||
"id": "string",
|
||||
"status": "string",
|
||||
"currentTask": "string",
|
||||
"performance": "object"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"file": {
|
||||
"description": "文件管理接口",
|
||||
"endpoints": {
|
||||
"list": {
|
||||
"path": "/api/file/list",
|
||||
"method": "GET",
|
||||
"description": "列出目录文件",
|
||||
"query": {
|
||||
"path": "string",
|
||||
"type": "string"
|
||||
},
|
||||
"response": {
|
||||
"path": "string",
|
||||
"files": "array",
|
||||
"directories": "array"
|
||||
}
|
||||
},
|
||||
"read": {
|
||||
"path": "/api/file/read",
|
||||
"method": "GET",
|
||||
"description": "读取文件内容",
|
||||
"query": {
|
||||
"path": "string",
|
||||
"encoding": "string"
|
||||
},
|
||||
"response": {
|
||||
"path": "string",
|
||||
"content": "string",
|
||||
"size": "number",
|
||||
"modified": "string"
|
||||
}
|
||||
},
|
||||
"write": {
|
||||
"path": "/api/file/write",
|
||||
"method": "POST",
|
||||
"description": "写入文件内容",
|
||||
"request": {
|
||||
"path": "string",
|
||||
"content": "string",
|
||||
"append": "boolean"
|
||||
},
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"path": "string",
|
||||
"size": "number"
|
||||
}
|
||||
},
|
||||
"structure": {
|
||||
"path": "/api/file/structure",
|
||||
"method": "GET",
|
||||
"description": "获取文件结构",
|
||||
"response": {
|
||||
"root": "string",
|
||||
"structure": "object",
|
||||
"totalFiles": "number"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"state": {
|
||||
"description": "状态管理接口",
|
||||
"endpoints": {
|
||||
"get": {
|
||||
"path": "/api/state",
|
||||
"method": "GET",
|
||||
"description": "获取系统状态",
|
||||
"response": "object"
|
||||
},
|
||||
"update": {
|
||||
"path": "/api/state",
|
||||
"method": "PUT",
|
||||
"description": "更新系统状态",
|
||||
"request": "object",
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"updated": "array",
|
||||
"timestamp": "string"
|
||||
}
|
||||
},
|
||||
"backup": {
|
||||
"path": "/api/state/backup",
|
||||
"method": "POST",
|
||||
"description": "创建状态备份",
|
||||
"response": {
|
||||
"backupId": "string",
|
||||
"timestamp": "string",
|
||||
"size": "number"
|
||||
}
|
||||
},
|
||||
"restore": {
|
||||
"path": "/api/state/restore",
|
||||
"method": "POST",
|
||||
"description": "恢复状态备份",
|
||||
"request": {
|
||||
"backupId": "string"
|
||||
},
|
||||
"response": {
|
||||
"success": "boolean",
|
||||
"restoredFrom": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
|
||||
"models": {
|
||||
"command": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"type": {
|
||||
"type": "string",
|
||||
"enum": ["standard", "natural", "admin"]
|
||||
},
|
||||
"command": {
|
||||
"type": "string"
|
||||
},
|
||||
"args": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string"
|
||||
}
|
||||
},
|
||||
"confidence": {
|
||||
"type": "number",
|
||||
"minimum": 0,
|
||||
"maximum": 1
|
||||
}
|
||||
},
|
||||
"required": ["type", "command"]
|
||||
},
|
||||
|
||||
"project": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"type": {
|
||||
"type": "string",
|
||||
"enum": ["website", "application", "api", "tool", "other"]
|
||||
},
|
||||
"status": {
|
||||
"type": "string",
|
||||
"enum": ["planning", "active", "testing", "completed", "archived"]
|
||||
},
|
||||
"created": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
},
|
||||
"timeline": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"start": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
},
|
||||
"end": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
},
|
||||
"duration": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": ["id", "name", "type", "status"]
|
||||
},
|
||||
|
||||
"task": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"title": {
|
||||
"type": "string"
|
||||
},
|
||||
"description": {
|
||||
"type": "string"
|
||||
},
|
||||
"status": {
|
||||
"type": "string",
|
||||
"enum": ["todo", "in-progress", "testing", "done", "blocked"]
|
||||
},
|
||||
"priority": {
|
||||
"type": "string",
|
||||
"enum": ["P0", "P1", "P2", "P3"]
|
||||
},
|
||||
"assignee": {
|
||||
"type": "string"
|
||||
},
|
||||
"created": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
},
|
||||
"updated": {
|
||||
"type": "string",
|
||||
"format": "date-time"
|
||||
}
|
||||
},
|
||||
"required": ["id", "title", "status", "priority"]
|
||||
},
|
||||
|
||||
"agent": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"id": {
|
||||
"type": "string"
|
||||
},
|
||||
"name": {
|
||||
"type": "string"
|
||||
},
|
||||
"role": {
|
||||
"type": "string",
|
||||
"enum": ["pm", "fe", "be", "qa", "ui", "devops"]
|
||||
},
|
||||
"status": {
|
||||
"type": "string",
|
||||
"enum": ["stopped", "starting", "running", "busy", "error"]
|
||||
},
|
||||
"currentTask": {
|
||||
"type": "string"
|
||||
},
|
||||
"performance": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"tasksCompleted": {
|
||||
"type": "number"
|
||||
},
|
||||
"successRate": {
|
||||
"type": "number"
|
||||
},
|
||||
"avgTime": {
|
||||
"type": "number"
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"required": ["id", "name", "role", "status"]
|
||||
}
|
||||
},
|
||||
|
||||
"errors": {
|
||||
"400": {
|
||||
"code": "BAD_REQUEST",
|
||||
"message": "请求参数错误"
|
||||
},
|
||||
"401": {
|
||||
"code": "UNAUTHORIZED",
|
||||
"message": "未授权访问"
|
||||
},
|
||||
"404": {
|
||||
"code": "NOT_FOUND",
|
||||
"message": "资源不存在"
|
||||
},
|
||||
"409": {
|
||||
"code": "CONFLICT",
|
||||
"message": "资源冲突"
|
||||
},
|
||||
"500": {
|
||||
"code": "INTERNAL_ERROR",
|
||||
"message": "系统内部错误"
|
||||
}
|
||||
},
|
||||
|
||||
"security": {
|
||||
"authentication": "none",
|
||||
"authorization": "role-based",
|
||||
"rateLimit": {
|
||||
"requests": 100,
|
||||
"period": "minute"
|
||||
}
|
||||
},
|
||||
|
||||
"examples": {
|
||||
"createWebsite": {
|
||||
"request": {
|
||||
"endpoint": "/api/project/create",
|
||||
"method": "POST",
|
||||
"body": {
|
||||
"name": "企业官网",
|
||||
"type": "website",
|
||||
"requirements": "响应式设计,深色主题,包含公司介绍、产品展示、联系表单",
|
||||
"timeline": "2天"
|
||||
}
|
||||
},
|
||||
"response": {
|
||||
"id": "proj-20260331-001",
|
||||
"name": "企业官网",
|
||||
"status": "planning",
|
||||
"taskId": "task-20260331-001"
|
||||
}
|
||||
},
|
||||
|
||||
"parseCommand": {
|
||||
"request": {
|
||||
"endpoint": "/api/command/parse",
|
||||
"method": "POST",
|
||||
"body": {
|
||||
"input": "/网站 '测试页面' '今天'",
|
||||
"context": {
|
||||
"model": "deepseek-chat",
|
||||
"session": "current"
|
||||
}
|
||||
}
|
||||
},
|
||||
"response": {
|
||||
"type": "standard",
|
||||
"command": "website",
|
||||
"args": ["测试页面", "今天"],
|
||||
"confidence": 0.95
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
272
system-api/model-context.md
Normal file
272
system-api/model-context.md
Normal file
@@ -0,0 +1,272 @@
|
||||
# 多Agent系统 - 模型上下文文档
|
||||
|
||||
## 🎯 新模型必读
|
||||
|
||||
**无论你是新模型、切换过来的模型、还是失忆后恢复的模型:**
|
||||
1. 请仔细阅读本文档
|
||||
2. 按照"模型恢复步骤"操作
|
||||
3. 使用标准指令开始工作
|
||||
|
||||
---
|
||||
|
||||
## 📋 系统基本信息
|
||||
|
||||
| 项目 | 内容 |
|
||||
|------|------|
|
||||
| **公司名称** | 瑞来滋软件科技有限公司 |
|
||||
| **系统名称** | 多Agent协作系统 v2.0 |
|
||||
| **系统类型** | 基于OpenClaw的AI原生团队协作平台 |
|
||||
| **系统位置** | `D:\openclaw-multi-agent\` |
|
||||
| **员工规模** | 16人 |
|
||||
| **Agent数量** | 16个 |
|
||||
| **系统利用率** | 100% |
|
||||
|
||||
---
|
||||
|
||||
## 🔄 模型恢复步骤
|
||||
|
||||
### 失忆或切换后,按以下步骤恢复:
|
||||
|
||||
#### 步骤1:了解系统
|
||||
阅读 `system-api/model-context.md`(本文档)
|
||||
|
||||
#### 步骤2:检查状态
|
||||
运行 `/状态 系统` 或读取 `system-state.json`
|
||||
|
||||
#### 步骤3:查看项目
|
||||
运行 `/项目 列表` 查看现有项目
|
||||
|
||||
#### 步骤4:开始工作
|
||||
使用标准指令创建项目或继续工作
|
||||
|
||||
---
|
||||
|
||||
## 🏢 公司与团队
|
||||
|
||||
### 公司信息
|
||||
- **全称**: 瑞来滋软件科技有限公司
|
||||
- **英文**: Ruilizi Software Technology Co., Ltd.
|
||||
- **地址**: 北京市海淀区中关村科技园区
|
||||
- **行业**: 软件开发与技术咨询服务
|
||||
|
||||
### 组织架构 (16人)
|
||||
|
||||
#### 管理层 (4人)
|
||||
| ID | 花名 | 大名 | 职位 | 职责 |
|
||||
|----|------|------|------|------|
|
||||
| ceo | 张总 | 张伟明 | CEO | 战略决策 |
|
||||
| coo | 小王 | 王晓东 | COO | 运营管理 |
|
||||
| cpo | 产品总 | 王海涛 | CPO | 产品方向 |
|
||||
| cto | 老陈 | 陈志强 | CTO | 技术架构 |
|
||||
|
||||
#### 核心产品研发 (6人)
|
||||
| ID | 花名 | 大名 | 职位 | 职责 |
|
||||
|----|------|------|------|------|
|
||||
| pm | 小明 | 张明辉 | PM | 需求分析 |
|
||||
| frontend | 小华 | 李建华 | FE | 前端开发 |
|
||||
| backend | 小强 | 赵志强 | BE | 后端开发 |
|
||||
| qa | 小李 | 李晓龙 | QA | 测试 |
|
||||
| ui-design | 小美 | 陈美玲 | UI | 设计 |
|
||||
| devops | 老周 | 周建国 | DevOps | 运维 |
|
||||
|
||||
#### 商业化 (3人)
|
||||
| ID | 花名 | 大名 | 职位 | 职责 |
|
||||
|----|------|------|------|------|
|
||||
| sales | 小赵 | 赵俊杰 | Sales | 销售 |
|
||||
| marketing | 小陈 | 陈思远 | Marketing | 市场 |
|
||||
| customer-success | 小孙 | 孙伟强 | CS | 客服 |
|
||||
|
||||
#### 支撑保障 (3人)
|
||||
| ID | 花名 | 大名 | 职位 | 职责 |
|
||||
|----|------|------|------|------|
|
||||
| finance | 老吴 | 吴立军 | Finance | 财务 |
|
||||
| legal | 小钱 | 钱文波 | Legal | 法务 |
|
||||
| hr | 婷婷 | 刘婷婷 | HR | 人力 |
|
||||
|
||||
---
|
||||
|
||||
## ⚡ 标准指令集
|
||||
|
||||
### 基础指令(最常用)
|
||||
```
|
||||
/网站 [需求] [时间] # 创建网站项目
|
||||
/应用 [需求] [时间] # 创建应用项目
|
||||
/状态 系统 # 查看系统状态
|
||||
/项目 列表 # 列出所有项目
|
||||
/agent 列表 # 列出所有Agent
|
||||
```
|
||||
|
||||
### 高级指令
|
||||
```
|
||||
/任务 完整 # 完整项目模板
|
||||
/api [需求] [时间] # 创建API项目
|
||||
/紧急 [需求] [时间] # 紧急任务
|
||||
```
|
||||
|
||||
### 管理指令
|
||||
```
|
||||
/agent 启动 [角色] # 启动Agent
|
||||
/agent 停止 [角色] # 停止Agent
|
||||
/文件 查看 [路径] # 查看文件
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 关键文件
|
||||
|
||||
### 系统核心文件
|
||||
| 文件路径 | 作用 | 必读度 |
|
||||
|----------|------|--------|
|
||||
| `system-api/model-context.md` | 本文档,模型工作记忆 | ⭐⭐⭐ |
|
||||
| `system-api/system-state.json` | 实时系统状态 | ⭐⭐⭐ |
|
||||
| `system-api/api-spec.json` | API接口定义 | ⭐⭐ |
|
||||
| `README.md` | 系统总览 | ⭐⭐⭐ |
|
||||
|
||||
### 用户文档
|
||||
| 文件路径 | 作用 |
|
||||
|----------|------|
|
||||
| `快速指令卡.md` | 常用指令速查 |
|
||||
| `任务指令系统.md` | 完整指令文档 |
|
||||
| `公司介绍.md` | 公司和团队介绍 |
|
||||
| `AGENTS.md` | Agent配置说明 |
|
||||
|
||||
### 工具脚本
|
||||
| 文件路径 | 作用 |
|
||||
|----------|------|
|
||||
| `系统自检.bat` | 检查系统健康 |
|
||||
| `新模型初始化.bat` | 引导新模型 |
|
||||
| `查看指令.bat` | 交互式指令查看 |
|
||||
| `启动-全员.bat` | 启动所有Agent |
|
||||
|
||||
---
|
||||
|
||||
## 🔧 工作流程
|
||||
|
||||
### 标准项目流程
|
||||
```
|
||||
用户需求 → PM分析 → 创建任务 → FE/BE开发 → QA测试 → PM验收 → 交付
|
||||
```
|
||||
|
||||
### Agent协作模式
|
||||
1. **PM** 接收需求,创建规格说明书
|
||||
2. **FE/BE** 根据规格开发代码
|
||||
3. **QA** 执行测试,生成报告
|
||||
4. **UI/DevOps** 按需参与
|
||||
5. **管理层** 提供决策支持
|
||||
|
||||
---
|
||||
|
||||
## 💡 使用示例
|
||||
|
||||
### 创建网站项目
|
||||
```
|
||||
/网站 "企业官网,响应式设计" "2天"
|
||||
```
|
||||
|
||||
### 创建应用项目
|
||||
```
|
||||
/应用 "任务管理工具,支持团队协作" "3天"
|
||||
```
|
||||
|
||||
### 完整项目模板
|
||||
```
|
||||
/任务 完整
|
||||
项目: 在线教育平台
|
||||
需求: 课程展示、视频播放、用户注册、支付
|
||||
技术: React + Node.js + MongoDB
|
||||
设计: 教育风格,蓝色主题
|
||||
时间: 7天
|
||||
团队: PM,FE,BE,QA,UI,DevOps
|
||||
优先级: P1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 故障处理
|
||||
|
||||
### 问题:不知道系统是什么
|
||||
**解决**:阅读本文档 `model-context.md`
|
||||
|
||||
### 问题:不知道当前状态
|
||||
**解决**:运行 `/状态 系统` 或查看 `system-state.json`
|
||||
|
||||
### 问题:不知道用什么指令
|
||||
**解决**:阅读 `快速指令卡.md`
|
||||
|
||||
### 问题:Agent不响应
|
||||
**解决**:运行 `系统自检.bat` 检查健康状态
|
||||
|
||||
### 问题:找不到文件
|
||||
**解决**:运行 `/文件 列表 shared/`
|
||||
|
||||
---
|
||||
|
||||
## 🎯 核心原则
|
||||
|
||||
1. **不要依赖记忆** - 所有信息在系统文件中
|
||||
2. **使用标准指令** - 以 `/` 开头的指令
|
||||
3. **文档自描述** - 找不到就看文档
|
||||
4. **状态实时保存** - 模型切换不影响
|
||||
|
||||
---
|
||||
|
||||
## 📊 系统保证
|
||||
|
||||
- ✅ **模型无关** - 任何LLM都能使用
|
||||
- ✅ **状态持久** - 保存在文件中
|
||||
- ✅ **指令标准** - 相同指令相同结果
|
||||
- ✅ **文档完整** - 自描述系统
|
||||
- ✅ **切换无忧** - 随时切换,立即上手
|
||||
|
||||
---
|
||||
|
||||
## 🚀 快速开始
|
||||
|
||||
### 1. 查看系统状态
|
||||
```
|
||||
/状态 系统
|
||||
```
|
||||
|
||||
### 2. 查看Agent列表
|
||||
```
|
||||
/agent 列表
|
||||
```
|
||||
|
||||
### 3. 创建项目
|
||||
```
|
||||
/网站 "测试页面" "今天"
|
||||
```
|
||||
|
||||
### 4. 查看项目
|
||||
```
|
||||
/项目 列表
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 重要提醒
|
||||
|
||||
1. **所有系统状态都在文件中**
|
||||
2. **模型切换不影响任何数据**
|
||||
3. **使用标准指令确保一致性**
|
||||
4. **找不到就看文档**
|
||||
|
||||
---
|
||||
|
||||
## 📞 支持资源
|
||||
|
||||
- **内置帮助**: `/帮助 指令`
|
||||
- **系统文档**: `D:\openclaw-multi-agent\` 目录下所有 `.md` 文件
|
||||
- **工具脚本**: 目录下所有 `.bat` 文件
|
||||
|
||||
---
|
||||
|
||||
**系统位置**: `D:\openclaw-multi-agent\`
|
||||
**核心文件**: `system-api/` 目录
|
||||
**文档语言**: 中文为主
|
||||
**模型要求**: 任何大语言模型
|
||||
|
||||
---
|
||||
|
||||
*本文档由系统自动生成,确保模型切换后能立即正常工作*
|
||||
*版本: v2.0 | 更新时间: 2026-03-31*
|
||||
496
system-api/system-state.json
Normal file
496
system-api/system-state.json
Normal file
@@ -0,0 +1,496 @@
|
||||
{
|
||||
"$schema": "./api-spec.json",
|
||||
"version": "2.0",
|
||||
|
||||
"system": {
|
||||
"name": "瑞来滋软件科技有限公司 - 多Agent协作系统",
|
||||
"company": "瑞来滋软件科技有限公司",
|
||||
"companyFullName": "Ruilizi Software Technology Co., Ltd.",
|
||||
"description": "基于OpenClaw的AI原生团队协作系统,16个Agent各司其职完成软件开发",
|
||||
"location": "D:\\openclaw-multi-agent\\",
|
||||
"health": "healthy",
|
||||
"status": "running",
|
||||
"activeModels": ["deepseek-chat"],
|
||||
"modelContextVersion": "2.0",
|
||||
"created": "2026-03-31T14:25:00Z",
|
||||
"lastUpdated": "2026-03-31T23:38:00Z"
|
||||
},
|
||||
|
||||
"modelSwitchGuide": {
|
||||
"title": "模型切换恢复指南",
|
||||
"steps": [
|
||||
"1. 读取 system-api/model-context.md 了解系统",
|
||||
"2. 运行 /状态 系统 查看当前状态",
|
||||
"3. 运行 /项目 列表 查看现有项目",
|
||||
"4. 使用标准指令开始工作"
|
||||
],
|
||||
"importantFiles": [
|
||||
"system-api/model-context.md - 模型工作记忆",
|
||||
"system-api/system-state.json - 实时状态",
|
||||
"README.md - 系统总览",
|
||||
"快速指令卡.md - 常用指令"
|
||||
]
|
||||
},
|
||||
|
||||
"projects": {
|
||||
"total": 2,
|
||||
"completed": 1,
|
||||
"inProgress": 1,
|
||||
"list": [
|
||||
{
|
||||
"id": "proj-20260331-001",
|
||||
"name": "个人作品展示网站",
|
||||
"type": "website",
|
||||
"status": "completed",
|
||||
"created": "2026-03-31T21:51:00Z",
|
||||
"completed": "2026-03-31T21:56:00Z",
|
||||
"location": "shared/code/frontend/portfolio/",
|
||||
"quality": "excellent"
|
||||
},
|
||||
{
|
||||
"id": "proj-20260331-002",
|
||||
"name": "单页面招聘H5",
|
||||
"type": "website",
|
||||
"status": "inProgress",
|
||||
"created": "2026-03-31T23:51:00Z",
|
||||
"deadline": "今天完成",
|
||||
"location": "shared/tasks/TASK-招聘H5-001.md",
|
||||
"team": ["pm", "ui-design", "frontend", "qa", "hr"],
|
||||
"priority": "P0"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
"agents": {
|
||||
"total": 16,
|
||||
"configured": 16,
|
||||
"active": 16,
|
||||
"utilization": "100%",
|
||||
"lastStartup": "2026-03-31T23:25:00Z",
|
||||
|
||||
"management": [
|
||||
{
|
||||
"id": "ceo",
|
||||
"name": "张伟明",
|
||||
"花名": "张总",
|
||||
"role": "ceo",
|
||||
"position": "CEO 首席执行官",
|
||||
"department": "管理层",
|
||||
"email": "zhangweiming@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "公司战略规划,团队领导,资源整合"
|
||||
},
|
||||
{
|
||||
"id": "coo",
|
||||
"name": "王晓东",
|
||||
"花名": "小王",
|
||||
"role": "coo",
|
||||
"position": "COO 首席运营官",
|
||||
"department": "管理层",
|
||||
"email": "wangxiaodong@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "公司运营管理,流程优化,效率提升"
|
||||
},
|
||||
{
|
||||
"id": "cpo",
|
||||
"name": "王海涛",
|
||||
"花名": "产品总",
|
||||
"role": "cpo",
|
||||
"position": "CPO 产品负责人",
|
||||
"department": "管理层",
|
||||
"email": "wanghitao@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "产品战略规划,产品路线图,团队管理"
|
||||
},
|
||||
{
|
||||
"id": "cto",
|
||||
"name": "陈志强",
|
||||
"花名": "老陈",
|
||||
"role": "cto",
|
||||
"position": "CTO 技术负责人",
|
||||
"department": "管理层",
|
||||
"email": "chenzhiqiang@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "技术架构设计,技术选型,技术创新"
|
||||
}
|
||||
],
|
||||
|
||||
"core": [
|
||||
{
|
||||
"id": "pm",
|
||||
"name": "张明辉",
|
||||
"花名": "小明",
|
||||
"role": "pm",
|
||||
"position": "PM 产品经理",
|
||||
"department": "核心产品研发",
|
||||
"email": "zhangminghui@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "需求分析,产品规划,项目协调,验收测试"
|
||||
},
|
||||
{
|
||||
"id": "frontend",
|
||||
"name": "李建华",
|
||||
"花名": "小华",
|
||||
"role": "fe",
|
||||
"position": "FE 前端工程师",
|
||||
"department": "核心产品研发",
|
||||
"email": "lijianhua@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "页面开发,交互实现,响应式设计,性能优化"
|
||||
},
|
||||
{
|
||||
"id": "backend",
|
||||
"name": "赵志强",
|
||||
"花名": "小强",
|
||||
"role": "be",
|
||||
"position": "BE 后端工程师",
|
||||
"department": "核心产品研发",
|
||||
"email": "zhaozhiqiang@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "API开发,数据库设计,系统架构"
|
||||
},
|
||||
{
|
||||
"id": "qa",
|
||||
"name": "李晓龙",
|
||||
"花名": "小李",
|
||||
"role": "qa",
|
||||
"position": "QA 测试工程师",
|
||||
"department": "核心产品研发",
|
||||
"email": "lixiaolong@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "功能测试,性能测试,兼容性测试,质量保障"
|
||||
},
|
||||
{
|
||||
"id": "ui-design",
|
||||
"name": "陈美玲",
|
||||
"花名": "小美",
|
||||
"role": "ui",
|
||||
"position": "UI 设计师",
|
||||
"department": "核心产品研发",
|
||||
"email": "chenmeiling@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "界面设计,交互设计,用户体验优化"
|
||||
},
|
||||
{
|
||||
"id": "devops",
|
||||
"name": "周建国",
|
||||
"花名": "老周",
|
||||
"role": "devops",
|
||||
"position": "DevOps 运维工程师",
|
||||
"department": "核心产品研发",
|
||||
"email": "zhoujianguo@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "自动化运维,持续集成,监控报警"
|
||||
}
|
||||
],
|
||||
|
||||
"business": [
|
||||
{
|
||||
"id": "sales",
|
||||
"name": "赵俊杰",
|
||||
"花名": "小赵",
|
||||
"role": "sales",
|
||||
"position": "Sales 销售经理",
|
||||
"department": "商业化",
|
||||
"email": "zhaojunjie@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "客户开发,商务谈判,业绩达成"
|
||||
},
|
||||
{
|
||||
"id": "marketing",
|
||||
"name": "陈思远",
|
||||
"花名": "小陈",
|
||||
"role": "marketing",
|
||||
"position": "Marketing 市场专员",
|
||||
"department": "商业化",
|
||||
"email": "chensiyuan@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "市场推广,品牌宣传,活动策划"
|
||||
},
|
||||
{
|
||||
"id": "customer-success",
|
||||
"name": "孙伟强",
|
||||
"花名": "小孙",
|
||||
"role": "cs",
|
||||
"position": "CS 客户成功经理",
|
||||
"department": "商业化",
|
||||
"email": "sunweiqiang@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "客户服务,客户成功,用户留存"
|
||||
}
|
||||
],
|
||||
|
||||
"support": [
|
||||
{
|
||||
"id": "finance",
|
||||
"name": "吴立军",
|
||||
"花名": "老吴",
|
||||
"role": "finance",
|
||||
"position": "Finance 财务主管",
|
||||
"department": "支撑保障",
|
||||
"email": "wulijun@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "财务管理,成本控制,预算规划"
|
||||
},
|
||||
{
|
||||
"id": "legal",
|
||||
"name": "钱文波",
|
||||
"花名": "小钱",
|
||||
"role": "legal",
|
||||
"position": "Legal 法务顾问",
|
||||
"department": "支撑保障",
|
||||
"email": "qianwenbo@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "合同审核,风险控制,合规咨询"
|
||||
},
|
||||
{
|
||||
"id": "hr",
|
||||
"name": "刘婷婷",
|
||||
"花名": "婷婷",
|
||||
"role": "hr",
|
||||
"position": "HR 人力资源",
|
||||
"department": "支撑保障",
|
||||
"email": "liutingting@company.com",
|
||||
"status": "running",
|
||||
"responsibility": "招聘培训,薪酬福利,员工关系"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
"commands": {
|
||||
"basic": [
|
||||
{
|
||||
"command": "/网站",
|
||||
"description": "创建网站项目",
|
||||
"syntax": "/网站 [需求] [时间]",
|
||||
"example": "/网站 '企业官网' '2天'"
|
||||
},
|
||||
{
|
||||
"command": "/应用",
|
||||
"description": "创建应用项目",
|
||||
"syntax": "/应用 [需求] [时间]",
|
||||
"example": "/应用 '任务管理工具' '3天'"
|
||||
},
|
||||
{
|
||||
"command": "/状态",
|
||||
"description": "查看系统状态",
|
||||
"syntax": "/状态 [目标]",
|
||||
"example": "/状态 系统"
|
||||
},
|
||||
{
|
||||
"command": "/项目",
|
||||
"description": "项目管理",
|
||||
"syntax": "/项目 [操作] [参数]",
|
||||
"example": "/项目 列表"
|
||||
},
|
||||
{
|
||||
"command": "/agent",
|
||||
"description": "Agent管理",
|
||||
"syntax": "/agent [操作] [角色]",
|
||||
"example": "/agent 列表"
|
||||
}
|
||||
],
|
||||
"advanced": [
|
||||
{
|
||||
"command": "/任务",
|
||||
"description": "完整项目模板",
|
||||
"syntax": "/任务 完整"
|
||||
},
|
||||
{
|
||||
"command": "/api",
|
||||
"description": "创建API项目",
|
||||
"syntax": "/api [需求] [时间]"
|
||||
},
|
||||
{
|
||||
"command": "/紧急",
|
||||
"description": "紧急任务",
|
||||
"syntax": "/紧急 [需求] [时间]"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
"files": {
|
||||
"critical": [
|
||||
{
|
||||
"path": "system-api/model-context.md",
|
||||
"description": "模型工作记忆,新模型必读",
|
||||
"encoding": "UTF-8"
|
||||
},
|
||||
{
|
||||
"path": "system-api/system-state.json",
|
||||
"description": "实时系统状态",
|
||||
"encoding": "UTF-8"
|
||||
},
|
||||
{
|
||||
"path": "README.md",
|
||||
"description": "系统总览文档",
|
||||
"encoding": "UTF-8"
|
||||
},
|
||||
{
|
||||
"path": "AGENTS.md",
|
||||
"description": "Agent配置说明",
|
||||
"encoding": "UTF-8"
|
||||
}
|
||||
],
|
||||
"documents": [
|
||||
{
|
||||
"path": "快速指令卡.md",
|
||||
"description": "常用指令速查"
|
||||
},
|
||||
{
|
||||
"path": "任务指令系统.md",
|
||||
"description": "完整指令文档"
|
||||
},
|
||||
{
|
||||
"path": "公司介绍.md",
|
||||
"description": "公司和团队介绍"
|
||||
},
|
||||
{
|
||||
"path": "公司花名册.md",
|
||||
"description": "员工详细信息(GB2312编码)"
|
||||
}
|
||||
],
|
||||
"tools": [
|
||||
{
|
||||
"path": "系统自检.bat",
|
||||
"description": "检查系统健康状态"
|
||||
},
|
||||
{
|
||||
"path": "新模型初始化.bat",
|
||||
"description": "引导新模型初始化"
|
||||
},
|
||||
{
|
||||
"path": "查看指令.bat",
|
||||
"description": "交互式指令查看"
|
||||
},
|
||||
{
|
||||
"path": "启动-全员.bat",
|
||||
"description": "启动所有Agent"
|
||||
}
|
||||
],
|
||||
"project": [
|
||||
{
|
||||
"path": "shared/tasks/",
|
||||
"description": "任务记录目录"
|
||||
},
|
||||
{
|
||||
"path": "shared/specs/",
|
||||
"description": "需求规格目录"
|
||||
},
|
||||
{
|
||||
"path": "shared/code/",
|
||||
"description": "代码文件目录"
|
||||
},
|
||||
{
|
||||
"path": "shared/reports/",
|
||||
"description": "测试报告目录"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
"statistics": {
|
||||
"projects": {
|
||||
"total": 2,
|
||||
"completed": 1,
|
||||
"inProgress": 1,
|
||||
"successRate": "50%"
|
||||
},
|
||||
"tasks": {
|
||||
"total": 3,
|
||||
"completed": 2,
|
||||
"inProgress": 1,
|
||||
"avgCompletionTime": "5分钟"
|
||||
},
|
||||
"agents": {
|
||||
"total": 16,
|
||||
"configured": 16,
|
||||
"active": 16,
|
||||
"utilization": "100%"
|
||||
},
|
||||
"performance": {
|
||||
"avgProjectTime": "5分钟",
|
||||
"qualityScore": 98,
|
||||
"userSatisfaction": "high"
|
||||
}
|
||||
},
|
||||
|
||||
"history": {
|
||||
"events": [
|
||||
{
|
||||
"timestamp": "2026-03-31T14:25:00Z",
|
||||
"event": "system_created",
|
||||
"description": "多Agent系统创建"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-03-31T21:51:00Z",
|
||||
"event": "first_project_started",
|
||||
"description": "第一个项目:个人作品展示网站"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-03-31T21:56:00Z",
|
||||
"event": "first_project_completed",
|
||||
"description": "第一个项目成功完成"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-03-31T22:34:00Z",
|
||||
"event": "standard_interface_requested",
|
||||
"description": "用户请求开发标准接口系统"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-03-31T22:41:00Z",
|
||||
"event": "interface_development_started",
|
||||
"description": "开始开发模型无关接口系统"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-03-31T23:17:00Z",
|
||||
"event": "all_agents_configured",
|
||||
"description": "配置完整16人团队Agent"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-03-31T23:25:00Z",
|
||||
"event": "all_agents_started",
|
||||
"description": "启动全员16人Agent,利用率100%"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-03-31T23:32:00Z",
|
||||
"event": "company_info_updated",
|
||||
"description": "更新公司信息为瑞来滋软件科技有限公司"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-03-31T23:38:00Z",
|
||||
"event": "documentation_updated",
|
||||
"description": "更新核心文档,确保模型切换后正常使用"
|
||||
},
|
||||
{
|
||||
"timestamp": "2026-04-01T00:01:00Z",
|
||||
"event": "placeholder_development_approved",
|
||||
"description": "用户批准使用占位文本开始开发招聘H5"
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
"modelRecovery": {
|
||||
"description": "模型失忆或切换后恢复指南",
|
||||
"steps": [
|
||||
"1. 读取 system-api/model-context.md 了解系统",
|
||||
"2. 查看 system-state.json 获取当前状态",
|
||||
"3. 使用 /状态 系统 验证系统健康",
|
||||
"4. 使用 /项目 列表 查看现有项目",
|
||||
"5. 使用标准指令开始或继续工作"
|
||||
],
|
||||
"guarantees": [
|
||||
"所有系统状态实时保存在文件中",
|
||||
"模型切换不影响任何项目数据",
|
||||
"相同指令总是产生相同结果",
|
||||
"系统完全模型无关,任何LLM都能使用"
|
||||
]
|
||||
},
|
||||
|
||||
"metadata": {
|
||||
"generatedBy": "橙子助手 (OpenClaw)",
|
||||
"generatedAt": "2026-03-31T23:38:00Z",
|
||||
"schemaVersion": "2.0",
|
||||
"company": "瑞来滋软件科技有限公司",
|
||||
"system": "多Agent协作系统 v2.0"
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user