@lisp 扩展 - AutoLISP/Visual LISP 语言服务

📚 架构 · MCP 调试 · AI 模块 · 开发指南

为 AutoLISP / Visual LISP 提供完整的 VS Code 开发体验，支持 AutoCAD、ZWCAD、GStarCAD、BricsCAD 平台。集成代码编辑、智能补全、实时诊断、调试器、REPL、AI 辅助、包管理等全方位功能。

📦 安装

在 VS Code 扩展市场搜索 @lisp 或 atlisp-funlib 即可安装。

在 CAD 中安装 @lisp 函数库

将以下代码复制到 CAD 命令行，回车即可：

(progn(vl-load-com)(setq s strcat h "http" o(vlax-create-object (s"win"h".win"h"request.5.1"))v vlax-invoke e eval r read)(v o'open "get" (s h"://atlisp.""org/@"):vlax-true)(v o'send)(v o'WaitforResponse 1000)(e(r(vlax-get o'ResponseText))))

提示：用 Ctrl+C 复制，到 CAD 命令行 Ctrl+V 粘贴。

✨ 功能一览

📝 代码编辑与智能补全

AutoLISP 基本函数 - 悬停提示与自动补全
vla-get-* / vla-put-* / vla-* 系列属性和方法
vlr-* 反应器函数
@lisp 函数库 全部函数
系统变量 - 提示与补全
DXF 组码查询 - 输入 dxf+数字 或 dxf+图元名（如 dxfcircle）查看组码说明
用户自定义代码片段 - 灵活的自定义片段机制
DCL 控件与属性 - 完整补全

🔍 代码分析与诊断

括号匹配检查
setq 变量参数检查
defun 结构检查
函数参数个数校验
支持排除注释/字符串范围的静态分析
彩虹括号高亮

🎨 语义着色与主题

Atlisp Light / Dark 两套专业配色主题
基本函数、对象属性/方法、系统变量、只读变量、@lisp 函数分色显示

📐 代码格式化

AutoLISP 代码缩进格式化
DCL 代码缩进格式化
支持保存时自动格式化
可配置缩进宽度、括号样式、行长等

🐞 调试器

Attach（附加） - 附加到已运行的 CAD 进程
Launch（启动） - 自动启动 CAD 并加载代码
支持 AutoCAD 2021+ 和 浩辰CAD 2021+
支持断点调试

💻 REPL（交互式求值）

输入 Lisp 表达式立即求值显示结果
历史记录管理
内联求值（alt+shift+e）
宏展开（macroexpand / macroexpand1）
代码审查（inspect / inspectMacro）

🤖 AI 辅助（v1.8+）

多提供商支持：@lisp / Gemini / OpenAI / DeepSeek
AI 聊天（ctrl+shift+a）
从注释生成代码（ctrl+shift+g）
代码审查 / 代码解释
上下文感知的代码生成

🔌 MCP 调试（atlisp-mcp）

通过 MCP（Model Context Protocol）协议连接 CAD，在 VS Code 中直接与 CAD 交互调试。

前提条件： 安装 atlisp-mcp（npm install -g @atlisp/mcp），CAD 需已运行。

功能	说明	快捷键
MCP Debug 面板	左侧活动栏 → MCP Debug，查看连接状态、输入代码、查看结果	—
在 CAD 中求值	选中代码 → 右键 `Evaluate in CAD (MCP)` 或快捷键	`alt+shift+m+e`
加载文件到 CAD	当前 `.lsp` 文件通过 MCP 发送到 CAD 加载	`alt+shift+m+r`
检查变量/表达式	选中变量 → 右键 `Inspect in CAD (MCP)`	`alt+shift+m+i`
Code Lens 调试按钮	在 `defun` 上方显示 ▶ Debug in CAD / Debug with Breakpoints	—
断点调试	在编辑器行号左侧设断点，点击 "Debug with Breakpoints" 逐步执行	—
变量监视	面板 Watch 标签页添加变量名，自动在 CAD 中求值刷新	—
多会话管理	连接多个 CAD 实例，面板下拉框切换	—

工作流程：

在 MCP Debug 面板点击 Connect，连接到 CAD
在 .lsp 文件中选中代码，按 alt+shift+m+e 发送到 CAD 求值
结果在面板和输出通道中显示
面板内置代码预验证（括号匹配、setq 参数检查等），提前发现语法问题

配置项： | 设置 | 说明 | |------|------| | atlisp.mcp.command | MCP 服务器可执行文件路径（默认 atlisp-mcp） | | atlisp.mcp.args | 启动参数（默认 ["--stdio"]） |

技术细节：MCP 客户端从 ../kernel/tools/cli/atlisp/lib/mcp-client.js 移植，复用 JSON-RPC over stdio 通信模式。代码预验证参考 @atlisp/lint 的静态分析规则。

📂 @lisp 包管理

浏览 @lisp 注册表中的应用包
安装 / 卸载包
编译应用包（.lsp → .fas）
发布应用包到注册表

🔧 @lisp CLI 集成

安装 / 搜索 / 拉取包
诊断（doctor）
文档查询
项目初始化

🌐 简繁互转

支持 .lsp 和 .dcl 文件
全文转换或选中区域转换

📋 大纲与导航

函数定义与引用快速定位
文档符号 / 调用层次
定义跳转 / 引用查找

⚙️ 开发环境要求

项目	要求
VS Code	≥ 1.82.0
AutoCAD	≥ 2021（LISPSYS = 1 或 2）
文件编码	推荐 UTF-8（GB2312/ANSI 可能导致调试异常）

建议 LISPSYS = 2，编译的 .fas 可向下兼容低版本 CAD。

🔑 快捷键

快捷键	功能
`alt+shift+e`	内联求值
`alt+shift+c`	清除内联结果
`alt+shift+l`	加载文件到 CAD
`alt+shift+enter`	发送到 REPL
`alt+shift+up`	选择 S 表达式
`alt+shift+r`	REPL 历史
`alt+shift+i`	代码审查
`alt+shift+f`	自动修复
`ctrl+shift+a`	AI 聊天
`ctrl+shift+g`	从注释生成代码
`ctrl+shift+r`	生成代码片段

@lisp Application Development Assistant

VitalGG