一句话先记下来，整理可以留到之后。Sprout 的 CLI 可以把你选择的标签同步成工作目录中的素材，再由你使用的 AI 工具读取。
从一个明确的标签开始
例如，在 App 里写下：
今天读到一个观点：记录不是为了积累更多，而是为了再次看见自己的思考。 #读书
这里 #读书 是标签。普通文字“今天读书了”不会匹配标签；#读书笔记 也不等于 #读书。CLI 参数填写 读书，不加 #。
在自己的工作目录授权
先安装 CLI，再进入你想放素材的工作目录。每个工作目录需要独立授权：
npm install -g @sprout-native/cli@0.6.0
sprout login --server https://app.example.com --workspace .
用自己的 Server 地址替换示例地址。打开 CLI 显示的授权网址，在 App 扫描二维码并核对代码，然后允许授权。CLI 不要求输入 App API Key。
标签用于筛选同步素材，不是授权权限的安全边界。
同步读书素材
首次选择一个新的相对目录保存素材：
sprout tags --server https://app.example.com --workspace .
sprout init --server https://app.example.com --workspace . --tags 读书 --materials reading-materials
sprout sync --workspace .
sprout status --workspace .
CLI 保存 Markdown、完整 JSON 与附件，index.json 记录文件映射。之后可让你使用的 AI 工具读取 reading-materials/，例如找出反复出现的观点，或按主题整理阅读记录。
App 与 CLI 本身不运行 AI，也不会替你选择或调用 AI 服务。
新增标签时选择是否补历史记录
例如要同时获取“读书”和“想法”的历史素材：
sprout set-tags --workspace . --tags 读书,想法 --backfill yes
sprout sync --workspace .
--backfill yes 请求补充历史匹配记录；不需要历史补充时明确使用 --backfill no。
保留数据边界
- App 的删除要先同步到 Server 才能影响 CLI 后续同步。
- 停止同步不会自动删除已经下载的本地文本和附件。
- 不要手动编辑 CLI 管理的文件、索引或所有权标记；CLI 会拒绝覆盖外部修改。
- 私人笔记目录与
.sprout/应排除在 Git 之外。 - 把笔记交给 AI 服务前，按自己的需要决定哪些内容可以分享。
更完整的命令说明见 CLI README。