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
parent
dea4a0e864
commit
4cbeddd0bd
64
guide.html
64
guide.html
@ -205,6 +205,7 @@
|
||||
<span class="badge"><strong>AES-256</strong> 加密</span>
|
||||
<span class="badge"><strong>HTTPS</strong> 传输</span>
|
||||
</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'">⬇ 下载一键安装器</a>
|
||||
</div>
|
||||
|
||||
<div class="container">
|
||||
@ -250,6 +251,16 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="alert info">
|
||||
<span class="alert-icon">💡</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>
|
||||
|
||||
<!-- 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-content">
|
||||
<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">
|
||||
<li>[1/6] 前置检查 (Claude Code / Node.js / Git)</li>
|
||||
<li>[2/6] 自动检测代理 (无需手动操作)</li>
|
||||
<li>[3/6] 解密凭证 (输入主密码)</li>
|
||||
<li>[4/6] 同步配置 (下载 92 个 Skills)</li>
|
||||
<li>[5/6] 渲染模板 + 初始化 + 系统验证</li>
|
||||
<li>[6/6] 启动 Claude Code</li>
|
||||
<li>[1/9] 前置检查 (Claude Code / Node.js / Git)</li>
|
||||
<li>[2/9] 自动检测代理 + 设置 NO_PROXY</li>
|
||||
<li>[3/9] 解密凭证 (输入主密码)</li>
|
||||
<li>[4/9] 同步配置 (下载 92 个 Skills)</li>
|
||||
<li>[5/9] 完整性校验 (SHA256 哈希验证)</li>
|
||||
<li>[6/9] 渲染配置模板</li>
|
||||
<li>[7/9] 初始化本地目录</li>
|
||||
<li>[8/9] Bookworm 系统验证 + MCP 检查</li>
|
||||
<li>[9/9] 启动 Claude Code</li>
|
||||
</ul>
|
||||
</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>
|
||||
</div>
|
||||
|
||||
<div class="card">
|
||||
<h3>❌ 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>❌ "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>❌ 完整性校验不匹配（大量文件 WARN）</h3>
|
||||
<p><strong>原因：</strong>本地配置文件已被更新（管理员推送了新版本），但 <code>integrity.sha256</code> 未同步更新。</p>
|
||||
<p><strong>解决：</strong>选 <strong>y</strong> 继续即可，不影响使用。管理员会在下个版本同步哈希文件。</p>
|
||||
</div>
|
||||
|
||||
<div class="card">
|
||||
<h3>❌ 需要自己的 Claude 账号吗？</h3>
|
||||
<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><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>仅进程级环境变量，不写磁盘，不写注册表</td></tr>
|
||||
<tr><td>凭证存储</td><td>进程级环境变量 + 可选本日缓存 (Windows Credential Manager, DPAPI 加密, 当日 23:59 过期)</td></tr>
|
||||
<tr><td>登录保护</td><td>fail2ban (5 次失败/小时 → 封禁 24 小时)</td></tr>
|
||||
</table>
|
||||
<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 class="footer">
|
||||
Bookworm Portable v1.4 — 保姆式安装手册<br>
|
||||
Bookworm Portable v1.5 — 保姆式安装手册<br>
|
||||
© 2026 Bookworm Smart Assistant
|
||||
</div>
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user