工具适配器
Windsurf
适用于 Windsurf（正式版）的 Apothem 工具适配器。
厂商： Codeium
安装名称： windsurf
状态： 正式版
平台原生配置： <project>/.devin/rules/apothem-rules.md
安装
apothem install --harness windsurf --project /path/to/project该适配器从共享的 Apothem 规则与治理面，写入一个项目级的 Windsurf 规则文件。
写入的文件： <project>/.devin/rules/apothem-rules.md
配置档案到平台原生配置的映射
在每次 apothem install 或 apothem update 运行时，适配器都会读取 Apothem
的共享配置档案并渲染项目规则文件。共享配置档案是事实来源；在下一次同步替换
Apothem 所管理的内容之前，对生成文件的项目本地编辑会先被备份。
兼容性说明
Windsurf 当前的规则面是项目级的，位于 .devin/rules/ 之下。
工作流和机器本地的记忆由操作者所有；Apothem 不会写入它们。
单文件形式的 .windsurfrules 出于设计考虑不会被写入。
验证
apothem verify --harness windsurf --project /path/to/projectverify 命令确认：
- 平台原生配置存在于预期路径。
- 共享配置档案中的所有必需字段均存在。
- 适配器专属的验证例程报告成功。
更新
apothem update --harness windsurf --project /path/to/project从当前的共享配置档案状态重新派生项目规则文件。
卸载
apothem uninstall --harness windsurf --project /path/to/project移除适配器写入的平台原生配置文件。 共享配置档案 YAML 和 Apothem 引擎不受影响。
合规门
python -m apothem.conformity.gate --all .故障排查
| 症状 | 修复方法 |
|---|---|
| 找不到配置文件 | 重新运行 apothem install --harness windsurf --project /path/to/project |
| 验证失败 | 运行 apothem update --harness windsurf --project /path/to/project，然后再次验证 |
| 意外的配置内容 | 检查 ~/.config/apothem/profile.yaml 或 --profile PATH，然后重新运行 apothem update --harness windsurf --project /path/to/project |
配置开关
| 标志 | 默认值 | 说明 |
|---|---|---|
--dry-run | false | 预览安装而不写入文件。 |