← 返回列表
D

@akslcw/dsh-negative-ledger

v0.1.1 · 3 天前发布

Agent negative-knowledge ledger for DeepSeek Harness: records failed paths with evidence hashes and retry conditions, auto-invalidates on evidence change.

dsh-plugindeepseek-harnessnegative-knowledgeagent-ledgercoding-agent

README

dsh-negative-ledger

给编码 Agent 用的失败知识账本。它只记录已被证伪的路径——失败的命令、不存在的文件、被否定的方案、不可用的 API——连同每条结论背后的证据、以及何时可以重试。证据变化时，结论自动失效。

English

不是什么

  • 不是 memory：不存正面知识、不做语义回忆。

  • 不是 cache：存的是结论，不是工具结果。

  • 不是 bug regression tracker：覆盖任意工具调用与文件读取，而非仅 bug 修复。

    • 核心循环

    1. 一次工具调用失败（非零退出码、FS_NOT_FOUND 等）→ 记录一条负结论：outcome 见证（退出码、错误码）+ precondition 见证（来自 DSH fs/observed 的文件状态）。
    2. 下一次相同尝试按指纹命中（规范化命令 + cwd，或文件路径）。
    3. 只要所有 precondition 见证未变，该尝试被提醒（warn 模式）或阻止（block 模式）。
    4. 任一 precondition 变化 → 结论变 stale，提醒自动撤销、允许重试；重试成功 → resolved。

    差异化：DSH 原生、证据约束的持久负面记忆门禁——失败结论随环境证据自动生效与吊销，并在并发代理之间保持事务一致。

    快速开始：一条命令安装

    sh
    dsh plugin --profile <name> add @akslcw/dsh-negative-ledger

    安装并激活 bundle 层：随包发布的 cordis.patch.yml（由 dsh.bundle 清单声明）以生产默认值挂载账本策略——sqli

    查看完整 README →

    版本兼容矩阵

    DSH 版本状态说明
    dsh@0.1.0-rc.6 ✅ 兼容 cordis patch ✅
    dsh@0.1.0 ✅ 兼容 标准 patch ✅
    dsh@0.2.0 ⚠️ 待验证 待实测（API 可能在变）
    dsh@0.3.0+ ❓ 未知 尚未发布

    💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

    元数据

    License
    MIT
    npm
    @akslcw/dsh-negative-ledger
    Repo
    git+https://github.com/akslcw/dsh-negative-ledger.git
    Engines
    {"node":"^22.19.0 || >=24.0.0"}
    Weekly DL
    0
    Monthly DL
    0
    dsh.bundle
    {"bundle":{"patch":"./cordis.patch.yml"}}