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