飘逸峰的博客

摘要

• 本文写 CodeGraph 的安装、把 MCP 接到 Cursor 等 Agent、给项目建索引，以及日常用 codegraph_explore / CLI 查符号、调用链和改动影响面。索引落在项目本地的 .codegraph/，不上传代码。
• 操作环境按 macOS，CLI 按 @colbymchenry/codegraph 1.6.2。Linux / Windows 安装命令一并给出；Agent 侧以 Cursor 为主，顺带覆盖 Claude Code、Codex CLI、opencode 等安装器支持的目标。
• Get Started，Installation，CLI，MCP Server，Integrations。同系列流量追踪见 记录 Claude Code、OpenCode、Codex-Cli 的 请求/响应 数据。

面向第一次申请 OAuth 的读者：在 Google Cloud 登记客户端、申请 Gmail 范围，浏览器里点允许，再用 curl 换成 refresh token。
另有一节专讲 scope 的作用以及如何申请、修改、删除。截图以一次实际操作为例。控制台按 2026 年 11 月的 Google Auth Platform。正文已加密。

摘要

• 本文写 Oracle JDK 的发布节奏、LTS 的 NFTC / OTN 许可，以及 class 文件主版本号和 JDK 版本的对照。后半部分在 Linux 上用 tar.gz 安装 Oracle JDK，并把 JAVA_HOME 指到 /usr/local/jvm/jdk。
• 许可和支持期限按 2026-10-20 更新的许可 FAQ，以及 Oracle Java SE Support Roadmap。安装步骤按 Oracle JDK 25.0.5 的 Linux x64 Compressed Archive。
• Oracle Java SE Support Roadmap，Oracle Java SE Licensing FAQ，Java Downloads，Archived Oracle Java SE Releases。

摘要

• 本文写 git 连接 GitHub 等远程仓库时的两种认证：HTTPS 远程用凭据助手保存令牌，SSH 远程用密钥。macOS 的凭据助手按钥匙串 osxkeychain 来写。本文按 Git 2.56.0。
• 令牌怎么创建见 创建 GitHub Personal Access Token。两个账号各用一把密钥见 同一台电脑使用两个 GitHub 账号。credential.helper 所在的配置文件见 Git 的用户配置 ~/.gitconfig。
• gitcredentials，Adding a new SSH key to your GitHub account。

摘要

• 本文写当前用户的 Git 配置文件 ~/.gitconfig：它为什么存在、和仓库里的 .git/config 谁生效、怎么创建和修改、常用项，以及怎么核对实际读到的值。core.quotepath 决定 git status 里的中文路径是原样显示，还是印成八进制转义。本文按 Git 2.56.0。
• HTTPS 凭据助手见 Git 的 HTTPS 凭据和 SSH 密钥。按目录换邮箱见 同一台电脑使用两个 GitHub 账号。签名密钥写在这个文件里，见 用 SSH 密钥签名 Git 提交。
• git-config。

摘要

• 本文写给一个仓库的 main 加上规则：禁止直接推送、禁止 force push、合并前必须通过指定的 Actions 检查。页面按 Creating rulesets for a repository 的当前流程。
• 分支上的 Pull Request 怎么开，见 Git安装和常用命令(最新) 的「创建 Pull Request」一节和 给别人的 GitHub 仓库提 Pull Request。提交签名见 用 SSH 密钥签名 Git 提交。Actions 里检查项的名字见 GitHub Actions Workflow 详细指南。
• Available rules for rulesets。

摘要

• 本文写没有对方仓库写权限时，如何 fork、在自己的仓库上推分支，再向原仓库开 Pull Request。本文按 gh 2.103.3、Git 2.56.0。
• 自己仓库里直接推分支再开 PR，见 Git安装和常用命令(最新) 的「创建 Pull Request」一节。gh pr create 的其余参数见 GitHub CLI 之 gh 命令。登录见同一篇。
• gh repo fork。

摘要

• 本文写 git worktree：同一个仓库开出第二个目录，各自停在不同分支。本文按 Git 2.56.0。
• 只是把修改收起来再切回原分支时，用 Git安装和常用命令(最新) 里的 git stash。分支的创建和切换见同一篇的「分支」。
• git-worktree。

摘要

• 本文说明为什么要给提交签名，以及如何用现有的 ed25519 公钥签名，并让 GitHub 把该提交标成 Verified。签名从 Git 2.34 起可用。本文按 Git 2.56.0、gh 2.103.3。
• 密钥本身的生成见 Git 的 HTTPS 凭据和 SSH 密钥。两个账号各用各的密钥见 同一台电脑使用两个 GitHub 账号。仓库要求签名才能合并时，见 用 Rulesets 保护 GitHub 的 main 分支。
• Telling Git about your signing key，Adding a new SSH key to your GitHub account。

摘要

• 本文写在一台电脑上同时使用个人和公司两个 GitHub 账号：SSH 用不同主机别名选密钥，Git 按目录切换提交邮箱，gh 用 gh auth switch 切换活动账号。本文按 Git 2.56.0、gh 2.103.3。
• 生成密钥的步骤见 Git 的 HTTPS 凭据和 SSH 密钥。gh auth login 见 GitHub CLI 之 gh 命令。按目录使用不同签名密钥见 用 SSH 密钥签名 Git 提交。
• Adding a new SSH key to your GitHub account，Conditional includes。