caveman Windows 安装深度指南：irm | iex 失败后的手动兜底与完整回退路径

caveman Windows 安装深度指南irm | iex 失败后的手动兜底与完整回退路径【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/cavemancaveman 的官方一条式安装命令irm ... install.ps1 | iex在部分 Windows 环境下会因引号、执行策略或 JSON 合并丢失而失败。本文以仓库中 docs/install-windows.md 为主线讲清 Windows 安装失败后的完整手动回退方案如何用 PowerShell 脚本手动完成 Claude Code 的 plugin-skill 激活、如何验证安装结果、Codex 在 Windows 上的符号链接限制以及npx skills的--copy兜底写法并结合 install.ps1 与 bin/install.js 的源码解释每条回退路径背后的设计原因。读完本文你可以独立完成 Windows 上 caveman 的安装、验证与常驻配置。一条式安装的架构install.ps1 只是薄壳理解 Windows 兜底方案前先要弄清一条式命令到底在做什么。install.ps1 顶部注释写明它是围绕 bin/install.js统一 Node 安装器的thin wrapper所有传给它的 flag 都会原样转发。整个脚本只有一层函数包装和两条执行路径# 仓库内 clone 路径若本地存在 bin/install.js直接运行 if ($PSCommandPath) { $here Split-Path -Parent $PSCommandPath $local Join-Path $here bin/install.js if (Test-Path $local) { node $local InstallerArgs exit $LASTEXITCODE } } # curl-pipe 路径委托给 npx默认钉在 v2.4.0可用 CAVEMAN_REF 覆盖 npx -y github:$Repo#$PinnedRef InstallerArgs这段代码透露了 Windows 安装历史上出过什么问题为什么必须是 Node 安装器源码注释明确写道install.ps1install.sh和install.ps1曾经是两份并行维护的真相来源不断漂移issue #249 就是一个node -e ...引号 bug导致每次 Windows 安装都静默丢掉了 JSON 合并步骤。换成一份到处都能跑的 Node 脚本后引号 bug 被根除。这正是 docs/install-windows.md 开头说irm失败issues #249, #199, #72的历史背景。为什么包在函数里而不是顶层param()irm | iex会把脚本当字符串执行此时$PSCommandPath为$null顶层param块也收不到管道传参issue #565。旧代码对$PSCommandPath无保护地做Split-Path时直接崩溃报 Cannot bind argument to parameter Path because it is null。包成Install-Caveman函数后一条脚本同时兼容无参无路径的管道路径和本地 clone 路径install.ps1。前置依赖要求 Node ≥ 18脚本会检查主版本不满足直接报错退出npx 随 Node ≥ 18 自带缺失时提示重装 Node.js。版本钉住默认$PinnedRef v2.4.0仅当刻意测试其他 ref 时才设CAVEMAN_REF环境变量。由于是薄壳统一安装器的全部能力在 Windows 上同样可用从 clone 里执行node bin/install.js --dry-run预览全部命令、--list查看约 30 行的 agent 检测矩阵、--only claude只装一个 agent、--force强制重跑。完整 flag 语义见 INSTALL.md 的 flag 表。手动兜底PowerShell 脚本完成 plugin-skill 激活当一条式安装失败时docs/install-windows.md 给出的核心方案是手工建立 plugin-skill 激活。需要明确这条路径的边界它不安装独立 hooks也不安装statusline——这两者之后要用统一 Node 安装器补上命令见下文补全 hooks 与 statusline小节。脚本完整内容从仓库 clone 中执行$ClaudeDir if ($env:CLAUDE_CONFIG_DIR) { $env:CLAUDE_CONFIG_DIR } else { Join-Path $HOME .claude } $PluginSkillDir Join-Path $ClaudeDir .agents\plugins\caveman\skills\caveman $MarketplaceDir Join-Path $ClaudeDir .agents\plugins $MarketplaceFile Join-Path $MarketplaceDir marketplace.json # Copy SKILL.md into the plugin path (run from a clone of the repo) New-Item -ItemType Directory -Path $PluginSkillDir -Force | Out-Null Copy-Item .\skills\caveman\SKILL.md $PluginSkillDir\SKILL.md -Force # Create or update marketplace.json with the caveman entry New-Item -ItemType Directory -Path $MarketplaceDir -Force | Out-Null if (Test-Path $MarketplaceFile) { $marketplace Get-Content $MarketplaceFile -Raw | ConvertFrom-Json } else { $marketplace [pscustomobject]{} } if (-not ($marketplace.PSObject.Properties.Name -contains plugins)) { $marketplace | Add-Member -NotePropertyName plugins -NotePropertyValue ([pscustomobject]{}) } $plugins [ordered]{} foreach ($p in $marketplace.plugins.PSObject.Properties) { $plugins[$p.Name] $p.Value } $plugins[caveman] [ordered]{ name caveman; source JuliusBrussee/caveman; version main } $marketplace.plugins [pscustomobject]$plugins $marketplace | ConvertTo-Json -Depth 10 | Set-Content -Path $MarketplaceFile -Encoding UTF8逐段拆解这个脚本在做什么1. 配置目录解析$ClaudeDir优先读CLAUDE_CONFIG_DIR环境变量缺省回落到~/.claude。这与 INSTALL.md 中--config-dirflag 的语义一致Default:$CLAUDE_CONFIG_DIRor~/.claude即 Claude Code 的全部状态都以该目录为根。2. 复制技能文件到插件路径skills\caveman\SKILL.md是 caveman 技能的唯一内容源——一个带 frontmatter 的 Markdown 文件声明了技能名、触发词/caveman、caveman mode、talk like caveman 等以及 lite/full/ultra/wenyan 等强度级别的完整压缩规则。脚本把它复制进$ClaudeDir\.agents\plugins\caveman\skills\caveman\SKILL.md。注意源路径.\skills\caveman\SKILL.md是相对路径因此必须在仓库 clone 根目录下运行该脚本仓库内的实际文件即 skills/caveman/SKILL.md。3. 合并写入 marketplace.json后半段是典型的读—改—写JSON 合并几个细节值得注意保留已有条目先解析现有marketplace.json不存在则建空对象用[ordered]{}按原顺序收集全部plugins条目再把caveman追加到末尾。这保证不会覆盖你机器上其他 marketplace 插件。caveman 条目本身name caveman; source JuliusBrussee/caveman; version main其中source指向上游仓库、version钉在main分支。ConvertTo-Json -Depth 10嵌套深度足够避免plugins下的对象结构被 PowerShell 默认深度截断成空。这正是 #249 那类 bug 的正面教材安装器侧曾因引号 bug 静默丢掉这个 JSON 合并步骤所以手动脚本把它写得足够显式、无子进程引号嵌套。验证Test-Path $PluginSkillDir\SKILL.md # 应输出 True然后重启 Claude Code输入/caveman确认技能加载。若响应变成简短的碎片句如 Got it. Caveman mode on.说明技能文件已被读取生效。补全 hooks 与 statusline统一 Node 安装器手动脚本只完成了 skill 激活。文档明确说 standalone hooks 和 statusline 不在其中需要随后运行npx -y github:JuliusBrussee/caveman -- --only claude或在 clone 内node bin/install.js --only claude补上之后Claude Code 侧才具备完整的 hook 链路。这些 hook 文件在仓库里都有对应源码位于 src/hooks/caveman-activate.jsSessionStart 时写入.caveman-active标志文件caveman-mode-tracker.js按会话记录模式开关状态到.caveman-sessions/caveman-statusline.ps1 与 caveman-statusline.shPowerShell 与 Shell 双版本状态栏在 Claude Code 底部显示[CAVEMAN]徽标。INSTALL.md 的故障排查一节专门针对 Windows 强调了这一点Git Bash 下跑install.sh也能装但 hook 侧配的是 PowerShell 版本caveman-statusline.ps1所以推荐直接用install.ps1最低要求 PowerShell 5.1用$PSVersionTable.PSVersion检查若irm | iex被执行策略拦截先Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass再重试。补装完成后的验证方式来自 INSTALL.md 的 Verify 节# 1. 查看 agent 检测矩阵确认 claude 被识别 node bin/install.js --list # 2. 检查标志文件内容应为 full Get-Content ${env:CLAUDE_CONFIG_DIR:$HOME/.claude}\.caveman-active # 3. 多窗口状态下逐一查看 ls ${env:CLAUDE_CONFIG_DIR:$HOME/.claude}\.caveman-sessions\Codex on Windows符号链接前置与手动激活文档的 Codex on Windows 一节给出三步流程核心障碍是符号链接权限先启用符号链接git config --global core.symlinks true——前提是系统已开启 Developer Mode 或你以管理员运行装插件clone 仓库 → 打开 VS Code → Codex Settings → Plugins → 在 local marketplace 中找到 Caveman → Install → Reload Window手动激活Codex hooks 目前在 Windows 上处于禁用状态因此每个会话都要用$caveman手动开启模式。第 1 步与 Windows 平台的硬限制直接相关非管理员账户创建符号链接需要开发者模式授权这也是后面npx skills --copy兜底存在的同一个根因。npx skills的 symlink 兜底加--copynpx skills add默认用符号链接落地技能文件。当 Windows 上符号链接创建失败未开开发者模式、非管理员时加--copy让 CLI 改为实体复制npx skills add JuliusBrussee/caveman --copy这条命令适用于 Codex、Cursor、Windsurf 等走npx skills通道的 agent完整 agent 列表与 profile slug 见 INSTALL.md 的 Per-agent install 表。另一个容易踩的坑npx skills add默认写入当前运行目录的./.agents/skills不带-g时按用户全局目录读取技能的 agent如 Cursor 读~/.cursor/skills根本看不到——全局安装要加-g。想要任何 agent 常驻开启静态规则文本对于没有 hook 系统的 agentCursor、Windsurf、Cline、Copilot 等文档最后一节给出always on方案把下面这段规则直接贴进 agent 的 system prompt 或 rules 文件Terse like caveman. Technical substance exact. Only fluff die. Drop: articles, filler (just/really/basically), pleasantries, hedging. Fragments OK. Short synonyms. Code unchanged. Pattern: [thing] [action] [reason]. [next step]. ACTIVE EVERY RESPONSE. No revert after many turns. No filler drift. Code/commits/PRs: normal. Off: stop caveman / normal mode.这段短文本是 skills/caveman/SKILL.md 完整规则的极简压缩版保留技术实质、删掉冠词/填充词/客套/模糊措辞[thing] [action] [reason]. [next step].是其输出句式模板代码块、commit、PR 正文保持正常书写stop caveman或normal mode可随时退出。仓库中统一安装器的对应自动化路径是--with-init它会把规则写入.cursor/rules/、.windsurf/rules/、.clinerules/、.github/copilot-instructions.md、AGENTS.md等各 agent 位置规则正文单一来源为 src/rules/caveman-activate.md在不允许 hook 的受管环境中这是零全局状态、只落当前仓库的合规做法node bin/install.js --with-init --only cursor --only windsurf故障排查速查表把文档与 INSTALL.md 中 Windows 相关的排查要点汇总成一张表症状原因处置irm \| iex执行后被拦截PowerShell 执行策略Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass后重跑报错 Cannot bind argument to parameter Path because it is null旧版脚本对管道下为$null的$PSCommandPath无保护操作issue #565更新到当前 install.ps1函数包装已修复安装成功但settings.json里没有 caveman 条目旧版引号 bug 静默丢失 JSON 合并issue #249用当前 Node 统一安装器重装node bin/install.js --only claude --forceClaude Code 仍用正常口吻claude不在 PATH / hook 未注册node bin/install.js --list确认检测查settings.json中caveman-activate.js重启 Claude CodeSessionStart hook 只在会话开始时触发npx skills add符号链接失败非管理员且未开开发者模式加--copy参数实体复制Codex 装了但 hooks 无效Codex hooks 在 Windows 上当前禁用每会话用$caveman手动开启PowerShell 版本过低最低要求 5.1$PSVersionTable.PSVersion检查后升级小结Windows 上 caveman 的安装失败绝大多数集中在两个根因PowerShell 字符串插值里的引号嵌套历史 JSON 合并丢失与符号链接权限限制。仓库的应对策略是把安装逻辑收敛到单一 Node 脚本bin/install.jsinstall.ps1 退化为纯转发薄壳再为确实走不通的环境提供 docs/install-windows.md 这条手动兜底PowerShell 脚本手工完成SKILL.md复制与marketplace.json合并统一安装器补 hooks 与 statusline--copy与--with-init分别化解符号链接与常驻规则两个问题。按一条式 → 手动 plugin-skill → 统一安装器补全 →--copy/规则文件的顺序逐级回退可以覆盖绝大多数 Windows 环境。【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考