ai4paper/apaper-plugin

APaper 工具

面向 Claude Code、Codex 和 OpenCode 的学术论文写作工具，以标准 MCP 配置和 Agent Skills 的形式分发。一个 install.sh 即可将工具安装到你选择的仓库中。

| 工具 | 用途 |
| --- | --- |
| apaper-mcp | 通过 MCP 进行论文研究和文献检索。 |
| writing | 修改学术文本，提供 IEEE 期刊、LaTeX 和定理陈述方面的指导。 |
| creating-figures | 出版级质量的 TikZ 和 CeTZ 图形，包括示例和渲染指导。 |

这些技能来源于 isomoes/skills。

安装

安装程序需要 Node.js 20+、npm、Bash、curl 和 tar（Linux、macOS 或 WSL）。目标仓库目录必须已存在。
运行 MCP 服务器需要 uv/uvx 和 Python 3.12+。
直接下载并运行安装程序：

curl -fsSL https://raw.githubusercontent.com/ai4paper/apaper-plugin/main/install.sh -o /tmp/apaper-install.sh
bash /tmp/apaper-install.sh

选择 Claude Code、Codex、OpenCode 或全部三者，然后选择所有组件、仅技能或仅 MCP，并输入仓库路径。多个客户端名称或编号可以用逗号分隔。在每个提示处按 Enter，即可在当前工作目录中安装 Codex 的所有组件。

或者用一条命令安装到指定仓库：

curl -fsSL https://raw.githubusercontent.com/ai4paper/apaper-plugin/main/install.sh | bash -s -- --repo /path/to/paper

使用已下载的脚本仅选择你需要的客户端：

bash /tmp/apaper-install.sh --client claude-code --repo /path/to/paper
bash /tmp/apaper-install.sh --client codex --repo /path/to/paper
bash /tmp/apaper-install.sh --client opencode --repo /path/to/paper
bash /tmp/apaper-install.sh --client claude-code,codex --repo "/path/to/my paper"

claude 和 claudecode 是 claude-code 的别名。你也可以重复使用
--client。默认客户端是 codex；--client all 会选择全部三个客户端。
使用 --only 选择要安装的组件（默认：all）：

bash /tmp/apaper-install.sh --repo /path/to/paper --only skills
bash /tmp/apaper-install.sh --repo /path/to/paper --only mcps

这些选择适用于任何已选客户端。仅安装技能会复制技能；
仅安装 MCP 会配置 MCP 服务器。非交互式运行需要 --repo。
运行 bash /tmp/apaper-install.sh --help 查看用法。在没有选项的情况下通过管道运行脚本时，如果终端可用，也支持交互式选择器。

该独立脚本会下载 GitHub 源码归档，并将其解析器依赖安装到临时文件夹中，然后在退出时删除该文件夹。无需克隆，也不会向你的论文仓库添加任何 npm 依赖。下载使用
默认使用 main；将 APAPER_REF 设置为分支、标签或提交以选择版本：

APAPER_REF= bash /tmp/apaper-install.sh --client codex --repo /path/to/paper

选择一个包含新安装器的修订版本。这些在线命令在将此更改推送到 main 后可用；更早的标签包含旧版 DSH 插件。完整的本地检出仍支持 ./install.sh 并使用其自身文件，在需要时将解析器依赖安装到该检出目录中。

客户端按需使用 uvx apaper-mcp 启动维护中的 Python MCP 服务器；首次使用需要访问 PyPI。确保 uvx 位于客户端的 PATH 中。此工具包的安装器使用 Node.js/npm。
对于 IACR PDF 下载，上游还要求 PATH 中有 Chromium 或 Scrapling 的浏览器运行时（uvx --from 'scrapling[fetchers]' scrapling install）。上游建议对这些浏览器辅助下载使用 15 分钟的 OpenCode 超时；请参阅其运行时和 MCP 设置说明。
图表编译需要技能中描述的相关 LaTeX 或 Typst 工具。

npm 发行版还以 apaper-install 的形式公开同一安装器：

npx -y --package @ai4paper/apaper-plugin apaper-install --client codex --repo /path/to/paper

此 npm 命令在包含新安装器的发行版发布后可用；更早的发行版包含旧版 DSH 插件。

安装的文件

所有路径均相对于所选仓库：

| 客户端 | MCP 配置 | 技能 |
| --- | --- | --- |
| Claude Code | .mcp.json | .claude/skills/{writing,creating-figures}/ |
| Codex | .codex/config.toml | .agents/skills/{writing,creating-figures}/ |
| OpenCode | opencode.json（或现有的 opencode.jsonc） | .agents/skills/{writing,creating-figures}/ |

Codex 和 OpenCode 共享标准的 .agents/skills 目录。每个技能都会连同所有参考文件和示例一起复制，因此安装的工具在移动或删除工具包检出后仍可使用。全局客户端设置不受影响。

安装器会添加 apaper-mcp 条目，同时保留其他服务器和设置。先前的默认 npx -y @ai4paper/apaper-mcp 启动器会迁移到 uvx apaper-mcp，并保留环境变量和其他服务器设置。
其他现有启动命令（包括固定版本）保持配置不变。
JSONC 注释和常规 TOML 格式会保留。迁移旧的 Codex 启动器会重新序列化其 TOML；原始格式/注释保留在备份中。如果 Codex 使用无法扩展的内联 mcp_servers 表，安装器会重新序列化 TOML 并报告其格式/注释已更改；原始文件已备份。

重新运行会更新打包的技能文件，并保持无关文件不变。
在覆盖任何已更改的文件之前，安装器会将其原始文件保存到
.apaper-backups//，保留其相对路径。完全相同的文件会被跳过。备份可能包含与原始配置相同的凭据。无效配置、有歧义的 OpenCode 配置（同时存在 JSON 和 JSONC）、以及符号链接目标，都会在目标文件被更改之前被拒绝。

安装完成后，在你的论文仓库中重启客户端。Claude Code 可能会要求项目 MCP 批准；Codex 仅对受信任的仓库加载项目 MCP 配置。查看客户端的 MCP 列表和技能列表以确认发现。

这些位置和格式遵循官方文档：
Claude Code MCP、
Claude Code skills、
Codex MCP、
Codex skills、
OpenCode MCP，以及
OpenCode skills。

手动安装和其他客户端

mcp/ 包含可直接合并的客户端配置示例。将 skills/ 下的两个文件夹复制到你客户端支持的技能目录中，保持每个文件夹的 SKILL.md 和支持文件在一起。
任何支持 stdio MCP 的客户端都可以使用参数 ["apaper-mcp"] 启动 uvx。

这取代了原生的 DeepSeek Harness/Cordis 打包。./dsh 导出、DSH 预设和 DSH 运行时依赖不再随附。现有的 DSH 用户可以通过客户端支持的接口保留其之前的版本，或配置 MCP 服务器和技能；install.sh 针对上述三个客户端。

要移除安装，只需从上述路径中删除 apaper-mcp 条目和两个复制的技能目录。共享的 .agents/skills 同时服务于 Codex 和 OpenCode。根据需要从 .apaper-backups 恢复任何本地自定义的文件。

开发和发布

使用 Node.js 24+ 进行 TypeScript 测试：

npm ci
npm run typecheck
npm test
npm run pack:check

npm 包随附安装程序、MCP 模板和技能。发布通过 GitHub OIDC 使用 npm 可信发布。有关发布流程，请参阅
prompt/release.md。

许可证

MIT。请参阅 LICENSE。