开始 / 安装与登录

安装与登录

suisuinian 是一套异步工作系统。从 Mac 端开始，iOS 端会通过 iCloud 自动接上。首次使用，你会在 macOS 上为自己的 vault 起一个位置；iPhone 客户端登入同一 iCloud 账号后自动加入。

# 通过 Homebrew tap 安装 CLI
$ brew install suisuinian/tap/cli

# 在喜欢的位置创建 vault（你的碎念仓库）
$ suisuinian init ~/vault

# 启动后台 daemon · 默认监听 iCloud Drive 变更
$ suisuinian daemon start

daemon 首次运行时，系统会弹出 iCloud 授权与「完全磁盘访问」权限请求 — 这两项是 vault 在 iCloud Drive 与本地之间双向同步的前提。

集成 / MCP

接入 Claude（MCP）

装一个独立的小助手，Claude 桌面版就能读你的 Vault：查会议转译稿、改写纪要、翻生词本、写日记。它是一个单独的命令行程序，由 Claude 在需要时拉起，不依赖碎碎念 Mac App 运行，数据源就是 iCloud Drive 里那个 suisuinian 文件夹。

开始之前，先确认两件事

这台 Mac 装了 Claude 桌面版（claude.ai/download），并且打开过一次。
iPhone 上的碎碎念开着 iCloud，这台 Mac 登录同一个 Apple ID —— 打开「访达 → iCloud 云盘」，能看到一个 suisuinian 文件夹就对了。

三步装好

下载碎碎念助手.pkg（400 KB · Apple 公证 · Intel 和 Apple 芯片通用）。
双击，一路点「继续」→「安装」。不需要输密码 —— 它只装到你的用户目录，不碰系统文件。
按 ⌘Q 彻底退出 Claude 桌面版，再重新打开。光把窗口关掉不算，那样它还在后台跑着旧设置。

第一次用到时，Claude 会问你要不要允许它读碎碎念，点允许就行。如果它说找不到记录库，是 iCloud 还没同步过来，等一会儿即可，不用重装。

装好之后，直接这么问它

我上周的会议录音都聊了什么？
把 8 月 19 日那个会的纪要重写一遍，分成决议和待办两部分
今天该复习哪些单词？
把这段整理成日记记下来：……

8 个工具

工具	干什么	读 / 写
vault_search	全库搜索：标题、摘要、标签、人物、项目。找东西的起点	读
recording_list	列出所有录音，并标注转译稿是否已经落盘	读
recording_transcript	读一条录音的完整转译文本（ASR 原文，不是 AI 摘要）	读
minutes_read	读一条条目的纪要正文、卡片摘要和结构化元数据	读
vocab_list	查个人英语词库：词、音标、释义、例句、复习进度、出处	读
report_daily	读某一天的日报：总结、关键洞察、当天统计	读
minutes_write	改写纪要正文，旧版本自动归档	写
diary_write	往时间流写一条新的文字条目	写

两个写入工具只落产物文件，改动会在 Mac App 下一轮扫描（约 30 秒）后出现在时间流里。两点已知限制：转译稿目前没有说话人标注和时间戳，查内容没问题，「这句是谁说的」答不了；词库这一版只读。

它不会做的事

不会删除你的任何记录 —— 压根就没做删除功能。
不会把数据传到网上 —— 只读你这台电脑上的 iCloud 文件夹。
不会碰 Dashboard.json（时间流的索引）。最坏情况是改错一个文件，而不是弄丢整条时间流。
改写纪要时，旧版本自动留一份在 core/meta/minutes-history/，改坏了能找回。
不会动你在 Claude 里已有的其它设置 —— 只往配置里加一条。

开发者：自己接别的 host

助手是一个 stdio 上的 MCP server，任何 MCP host 都能拉起它。Claude Code 一条命令：

# 注册到 user scope，所有项目可用
$ claude mcp add --scope user suisuinian -- \
    "$HOME/Library/Application Support/suisuinian/suisuinian-mcp"

# MCP server 在 session 启动时加载，配完开一个新 session 才生效
$ claude mcp get suisuinian

其它 host 手写配置（Claude 桌面版的这份 pkg 已经自动写好了，下面这段是备查或修复用）：

{
  "mcpServers": {
    "suisuinian": {
      "command": "/Users/你的用户名/Library/Application Support/suisuinian/suisuinian-mcp"
    }
  }
}

Vault 会自动在 iCloud Drive 里找；库放在别处就加 --vault /path/to/vault 参数，或设环境变量 SUISUINIAN_VAULT。

不想要了怎么卸载

访达里按 ⌘⇧G，输入 ~/Library/Application Support/suisuinian，把这个文件夹删掉。
打开 Claude，跟它说「帮我从配置里移除 suisuinian」。