命令行工具

你不需要学命令行

把下面这段话发给 Claude Code、Codex、OpenCode 等 AI Agent，它们会自动安装、登录、校对——你只需要跟着提示点几下鼠标。

你的电脑系统：

🤖 发给桌面 AI支持 Claude Code · Codex · OpenCode 等
帮我在电脑上安装黑猫校对（heimao）命令行工具，安装后登录并校对书稿。 安装： 1. 访问 https://heimaojiaodui.com/cli/version.json 获取最新版本号、下载地址和 SHA-256 2. 根据我的系统（macOS）下载对应二进制包，校验 SHA-256 3. 解压，将 heimao 放到 ~/.local/bin/，chmod +x，加入 PATH 4. 运行 heimao --version 确认安装成功 使用： 1. heimao login —— 浏览器弹窗授权登录 2. heimao proofread 书稿文件 -y —— 校对书稿（-y 跳过确认） 3. Word 打开生成的「书稿-审阅.docx」逐条审阅建议 出错把终端输出发我。
复制上面这段话，粘贴到桌面 AI 对话框中发送

AI 收到后会这样帮你

你只需要同意或点"是"，具体操作 Agent 全包

1

Agent 分步安装（可审查，非管道执行）

Agent 会先访问 heimaojiaodui.com 验证网站真实性，然后从 version.json 获取下载地址和 SHA-256，下载二进制、校验哈希、放到 PATH。

终端
$ curl -s https://heimaojiaodui.com/cli/version.json
{
"version": "0.2.0",
"darwin_arm64": {
"url": "https://...cos.../cli/heimao-darwin-arm64.tar.gz",
"sha256": "488d902f..."
}
}
$ curl -sL "$url" -o heimao.tar.gz
$ shasum -a 256 heimao.tar.gz # 比对 SHA-256
$ tar -xzf heimao.tar.gz && cp heimao ~/.local/bin/ && chmod +x ~/.local/bin/heimao
$ heimao --version
heimao 0.2.0
✓ 安装成功！
2

Agent 运行登录，你点"授权"

Agent 执行 heimao login， 浏览器会自动弹出授权页——你只需要点击「授权登录」。

终端
$ heimao login
连接 https://heimaojiaodui.com …
请在浏览器中确认登录
┌─────────────┐
│ ABCD-EFGH │
└─────────────┘
✓ 已登录 bob@example.com，余额 9,500,000 字
3

Agent 提示安装成功，你把文件拖给它

安装和登录完成后，Agent 会告诉你准备好了。你只需要把书稿文件拖到 Agent 对话框里（或告诉它文件路径）， Agent 就会运行 heimao proofread 开始校对。

终端
✓ 安装成功！版本：heimao 0.2.0
✓ 已登录 bob@example.com
Agent：已准备好，请把要校对的书稿文件发给我。
你：（拖入 书稿.docx）
Agent：收到，开始校对…
$ heimao proofread 书稿.docx -y
4

Agent 校对书稿，Word 打开审阅

校对完成后，在同目录生成「书稿-审阅.docx」。用 Word 打开即可逐条审阅 AI 的修改建议。

终端
$ heimao proofread 书稿.docx -y
上传 书稿.docx（123,456 字节）…
字数：45,000 将扣：45,000 字　当前余额：9,500,000 字
任务已创建（T-XXXXXXXX），扣费 45,000 字。
校对中… COMPLETED 45/45
✓ 完成：书稿-审阅.docx
剩余余额：9,455,000 字
▸想自己敲命令？这里是完整的命令参考

安装

curl -fsSL https://heimaojiaodui.com/cli/install.sh | bash

常用命令

heimao login登录账号（浏览器授权）
heimao proofread 文件 -y校对单个文档（-y 跳过确认）
heimao balance查看字数余额
heimao recharge充值字数
heimao batch 目录/批量校对目录下所有文件
heimao pull 目录/拉取批量任务结果
heimao upgrade升级到最新版本
heimao --help查看所有命令
▸常见问题

AI 拒绝执行安装命令怎么办？

试试把安装步骤拆开让它执行——先下载，再校验，再解压。每一步都可审查，AI 通常会接受。

我没有任何编程经验，能用吗？

完全可以。把上面那段话复制粘贴给 Claude Code、Codex、OpenCode 等 AI Agent，它会自动完成所有操作。你只需要点"同意"或"授权"。

我需要什么 AI 工具？

推荐 Claude Code、Codex、OpenCode 等 AI Agent，能操作电脑、自动执行命令。

Agent 会不会搞坏我的电脑？

不会。heimao 只做三件事：安装自己、登录账号、上传文件并下载校对结果。不修改系统配置，不访问其他文件。你可以随时让 Agent 解释每一步在做什么。

校对需要多久？

取决于书稿字数。一般 5 万字约 2-5 分钟。大书稿可用 batch 命令异步提交，后台校对，随时拉取结果。

如何充值？

运行 heimao recharge，终端会显示支付链接或二维码，微信/支付宝扫码即可，到账后余额自动更新。