@atlisp/agent

@lisp Agent — 多智能体 CAD 协作系统

基于 LangGraph 的多智能体（Multi-Agent）系统，为 @lisp CAD 环境提供 AI 驱动的自动化能力。

架构概览

CLI (index.js) ──── HTTP Server (server.js)
     │                       │
  TUI ──── ChatApp.jsx       │
     │                  AgentManager
     │                  ┌─────┼────┬─────┬─────┬─────┬─────┐
     │                  │     │    │     │     │     │     │
     │            lisp- cad-  draw- know- diag- code- test-
     │            engin. des.  anal. ledge nosis reviewer gener.
     │                  │     │    │     │     │     │
     │                  └── MCP Client ── CAD
     │                       │
                    LLM Provider ── OpenAI API

智能体（Agent）一览

Agent	命令	工作流
lisp-engineer	/code	需求→函数推荐→代码→安全检查→测试→修复→文档
cad-designer	/design	需求→连接CAD→环境设置→绘图→执行→验证→总结
drawing-analyst	/analyze	连接→提取数据→图片分析→分析→报告
knowledge-manager	/knowledge	对话整理→代码归集→技能提炼→报告
diagnostics	/diagnose	连接→环境检测→诊断→报告
code-reviewer	/review	静态检查→AI审查→CAD编译测试→报告
drawing-comparator	/compare	连接→数据提取→比对→差异报告
test-generator	atlisp-agent test-generate	代码解析→测试生成→执行验证

新增功能

函数库智能推荐

根据需求自动推荐相关 @lisp 函数，集成到 lisp-engineer 工作流中。

Code Interpreter

在 CAD 内安全执行生成的 AutoLISP 代码，包含：

• 危险函数检测（vl-file-delete, shell, command 等）
• 括号/引号匹配检查
• 超时控制（默认 30s）

多模态支持

• DWG 元数据提取（通过 MCP）
• 图片上传分析（Base64 编码后传给 LLM）

Agent 协作工作流

支持 YAML/JSON 格式定义多 Agent 编排：

workflow:
  name: "批量图纸审查"
  steps:
    - agent: drawing-analyst
      input: "分析 {file}"
      output_var: analysis
    - agent: code-reviewer
      input: "审查 {analysis.code}"

缓存与监控

• LLM 响应缓存（可配置 TTL）
• MCP 工具缓存 TTL 可配置
• 运行时监控模块（Agent 运行统计、Token 消耗）

快速开始

# 安装依赖
npm install
npm run build

# 首次运行：自动触发配置向导
node dist/index.js

# 或手动触发配置向导
node dist/index.js --setup

# CLI 交互模式（Ink TUI，自动调度）
node dist/index.js chat

# CLI 指定工作流（非交互式，直接输出结果）
node dist/index.js code "生成一个绘制矩形的 AutoLISP 命令"
node dist/index.js design "绘制一个 A3 图框"
node dist/index.js analyze "分析当前图纸"

# 函数推荐
node dist/index.js funlib recommend "创建图层"
node dist/index.js funlib search "layer"
node dist/index.js funlib categories

# HTTP 服务模式
node dist/server.js

TUI 界面

node dist/index.js chat 启动 Ink/React 终端 UI：

┌──────────────────────────────────────────────────────────────────┐
│  atlisp-agent  (自动调度模式)  https://atlisp.cn                │
│  ↑ N 条更早的消息 (PgUp翻页)                                      │
│  ┌─────────────────────────────────────────────┐│
│  │ [系统] atlisp-agent 已启动                    ││
│  │ [用户] 画一个五边形                           ││
│  │   🎨 ───                                    ││
│  │     状态: completed                          ││
│  │     摘要: ...                                ││
│  │   💻 ───                                    ││
│  │     状态: completed                          ││
│  │     代码:                                    ││
│  │       (defun c:pentagon () ...)  ← 语法着色  ││
│  └─────────────────────────────────────────────┘│
│  ↓ N 条更新的消息 (PgDn翻页)                      │
│  ───────────────────────────────────────────────│
│  > 画一个五边形▌  /code /design /clear          │
│  ───────────────────────────────────────────────│
│  Ctrl+C:退出  ↑↓:历史  PgUp,PgDn:翻页   MCP: 已连接 │
│  ←→:光标  Tab:补全  /clear                       │
└─────────────────────────────────────────────────┘

快捷键

按键	功能
↑ ↓	命令历史浏览
PgUp PgDn	日志区域翻页
← →	输入光标移动
Home End	光标到行首/行尾
Tab	命令自动补全
Ctrl+C	退出
鼠标滚轮	日志区域滚动

内置命令

命令	说明
/code <需求>	强制使用 lisp-engineer
/design <需求>	强制使用 cad-designer
/analyze <需求>	强制使用 drawing-analyst
/all <任务>	多团队协调（自动分解并发执行）
/knowledge <内容>	强制使用 knowledge-manager
/diagnose	运行环境诊断
/review <代码>	代码审查
/compare [请求]	图纸比对
/recommend <需求>	函数推荐
/funlib search <关键词>	搜索函数
/agents	列出所有可用 Agent
/tokens	查看 Token 用量
/history	历史会话
/clear	清屏
exit / quit	退出

特性

• AutoLISP 语法着色 — code 字段及 Markdown 代码块 (```lisp) 自动语法高亮
• 命令历史 — 最多 50 条，↑/↓ 切换
• 光标编辑 — ←/→/Home/End 移动，支持任意位置插入/删除
• 自动滚动 — 新消息自动跟随，翻页后暂停，PgDn 恢复
• 鼠标滚轮 — 支持 SGR 鼠标协议的终端可滚轮翻页
• MCP 状态栏 — 状态栏右侧实时显示 MCP 连接状态（已连接/连接失败/连接中...）
• MCP 连接重试 — 启动时连接失败自动指数退避重试（3次，1s/2s/4s），并在日志区显示连接状态
• HTTP 请求超时 — HTTP/Streamable-HTTP 模式默认 30s 超时，防止请求挂起

首次运行引导

首次运行时，系统会自动检测配置文件是否存在或 apiKey 是否为空，若检测到首次运行将自动触发配置向导：

node dist/index.js
# 或手动触发
node dist/index.js --setup

配置向导会询问以下内容：

项目	说明	默认值
LLM API Key	必填，大语言模型访问密钥	(无)
LLM Base URL	LLM API 端点地址	http://atlisp.org:11434/v1
LLM Model	使用的模型名称	minimax-m2.5:cloud
MCP 连接模式	CAD 通信协议	Windows: stdio / Linux: streamable-http
MCP URL	HTTP 模式端点地址	http://localhost:8110
MCP Command	stdio 模式命令	npx
MCP Args	stdio 模式参数	@atlisp/mcp --stdio

配置完成后会保存至 ~/.atlisp/atlisp.json。

配置

配置文件位于 ~/.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",
    "apiKey": "",
    "temperature": 0.1,
    "maxTokens": 65536
  },
  "mcp": {
    "mode": "stdio",
    "url": "http://localhost:8110",
    "command": "npx",
    "args": ["@atlisp/mcp", "--stdio"]
  }
}

环境变量

变量	说明	默认值
LLM_CACHE	启用 LLM 缓存	true
LLM_CACHE_TTL	LLM 缓存 TTL (ms)	3600000

HTTP API（server.js）

端点	方法	说明
/chat	POST	自动调度对话
/agent/lisp-engineer	POST	AutoLISP 代码生成
/agent/cad-designer	POST	CAD 设计绘图
/agent/drawing-analyst	POST	图纸分析
/agent/knowledge-manager	POST	知识管理
/agents	GET	列出所有 Agent
/health	GET	健康检查
/usage	GET	Token 用量统计
/mcp-status	GET	MCP 连接状态

项目结构

agent/
├── index.js                  # CLI 入口（commander）
├── server.js                 # HTTP 服务（Express）
├── config.js                 # 配置加载（JSON/YAML/.env）
├── llm.js                    # LLM 抽象层（支持缓存）
├── mcp-client.js             # MCP 客户端（stdio/http/streamable-http）
├── mcp-pool.js               # MCP 连接池
├── agent-manager.js          # 意图识别 & 智能体调度中心
├── workflow-engine.js        # 多 Agent 工作流引擎
├── monitor.js                # 运行时监控统计
├── funlib-cache.js           # @lisp 函数库缓存
├── agents/                   # 各智能体实现
│   ├── lisp-engineer/        #   代码生成团队
│   ├── cad-designer/         #   CAD 设计团队
│   ├── drawing-analyst/      #   图纸分析团队
│   ├── knowledge-manager/    #   知识管理团队
│   ├── diagnostics/          #   诊断团队
│   ├── code-reviewer/        #   代码审查团队
│   ├── drawing-comparator/   #   图纸比对团队
│   └── test-generator/       #   测试生成团队
├── ui/                       # TUI 界面组件（Ink + React）
│   ├── ChatApp.jsx           #   主界面组件
│   └── SyntaxHighlight.jsx   #   AutoLISP 语法着色器
├── tools/
│   ├── mcp-tools.js          #   MCP 工具封装（缓存可配置）
│   ├── lisp-utils.js         #   Lisp 语法检查/格式化工具
│   ├── funlib-recommender.js #   函数智能推荐
│   ├── code-interpreter.js   #   代码解释器（安全检查）
│   └── multimodal-processor.js # 多模态处理
├── providers/                # LLM 提供商
│   ├── openai.js
│   ├── deepseek.js
│   ├── anthropic.js
│   ├── ollama.js
│   ├── vllm.js
│   └── gemini.js
├── shared/
│   ├── prompt-templates.js   #   LLM 提示词模板
│   └── tool-descriptions.js  #   MCP 工具描述
├── test/
│   ├── agent-manager.test.js
│   ├── code-interpreter.test.js
│   └── workflow-engine.test.js
└── web/                      # Web UI
    ├── index.html
    ├── app.js
    └── style.css

技术栈

• 运行时: Node.js 18+
• TUI: Ink v7 + React 19
• AI 框架: LangGraph / LangChain (@langchain/langgraph, @langchain/core)
• LLM: 兼容 OpenAI API 协议的任意提供商
• CAD 通信: MCP（Model Context Protocol，通过 npx @atlisp/mcp）
• 构建: esbuild
• 测试: vitest

测试

npm test

许可

ISC