用途:capture 是向 brain 写入内容的统一入口。当用户想保存一条想法、文章片段、转录内容或任意文本时,使用 gbrain capture,而不使用 gbrain put 或先 commit 再 sync。它同时适用于本地安装与 thin-client 安装。
主要能力:输入支持内联参数、--file PATH 或 --stdin。输出为 brain 数据库中的一页,以及 <sync.repo_path>/<slug>.md 磁盘文件,并向标准输出打印回执。写入后页面可立即通过 gbrain query、gbrain search 或任意绑定 MCP 的智能体查询。相同内容具有幂等性,默认 slug 为 inbox/YYYY-MM-DD-<hash8>,daemon 的 24 小时内容哈希去重会拦截重复捕获。所有经此技能的捕获均为本地 CLI 信任(remote: false);不受信任的 webhook 摄取应走 POST /ingest。
使用方式: gbrain capture "the thought I want to remember" gbrain capture --file ./notes/today.md echo "from a pipe" | gbrain capture --stdin gbrain capture "..." --slug daily/2026-05-21 gbrain capture "..." --type idea --source voice-whisper gbrain capture "..." --quiet gbrain capture "..." --json 默认类型为 note,可用 --type 覆盖;frontmatter 会标记 captured_via: capture-cli 与 captured_at;标题取正文首个非空行,上限 80 字符。默认回执为 5 行,--quiet 只输出 slug,--json 输出结构化结果。
适用与限制:适合单条想法、单条笔记、单条转录的简单保存。批量导入大量文件应使用 gbrain sync 或 gbrain import;带作者与出版元数据的文章链接走 idea-ingest;会议转录走 meeting-ingestion。不要用内联参数传递机密内容,因其会进入 shell 历史,应改用 --file 或 --stdin。资料未提供收费、价格与具体平台支持信息。