chunsi-w/dsh-trajectory-governor ↗★ 13

@chunsi-m/dsh-trajectory-governor

Closed-loop trajectory policy plane for DeepSeek Harness: task episodes, revision-aware verification debt, benchmark-aware stop control, adaptive effort, and scoped capability control. 适合需要对任务执行、基准测试和自动重试进行策略管控的用户。

パッケージ
@chunsi-m/dsh-trajectory-governor
互換性
未検証
Harness ピア範囲
>=0.1.0-rc.5 <0.2.0
Cordis ピア範囲
^4.0.1
バージョン
0.2.0
ライセンス
MIT
最終更新
2026/08/18

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:chunsi-w/dsh-trajectory-governor

ドキュメント

README 全文を読む ↗

配置

cordis.patch.yml 默认配置:

- insert:
    - id: trajectory-governor
      name: '@chunsi-m/dsh-trajectory-governor'
      config:
        mode: active
        adaptiveReasoning: false
        restrictBeforeEvidence: true
        autoVerify: true
        maxAutomaticContinuations: 1
        exposeStatusTool: true
        ledger: true
        maxLedgerBytes: 10485760
        benchmarkRequired: false
        benchmarkToolNames: [run_benchmark]
        verificationToolNames: [build_project, run_correctness_test]
        finishToolNames: [finish]
        fullBenchmarkMinQueries: 10000
        fullBenchmarkMinRecall: 0.95
        benchmarkScoreTolerancePercent: 2
        maxActionsWithoutBenchmark: 8
        maxStagnantFullBenchmarks: 2
        stopRetryOnDeterministicErrors: true
字段默认说明
modeactiveoff / shadow / active;shadow 只决策和记账,不改请求
adaptiveReasoningfalseinspect/design/recover 阶段选择模型声明的最深 effort;阶段结束后恢复 provider default
restrictBeforeEvidencetruefix/continuation 等任务在观察前临时隐藏已知专用写工具
autoVerifytrue有完成 blocker 时允许 agent/turn-stopping 追加有限验证步骤
maxAutomaticContinuations1每个 turn 的自动验证续步上限;耗尽后只追加一次 blocker-report 步
noInformationLimit3重复且无新信息达到阈值后成为完成 blocker,取得新结果后解除
exposeStatusTooltrue注册只读 trajectory_policy_status 工具
ledgertrue写入本地 policy ledger,不进入模型历史
ledgerPath$DSH_HOME/trajectory-governor/decisions.jsonl自定义账本路径
maxLedgerBytes10485760活动 JSONL 达到大小前轮转;旧文件保留
maxHintChars1200单条 model-visible policy hint 上限
benchmarkRequiredfalse为性能任务强制当前 revision 的完整 benchmark;普通任务保持关闭
benchmarkToolNames[run_benchmark]视为 benchmark 的工具名,可按 harness 改写
verificationToolNames[build_project, run_correctness_test]视为常规验证的工具名
finishToolNames[finish]需要经过完成门的显式结束工具名
fullBenchmarkMinQueries10000完整 benchmark 的最小 total_queries
fullBenchmarkMinRecall0.95完整 benchmark 的最小 recall
benchmarkScoreTolerancePercent2同规格 QPS 下降不超过此比例时视作噪声范围
maxActionsWithoutBenchmark8缺当前完整 benchmark 时,多少成功动作后主动提醒补证据
maxStagnantFullBenchmarks2同规格完整 benchmark 无实质提升后提示平台期
stopRetryOnDeterministicErrorstrue对 HTTP 400 / invalid_request_error 不调用 DSH retry chain
maxTrackedResults256每 Agent 保留的 result fingerprint 与 benchmark best record 上限

推荐上线顺序

先使用 shadow mode:

mode: shadow
ledger: true

确认 relation/phase 判断符合真实会话后,再切换:

mode: active

adaptiveReasoning 默认关闭,因为改变 reasoning effort 会改变 request header 与缓存形状。应在具体 provider/model 上完成校准后再启用。