配置参考

精选查阅用户与插件开发者最常用的 DeepSeek Harness 设置、凭据、环境变量、模型路由、沙箱模式与持久化配置

本页精选了用户与插件开发者最常查阅的配置项。完整且权威的来源是生成式的配置目录（英文源由系统生成，随附经评审的中文对侧文件），因此本页只是速查表，而非真源。每个条目都列出键、所在位置（环境变量、cordis.yml、设置文件或 CLI（命令行界面）flag），以及目录中记录的默认值；目录未列出默认值的必填键会相应标注。

设置与凭据

`settings.yaml` — `@deepseek-ai/dsh-settings-file`

用户设置文档。键 path（默认为 harness home 下的 settings.yaml）、dshHome（默认为 $DSH_HOME 或 ~/.dsh）、watch（默认为 true）、debounceMs（默认为 100）都写在插件 cordis.yml 的 config: 块里。见 CLI 与 Profile。

`.credentials.yaml` — `@deepseek-ai/dsh-credentials-local`

凭据引用文档，形状与设置相同：path（默认为 harness home 下的 .credentials.yaml）、dshHome（$DSH_HOME 或 ~/.dsh）、watch（true）、debounceMs（100）。不要把密钥写进 cordis.yml；见安全。

环境变量

变量	由谁设置 / 读取	用途
`DEEPSEEK_API_KEY`	`@deepseek-ai/dsh-llm-deepseek`（`apiKeyEnv`）、`@deepseek-ai/dsh-web-search-deepseek`	DeepSeek API 密钥，每次请求时解析。
`DEEPSEEK_BASE_URL`	`@deepseek-ai/dsh-llm-deepseek`（`baseURL` 回退）	端点基地址；缺失时回退到公共 API。
`DSH_HOME`	harness home 解析	harness home 目录；默认为 `~/.dsh`。
`DSH_AGENTS_HOME`	`@deepseek-ai/dsh-skill-filesystem`（`agentsHome`）	共享 agent（智能体）配置根目录；默认为 `~/.agents`。
`DSH_BUNDLED_SKILL_DIR`	`@deepseek-ai/dsh-skill-filesystem`（`bundledSkillDir`）	内置 skill（技能）根目录，包含默认根时挂载。
`E2B_API_KEY`	`@deepseek-ai/dsh-e2b`（`apiKey`）	E2B 沙箱 API 密钥；永不转发进沙箱。
`EXA_API_KEY`	`@deepseek-ai/dsh-web-search-exa`	Exa 搜索密钥；为空则提供方不可用。
`PERPLEXITY_API_KEY`	`@deepseek-ai/dsh-web-search-perplexity`	Perplexity 搜索密钥；为空则提供方不可用。
`DSH_WEB_URL`	由 `@deepseek-ai/dsh-web-app`（`surfaceContext`）暴露	携带 Web 界面 URL 的 bash 变量。
`DSH_CORDIS_CONFIG`	`@deepseek-ai/dsh-subagent-dsh-sdk`（`env`）	指定子运行时 `cordis.yml` 的路径。

模型与提供方路由

`@deepseek-ai/dsh-agent-default-model`

默认模型选择的组合条目。provider（已注册提供方路由）与 model（提供方拥有的模型 id）均为必填，目录未列出默认值。见配置模型。

`@deepseek-ai/dsh-llm-deepseek`

DeepSeek 直连提供方。apiKeyEnv 默认为 DEEPSEEK_API_KEY；baseURL 依次回退到 $DEEPSEEK_BASE_URL、公共 API；thinking 取 enabled/disabled；reasoningEffort 取 off/high/max（默认 high）；maxTokens 默认 256,000；defaultContextWindow 默认 1,000,000；models 为咨询性目录（默认 V4 Flash 与 V4 Pro）。同一形状也是 llm-deepseek 设置分区。见配置模型。

`@deepseek-ai/dsh-llm-pi-ai`

按 provider 键组织的自定义 OpenAI 兼容提供方路由。providers 的每个条目接受 apiKeyEnv、baseURL、api（协议格式，如 openai-completions）、models、modelOverrides、defaultContextWindow（默认 262,144）与 defaultMaxTokens（默认 32,768）。见配置模型。

权限 preset 与沙箱模式

`@deepseek-ai/dsh-permission-presets`

preset 表与组合默认值。presets 默认为 workspace-write（workspace-write + ask）与 danger-full-access（danger-full-access + never）；defaultPreset 选择新会话的起始 preset。custom 为保留名。见安全。

`@deepseek-ai/dsh-sandbox-policy`

部署共享的沙箱默认值。mode 默认为 read-only；workspaceRoot 默认为 process.cwd()，是无 agent 调用与无 cwd 会话的回退根。见安全。

`@deepseek-ai/dsh-user-approval`

默认批准策略。policy 取 ask（默认）或 never；never 对每次询问确定性拒绝，用于 CI 与无人值守运行。见安全。

Profile、preset 与 patch 层

`@deepseek-ai/dsh-agent-presets`

preset 的存放位置与默认项。default（必填——挂载时缺失会响亮失败）、roots（按优先级扫描的 preset 目录）与 includeUserRoot（追加 harness home 的用户 preset 目录）。见 Agent Preset 与 CLI 与 Profile。

`@deepseek-ai/dsh-cordis-host-runner`

动态 Cordis 插件背后的运行器。vmTimeoutMs 限制同步 VM 求值时间。见 Cordis 入门。

文件系统

`@deepseek-ai/dsh-fs-local`

本地文件系统后端。cwd 默认为 process.cwd()；diffBasisMaxBytes 限制覆盖 diff 的单侧字节数（默认 10 MiB）。workspace 根目录见 CLI 与 Profile。

Web UI

`@deepseek-ai/dsh-host-webserver`

网关的监听地址。host 取 127.0.0.1 或 0.0.0.0；port 为 0 时请求由操作系统分配端口。web profile 的 --host/--port flag 落到这里；默认在 http://127.0.0.1:3080 提供服务。见 CLI 与 Profile。

`@deepseek-ai/dsh-client-connection`

非回环的服务来源。trustedHosts 列出 /api 信任边界在回环之外接受的 host:port（或省略端口的 host）来源；maxRequestBodyBytes 限制每个 /api JSON 请求体。--trusted-host flag 会写入这些项。见 CLI 与 Profile。