Bookworm Portable - 保姆式安装手册

整体流程概览

最快方式：一键安装器

获取 Bookworm-Setup.bat (4KB) → 双击运行 → 输入密码 → 完成

安装器自动检测依赖、下载配置、创建桌面快捷方式、启动 Claude Code

手动安装流程：

安装依赖
Node.js + Git

➔

安装 Claude Code
npm 全局安装

➔

双击安装器
或 git clone

➔

输入密码
主密码

➔

开始使用
Bookworm 激活

首次安装约 10 分钟（含依赖下载），之后每次双击启动约 10-30 秒

1安装依赖软件

⚠

国内必须：代理/VPN 软件
Claude Code 启动时会检查 api.anthropic.com，国内无法直连。
请先安装并启动代理软件（Clash / V2Ray / 快柠檬 / 任意 VPN），安装脚本会自动检测系统代理。
无代理 = Claude Code 无法启动。

💡

中转站不走代理
API 中转站 bww.letcareme.com 部署在国内阿里云，不需要通过代理访问。
安装脚本已自动设置 NO_PROXY=bww.letcareme.com,code.letcareme.com，无需手动配置。
如果代理软件有"绕过规则"设置，建议把 *.letcareme.com 加入直连列表。

需要安装以下软件。如果已装过可跳到下一步。

A

安装 Node.js（必须）

去官网下载 LTS 版本安装包，双击安装，一路 Next 即可。

方式一：官网下载（推荐）

打开浏览器访问 https://nodejs.org，点击绿色的 "LTS 推荐" 按钮下载，双击 .msi 文件安装，全部默认 Next。

方式二：PowerShell 命令安装

右键开始菜单 → 选择 "PowerShell (管理员)" 或 "终端 (管理员)"，然后执行：

      PowerShell (管理员)
      # 下载 Node.js 安装包
Invoke-WebRequest -Uri "https://nodejs.org/dist/v22.15.0/node-v22.15.0-x64.msi" -OutFile "$env:TEMP\node-install.msi"

# 运行安装（会弹出安装向导，一路 Next）
Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait
    

⚠

安装完成后必须重开 PowerShell！
关闭当前 PowerShell 窗口，重新打开一个新的，否则 node 和 npm 命令找不到。

验证安装成功：

      node -v    # 应显示 v22.x.x
npm -v     # 应显示 10.x.x
    

如果 npm 报 "执行策略" 错误？ 执行以下命令后重试：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
提示确认时输入 Y 回车。

B

安装 Git（必须）

去官网下载安装，全部默认设置即可。

打开 https://git-scm.com/download/win，下载 "64-bit Git for Windows Setup"，双击安装，全部 Next。

验证：

git --version # 应显示 git version 2.x.x

C

安装 PowerShell 7（推荐）

Windows 自带的 PowerShell 5.1 有中文兼容问题，建议升级到 7。

      PowerShell (管理员)
      winget install Microsoft.PowerShell
    

如果没有 winget，去 GitHub Releases 下载 .msi 安装包。安装后用 pwsh 命令启动新版 PowerShell。

2安装 Claude Code

1

全局安装

在 PowerShell 中执行（不需要管理员权限）：

npm i -g @anthropic-ai/claude-code

安装过程需要几分钟，等待完成即可。

2

验证安装

claude --version # 应显示版本号

💡

不需要登录 Claude 账号！
Bookworm 使用中转站 API，安装 Claude Code 后直接进入下一步，不用执行 claude login。

3安装 Bookworm（核心步骤）

1

克隆引导仓库

在 PowerShell 中执行以下命令。系统会提示输入用户名和密码。

      git clone https://code.letcareme.com/bookworm/bookworm-boot.git
cd bookworm-boot
    

弹出用户名密码？ 输入管理员提供给你的 Gitea 账号密码。这是 Gitea 的密码，不是主密码。

2

双击运行安装脚本

双击文件夹里的 更新并启动Bookworm.bat，脚本会自动完成所有配置。

或者用命令行运行

如果双击 .bat 不起作用，在 PowerShell 中手动执行：

pwsh -ExecutionPolicy Bypass -File install.ps1

没有 pwsh 可用 powershell 替代。

3

输入主密码

脚本会提示 "输入主密码解密凭证"，输入管理员提供的主密码（不是 Gitea 密码），按回车。

密码输入时不显示字符，这是正常的。输错了可以重试，最多 3 次。

两个密码不要搞混：
Gitea 密码 = 克隆仓库时输入的，用于下载文件
主密码 = 解密 API 凭证时输入的，用于启动 Claude Code

4

等待完成

脚本会显示步骤进度 [1/9] 到 [9/9]，自动完成：

[1/9] 前置检查 (Claude Code / Node.js / Git)
[2/9] 自动检测代理 + 设置 NO_PROXY
[3/9] 解密凭证 (输入主密码)
[4/9] 同步配置 (下载专家技能库)
[5/9] 完整性校验 (SHA256 哈希验证)
[6/9] 渲染配置模板
[7/9] 初始化本地目录
[8/9] Bookworm 系统验证 + MCP 检查
[9/9] 启动 Claude Code

✓

看到 "Bookworm 就绪" 绿色横幅就说明成功了！
Claude Code 启动后，脚本会验证配置完整性，全部 [OK] 后进入 Bookworm 模式。
所有 API 请求通过中转站转发，不需要自己的 Claude 账号。

⚠

看到 "原生模式启动" 黄色横幅？
说明 Bookworm 配置不完整。请不加 -StartOnly 重新运行安装脚本，或联系管理员。

4日常使用

方法一：双击 .bat 文件（推荐，最简单）

bookworm-boot 文件夹里有两个 .bat 文件：

文件	作用	适用场景
启动Bookworm.bat	快速启动，不更新配置	每天日常使用
更新并启动Bookworm.bat	先同步最新 Skills 再启动	管理员通知有更新时

双击即可，无需打开 PowerShell，无需记命令。脚本会自动检测 PowerShell 7/5.1。

💡

启动时显示 "有新更新可用"？
说明管理员推送了更新。双击 更新并启动Bookworm.bat 即可同步。

方法二：命令行（备用）

如果 .bat 文件无法运行，在 PowerShell 中手动执行：

      # 快速启动
cd bookworm-boot
pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly

# 同步更新后启动
cd bookworm-boot
pwsh -ExecutionPolicy Bypass -File install.ps1
    

5密码说明

本系统有两个密码，不要搞混

名称	用途	何时输入
Gitea 密码	下载文件（克隆仓库）	首次安装时 git 弹出要求
主密码	解密 API 凭证	每次启动脚本提示输入

💡

密码输错了？ 最多可以重试 3 次，不用紧张。3 次都错才会退出。

本日免密功能

首次解密成功后，脚本会询问 "今日内免密启动? (y/n)"

选 y 后，当天再次启动无需输入主密码，次日自动过期。

凭证缓存在 Windows Credential Manager 中（DPAPI 加密，仅当前用户可读）。

🔒

主密码无法找回 — 忘记后联系管理员重新生成 secrets.enc。

6使用完毕 — 清理 / 卸载

最简单：双击卸载Bookworm.bat

bookworm-boot 文件夹里的 卸载Bookworm.bat，双击即可一键完整卸载：终止进程 + 清除凭证 + 恢复原始配置 + 删除桌面快捷方式。

或者用命令行精细控制：

场景	命令	说明
基础清理	`pwsh -File stop.ps1`	清除环境变量，保留配置供下次快速启动
完整恢复	`pwsh -File stop.ps1 -Restore`	删除 Bookworm，恢复电脑原始状态
深度清理	`pwsh -File stop.ps1 -Restore -Deep`	完整恢复 + 清除历史 + 清除 Git/凭证缓存

⚠

在他人电脑/公用电脑上务必卸载：
双击 卸载Bookworm.bat 或执行 pwsh -File stop.ps1 -Restore -Deep

!常见问题排查

❌ 输入 node -v 或 npm -v 提示 "无法识别"

原因：安装 Node.js 后没有重开 PowerShell 窗口，PATH 没刷新。

解决：关闭当前 PowerShell，重新打开一个新的窗口再试。

如果还不行，手动刷新 PATH：

      $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
node -v
    

❌ npm 报 "执行策略" / "Execution Policy" 错误

原因：Windows 默认禁止运行脚本。

解决：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

提示确认时输入 Y 回车。之后 npm 和 pwsh 脚本都能正常运行。

❌ 提示 "openssl 未找到"

原因：解密凭证需要 openssl，它随 Git for Windows 一起安装。

解决：确认 Git 已安装。脚本会自动搜索 C:\Program Files\Git 和 D:\Git 下的 openssl。

❌ git clone 失败 / 认证失败

解决步骤：

浏览器打开 https://code.letcareme.com 确认网站可访问
确认用户名密码正确（区分大小写）
如果开了 2FA，需要用 Access Token 替代密码
检查网络是否需要代理

❌ 解密凭证失败 / 主密码错误

原因：主密码区分大小写，且无法找回。

解决：仔细检查密码是否正确。如确认忘记，联系管理员重新生成 secrets.enc。

❌ Claude Code 启动后没有 Bookworm 横幅

原因：配置文件未正确同步。

解决：不加 -StartOnly 重新运行安装脚本，让它重新 clone：

pwsh -ExecutionPolicy Bypass -File install.ps1

❌ 安装包下载太慢

解决：Node.js 官网在国内可能较慢，可以用淘宝镜像：

      # 设置 npm 淘宝镜像（加速下载）
npm config set registry https://registry.npmmirror.com

# 然后重新安装 Claude Code
npm i -g @anthropic-ai/claude-code
    

❌ ECONNRESET / "Unable to connect to API"

原因：代理软件把国内中转站 bww.letcareme.com 的流量也走了国际线路，导致连接被重置。

解决：在 PowerShell 中手动设置 NO_PROXY 后重试：

      # 设置中转站直连（不走代理）
$env:NO_PROXY = "bww.letcareme.com,code.letcareme.com"

# 重新启动
cd bookworm-boot
pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly
    

新版安装脚本已自动设置 NO_PROXY，git pull 更新后此问题不再出现。

❌ "Not logged in" / 直接运行 claude 报错

原因：API 凭证是进程级环境变量，只在安装脚本启动的进程中有效。新开 PowerShell 窗口直接运行 claude 没有凭证。

解决：不要直接运行 claude，必须通过以下方式启动：

双击桌面 Bookworm 快捷方式
双击 启动Bookworm.bat
命令行：pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly

❌ 完整性校验不匹配（大量文件 WARN）

原因：本地配置文件已被更新（管理员推送了新版本），但 integrity.sha256 未同步更新。

解决：选 y 继续即可，不影响使用。管理员会在下个版本同步哈希文件。

❌ 需要自己的 Claude 账号吗？

不需要。所有 API 请求通过中转站转发，消耗中转站额度。目标机不需要任何 Anthropic 账号或订阅。

❌ 询问 AI 系统内部信息时被拒绝了？

这是正常行为。Bookworm 的技能库、路由引擎、配置架构属于技术保密范围，AI 被设定为不披露这些信息。

解决：直接告诉 AI 你要完成的任务（写代码、分析问题、设计方案等），它会自动调用最合适的专家能力来帮你。无需了解内部机制即可获得完整服务。

安装检查清单

逐项确认，全部打勾即可开始使用：

Node.js 已安装 — node -v 显示版本号
Git 已安装 — git --version 显示版本号
npm 可用 — npm -v 显示版本号（如报错先设 ExecutionPolicy）
Claude Code 已安装 — claude --version 显示版本号
PowerShell 7 已安装 — pwsh --version 显示 7.x（推荐但非必须）
已获取 Gitea 账号密码 — 管理员提供
已获取主密码 — 管理员提供（用于解密 API 凭证）
能访问 code.letcareme.com — 浏览器打开确认
代理/VPN 已启动 — 国内必须，脚本自动检测 (Clash/V2Ray/快柠檬等)

快速参考

操作	最简方式	命令行方式
首次安装	git clone + 双击更新并启动Bookworm.bat	`pwsh -ExecutionPolicy Bypass -File install.ps1`
快速启动	双击启动Bookworm.bat	`pwsh -File install.ps1 -StartOnly`
同步更新	双击更新并启动Bookworm.bat	`pwsh -File install.ps1`
基础清理	`pwsh -ExecutionPolicy Bypass -File stop.ps1`
完整恢复	`pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore`
深度清理	`pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore -Deep`

安全须知

特性	规格
凭证加密	AES-256-CBC + PBKDF2 (600,000 迭代)
传输加密	HTTPS (TLS 1.2+, Let's Encrypt 证书)
凭证存储	进程级环境变量 + 可选本日缓存 (Windows Credential Manager, DPAPI 加密, 当日 23:59 过期)
登录保护	fail2ban (5 次失败/小时 → 封禁 24 小时)

🔒

主密码无法找回 — 请妥善保管。忘记后需管理员重新生成加密凭证。

Bookworm Portable 保姆式安装手册