Skip to content
Apothem
博客

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:

  1. Claude Code 插件 —— 在 Claude Code 内部:

    /plugin marketplace add ahmed-g-gad/apothem
    /plugin install apothem@apothem
  2. npx —— 直接从 npm 包 @ahmed-g-gad/apothem 运行 CLI,无需安装步骤:

    npx @ahmed-g-gad/apothem profile init
    npx @ahmed-g-gad/apothem install --harness all --project .
  3. 一次性脚本安装器 —— 放置一个自包含运行时与一个 apothem 启动器(在 POSIX 上为 ~/.local/bin/apothem,当该目录不在 PATH 上时附带 PATH 提示;在 Windows 上为 WindowsApps 中的 apothem.cmd):

    curl -fsSL https://apothem.ahmedgad.com/install.sh | sh    # POSIX

    POSIX 脚本默认校验发布标签的 GPG 签名,当维护者密钥不在本地密钥环中时中止。在维护者发布密钥指纹之前(参见 SECURITY.md),可设置 APOTHEM_VERIFY=checksum 以依据发布的 SHA256SUMS 校验归档文件,或设置 APOTHEM_ALLOW_UNVERIFIED=1 以在不校验标签的情况下继续。

    irm https://apothem.ahmedgad.com/install.ps1 | iex         # Windows
  4. 工具原生插件与扩展 —— 一个 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 公开开发。

On this page