论文写作助手 ai4paper/apaper-plugin

APaper 插件

面向 Codex 和 OpenCode V2 的学术论文写作工具：通过 MCP 进行文献研究、学术写作，以及出版级质量的图表。

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

这些技能源自 isomoes/skills。

要求： 客户端 PATH 中需有 uvx 和 Python 3.12+ 以运行 apaper-mcp （首次启动时从 PyPI 下载），以及 LaTeX 或 Typst 以编译图表。

Codex

codex plugin marketplace add ai4paper/apaper-plugin
codex plugin add apaper-plugin@ai4paper

重启 Codex，并在你的论文仓库中开启一个新线程。试试：

- “使用 APaper 为我的研究主题查找相关论文。”
- “使用 APaper 修改这段摘要，使其更清晰、更精确。”
- “使用 APaper 为这个方法创建一张 TikZ 架构图。”

其他任务：

- 更新： codex plugin marketplace upgrade ai4paper，然后重新运行 codex plugin add apaper-plugin@ai4paper。
- 卸载： codex plugin remove apaper-plugin@ai4paper。
- 本地检出： 改为在本仓库中运行 codex plugin marketplace add .。切换来源前先运行 codex plugin marketplace remove ai4paper。
- 从旧安装器迁移： 从 .codex/config.toml 中删除其 apaper-mcp 条目，并删除已复制的 .agents/skills/{writing,creating-figures}，以避免重复加载 APaper。

OpenCode

对于单个论文仓库，将 APaper 添加到其 opencode.json 或 .opencode/opencode.json。OpenCode 会在下次启动时安装它：

{
"$schema": "https://opencode.ai/config.json",
"plugins": ["@ai4paper/apaper-plugin"]
}

若要对所有项目生效，请全局安装：

opencode plugin add @ai4paper/apaper-plugin

- 更新： 对于全局安装，运行 opencode plugin update @ai4paper/apaper-plugin；对于某个仓库，请固定版本，例如 "@ai4paper/apaper-plugin@0.4.0"。
- 本地检出： 使用 "/path/to/apaper-plugin/opencode" 作为 plugins 条目。
- 已有配置： 你自己的 apaper-mcp 服务器或同名技能优先；删除手动副本以使用捆绑版本。

其他客户端

将 mcp/ 中的示例合并到你的客户端配置中，并将 skills/ 下的文件夹复制到其技能目录中，保持每个文件夹完整。任何 stdio MCP 客户端都可以运行 uvx apaper-mcp。

开发

使用 Node.js 24+：

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

npm 包包含 Codex 清单（.codex-plugin/、
.mcp.json）、OpenCode 入口点（opencode/index.js）、MCP 模板和技能。保持 .codex-plugin/plugin.json、package.json 和 package-lock.json 中的版本一致。发布通过 npm 可信发布进行；参见 prompt/release.md。

许可证

MIT。参见 LICENSE。