From 38da27b389e7a9e2d783273c78391197eac09e04 Mon Sep 17 00:00:00 2001 From: leesu Date: Wed, 1 Apr 2026 21:04:50 +0800 Subject: [PATCH] docs: guide v1.3 bat launchers + password retry --- guide.html | 100 +++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 75 insertions(+), 25 deletions(-) diff --git a/guide.html b/guide.html index fcaba56..5abbb0d 100644 --- a/guide.html +++ b/guide.html @@ -378,42 +378,71 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait
- 弹出用户名密码？ 输入管理员提供给你的 Gitea 账号密码。 + 弹出用户名密码？ 输入管理员提供给你的 Gitea 账号密码。这是 Gitea 的密码，不是主密码。
2
-

运行安装脚本

-

这条命令会自动完成所有配置：克隆 97 个 Skills、渲染配置文件、解密 API 凭证、启动 Claude Code。

+

双击运行安装脚本

+

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

+ +
+

或者用命令行运行

+

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

+
pwsh -ExecutionPolicy Bypass -File install.ps1
+

没有 pwsh 可用 powershell 替代。

3

输入主密码

-

脚本会提示 "输入主密码解密凭证"，输入管理员提供的主密码，按回车。密码输入时不显示字符，这是正常的。

+

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

+

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

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

等待完成

-

脚本会显示步骤进度 [1/6] 到 [6/6]，全部显示 [OK] 后自动启动 Claude Code。

+

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

+
    +
  • [1/6] 前置检查 (Claude Code / Node.js / Git)
    • +
  • [2/6] 自动检测代理 (无需手动操作)
    • +
  • [3/6] 解密凭证 (输入主密码)
    • +
  • [4/6] 同步配置 (下载 97 个 Skills)
    • +
  • [5/6] 渲染模板 + 初始化 + 系统验证
    • +
  • [6/6] 启动 Claude Code
    • +
✓
- 看到 Bookworm 横幅就说明成功了！
- Claude Code 启动后会显示 ASCII 艺术字 "Bookworm" 横幅，表示 97 个 Skills 全部激活。
- 现在可以直接开始使用，所有 API 请求通过中转站转发，不需要自己的 Claude 账号。 + 看到 "Bookworm 就绪" 绿色横幅就说明成功了！
+ Claude Code 启动后，脚本会验证 Skills/Hooks/配置 完整性，全部 [OK] 后进入 Bookworm 模式。
+ 所有 API 请求通过中转站转发，不需要自己的 Claude 账号。 +
+
+ +
+ ⚠ +
+ 看到 "原生模式启动" 黄色横幅？
+ 说明 Bookworm 配置不完整。请不加 -StartOnly 重新运行安装脚本，或联系管理员。
@@ -425,24 +454,45 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait4日常使用
-

场景一：快速启动（已安装过，不更新配置）

-

适合每天打开电脑后快速进入工作状态。

+

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

+

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

-
- cd bookworm-boot -pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly + + + + + + + + + + + + +
文件作用适用场景
启动Bookworm.bat快速启动，不更新配置每天日常使用
更新并启动Bookworm.bat先同步最新 Skills 再启动管理员通知有更新时
+

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

+ +
+ 💡 +
+ 启动时显示 "有 N 个新更新可用"？
+ 说明管理员更新了 Skills 或 Hooks。双击 更新并启动Bookworm.bat 即可同步。 +
-

-StartOnly 跳过 git 同步，直接解密凭证并启动，约 10 秒完成。

-

场景二：同步最新配置后启动

-

管理员更新了 Skills 或 Hooks 后，用这个命令拉取最新版本。

+

方法二：命令行（备用）

+

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

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

不加 -StartOnly 会自动 git pull 拉取更新。

@@ -581,13 +631,13 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait

快速参考

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