前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。對於需要處理大量文獻的工程師或研究者來說，如何高效地提取知識、校驗準確性並整理成一份可查閱的文檔，是一個常見痛點。bearing-notes 插件提供了這樣一個解決方案：它允許在閱讀文獻時隨手記錄，將所有筆記彙總到一個 Word 文檔中，並利用模型對筆記進行審閱和知識延伸。
核心功能¶
筆記記錄與彙總¶
插件支持記錄筆記的標題、來源、標籤以及 Markdown 格式的正文。所有筆記會統一彙總到一個 Word 文檔中。用戶可以隨時調閱這份文檔，也可以對已保存的筆記進行重新審閱，並將審閱結果寫回 Word。
模型審閱與知識延伸¶
右側欄會調用模型對筆記進行審閱。模型會返回四部分反饋：準確性審閱（判斷正誤）、遺漏與風險、相關知識延伸、建議追讀。該功能的提示詞內置了該領域的概念地圖和常見錯誤清單（例如 GCr15 的碳化物類型、L10 壽命的判斷等），因此審閱並非泛泛而談，而是針對「軸承鋼滾動接觸疲勞」領域的專業判斷。
術語翻譯與約束¶
爲了解決專有名詞譯不準的問題，插件內置了 214 條人工整理的術語庫。
* 術語鎖定：文中命中的術語會被釘進提示詞，長詞優先，允許嵌套。
* 誤譯禁令：內置高頻誤譯禁令（如 white etching area 禁止譯爲「白色腐蝕區」）。
* 禁譯清單：牌號、標準號、符號、單位保留原文。
* 譯後覈對與重譯：系統會檢查譯文是否包含釘住的術語，若缺失會觸發一次重譯機制。
安裝與配置¶
插件是標準的 DSH bundle。推薦使用官方工具安裝：
plugin_manager { action: "install_bundle", target: "<本倉庫絕對路徑>" }
安裝後，需要在 loader 行的 config 中覆蓋配置項。主要配置包括：
* dataDir：數據目錄。
* docxFile：生成的 Word 文件名。
* docxTitle：Word 文檔標題。
* provider 與 model：指定用於審閱和翻譯的模型，留空則跟隨默認路由。
注意：修改 Host 半代碼（index.js 或 lib/*.mjs）後必須重啓 dsh。客戶端 bundle 支持熱更新，但 Host 模塊不會。
典型用法¶
筆記與審閱¶
在閱讀文獻時，可以通過會話標題欄的按鈕或右側欄的 + 新建標籤菜單進入「文獻知識庫」。隨手記錄知識點後，右側欄會調用模型進行審閱。用戶可以將草稿交給模型，獲取準確性反饋、風險提示以及相關知識延伸，從而完善筆記。
翻譯與術語約束¶
對於長文，插件支持自動分段翻譯。在翻譯過程中，會利用釘住的術語庫鎖定專有名詞（如 GCr15、RCF 等），防止模型亂譯。若模型漏譯了被鎖定的術語，插件會自動觸發重譯。
已知限制¶
- Word 格式限制：生成的 Word 文檔僅支持最小集格式（標題、正文、項目符號、加粗、斜體、等寬字體），不支持表格、圖片或目錄域（目錄爲手動段落列表）。
- 術語庫來源：術語庫爲人工整理的 214 條，覆蓋常用術語，未進庫的新詞按模型通用譯法處理。
- 驗證機制：側欄的渲染效果未做瀏覽器內的自動化視覺驗證。
- 數據流：
notes.jsonl是唯一的數據真相，Word 每次改動後都會由 JSONL 重新編譯。
結語¶
bearing-notes 旨在幫助用戶在 DeepSeek Harness 中構建結構化的文獻知識庫。它通過模型審閱和術語約束機制，輔助用戶在特定領域（如軸承鋼滾動接觸疲勞）內更準確地整理文獻。
- 目錄頁：https://www.skillhub.cn/plugins/FeC3-pearlite/bearing-notes
- GitHub：https://github.com/FeC3-pearlite/bearing-notes
