Method guide · Folium 1.5

Use cards as a thinking chain.

Folium is built around Luhmann-style cards, but it keeps the workflow practical: boxes give local context, real links hold durable thought relations, potential links suggest missing references, and workspaces let you reason visually before committing.

使用指南 · Folium 1.5

用卡片形成思考链。

Folium 借鉴鲁曼式卡片，但把流程做得更适合实际使用：box 提供局部语境，真实双链承载稳定关系， potential 提醒可能遗漏的引用，workspace 则让你在提交到仓库前先进行视觉化推演。

Mental model

A Luhmann-style card system is not a folder tree. It is a growing network of small notes. Each card should be understandable on its own, but useful because it knows which card comes next.

Card

One compact thought, written in your own words, with enough context to survive outside the source.

Box

A top-level numbered index and its descendants. It is a local thinking field, not a folder.

Real link

A durable [[link]] that says two cards should remain mentally adjacent.

Potential

A weak assistant layer for unlinked references and high-confidence similarity.

Folium keeps Markdown as the source of truth. SQLite is a local index for speed, not a replacement for your vault.

Daily workflow

  1. Capture one idea as a short card. Do not force a category before the thought is clear.
  2. Rewrite it in your own words. A Folium card should be processed thinking, not a highlight dump.
  3. Place it near a useful neighbor with a stable Luhmann ID.
  4. Add a real link when the relation is durable: continuation, contrast, evidence, consequence, or useful tension.
  5. Use a workspace when the relation is still uncertain. Sketch first, commit later.
  6. When a chain becomes too deep or too important, promote it into an index card or a new top-level box.
1a2

Feature selection as a pressure valve

Dimensionality is not only a computation problem. It changes the shape of what a model can learn. This card links to 1a for feature selection and 3b for model capacity.

Numbering and boxes

Folium uses IDs such as 1, 1a, 1a1, and 1a1b. The ID is a position in a thought sequence, not a filesystem path.

  • 1, 2, 3 are top-level index boxes.
  • 1a continues or branches from 1.
  • 1a1 develops 1a further.
  • If an ID becomes painfully long, the idea probably deserves promotion into an index.

This is why Folium treats every top-level numbered card as an index category even when it has no visible children yet. The empty box is still a real place for future structure.

Workspace

A workspace is a visual thinking surface. It can contain real vault cards, temporary cards, relation labels, relation notes, and workspace-only colors. It is the place for provisional structure.

  • Real vault card to real vault card: applying writes a normal vault double-link.
  • Temporary card: useful for ideas that are not ready to become Markdown files.
  • Workspace labels and notes: remain as workspace annotations even when the real link is applied.
  • Workspace colors: visual only; they do not change the canonical vault link.

If a vault card is deleted while it is still used in a workspace, Folium can preserve the workspace thought by degrading that node into an unlinked temporary card.

Graph and tags

Graph view is for the whole vault. It groups cards by top-level boxes, shows real links in a warmer color, keeps box relations quieter, and highlights the first-degree neighborhood around the hovered node.

Tags are best used as temporary gatherings. When you want to connect several cards that share a tag, use the tag view to inspect them together and create deliberate links from there.

Vault, files, plugins

A Folium vault is a folder of Markdown cards plus local app metadata. Attachments should live inside the selected vault, so the vault remains portable. The app can be packaged as a desktop app, while the data model stays plain enough for export and future migration.

The plugin SDK is intentionally local and trusted. Plugins can extend workflows such as export, cleanup, and bridge formats, but they should not need private network access for ordinary vault work.

心智模型

鲁曼式卡片系统不是文件夹树，而是一张不断生长的小笔记网络。每张卡要能独立理解， 但它真正有价值的地方在于它知道下一张有用的卡在哪里。

Card

一个紧凑的想法，用自己的语言写成，并且脱离原始材料之后仍然能读懂。

Box

顶层数字索引和它的后代。它是一个局部思考场，不是普通文件夹。

真实双链

稳定的 [[link]]，表示两张卡应该长期保持思维上的相邻。

Potential

弱辅助层，用来提示未链接引用和高置信度的内容相似。

Folium 以 Markdown 作为你的笔记本体。SQLite 只是为了速度存在的本地索引，不替代仓库。

日常流程

  1. 把一个想法写成一张短卡，不要在想法还没清楚时强行分类。
  2. 用自己的话重写。Folium 的卡片应该是处理过的思考，而不是摘抄堆积。
  3. 给它一个稳定编号，把它放到一个有意义的邻居旁边。
  4. 当关系足够稳定时创建真实双链：延续、对照、证据、结果，或有价值的张力。
  5. 关系还不确定时先用 workspace。先画草稿，再提交到仓库。
  6. 当一条链变得太深或太重要，就把它提权成索引卡，或者升级成新的顶层 box。
1a2

特征选择作为压力阀

维度问题不只是计算问题，它会改变模型能够学习的形状。这张卡可以链接到 1a 的特征选择，也可以链接到 3b 的模型容量。

编号与 Box

Folium 使用类似 1、1a、1a1、1a1b 的编号。 编号不是文件系统路径，而是思想序列里继续生长的位置。

  • 1、2、3 是顶层 index box。
  • 1a 从 1 继续或分叉。
  • 1a1 继续展开 1a。
  • 如果编号长到难受，说明它可能应该被提权成索引。

所以 Folium 会把每张顶层数字卡都视为索引类别。哪怕暂时没有内容，这个空 box 也是真实存在的位置。

Workspace

Workspace 是视觉化思考面板。它可以容纳真实仓库卡、临时卡、关系标签、关系备注，以及只在 workspace 生效的颜色。 它适合承载还没有定型的结构。

  • 真实卡到真实卡：apply 后写入普通仓库双链。
  • 临时卡：用于还不值得变成 Markdown 文件的想法。
  • Workspace 的 label 和 note：即使真实双链被 apply，也作为 workspace 注释保留。
  • Workspace 的颜色：只负责视觉表达，不改变仓库里的标准双链。

如果一张真实仓库卡被删除，但它还在 workspace 中承担思考位置，Folium 可以把它降级成无链接临时卡， 尽量保留这段视觉推理。

Graph 与 Tag

Graph view 面向整个仓库。它按顶层 box 聚合卡片，用更暖的颜色显示真实双链，让 box 关系保持更安静， 并在鼠标悬停时突出一层邻居关系。

Tag 更适合做临时聚合。当你想把拥有同一个 tag 的卡连起来时，可以在 tag 视图里集中检查，再创建真正有意义的双链。

仓库、文件、插件

Folium 仓库是一组 Markdown 卡片，加上一些本地应用元数据。附件应该放在被选择的仓库内部， 这样整个仓库才能保持可迁移。应用可以打包成桌面端，但数据模型仍然应该足够朴素，方便导出和迁移。

插件 SDK 目前定位为本地可信插件。插件可以扩展导出、清理、格式桥接等流程，但普通仓库操作不应该依赖私有网络权限。