ClawHub

Reference Formatter

Other

将用户提供的参考文献按指定引用格式（如APA、GB/T、MLA等）整理排版，输出规范的文档文件。

Install

openclaw skills install reference-formatter

Reference Formatter 📚

把混乱的参考文献列表整理成专业格式，输出可直接使用的文档。

Trigger

['整理参考文献', '格式化文献', '文献格式', '参考文献排版', '引用格式', 'APA格式', 'GB/T格式', 'MLA格式', '文献列表整理', 'format references', 'citation format']

Workflow

第一步：接收文献列表

用户提供原始参考文献列表。接受任意格式的输入：

  • 直接粘贴的文本
  • 从网站/知网/Google Scholar/PubMed 等导出的混乱格式
  • 多条参考文献混合

如果用户未提供文献，先追问：「请把需要整理的参考文献粘贴过来，直接 Ctrl+V 就行」

第二步：确认目标格式

确认目标格式。优先级如下：

  1. 用户上传了自定义格式规范（如学院格式说明、期刊作者须知）→ 按用户提供的格式输出
  2. 用户口头指定了标准格式 → 按该格式输出
  3. 未指定 → 默认 APA 第7版标准

内置支持的格式：

序号格式适用场景
1APA 第7版默认格式。Publication Manual (7th ed.) 标准版
2APA 第6版旧版学术期刊投稿
3GB/T 7714-2015中国学位论文、国内期刊投稿
4MLA 第9版人文学科、语言文学
5Chicago (Author-Date)历史学、部分社会科学
6自定义用户上传自己的格式规范文件

追问格式：「用什么格式？不说就默认 APA 第7版。如果你有自己的格式规范（学院发的、期刊的），直接贴过来就行」

第三步：解析与识别

对每条文献自动识别类型：

  1. 扫描 DOI、URL、卷期号、出版社等特征
  2. 按 reference/formats.md 中的检测规则分类：
    • 期刊文章 → 有 DOI 或卷期号
    • 图书 → 有出版社、无卷期
    • 书籍章节 → 包含 "In"、编者、"pp."
    • 网页 → 有 URL、无学术元数据
    • 学位论文 → 含"dissertation"/"thesis"/[D]
    • 会议论文 → 含 conference/symposium/proceedings
  3. 无法识别的条目标记为 ⚠️ 需人工确认，并保留原文

第四步：格式化与变更报告

按目标格式规范逐条处理：

  • 作者名：正确处理缩写（APA）、全大写（GB/T 英文）或全名（MLA）
  • 标点：中文文献用中文标点，英文文献用英文标点
  • 斜体：书名、刊名、卷号用斜体（Markdown * 标记）
  • DOI/URL：默认去除 DOI（除非用户要求保留）
  • 排序：中文文献按拼音首字母排序，英文文献按姓氏字母排序，中英文分开为独立小节
  • 分段：每条文献独立成段，段落间有间距
  • 标题不加粗：参考文献标题使用普通字重
  • 悬挂缩进：在输出文档中自动应用

格式化完毕后，直接生成文档并附带变更报告，无需用户确认。报告格式如下：

📋 格式变更报告（36条文献）

处理摘要：
├─ 期刊文章格式化：16条
├─ 书籍/章节格式化：3条
├─ 学位论文格式化：7条
├─ 会议论文格式化：4条
├─ 其他：6条（含1条⚠️需人工确认）

主要变更：
├─ 作者格式：and→&（3处）、Wang M-W→Wang M.-W.（2处）
├─ 标点符号：～→– 全角→半角（8处）
├─ 页码范围：en dash 统一（5处）
├─ 出版地：删除 New York:、Madison: 等（3处）
├─ 学位论文：调整格式（2处）
├─ DOI：已全部移除
├─ 排序：中文按拼音，英文按姓氏（已分节）

⚠️ 需注意：
└─ Moore (2008) — 缺少学位授予单位信息

文件已生成：references.docx / references.txt

格式细节参考：reference/formats.md

第五步：输出文档

默认输出（用户未指定文件名和位置时）：

  • 格式：.docx（Word 文档）
  • 位置：workspace 根目录
  • 文件名：references.docx

如果用户指定了文件名或位置，按用户要求执行。

如果 pandoc 或 Word COM 不可用，降级为 .txt 纯文本并告知用户。

输出位置： 默认写到 workspace 根目录

输出示例：

# References (APA 7th Edition)

Smith, J. A., & Jones, B. C. (2023). Understanding cognitive biases in decision-making. *Journal of Behavioral Science*, *45*(2), 112-130. https://doi.org/10.1234/jbs.2023.045

Wang, X., & Li, Y. (2022). 机器学习在自然语言处理中的应用 [Application of machine learning in NLP]. *计算机学报*, *44*(3), 201-215.

U.S. Department of Health and Human Services. (2021, March 15). *Mental health and wellness*. https://www.hhs.gov/mental-health

第六步：质量检查

输出后自检：

  • 所有条目都成功识别了类型？
  • 有无 ⚠️ 标记的条目？如有，提醒用户核对
  • 标点符号符合目标格式规范？
  • 排序正确？
  • DOI/URL 可点击？

失败兜底

  • 无法识别类型 → 保留原文格式，标记 ⚠️，不强行猜测
  • 作者信息缺失 → 不编造，留空或标 [Author unknown]
  • pandoc 未安装 → 仅输出 .md 文件，告知用户：「如需 .docx，可以安装 pandoc 后让我再转一次」

Examples

示例 1：混格式输入 → APA

输入：

[1] Smith, John, and Jones, Betty. Understanding cognitive biases in decision-making. Journal of Behavioral Science, vol. 45, no. 2, 2023, pp. 112-130.
[2] Wang Xiao, Li Yu. Research on machine learning in NLP. Chinese Journal of Computers, 44(3):201-215, 2022.

输出：

Smith, J., & Jones, B. (2023). Understanding cognitive biases in decision-making. *Journal of Behavioral Science*, *45*(2), 112-130.

Wang, X., & Li, Y. (2022). Research on machine learning in NLP. *Chinese Journal of Computers*, *44*(3), 201-215.

示例 2：GB/T 输出

要求：「转成 GB/T 格式」 输出：

[1] SMITH J, JONES B. Understanding cognitive biases in decision-making[J]. Journal of Behavioral Science, 2023, 45(2): 112-130.
[2] 王小明, 李雨. 机器学习在自然语言处理中的应用研究[J]. 计算机学报, 2022, 44(3): 201-215.

Tool Usage

  • 文件读写：read / write — 读入原始文献，写出格式化文件
  • 格式参考：read reference/formats.md — 查阅各格式的详细规范
  • 文档转换：pandoc references_formatted.md -o references_formatted.docx — Markdown → Word
  • 联网查询（可选）：如果参考文献信息不全（缺 DOI 等），可用 web_search 补全

Additional Information

注意事项

  1. 不编造信息 — 缺作者或缺日期就留白，不要编
  2. 保留原文信息 — 即使识别出的类型不对，原文内容一字不动
  3. 中文作者处理 — 中文名字不需要缩写，保留全名，按拼音排序
  4. 去敏提醒 — 如果文献信息包含个人标注、内部链接等，保留但不额外处理

后续可扩展

  • 支持更多格式：Harvard、Vancouver、IEEE
  • 批量导入：从 BibTeX/EndNote/RefMan 文件直接导入
  • 在文内插入引用标记 [1] 并自动编号