循脉画板
一个把「你硬盘上的文件夹」当唯一真源的手稿工作台。文档和画板平起平坐, 画板上的每个节点都能下钻进一篇文档,也能被评论、被打组、被单独备份。
没有账号、没有云依赖、没有「导入导出」这一步 —— 你打开的那个文件夹,就是全部数据。 换台电脑把文件夹拷过去即可,格式全是 Markdown 和普通 JSON。
它是什么
大多数工具把数据放在自己的云里,你只看见一层界面;循脉反过来,界面只是那堆文件的一层皮。
文件夹是真身
仓库 = 你选的任意一个文件夹。.md 是文档,.xmb.json 是画板,用别的编辑器打开照样能读。
文档与画板平级
不是「画布上放个文件引用」,而是两种一等公民:画板节点可以直达文档,文档也能反向被画板引用。
给「想事」用的
时间轴、看板、列表都是格子,只让你把东西放进去;循脉让你先摊开、再连线、最后才收拢成结论。
上手三步
-
打开一个文件夹当仓库。
左上角点仓库名 → 选一个空文件夹(或者你现成的手稿目录)。它不会搬动、不会改造你的文件,
只在这上面加一个隐藏目录
.xm/存备份和草稿。 - 建第一篇。 文件树顶部 + 可以建文档 / 画板 / 待办 / 文件夹;也可以直接把文件从资源管理器拖进树里导入。
- Ctrl+S 保存。 默认是手动保存:改动先落在草稿区,树里名字变红就是在提醒你还没落盘。 嫌麻烦可以去「设置 → 保存」打开「自动保存到文件」,改完停下来就写盘。
右下角那个时间,是磁盘上这一篇最后写进文件的时间;内存里还有没保存的改动时,它会变成「未存」并转为琥珀色。
写文档
文档链:[[文档名]]
在正文里打 [[(中文输入法下打 【【 也行),就地弹出只搜本仓库的候选框,
边打边过滤,↑↓ 选,Enter 插入。
插入的是纯文本 [[名字]],和 Obsidian 完全互通;中文括号只当输入入口,写进文件时统一成半角。
点它会在新标签打开那篇(不顶掉手上这篇),已经开着就直接切过去。
链接找不到时不会生成死链:正文里原样保留 [[名字]],点它会提示「本仓库里没有这篇」。
选中文字
选中一段会浮出工具条:加粗、斜体、行内代码、链接、高亮、评论。评论挂在文本上,不污染正文。
链接的点击
外部链接点一下就用系统浏览器打开;按住 Alt 点则不打开,把光标放进链接里改字。
导出
文件树里文档右键 ⇩ 导出 HTML:生成一份自带样式的静态页,[[文档链]] 会变成指向真实路径的链接。
要 PDF 就在浏览器里 Ctrl+P 另存为 PDF。
画板
建节点与连线
- 双击空白建一个节点,直接打字命名。
- 从节点边上的小圆点拖线到另一个节点即可连上;拖到空白松手会当场弹候选,选一个就自动建好并连回起点。
- 节点可以绑定到某篇文档,双击进入下钻;也能绑到另一块画板。
多选与打组
- Ctrl 点选加选,Shift 框选一片。
- 右键 → 打组(或 Ctrl+G):自动套一个分组框,编号 1、2、3… 只增不减。
- 拖任意一个成员,整组一起动;Alt 拖只动这一个。
- 一个节点只属于一个组 —— 想换组先解组,不会出现「共享节点」这种糊涂账。
撤销与复制
- Ctrl+Z / Ctrl+Y 撤销重做(一次拖动算一步,不是一百步)。
- Ctrl+C 之后把鼠标移到想放的地方再 Ctrl+V,粘出来的就落在鼠标那里;连着按每次错开一点。
- 复制是全字段带走:颜色、图标、状态、备注、子流程引用、自定义端口、绑定文档都在,只有编号和评论不带。
找东西
Ctrl+P 是唯一的搜索入口,一次搜两样东西:
- 文档正文:同一篇里命中几处就列几条,点哪个就跳到哪一段。
- 画板节点:点候选直接在该画板上定位并选中那个节点。
- 候选里会标出命中位置是标题还是正文,关键词高亮。
- 点 🔒 锁定关键词,下次打开搜索时不清空。
按 Tab 一键开合左右两侧:任意一侧开着就两侧一起收,都收着就两侧一起展开。
备份与同步
本地备份
右栏底部是这一篇的版本列表,按时间排,点一下就能回退。留在 .xm/backups/,超过上限自动删最旧的。
云端按篇备份(Gitee)
左栏底部的 ⇄ 把当前这一篇推到你的私有 Gitee 仓库,文件名带时间戳,
结构跟本地备份一模一样(.xm/gitee-backups/<文档>/<时间>-<名字>.md)。
右栏 Gitee 页会列出云上的版本,点 ⟲ 取回覆盖当前这篇。
用法顺序:设置 → Gitee 贴私人令牌(点「验证」确认有效)→ 仓库页卡片点 ☁+ 绑定(转圈后变 ✓, 远程仓库显示名就是卡片名)→ 之后用 ⇄ 备份。对勾→圆圈 表示这篇又改了还没备。
它备份的是磁盘上的真文件,所以点备份会先替你保存;保存被保险丝拦下就中止,绝不把旧内容当新版本传上去。
数据安全
这块是循脉最当紧的部分 —— 一个手稿工具,最不能犯的错是悄悄弄丢你的字。
- 写盘保险丝:覆盖前先比对,篇幅骤减(比如一次少了一半)会拦下来问你;确认要写才放行。
- 节点数高水位:画板历史最多节点数只升不降,逐个删也会被拦。
- 读失败 ≠ 文件不存在:读不到一律当错误处理,不会「当空文件」再造一份覆盖掉。
- 同名让路:搬移、复制、导入遇到同名,要么改名要么拒绝,不静默覆盖。
- 草稿可恢复:异常退出后重开,树里红名那几篇就是还没落盘的,点开可恢复。
快捷键
| 按键 | 作用 |
|---|---|
| Ctrl+S | 保存当前文档到磁盘 |
| Ctrl+P | 全局搜索(文档正文 + 画板节点) |
| Tab | 一键开合左右两侧栏 |
| Ctrl+Z / Ctrl+Y | 画板撤销 / 重做 |
| Ctrl+C / V | 画板复制 / 粘贴(跟随鼠标) |
| Ctrl+G | 选中节点打组 |
| Alt + 拖动 | 只动一个节点(不进整组联动) |
| Alt + 点链接 | 不打开链接,进入编辑 |
| 标题栏 ☾ / ☀ | 深色 / 浅色切换(夜里看字不刺眼,选择会记住) |
Tab 在输入框和正文里照常工作(缩进、跳控件),只在画布与空白处才开合侧栏。
常见问题
文件名是红的,是不是出问题了?
不是。红名 = 这篇有改动还没落盘(草稿状态)。按 Ctrl+S 或者关标签时选「保存」就恢复正常。
它会改我的文件吗?
只写你编辑的那几个文件,外加仓库里的隐藏目录 .xm/(草稿、本地备份、画板高水位)。不动其它任何东西。
没网能用吗?
能。全部功能都是本地的;只有 Gitee 备份需要联网,失败也只是那一次没备上,不影响编辑。
换电脑怎么搬?
整个仓库文件夹拷过去,在新机器上打开同一个文件夹即可。本地备份在 .xm/backups/ 里会一起跟过去。
为什么导出的 HTML 里文档链点不动?
导出的链接指向仓库内相对路径。把 HTML 放回仓库里(或保留原来的相对位置)就能跳;单独拿出来放到别处,链接会 404,这是预期行为。
画板节点能当文档用吗?
节点本身是结构化的一小块(标题、备注、颜色、状态、端口、绑定的文档/子画板),不是长文。 要写长内容就绑定一篇文档,双击下钻进去写。