从 PDF 或电子书的一段文字长出一条笔记
在 Card Detail 里打开 PDF 或电子书，选中一段文字，再选择 Grow branch。BaseHalf 会生成一条已经连到这份文档的笔记，git 和你的代理都能看到它建立在什么之上。
你需要的那句话常常在一份 PDF 或 EPUB 里，而你正在写的笔记在别处。把句子复制进一个新文件很容易。难的是让这条笔记和原文档之间留下一条以后还能用的连接。
在 BaseHalf 里，PDF 和书跟笔记在同一块画布上。在 Card Detail 中打开文档，选中一段文字，再选择 Grow branch。你会得到一条笔记，它的 upstream 里已经写上了这份文档。
什么算书，卡片长什么样
PDF 卡片和书卡片会以固定尺寸显示封面。标题栏上的按钮可以藏起封面。这里的书指 EPUB、Kindle、FictionBook 和漫画书压缩包。它们和 Markdown 笔记、代码文件一样，都是文件夹里的普通文件。
双击卡片上除名称以外的任何地方，就会在 Card Detail 里打开阅读。Card Detail 占满画布区域，左侧栏和右侧的 Agent Area 还在旁边。按 Escape 可以关掉。
| 种类 | 阅读器提供什么 |
|---|---|
| 缩略图、目录、搜索和缩放 | |
| 书 | 分页或连续滚动、目录、搜索、字号，以及你读到的位置 |
你在 Card Detail 里读，再回到画布。文档卡片在画布上保持一个尺寸，封面就不会把周围的笔记挤掉。
长出一条已经带有 upstream 的笔记
- 在 Card Detail 里打开这份 PDF 或书。
- 选中你在意的那段文字。
- 选择 Grow branch。
- 一条笔记会出现，并且已经连到这份文档。
这条连接的意思是：文档的上下文流入这条笔记。文档是笔记的 upstream。如果下游是 Markdown 笔记，这份列表会写在笔记开头的 frontmatter 里，字段是 upstream:，路径相对于工作区文件夹。git 能看出 diff。之后打开这条笔记的代理也能看到它建立在什么之上。
保存方式和任何其他连接一样：只写一次，写在下游条目里。一条连接会像 import 一样写进下游文件 说明列表写在哪里。只是把文字高亮，或在笔记里加一个 Markdown 链接，都不会建立这种关系。Markdown 链接不是 upstream 连接。
在新笔记里写下这段文字里真正该留下来的东西：你以后会引用的判断、一条约束、文档提出的问题。PDF 或书仍是原文。笔记才是以后会话会反复打开的那个文件。
什么时候长出笔记，什么时候只选中
在 PDF 或书里选中文字，还可以只问这一次。安装了 BaseHalf skill 之后，当前选中就是 Claude Code 或 Codex 所理解的「这个」：这段文字、它所在的文档，以及页码或章节。这份记录写在 .bh/cache/selection.yaml 里，只在窗口开着时存在。git 看不到它。
| 动作 | 你会得到什么 | 能持续多久 |
|---|---|---|
| Grow branch | 一条 upstream 列表里写着这份文档的笔记 | 直到你改掉或去掉这条连接 |
| 选中一段文字并询问「这个」 | 代理看到文字、文档，以及页码或章节 | 只在这个窗口开着的时候 |
如果这段摘录以后还要继续为工作提供上下文，就长出一条笔记。如果只想问光标下这几行的一个问题，选中再提问就够了。该留下来的就连上，这一问才用的就选中 讲的是同一种分工，用在文档上。
局限
Grow branch 是 PDF 和书在 Card Detail 阅读器里的操作，不能从画布上那张小封面发起。其他文件进入 Card Detail 是为了编辑，走的不是这条「长出笔记」的路径。
文档如果在另一个文件夹里，连接仍然会计入卡片徽章，即使当前画布上看不到连线。代理会自己去读文件。BaseHalf 不会把整份 PDF 或书塞进提示词。