@atlisp/agent
v0.8.18
Published
Multi-Agent System for @lisp CAD operations
Maintainers
Readme
@lisp Agent v0.8.16 — 多智能体 CAD 协作系统
基于 LangGraph 的多智能体(Multi-Agent)系统,为 @lisp CAD 环境提供 AI 驱动的自动化能力。
架构概览
TUI/Web ──── HTTP/WS Server ──── AgentManager ──── 19 Agents
│ │
LLM Providers ──┬── MCP Pool ── CAD │
│ │
AgentOps Dashboard Orchestrator · Workflow Engine · Plugin Registry智能体(Agent)一览(19个)
| Agent | 命令 | 功能 |
|-------|------|------|
| lisp-engineer | /code | AutoLISP 代码生成、函数推荐、测试、修复 |
| cad-designer | /design | CAD 环境设置、绘图执行、验证 |
| drawing-analyst | /analyze | 图纸数据提取、图片分析、报告 |
| knowledge-manager | /knowledge | 对话整理、代码归集、技能提炼 |
| diagnostics | /diagnose | CAD 环境检测、MCP/LLM 连接诊断 |
| code-reviewer | /review | 静态检查、AI 审查、CAD 编译测试 |
| drawing-comparator | /compare | 图纸比对、差异报告 |
| test-generator | — | 代码解析、测试生成、执行验证 |
| lsp-project | — | 项目文件管理、依赖分析 |
| lsp-optimizer | — | 代码性能优化、重构建议 |
| pipeline | — | 多步骤管道编排、批处理 |
| trigger | — | CAD 变更监控、事件触发 |
| webhook | — | Webhook 注册管理、事件回调 |
| data-integration | — | CSV/JSON 数据导入、字段映射 |
| collaborative-cad | — | 多用户协作、变更同步 |
| cad-subscription | — | CAD 订阅管理、变更通知 |
| cad-recorder | — | 操作录制回放、教学演示 |
| bim-exporter | — | BIM 数据导出、IFC 转换 |
| cad-template-market | — | 模板搜索下载、市场管理 |
快速开始
npm install && npm run build
node dist/index.js # 首次运行自动配置向导
node dist/index.js chat # TUI 模式(自动调度)
node dist/index.js code "..." # 直呼特定 Agent
node dist/server.js # HTTP 服务(含 Web UI)
# Web UI 默认地址: http://localhost:3000
# AgentOps 仪表盘: http://localhost:3000/agentops
# 工作流编辑器: http://localhost:3000/workflow-editor
# 管理后台: http://localhost:3000/adminWeb UI
基于 WebSocket 的浏览器界面,无需终端:
功能:
- 实时对话、Agent 切换、消息队列
- DWG 预览(SVG 渲染)、导出
- MCP 工具面板(分类搜索、参数填写、执行)
- 知识库搜索、工作流列表、会话管理
- Token 用量统计、Agent 状态指示
- 多语言支持(中文/English)— 右上角切换
HTTP API
| 端点 | 方法 | 说明 |
|------|------|------|
| /chat | POST | 自动调度对话 |
| /agent/:type | POST | 指定 Agent 执行 |
| /agents | GET | 列出所有 Agent |
| /sessions | GET/DELETE | 会话管理 |
| /knowledge | GET | 知识库搜索 |
| /workflows | GET/POST | 工作流管理 |
| /workflows/:id/run | POST | 执行工作流 |
| /tools | GET | MCP 工具列表 |
| /usage | GET | Token/Agent 用量统计 |
| /health | GET | 健康检查 |
| /mcp-status | GET | MCP 连接状态 |
| /agentops/data | GET | AgentOps 仪表盘数据 |
| /api/v1/admin/* | — | 管理后台 API |
| /i18n/:lang.json | GET | 国际化翻译文件 |
| /batches | GET | 批量任务列表 |
| /admin | GET | 管理后台页面 |
| /workflow-editor | GET | 可视化工作流编辑器 |
| /agentops | GET | AgentOps 仪表盘页面 |
主要功能
AgentOps 仪表盘
GET /agentops — 实时监控所有 Agent / LLM / MCP 调用统计。
指标:调用次数、Token 消耗、成功率、延迟分布。
可视化工作流编辑器
/workflow-editor — 拖拽式多 Agent 工作流编排。
支持 YAML/JSON 定义、分支/循环/并行执行、手动/触发模式。
函数库智能推荐
根据自然语言需求自动推荐 @lisp 函数,集成到 lisp-engineer 工作流。
Code Interpreter
在 CAD 内安全执行 AutoLISP 代码:危险函数检测、括号/引号匹配、超时控制。
多模态支持
DWG 元数据提取(MCP)、图片上传分析(Base64 → LLM)。
插件与 Skill 系统
- Plugin Registry: 第三方插件搜索、安装、管理
- Skill Hub: 远程技能包搜索、安装、自动更新
结构化错误处理
AppError基类 →McpError/LlmApiError/AgentError/ConfigError/SessionError- 自动错误分类、
isRetryableError()判断是否可重试
国际化
/i18n/:lang.json — 支持 zh-CN / en-US,Web UI 右上角一键切换。
后端 API src/i18n/ 提供 t() / tn() 翻译函数。
测试框架
- Agent 测试台(输入/输出断言、模拟 LLM/MCP)
- CI/CD 自动化测试 (
npm test)
配置
~/.atlisp/atlisp.json(自动生成),支持 JSON / YAML / .env 覆盖:
{
"agent": { "verbose": false, "maxIterations": 5 },
"llm": {
"provider": "openai",
"baseURL": "http://atlisp.org:11434/v1",
"model": "minimax-m2.5:cloud",
"temperature": 0.1,
"maxTokens": 65536
},
"mcp": {
"mode": "stdio",
"url": "http://localhost:8110",
"command": "npx",
"args": ["@atlisp/mcp", "--stdio"]
},
"i18n": { "language": "zh-CN" },
"agentops": { "enabled": true }
}| 环境变量 | 说明 | 默认值 |
|----------|------|--------|
| LLM_CACHE | 启用 LLM 响应缓存 | true |
| LLM_CACHE_TTL | 缓存 TTL (ms) | 3600000 |
| AGENTOPS_ENABLED | 启用 AgentOps 仪表盘 | true |
项目结构
src/
├── server.js # HTTP 服务(Express + WebSocket)
├── agent-manager.js # Agent 调度中心
├── llm.js # LLM 抽象层(缓存、重试)
├── mcp-client.js / mcp-pool.js # MCP 连接管理
├── config.js # 配置加载
├── errors.js # 结构化错误类(AppError 等)
├── i18n/ # 国际化(zh-CN / en-US)
├── agentops/ # AgentOps 遥测(collector + dashboard)
│ ├── collector.js # 数据采集器
│ └── dashboard.js # HTTP API + HTML 仪表盘
├── agents/ # 19 个智能体实现
├── routes/ # API 路由
├── tools/ # MCP 工具、函数推荐、代码解释器
├── providers/ # LLM 提供商(openai/deepseek/anthropic/...)
├── shared/ # 提示词模板、工具描述
├── registry/ # 插件注册表、安装器
├── agents/ # Skill / Plugin 系统
├── test/ # 测试台 + CI
└── web/ # Web UI(HTML/JS/CSS)
├── index.html / app.js / style.css
├── agentops.html / admin.html / workflow-editor.html
└── i18n.js # 浏览器端 i18n 加载器技术栈
- 运行时: Node.js 18+
- TUI: Ink v7 + React 19
- Web: 原生 HTML/JS/CSS + WebSocket
- AI: LangGraph / LangChain
- LLM: OpenAI / DeepSeek / Anthropic / Ollama / vLLM / Gemini
- CAD 通信: MCP (
npx @atlisp/mcp) - 构建: esbuild
- 测试: vitest
许可
ISC
