概览
BaseHalf 把普通文件夹打开成画布，文件之间的连接以纯文本保存在这个文件夹里，你的 Agent 读到的结构和你看到的一样。
BaseHalf 是一个开源的桌面工作区，用来和文件、Agent 一起思考。它把你已有的文件夹打开成画布：里面的文件和子文件夹都是卡片，可以摆放、阅读、编辑和连接。
你画的连接以纯文本保存在文件夹里。笔记开头有一个 upstream 列表，写明哪些内容流入这篇笔记，所以 Claude Code、Codex 或其他任何 Agent 打开它，看到的结构都和你在画布上看到的一样。其他条目的列表由 BaseHalf 保存在 .bh/ 下。
你的文件还是普通文件，Git、其他编辑器和 Agent 都能像以前一样处理它们。BaseHalf 在此之上加了一层可视化，它自己的文件放在一个隐藏的 .bh/ 文件夹里，就在你的文件旁边。
文档内容
开始使用
下载 BaseHalf，首次启动，再把一个文件夹打开成画布。
画布与卡片
文件夹怎样变成画布，以及怎样摆放、阅读、编辑、选中和排列卡片。
连接
上游连接是什么意思，怎样建立，保存在哪里。
与 Agent 协作
在 Agent Area 里运行 Claude Code 和 Codex，安装 BaseHalf skill，让 Agent 知道你选中了什么。
AI 图片、视频和声音
根据提示词和连到它的卡片来生成，使用你自己的服务商 key。
各部分如何配合
- 你在画布上摆放材料，决定什么建立在什么之上。
- 文件保存内容和连接，所以重要的东西都不会只存在于应用里。
- Agent 用自己的工具在同一个文件夹里工作。它们从文件里读取连接，其余信息在哪里，由 BaseHalf skill 告诉它们。
BaseHalf 里面没有 Agent。在这里，你和你的 Agent 看的是同一份工作。
适合谁
只要你的思考和 AI 的思考能在同一张画布上流动，BaseHalf 就适合你：学习一个领域的人，用 AI 模型做图片、视频和声音的人，习惯用地图思考的人，审代码的人。画布让你看到有哪些材料、它们怎样组合在一起，Agent 则从文件里读到同一套结构。
始终归你
BaseHalf 为你的工作记下的东西，比如连接、描述和卡片位置，都以普通文件的形式存在文件夹里。关掉应用，笔记和它们的连接、描述都还在，Git、其他编辑器和任何 Agent 照样能用。BaseHalf 不需要账号，也不需要服务器。