常见问题

常见问题，按频率排序。

apothem 是什么？Copy Anchor Link

Apothem 是一个面向编码助手工具、与宿主无关的配置管理器。你编写一份共享配置档案，Apothem 会将其物化为每个工具的原生配置面——将行为规则、创意标准、斜杠命令、持久的委派工作者、钩子和技能整合为一套在所有工具中保持一致的受治理语料。

它能与哪些助手工具配合使用？Copy Anchor Link

Apothem 与工具无关。src/apothem/harnesses/<harness>/ 下按工具划分的适配器将共享配置档案投射到每个工具的原生配置目录。运行时工具注册表是受支持工具集合的权威来源；工具页面分别记录了每个工具。该注册表目前涵盖以下受支持的工具：

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai), and Kimi Code

Claude Code 适配器物化到 ~/.claude/；其钩子分派器与宿主无关——它首先从 $CLAUDE_PROJECT_DIR 解析生态系统根目录，然后是 $LLM_PROJECT_DIR，接着尝试相对于脚本与工作目录的查找，最后回退到 $HOME/.claude。

我必须使用计划套件流水线吗？Copy Anchor Link

不必。计划套件流水线只是生态系统的一个组成部分。行为规则、创意标准、钩子和校验器工具链都是各自独立可用的。

如何在不分叉仓库的情况下定制规则？Copy Anchor Link

在 ~/.config/apothem/profile.yaml 的 rules: 列表中添加一个字符串，然后重新运行安装或更新。src/apothem/rules/ 下的规则文件会编辑已打包的源码树，而归档安装器在以 --yes 运行时会替换该源码树。

如何临时禁用某条规则？Copy Anchor Link

要么将该文件重命名到 src/apothem/rules/*.md 模式之外，要么将其移动到加载器不扫描的同级目录中。

规则、技能和委派工作者有什么区别？Copy Anchor Link

• 规则治理行为——助手所遵循的始终启用或路径过滤的义务。
• 技能是可复用的可检测技术——一个检测信号、一套流程，以及一个强制执行钩子。
• 委派工作者是持久的角色，拥有各自的工具限制和系统提示，通过工作者编排协议进行调度。

如何报告安全问题？Copy Anchor Link

参见 SECURITY.md。受支持的渠道是 GitHub Security Advisories 和 [email protected]。

如何参与贡献？Copy Anchor Link

参见参与贡献。简而言之：阅读 CONTRIBUTING.md，分叉仓库，使用填好的规范 PR 模板开启一个 PR，并确保 CI 检查全部通过——开发者指南列出了 PR 必须通过的各道闸门。

生态系统状态保存在哪里？Copy Anchor Link

• 每个套件的计划状态位于 <project>/.apothem/plans/{suite}/ 下。
• Apothem 记忆位于安装根目录之下的 .apothem/memory/ 中（对 Claude Code 为 ~/.claude/.apothem/memory/；当 workspace.scope 为 user-home 时为 ~/.apothem/memory/；对项目范围的安装为 <project>/.apothem/memory/）。Claude Code 自身的自动记忆位于工具配置根目录下的 projects/{hash}/memory/（对 Claude Code 为 ~/.claude/projects/{hash}/memory/）。
• 跨项目记忆位于同一工具配置根目录下的 .apothem/memory/（对 Claude Code 为 ~/.claude/.apothem/memory/）。
• 每个会话的临时草稿位于 <project>/.apothem/plans/{suite}/_inputs/ 下。

我能在新会话或另一台机器上接续长时间运行的工作吗？Copy Anchor Link

可以。长时间运行的工作会把它的完整状态外置到一个项目本地的 .apothem/plans/ 套件中——一份续作契约外加一套冷启动协议——因此该工作并不存在于某一段聊天历史里。由于状态就在你项目的文件中，任何账户或机器上指向同一项目的全新会话都能就地接续该工作。Apothem 本身不会在账户之间推送这些文件；它们以你项目文件本就采用的方式流转（版本控制、共享检出、同步目录）。参见可续作规划。

Apothem 需要 pip 吗？Copy Anchor Link

不需要——引擎本身不需要。引擎是一个自包含的源代码树，内含随附的依赖——它可以从任何检出目录、npx 缓存或插件树，以 python -m apothem 在系统 Python 3.10+ 上运行，并且不会把自己的任何代码安装到 site-packages 中（click 和 rich 是仅有的解释器先决条件）。唯一的可选例外是：如果缺少 click 或 rich，安装器会主动提出仅为这两者运行 pip install——需经你确认，或通过 --yes / APOTHEM_AUTO_INSTALL_DEPS=1 自动进行。Apothem 自己的软件包永远不会被安装到 site-packages 中。

钩子如何在没有已安装软件包的情况下运行？Copy Anchor Link

apothem install 会在工具根目录下具现化钩子调度器和合规闸门（对于 Claude Code 为：~/.claude/.apothem/support/hooks/ 和 ~/.claude/.apothem/support/conformity/），而渲染出的钩子条目通过绝对路径调用这些脚本。两者都是独立的标准库脚本，因此即便在一台从未执行过 pip install 的机器上，这些钩子也能工作。

如何彻底卸载？Copy Anchor Link

对每个已安装的工具运行 apothem uninstall --harness <name>，按你的安装渠道移除引擎，如果你想做到零残留，再删除 ~/.apothem/（备份）以及 ~/.config/apothem/（你的配置档案）。卸载指南对每个渠道都有详细说明。

生态系统采用什么许可证？Copy Anchor Link

MIT——参见 LICENSE。