配置与使用

配置从 profile 起步，每个 profile 对应 ~/.dsh/profiles 下一个目录；在 Web UI 的 Settings → Models 填模型 API Key、选工作区，再用 dsh --dump-config 核对组合结果。

本分类讲解 DeepSeek Harness Plugin（DSH plugin）的配置与使用：dsh --profile 的用法、用 --dump-config 查看组合配置树、在 Web UI 里设置模型与选择工作区、在 headless 模式下跑一次性任务。配置变化大多即时生效，改完即可验证；遇到问题可随时用 dsh --dump-config 检查当前组合。

DSH-Plugin 教程列表

全部9概念与架构1安装与快速上手3配置与使用1更新与升级1卸载与清理1故障排查1插件开发1
配置与使用2026-08-19

DSH 怎么配置和使用？配置文件、模型密钥与 profile 详解

DSHDeepSeek Harness配置profilecordis.patch.ymlAPI Key

DSH 的配置都落在 $DSH_HOME（默认 ~/.dsh）下：profile 目录里是插件依赖和 cordis.patch.yml，模型密钥在 Web UI 设置里填。本文讲清配置存在哪、怎么查看（dsh --dump-config）、怎么改，以及端口、工作区等常用用法。

DSH 配置与使用常见问题

DSH 的配置都存在哪里？

默认在 ~/.dsh 数据目录下：profile 各自在 ~/.dsh/profiles/<名字>，会话记录在 ~/.dsh/sessions。该目录由 $DSH_HOME 环境变量控制，路径以官方文档为准。

--profile 和 dsh web 有什么关系？

dsh 的启动参数写在最前面，--profile <名字> 指定工作区；dsh web 等价于 dsh --profile web，是官方提供的快捷写法。headless profile 则对应 --profile headless。

怎么查看 DSH 当前的完整配置？

运行 dsh --dump-config 查看 profile 组合后的配置树；想对比默认值可以看 dsh --dump-default-config。这两个命令只输出配置，不会修改任何东西。

在 Web UI 里怎么配置模型？

进入 设置（Settings）→ 模型（Models），填入 API Key 并选择模型，保存后即可在选择工作区后运行任务；自定义端点走 OpenAI 兼容配置，按官方文档填写。

改完配置需要重启 DSH 吗？

大部分配置（如模型路由）即时生效；涉及依赖或 profile 结构的变更，建议重启 dsh web 或重新运行命令，让环境重新加载。