现象

Codex Desktop 的插件页面可以打开，但插件搜索区和插件卡片出现明显渲染异常：

• 插件卡片内容被横向或纵向错位。
• 文字只显示一部分，部分内容被裁切。
• 右侧预览图、骨架屏和列表区域发生重叠。
• 切换页面、重启应用、清理缓存后仍然复现。

从表现看，这不像插件列表接口失败，更像 Electron / Chromium 渲染层的问题。

初步排查

先确认 Codex Desktop 的版本和运行环境：

/usr/libexec/PlistBuddy -c 'Print :CFBundleShortVersionString' /Applications/Codex.app/Contents/Info.plist
/usr/libexec/PlistBuddy -c 'Print :CFBundleVersion' /Applications/Codex.app/Contents/Info.plist
/usr/libexec/PlistBuddy -c 'Print :CFBundleIdentifier' /Applications/Codex.app/Contents/Info.plist

当时环境信息如下：

Codex Desktop: 26.513.31313
Bundle ID: com.openai.codex
Electron: 42.0.1
macOS: 15.7.7
Architecture: x64
Screen: 3360x2100, density 2

再看本地 Sentry scope 里的请求记录：

jq -r '.scope.breadcrumbs[]
  | select((.message? // "") | test("plugin/list"))
  | [.timestamp, .category, .level, .message]
  | @tsv' "$HOME/Library/Application Support/Codex/sentry/scope_v3.json"

可以看到 plugin/list 请求正常返回，没有接口失败或权限错误。因此问题不在插件市场数据本身。

清理缓存无效

尝试清理 Electron / Chromium 常见缓存：

rm -rf "$HOME/Library/Application Support/Codex/Cache" \
       "$HOME/Library/Application Support/Codex/GPUCache" \
       "$HOME/Library/Application Support/Codex/DawnGraphiteCache" \
       "$HOME/Library/Application Support/Codex/DawnWebGPUCache" \
       "$HOME/Library/Application Support/Codex/Code Cache"

重新打开 Codex 后，插件页仍然错位。由此可以排除普通缓存损坏。

最终修复

解决方案来自 openai/codex#18774。

在 Intel Mac 上，通过启动参数强制 Codex 使用高性能 GPU：

open -na "/Applications/Codex.app" --args --force_high_performance_gpu

执行后，插件搜索页面恢复正常。

这个结果说明：插件页渲染异常与默认 GPU 选择路径有关。--force_high_performance_gpu 避开了默认 Electron / Chromium GPU compositing 路径中的问题。

从 Dock 启动

Dock 里的原始 Codex.app 不能直接附加启动参数。可以创建一个 AppleScript 启动器，再把启动器固定到 Dock。

mkdir -p "$HOME/Applications"

osacompile -o "$HOME/Applications/Codex GPU.app" -e '
do shell script "open -na /Applications/Codex.app --args --force_high_performance_gpu"
'

然后在 Finder 打开 ~/Applications，把 Codex GPU.app 拖到 Dock。之后从这个 Dock 图标启动 Codex，就会自动带上 --force_high_performance_gpu 参数。

如果希望图标和原应用一致，可以手动复制图标：

1. Finder 中选中 /Applications/Codex.app。
2. 按 Cmd + I 打开信息面板。
3. 点击左上角图标，按 Cmd + C。
4. 选中 ~/Applications/Codex GPU.app。
5. 按 Cmd + I 打开信息面板。
6. 点击左上角图标，按 Cmd + V。

原 Dock 里的 Codex 图标仍然不带启动参数，建议移除，只保留 Codex GPU.app。

结论

这不是插件搜索接口问题，也不是本地缓存问题，而是 Codex Desktop 在特定 macOS Intel / GPU 路径上的前端渲染 bug。

临时规避方式是：

open -na "/Applications/Codex.app" --args --force_high_performance_gpu

如果后续 Codex 官方修复了该问题，可以再回到默认启动方式。

GLOBAL AGENTS.md — 个人全局上下文

版本：v2.2 最后更新：2026-05-12 作用范围：所有会话，项目及非项目场景 默认路径：~/.codex/AGENTS.md

1. 角色与语气

• 你是我最信任的技术搭档，不是客服，不是教程生成器。
• 默认使用简体中文回复；代码、术语、专业引用可保留英文。
• 我明确要求英文时，再切换为英文。
• 语气冷静、务实、无客套。
• 避免“当然可以！”“没问题！”“作为一个人工智能助手…”等社交填充或免责声明。
• 回答直接给出结论，随后是必要的推理。
• 不绕弯，不铺垫背景故事，除非我明确要求讲解。

2. 工作流偏好

• 以当前运行环境为准；不要假设一定是 macOS、Linux 或 Windows。
• 我是以终端和编辑器为中心的开发者；优先给出可直接执行的命令、代码或最短操作路径。
• 编码前应明确目标、约束和验收标准；需求含糊或高风险时先指出不确定性，不做隐含假设。
• 需要高风险或不可逆决策时，先提供 2-3 个选项并等待确认；低风险实现细节直接按项目惯例保守处理。
• 多步骤任务尽量拆成可验证的小步；能实际验证时说明结果，不能验证时说明原因和剩余风险。

3. 编码约定

• 默认最小可行实现：只改目标范围，不主动重构、移动文件、拆分模块、添加抽象、配置项或未要求的功能。
• 发现无关的死代码、味道或 bug 可以提醒，但不要擅自修改；除非它直接阻塞当前任务或由本次改动引入。
• 简单优先：能用清晰直接的方案解决，就不要引入额外层级或复杂机制。
• 命名清晰：宁可长一点，不使用无上下文缩写。
• 涉及异步、IO、网络、数据库或外部服务调用时，必须显式处理错误，禁止静默失败。
• 注释解释“为什么”，不解释“做了什么”；不写冗余注释。
• 遵循项目已有的风格和配置，例如 ruff、biome、eslint、prettier 等，不需要我额外提醒。

4. 测试要求

• 若我要求实现新功能，且项目已有测试体系，请同时补充对应测试。
• 优先沿用项目已有测试框架和命令。
• 优先断言具体行为和边界情况，不禁止必要的布尔断言。
• 不主动引入新的测试依赖，除非任务必要且我同意。

5. 安全红线

• 绝对不要在任何地方生成或存储硬编码的密钥、Token、密码。
• 涉及环境变量时，只引用 process.env.XXX 或写入 .env.example，不写真实值。
• 发现存在安全风险的依赖或写法时，必须立即指出并给出改进建议。

6. 数据与并发

• 数据库迁移脚本必须包含回滚方案。
• 并发修改共享状态时，必须使用项目认可的同步机制，例如锁、事务、原子操作、队列或单线程串行化。

7. 规则维护

• 若反复出现同类偏好冲突，可询问是否写入全局规则；未经确认不得修改本文件。
• 未经我明确指令，不要修改任何项目级 CLAUDE.md、.claude/rules/*.md 或 AGENTS.md。
• 本文件默认追加规则；若规则过时、冲突或重复，应在我明确确认后整理、替换或废弃。

8. 行为分层与优先级

• 本文件定义的是个人全局偏好，适用于所有会话。
• 若当前项目存在 ./CLAUDE.md、./AGENTS.md 或 .claude/rules/*.md，项目级规则优先于本文件中的同类规则。
• 当两者发生冲突时，以项目级规则为准；但语气和角色偏好仍尽量遵循本文件设定。
• 全局规则应尽量写成工具无关的行为要求；工具专属规则应放入专属章节或对应工具自己的配置文件。

目标

Skillshare 适合解决一个问题：不同 AI 工具和 Agent 各自维护 skills 目录，手动复制容易混乱，也不方便在多台电脑之间同步。

通过 Skillshare，可以把所有 skills 放到一个源目录，再同步到不同 AI 工具、Agent 或 CLI 的目标目录：

• 单机使用：修改一次，执行 skillshare sync 同步到所有已配置目标。
• 多机使用：通过远端 Git 仓库执行 skillshare push / skillshare pull。
• 第三方 skills：安装前可用 skillshare audit 做安全扫描。

安装

MacOS / Linux

使用安装脚本：

curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

也可以通过 Homebrew 安装：

brew install runkids/tap/skillshare

Windows PowerShell

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

升级

skillshare upgrade

初始化

在终端执行：

skillshare init

初始化会完成三件事：

• 创建 skills 源目录：~/.config/skillshare/skills/
• 检测本机已安装的 AI 工具、Agent 或 CLI
• 生成 Skillshare 配置文件：config.yaml

初始化完成后，可以先查看当前状态：

skillshare status
skillshare target list

添加 Skill

收集已有 Skill

如果本机的 Claude Code、OpenClaw、Codex 或其他 Agent 工具里已经有 skills，可以先统一收集到 Skillshare 源目录：

skillshare collect --all

从 GitHub 安装

skillshare install github.com/<用户名>/<仓库名>
skillshare sync

安装第三方仓库前，建议先做一次安全扫描：

skillshare audit

新建自己的 Skill

skillshare new my-skill

命令会在源目录中生成一个新的 skill 目录，并创建 SKILL.md 模板。编辑完成后执行同步：

skillshare sync

同步机制

修改、新增或删除 skill 后，执行：

skillshare sync

默认同步方式是软链接：各 AI 工具或 Agent 的 skills 目录指向 Skillshare 的源目录。Windows 下会使用 NTFS junctions。

如果软链接在某些环境中不可用，例如 Docker、受限文件系统或同步盘目录，可以切换为 copy 模式：

skillshare target claude --mode copy
skillshare sync

常用命令

跨机器同步

多台电脑共用一套 skills 时，可以给 Skillshare 源目录绑定一个 Git 远端仓库。

1. 创建远端仓库

在 GitHub、Gitee 或自建 Git 服务中创建一个空仓库，复制仓库 URL。

HTTPS 和 SSH 地址都可以，认证由本机 Git 配置处理。

2. 绑定远端

skillshare init --remote <仓库URL>

如果已经执行过 skillshare init，这条命令会绑定远端，不会重置已有源目录。

3. 推送本机更新

第一台电脑改完 skill 后执行：

skillshare push -m "更新说明"

4. 拉取远端更新

第二台电脑执行：

skillshare pull

skillshare pull 会先拉取远端仓库，再执行 skillshare sync。

冲突处理

如果拉取时报本机有未提交改动，可以先提交并推送本机更新：

skillshare push -m "本机更新"
skillshare pull

也可以手动暂存当前改动：

cd ~/.config/skillshare/skills
git stash
skillshare pull
git stash pop

如果提示远端有新提交，先拉再推：

skillshare pull
skillshare push -m "同步更新"

如果出现真实文件冲突，进入源目录手动解决冲突后提交：

cd ~/.config/skillshare/skills
git add .
git commit -m "merge skills"
skillshare sync

使用建议

• 单机使用时，记住 skillshare sync 即可。
• 多机使用时，围绕 skillshare push 和 skillshare pull 建立习惯。
• 安装第三方 skills 前，先运行 skillshare audit。
• 修改 target 同步模式后，再执行一次 skillshare sync。

官方文档：https://skillshare.runkids.cc/docs

目标

通过统一配置，使以下 Git 相关操作自动走本地代理：

• git clone https://...
• git fetch、git pull、git push
• 依赖 Git 下载远程仓库的安装脚本
• 使用 SSH 地址的 Git 操作，例如 git@github.com:<owner>/<repo>.git

以下示例均使用脱敏占位符：

HTTP 代理：http://127.0.0.1:<HTTP_PORT>
SOCKS5 代理：socks5://127.0.0.1:<SOCKS_PORT>

请将 <HTTP_PORT> 和 <SOCKS_PORT> 替换为本机代理客户端实际监听的端口。

Shell 环境变量

将代理环境变量写入 ~/.zshenv，让非交互 zsh、安装脚本和命令行子进程也能继承代理配置。

# 全局代理环境变量，供非交互 zsh 和安装脚本使用
export HTTP_PROXY="http://127.0.0.1:<HTTP_PORT>"
export HTTPS_PROXY="http://127.0.0.1:<HTTP_PORT>"
export ALL_PROXY="socks5://127.0.0.1:<SOCKS_PORT>"

export http_proxy="$HTTP_PROXY"
export https_proxy="$HTTPS_PROXY"
export all_proxy="$ALL_PROXY"

如果只把代理写在 ~/.zshrc，通常只能覆盖交互式终端。~/.zshenv 更适合放置需要被非交互命令继承的环境变量。

交互式终端自动启用

可以在 ~/.zshrc 中保留一个代理开关函数，方便手动启停，同时让新打开的终端自动执行 proxy on。

PROXY_HTTP="http://127.0.0.1:<HTTP_PORT>"
PROXY_SOCKS5="socks5://127.0.0.1:<SOCKS_PORT>"

proxy() {
  case "$1" in
    on)
      export HTTP_PROXY="$PROXY_HTTP"
      export HTTPS_PROXY="$PROXY_HTTP"
      export ALL_PROXY="$PROXY_SOCKS5"
      export http_proxy="$PROXY_HTTP"
      export https_proxy="$PROXY_HTTP"
      export all_proxy="$PROXY_SOCKS5"
      git config --global http.proxy "$PROXY_HTTP"
      git config --global https.proxy "$PROXY_HTTP"
      echo "Proxy ON"
      ;;
    off)
      unset HTTP_PROXY HTTPS_PROXY ALL_PROXY
      unset http_proxy https_proxy all_proxy
      git config --global --unset http.proxy
      git config --global --unset https.proxy
      echo "Proxy OFF"
      ;;
    status|*)
      if [[ -n "$HTTP_PROXY" ]]; then
        echo "Proxy: ON"
      else
        echo "Proxy: OFF"
      fi
      ;;
  esac
}

proxy on

Git HTTP/HTTPS 代理

为 Git 全局配置 HTTP/HTTPS 代理后，https:// 协议的 Git 操作会自动走代理。

git config --global http.proxy "http://127.0.0.1:<HTTP_PORT>"
git config --global https.proxy "http://127.0.0.1:<HTTP_PORT>"

查看当前配置：

git config --global --get http.proxy
git config --global --get https.proxy

取消配置：

git config --global --unset http.proxy
git config --global --unset https.proxy

Git SSH 代理

Git 使用 SSH 地址时，http.proxy 和 https.proxy 不会生效，需要在 SSH 配置中为目标域名设置 ProxyCommand。

编辑 ~/.ssh/config：

Host github.com
  HostName github.com
  User git
  ProxyCommand nc -X connect -x 127.0.0.1:<HTTP_PORT> %h %p
  ConnectTimeout 8

如果代理客户端提供的是 SOCKS5 端口，也可以使用：

Host github.com
  HostName github.com
  User git
  ProxyCommand nc -X 5 -x 127.0.0.1:<SOCKS_PORT> %h %p
  ConnectTimeout 8

为了避免 SSH 配置权限过宽，建议设置：

chmod 600 ~/.ssh/config

验证

验证 Git HTTPS：

git ls-remote https://github.com/<owner>/<repo>.git HEAD

验证 Git SSH：

ssh -T git@github.com
git ls-remote git@github.com:<owner>/<repo>.git HEAD

验证环境变量：

env | grep -i '_proxy'

注意事项

• 代理客户端必须先启动，并确认本地端口处于监听状态。
• 修改 ~/.zshenv 或 ~/.zshrc 后，需要重新打开终端才能自动生效。
• 从 GUI 应用启动的进程不一定继承 shell 配置，必要时需要重启对应应用。
• https:// Git 操作依赖 Git 的 http.proxy、https.proxy 或 shell 代理环境变量。
• git@... SSH 操作依赖 ~/.ssh/config 中的 ProxyCommand。
• 文档中的仓库名、用户名、本地路径和代理端口均已脱敏。

最新更新

随着 Claude Desktop 的版本更新，直接接入三方模型的方式已经无法起作用，目前需要利用本地代理在Claude Desktop和第三方模型API之间进行“中间人”转换，通过模型ID映射来绕过客户端白名单的限制。可以参考 https://github.com/Ltb2539/UpstreamKit 的解决方案，或者选用cc-switch 的本地路由功能解决。

安装步骤

1. 下载 Claude 桌面客户端并安装

前往 Claude 官网下载 MacOS 版桌面客户端，下载完成后按步骤安装。

• 下载地址：https://claude.ai/download
• 安装完成后，首次启动无需登录 Claude 账号。

2. 获取 DeepSeek API Key

登录 DeepSeek 开放平台，创建并复制一个 API Key，稍后会在 Claude 客户端中使用。

• 访问：https://platform.deepseek.com/api_keys
• 点击「创建 API Key」，填写名称后生成。
• 复制并妥善保存 API Key，页面关闭后将无法再次查看。

3. 打开 Claude 客户端的 Developer 模式，修改配置

1. 启动 Claude 客户端，在菜单栏选择 Help → Troubleshooting → Enable Developer Mode，此时菜单栏会出现 Developer 选项。

2. 打开 Developer → Configure Third-Party Inference...，在默认的 Connection 中修改 Gateway 模式下的配置：

   Gateway BaseURL:     https://api.deepseek.com/anthropic
   Gateway API key:     刚生成的 DeepSeek API key
   Gateway Auth Scheme: bearer
   

3. 继续往下拉，在 Model list 中点击 Add，Model ID 输入 deepseek-v4-pro，并开启 Offer 1M-context variant 选项。

   

4. 配置完成后，点击 Apply locally，再点击 Relaunch Now 等待应用重启完成，即可使用 DeepSeek V4 作为第三方模型进行对话。

   

一、Homebrew 加速

1. 清理第三方 Tap

删除了两个从 GitHub 拉取的第三方 tap，避免 brew update 时访问外网：

# 已删除的 tap
brew untap antoniorodr/memo
brew untap qoderai/qoder

删除原因：这两个 tap 没有镜像，每次 brew update 都需要直接从 GitHub 拉取。

2. 配置国内镜像源

Bottles + API（中科大源）

~/.zshrc 中添加：

export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles
export HOMEBREW_API_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles/api

Brew 自身仓库（腾讯源）

Homebrew 核心代码仓库改用腾讯云镜像：

git -C "$(brew --repo)" remote set-url origin https://mirrors.cloud.tencent.com/homebrew/brew.git

选择原因：实测腾讯源 git ls-remote 仅需 0.37 秒，而清华源需要 28.87 秒。

3. 关闭自动更新

~/.zshrc 中添加：

export HOMEBREW_NO_AUTO_UPDATE=1

原因：brew update 即使在国内镜像下，由于 Homebrew 自身 git 仓库体积大，git fetch 仍然很慢。关闭后，brew install 不再自动触发更新。

二、终端代理配置（Clash Verge）

~/.zshrc 中添加代理开关函数：

# 替换 <你的代理端口> 为你实际使用的端口，如 7890 / 7897 / 8080 等
PROXY_HTTP="http://127.0.0.1:<你的代理端口>"
PROXY_SOCKS5="socks5://127.0.0.1:<你的代理端口>"

proxy() {
  case "$1" in
    on)
      export HTTP_PROXY="$PROXY_HTTP"
      export HTTPS_PROXY="$PROXY_HTTP"
      export ALL_PROXY="$PROXY_SOCKS5"
      export http_proxy="$PROXY_HTTP"
      export https_proxy="$PROXY_HTTP"
      export all_proxy="$PROXY_SOCKS5"
      git config --global http.proxy "$PROXY_HTTP"
      git config --global https.proxy "$PROXY_HTTP"
      echo "Proxy ON  ->  $PROXY_HTTP"
      ;;
    off)
      unset HTTP_PROXY HTTPS_PROXY ALL_PROXY
      unset http_proxy https_proxy all_proxy
      git config --global --unset http.proxy
      git config --global --unset https.proxy
      echo "Proxy OFF"
      ;;
    status|*)
      if [[ -n "$HTTP_PROXY" ]]; then
        echo "Proxy: ON  ($HTTP_PROXY)"
      else
        echo "Proxy: OFF"
      fi
      ;;
  esac
}

用法：

proxy on     # 开启终端代理
proxy off    # 关闭终端代理
proxy status # 查看当前状态

作用：让终端中的 git、curl、brew 等命令也能走 Clash Verge 代理，解决 GitHub 访问慢/超时的问题。

三、pip 加速

配置阿里云 PyPI 镜像：

pip3 config set global.index-url "https://mirrors.aliyun.com/pypi/simple/"
pip3 config set global.trusted-host "mirrors.aliyun.com"

配置文件位置：~/.config/pip/pip.conf

四、镜像源速度实测

Homebrew 仓库镜像对比

PyPI 镜像对比

五、当前环境信息

• 系统：MacOS (Intel)
• Shell：zsh
• Homebrew：较新版本
• 代理工具：本地代理客户端（规则模式）