dsh-saturdayCAUTION

[](https://github.com/toki0413/dsh-saturday/actions/workflows/ci.yml) [](https://smithery.ai/servers/toki0413/saturday-materials)

简体中文 | English

Everything is a plugin。 Saturday 不是又一套材料计算引擎,不替代 DFT / MD / FEM / CFD 的任何求解器; 它是材料计算的组合层:引擎、结构源、工作流、分析工具全部以插件形态挂载到 DeepSeek Harness (dsh) / `@deepseek-ai/cordis` v4 运行时上,由 Agent 在运行时自由挂载、卸载与组合。

插件接口规范见 packages/bridge/docs/plugin-contract-v0.md(中文原本,英文摘要版同目录)。

60 秒上手

不需要 Python、不需要装任何求解器——有 Node ≥ 22 就能让 Agent 拿到真实的材料回算数值 (无 ASE 时自动走零依赖 lj-js 引擎;能量由引擎回算,非玩具占位假数)。

最快一行(连客户端都不配):npx -y @toki0413/mcp-server --relax Cu 直接打印 Cu 的每原子能量与所用引擎(装了 MACE/ASE 会自动升真物理)。

免装 Node/Python(全保真容器):docker run --rm ghcr.io/toki0413/saturday --relax Cu 一行拿 EMT 真值,镜像已内含 Node + Python + ASE(构建/推镜像由 GitHub Actions + GHCR 承担,本地不装工具链)。当前状态:镜像构建与容器内冒烟已在 CI 跑通,但 GHCR 推送只在打 v* tag 时发生,因此该命令自 v0.3.14 起可拉;现在就要零安装跑用上面那行 npx。

路径 A:接进任意 MCP 客户端(Claude Desktop / Cursor / Cherry Studio 等)——在客户端配置里加:

{
"mcpServers": {
"saturday-materials": { "command": "npx", "args": ["-y", "@toki0413/mcp-server"] }
}
}

存盘重启客户端,对它说一句“把 Cu 弛豫一下并给出每原子能量”,它会调 potential.relax 返回 energyPerAtom(eV);material.load / workflow.screen(掺杂筛选)/ analysis.phonon(声子) 等 56 个工具都在。想要真实 EMT/LAMMPS 物理,再装 Python≥3.10 + ASE(见下“环境矩阵”), 引擎按能力自动升级,插件面契约与单位/指纹门禁不变。

路径 B:本地跑起来看全链

git clone https://github.com/toki0413/dsh-saturday && cd dsh-saturday
npm install && npm test        # 全量回归(纯 Node 即可)
npm run demo                   # 一条十阶段端到端:加载→采样→筛选→声子→回算,环境自适应
npm run demo:agent             # 一个 prompt 驱动整个发现链(mock LLM,无外部依赖)

想知道“我该调哪个工具”→ 见 docs/recipes.md(按意图找工具与参数); 5 分钟上手与拒绝伪造证据的演示 → docs/agent-e2e-demo.md。

核心范式

时空可组合性(