本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-science

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-science

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• id: model-tier
• HOST 平面：挂在 profile bundle（cordis.patch.yml），非 agent preset；所有会话与子代理统一生效。
• 安全护栏：tiers 未配置 → 惰性 no-op；目标 provider 未注册 → 不路由；轻档失败自动回退原路由（辅助功能不挂）。
• 验证：node packages/dsh-model-tier/test/model-tier.test.mjs（路由决策矩阵单测，零依赖）+ bash packages/dsh-model-tier/scripts/test-model-tier.sh（E2E：轻档指向本地 mock LLM，断言标题请求真的被路由）。
• 主机 Details 文档：remote_host_notes 维护每台主机的备注（环境激活方式、分区/账号、约定），模型提交作业前会参考。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后 DSH 必须重启吗？

需要重启 profile（或刷新 Web GUI）才能让 cordis.patch.yml 里插入的 4 个 science 引擎行以及 model-tier 引擎生效；之后改 artifacts / 状态、跑作业都不需要再重启（远程主机设置页除外，见下条）。

远程主机设置页看不到怎么办？

设置 → 远程主机页对应 science-remote-hosts-ui 引擎，需要重启 profile 后才会出现；它的客户端 bundle 通过 package.json 的 dsh.client 注入 @deepseek-ai/dsh-client-ui-settings，宿主侧 REST API 路径是 /dsh-science/remote-hosts/*。

remote_run 提交后连接断开，作业会丢吗？

不会。工作站模式用 nohup + setsid 启动 detached 进程（断连不杀），SLURM 集群用 sbatch 提交；作业目录在主机的 scratch 下，状态由 remote_status 通过 ssh 重新探测并写回本地作业注册表，跨会话持续。

SSH 主机需要装什么额外软件吗？

不需要。引擎只依赖本机的 ssh/scp/sbatch/squeue 二进制（用 OpenSSH），主机侧零安装；但本机必须有 ~/.ssh/config 别名或 user@host 形式可用，且密钥已配好（推荐 ssh-agent + BatchMode=yes）。

怎么避免每次都弹审批？

首次在某项目使用某主机（注册/探测/exec/run）会弹一次授权审批，批准后该主机写入项目的 .dsh/remotes/allowlist.json（按项目隔离），同项目不再询问；之后每次 remote_run 仍默认弹"Run this job on ?"作业审批。CI/无人值守场景在 cordis.patch.yml 的引擎 config 里把 requireApproval 与 requireHostAccess 都设成 false。

research_ 工具什么时候该用？*

进入一个科研项目时先调 research_init（创建 research-manifest.json + 项目目录骨架），之后每轮迭代按 research_hypothesis → research_experiment → 研究代码 → research_findings 推进；research_state 任何会话开始先看一次可恢复上下文。

工件和实验日志有什么关系？

实验目录 experiments/E0X/{design.md,log.md,code/,results/} 记录一次实验的完整执行，artifact_save 则把"值得引用或复现"的结果归档到 artifacts//v/，每个版本带 SHA-256 校验与溯源（命令/输入/环境/envFile 哈希），可随时 artifact_verify 重算哈希校验。

卸载会影响现有项目数据吗？

引擎是只读地读写 research-manifest.json、artifacts/、.dsh/remotes/ 这些目录与文件；从 cordis.patch.yml 移除插件行并重启后，数据原样保留；想清理可用 dsh plugin remove + 手动删除项目目录。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=18
• Platforms: 跨平台
• Native modules: openssh-client (ssh/scp/sbatch/squeue 系统二进制，非 npm 原生模块)

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则