docs: guide v1.3 bat launchers + password retry
This commit is contained in:
parent
2a6bb08abb
commit
38da27b389
100
guide.html
100
guide.html
@ -378,42 +378,71 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait</c
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="screenshot-note">
|
<div class="screenshot-note">
|
||||||
<strong>弹出用户名密码？</strong> 输入管理员提供给你的 Gitea 账号密码。
|
<strong>弹出用户名密码？</strong> 输入管理员提供给你的 Gitea 账号密码。这是 Gitea 的密码，不是主密码。
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="step">
|
<div class="step">
|
||||||
<div class="step-icon purple">2</div>
|
<div class="step-icon purple">2</div>
|
||||||
<div class="step-content">
|
<div class="step-content">
|
||||||
<h4>运行安装脚本</h4>
|
<h4>双击运行安装脚本</h4>
|
||||||
<p>这条命令会自动完成所有配置：克隆 97 个 Skills、渲染配置文件、解密 API 凭证、启动 Claude Code。</p>
|
<p>双击文件夹里的 <strong>更新并启动Bookworm.bat</strong>，脚本会自动完成所有配置。</p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<div class="card">
|
||||||
|
<h3>或者用命令行运行</h3>
|
||||||
|
<p>如果双击 .bat 不起作用，在 PowerShell 中手动执行：</p>
|
||||||
|
</div>
|
||||||
<div class="code-block" onclick="copyCode(this)">
|
<div class="code-block" onclick="copyCode(this)">
|
||||||
<code><span class="cmd">pwsh</span> <span class="flag">-ExecutionPolicy Bypass</span> -File install.ps1</code>
|
<code><span class="cmd">pwsh</span> <span class="flag">-ExecutionPolicy Bypass</span> -File install.ps1</code>
|
||||||
</div>
|
</div>
|
||||||
|
<p style="color:var(--text-dim);font-size:0.85rem">没有 pwsh 可用 <code>powershell</code> 替代。</p>
|
||||||
|
|
||||||
<div class="step">
|
<div class="step">
|
||||||
<div class="step-icon purple">3</div>
|
<div class="step-icon purple">3</div>
|
||||||
<div class="step-content">
|
<div class="step-content">
|
||||||
<h4>输入主密码</h4>
|
<h4>输入主密码</h4>
|
||||||
<p>脚本会提示 <strong>"输入主密码解密凭证"</strong>，输入管理员提供的主密码，按回车。密码输入时不显示字符，这是正常的。</p>
|
<p>脚本会提示 <strong>"输入主密码解密凭证"</strong>，输入管理员提供的<strong>主密码</strong>（不是 Gitea 密码），按回车。</p>
|
||||||
|
<p>密码输入时不显示字符，这是正常的。<strong>输错了可以重试，最多 3 次。</strong></p>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<div class="screenshot-note">
|
||||||
|
<strong>两个密码不要搞混：</strong><br>
|
||||||
|
<strong>Gitea 密码</strong> = 克隆仓库时输入的，用于下载文件<br>
|
||||||
|
<strong>主密码</strong> = 解密 API 凭证时输入的，用于启动 Claude Code
|
||||||
|
</div>
|
||||||
|
|
||||||
<div class="step">
|
<div class="step">
|
||||||
<div class="step-icon green">4</div>
|
<div class="step-icon green">4</div>
|
||||||
<div class="step-content">
|
<div class="step-content">
|
||||||
<h4>等待完成</h4>
|
<h4>等待完成</h4>
|
||||||
<p>脚本会显示步骤进度 [1/6] 到 [6/6]，全部显示 [OK] 后自动启动 Claude Code。</p>
|
<p>脚本会显示步骤进度 [1/6] 到 [6/6]，自动完成：</p>
|
||||||
|
<ul style="color:var(--text-dim);font-size:0.9rem;padding-left:1.2rem;margin-top:0.3rem">
|
||||||
|
<li>[1/6] 前置检查 (Claude Code / Node.js / Git)</li>
|
||||||
|
<li>[2/6] 自动检测代理 (无需手动操作)</li>
|
||||||
|
<li>[3/6] 解密凭证 (输入主密码)</li>
|
||||||
|
<li>[4/6] 同步配置 (下载 97 个 Skills)</li>
|
||||||
|
<li>[5/6] 渲染模板 + 初始化 + 系统验证</li>
|
||||||
|
<li>[6/6] 启动 Claude Code</li>
|
||||||
|
</ul>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="alert success">
|
<div class="alert success">
|
||||||
<span class="alert-icon">✓</span>
|
<span class="alert-icon">✓</span>
|
||||||
<div>
|
<div>
|
||||||
<strong>看到 Bookworm 横幅就说明成功了！</strong><br>
|
<strong>看到 "Bookworm 就绪" 绿色横幅就说明成功了！</strong><br>
|
||||||
Claude Code 启动后会显示 ASCII 艺术字 "Bookworm" 横幅，表示 97 个 Skills 全部激活。<br>
|
Claude Code 启动后，脚本会验证 Skills/Hooks/配置 完整性，全部 [OK] 后进入 Bookworm 模式。<br>
|
||||||
现在可以直接开始使用，所有 API 请求通过中转站转发，不需要自己的 Claude 账号。
|
所有 API 请求通过中转站转发，不需要自己的 Claude 账号。
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div class="alert warning">
|
||||||
|
<span class="alert-icon">⚠</span>
|
||||||
|
<div>
|
||||||
|
<strong>看到 "原生模式启动" 黄色横幅？</strong><br>
|
||||||
|
说明 Bookworm 配置不完整。请不加 -StartOnly 重新运行安装脚本，或联系管理员。
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
@ -425,24 +454,45 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait</c
|
|||||||
<h2><span class="num">4</span>日常使用</h2>
|
<h2><span class="num">4</span>日常使用</h2>
|
||||||
|
|
||||||
<div class="card">
|
<div class="card">
|
||||||
<h3>场景一：快速启动（已安装过，不更新配置）</h3>
|
<h3>方法一：双击 .bat 文件（推荐，最简单）</h3>
|
||||||
<p>适合每天打开电脑后快速进入工作状态。</p>
|
<p>bookworm-boot 文件夹里有两个 .bat 文件：</p>
|
||||||
|
</div>
|
||||||
|
<table>
|
||||||
|
<tr><th>文件</th><th>作用</th><th>适用场景</th></tr>
|
||||||
|
<tr>
|
||||||
|
<td><strong>启动Bookworm.bat</strong></td>
|
||||||
|
<td>快速启动，不更新配置</td>
|
||||||
|
<td>每天日常使用</td>
|
||||||
|
</tr>
|
||||||
|
<tr>
|
||||||
|
<td><strong>更新并启动Bookworm.bat</strong></td>
|
||||||
|
<td>先同步最新 Skills 再启动</td>
|
||||||
|
<td>管理员通知有更新时</td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
<p style="color:var(--text-dim);font-size:0.85rem;margin-top:0.5rem">双击即可，无需打开 PowerShell，无需记命令。脚本会自动检测 PowerShell 7/5.1。</p>
|
||||||
|
|
||||||
|
<div class="alert info">
|
||||||
|
<span class="alert-icon">💡</span>
|
||||||
|
<div>
|
||||||
|
<strong>启动时显示 "有 N 个新更新可用"？</strong><br>
|
||||||
|
说明管理员更新了 Skills 或 Hooks。双击 <strong>更新并启动Bookworm.bat</strong> 即可同步。
|
||||||
</div>
|
</div>
|
||||||
<div class="code-block" onclick="copyCode(this)">
|
|
||||||
<code><span class="cmd">cd</span> bookworm-boot
|
|
||||||
<span class="cmd">pwsh</span> <span class="flag">-ExecutionPolicy Bypass</span> -File install.ps1 <span class="flag">-StartOnly</span></code>
|
|
||||||
</div>
|
</div>
|
||||||
<p style="color:var(--text-dim);font-size:0.85rem"><code>-StartOnly</code> 跳过 git 同步，直接解密凭证并启动，约 10 秒完成。</p>
|
|
||||||
|
|
||||||
<div class="card" style="margin-top:1rem">
|
<div class="card" style="margin-top:1rem">
|
||||||
<h3>场景二：同步最新配置后启动</h3>
|
<h3>方法二：命令行（备用）</h3>
|
||||||
<p>管理员更新了 Skills 或 Hooks 后，用这个命令拉取最新版本。</p>
|
<p>如果 .bat 文件无法运行，在 PowerShell 中手动执行：</p>
|
||||||
</div>
|
</div>
|
||||||
<div class="code-block" onclick="copyCode(this)">
|
<div class="code-block" onclick="copyCode(this)">
|
||||||
<code><span class="cmd">cd</span> bookworm-boot
|
<code><span class="comment"># 快速启动</span>
|
||||||
|
<span class="cmd">cd</span> bookworm-boot
|
||||||
|
<span class="cmd">pwsh</span> <span class="flag">-ExecutionPolicy Bypass</span> -File install.ps1 <span class="flag">-StartOnly</span>
|
||||||
|
|
||||||
|
<span class="comment"># 同步更新后启动</span>
|
||||||
|
<span class="cmd">cd</span> bookworm-boot
|
||||||
<span class="cmd">pwsh</span> <span class="flag">-ExecutionPolicy Bypass</span> -File install.ps1</code>
|
<span class="cmd">pwsh</span> <span class="flag">-ExecutionPolicy Bypass</span> -File install.ps1</code>
|
||||||
</div>
|
</div>
|
||||||
<p style="color:var(--text-dim);font-size:0.85rem">不加 <code>-StartOnly</code> 会自动 <code>git pull</code> 拉取更新。</p>
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<!-- ============================================================ -->
|
<!-- ============================================================ -->
|
||||||
@ -581,13 +631,13 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait</c
|
|||||||
<div class="section">
|
<div class="section">
|
||||||
<h2>快速参考</h2>
|
<h2>快速参考</h2>
|
||||||
<table>
|
<table>
|
||||||
<tr><th>操作</th><th>命令</th></tr>
|
<tr><th>操作</th><th>最简方式</th><th>命令行方式</th></tr>
|
||||||
<tr><td>首次安装</td><td><code>git clone https://code.letcareme.com/bookworm/bookworm-boot.git && cd bookworm-boot && pwsh -ExecutionPolicy Bypass -File install.ps1</code></td></tr>
|
<tr><td>首次安装</td><td>git clone + 双击<br><strong>更新并启动Bookworm.bat</strong></td><td><code>pwsh -ExecutionPolicy Bypass -File install.ps1</code></td></tr>
|
||||||
<tr><td>快速启动</td><td><code>cd bookworm-boot && pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly</code></td></tr>
|
<tr><td>快速启动</td><td>双击 <strong>启动Bookworm.bat</strong></td><td><code>pwsh -File install.ps1 -StartOnly</code></td></tr>
|
||||||
<tr><td>同步更新</td><td><code>cd bookworm-boot && pwsh -ExecutionPolicy Bypass -File install.ps1</code></td></tr>
|
<tr><td>同步更新</td><td>双击 <strong>更新并启动Bookworm.bat</strong></td><td><code>pwsh -File install.ps1</code></td></tr>
|
||||||
<tr><td>基础清理</td><td><code>pwsh -ExecutionPolicy Bypass -File stop.ps1</code></td></tr>
|
<tr><td>基础清理</td><td colspan="2"><code>pwsh -ExecutionPolicy Bypass -File stop.ps1</code></td></tr>
|
||||||
<tr><td>完整恢复</td><td><code>pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore</code></td></tr>
|
<tr><td>完整恢复</td><td colspan="2"><code>pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore</code></td></tr>
|
||||||
<tr><td>深度清理</td><td><code>pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore -Deep</code></td></tr>
|
<tr><td>深度清理</td><td colspan="2"><code>pwsh -ExecutionPolicy Bypass -File stop.ps1 -Restore -Deep</code></td></tr>
|
||||||
</table>
|
</table>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user