MCP

ArchLang 平面图 DSL 与编译器：适合谁、3 分钟首用与使用边界

ArchLang 最适合把平面图写成 .arch 源码（可交给 AI agent 代写）并编译成 SVG/DXF/PDF，配合 lint 与几何校验；前提是本机能以 npx 运行 @chanmeng666/archlang，首次可先用 context 子命令一次取回整套语言说明，而 compile 会在本地写出产物文件。

官方来源 · ArchLang

安装

npx -y skills add ChanMeng666/archlang --yes

适合谁

  • 最适合两类人：一是想让智能体代写平面图源码、再编译成图的人，官方定位就是「写 .arch 源码，或让 AI agent 代写」；二是需要快速拿到 SVG、DXF 或 PDF 格式平面图，并用 lint 与几何校验给源码把关的人。
  • 也适合把图纸检查放进脚本的人：describe 与 validate 都支持 --json 输出，便于程序化地判断源码状态。
  • 它把平面图当作代码来维护：源文件是纯文本，布局描述可复现、可对比，也方便交给智能体修改；编译产物则是矢量或文档格式的图纸文件。
  • 使用前提：官方命令全部通过 npx 运行 npm 包，本机要能执行 npx；主安装路径面向 coding agent 的 skills，不接入 MCP 客户端也能直接在终端运行命令行子命令。
  • 不适合与未知：证据里没有可视化编辑、拖拽作图的能力，想所见即所得画图的人不适合；.arch 的语法样例未出现在证据里，第一份源文件要自己写或交给智能体写；正式工程图纸的精度与规范符合性、支持的操作系统与许可证，证据均未说明。

3 分钟完成第一次尝试

主路径只有一条：skills 安装，四步走完。

  1. 前提：终端可用 npx；官方命令本身不含密钥或账号参数，不必先准备凭证。是否还需要其他环境配置，证据未说明。
  2. 安装：执行 npx -y skills add ChanMeng666/archlang --yes，把本仓库的 skills 装给你的 coding agent。
  3. 低成本首试：运行 npx -y @chanmeng666/archlang context。官方对它的定位是「一次调用给出整套 ArchLang 语言」，智能体不必预先加载语言知识。成功信号：终端打印出语言说明。该命令是否访问网络及其他读写细节，证据未说明。
  4. 拿到第一个产物：准备一份 plan.arch 后运行 npx -y @chanmeng666/archlang compile plan.arch -o plan.svg --json，成功信号是本地生成 plan.svg，并输出 JSON 状态。注意 compile 会写本地文件，属于本地写入、不是只读操作，建议放在确认源文件内容之后。

次要说明（另一条官方路径，不与主路径并列）：MCP 客户端可执行 claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp，以 npx 启动独立的 npm 包 @chanmeng666/archlang-mcp，注册名为 archlang 的服务器；该服务器注册后暴露哪些 MCP 工具，证据未说明。

使用案例

案例一：先查再编。场景：手头已有 plan.arch，想在出图前确认内容可靠。做法：先运行 describe plan.arch --json 查看结构描述，再运行 validate plan.arch --strict --json 做严格校验，两者与 compile 是同一命令前缀；按校验结果修正源码后重新编译，官方给出的工作流正是修复后重编。可期待的结果：JSON 格式的描述与校验结果，几何问题在编译成图之前暴露。两条命令都带 --json，适合接进脚本作为编译前的前置检查；校验输出的具体字段结构，证据未给出。

案例二：让智能体代写图纸。场景：不熟悉 .arch 语法，想把源码交给智能体完成。做法：先运行 npx -y @chanmeng666/archlang context，把整套语言一次性交给智能体，官方明确说明这样无需预载语言知识；再让智能体产出 .arch 源码，最后用 compile 命令编译出图。源码由智能体产出，编译与校验仍由本地命令完成。可期待的结果：拿到源码与第一张 plan.svg。项目定位支持输出 SVG、DXF 或 PDF，但逐字可复制的编译命令证据只有 SVG 一例，DXF 与 PDF 的确切输出参数未确认，不要自行类推。

使用边界

  • 读写性质：compile 读取 plan.arch、按 -o 在本地写出 plan.svg，是明确的本地写；describe、validate、context 未被官方标注为只读工具，context 仅被描述为输出语言说明，其余读写细节证据未说明。
  • 凭证与配置：上述官方命令均未包含密钥、令牌等凭证参数，也没有出现姓名、邮箱之类的必填信息；是否存在额外的环境配置要求，证据未说明。
  • 路径区分：本文的首次尝试基于命令行子命令与 skills 安装；若目标是让 MCP 客户端里的智能体调用，需另行执行注册命令，两条路径安装的内容与前提不同。
  • 副作用与确认点：compile 会写本地文件，运行前确认输出路径；官方未提供撤销路径说明，因此不应把它称作「可撤销」。skills 安装具体写入哪些位置，证据未说明。
  • 两个制品彼此独立：skills 安装面向智能体的技能包；claude mcp add 注册的是另一个 npm 包。两者关系、能否只装其一，证据未说明。
  • 许可证、支持平台、网络行为与数据边界未在证据中出现；「未找到说明」不等于没有风险，本文不作独立安全结论。