academic-paper-skill

English · 简体中文

专为学术论文写作设计的开源 CLI 工具，支持自由选择 AI 模型。内置 Claude、DeepSeek、GLM、通义千问、Kimi、文心一言等——中英双语、多种期刊模板、主流引用格式。

快速开始

npm install -g academic-paper-skill

设置任意一个 API Key，工具自动识别：

export DEEPSEEK_API_KEY=你的密钥      # DeepSeek（推荐国内用户）
export GLM_API_KEY=你的密钥           # GLM — glm-4-flash 免费
export DASHSCOPE_API_KEY=你的密钥     # 通义千问
export MOONSHOT_API_KEY=你的密钥      # Moonshot (Kimi)
export QIANFAN_API_KEY=你的密钥       # 文心一言
export ANTHROPIC_API_KEY=你的密钥     # Claude（国际用户）

然后直接运行：

aps draft "你的研究课题"

查看可用的 provider

aps providers

Supported providers:

  ✓ deepseek   DeepSeek (深度求索)   [DEEPSEEK_API_KEY is set]  ← 自动选择
  ✗ glm        GLM (智谱清言)        [GLM_API_KEY not set]  (glm-4-flash 免费)
  ✗ claude     Claude (Anthropic)   [ANTHROPIC_API_KEY not set]
  ...

命令列表

| 命令 | 说明 | |------|------| | aps draft <topic> | 生成论文框架或完整草稿 | | aps polish [text] | 学术语言润色 | | aps cite <reference> | 格式化参考文献 | | aps abstract [text] | 生成摘要 | | aps review [references] | 生成文献综述 | | aps caption <figure\|table> <description> | 生成图题或表题 | | aps providers | 列出所有 provider 及 API Key 状态 |

使用示例

# 自动检测 provider，生成 IEEE 格式大纲
aps draft "Federated Learning for Medical Image Analysis" --template ieee

# 指定 provider
aps draft "你的课题" --provider deepseek
aps draft "你的课题" --provider glm --model glm-4-plus

# 生成中文核心期刊格式大纲
aps draft "基于深度学习的医学图像分割" --template chinese --mode outline

# 润色文字
aps polish "本文研究了一下深度学习问题，发现效果不错。"
aps polish --file 草稿.md
cat 正文.md | aps polish

# 格式化参考文献
aps cite "LeCun Y et al. Deep learning. Nature. 2015;521:436." --style apa
aps cite "张伟等. 深度学习综述. 计算机学报. 2023." --style gbt7714

# 生成摘要
aps abstract --file 论文.md
aps abstract --file 论文.md --format structured   # 医学/生命科学结构化摘要

# 生成文献综述
aps review --file 参考文献.txt --style ieee

# 生成图题/表题
aps caption figure "五种模型在 ImageNet 上的准确率对比柱状图" --template ieee --number 3
aps caption table "三个数据集上各模型性能对比" --template chinese --number 2

# LaTeX 格式输出
aps draft "课题" --template ieee --latex

# 生成完整草稿
aps draft "课题" --template acm --mode full

支持的 Provider

| Provider | 环境变量 | 默认模型 | 说明 | |----------|---------|---------|------| | DeepSeek | DEEPSEEK_API_KEY | deepseek-chat | 价格低，推理能力强 | | GLM | GLM_API_KEY | glm-4-flash | glm-4-flash 免费 | | 通义千问 | DASHSCOPE_API_KEY | qwen-plus | 阿里云 | | Moonshot | MOONSHOT_API_KEY | moonshot-v1-8k | 长上下文 | | 文心一言 | QIANFAN_API_KEY | ernie-4.5-8k | 百度 | | Claude | ANTHROPIC_API_KEY | claude-sonnet-4-6 | 国际用户 |

国内所有 Provider 均使用 OpenAI 兼容接口，无需额外依赖。

自动检测规则： 如果同时设置多个 Key，按上表顺序选第一个；用 --provider 手动指定覆盖。

支持的格式

期刊模板： IEEE · ACM · Nature · 中文核心期刊 · 高校理工学报 · 高校社科学报 · 中国科学系列

引用规范： APA · MLA · Chicago · IEEE · ACM · GB/T 7714-2015

输出格式： Markdown（默认）· LaTeX（加 --latex）

工作原理

每条命令从 prompts/ 目录加载精心设计的 Prompt，通过对应 provider 的 API 以流式方式调用——输出逐字实时显示。语言自动检测（中文输入 → 中文输出 + GB/T 7714；英文输入 → 英文输出 + APA）。

参与贡献

改进 prompts/ 目录中的 Prompt 是最有价值的贡献。详见 CONTRIBUTING.md。

相关文档

• Overleaf 集成指南
• 测试用例

开源协议

MIT © xiaoshuntian