Hermes Windows Setup 是一套针对 Windows 机器的、以仓库为中心的 Hermes 智能体安装与配置流程。其目标是产出与 Linux 上 workspace-hub 相同的工作区模式：技能、记忆与配置都存放在 git 仓库内，供所有智能体共享。该技能仅适用于 Windows；在 Linux 上应使用标准 workspace-hub 模式。规则要求：工作区仓库（.claude/）是唯一来源，而非全局智能体配置；所有技能与记忆文件必须纳入 git 跟踪；不得提交 .env 文件或 API 密钥；Windows 上使用 python 而非 python3；脚本执行使用 uv run <script.py>；Git 的 core.autocrlf 在 Windows 上必须为 true。
用途与适用范围：在 Windows 上从零搭建可多智能体共享的工作区，或让 Claude Code 直接在仓库根目录读取 .claude/ 下的技能与记忆，保留 Hermes 的大部分优势。
主要能力与阶段：前置检查 Git for Windows、Python 3.12+、uv、GitHub CLI、Windows Terminal（推荐 PowerShell 7+）；创建工作区目录 C:\workspace-hub 并克隆仓库及子仓库；用 uv venv 创建 Python 环境并安装依赖；安装 Hermes 智能体（install.ps1 脚本、hermes setup、在 config.yaml 的 skills.external_dirs 中指向 C:\workspace-hub.claude\skills）或安装 Claude Code；建立 .claude/skills 与 .claude/memory 结构并确保 workspace-cli、repo-structure、clean-code、memory-bridge-operation 等技能文件存在；记忆桥将 user.md、project.md 纳入 git 跟踪并为所有智能体共享；Git 配置含 core.autocrlf true、core.eol crlf、SSH agent 与 .gitignore；按顺序执行 git status、Python 版本、gh auth status、hermes chat 等验证步骤；首次运行指向 C:\workspace-hub 并以读取 .claude/AGENTS.md 的提示测试。
使用方式要点：外部技能目录为只读，Hermes 读取但不写入，且同名时本地 ~/.hermes/skills/ 优先；多智能体可共用同一目录，用 hermes -w 或 git worktree 避免 Git 争用；后台进程使用 Start-Process 或 hermes chat -q 的一次性模式。
限制与注意：Windows 与 Linux 在命令、路径分隔符、shebang、换行、后台运行、终端、SSH agent、主目录上存在差异，应使用 python 与 uv run 而非依赖 shebang。2026-04-11 的对等性审计指出：Git Bash 为必需（钩子大量调用 bash）；Node.js 与 Claude Code 认证需可用；Git Bash 内需安装 uv，部分钩子仍调用 uv run；需提供 python3 兼容别名或修改钩子；Git Bash 需安装 jq；harness-config.yaml 中的 ws_hub_path 可能仍为 null，需设为实际路径；安装后应有 .claude/state/harness-readiness-ace-win-1.yaml 就绪证明；若 issue #1918 仍未关闭，Windows 自动记忆回写仓库尚不完整，可消费共享上下文但未必自动发布新经验。常见问题包括杀毒软件拦截（可添加排除路径）、PowerShell 执行策略（Set-ExecutionPolicy RemoteSigned）、MAX_PATH 260 限制（启用长路径）、VS Code 终端找不到 Python（切换到 PowerShell 并检查系统 PATH）、可选 WSL2（工作区文件保留在 Windows 文件系统以便跨工具访问）。故障排除涵盖 uv/python 未识别（重启终端或检查 PATH）、Git SSL 证书错误（代理配置）、技能未加载（检查 external_dirs 与 SKILL.md，用 /new 重载）、记忆未持久化（检查记忆文件与 memory_enabled 配置）。