docs: guide v1.5 - deployment lessons from mph01

- Step progress updated [1/6]-[6/6] → [1/9]-[9/9]
- Added NO_PROXY explanation for domestic relay
- New FAQ: ECONNRESET (proxy routing domestic traffic internationally)
- New FAQ: "Not logged in" (must launch via install script, not direct claude)
- New FAQ: integrity hash mismatch (safe to skip)
- Credential storage description corrected (includes cache mechanism)
This commit is contained in:
bookworm 2026-04-02 19:09:12 +08:00
parent dea4a0e864
commit 4cbeddd0bd

View File

@ -205,6 +205,7 @@
<span class="badge"><strong>AES-256</strong> 加密</span> <span class="badge"><strong>AES-256</strong> 加密</span>
<span class="badge"><strong>HTTPS</strong> 传输</span> <span class="badge"><strong>HTTPS</strong> 传输</span>
</div> </div>
<a href="/Bookworm-Setup.bat" download style="display:inline-block;margin-top:1.2rem;padding:0.7rem 2rem;background:var(--accent);color:#000;font-weight:700;border-radius:8px;font-size:1rem;text-decoration:none;transition:opacity 0.2s" onmouseover="this.style.opacity='0.85'" onmouseout="this.style.opacity='1'">&#11015; 下载一键安装器</a>
</div> </div>
<div class="container"> <div class="container">
@ -250,6 +251,16 @@
</div> </div>
</div> </div>
<div class="alert info">
<span class="alert-icon">&#128161;</span>
<div>
<strong>中转站不走代理</strong><br>
API 中转站 <code>bww.letcareme.com</code> 部署在国内阿里云,<strong>不需要通过代理访问</strong><br>
安装脚本已自动设置 <code>NO_PROXY=bww.letcareme.com,code.letcareme.com</code>,无需手动配置。<br>
如果代理软件有"绕过规则"设置,建议把 <code>*.letcareme.com</code> 加入直连列表。
</div>
</div>
<p>需要安装以下软件。如果已装过可跳到下一步。</p> <p>需要安装以下软件。如果已装过可跳到下一步。</p>
<!-- Node.js --> <!-- Node.js -->
@ -425,14 +436,17 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait</c
<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],自动完成:</p> <p>脚本会显示步骤进度 [1/9] 到 [9/9],自动完成:</p>
<ul style="color:var(--text-dim);font-size:0.9rem;padding-left:1.2rem;margin-top:0.3rem"> <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>[1/9] 前置检查 (Claude Code / Node.js / Git)</li>
<li>[2/6] 自动检测代理 (无需手动操作)</li> <li>[2/9] 自动检测代理 + 设置 NO_PROXY</li>
<li>[3/6] 解密凭证 (输入主密码)</li> <li>[3/9] 解密凭证 (输入主密码)</li>
<li>[4/6] 同步配置 (下载 92 个 Skills)</li> <li>[4/9] 同步配置 (下载 92 个 Skills)</li>
<li>[5/6] 渲染模板 + 初始化 + 系统验证</li> <li>[5/9] 完整性校验 (SHA256 哈希验证)</li>
<li>[6/6] 启动 Claude Code</li> <li>[6/9] 渲染配置模板</li>
<li>[7/9] 初始化本地目录</li>
<li>[8/9] Bookworm 系统验证 + MCP 检查</li>
<li>[9/9] 启动 Claude Code</li>
</ul> </ul>
</div> </div>
</div> </div>
@ -652,6 +666,38 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait</c
<span class="cmd">npm</span> i -g @anthropic-ai/claude-code</code> <span class="cmd">npm</span> i -g @anthropic-ai/claude-code</code>
</div> </div>
<div class="card">
<h3>&#10060; ECONNRESET / "Unable to connect to API"</h3>
<p><strong>原因:</strong>代理软件把国内中转站 <code>bww.letcareme.com</code> 的流量也走了国际线路,导致连接被重置。</p>
<p><strong>解决:</strong>在 PowerShell 中手动设置 NO_PROXY 后重试:</p>
</div>
<div class="code-block" onclick="copyCode(this)">
<code><span class="comment"># 设置中转站直连(不走代理)</span>
$env:NO_PROXY = "bww.letcareme.com,code.letcareme.com"
<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></code>
</div>
<p style="color:var(--text-dim);font-size:0.85rem">新版安装脚本已自动设置 NO_PROXY<code>git pull</code> 更新后此问题不再出现。</p>
<div class="card">
<h3>&#10060; "Not logged in" / 直接运行 claude 报错</h3>
<p><strong>原因:</strong>API 凭证是进程级环境变量,只在安装脚本启动的进程中有效。新开 PowerShell 窗口直接运行 <code>claude</code> 没有凭证。</p>
<p><strong>解决:</strong><strong>不要直接运行 <code>claude</code></strong>,必须通过以下方式启动:</p>
<ul style="color:var(--text-dim);font-size:0.9rem;padding-left:1.2rem;margin-top:0.3rem">
<li>双击桌面 <strong>Bookworm</strong> 快捷方式</li>
<li>双击 <strong>启动Bookworm.bat</strong></li>
<li>命令行:<code>pwsh -ExecutionPolicy Bypass -File install.ps1 -StartOnly</code></li>
</ul>
</div>
<div class="card">
<h3>&#10060; 完整性校验不匹配(大量文件 WARN</h3>
<p><strong>原因:</strong>本地配置文件已被更新(管理员推送了新版本),但 <code>integrity.sha256</code> 未同步更新。</p>
<p><strong>解决:</strong><strong>y</strong> 继续即可,不影响使用。管理员会在下个版本同步哈希文件。</p>
</div>
<div class="card"> <div class="card">
<h3>&#10060; 需要自己的 Claude 账号吗?</h3> <h3>&#10060; 需要自己的 Claude 账号吗?</h3>
<p><strong>不需要。</strong>所有 API 请求通过中转站转发,消耗中转站额度。目标机不需要任何 Anthropic 账号或订阅。</p> <p><strong>不需要。</strong>所有 API 请求通过中转站转发,消耗中转站额度。目标机不需要任何 Anthropic 账号或订阅。</p>
@ -702,7 +748,7 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait</c
<tr><th>特性</th><th>规格</th></tr> <tr><th>特性</th><th>规格</th></tr>
<tr><td>凭证加密</td><td>AES-256-CBC + PBKDF2 (600,000 迭代)</td></tr> <tr><td>凭证加密</td><td>AES-256-CBC + PBKDF2 (600,000 迭代)</td></tr>
<tr><td>传输加密</td><td>HTTPS (TLS 1.2+, Let's Encrypt 证书)</td></tr> <tr><td>传输加密</td><td>HTTPS (TLS 1.2+, Let's Encrypt 证书)</td></tr>
<tr><td>凭证存储</td><td>仅进程级环境变量,不写磁盘,不写注册表</td></tr> <tr><td>凭证存储</td><td>进程级环境变量 + 可选本日缓存 (Windows Credential Manager, DPAPI 加密, 当日 23:59 过期)</td></tr>
<tr><td>登录保护</td><td>fail2ban (5 次失败/小时 &#8594; 封禁 24 小时)</td></tr> <tr><td>登录保护</td><td>fail2ban (5 次失败/小时 &#8594; 封禁 24 小时)</td></tr>
</table> </table>
<div class="alert warning" style="margin-top:1rem"> <div class="alert warning" style="margin-top:1rem">
@ -716,7 +762,7 @@ Start-Process msiexec.exe -ArgumentList "/i $env:TEMP\node-install.msi" -Wait</c
</div> </div>
<div class="footer"> <div class="footer">
Bookworm Portable v1.4 &mdash; 保姆式安装手册<br> Bookworm Portable v1.5 &mdash; 保姆式安装手册<br>
&copy; 2026 Bookworm Smart Assistant &copy; 2026 Bookworm Smart Assistant
</div> </div>