Aone2233/dsh-router-sci

router-sci — 科研计算 Agent 预设

面向 核工程粉体 / 多相流仿真 的 DeepSeek Harness (dsh) agent preset。

在 router-standard 的渐进披露路由之上，替换 persona 为中文科研助手，
并把 WSL ↔ Windows 双环境工具路由、科研写作纪律、跨会话续接
写进系统提示，让 agent 在 LAMMPS / Fluent DPM / LaTeX 混合工作流里
按项目约定行事。

它解决什么问题

跑仿真研究时的典型摩擦：

- 环境分裂 — LAMMPS 和 Python 在 WSL，Fluent 在 Windows，agent 经常
在错误的一侧执行，或者用 9P 路径（\\wsl.localhost\...）跑重 IO 导致极慢
- 数值来源失守 — 颗粒物性（密度、弹性模量、表面能）被随手编造
- 写作纪律松散 — 报告结构每次都不一样，图表风格不统一
- 跨会话断片 — 新会话不知道上一轮做到哪、哪些是未决项

这个预设把上述约定固化成 persona，并配一套渐进披露的阶段机制。

核心内容

1. 双环境工具路由

LAMMPS / Python / LaTeX  →  WSL 侧（经 git bash 执行 wsl -d ）
Fluent                   →  Windows 侧（批跑脚本）
重 IO（dump / .trn）      →  必须在 WSL 原生目录内
9P 路径（UNC / 符号链接）  →  只做轻量读写与 dsh 交互

2. 领域背景注入

- 微观：LAMMPS 分子动力学模拟颗粒碰撞，恢复系数 e(v)，附着/反弹判据，
附着临界速度幂律模型 v_crit = A·d_p^B
- 宏观：Fluent DPM 气固两相流沉积，UDF 壁面边界条件，
P2P/P2W 恢复系数 profile
- 仿真-理论对照：物性参数只取文献或报告值，结论须相互印证

3. 科研写作纪律

报告七段结构（时间线 / 问题发现 / 参数空间 / 敏感性分析 / 物理机制 /
工程意义 / 后续计划），图表遵循统一出版风格（STIX 数学字体、300 dpi、11pt）。

4. 跨会话续接

开工前读 task_plan.md / findings.md / progress.md，完成后回写。

安装

前置

- DeepSeek Harness（dsh）
- 无需额外安装——本仓库自带全部 bootstrap 与执行器文件
（见下方「与上游的关系」）。它们直接以相对路径被 agent.cordis.yml 引用，
不经过 npm 安装。

步骤

1. 克隆
git clone https://github.com//dsh-router-sci.git
cd dsh-router-sci

2. 复制到 dsh 的 agent-presets 目录（dsh 只扫一级子目录）
Windows:
xcopy /E /I . "%USERPROFILE%\.dsh\.agent-presets\router-sci"
Linux / macOS / WSL:
cp -r . ~/.dsh/.agent-presets/router-sci

3. 填占位符（见下）
4. 生效（新会话挂载新一代）

必填占位符

本仓库的 agent.cordis.yml 是模板，persona 中的机器相关路径以占位符给出，
使用前请替换为你的真实环境：

| 占位符 | 含义 | 示例 |
|---|---|---|
|  | 项目名 | MyThesis |
|  | WSL 发行版名 | Ubuntu |
|  | WSL 侧项目根（绝对路径） | /home/you/MyThesis |
|  | Windows 侧符号链接路径 | C:\MyThesis |
|  | ANSYS 安装路径 | D:\ANSYS2024R2 |

{{model}} 与 {{cwd}} 由 dsh 运行时解析，保持原样不要替换。

与上游的关系

本预设构建在 dsh-routing-suite
的 router-standard 之上，沿用其渐进披露路由机制与 Git Bash shell seam。
下列文件来自该上游项目（MIT）：

gitbash-executor.mjs
router-bootstrap.mjs
router-bootstrap-v34.mjs
router-bootstrap-v34.selftest.mjs
router-core.mjs
router-core-v34.mjs

本仓库的原创部分为：

agent.cordis.yml   （persona、工具路由约定、科研写作纪律 —— 该文件整体
改编自 DeepSeek Harness Standard 预设的 composition，
其余插件行沿用上游；只有上述内容为原创）
preset.yml         （预设元数据）
README.md / NOTICE （文档与许可说明）

请注意 agent.cordis.yml 同时包含派生的插件行与原创的 persona，
两部分的归属不同，详见 NOTICE。

若上游发布新版本，可自行同步上述代码文件。

注意 router-core.mjs（无版本别名）与 router-core-v34.mjs（版本快照）
在本仓库中内容相同，且都包含上游 39ee0a0 引入的 sessionEvents 辅助。
但上游仓库自身的别名文件尚未跟进该修复（其 router-core.mjs 仍是旧版，
缺 sessionEvents），因此从上游同步时请以 -v34 快照为准，
不要用上游的别名覆盖本仓库的别名，以免两个 core 文件出现版本漂移。

自定义
要改 persona，直接编辑 agent.cordis.yml 里的 persona.config.prefix。
阶段划分与工具解锁顺序在 router-bootstrap.mjs 的 STAGES 常量中。

改完需要绕 ESM 缓存才能让新会话加载新代码：

递增 agent.cordis.yml 里 router-bootstrap-v34.mjs?v=N 的 N
然后对新会话生效

已知限制

- 技能目录不可见：router 系列预设把 skill 工具排除在工具面之外
（上游设计取舍：控制面工具会扰动推理轨迹）。本预设沿用该取舍，
因此 ~/.agents/skills 下的技能在会话中不可用。
- POSIX bash：agent.cordis.yml 已包含 tool-bash-posix 行以支持
在 Linux/macOS/WSL 侧直接运行 dsh；Windows 侧走 gitbash-shell 组。
- 依赖 dsh 版本：persona schema 随 dsh 演进（text → prefix）。
本仓库已适配 dsh 0.1.5-rc.1 的 @deepseek-ai/dsh-persona schema。

License

MIT — 见 LICENSE。
上游衍生内容的版权归原作者，见 NOTICE。