循脉画板 使用手册

循脉画板

一个把「你硬盘上的文件夹」当唯一真源的手稿工作台。文档和画板平起平坐, 画板上的每个节点都能下钻进一篇文档,也能被评论、被打组、被单独备份。

没有账号、没有云依赖、没有「导入导出」这一步 —— 你打开的那个文件夹,就是全部数据。 换台电脑把文件夹拷过去即可,格式全是 Markdown 和普通 JSON。

它是什么

大多数工具把数据放在自己的云里,你只看见一层界面;循脉反过来,界面只是那堆文件的一层皮。

文件夹是真身

仓库 = 你选的任意一个文件夹。.md 是文档,.xmb.json 是画板,用别的编辑器打开照样能读。

文档与画板平级

不是「画布上放个文件引用」,而是两种一等公民:画板节点可以直达文档,文档也能反向被画板引用。

给「想事」用的

时间轴、看板、列表都是格子,只让你把东西放进去;循脉让你先摊开、再连线、最后才收拢成结论。

上手三步

  1. 打开一个文件夹当仓库。 左上角点仓库名 → 选一个空文件夹(或者你现成的手稿目录)。它不会搬动、不会改造你的文件, 只在这上面加一个隐藏目录 .xm/ 存备份和草稿。
  2. 建第一篇。 文件树顶部 + 可以建文档 / 画板 / 待办 / 文件夹;也可以直接把文件从资源管理器拖进树里导入。
  3. Ctrl+S 保存。 默认是手动保存:改动先落在草稿区,树里名字变红就是在提醒你还没落盘。 嫌麻烦可以去「设置 → 保存」打开「自动保存到文件」,改完停下来就写盘。

右下角那个时间,是磁盘上这一篇最后写进文件的时间;内存里还有没保存的改动时,它会变成「未存」并转为琥珀色。

写文档

文档链:[[文档名]]

在正文里打 [[(中文输入法下打 【【 也行),就地弹出只搜本仓库的候选框, 边打边过滤,↑↓ 选,Enter 插入。

插入的是纯文本 [[名字]],和 Obsidian 完全互通;中文括号只当输入入口,写进文件时统一成半角。 点它会在新标签打开那篇(不顶掉手上这篇),已经开着就直接切过去。

链接找不到时不会生成死链:正文里原样保留 [[名字]],点它会提示「本仓库里没有这篇」。

选中文字

选中一段会浮出工具条:加粗、斜体、行内代码、链接、高亮、评论。评论挂在文本上,不污染正文。

链接的点击

外部链接点一下就用系统浏览器打开;按住 Alt 点则不打开,把光标放进链接里改字。

导出

文件树里文档右键 ⇩ 导出 HTML:生成一份自带样式的静态页,[[文档链]] 会变成指向真实路径的链接。 要 PDF 就在浏览器里 Ctrl+P 另存为 PDF。

画板

建节点与连线

多选与打组

撤销与复制

找东西

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,这是预期行为。

画板节点能当文档用吗?

节点本身是结构化的一小块(标题、备注、颜色、状态、端口、绑定的文档/子画板),不是长文。 要写长内容就绑定一篇文档,双击下钻进去写。