appledger：实践指南

实际评估appledger时，我先确认它解决的具体问题：一个开放的文本记录，记录应用程序的用途、如何组合、做什么以及如何更改，账本保存个人或代理人记录的内容，检查器验证结构和引用，而不是验证记录是否真实。从内容与市场工作的使用方式看，受众、平台规则和事实依据容易被统一模板抹平是采用前必须回答的问题。试跑可以从选一个已有主题制作可人工复核的样稿开始，并把事实准确性、平台适配、语气和修改成本写进验收记录。对有明确品牌标准并保留人工审校的团队来说，这个仓库值得继续验证；只求即装即用的人则要先看维护成本。

appledger

打开文本记录，记录应用程序的用途、如何组合、做什么以及如何更改。

该存储库是规范和参考检查器。同样是一个ForgeTrail项目，所以项目记录是appledger/中的账本。标准格式为spec/。这些是不同的事情。

启动账本

从应用程序文件夹：

pnpm dlx appledger init --name "Workshop notes"
pnpm dlx appledger check

init 创建 appledger/manifest.yaml、profiles/forgetrail.yaml、应用记录和会话记录。第二次运行什么也没写。现有清单、配置文件或记录保留在原处。 Init 不会从文件夹名称推断用途，也不会写入标签。

check 在没有发现错误的情况下打印 ok 和账本路径。它不修改文件。错误是模式、谓词和路径问题。警告意味着记录源丢失、其摘要不再匹配、声明的 git 修订版本不是 HEAD，或者事务日志仍处于打开状态。丢失的文件不会被视为功能已消失的证据。

其他命令以及它们拒绝执行的操作位于 一致性页面 (appledger.dev/docs/conformance) 上。

旧版跟踪迁移在架子切换后已停用。 历史恢复 保留在 Git 历史记录中。

在此存储库上工作

这些命令在此存储库的签出中运行。

pnpm install
pnpm verify
pnpm exec appledger check --root examples/minimal/appledger
pnpm exec appledger check

策展技能为skills/appledger/SKILL.md。命令状态位于 spec/10-tooling-and-automation.md 中。

网站

公共站点是appledger.dev。该文档是 appledger.dev/docs。 site/ 保存这些页面，包括合成的 examples/minimal 分类帐。

许可证

规范和架构为 CC0。检查器是MIT。请参见 LICENSE 和 schemas/LICENSE.md。

ForgeTrail

决策和阶段状态存在于账本中。阶段位于 ForgeTrail 文档页面 (appledger.dev/docs/forgetrail)。