前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。p-jiangh/dsh-enhance 是一个为 DSH 提供增强体验的工具包，它的定位类似于 oh-my-zsh 的主题扩展。它通过封装技能、注入工作规则、提供预设代理以及一系列辅助工具，帮助用户在 DSH 中快速建立一套标准的深度工作流。
核心能力¶
安装后，插件主要提供以下功能：
- 打包技能：内置
code-review、git-workflow和tdd等技能，通过/菜单直接调用。 - Work-rules 段：常驻系统提示词段，定义通用工作纪律。
- Doctor 工具：
dsh_enhance_doctor，用于诊断插件装配状态并给出建议。 - 人类指令：提供
/doctor（诊断）和/boulder（工作追踪状态）两个 UI 入口，结果仅渲染不消耗 token。 - 守卫 + Delivery-gate：包含
write-existing、path-traversal、bash-read等守卫，以及基于文件 manifest 的交付门卫。 - 工作追踪：结合 boulder 和写令牌，提供
start-work和 delivery-gate 钩子。 - Worktree 工具：提供
worktree_create/list/cleanup工具。 - Enhance 预设：一个名为
enhance的工作模式预设，包含深度工作协议（enhance-mode）段。 - Advisor：伴随审查运行的子代理，提供 nit/concern/blocker 等建议。
安装与启用¶
本插件以 Profile 为单位进行挂载。安装前请确保已安装 dsh CLI（npm 包 @deepseek-ai/dsh）。
- 确认你的 profile 名称。桌面端 GUI 使用
desktop，Loopback Web 使用web，无头模式使用headless。 - 执行安装命令：
dsh plugin --profile <your-profile> add https://github.com/P-JIANGH/dsh-enhance/releases/download/v0.1.2/p-jiangh-dsh-enhance-0.1.2.tgz
注意点：
* 包名是 @p-jiangh/dsh-enhance，不要写成裸名 dsh-enhance。
* 如果 profile 名称写错，命令会静默新建一个同名 profile，桌面端 GUI 可能看不到该插件。建议先确认已存在的 profile：ls $DSH_HOME/profiles。
* 桌面端的 profile 由应用独占管理，CLI 只能管理 web、headless 或自定义 profile。在桌面端 GUI 的插件面板安装即可。
典型用法¶
安装完成后，插件会自动加载。你可以通过以下方式使用：
- 使用技能：在输入框打
/，选择code-review、git-workflow或tdd。 - 执行诊断：在输入框打
/，选择/doctor。 - 启用增强模式：新建会话时，在预设菜单中选择 Enhance。该预设包含常驻的
enhance-mode段。
配置¶
插件支持在界面或 YAML 文件中进行配置。
- 界面配置：在侧边栏「插件」面板中找到
@p-jiangh/dsh-enhance，点击「配置」。可以调整workRules、doctorTool、guards、workTracking等开关，或修改advisorModel。 - YAML 配置：在 profile 的
cordis.patch.yml或$DSH_HOME/cordis.patch.yml中覆盖：
- id: dsh-enhance
name: '@p-jiangh/dsh-enhance'
config:
workRules: |
# 你的自定义规则
doctorTool: true
注意事项¶
- 预设固定：Enhance 预设是会话创建时固定的，无法在已有会话中切换。要使用该预设，必须新建会话。
- 兼容性：Enhance 预设需要
dsh >= 0.2.0，且仅在 Web 或桌面端界面可用。纯 headless / acp / sdk 环境下无法在预设菜单选择，但插件本体功能正常。 - 功能状态：Advisor 的目标回归功能尚未实现，当前仅作为伴随审查运行时存在。
总结¶
dsh-enhance 通过提供预设好的技能、工作流守卫和深度工作模式，降低了在 DSH 中搭建复杂工作流的门槛。它适合希望在对话中快速复用代码审查、Git 工作流或进行结构化深度工作的用户。
