Zotero 写作笔记润色

写作规范散落在 Zotero 笔记里的问题

很多研究者习惯把英文写作的经验沉淀到 Zotero 里，但这类笔记往往是中文记录、零散分布在多个独立 note 中。当你要润色一段英文段落时，通用大模型的建议很容易和你已有的写作风格冲突：标点怎么处理、缩写要不要展开、结果章节用主动还是被动语态，这些问题的答案其实都在你自己的笔记里，只是没有被有效利用。

以个人笔记为唯一依据的润色流程

zotero-polish 的目标是让润色结果只服从你的笔记规范，而不是通用的学术英语经验。

• 触发条件：仅在消息中同时出现「润色英文」类指令，且明确点名 zotero 或 note 时才会启动。单纯说“帮我改一下这段英文”不会触发。
• 段落归属判定：根据段落内容从 6 条笔记中选出 1 条主笔记，例如含大量实验数据的选结果描述笔记，包含模型结构和参数说明的选方法笔记。无论选哪条，都会额外读取通用表达笔记，因为它包含适用于所有章节的术语对照和排版规则。
• 拉取笔记正文：通过 Zotero Web API 获取笔记 HTML 正文，API Key 从环境变量 zotero_api_key 读取。如果 API 不可用，则回退到本地 SQLite 数据库，通过 itemKey 查询独立笔记全文。
• 可溯源修改：输出采用中英双语三段式结构，每处修改说明都必须指向笔记中的具体规则或示例。笔记中未覆盖的场景，技能会明确告知未覆盖此场景，只做不冲突的最小润色。

适用边界与注意事项

笔记内容代表个人风格偏好，如果与通用学术英语规范冲突，一律以笔记为准。技能不参考外部文献，也不混入其他人写作技能的建议，因此不适合用于需要外部事实核查的改写场景。另外，特定的 MCP 工具无法读取独立笔记，该路径已明确禁用。