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 文件。