用途:这是 earthtojake/text-to-cad 中维护的本地技能,用于在 CAD 插件安装或更新后,检查并解释 CAD 应用能否启动。CAD 的查看器是本地服务器,由 agent 应用通过 uvx 启动,并固定到某个 cadgen 发布版本;安装或更新后首次启动时该应用会从 PyPI 下载对应版本,因此首次启动需要网络连接。该技能只做检查与说明,不安装任何东西、不下载任何内容、不修改用户项目。
主要能力与使用方式:先用 uv --version 检查 uv 是否可用。若缺少 uv,应告知用户 CAD 需要它,并提供 uv 官方安装指南(https://docs.astral.sh/uv/getting-started/installation/)让用户自行安装。随后向用户说明 CAD 在其应用中的呈现:Codex 中需退出并重新打开 Codex,CAD 会出现在侧边栏以及每个线程的标签中;Claude Code 中插件随每个会话启动 CAD,可用 /mcp 查看是否连接,能显示应用视图时以查看器卡片展示模型,否则(如终端中)返回链接在浏览器 CAD Viewer 中打开;Claude Desktop 中插件无法直接接入,需按其配置(Settings > Developer > Edit Config)添加 CAD 服务器并重启,之后在聊天中以查看器卡片显示模型;其他支持 MCP Apps 的应用(VS Code、Cursor、Goose)在重启后也会在聊天中以查看器卡片显示模型。
限制与排错:安装 uv 后仍找不到 uv 或 uvx,说明应用读取的是登录 shell 的 PATH,需要在新 shell 中确认 uv --version 再重启应用;在 Claude Desktop 配置中也可使用 uvx 的完整路径(uvx)。安装或更新后的首次启动若无网络,固定运行时无法获取,需联网后重启一次应用。Claude Code 给服务器 30 秒启动时间,而首次启动要下载 CAD 库(解包后约 1 GB),网速慢时可用 MCP_TIMEOUT=300000 claude 启动一次以完成下载。插件更新后需重启应用,首次启动会拉取新的固定运行时,慢网下可能耗时数分钟;在 Codex 中,更新前已启动的线程会继续使用旧版本,直到重启。