Doc2X 文档

简体中文

English

简体中文

English

主题

Doc2X CLI Skills 安装指南 ​

@noedgeai/doc2x-cli-skills 是 Doc2X 官方提供的 Claude Code 技能插件。安装后，在 Claude Code 中输入 /doc2x-cli，即可让 AI 自动调用 Doc2X CLI 完成 PDF 解析、文档翻译、批量处理等任务 —— 无需记忆命令与参数。

本页只介绍技能插件的安装与卸载。 CLI 工具本身的命令与参数由技能在使用时按需提供给 AI，无需用户预先学习。

前置准备 ​

技能插件本身没有运行时依赖，但它调用的 Doc2X CLI 需要：

项目要求
Node.js>= 22
Claude Code已安装
Doc2X 账号doc2x.noedgeai.com 注册
Doc2X CLI见下方安装步骤

安装 Doc2X CLI ​

CLI 工具托管在 GitHub Packages，需要先配置 registry：

bash
npm config set @noedgeai:registry=https://npm.pkg.github.com
npm i -g @noedgeai/doc2x-cli@latest

技能插件本身通过 GitHub 仓库直接安装，不需要 registry 配置；但 CLI 需要。技能在首次使用时会自动检查并引导完成上述步骤。

安装技能插件 ​

方式一：npx 一键安装（推荐） ​

bash
# 个人作用域（所有项目生效）
npx github:noedgeai/doc2x-cli-skills

# 项目作用域（仅当前项目，可与协作者共享）
npx github:noedgeai/doc2x-cli-skills --project

脚本会将技能文件复制到：

  • 个人作用域：~/.claude/skills/doc2x-cli
  • 项目作用域：.claude/skills/doc2x-cli

方式二：手动安装 ​

bash
git clone https://github.com/noedgeai/doc2x-cli-skills.git
cd doc2x-cli-skills

# 个人作用域
cp -r skills/doc2x-cli ~/.claude/skills/doc2x-cli

# 项目作用域
cp -r skills/doc2x-cli .claude/skills/doc2x-cli

方式三：Codex CLI / 其他 Agent ​

bash
git clone https://github.com/noedgeai/doc2x-cli-skills.git
cd doc2x-cli-skills

# 用户作用域
cp -r skills/doc2x-cli ~/.agents/skills/doc2x-cli

# 仓库作用域
cp -r skills/doc2x-cli .agents/skills/doc2x-cli

验证 ​

在 Claude Code 中输入 /doc2x-cli，应能在自动补全中看到该技能。

text
/doc2x-cli

然后用自然语言告诉它你的需求即可，例如：

  • "把 paper.pdf 解析为 Markdown"
  • "批量翻译 ./docs 下的 PDF 为英文"
  • "生成 paper.pdf 的中英双语 PDF"

AI 会自动选择正确的 doc2x 命令和参数。

卸载 ​

bash
# Claude Code
rm -rf ~/.claude/skills/doc2x-cli    # 个人作用域
rm -rf .claude/skills/doc2x-cli      # 项目作用域

# Codex / Agents 标准
rm -rf ~/.agents/skills/doc2x-cli    # 用户作用域
rm -rf .agents/skills/doc2x-cli      # 仓库作用域

如需同时卸载 CLI 工具：

bash
npm uninstall -g @noedgeai/doc2x-cli

常见问题 ​

Q: 安装 CLI 时提示 404？ ​

A: 未配置 GitHub Packages registry。运行：

bash
npm config set @noedgeai:registry=https://npm.pkg.github.com

Q: command not found: doc2x？ ​

A: npm 全局 bin 目录未加入 PATH。运行 npm config get prefix，将输出路径下的 bin 目录加入 PATH。

Q: 输入 /doc2x-cli 没有出现？ ​

A: 检查 ~/.claude/skills/doc2x-cli/SKILL.md 是否存在，重启 Claude Code。

Q: Node 版本过低？ ​

A: 要求 Node >= 22。使用 nvm 升级：nvm install 22 && nvm use 22。