前言¶
在 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