DeepSeek Harness 插件：dsh-default-overrides

前言¶

DeepSeek Harness（DSH）的设计理念是“一切皆插件”。核心预设（如 standard）提供了通用的基础能力，但在实际开发中，往往需要针对特定环境（如 Shell 通道、工具权限、人设）进行调整。dsh-default-overrides 插件允许你通过配置覆盖这些默认行为，而无需修改 DSH 的安装文件或预设源码。

插件概览¶

• 名称：dsh-default-overrides
• 一句话介绍：DeepSeek Harness（DSH）标准预设的可配置覆盖：Shell（Bash/PowerShell）通道、禁用行、人设和 Harness 身份。
• 类别：工作流
• 维护者：site-chenwei
• 许可证：MIT

安装与启用¶

安装后默认不改变现有行为，按需添加配置即可。

1. 安装插件。以下以 web profile 为例：

    dsh plugin --profile web add dsh-default-overrides

也可以在 DSH 插件管理器中安装。

2. 编辑目标 profile 的配置文件。以 web profile 为例：

    # 文件路径：~/.dsh/profiles/web/cordis.patch.yml
    - id: dsh-default-overrides
      config:
        # 在此添加具体配置项

核心功能¶

插件提供以下配置能力：

1. 配置 Shell 模式¶

支持 Bash 和 PowerShell，并支持持久化模式。
* 模式选择：
* bash / pwsh：每次新建 Shell，不保留目录、变量和函数。
* persistent-bash / persistent-pwsh：保留状态，适合连续执行。
* 路径配置：
* Windows：需显式填写 bashPath（如 Git Bash）或 pwshPath。
* macOS / Linux：通常使用系统默认路径。
* 限制：Windows 上本插件的 Bash 后端不接受 Cygwin 或 WSL / Linux 入口。

2. 设置助手人设¶

通过 persona 字段修改系统提示词，通过 personaPresets 指定生效的预设（默认为 standard）。

3. 禁用工具¶

通过 disabledTools 禁用 standard 预设中的特定工具（如 tool-web、tool-workflow）。

4. 调整上下文与压缩¶

• autoCompaction：关闭原生自动压缩，由用户手动控制上下文管理。
• includeHarnessIdentity / surfaceContext：隐藏框架身份提示或 Web 表层提示。

适用场景与注意事项¶

• 适用场景：需要持久化 Shell 环境进行开发、需要固定助手人设的工作流、需要精确控制上下文内容的场景。
• 注意事项：
  • 验收状态：Windows 实机与 ConPTY 验收尚未完成；PowerShell 真进程也尚未在此环境验收。
  • 默认行为：安装后默认不改变现有行为，需手动添加配置。
  • 插件限制：插件不限制安装版本，其他 DSH / Node 版本的兼容性需要实际确认。

结语¶

该插件通过配置覆盖解决了 DSH 标准预设的通用性与特定工作流需求之间的矛盾。更多细节与完整配置示例可参考：
* 插件目录页
* GitHub 仓库