bookworm
|
7c8540b542
|
feat(v3.1.1): E2E 护栏 + UX 4 项闭合 + 并发安全
闭合 v3.1.0 后续 4 个 HIGH 局限:
[L8] smoke 覆盖不到 .lnk 行为 → 引入 tools/test-launcher-e2e.ps1
4 测试套: PARSE / wrapper 6 特性 / .lnk Args 6 契约 / profile 双注入契约
集成到 build.ps1 后置, 失败 exit 1 拒绝发布
闭合 v3.0.10 -or 类 PSParser 漏网 bug 风险
[L5] Phase 1 总结弹窗仅有动作时弹 → 始终弹
老用户全就绪重跑 EXE 跳过总结不知是否完成
v3.1.1 移除条件, 永远显示 (零新装也弹 OK 态)
[L6] 更新.bat 完成无反馈 → GUI YesNo 询问立即启动
PS MessageBox: '同步完成. 是否立即启动 Claude?' Yes 触发 Start-Process 桌面 .lnk
[L7] profile 注入并发损坏 → FileShare.None 排他锁 + 5 次重试
WriteAllText 隐式 FileShare.Read 改为显式 FileStream
IOException catch sleep 50ms 重试, 5 次都失败 throw 触发 v3.1.0 显式弹窗
8/12 局限闭合 (剩余 L9-L12 计划 v3.1.2)
|
2026-04-25 23:16:08 +08:00 |
|
bookworm
|
1421338da3
|
feat(v3.0.11): 架构重构 — 启动链路 7 跳 → 1 跳直链
用户报障驱动 (v3.0.3-3.0.10 共 9 轮迭代后接受架构原罪).
旧架构: .lnk → bat → wt → pwsh → Base64 → DPAPI → claude (7 跳)
新架构: .lnk → pwsh → claude.ps1 (1 跳, 凭证由 profile 异步加载)
ADR-001 桌面 .lnk 直调 pwsh + claude.ps1 绝对路径
- 安装时 Get-Command claude / npm config get prefix 定位 claude.ps1
- bake 进 .lnk Args, 运行时不依赖任何 PATH 重载
- 自验证: 创建后回读 .lnk 确认 Target/Args 完整, 失败立即删除拒绝交付
ADR-002 DPAPI 凭证加载迁移到 PowerShell profile sentinel
- BW_CRED_START..END 块写入 ~/Documents/PowerShell/profile.ps1
- pwsh 启动自动 source, 与启动链路彻底解耦
- profile 编辑用 String.Replace 字面替换 (避开 -replace $ backreference)
ADR-003 启动 / 更新功能拆分
- 启动Bookworm.lnk → 仅启动 (1 跳)
- 更新Bookworm.lnk → 仅 git pull
- 更新并启动Bookworm.bat → 重命名为 更新Bookworm.bat (仅同步)
- tools/gen-launcher-bats.ps1 归档 (新架构不需要 Base64 生成器)
8 个失败模式中 7 个被架构性消除:
✅ F1 wt ; 切 tab (无 wt)
✅ F2 cmd 转义 (无 cmd 启动路径)
✅ F3 wt -d 引号 (无 wt -d)
✅ F4 Base64 解码语义错 (无 Base64)
✅ F5 PATH 时序 (绝对路径不依赖 PATH)
✅ F6 claude shim (直调 .ps1)
✅ F8 wt 自身 issue (无 wt)
⚠️ F7 DPAPI 跨用户 (设计限制, 跨用户需重激活)
EXE 220672 → 227840 bytes (+7168, ADR-002 profile 注入函数)
|
2026-04-25 18:19:07 +08:00 |
|
bookworm
|
609e82bac0
|
hotfix(v3.0.10): Base64 '-or' 括号 bug + dry-run 实跑验证护栏
v3.0.9 Base64 脚本启动即报:
Test-Path: A parameter cannot be found that matches parameter name 'or'.
claude.exe not found
根因: 'Test-Path (Join-Path $p claude.ps1) -or (Test-Path ...)' 中 -or
被当成 Test-Path 的命名参数. PSParser 静态检查看合法, 运行时炸.
修复:
F1: 括号修正 — $hasClaude 抽为独立变量, 三元 -or 每项带外括号
F2: gen-launcher-bats.ps1 强制加 dry-run 实跑验证护栏
解码后的 Base64 脚本必须被 pwsh -File 实跑到底部 __BW_DRYRUN_OK__
才算通过. 检查 ErrorRecord / ParameterBindingException / 未知命令.
任何未来 Base64 改动都被此验证拦截.
验证层级教训:
PSParser = 抓语法 / 抓不到参数绑定错
dry-run = 抓运行时 / 抓不到业务逻辑
smoke = 抓业务 / 需要前两层通过
EXE 220160 → 220672 bytes (+512)
|
2026-04-24 22:48:08 +08:00 |
|
bookworm
|
a3b4ff3a78
|
fix(v3.0.9): Claude 装完 npm prefix 固化 + 三层 PATH + 快捷方式自验证
用户反馈 (核心): '不要客户端修修补补, EXE 必须一次对'
诊断: v3.0.8 Phase 1 全 OK, 但桌面快捷方式 claude.exe not found
user npm config get prefix = C:\Users\Administrator\AppData\Roaming\npm
但 Get-Command claude 在 PS 7 为空 → User PATH 没含这个目录
Node.js MSI 写 User PATH 时机/行为被企业镜像/防病毒/组策略干扰
三层根治:
F1: auto-setup.ps1 装完 Claude Code 后立即 `npm config get prefix` 查真实路径,
强制写入 User PATH (永久生效). 不依赖 npm 自己的 PATH 注入时机.
F2: gen-launcher-bats Base64 脚本加 3 层 PATH 修复:
层 1 Machine+User env PATH / 层 2 npm config get prefix 动态查询 /
层 3 硬编码候选 (%APPDATA%\npm / Program Files\nodejs / LOCALAPPDATA\npm)
F3: auto-setup.ps1:2256 创建桌面快捷方式前 Test-Cmd claude 自验证,
失败则拒绝创建 + 弹明确错误, 不再静默产出坏快捷方式
EXE 217088 → 220160 bytes (+3072)
Base64 3544 → 5880 chars
产品原则: 点快捷方式要么成功要么给清晰诊断, 不再给 'claude not found' 无头案
|
2026-04-24 22:39:17 +08:00 |
|
bookworm
|
8f6c53ec99
|
fix(v3.0.6): 启动器四连击 bug 根治 + 分发版阈值调整
真实用户报障驱动, 4 个 P0 闭环:
B1: wt.exe ';' 切 tab 误报 → -EncodedCommand Base64-UTF-16LE
B2: -d '%~dp0' 尾 \ 配 " 转义引号 → -d '%CD%' 无尾反斜杠 (cd /d 已切入)
B3: 子 pwsh 继承老 PATH 致 claude.exe not found → Base64 首行强制重载
$env:Path = Machine + ';' + User, 找不到 claude 还附带 PATH 诊断
B4: install.ps1 [8/9] Skills>50 Hooks>10 阈值误报脱敏分发版残缺
→ Skills>=10 Hooks>=3 匹配 bookworm-portable-config.git 实际规模
新增工具 tools/gen-launcher-bats.ps1: 单一明文源 → Base64 → 两 bat 自动同步,
含字符集 + 长度 + round-trip PARSE 三重 health check, 以后改启动逻辑
只需改 $plainScript 一处.
向后兼容: DPAPI 凭证语义 round-trip 不变, 老快捷方式继续可用,
Installer banner v1.5 → v1.6, BWVersion 3.0.5 → 3.0.6.
|
2026-04-24 20:47:16 +08:00 |
|