用 git worktree 同时打开两个分支
摘要
- 本文写
git worktree：同一个仓库开出第二个目录，各自停在不同分支。本文按 Git 2.56.0。 - 只是把修改收起来再切回原分支时，用 Git安装和常用命令(最新) 里的
git stash。分支的创建和切换见同一篇的「分支」。 - git-worktree。
用 SSH 密钥签名 Git 提交
摘要
- 本文说明为什么要给提交签名，以及如何用现有的 ed25519 公钥签名，并让 GitHub 把该提交标成 Verified。签名从 Git 2.34 起可用。本文按 Git 2.56.0、
gh2.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 账号
摘要
- 本文写在一台电脑上同时使用个人和公司两个 GitHub 账号：SSH 用不同主机别名选密钥，Git 按目录切换提交邮箱，
gh用gh auth switch切换活动账号。本文按 Git 2.56.0、gh2.103.3。 - 生成密钥的步骤见 Git 的 HTTPS 凭据和 SSH 密钥。
gh auth login见 GitHub CLI 之 gh 命令。按目录使用不同签名密钥见 用 SSH 密钥签名 Git 提交。 - Adding a new SSH key to your GitHub account，Conditional includes。
创建 GitHub Personal Access Token
摘要
- 本文写 GitHub 的两种 Personal Access Token：细粒度令牌（fine-grained）和经典令牌（classic）。每种先说它能访问什么，再写网页上怎么创建，以及在
git、gh和 REST API 里怎么用。gh命令按 2.102.0。 - HTTPS 凭据助手见 Git 的 HTTPS 凭据和 SSH 密钥。
gh auth login见 GitHub CLI 之 gh 命令。 - Managing your personal access tokens，GitHub’s token formats。
GitHub CLI 之 gh 命令
摘要
- 本文写 GitHub 官方命令行
gh的安装、登录，以及仓库、Pull Request、Issue、Release 和 Actions 的日常用法。本文按gh2.102.0 来写。 - Git 本身的安装和提交、分支、推送见 Git安装和常用命令(最新)。命令速查见 Git常用命令(快查手册)。
- GitHub CLI 手册，cli/cli 仓库。
用 opencode-llm-proxy 把模型接到本地 OpenAI 接口
摘要
- 插件仓库：KochC/opencode-llm-proxy，npm 包名
opencode-llm-proxy。本文按插件1.11.2、OpenCode2.1.2来写。 - 它不是单独启动的服务。OpenCode 2.x 的后台服务加载插件后，在本机
127.0.0.1:4010提供 OpenAI、Anthropic、Gemini 兼容接口，模型用的是 OpenCode 里已经登录或配置好的那些。 - OpenCode 2.x 本身的安装、后台服务和插件命令见 opencode 2.x 的安装和使用。
npm -- 用 npm-publish-oidc 发布包
摘要
- Trusted Publishing 的配置、Workflow 权限和 provenance 见 使用 GitHub Actions 和 OIDC 安全发布 npm 包。配好之后，每次发布仍然要在本地升版本、打
vX.Y.Z标签、推上去，再等 GitHub Actions 跑完npm publish。 - npm-publish-oidc 把本地这一段收成项目根目录里的一条命令。它检查项目、按需提升版本、推送提交和标签。
npm publish由该项目的 GitHub Actions 通过 npm Trusted Publishing 完成。 - 当前工作目录就是项目根目录。脚本不会切到自己所在的目录。
brew -- 用 brew-publish-formula 发布 Formula
摘要
- 手写 Formula、创建 Tap 的过程见 brew -- 创建自己的 Formula。版本发上去之后，每次还要自己算下一个版本、推 tag、下载 GitHub 源码包、改
url/sha256，再把 formula 提交进 Tap。 - brew-publish-formula 把这几步收成项目根目录里的一条命令。它读当前仓库的配置、formula 和 git 信息，算出新版本，推送 tag，更新 formula，再把文件同步到本地 Tap。
- 正确的
sha256要等 tag 到达 GitHub 之后才能算。脚本写进项目里的.formula，再复制到 Tap 并在 Tap 仓库提交。Homebrew 读的是 Tap 里的那份。.formula不进项目仓库。 - brew 本身的安装和日常命令见 MacOS软件包管理器--brew。
opencode 2.x 的安装和使用
摘要
-
1.x 的安装和基本用法见 opencode的安装和使用。
-
把已经接好的模型暴露成本地 OpenAI 兼容接口，见 用 opencode-llm-proxy 把模型接到本地 OpenAI 接口。
-
本文写 OpenCode 2.x 的安装、从 1.x 升级，以及升级后配置和日常命令的写法。2.x 文档以英文为准。
MacPorts -- 创建自己的 Port
摘要
- Portfile 是 MacPorts 的安装脚本，对应 Homebrew 的 formula。官方 ports 树里没有的软件，可以放在本机的一个目录里，在
sources.conf登记之后，用同样的port install安装。 - 本地目录要写成
file://，放在带[default]的那一行前面，并加上[nosync]。Portfile 放在分类/名字/Portfile。改完在仓库根目录执行portindex。 - 下面用 brew -- 创建自己的 Formula 里的
color_echo1.0.0 作例子。源码是 GitHub tagv1.0.0的归档，命令文件在bin/color_echo。安装和日常命令见 MacOS软件包管理器--MacPorts。没有brew tap这种命令，个人仓库是一份 Git 上的 ports 树，别人克隆后写进自己的sources.conf。 - 本机 MacPorts 是 2.12.7。
sources.conf里的默认行是ports.tar.gz，不是指南旧示例里的ports.tar。