前言¶
在 DeepSeek Harness(DSH)的工作流开发中,智能体偏离任务轨道或行为退化是一个常见问题。dsh-trajectory-anchor 是一个旨在解决这一问题的插件。它通过锁定初始行为、监控每一步轨迹并在退化时进行干预,防止智能体偏离任务。
插件定位¶
这是一个由 ggfgfgf-on 维护的工作流插件。它是一个独立的 DSH 捆绑包,用于单智能体轨迹的观测、锚定和审计。
核心功能¶
该插件提供四个核心能力:
- Observation & audit:对每一步进行基于分词权重的轨迹评分(如“我/让我”比率、人设带、会话本地基线百分位、EWMA),捕获证据(验证/编辑/完成声明),并生成追加式审计日志(
<workspace>/.dsh-trajectory-logs/anchor-<agentId>.jsonl)。 - First-round anchoring:在第一轮请求时应用三部分机制:引导工具允许列表(
bash/str_replace_editor/pwsh)、最小人设以及运行时上下文 + 技能目录抑制。工具表面在组装时派生(未提升的请求仅接收引导允许列表)。 - Two behavioral reminders:
- L1 pullback:在作用域违规或上次验证后代码编辑时触发,建议明确豁免。
- L2’ confirm-reanchor:仅在轮次内确认某事错误时触发,将第一轮最小载荷放回。
- 这两个提醒均为信息性的,默认关闭。
- anchor_status:一个只读审计工具,用于检查锚定/提升状态、引导允许列表、分数和审计日志尾部。
安装与启用¶
使用 PowerShell 进行安装,设置环境变量并添加插件。
$env:DSH_HOME = "<scratch-dir>"
dsh plugin --profile anchor-e3 add --ignore-scripts <path-or-fixed-commit-spec>
dsh --profile anchor-e3 --dump-config
配置项¶
新安装需要零配置。所有 21 个键都有默认值,未知键会被警告并忽略。
关键配置项包括:
- anchorEnabled:启用第一轮锚定。
- bootstrapTools:引导工具允许列表。
- gateEnabled:晋升门禁(anchor-gate 词汇检查)。
- pullbackEnabled:L1 拉回提醒。
- reanchorOnConfirm:L2’ 重新锚定确认。
注意事项¶
- 插件仅写入其自己的追加式审计日志,无网络/凭证,无子进程,无动态代码加载。
- 两个行为提醒默认关闭,启用时会注入一条额外用户消息。
- 无回滚、能力层、交付门或事实镜像。
- 需要 DSH
>=0.2.0-rc.2 <0.3.0和 Node.js>=22.19。
结尾¶
该插件专注于观测和审计,而不是承诺直接的执行效果。有关更多细节和源代码,请参阅 GitHub 仓库。