Skip to content

CLAUDE.md

Latest commit

 

History

History
53 lines (39 loc) · 4.16 KB

CLAUDE.md

File metadata and controls

53 lines (39 loc) · 4.16 KB
Raw

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

概述

这是一个 macOS 个人环境配置仓库（dotfiles），管理 shell 配置、开发工具、代理设置、Homebrew 包列表等。仓库通过 $ENV 环境变量引用，值为 ~/Workspace.localized/env。

仓库结构

  • bin/ — 自定义可执行脚本和工具的包装器。许多是符号链接，指向 package/yyscripts/wrapper.sh 或 bin/zoo/ 中的入口点。bin/zoo/ 下的 javan 是多版本 Java/Maven 命令的统一入口（java8, mvn21 等通过符号链接名称区分版本）。bin/claude 及其符号链接变体（claude-glm, claude-mini 等）根据名称加载对应的 etc/secret/*.env 环境变量。
  • etc/ — 各类应用配置：zsh/（oh-my-zsh 自定义配置）、git/（gitconfig）、sing-box/（代理配置，使用分片 JSON）、ssh/、hammerspoon/、claude/、Brewfile 等。
  • etc/zsh/ — oh-my-zsh 的 $ZSH_CUSTOM 目录。env.zsh 设置环境变量，alias.zsh 定义别名，tools.zsh 配置开发工具，proxy.zsh 管理代理。
  • etc/secrets/ — 通过 sops 加密的 .env 文件（secret.env 在 zsh 启动时自动 source；claude-*.env、gemini*.env 由对应包装器按 wrapper 名按需加载）。规则在仓库根 .sops.yaml。
  • etc/claude/ — Claude Code 的全局配置源（settings.json、CLAUDE.md 等），通过软链同步到 ~/.claude/。
  • lib/bash/ — 可复用的 bash 函数库：color.sh、console.sh、docker.sh、fs.sh、github.sh、java.sh、json.sh、native.sh，通过 source 引入。
  • package/ — Git submodule。zsh 相关在 package/zsh/ 下（oh-my-zsh、powerlevel10k、fast-syntax-highlighting、zsh-autosuggestions、zsh-history-substring-search），其余在 package/ 顶层（yyscripts、archey-osx、custom-alfred-iterm-scripts、gost）。
  • preferences/ — 应用偏好设置备份（Alfred、Chrome、iTerm、mpv 等）。

常用命令

# 更新所有 submodule 和子目录中的 update.sh，以及 homebrew
./update.sh

# 仅更新 submodule，不更新 homebrew
./update.sh --no-brew

# 更新并执行 git gc
./update.sh --gc

# 跳过指定子目录（可重复，按路径后缀匹配，如 sing-box 或 etc/sing-box）
./update.sh --skip sing-box

# 解密 sops 加密的 env 并 export 到当前 shell
eval "$(sops-env <name>)"   # 例如 sops-env claude-glm

# 直接查看明文
sops decrypt etc/secrets/<name>.env

关键约定

  • Git 配置：commit 默认启用 SSH 签名（gpg.format = ssh，signingkey = ~/.ssh/id_ed25519.pub），pager 使用 delta（side-by-side 模式）。
  • 代理：GitHub/GitLab/Bitbucket 的 HTTP 代理设置为 http://127.0.0.1:7890，SSH URL 统一重写为 HTTPS。
  • sing-box 配置：etc/sing-box/config/ 下为分片 JSON 文件，由 sing.sh 组装。修改配置后使用 reload.sh 重载。
  • Homebrew：etc/Brewfile 记录所有已安装的包。brew-up.sh 和 brew-livecheck.sh 是自定义更新脚本。
  • Zsh 入口：etc/zshrc 是 .zshrc 的实际内容，设置 $ZSH_CUSTOM 指向 etc/zsh/，主题根据终端选择 powerlevel10k 或 robbyrussell。
  • Secrets 加载：bin/claude（及 claude-glm/claude-mini/claude-open/claude-xiaomi 等同名软链）按调用名 $0 从 etc/secrets/<name>.env 中 sops decrypt 出 env 并 export，再 exec 真实 claude；同样模式适用于 gemini/gemini-x。
  • 多版本 Java：bin/zoo/javan 是统一入口，调用名按正则 <cmd><version> 解析（如 mvn21、java8、ijhttp21、mvn-release-17.sh），最终通过 java-home -v <version> 选版本执行。
  • 日志查询：seqbox 查询 Seq 中的 sing-box 连接日志，实现在 submodule package/yyscripts/seqbox.py。详见 docs/seqbox.md。
  • 订阅 UA 探测：etc/sing-box/ua-diff.py 比较不同客户端 UA 能从订阅拉到多少可用节点。 动它之前先读 docs/ua-diff.md——不要真实请求订阅 URL（消耗限速额度），验证一律用离线单测。