为给定 Zotero 论文条目创建 Better Note 风格的 Markdown 总结笔记。用于用户要求在 Zotero 中为某篇论文生成简洁清晰的中文总结时,尤其适用于需要按“研究动机”“研究内容”“核心技术或核心结论”三部分各写一段、避免冗余描述、并可直接粘贴或写入 Better Notes 的场景。
为单篇论文生成可直接用于 Zotero Better Notes 的 Markdown 笔记,并在可用时自动把笔记创建到 Zotero 的目标论文条目下。默认使用中文,输出三段式总结,每一部分只写一段,优先做到信息密度高、表达直白、便于快速回顾。
优先使用本 skill 自带的本地桥接脚本和 Zotero 插件完成自动创建;只有当桥接不可用时,才退回到输出一份可直接粘贴到 Better Notes 的 Markdown 正文。
先检查 Zotero 桥接是否可用:
python3 scripts/zotero_bridge.py ping
若命令成功返回 JSON,说明可以直接读写 Zotero。
若桥接不可用,则先安装本 skill 附带的 Zotero 插件:
python3 scripts/build_zotero_bridge_xpi.py
这会生成 assets/codex-zotero-bridge.xpi。将该文件安装到 Zotero profile 的 extensions/ 目录中,然后重启 Zotero。插件源码位于 assets/zotero-codex-bridge/bootstrap.js 和 。
桥接就绪后,使用 scripts/zotero_bridge.py 完成两类操作:
先确认当前任务是“单篇论文总结”,而不是文献综述或多篇比较。若用户没有额外要求,默认:
如果用户显式要求英文或其他结构,按用户要求覆盖默认行为。
若用户没有显式给出 Zotero item key,且桥接可用,则默认以 Zotero 当前选中的单篇论文作为目标对象。先运行:
python3 scripts/zotero_bridge.py get-selected-item
若未选中条目、选中了多个条目,或返回对象不是单篇论文的顶层条目,则先纠正目标对象。
优先从用户提供的信息,或由 Zotero 桥接返回的标题、摘要、作者、年份、附件路径中提取关键信息,并围绕以下问题归纳:
若桥接返回 bestAttachment.path 且总结质量明显依赖正文细节,可以进一步读取该 PDF 或附件;否则优先根据标题、摘要和已有元数据给出简洁总结。
如果只能看到摘要或部分信息,明确按“基于摘要”或“基于可见内容”总结,不要把推断写成确定事实。
根据论文类型,在以下两种写法中二选一:
不要为了保持模板僵硬而误用“核心技术”。若论文的价值主要来自发现、结论或实证结果,就写“核心结论”。
严格输出以下三部分,每部分各一段,不拆成列表:
## 研究动机## 研究内容## 核心技术 或 ## 核心结论写作要求:
默认输出正文使用如下结构:
## 研究动机
...
## 研究内容
...
## 核心技术
...
若第三部分更适合写结论,则将最后一个标题替换为 ## 核心结论。
若桥接可用,优先自动创建 note,而不是只返回文本。推荐流程:
python3 scripts/zotero_bridge.py create-note --selected --markdown-file /tmp/paper-summary.md --title "论文总结" --open
若用户提供了明确的 Zotero item key,则改用:
python3 scripts/zotero_bridge.py create-note --parent-key ITEMKEY --markdown-file /tmp/paper-summary.md --title "论文总结" --open
--title "论文总结" 会在正文前补一个顶层标题,目的是让 Zotero 中的 note 列表有稳定标题;不要把这个标题当作三段总结的一部分。
若桥接不可用,则直接返回 Markdown 内容,不要额外包裹解释性前言,并明确说明需要先安装桥接插件后才能自动写入 Zotero。
.xpi。/tmp/zotero-codex-bridge 请求并创建 note。交付前检查以下几点:
若论文信息不足,明确说明信息边界,但仍尽量给出可用的精炼总结。