DSH-Reforge

修复有据，经验可循。

官网 · 中文 · English · 文档导航 · 安装指南 · 兼容性 · 更新记录

DSH-Reforge（npm 包名 dsh-reforge）是 DeepSeek Harness 的社区插件，从有测试依据的 Python Bug 修复中积累可追溯经验，在后续相似任务中选择适用经验作为参考。

DSH-Reforge is a DeepSeek Harness plugin for traceable experience from test-verified Python bug fixes, with scoped retrieval for later tasks.

本发行版本：dsh-reforge@0.1.0-alpha.2，实验性 alpha。 包含新版工作台、完整示例、配置检查与备份恢复。公开 npm/Release 是否已完成核验，以版本状态与 Issue #113 为准。本项目由社区独立开发，不代表 DeepSeek 官方审核、推荐或安全认证。

精确兼容 DSH 0.2.0-rc.2 和 0.2.1-rc.5，采用独立适配层与 Windows/Linux 四组合检查；范围见版本矩阵。旧公开 alpha.1 仅支持前一个宿主；其他 DSH 版本需另行验证。

能做什么

• 自动记录：首次由仓库所有者开启后，正常对话中的直接用户请求形成执行片段；保存有限摘要与受限 Python 代码快照。
• 验证来源：在临时工作区重放原始失败、修复后的独立验收和回归测试。回合结束只触发检查，不能证明任务正确。
• 提炼候选：使用 DSH 已注册的模型，从验证材料提炼有来源、适用条件和版本约束的候选，再执行独立来源复核。
• 适用时参考：后续请求按仓库、代码、依赖条件和相关度选择少量经验；证据不足或不适用时可以不提供。
• 查看和纠正：在 DSH 的插件详情中查看学习动态、经验、来源、历史和使用记录，记录反馈、修订、停用或恢复。

来源验证说明当时的修复通过检查，不证明经验能改善未来任务。已有小规模对照没有观察到验收成功率改善，不能宣传普遍有效；结果与失败见 评价记录。

开发者可复查冻结100条查询的检索评测、逐条解释与索引性能：实验候选的合成留出正例召回12/30→18/30，中文/改述仍漏选。该源码工具尚未发行，未替换默认DSH策略，也不代表真实任务收益。

后续源码已将等价BM25索引及请求内读取优化接入实际选择服务，工作台可查看本次运行的选择/拒绝依据。完整服务链三组测量保留索引单独优化的无收益结果与冷请求：本机10条合成变体的选择P50为1556.79→142.96ms；不是模型或线上收益，尚未发行至npm。

新增120条跨语言合成检索对照：本地向量在60条任务族留出中将正确提供从3/30提高到18/30，但仍误选16/60；混合方案为12/30、误选18/60。公开合成向量支持零付费评分重放；原型仅离线，不能当作真实任务收益或默认策略上线依据。

后续三态适用性对照使用额外的作者结构化任务事实：48条新留出中误选13→1，提供精确率45.8%→92.3%，保留原正确9/11、另补回3条，覆盖率50%→27.1%。完整漏选、纯条件消融与复现公开；不是自动事实提取或真实任务收益，尚未接默认DSH/发行包。

新增真实文件事实预览与五臂对照：有限Schema自动支持32/48输入，成功投影事实96/96一致；同批合成工件留出中，自动事实＋明确目标相对dense正确7/24→11/24、误选9/48→0/48，同时丢失2个原正确、覆盖率33.3%→22.9%。目标/属性仍需显式输入，13/24正例仍漏；源码npm run project:facts可体验，未接默认DSH或发行包，不代表Agent收益。

源码工作台新增任务准备与真实输入流程：检查文件与字段、选择明确目标、预览后提交当前对话；为确切经验版本声明必要前提，只否决原第一候选，不改变原排序。提供实际官方AgentLoop的零费用演练和恢复测试；已发布alpha.2不包含此源码增量，6个作者流程对照也不代表真实任务成功率提升。

演示视频：保存失败，也不丢输入

亲自运行同款工程： examples/customer-form 提供原始代码、补丁、外部验收和回归测试。运行 npm run example:customer-form，无需 Key 或 DSH，实际核对失败、修复和经验入库。第一次配置与验证将体验、只读配置与学习授权串起来。

下载演示 MP4（2 分 02 秒，1080p） · 中文字幕 · 案例与验收说明

从客户表单丢失输入开始，演示明确纠正、实际补丁、独立验收和经验入库：原始版本 2 项验收失败，修复版本 2/2 通过，回归测试 3/3 通过。

本片为合成数据的本地显式记录案例，展示 alpha.2 的独立工作台；修复由 Codex 准备，示例页面应用补丁。录像没有模型自主编码、自动提炼或付费调用。另有真实模型验证报告：自动闭环通过；对照题中两检索均拒选，未得到使用经验的收益证据。

安装与打开

需要 Node.js ≥24.10、DSH 0.2.0-rc.2 或 0.2.1-rc.5。修复验证还需要 Git、Python ≥3.10 和 pytest；CI 固定 pytest 9.1.1。只支持这两个精确宿主，不适用于 DeepSeek 官方聊天网页。

在自己的 DSH 环境安装准确版本：

dsh plugin --profile web add dsh-reforge@0.1.0-alpha.2

停止原 DSH 进程，再使用同一 profile 启动 Web，打开启动器打印的完整认证地址。左侧「插件」→「dsh-reforge」→ 详情操作页即可查看；配置仓库中的已有会话，可从与「对话／轨迹」并列的「经验」标签进入。打开页面不调用模型。

学习默认关闭。启动前设置 DSH_REFORGE_CONFIG 为本机 JSON 配置的绝对路径。最小只读配置：

{
  "repoRoot": "/absolute/path/to/your/repository"
}

完整安装、开启自动学习、独立验收和旧本地预览迁移步骤见 安装指南。旧 DSH_EVOLVE_CONFIG 仍兼容；两个变量同时存在时必须指向同一个文件。凭据只在 DSH 官方凭据配置中设置，不写入插件 JSON。

一次修复如何形成经验

1. 仓库所有者配置独立验收、执行信任、模型共享和提炼次数，开启学习。
2. 在 DSH 中照常提出 Python Bug 修复请求，并在需要时明确纠正。
3. 插件在临时工作区检查原始失败、修复结果和回归测试；材料与授权齐备后提炼候选，再独立复核。
4. 在插件页查看经验、适用范围和来源；后续相似请求可能获得参考，反馈或停用仍由使用者决定。

这是当前流程的文字说明；来源验证和后续参考记录不能证明任务收益。可复用的中英文项目介绍单独维护。

当前边界

• 第一版聚焦一个仓库内的 Python＋pytest 修复，每个直接请求是独立执行片段，不做跨轮语义合并。新建 Python 文件、符号链接、交错请求、版本漂移或不支持的变更可能跳过学习。
• 自动学习须显式配置执行信任、模型共享、独立验收及提炼次数；maxCalls 是提炼次数，不是整个 DSH 会话的人民币上限。网络中断等未知调用不自动重试或退额。
• 本地验证会运行仓库代码，不具备强沙箱。只对自己信任的仓库开启；不自动回滚或提交用户代码。
• 默认数据继续保存在 ~/.dsh/evolve/<repoId>/evolve.sqlite，当前 SQLite v9。保留旧历史、evolve_ 工具和内部标识，改名不搬迁经验或重置授权。
• 不保存完整会话、附件或任意工具输出。自动模式保存有界摘要、少量明确纠正、来源标识及代码快照；目前没有自动彻底遗忘功能。模型共享开启后，有限修复材料会发送至所选模型服务。
• 已有 Windows 完整 Web、双平台核心与实际安装演练；脚本模型证明执行路径可运行，不能替代真实模型质量、Desktop、多版本或收益验证。

从源码开发

读者入口：文档导航 · 版本与发行状态 · FAQ · 数据运维 · 参与试用。开发历史与公开发行分开记录，八项补齐进度见 T046。

npm ci --ignore-scripts
npm run check
npm run compat
npm run demo

demo 只生成合成案例。按输出中的配置路径运行 node dist/src/cli.js panel --config <config.json> 可打开独立面板；完整地址带本机访问令牌，请勿分享。开发检查和实际安装使用隔离 profile，不操作默认 DSH 配置。

产品需求 · 架构总纲 · 路线 · 开发与贡献 · 更新记录

本产品的数据、验证、选择及更新机制由本仓库独立实现。MIT License。 品牌素材与使用说明。