BookwormPRO 安装指南

完整安装指南

从全新电脑到正常使用的每一步

0 前置条件

依赖	要求	自动安装?	手动安装
Git	任意版本	否 (必须预装)	`winget install Git.Git`
Python	3.12+	是 (via uv)	`winget install Python.Python.3.12`
Node.js	v22 LTS	是	`winget install OpenJS.NodeJS.LTS`
uv	latest	是	`irm astral.sh/uv/install.ps1 \| iex`
ripgrep	任意	是	`winget install BurntSushi.ripgrep.MSVC`
ffmpeg	任意	是	`winget install Gyan.FFmpeg`
API Key	任一 AI 服务	否	推荐 DeepSeek (支付宝充值, 1 元起)

只有 Git 和 API Key 需要提前准备，其余依赖安装脚本会自动处理。

1 选择安装方式

1 安装 Git (如未安装)

打开 PowerShell (按 Win+X 选择 "终端")，执行：

winget install Git.Git
# 安装完成后关闭并重新打开 PowerShell

2 一键安装 BookwormPRO

在 PowerShell 中执行：

irm https://raw.githubusercontent.com/huakoh/bookwormpro-sale/master/scripts/install.ps1 | iex

安装脚本会自动完成：

安装 uv (Python 包管理器) + Python 3.12
安装 Node.js v22 + ripgrep + ffmpeg
克隆 BookwormPRO 到 %LOCALAPPDATA%\bookworm\
创建虚拟环境并安装所有依赖
添加 PATH 环境变量
启动配置向导

3 重启终端

安装完成后关闭并重新打开 PowerShell，使 PATH 生效。

# 验证安装
bookworm version
BookwormPRO v7.0.0

1 安装 WSL2 (仅 Windows 用户)

# 管理员 PowerShell
wsl --install
# 重启电脑，然后打开 Ubuntu 终端

2 一键安装

curl -fsSL https://raw.githubusercontent.com/huakoh/bookwormpro-sale/master/scripts/install.sh | bash

macOS / Linux 原生用户同样执行此命令。

3 加载环境

source ~/.bashrc
bookworm version

1 克隆仓库

git clone https://github.com/huakoh/bookwormpro-sale.git
cd BookwormPRO

2 配置主机桥接

# Windows
.\scripts\setup-host-bridge.ps1

# Linux / macOS
bash scripts/setup-host-bridge.sh

3 启动容器

docker compose up -d --build
# 首次构建约 3-5 分钟

# 查看日志
docker compose logs -f bookworm

2 配置向导

安装脚本会自动启动配置向导。也可以手动运行：bookworm setup

选择 AI Provider

向导会列出所有支持的 AI 服务商。推荐选择：

源力AI 中转站官方推荐

一个 Key 调用 GPT-4o / Claude / DeepSeek / Gemini 全系列。注册 bww.letcareme.com，OpenAI 兼容格式，无需翻墙。

DeepSeek 性价比首选

OpenRouter

200+ 模型一站式接入。注册 openrouter.ai，需国际信用卡。

GitHub Copilot

已有 Copilot 订阅？直接通过 gh auth login 认证，无需 API Key。

源力AI 中转站配置方法

运行 bookworm setup model 时选择 "Custom endpoint"，然后填入：

# Base URL
https://bww.letcareme.com/v1

# API Key (在 bww.letcareme.com 注册后获取)
sk-your-yuanforce-api-key

或直接编辑 ~/.bookwormpro/.env：

OPENAI_BASE_URL=https://bww.letcareme.com/v1
OPENAI_API_KEY=sk-your-yuanforce-api-key

配置完成后，BookwormPRO 会自动通过源力AI 中转站调用各家模型，国内直连无需代理。

# 向导子命令 (可单独运行)
bookworm setup model      # 只配置 AI 模型
bookworm setup gateway    # 只配置消息平台
bookworm setup tools      # 只配置工具 (TTS/搜索/图片生成)
bookworm setup --quick    # 快速模式 (只填必要项, 30 秒完成)

3 首次使用

启动对话

bookworm              # 经典 CLI 模式
bookworm --tui         # 现代 TUI (鼠标支持/模态窗口)
bookworm --continue    # 继续上次会话

进入对话后，试试这些命令：

/help                  # 查看所有命令
/model                 # 切换 AI 模型
/tools                 # 查看可用工具
/new                   # 开始新会话

4 Gateway 多平台部署可选

Gateway 让你通过微信、Telegram、Discord、Slack 等 15+ 平台与 AI 对话。

配置并启动

bookworm gateway setup    # 交互式配置 (选择平台、填 Token)
bookworm gateway start    # 后台启动
bookworm gateway status   # 检查状态

支持的平台：

TelegramDiscordSlack 微信企业微信钉钉飞书WhatsAppSignal MatrixEmailSMS QQ BotHome AssistantWebhook API

OpenAI 兼容 API 高级

Gateway 内置 OpenAI 兼容 API 服务，任何支持 OpenAI 格式的前端都能接入：

# 启动后自动监听 http://localhost:8642/v1
# 兼容 Open WebUI / LobeChat / NextChat / ChatBox 等

# 测试连通
curl http://localhost:8642/health
curl http://localhost:8642/v1/models

5 验证安装

运行诊断

# 快速烟雾测试 (无网络)
bookworm canary

# 含 API 连通验证
bookworm canary --live

# 完整诊断报告
bookworm doctor

# 查看系统状态
bookworm status --deep

6 故障排查

`bookworm: command not found`

关闭并重新打开终端。如果仍然不行，手动添加 PATH：
Windows: $env:PATH += ";$env:LOCALAPPDATA\bookworm\bookwormpro\venv\Scripts"
Linux: export PATH="$HOME/.bookwormpro/bookwormpro/venv/bin:$PATH"

AI 回复为空或报错

重新运行 bookworm setup model 检查 Provider 和 API Key 配置。
运行 bookworm doctor 查看详细诊断。

Gateway 启动后平台无响应

运行 bookworm gateway status 检查各平台连接状态。
重新运行 bookworm gateway setup 更新 Token。

已有旧版本，想重新安装

先运行 bookworm uninstall 卸载旧版，然后重新按安装指南操作。
如果旧版本太早没有 uninstall 命令，手动清理：
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\bookworm","$HOME\.bookwormpro","$HOME\.hermes" -ErrorAction SilentlyContinue

Python/Node 版本冲突

BookwormPRO 使用独立虚拟环境，不影响系统 Python。
如遇冲突，删除 %LOCALAPPDATA%\bookworm\bookwormpro\venv 目录后重新安装。

装完立刻能做什么

不需要记技能名，正常对话即可 — AI 自动匹配最合适的专家

🛡

安全审查 — 说"审查这个项目安全性"

AI 自动调用安全技能组合：OWASP Top 10 扫描、注入检测、凭证泄漏检查、依赖供应链审计、权限模型验证。一份命令，全面报告。

🎨

前端设计 — 说"设计一个登录页"

不是千篇一律的 AI 模板。多种设计风格、配色方案和字体组合可选。出来的代码直接可用，暗色主题、响应式、无障碍全到位。

📊

数据分析 — 说"分析这份 CSV"

AI 自动启动 Jupyter 内核，跑 Pandas/Matplotlib，出图表出结论。不懂 Python？没问题，你用中文描述需求，AI 写代码跑结果。

🤖

多 Agent 协作 — 复杂任务自动拆分

超过 3 个领域的任务自动激活编排器：拆成子任务 → 并行分派给不同专家 Agent → 汇总结果。

技能领域一览

300+ 技能覆盖开发、安全、运维、设计、商业等领域

🖥

软件开发

通用开发、调试侦探、代码审查、重构专家

🛡

安全审计

OWASP、红队对抗、凭证守护、零缺陷门控

🚀

DevOps

Docker、SSL 证书、网关加固、CI/CD

🎨

创意设计

UI/UX 设计、信息图、架构图

📊

数据科学

数据分析、机器学习、学术论文

🤖

AI/ML

模型微调、推理部署、提示词优化

💰

商业财经

商业计划书、定价策略、财务顾问

📱

移动开发

React Native、Flutter、微信小程序

免费试用 7 天

无需注册，无需信用卡 — 一行命令解锁 300+ 全部技能，体验 7 天

1 安装 BookwormPRO

# Windows PowerShell
irm https://raw.githubusercontent.com/huakoh/bookwormpro-sale/master/scripts/install.ps1 | iex

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/huakoh/bookwormpro-sale/master/scripts/install.sh | bash

2 一键激活试用

bookworm trial
# ┌──────────── 7-Day Free Trial ────────────┐
# │ Trial activated!                         │
# │   Tier:      trial                       │
# │   Expires:   2026-05-19                  │
# └──────────────────────────────────────────┘

3 开始使用

bookworm    # 进入对话，300+ 技能自动匹配

试用到期后技能将锁定。升级为个人版即可解锁全部技能 (按年订阅)。
每台机器仅可试用一次 (HWID 绑定)。

激活 License

购买后收到 .license 文件，3 步完成激活

1 获取机器指纹 (HWID)

首次激活需要采集机器硬件指纹，用于绑定 License。

bookworm license hwid
# 输出: Machine HWID: 24afab...4ac71c
# 将此 HWID 发送给客服，客服据此生成专属 License

2 激活 License 文件

收到客服发来的 .license 文件后，一行命令激活。

bookworm activate /path/to/your.license
# ┌─────────── Activation Successful ───────────┐
# │ License activated                           │
# │   Licensee:  Your Company                   │
# │   Tier:      pro                            │
# │   Expires:   2027-06-01                     │
# └─────────────────────────────────────────────┘

3 验证激活状态

bookworm license status
# ┌────────────── License Status ──────────────┐
# │   Status:    VALID                         │
# │   Licensee:  Your Company                  │
# │   Tier:      pro                           │
# │   Expires:   2027-06-01                    │
# └────────────────────────────────────────────┘

License 管理命令

查看状态

bookworm license status

查看当前 License 有效性、到期时间、绑定信息。

查看机器指纹

bookworm license hwid

显示当前机器 HWID。更换机器后需重新绑定。

移除 License

bookworm license deactivate

从本机移除已安装的 License 文件。

版本更新

bookworm update

更新到最新版本。License 和配置不受影响。

获取 BookwormPRO

HWID 机器绑定 · Ed25519 签名授权 · 质量保障退款

个人版

BookwormPRO

¥299

/年 (续费 ¥210/年)

✓ 300+ 全部技能 解锁
✓ CLI + TUI + Gateway 全平台
✓ 单机 HWID License 绑定
✓ 每周同步国际社区更新
✓ 安装诊断 + 智能路由
✓ 48 小时邮件支持
✓ 质量问题 7 天退款 (详情)
✓ 一键版本更新 (bookworm update)

团队 / 企业

面议

按机器数量授权

✓ 个人版全部功能
✓ 多机 License (每台独立 HWID 签发)
✓ 团队人数阶梯折扣
✓ 优先邮件技术支持
✓ 发票 + 合同

QQ 扫码联系客服

1. 先按安装指南部署 BookwormPRO

2. 运行 bookworm license hwid 获取机器指纹

3. QQ 扫码联系客服，发送 HWID + 选择套餐 + 支付

4. 收到 .license 文件后 bookworm activate 激活

常见问题

安装与使用

需要什么前置条件?

只需要 Git 和一个 AI API Key。推荐 DeepSeek (platform.deepseek.com，支付宝充值 1 元起)。安装脚本自动处理 Python、Node.js 等其他依赖。

支持哪些 AI 助手?

所有兼容 Skills 协议的 AI 编程助手：Claude Code、Cursor、Windsurf 等。同时内置独立 CLI / TUI 客户端和 Gateway 多平台服务。

和直接问 AI 有什么区别?

AI 本身是通用模型。BookwormPRO 给它加载了 300+ 个专家级的提示词和工作流程。同样的 AI，加载技能后输出的代码质量、安全审查深度、设计水平显著提升。

怎么更新?

运行 bookworm update 即可。更新不丢失你的 API Key、License 和个人配置。

License 与激活

HWID mismatch 怎么办?

License 绑定的机器与当前机器不同。运行 bookworm license hwid 获取新 HWID 联系客服重新绑定。更换电脑、重装系统、更换网卡都可能导致 HWID 变化。

License expired 怎么办?

联系客服续费 (续费 ¥210/年，7 折)。收到新 .license 文件后重新 bookworm activate 即可。

可以在多台机器上使用吗?

个人版绑定单台机器 (HWID)。多台机器使用请联系客服获取团队/企业多机授权方案。

Skills 列表为空?

可能 License 未激活或已过期。运行 bookworm license status 检查。加密技能需要有效 License 解锁。

安全与支付

我的 API Key 安全吗?

Key 只存储在本地 ~/.bookwormpro/.env 文件，不上传任何服务器。技能文件采用 AES-256-GCM 加密，License 采用 Ed25519 数字签名，防篡改防拷贝。

可以开发票吗?

可以。提供电子普通发票。联系客服告知开票信息即可。

退款怎么操作?

2 小时内未下载可全额退款；下载后如遇文件损坏等质量问题，7 天内可退款或免费更换。详见服务条款第四条。