Doc2X CLI Skills 安装指南

@noedgeai/doc2x-cli-skills 是 Doc2X 官方提供的 Agent Skills 插件。安装到支持 Skills 的 AI Agent 后，对话中提到 Doc2X、doc2x-cli、PDF 解析、文档翻译或批量处理等需求时，Agent 可依据技能说明选择 CLI 工作流。真实解析/翻译仍需有效登录、额度和用户授权，不能保证自动选择一定正确。

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

前置准备

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

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

安装 Doc2X CLI

当前公开 CLI 包为 @noedgeai-org/doc2x-cli；以下固定到本教程核对的 0.2.0，无需旧的 GitHub Packages registry：

npm i -g @noedgeai-org/doc2x-cli@0.2.0

技能插件与 CLI 是两个安装对象。插件包含工作流说明，不会自动证明 CLI 已安装、账户已登录或业务任务已授权。

安装技能插件

方式一：Claude Code npx 一键安装

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

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

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

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

方式二：手动安装

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

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

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

方式三：Codex CLI / 其他 Agent

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

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

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

验证

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

doc2x-cli
Doc2X
PDF to Markdown

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

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

先让 Agent 说明拟用的命令、输入与输出目录。确认文件和范围后再执行；解析/翻译会消耗相应额度。失败时优先查回执中的原任务 ID，避免重复提交。

卸载

# 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 工具：

npm uninstall -g @noedgeai-org/doc2x-cli

常见问题

Q: 安装 CLI 时提示 404？

A: 确认包名是 @noedgeai-org/doc2x-cli，检查 npm registry 与网络访问。不要再用旧的 @noedgeai/doc2x-cli 安装命令，也不要为排错公开认证信息。

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。

相关链接

• 技能仓库：github.com/noedgeai/doc2x-cli-skills
• Doc2X 官网：doc2x.noedgeai.com
• Agent Skills 标准：agentskills.io
• 联系我们：联系方式

首次使用后的检查

doc2x --version
doc2x account status --json
doc2x batch parse ./docs --glob "**/*.pdf" --dry-run --json

版本检查与 dry-run 不解析文件；账户查询需要登录并访问服务。确认 Agent 能看到技能、CLI 版本符合本教程，并核对 dry-run 文件清单。需要登录时按CLI 鉴权操作；--no-browser 仍需浏览器回调运行 CLI 的电脑。

实际运行后查看输出路径、回执与文件内容；Skill 安装截图或命令退出不能代替结果核对。0.2.0 的账户、回执、任务历史与 Zotero 清单见CLI 教程。Zotero manifest 不直接写文献库。