与 Agent 协作

BaseHalf 本身不是 Agent，也不内置 Agent，它是你的 Agent 所在的工作区。Agent 用自己的工具，读写你在画布上看到的那些普通文件。

Agent Area

窗口右侧是 Agent Area，可以在这里启动会话：

• Claude Code 运行 claude 命令行工具。
• Codex 运行 codex 命令行工具。
• Claude Code Extension 和 Codex Extension 分别运行这两个 Agent 的 VS Code 扩展。
• Terminal 打开一个 shell，用来运行 OpenCode、Gemini CLI，或其他任何在终端里运行的 Agent。

会话支持标签页、窗格和分屏，每个会话都可以重启、停止、调整大小和最大化。你想用的命令行 Agent 需要自己安装，Agent Area 负责运行它们。

BaseHalf skill

Agent 在你的文件夹里工作时，需要知道卡片的描述和连接存放在哪里。BaseHalf 通过 skill 告诉它。skill 是一种开放格式，Claude Code、Codex 等 Agent 会在任务需要时加载它。

打开文件夹时，BaseHalf 会询问是否安装这个 skill，选项是 Install、Not Now 和 Don't Ask Again，在你回答之前这个询问会一直在。安装时，它会在你这台 Mac 上各个 Agent 自己的设置里加一个链接，指向 BaseHalf 自己的那份 skill，绝不会放进你的文件夹：

• Claude Code：~/.claude/skills/basehalf/；
• Codex 和其他读取共享位置的 Agent：~/.agents/skills/basehalf/。

BaseHalf 每次更新都会把自己的那份一起更新，所以不用重新安装。你也可以随时在命令面板中运行 BaseHalf: Install Agent Skill 或 BaseHalf: Remove Agent Skill。

这个 skill 告诉 Agent：

• 怎样通过隐藏的 .bh/ 文件夹认出 BaseHalf 工作区；
• 卡片的描述在哪里，什么流入它、它又流入什么；
• 移动或重命名文件会对这些信息产生什么影响；
• 你最后选中了什么；
• 怎样创建草稿并生成；
• 它用自己的工具做的图片或声音该放到哪里。

因为是 skill，所以不管你在哪里启动 Agent 都有效，不限于 Agent Area。什么时候用它，由 Agent 根据任务决定。

说“这个”就行

问一个文件的事，不应该非得说出它的名字。BaseHalf 记录你最后选中了什么，Agent 就能知道“这个”“这里”“改进一下”指的是什么。

skill 安装后，状态栏右端会显示 Agent 能看到什么。只有选中操作才会改变它：点进 Agent Area 给 Agent 打字不会。在你回答询问之前，这里显示 “Agents can't see your selection”，点击它会再次显示询问。

这份记录是工作区文件夹里的 .bh/cache/selection.yaml。BaseHalf 只在运行且已安装 skill 时写入，窗口关闭时删除。Git 不会看到它，Agent 只读不写。请求里明确提到别的内容时，以请求为准：“改进摘要”说的就是摘要，不管选中了什么。

文件移动时

Agent 用自己的工具移动和重命名文件就行，不需要专门的命令。BaseHalf 根据内容在新路径认出这个条目，更新它为这个条目保存的东西和引用它的行，不管是哪个 Agent 移动的，也不管它在哪里运行。认不出来的情况见连接。

BaseHalf 不做什么

• 不会把你的工作区内容放进 Agent 的提示词。Agent 自己读文件。
• 不会往你的 CLAUDE.md 或 AGENTS.md 里写指令。
• 从 Agent Area 启动的 Claude Code 会话，启动时会收到一段固定的说明。装了 skill 时，它只是一句指向 skill 的话；没装时，它包含关于 .bh/、连接和生成的相同事实。其他 Agent 不会收到。
• 没有常驻后台的程序。BaseHalf 打开时，只会为你发起的操作改动文件，或者修复移动造成的问题，比如引用了被移动条目的那些行。

下一步

• 连接：Agent 读取的上游列表。
• AI 图片、视频和声音：Agent 也能创建草稿并生成。