Doc2X 文档

简体中文

English

简体中文

English

主题

Doc2X CLI Skills 安装指南 ​

@noedgeai/doc2x-cli-skills 是 Doc2X 官方提供的 Agent Skills 插件。安装到支持 Skills 的 AI Agent 后，对话中提到 Doc2X、doc2x-cli、PDF 解析、文档翻译或批量处理等需求时，AI 即可自动调用 Doc2X CLI 完成任务 —— 无需记忆命令与参数。

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

前置准备 ​

技能插件本身没有运行时依赖；使用技能需要一个支持 Agent Skills 的 AI Agent。它调用的 Doc2X CLI 需要：

项目要求
Node.js>= 22
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 需要。技能在首次使用时会自动检查并引导完成上述步骤。

安装技能插件 ​

方式一：Claude Code 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

验证 ​

确认目标目录中存在 doc2x-cli/SKILL.md，必要时重启对应 Agent 客户端。

text
doc2x-cli
Doc2X
PDF to Markdown

然后在对话中提到 doc2x-cli、Doc2X 或 PDF 处理需求，例如：

  • "把 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: 技能没有被自动加载？ ​

A: 检查对应 Agent 的 skills 目录中是否存在 doc2x-cli/SKILL.md，并重启客户端。Claude Code 默认目录是 ~/.claude/skills/doc2x-cli，Codex / Agents 标准目录是 ~/.agents/skills/doc2x-cli。

Q: Node 版本过低？ ​

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