用途：当用户提到 Heptabase 或分享 app.heptabase.com 链接时，通过本地 heptabase CLI 读写数据，而不是直接在浏览器打开（应用需登录）。
前置条件：CLI 由桌面应用安装，命令为 heptabase。使用前用 heptabase --version 检查版本，需落在 0.7.x 兼容范围内，否则停止并请用户更新桌面应用或技能包。用 heptabase help 及各命令 --help 发现语法。
常见用法：heptabase card list --sort createdTime --direction descending --limit 20；heptabase journal read $(date +%Y-%m-%d)；heptabase card list -q "<keyword>"；heptabase note create --content；heptabase note append <cardId> --content；heptabase note save <cardId> --content-md5 <contentMd5> --content-file <path>。属性用 card set-property 等；PDF 用 pdf metadata/read；转录用 audio/video metadata/read。深链接按 card/whiteboard ID 处理，workspaceId 无需传入。
要求：写 ProseMirror JSON 前必须阅读 card-content-schema；处理属性、文件、图片、PDF、转录、白板前分别先读对应参考文档。所有输出为 JSON，可用 jq 解析。嵌套或批量数据用 --input <path|->，勿手工拼接不可信文本为 shell JSON。每次变更后检查结果，顶层 status 为 failed 时退出码 1，成功也可能含 failureReasonCode。
限制：需桌面应用运行，可用 heptabase start 启动；请求体上限 1 MB，file import 最大 2000 MB，JSON 请求 10 秒超时；文件导出仅限本地已有文件；只支持图片导入（不支持 HEIC/HEIF/TIFF 等）；白板不能删除、跨空间移动或自动整体布局；无 CLI 撤销；属性筛选暂不支持；仅可用 CLI 访问数据，禁止绕过操作本地数据库。