前言¶
在 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)。
核心功能¶
两个适配器暴露的工具行为一致,要点如下。
- 只读检索:工具名
h2_lessons,按任务相关词匹配 lesson 的 task 名称与摘要,匹配项优先排序。 - 返回上限:最多返回 3 条 lesson;每条内容截断至 4,000 字符。
- 不写库、不推广:不会写入 harness,也不会把某条 lesson「推广」为必须遵守的指令。
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,顺序如下。
- 在目标项目中先通过 pi-harness2 运行
h2:run,生成 lesson 并写入.harness2/library/。 - 在 Pi 或 DSH 中向智能体提出与任务相关的描述,让其调用
h2_lessons并传入任务关键词(task terms)。 - 根据返回的最多三条摘要与正文片段,结合源码与测试自行判断是否采纳。
仓库提供的自检方式(开发者向):
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