dsh-router-sci：面向核工程粉体/多相流仿真的 DeepSeek Harness Agent 预设

DeepSeek Harness (DSH) 生态推崇“一切皆插件”的理念。在处理核工程粉体或多相流仿真这类混合工作流时，开发者常面临环境分裂（WSL 与 Windows 路径混淆）、数值来源失守、写作纪律松散以及跨会话断片等问题。dsh-router-sci 是一个针对上述场景定制的 agent 预设，它将环境路由规则、科研写作纪律与跨会话续接机制固化为系统提示，旨在让 agent 在 LAMMPS / Fluent DPM / LaTeX 混合流程中严格按项目约定行事。

核心能力¶

该预设构建在 dsh-routing-suite 的 router-standard 之上，主要包含以下四个核心模块：

双环境工具路由¶

预设定义了明确的工具分流逻辑，避免 agent 在错误的环境侧执行操作或使用低效的 9P 路径（UNC 路径）进行重 IO 操作。

WSL 侧：处理 LAMMPS 分子动力学模拟、Python 脚本运行及 LaTeX 编译。执行时通过 git bash 调用 wsl -d <DISTRO>。
Windows 侧：处理 Fluent 批处理脚本。
重 IO 文件：dump 文件、.trn 文件等必须读写 WSL 原生目录内的文件。
轻量交互：9P 路径（UNC / 符号链接）仅用于 dsh 与环境的轻量级交互。

领域背景注入¶

预设通过 persona.config.prefix 注入了核工程粉体与多相流仿真的领域知识，要求 agent 在处理参数时遵循物理规律：

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

科研写作纪律¶

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

跨会话续接¶

通过规范化的文件命名，实现 agent 在不同会话间的状态同步。开工前需读取 task_plan.md、findings.md 和 progress.md，完成后回写更新。

安装与启用¶

本插件为纯文件分发，无需通过 npm 安装。安装步骤如下：

前置条件¶

已安装 DeepSeek Harness (dsh)，版本需满足 0.1.5-rc.1。
dsh 仅扫描 .dsh/.agent-presets 目录下的一级子目录，因此安装目录必须命名为 router-sci。

安装步骤¶

# 1. 克隆仓库
git clone https://github.com/<你的账号>/dsh-router-sci.git
cd dsh-router-sci

# 2. 复制到 dsh 的 agent-presets 目录
# 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 是一个模板文件，包含机器相关的路径占位符。使用前必须替换为你的真实环境路径。

占位符	含义	示例
`<PROJECT_NAME>`	项目名	`MyThesis`
`<WSL_DISTRO>`	WSL 发行版名	`Ubuntu`
`<WSL_PROJECT_ROOT>`	WSL 侧项目根目录（绝对路径）	`/home/you/MyThesis`
`<WIN_PROJECT_LINK>`	Windows 侧符号链接路径	`C:\MyThesis`
`<ANSYS_INSTALL>`	ANSYS 安装路径	`D:\ANSYS2024R2`

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

自定义与维护¶

自定义 Persona¶

若需调整 agent 的行为或写作风格，直接编辑 agent.cordis.yml 文件中的 persona.config.prefix 字段即可。阶段划分与工具解锁顺序定义在 router-bootstrap.mjs 的 STAGES 常量中。

版本更新与缓存¶

dsh 使用 ESM 模块缓存机制。修改代码后，新会话可能无法加载最新逻辑。需在 agent.cordis.yml 中递增 router-bootstrap-v34.mjs?v=N 中的版本号 N，重启会话即可生效。

与上游的关系¶

本插件依赖上游项目 dsh-routing-suite 的部分核心文件（如 router-core.mjs、gitbash-executor.mjs 等）。这些文件通过相对路径引用，不经过 npm 安装。若上游发布更新，请参照 NOTICE 文件处理版本漂移问题。

已知限制¶

技能目录不可见：router 系列预设的设计取舍是排除 skill 工具（控制面工具），以避免扰动推理轨迹。因此，~/.agents/skills 下的技能在会话中不可用。
POSIX Bash 支持：agent.cordis.yml 已包含 tool-bash-posix 行，支持在 Linux/macOS/WSL 侧直接运行。Windows 侧需通过 gitbash-shell 组。
版本依赖：本预设适配 dsh 0.1.5-rc.1 的 schema。若 dsh 版本过低或过高，可能导致 persona 加载失败。

License¶

MIT License。见 LICENSE 文件。