harness2-lessons-bridge:在 Pi 与 DSH 中只读读取 pi-harness2 项目教训

前言

在 Pi 或 DeepSeek Harness(DSH)里做任务时,如果项目已经用 pi-harness2 跑过 h2:run 并在本地 .harness2/library/ 里沉淀了 lesson,常见做法是手动翻目录或复制片段给模型。两个运行时各自装插件、路径不一致时,更容易漏读或重复劳动。下面介绍社区插件 harness2-lessons-bridge(维护者 YeChenglin8888,GitHub:YeChenglin8888/harness2-lessons-bridge):为 Pi 与 DSH 各提供同一套只读工具,从项目目录里的 pi-harness2 产出中检索 lesson,供智能体调用时参考,而不是替代完整的 Harness² 执行链。

这是什么

harness2-lessons-bridge 是一个跨运行时的「经验阅读器」:读取项目本地由 pi-harness2 生成的 lesson 文件。Pi 侧与 DSH 侧各注册同一个只读模型工具 h2_lessons。插件本身不发起模型调用、不做 probe,也不是完整的 propose → probe → compose 执行器。

在 SkillHub 社区目录中,该插件归类为「联网工具」;仓库当前星标为 0。许可证为 MIT(见仓库 package.json,版本 0.1.0)。

核心功能

两个适配器暴露的工具行为一致,要点如下。

  1. 只读检索:工具名 h2_lessons,按任务相关词匹配 lesson 的 task 名称与摘要,匹配项优先排序。
  2. 返回上限:最多返回 3 条 lesson;每条内容截断至 4,000 字符。
  3. 不写库、不推广:不会写入 harness,也不会把某条 lesson「推广」为必须遵守的指令。
  4. verified 字段含义:pi-harness2 lesson 里的 verified 记录的是该 lesson 自身 LLM judge 的判定;工具会标注为 self-judged pass,并非独立第三方核验。应把返回内容当作待核查的证据,而不是无条件执行的命令。

安装与启用

安装命令以仓库 README 为准。

Pi(从 GitHub 安装):

pi install git:github.com/YeChenglin8888/harness2-lessons-bridge

DSH(需指定 profile):

dsh plugin --profile <profile> add github:YeChenglin8888/harness2-lessons-bridge

启用前提:Pi 与 DSH 都必须指向包含 .harness2/library/ 的同一项目目录。DSH 侧会在下一次启动该 profile 时加载插件自带的 cordis.patch.yml(见 package.json 中 dsh.bundle.patch 配置)。

依赖说明:插件将 @deepseek-ai/dsh-tools 列为 peerDependency(资料中为 0.2.2-alpha.2,optional),与 DSH 工具链版本需自行对齐。

典型用法

可复现流程来自 README,顺序如下。

  1. 在目标项目中先通过 pi-harness2 运行 h2:run,生成 lesson 并写入 .harness2/library/。
  2. 在 Pi 或 DSH 中向智能体提出与任务相关的描述,让其调用 h2_lessons 并传入任务关键词(task terms)。
  3. 根据返回的最多三条摘要与正文片段,结合源码与测试自行判断是否采纳。

仓库提供的自检方式(开发者向):

npm install --ignore-scripts
npm test

适用场景与注意

适合谁:已在用 pi-harness2 沉淀项目级 lesson,并希望在 Pi 与 DSH 两套 Harness 里用同一工具名只读检索,避免重复造轮子的人。

不适合当作什么:不要指望本插件完成 Harness² 的完整 propose → probe → compose;它只做本地 lesson 的阅读桥接。

安全与权限:DSH 插件随当前 DSH 进程权限运行,可访问该进程能读的项目路径。安装前请阅读仓库源码与 MIT 许可证,确认 cordis.patch.yml 与入口文件符合你的策略;社区目录 SkillHub 为独立站点,与 DeepSeek / 幻方无官方从属关系。

结尾

harness2-lessons-bridge 把 pi-harness2 的项目本地 lesson 以只读、限量、带 self-judged 标注的方式接到 Pi 与 DSH,适合作为检索证据而非自动规程。目录页与源码:

  • 社区目录:https://www.skillhub.cn/plugins/YeChenglin8888/harness2-lessons-bridge
  • GitHub:https://github.com/YeChenglin8888/harness2-lessons-bridge
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜