每个文件夹都会打开成一块自己的画布
在 BaseHalf 里，每个文件夹都是一块由其中文件和子文件夹组成的画布。双击文件夹卡片就能进入。大型项目仍然可读：构建目录不会出现在画布上，一块画布最多显示 300 张卡片。
用 BaseHalf 打开一个仓库时，很容易期待一整张大地图：每个文件、每个子文件夹、每条连接都铺在同一视图里。画布不是这样工作的。每个文件夹都有自己的一块画布。这个文件夹里的文件和子文件夹才是卡片。仓库其余部分在一次双击之外，不会画到同一块表面上。
这样拆开，大型项目才读得下去。画布跟着磁盘上的文件夹走。新加一个文件，卡片就会出现；删掉一个文件，卡片也会消失。
这块画布显示什么，又会略过什么
文件夹卡片会列出该文件夹里有什么。双击卡片（不要点到名字）就会进入那个文件夹的画布。不想在卡片之间找时，用侧边栏的 Files 或 Search，也就是 VS Code 里那两套视图。从这两处打开文件夹，会把它作为画布打开；打开文件则进入 Card Detail。
画布也会有意略过一些东西。画布与卡片文档里写的是同一套规则。
| 会出现在当前文件夹的画布上 | 被略过，或没那么显眼 |
|---|---|
| 这个文件夹里的文件和子文件夹 | .git、node_modules、dist、build、out、target、vendor 这类文件夹 |
| 笔记在卡片上渲染；文本和代码显示文件开头；图片、视频、PDF 和电子书用各自通常的卡片形态 | .DS_Store 这类系统文件，以及工作区顶层的 CLAUDE.md 和 AGENTS.md |
| 同一文件夹里卡片之间的连接线 | 连到另一文件夹里条目的连接：这里没有线，但仍会列在卡片徽章里并计入数量 |
| 最多 300 张卡片 | 超过 300 之后，只有已经有位置、描述或连接的条目才会有卡片 |
被忽略的文件夹永远不会变成卡片。这通常正是你想要的：node_modules 树会把真正的工作埋掉。即使某个文件没有卡片，代理仍可以用自己的工具去读它。
让一块文件夹画布保持专注
在大型仓库里，可以这样用：
- 打开你正在做的那一层文件夹。如果工作区根目录只是一大串互不相关的目录，就不必总停在根上。
- 和这些文件相关的笔记就放在这个文件夹里，这样它们会待在同一块画布上，也能画出可见的线。
- 当文件夹 A 里的笔记需要用到文件夹 B 里的文件时，打开笔记的徽章，用 Add Upstream。连接是真实的：它会写进笔记，并在徽章上计数。两边卡片不在同一个文件夹时，你看不到线。
- 需要跳转时用侧边栏的 Search 或 Files。不必把所有相关文件都留在当前画布上。
这和用本地文件夹当 AI 工作区是同一思路，只是再往下一层：仓库是一个文件夹，每个嵌套文件夹也是一张只包含自己内容的地图。
按文件夹划分地图的边界
你不会得到整仓一份空间地图。跨文件夹的上下文是存着的、也能读到，只是没那么显眼，因为线只画在同一文件夹的卡片之间。卡片位置写在 .bh/ 里，不进 git。你提交的连接仍然可以指向工作区里任何位置的文件。
300 张卡片的上限意味着，一个巨大的扁平文件夹不太合适。如果几百个文件平铺在一起、没有分层，其中大多数不会以卡片出现，除非它们已经有位置、描述或连接。当地图开始变稀时，把工作拆进各个文件夹。
跟着文件夹走的画布，是这个目录的地图。它替代不了 Search，也替代不了文件列表。用画布看这里哪些东西该待在一起；需要别处的内容时，用 Search。