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

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，无外部依赖）

npx @toki0413/mcp-server        # stdio；SATURDAY_DISABLE 可排除插件
npx @toki0413/mcp-server --http # 或 SATURDAY_MCP_TRANSPORT=http：streamable-http 远程端点（默认 127.0.0.1:3000/mcp，/health 探活）

{
  "mcpServers": {
    "saturday-materials": {
      "command": "npx",
      "args": ["-y", "@toki0413/mcp-server"],
      "env": {
        "MP_API_KEY": "可选：Materials Project 远端结构解析需要"
      }
    }
  }
}

packages/
  kernel/                     # @toki0413/kernel —— 防腐层：全仓唯一接触 cordis 的文件
    src/cordis-adapter.mjs    #   SaturdayRuntime 接口 + append-only Trajectory
  core/                       # @toki0413/core —— 领域核心（零运行时依赖）
    src/material.mjs          #   Material 领域对象（谱系、视图、substitute 掺杂）
    src/potential.mjs         #   PotentialRegistry（引擎 seam + 评分路由 + 粒度门禁）
    src/structure-resolver.mjs#   结构解析 seam（原型库，含多晶型 + 7 种 fcc 金属）
    src/elements.mjs          #   元素表（Z/符号/电负性，化学式合成）
  python-bridge/              # @toki0413/python-bridge —— 通用 Python sidecar 客户端
    src/bridge.mjs            #   stdio JSON-lines，握手/超时/批量
    sidecar.py + adapters/    #   主 sidecar：按元素逐调用路由 ASE EMT / LJ 兜底
  contract-tests/             # @toki0413/contract-tests —— 契约测试套件（兼容性由测试承诺）
    src/index.mjs             #   structureResolver / potentialProvider / workflow / sampler / derivation
  bridge/                     # @toki0413/bridge —— dsh Bundle（saturday 主插件）
    src/saturday.plugin.mjs   #   cordis 插件入口 { name, apply }
    profiles/cordis.patch.yml #   挂载到 dsh profile 的示例
    docs/plugin-contract-v0.md#   Plugin Contract v0（插件契约，experimental）
plugins/                      # 插件生态（新插件必须过 contract-tests 套件）
  screening/                  #   @toki0413/plugin-screening —— 工作流：批量掺杂筛选
  mp-structure-source/        #   @toki0413/plugin-mp —— 结构源：Materials Project
  lammps/                     #   @toki0413/plugin-lammps —— 引擎：LAMMPS 批处理，粒度 job
  mace/                       #   @toki0413/plugin-mace —— 引擎：MACE ML 势，一次性/常驻 batch 双形态，可用性预检
  ase/                        #   @toki0413/plugin-ase —— 引擎：通用 ASE 计算器，自带 sidecar
  lennard-jones/              #   @toki0413/plugin-lj —— 引擎：零依赖纯 JS LJ（优雅回退数据面，指纹 lj-js）
  replay/                     #   @toki0413/plugin-replay —— 分析：Trajectory 回放与索引重建
  rss/                        #   @toki0413/plugin-rss —— 采样：RSS 随机结构搜索（§4.5 非 flow 生成式第二实证）
  neb/                        #   @toki0413/plugin-neb —— 分析：NEB 最小能量路径与势垒
  eos/                        #   @toki0413/plugin-eos —— 分析：Birch-Murnaghan 状态方程拟合
  phonon/                     #   @toki0413/plugin-phonon —— 分析：Γ 点声子（虚频与稳定性判定）
  elasticity/                 #   @toki0413/plugin-elasticity —— 分析：6×6 弹性张量 + Born 判据 + VRH
  sampler-perturb/            #   @toki0413/plugin-sampler-perturb —— 采样：参考结构微扰
  sampler-ou/                 #   @toki0413/plugin-sampler-ou —— 采样：OU 受控扩散 + 混合提案 + 锚点工具链
  sampler-flow/               #   @toki0413/plugin-sampler-flow —— 采样：仿射耦合流（可逆输运 + 换元精确似然）
  explore/                    #   @toki0413/plugin-explore —— 工作流：采样 → 回算闭环
  ergodic/                    #   @toki0413/plugin-ergodic —— 工作流：遍历对账
  free-energy/                #   @toki0413/plugin-free-energy —— 工作流：构型自由能曲线（热力学积分）
  derivation/                 #   @toki0413/plugin-derivation —— 活性上下文：失效传播与惰性重算

npm install             # workspaces：@deepseek-ai/cordis（peer）+ 全部 @toki0413/* 包软链
npm test                # 全部 workspace 测试
npm run summary         # 再生项目摘要（实跑全部包测试 + 提取契约实证表 → SUMMARY.md/.json）
node scripts/pack-check.mjs   # 发布形态核验（逐包 pack 干跑：版本一致 + files 白名单）

# 端到端演示（均无需 API Key，纯 Node 环境全部可跑：
# 无 Python 时数据面自动回退零依赖 lj-js 引擎，横幅如实呈报）
npm run demo --workspace @toki0413/bridge                    # 基础端到端
npm run demo:screening --workspace @toki0413/bridge          # 掺杂筛选（环境自适应：EMT 或 lj-js）
npm run demo:screening-ternary --workspace @toki0413/bridge  # 三元混掺筛选（多组分凸包判据）
npm run demo:concentrations --workspace @toki0413/bridge     # 多浓度/共掺扫描（非退化凸包包络）
npm run demo:freeenergy --workspace @toki0413/bridge         # 构型自由能曲线（恒温 Langevin MD + 谐波锚点）
npm run demo:cross-engine --workspace @toki0413/bridge       # 跨引擎对照（单位/指纹门禁）
npm run demo:availability --workspace @toki0413/bridge       # 引擎可用性预检
npm run demo:mixture-sampling --workspace @toki0413/bridge   # 多锚点混合采样（闭式似然重算 + 回算闭环）
npm run demo:anchor-guided --workspace @toki0413/bridge      # 锚点引导闭环（入库→检索→提案→回算→排序）
npm run demo:anchor-auto --workspace @toki0413/bridge        # 全自动锚点闭环（弛豫产物自动入库）
npm run demo:anchor-resume --workspace @toki0413/bridge      # 跨会话恢复（落盘→回填→续供，谱系不断）
npm run demo:rss --workspace @toki0413/bridge                # RSS 随机结构搜索 → 回算闭环（环境自适应）
npm run demo:agent --workspace @toki0413/bridge              # Agent 会话端到端（mock LLM，十个阶段）

npm i @deepseek-ai/dsh                 # 需要 Node ≥ 22
export DSH_HOME=~/.dsh
dsh web --help                         # 首次运行自动初始化 web profile
# 1) 在 $DSH_HOME/profiles/web/package.json 的 dependencies 声明：
#    "@toki0413/bridge": "file:/path/to/Saturday/packages/bridge"
# 2) cd $DSH_HOME/profiles/web && pnpm install
# 3) 把 packages/bridge/profiles/cordis.patch.yml 的 - insert: 行写入 profile 的 cordis.patch.yml
dsh --profile web --dump-config        # 验证组合树包含 saturday 行
dsh web                                # 启动

@misc{shi2026cordis,
  title         = {A Programming Paradigm for Spatiotemporal Composability},
  author        = {Shi, Yifan and Zhang, Wei and Cui, Tianyi},
  year          = {2026},
  eprint        = {2608.25512},
  archivePrefix = {arXiv},
  primaryClass  = {cs.PL},
  url           = {https://arxiv.org/abs/2608.25512}
}