Skip to content

installation.md

Latest commit

 

History

History
136 lines (92 loc) · 3.97 KB

installation.md

File metadata and controls

136 lines (92 loc) · 3.97 KB
Raw

PaperRefine 安装、更新与迁移

PaperRefine 的 Codex 与 Claude Code 插件包含同一份核心 Skill。优先使用插件安装；只有需要直接检查或修改 Skill 文件时，才使用手动目录安装。

Codex 插件安装

要求：Codex CLI 支持 codex plugin 命令。

codex plugin marketplace add wp-a/paper-refine
codex plugin add paper-refine@paper-refine

安装后重新打开一个 Codex 任务，然后输入：

使用 $paper-refine 润色这段英文论文，保留所有数字和引用。

Claude Code 插件安装

claude plugin marketplace add wp-a/paper-refine
claude plugin install paper-refine@paper-refine

安装为 Claude Code 插件后，使用插件命名空间显式调用：

/paper-refine:paper-refine 润色这段英文论文，保留所有数字和引用。

Codex 的 $paper-refine 与 Claude Code 插件的 /paper-refine:paper-refine 是两套平台原生语法。自然语言是否自动选择 Skill 取决于模型和运行模式，不应作为安装验证标准。

Codex 手动 Skill 安装

如果不使用插件，将仓库克隆到临时位置，再复制核心文件：

git clone https://github.com/wp-a/paper-refine.git
mkdir -p ~/.codex/skills/paper-refine/references
cp paper-refine/SKILL.md ~/.codex/skills/paper-refine/SKILL.md
cp -R paper-refine/references/. ~/.codex/skills/paper-refine/references/

Codex 的目标目录必须是 ~/.codex/skills/paper-refine，并同时包含 SKILL.md 和整个 references/ 目录。

Claude Code 手动 Skill 安装

全局安装：

mkdir -p ~/.claude/skills/paper-refine/references
cp paper-refine/SKILL.md ~/.claude/skills/paper-refine/SKILL.md
cp -R paper-refine/references/. ~/.claude/skills/paper-refine/references/

仅当前项目使用：

mkdir -p .claude/skills/paper-refine/references
cp /path/to/paper-refine/SKILL.md .claude/skills/paper-refine/SKILL.md
cp -R /path/to/paper-refine/references/. .claude/skills/paper-refine/references/

项目内目标目录是 .claude/skills/paper-refine。不要只复制 SKILL.md，否则六份按需参考无法加载。

手动安装到 ~/.claude/skills 或 .claude/skills 时，Skill 不带插件命名空间，使用 /paper-refine 调用。

从 nature-polishing 迁移

旧的 nature-polishing 与新的 paper-refine 触发范围重叠。先安装并验证 PaperRefine，再删除旧 Skill，避免两个 Skill 同时响应。

Codex 旧目录通常是：

~/.codex/skills/nature-polishing

Claude Code 旧目录通常是：

~/.claude/skills/nature-polishing
.claude/skills/nature-polishing

确认 PaperRefine 可以被发现后，再手动删除对应旧目录。本仓库不会自动删除用户的旧安装。

更新

Codex 插件：

codex plugin marketplace upgrade paper-refine
codex plugin remove paper-refine@paper-refine
codex plugin add paper-refine@paper-refine

Claude Code 插件：

claude plugin marketplace update paper-refine
claude plugin uninstall paper-refine@paper-refine
claude plugin install paper-refine@paper-refine

手动 Skill 安装需要重新拉取仓库，并再次复制 SKILL.md 与整个 references/ 目录。

卸载

Codex 插件：

codex plugin remove paper-refine@paper-refine
codex plugin marketplace remove paper-refine

Claude Code 插件：

claude plugin uninstall paper-refine@paper-refine
claude plugin marketplace remove paper-refine

手动安装则删除对应的 paper-refine Skill 目录。删除前检查目录内是否有自行修改的文件。

验证

  1. 在一个新任务中要求润色一段已有学术文本。
  2. 确认结果依次包含 Refined text 和 Why it is better。
  3. 加入数字、限定词或 LaTeX 引用键，确认前后保持不变。
  4. 输入“从零写整篇论文”或“搜索文献”，确认 PaperRefine 不接管这些任务。

如需验证仓库本身，参考维护说明。