AutoMD CLI

AutoMD 是面向 LAMMPS / 分子动力学工作的终端 AI 助手。npm 包内置默认 agents、skills、templates 和 knowledge，用户安装后只需要运行 automd，再按初始化向导填写模型 API Key。

安装

要求：Node.js >= 20.0.0。

npm install -g @luluyun/automd

如果系统把全局 npm 包安装到 /usr/lib/node_modules 或 /usr/local/lib/node_modules，普通用户可能没有写权限；这类系统级 Node 安装请使用：

sudo npm install -g @luluyun/automd

安装后直接运行：

automd

不需要安装 Bun，也不需要用户手动配置环境变量。

首次启动

在任意项目目录运行 automd。如果当前项目没有可用的 .angsheng/settings.json，AutoMD 会自动进入初始化向导：

1. 选择模型服务商。
2. 输入 API Key。
3. AutoMD 写入当前项目的 .angsheng/settings.json。
4. AutoMD 自动把 .angsheng/settings.json 加入当前项目 .gitignore。
5. 初始化完成后继续进入 AutoMD。

内置预设包括 MiniMax、DeepSeek、百炼、智谱和自定义兼容接口。初始化不会联网校验 key；如果 key、base URL 或模型名有误，会在首次模型调用时报错。

常用命令

automd
automd setup
automd lookup "LAMMPS units metal 的时间单位是什么？"
automd build "写一个金属体系拉伸的 LAMMPS 输入脚本"
automd execute --input in.lammps --workdir runs/test --dry-run

项目配置

• 配置文件保存在用户运行 automd 时所在项目的 .angsheng/settings.json。
• API Key 只写入项目配置文件，不要求用户设置 shell 环境变量。
• .angsheng/settings.json 会被自动加入 .gitignore。
• 用户项目里的 .angsheng/agents 和 .angsheng/skills 可以覆盖 npm 包内置的同名 agent / skill。
• npm 包内置 knowledge/ 是默认知识库；用户项目自己的 knowledge 可作为补充或覆盖来源。

安全提醒

不要把 .angsheng/settings.json 提交到 Git。这个文件包含模型服务商 API Key，AutoMD 初始化时会自动写入 .gitignore，但已有仓库仍建议在提交前确认一次。

故障排查

• Unsupported engine：请升级到 Node.js 20 或更高版本。
• EACCES：说明当前系统的全局 npm 安装目录没有写权限。如果全局目录在 /usr/lib/node_modules 或 /usr/local/lib/node_modules，请改用 sudo npm install -g @luluyun/automd。
• 模型调用失败：检查 .angsheng/settings.json 中的 key、base URL 和 model 是否正确。