用途:维护、验证和发布 graincrawl——本地优先的 Granola 归档 CLI。它把 Granola 的笔记、转录、面板、人物、工作区及同步元数据归档进私有本地 SQLite 库,对 Granola 源保持只读,并以 SQLite 优先的方式浏览与导出,与其他 crawl 应用保持一致。
主要能力:支持多种 Granola 源适配器,包括 private-api、desktop-cache、encrypted-json、opfs、public-api 和 companion-cli;可验证笔记、转录、面板、源对象、搜索、Markdown 导出及 TUI 行为;支持 crawlkit 控制元数据、快照与 TUI 集成;可准备发布、Homebrew formula 或刷新本地二进制。
使用方式:从当前仓库、用户指定路径或配置的工作区根目录定位 checkout,发布、源适配器或解锁前先阅读 AGENTS.md、README.md、SPEC.md 和 docs/security.md。普通 doctor、status、notes、export、tui 命令不得触发 Keychain、解包 safeStorage 或修改 Granola 配置文件。测试与冒烟检查应使用临时 HOME、XDG 目录、配置和 SQLite 数据库,除非用户明确要求,否则不要改动线上 ~/.config/graincrawl 归档或 Granola 应用数据。UI/导出优先读取已归档的 SQLite。本地门禁命令:GOWORK=off go mod tidy;git diff --exit-code -- go.mod go.sum;GOWORK=off go vet ./...;GOWORK=off go test -count=1 ./...;make smoke;goreleaser check。发布使用语义化版本标签并验证 tap 路径,例如 git tag -a v0.1.0 -m "graincrawl v0.1.0"、git push origin main v0.1.0、HOMEBREW_NO_AUTO_UPDATE=1 brew install --build-from-source vincentkoc/tap/graincrawl、HOMEBREW_NO_AUTO_UPDATE=1 brew test vincentkoc/tap/graincrawl。应用改动后按需刷新本地二进制:GOWORK=off go build -trimpath -o ~/.local/bin/graincrawl ./cmd/graincrawl,再用 graincrawl version --json 验证。
适用场景:编辑或审查 graincrawl checkout、调查 Granola 源适配器、修复本地归档或 TUI、准备发布与 tap 更新、刷新本地二进制。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;涉及私有 API、Keychain、safeStorage、OPFS 或线上配置文件的边界操作需明确记录,且不应在常规命令中触发。