01
窗口的四个区域#
| 区域 | 是什么 |
|---|---|
| 左侧栏 | 画布列表、最近删除和设置入口。可以拖宽,宽度会记住。 |
| 工具栏 | 撤销、搜索、新建、粘贴、AI 分组、一键整理和面板开关。 |
| 画布 | 中间那片可以平移、缩放的空间,卡片住在这里。 |
| 右侧面板 | AI 工作助手:带依据的发现、对话、To-do 和运行状态。需要时打开,不用时收起。 |
画布左下角显示卡片数量;右下角的提示条会告诉你内容落在哪里,几秒后自行消失。窗口变窄时,工具栏会先把文字收成图标,再把次要操作收入溢出菜单。
02
把东西放进来#
| 方式 | 落在哪 |
|---|---|
| ⌘V(先点画布) | 指针附近 |
| ⇧⌘V | 当前画布,不用先点 |
| 从别处拖进来 | 松手的位置 |
| 拖到 Dock 图标 | 默认画布正中,App 没开也能接 |
| 工具栏 + / 空白处右键 | 新建文字、链接、图片或文件 |
| Finder 里放入文件库 | 对应画布出现“待摆放”卡片 |
粘贴什么就得到什么:文字成为 Markdown 卡片,网址成为链接卡片,图片和文件保留为真实文件。在工作窗口阅读一张卡片时粘贴,新卡片会落在它旁边并自动成组,不会被挡在身后。
03
卡片#
| 类型 | 磁盘上是什么 | 主要能力 |
|---|---|---|
| 文字 | .md 文件 | 双击打开工作窗口,进入写作页 |
| 链接 | 网址 | 卡片内浏览、登录并保留自己的历史 |
| 图片 | 真实图片 | 卡片内缩放和平移 |
| 文件 | 任意文件 | PDF 内联阅读;其余使用系统预览 |
拖顶部横条移动,拖四角缩放。双击卡片会在画布上方的窗口里打开;同时打开多张时,暂时不看的会收进底部工作台,点一下即可切回。顶边细线表示卡片类型,颜色可在设置中修改。文字卡片可以直接编辑,待办也能在小卡片上勾选。
04
选择与移动#
| 操作 | 结果 |
|---|---|
| 点一张卡片 | 成为当前卡片 |
| 空白处拖动 | 框选;碰到就算选中 |
| Shift + 框选 | 在已有选择上继续加 |
| ⌘ 点卡片 | 单张加选或取消 |
| Esc | 取消全部选择 |
多选后拖动,所有选中的卡片会保持排布一起移动。移动一张卡片从不改变其他卡片的位置。 ⌥ 拖会复制指针下的那张卡片;Delete 会删除全部选中项。
05
分组#
拖一张卡片到另一张上、选中后按 ⌘G,或使用 AI 分组,都可以建立分组。
分组是画布上的彩色虚线框。拖任何一条边都能移动整组;卡片中心越过外框才会脱组。
| 动作 | 做什么 |
|---|---|
| 整理这一组 | 只重排组内卡片,其他内容不动 |
| 归档 | 变成真实画布和真实文件夹,会先询问 |
| 解散 | 只去掉框,卡片留在原地 |
| 重命名 | 修改组名,也会成为归档后的文件夹名 |
⇧⌘G 可以取消编组。分组也是一个堆叠单元:碰到其中任何部分,外框和全部成员会一起到最前。
06
卡片窗口与工作台#
双击任何卡片,它会在画布上方的窗口里打开,阅读、写作和浏览都在这里进行。窗口可以并排打开;暂时不看的会收进底部工作台,内容和进度不会丢失。
窗口中双指缩放只作用于当前内容:文字会重排,网页调整页面缩放,图片和 PDF 各自缩放。身后的画布不会移动。按 Esc 关闭当前窗口。
07
写作页#
双击文字卡片,在工作窗口里打开 Markdown 写作页。按 / 插入文本、标题、列表、待办、引用、提示、代码块或分割线;也可以直接输入 #、-、1.、> 等 Markdown 前缀。
列表或待办中按 Return 会继续当前块;在空项目上按 Return 会走出这个块。表格使用类似 Notion 的行列抓手:可以选中整行或整列、拖动排序,也可以拖出去拆成一张新表。图片支持对齐与缩放;从空白处拉框可以整块选择多个段落。
指向段落左侧会出现六点手柄:
- 在页面内拖:移动段落,蓝色横线显示落点;长文档会自动滚动。
- 拖出页面:变成画布上的关联卡片,两边内容保持同步。
- ⌥ 拖出:制作独立副本,不再同步。
第一行是笔记名字,同时也是卡片标题和磁盘文件名,因此不能移动。一次移动等于一步撤销。
08
网页卡片#
链接卡片是一个真正的浏览器:可以点击、滚动和登录,每张卡片保留自己的浏览记录。
地址栏右键可以把当前页面设为收藏起点、复制当前链接或清空记录。网页身份只存在这台 Mac,不读取也不共享 Chrome 或 Safari 的 Cookie、密码和历史。切换画布时网页会暂停,内存紧张时自动收缩活动页面数量。
09
图片与文件#
图片可以在卡片内缩放和平移;PDF 可以直接阅读并记住上次的位置;其他文件使用 macOS 系统预览。按 空格 快速查看当前卡片。
文件库外的文件,例如桌面和下载文件夹里的文件,只会被引用,put·here 从不擅自移动它们。
10
画布与侧栏#
画布最多两层:子画布对应真实文件夹中的子文件夹。每块画布分别记住自己的平移和缩放。打开一块有内容却看不见卡片的画布时,镜头会移到最新卡片,而不是移动卡片。
侧栏中:点击打开,双击名字重命名,拖动重排或嵌套。菜单可生成简报、在 Finder 中打开、新建子画布或删除画布。删除整个画布会连同文件夹进入 Finder 废纸篓,并且一定先询问。
11
搜索与找回#
工具栏搜索会边输入边过滤全部画布。
| 写法 | 找什么 |
|---|---|
| 任意文字 | 标题或正文包含它的卡片 |
| /文本 或 /text | 文字卡片 |
| /图片 或 /image | 图片卡片 |
| /文件 或 /file | 文件卡片 |
| /链接 或 /link | 链接卡片 |
| /重复 或 /duplicate | 内容相同的卡片 |
语义搜索需要 AI,会跨画布按意思查找,并告诉你结果在哪块画布、为什么匹配。它按时间倒序读取最近 400 张候选;未覆盖全部时会明确提示。
12
AI#
AI 完全可选。没有配置 AI 服务,就不会发出 AI 请求。
| 功能 | 做什么 |
|---|---|
| AI 分组 | 读取画布,把相关卡片圈成带名字的组 |
| 卡片说明 | 为卡片保存一句可复用的说明 |
| 语义搜索 | 跨画布按意思找 |
| 画布简报 | 总结在做什么、缺什么、下一步做什么 |
| 画布对话 | 就着当前画布聊天,把回答存成卡片 |
| 交给 AI | 从问题卡片发起调研,在独立工位里工作,每条发现都保留原文出处 |
分组有程序保证的边界:不会删除你建的组;同名组会延续;AI 可以向组里加卡片,不能拿走;再次分组只发送未分组卡片;少于两张不成组,一次最多处理 300 张。
支持 DeepSeek、OpenAI、Claude、Kimi、智谱 GLM、通义千问、OpenRouter、本地 Ollama 和任意 OpenAI 兼容接口。普通用户使用自己的 API Key;选择本地 Ollama 时内容不出本机。
13
右侧面板#
工具栏最右侧按钮打开「AI 工作助手」。不用时可以完全收起。
- AI 看到的:从画布结构中整理出来的少量发现,每条附带依据。
- 对话与 To-do:就着这块画布交流,有用的回答可以保存成卡片。
- 运行状态:AI 调研时显示当前动作、进度和停止按钮。
- 回执:一次运行结束后,查看做了什么、发现了什么、还剩哪些问题。
14
把卡片连起来#
鼠标停在卡片上,把底部的小圆点拖到另一张卡片,即可建立连接。不必立即命名;点线以后再选「因为」「支持」「反驳」「引出」「存疑」。
当前界面显示同一画布内卡片之间的手动连线。连线会保存,也支持撤销。AI 自动判断并推荐连线尚未发布。
15
交给 AI:工位与出处#
在一张写着问题的文字卡片上点右键,选择「交给 AI」。AI 在独立的子画布(工位)里读取材料、制定计划、查找网页,并留下来源卡片与发现。
每条发现都需要实际引用的原文支撑。打开过一个网页,不代表它已经成为证据;没有出处的结论会保留为问题。点开来源可以回看依据。
工位长期保留,可以有多次运行;同一工位同时最多一次运行。运行中可在右侧面板查看当前动作、进度并停止。结束后读回执,了解发现和未解决的问题。
AI 读网页不带你的 Cookie 或登录状态,不会替你登录、点击或填表。遇到依赖登录或脚本的页面,会说明无法读取。AI 在自己的工位里创建和整理产物;你的主画布仍由你决定。
16
导出分享包#
可以将画布导出为分享包,再由你决定交给谁。分享包包含你选择导出的内容;请在分享前检查其中的文字与文件。
托管成公开链接目前需要邀请口令,普通下载版不默认开放。分享不是云同步,原画布仍在本机。
17
数据与隐私#
App 没有账号、遥测、埋点或云同步。 AI 请求不会包含文件本身、文件路径、卡片位置或文件库位置。主动导出分享包时,包内会包含你选择分享的内容。
没配置 AI 时不会发出任何 AI 请求;Ollama 完全在本机。使用云端模型时,每一步只发送所需文字:分组和简报每张最多 600 字;对话最多 80 张卡片、每张最多 300 字;改写只发选中的段落。「交给 AI」由这台 Mac 直接读取网页,不带 Cookie、登录状态或浏览历史,每页最多把 6000 字发给模型。
添加链接时,App 会向该网址本身请求标题与预览图,可在设置中关闭。启动时读取 updates.json 检查版本,不发送任何用户内容。
18
删除与找回#
删除遵循三层退路:删除 →︎ 最近删除 →︎ Finder 废纸篓 →︎ 由你决定。
“最近删除”是一块常驻的真实画布。还原会尽量回到原画布、原文件夹和原坐标;如果原文件夹已经不存在,会放回当前画布的文件夹并明确说明。库外文件从不移动,删除的只是引用卡片。
⌘Z 可以撤销最近 200 步,包括删除、移动、分组、归档和改名。
19
设置#
按 ⌘, 打开设置。你可以更换文件库、决定外部文件是复制还是引用、选择浅色/深色/跟随系统、切换中文或 English、修改卡片颜色、控制网页预览与性能、清除网站数据,以及配置 AI 服务商、Key、模型和接口地址。
语言切换不需要重启。AI 设置中的“测试连接”只做一次极小的往返,用来定位 Key、地址、模型名或响应格式问题。
20
快捷键总表#
| 快捷键 | 作用 |
|---|---|
| ⌘N | 新建文字卡片 |
| ⌘V / ⇧⌘V | 粘贴到指针附近 / 当前画布 |
| ⌘G / ⇧⌘G | 编成一组 / 取消编组 |
| ⌘D | 制作副本 |
| ⌘Z / ⇧⌘Z | 撤销 / 重做 |
| ⌘, | 设置 |
| Delete | 删除选中项 |
| 空格 | 快速查看 |
| Esc | 取消选择、关闭卡片窗口或取消改名 |
| ⌘ 点卡片 | 加选或取消单张 |
写作页内:⌘B 粗体、⌘I 斜体、⌘K 插入链接、/ 打开内容块面板。
21
手势总表#
| 手势 | 结果 |
|---|---|
| 双指平移 / 捏合 | 移动画布 / 以指针为中心缩放 |
| 空白处拖动 | 框选 |
| 拖卡片顶部 / 四角 | 移动 / 缩放卡片 |
| 双击卡片 | 在画布上方的窗口中打开 |
| 拖卡片到卡片上 | 建立分组 |
| 从卡片底部圆点拖到另一张卡片 | 建立连线;点线可选关系词 |
| 拖分组边框 | 移动整组 |
| 拖段落手柄 | 页面内移动,或拖出成为卡片 |
| 拖侧栏行 | 重排或嵌套画布 |
23
文件在磁盘上是什么#
每块画布对应一个真实文件夹,子画布对应子文件夹。文字卡片就是普通 .md 文件,图片、PDF 和其他文件保持原格式。“最近删除”也是一个真实文件夹。
卡片坐标、分组和颜色保存在 App 数据中,不污染你的文件夹;搜索索引存在边车文件中。备份整个文件库文件夹即可,Time Machine 可以直接使用。
24
出问题时#
| 症状 | 原因或做法 |
|---|---|
| 画布看起来是空的 | 卡片可能在视野外;切走再回来会跳到最新卡片,或缩小查看 |
| Finder 新文件没出现 | 设置 › 文件空间 › 立即刷新 |
| 文件不见了 | 先看“最近删除”,再看 Finder 废纸篓 |
| AI 没反应 | 设置 › AI 服务 › 测试连接 |
| 网页需要重新登录 | App 使用独立浏览身份,不与 Chrome 共享 |
| 卡片名和文件名不同 | 文字卡片第一行就是文件名,修改第一行即可 |
| 想报告问题 | 帮助 › 报告问题…,或发邮件到 peterli_lhc@outlook.com;微信 PETERLHC |