Apothem v1.0.1 —— 发布版本
Apothem v1.0.1 现已发布 —— 一份共享配置档案物化为十七种工具、多条安装路径,以及一个已签名、带凭证的版本。
Apothem v1.0.1 是这款面向助手工具的与宿主无关配置管理器的发布版本:一份共享 配置档案、十七种工具、单一已签名版本,以及随版本本身附带的供应链 证据。
论点:一份配置档案,十七种工具
Apothem 读取 ~/.config/apothem/profile.yaml 处的单一共享配置档案,并把它
物化为每种工具所期望的原生配置。你只需一次性编写自己的行为规则、技能、
钩子与约定。Apothem 会把它们渲染为十七个工具原生目标,并保持同步。
本版本中的十七个适配器:
- antigravity
- claude-code
- codebuddy
- codex
- cursor
- gemini-cli
- github-copilot
- glm
- hermes
- kimi-code
- kiro
- open-claw
- opencode
- qwen-code
- trae
- windsurf
- zed
向你的工作流添加一个工具,运行一条命令,你的配置即刻就位。移除一个工具时,Apothem 会删除它所写入的文件;共享的记忆、上下文与学习存储会在最后一个工具被移除时、备份之后一并移除,而 plans/ 始终保留。
安装
多条安装路径,底层共用同一个 CLI:
-
Claude Code 插件 —— 在 Claude Code 内部:
/plugin marketplace add ahmed-g-gad/apothem /plugin install apothem@apothem -
npx —— 直接从 npm 包
@ahmed-g-gad/apothem运行 CLI,无需安装步骤:npx @ahmed-g-gad/apothem profile init npx @ahmed-g-gad/apothem install --harness all --project . -
一次性脚本安装器 —— 放置一个自包含运行时与一个
apothem启动器(在 POSIX 上为~/.local/bin/apothem,当该目录不在PATH上时附带 PATH 提示;在 Windows 上为 WindowsApps 中的apothem.cmd):curl -fsSL https://apothem.ahmedgad.com/install.sh | sh # POSIXPOSIX 脚本默认校验发布标签的 GPG 签名,当维护者密钥不在本地密钥环中时中止。在维护者发布密钥指纹之前(参见
SECURITY.md),可设置APOTHEM_VERIFY=checksum以依据发布的SHA256SUMS校验归档文件,或设置APOTHEM_ALLOW_UNVERIFIED=1以在不校验标签的情况下继续。irm https://apothem.ahmedgad.com/install.ps1 | iex # Windows -
工具原生插件与扩展 —— 一个 Gemini CLI 扩展 (
gemini extensions install https://github.com/ahmed-g-gad/apothem)、一个 Qwen Code 扩展(qwen extensions install ahmed-g-gad/apothem),以及一个 Codex 插件(codex plugin marketplace add ahmed-g-gad/apothem)。覆盖 VS Code 与 GitHub Copilot 的 VS Code 系扩展,其源代码位于仓库的vscode-extension/目录中。该扩展未在 Visual Studio Marketplace 上架, 本次发布也未附带打包好的.vsix。
供应链态势
GitHub Release v1.0.1 随代码一并携带了完整的证据集:
- sdist 与 wheel,在发布前校验过。
- 一份 CycloneDX SBOM。
- 为 sdist、wheel 与各平台运行时归档生成的 Sigstore cosign 无密钥签名包。
- SLSA-3 构建溯源,在发布工作流内部本身已经过验证。
- 平台运行时归档(darwin / linux / windows),附带一份已签名的
SHA256SUMS清单。
版本提交经 GPG 签名(v1.0.1 是轻量标签,本身没有签名),npm 包发布时附带在
GitHub Actions 中生成的 Sigstore 构建溯源。
箱内之物
apothem CLI 暴露出你在完整配置生命周期中所需的操作者命令:
apothem install—— 把配置档案物化到一种工具或全部工具。apothem uninstall—— 移除某种工具的已物化配置,而不触动共享配置 文件。apothem update—— 在你编辑配置档案后重新物化。apothem verify—— 检测配置档案与某种工具磁盘配置之间的漂移。apothem harnesses—— 列出每个已注册的适配器。apothem profile—— 检视并管理共享配置档案。apothem doctor—— 诊断环境与配置问题。
每个工具适配器都实现统一的 HarnessAdapter 协议——install、update、uninstall、is_installed、verify——因此,无论底层厂商格式如何,从操作者的视角看,每个工具的行为都可预测。关于这一设计的更多内容,请阅读适配器架构深度解析,关于格式调和的更多内容,请阅读跨工具约定收敛。
下一步去哪里
Apothem 采用 MIT 许可,并在 github.com/ahmed-g-gad/apothem 公开开发。