使用手册

这份手册是查的,不是读的。输入一个动作、界面或问题,直接去需要的地方。

第一次打开?选择文件库 →︎ 点一下画布 →︎ 按 ⌘V →︎ 拖动卡片顶部。四步已经够你开始。

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 废纸篓,并且一定先询问。

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

本手册对应 0.12.0,功能有变时以 App 内为准。