前言¶
DeepSeek Harness (DSH) 的插件生态支持针对特定场景的深度定制。在构建智能体应用时,任务级的中断、网络抖动或常规的低风险问题往往需要人工介入,这会显著增加维护成本。dsh-continue 是一个 DeepSeek Harness 插件,专注于解决任务级别的恢复和安全无人值守继续的问题。它结合了确定性恢复、精确的自适应网络学习,以及任务范围配置注入,旨在让常规的低风险问题无需人工实时监控。
插件定位¶
dsh-continue 是 DeepSeek Harness 的一个可选插件,由 JuwanXu 维护,采用 MIT 许可证。
它解决的核心问题是:在模型重试和基础网络恢复之后,如何进行安全、确定性的任务继续。它不替代通用的模型错误重试,而是作为任务层级的继续层,处理网络故障后的决策、推荐选项的确认以及 Plan Mode 的自动退出。
核心能力¶
该插件提供以下经过核实的功能:
- 安全无人值守继续:提供安全的任务继续机制,确保在无人值守状态下不会执行特权或不可逆的操作。
- 确定性恢复:在下游重试之后提供确定性的网络恢复策略。
- 精确自适应学习:支持基于 provider(提供商)、model(模型)和 error-code(错误码)的精确网络故障学习。
- 任务范围配置注入:支持为单个任务注入隔离的策略配置,配置会覆盖全局默认值。
- 窄范围自动化:将自动化限制在特定场景,包括唯一推荐答案的选择、二进制继续提示、有效的 Plan Mode 退出以及纯文本继续。
- 控制与记忆:支持暂停/恢复控制、持久化活动和学习事件、项目范围的决策记忆(支持任务范围回退)以及可验证的手动决策来源。
- 安全边界:配置可重试预算,并设置 fail-closed(失败-关闭)的安全边界。
- 仅建议模式:继续候选仅作为建议提供,不直接执行。
安装与启用¶
安装插件不会自动改变任何任务交互、重试、学习或审批行为。所有可执行功能默认为关闭状态。安装后需要通过配置或命令手动启用。
安装命令如下:
dsh plugin --profile <profile-name> add dsh-continue
安装后,需要在配置文件中开启相应的功能模块,或通过任务命令进行即时覆盖。
典型用法¶
使用预设¶
插件提供三种预设配置,用于快速启用一组功能:
/continue preset recommended
/continue preset resilient
/continue preset unattended-safe
| 预设名称 | 启用的功能 |
|---|---|
recommended |
启用唯一推荐答案的选择 |
resilient |
启用临时网络恢复和推荐答案选择 |
unattended-safe |
启用上述功能,并增加二进制继续确认、有效的 Plan Mode 退出以及纯文本继续 |
配置与命令¶
通过 /continue 命令集进行控制。以下为常用命令示例:
# 查看当前状态
/continue status
# 手动设置配置(JSON 对象)
/continue set {"network":{"enabled":true},"recommended":{"enabled":true}}
# 禁用插件对当前任务的影响
/continue off
# 重置为全局默认配置
/continue reset
# 暂停自动化控制(支持时间单位)
/continue pause [<Nms|Ns|Nm|Nh>]
/continue resume
# 查看最近决策的解释
/continue explain
# 管理学习机制
/continue learn <on|off|status>
/continue learn candidates
/continue learn approve <candidate-id>
/continue learn forget <record-id|--all>
全局配置示例¶
在 cordis.patch.yml 中设置全局默认值:
- id: continue
config:
defaults:
network:
enabled: true
mode: bounded
maxRetries: 5
recommended:
enabled: true
continuation:
enabled: false
优先级规则为:任务会话覆盖 > 插件全局默认 > 内置值。
使用注意¶
- 默认关闭:安装后,每个可执行能力默认关闭。必须通过配置或命令显式启用。
- 输入处理:插件不会使用 LLM 去猜测问题或错误的含义。对于未知、模糊、风险或未验证的输入,会委托给官方 UI 处理。
- 权限控制:插件永远不会批准特权操作或不可逆的操作。
- 与 dsh-camel 的协作:插件不处理
RATE_LIMIT错误,该功能由dsh-camel处理。如果需要在 Continue 中处理RATE_LIMIT,需在配置中显式添加并会触发所有权重叠警告。 - 网络恢复范围:插件内置处理的网络代码为
TIMEOUT、TRANSPORT和SERVER。其他代码(如RATE_LIMIT)的处理逻辑需根据项目依赖的插件(如dsh-camel)进行协调。
生态背景¶
DSH 理念是「一切皆插件」,插件生态独立于 DeepSeek 或幻方的官方关系,由社区维护。更多插件详情及源码可访问插件目录: