枝见 Zhijian 使用手册

这份手册既是入门说明，也是一份可打开的多层级 Markdown 脑图示例。你可以通过“帮助 -> 打开使用手册”载入随程序输出的 使用手册.md，观察大纲、Markdown 和脑图三种视图如何同步。

1. 认识枝见

1.1 枝见适合做什么

1.1.1 写文章提纲

• 先把标题、章节、段落观点拆成树状结构。
• 需要长句说明时，把说明写进节点备注。
• 最后切换到 Markdown 视图继续细化正文。

1.1.2 整理产品和功能设计

• 用中心主题描述目标。
• 用二级节点拆出场景、用户、流程、数据、风险。
• 用更深层级记录细节、边界条件和待确认问题。

1.1.3 梳理代码和文档结构

• 适合整理项目目录、模块职责、接口边界和发布清单。
• 支持把 Markdown 文档重新打开成脑图。
• 支持 Markdown、OPML 和 XMind 等可编辑文件的打开与保存，也支持从更多外部格式导入结构。

1.2 枝见不是什么

1.2.1 不是在线协作工具

• 当前版本是本地优先的桌面应用。
• 文档保存在本机文件中。
• 没有账号、云同步、多人同时编辑或权限管理。

1.2.2 不是完整项目管理系统

• 它不会替代看板、甘特图、工时统计或需求平台。
• 它更适合在需求定稿之前快速梳理思路。

1.2.3 不是富文本排版软件

• 当前文档模型以标题、备注和层级关系为核心。
• Markdown 视图适合维护结构和说明，但不是复杂版式编辑器。

2. 第一次启动

2.1 默认看到空白脑图

2.1.1 中心主题

• 启动后默认创建一个空白文档。
• 中心主题会被选中，可以直接输入标题。
• 如果想查看这份手册，需要通过“帮助 -> 打开使用手册”手动打开。

2.1.2 左侧编辑区

• 左侧有“文件”和“大纲”两个页签。
• “文件”页在没有文件时也提供打开可编辑文件、导入、打开文件夹和打开使用手册的入口。
• 单独打开或导入一个文件后，左侧文件列表会列出这个文件，方便再次切回。
• 打开文件夹后，左侧文件列表会列出该目录下支持的可编辑脑图和可导入资料文件。

2.1.3 右侧脑图区

• 右侧实时显示当前树结构。
• 标题和备注都可以在脑图节点上直接编辑。
• 多级内容较多时，可以缩放、平移或打开小图定位。

2.2 建议的上手顺序

2.2.1 从大纲输入开始

• 大纲视图适合快速录入层级。
• 输入时不用过早关心节点在画布上的位置。

2.2.2 用脑图检查结构

• 右侧脑图能帮你检查章节是否过深、分支是否偏重。
• 如果兄弟节点太多，可以拆成多个二级分支。

2.2.3 用 Markdown 做收尾

• 结构稳定后，可以切换到 Markdown 视图统一修改文字。
• 保存为 Markdown 后，文件依然可以再次打开成脑图。

3. 三种编辑视角

3.1 大纲视图

3.1.1 输入标题

• 每一行对应一个节点标题。
• 选中节点后直接输入即可修改。

3.1.2 添加节点

• Enter 添加同级节点；在中心主题上按 Enter 会添加子节点。
• Tab 将当前节点降级为上一个同级节点的子节点。
• Shift + Tab 提升节点层级。
• Alt + Up / Alt + Down 在同级节点中上移或下移。

3.1.3 调整顺序

• 可以通过 Alt + Up / Alt + Down 或节点菜单上移、下移。
• 也可以拖拽大纲中的节点入口调整位置。

3.2 Markdown 视图

3.2.1 标题就是层级

• # 对应中心主题。
• ##、### 和更深标题会变成下级节点。
• 非标题行会作为最近一个标题节点的备注。

3.2.2 适合批量修改

• 适合一次性替换多个标题。
• 适合粘贴已有 Markdown 提纲。
• 修改后会同步到大纲和脑图。

3.2.3 注意事项

• 如果一段文字没有放在标题下面，它会成为根节点备注。
• 复杂 Markdown 表格、代码块和富文本样式不会被当成独立脑图节点。

3.3 脑图视图

3.3.1 直接编辑

• 点击节点标题可以修改标题。
• 使用节点浮动工具或右键菜单可以添加备注。
• 备注会显示在标题下方，并参与布局高度计算。

3.3.2 拖拽结构

• 拖到节点中部，表示成为目标节点的子节点。
• 拖到节点上边缘或下边缘，表示调整同级顺序。
• 根节点不能被拖成其他节点的同级。

3.3.3 浏览画布

• 触控板双指滑动或鼠标滚轮可以平移画布。
• 触控板双指捏合可以围绕指针位置放大和缩小。
• 按住 Ctrl（Windows/Linux）或 ⌘（macOS）配合滚轮，也可以围绕指针位置放大和缩小。
• 按住 Shift 并滚动鼠标滚轮，可以横向平移画布。
• 直接拖拽中心主题、按住 Space 并拖动鼠标左键，或直接用鼠标中键拖动，也可以平移画布。
• 使用底部缩放按钮可以放大、缩小和回到中心主题。
• 小图适合在复杂脑图中快速回到目标区域。

4. 文件工作流

4.1 新建和新窗口

4.1.1 新建

• 创建一个只有中心主题的空白文档。
• 如果当前文档有未保存修改，会先询问是否保存。

4.1.2 新建窗口

• 启动一个新的编辑器进程。
• 适合同时参考两份资料。

4.2 打开和导入文件

4.2.1 打开可编辑文件

“打开可编辑文件”用于可以继续保存为同类脑图结构的格式：

4.2.1.1 Markdown

• 文件扩展名通常是 .md 或 .markdown。
• 标题层级会转换为脑图层级。

4.2.1.2 OPML

• 适合和大纲工具交换结构。
• 节点标题和备注会尽量保留。

4.2.1.3 XMind

• 适合和常见脑图工具交换。
• 当前版本关注主题结构和备注文本，不承诺完整保留所有样式。

4.2.2 导入其他格式

• “导入...”用于把其他脑图、draw.io、图片、Office、文档和数据文件转换成脑图。
• 导入格式不代表可以原格式保存；编辑后请另存为 Markdown、OPML 或 XMind。
• 如果当前文件来自只读导入格式，点击保存会进入另存为流程，避免覆盖原始资料。

4.2.3 左侧文件列表

• 如果列表为空，可以直接在“文件”页点击“打开可编辑文件...”“导入...”或“打开文件夹...”。
• 单独打开或导入文件时，这个文件会出现在左侧文件列表。
• 打开文件夹时，列表会展示文件夹内支持格式的文件。
• 点击列表项会打开对应文件，并回到大纲编辑。

4.3 保存和另存为

4.3.1 保存

• 保存到当前文件路径。
• 新建文档第一次保存时会进入另存为流程。

4.3.2 另存为

• 可以选择 Markdown、OPML 或 XMind。
• 只展示枝见能可靠写出的可编辑格式。
• 适合给同一份结构保存为不同的可编辑交换格式。

4.3.3 关闭前确认

• 当前文档有未保存修改时，关闭前会询问保存、放弃或取消。

4.4 最近文件和打开位置

4.4.1 最近文件

• 最近打开或保存的文件会被记录。
• 文件不存在时会从最近文件中移除。

4.4.2 打开文件位置

• 可以在系统文件管理器中定位当前文件。
• 适合确认保存位置或继续做版本管理。

5. 节点编辑能力

5.1 标题

5.1.1 简短标题

• 推荐把节点标题写成一句短语。
• 长说明放进备注会更清晰。

5.1.2 多行标题

• 标题过长时会自动换行。
• 脑图会根据标题宽高重新布局。

5.2 备注

5.2.1 备注适合写什么

• 写背景、判断依据、细节说明和待办提示。
• 写给未来的自己看的上下文。

5.2.2 多行备注

• 可以输入多行备注。
• 备注较多时会限制最大显示高度。
• 布局会给备注预留高度，避免压住后面的兄弟节点。

5.2.3 空备注

• 空备注失去焦点后会自动收起。
• 已有备注会跟随节点保存到文档。

5.3 结构命令

5.3.1 添加同级

• 适合补充同一分类下的新条目。
• 根节点不会新增同级，根节点处添加同级会转为添加子级。

5.3.2 添加子级

• 适合继续拆解一个节点。
• 子级会自动使用当前布局规则放到下一列。

5.3.3 提升和降级

• 提升会把节点移到父节点的同级位置。
• 降级会把节点变成上一个同级节点的子节点。

5.3.4 删除

• 删除会移除当前节点及其子节点。
• 删除根节点不会清空整个文档。

6. 浏览复杂脑图

6.1 缩放

6.1.1 放大

• 适合细看长标题和备注。
• 放大后可以配合滚动条或画布拖拽移动视野。

6.1.2 缩小

• 适合检查整体结构。
• 大文档缩小后可结合小图快速定位。

6.2 平移

6.2.1 触控板、滚轮和拖拽

• 触控板双指滑动或鼠标滚轮可以直接平移画布，适合笔记本。
• 触控板双指捏合可以直接缩放画布，适合笔记本触控板。
• 按住 Shift 并滚动鼠标滚轮，可以横向平移。
• 直接拖拽中心主题、按住 Space 后用鼠标左键拖动，或直接用鼠标中键拖动画布。
• 画布边缘会保留额外空间，缩放后也能把内容拖到合适位置。

6.2.2 滚动条

• 水平和垂直滚动条用于精确移动。
• 复杂脑图中滚动条和小图可以互相配合。

6.3 小图

6.3.1 打开小图

• 底部导航可以打开小图预览。
• 小图展示整张脑图的缩略区域。

6.3.2 定位内容

• 通过小图可以理解当前视口在整张图中的位置。
• 适合在深层分支之间来回切换。

7. 主题、语言和引导

7.1 主题

7.1.1 浅色主题

• 适合白天和投屏演示。

7.1.2 深色主题

• 适合暗光环境。
• 菜单、节点和面板会同步切换颜色。

7.2 语言

7.2.1 当前支持

• 中文简体。
• 中文繁体。
• 英语。
• 日语。

7.2.2 切换后

• 标题栏菜单、页签、状态栏和引导文字会更新。
• 文档内容不会被自动翻译。

7.3 新手引导

7.3.1 覆盖范围

• 文件菜单。
• 大纲编辑区。
• Markdown 切换。
• 脑图画布。
• 底部导航。

7.3.2 重新打开

• 可从帮助入口重新打开。
• 已跳过后会记录状态。

8. 推荐工作流

8.1 从一个问题开始

8.1.1 写中心主题

• 用一句话描述你要解决的问题。

8.1.2 拆二级分支

• 常见分支包括目标、现状、方案、风险、验证和后续动作。

8.1.3 补备注

• 把判断依据、限制条件和参考信息写进备注。

8.2 逐步收敛

8.2.1 先发散

• 不急着整理顺序，先把想到的内容放进去。

8.2.2 再归类

• 通过拖拽、提升、降级把节点移动到合适位置。

8.2.3 最后导出

• 保存 Markdown 用于继续写作。
• 保存 OPML 或 XMind 用于和其他工具交换。

9. 示例脑图：写一篇技术文章

9.1 文章定位

9.1.1 读者

9.1.1.1 新手读者

• 需要看到清晰操作路径。

9.1.1.2 有经验的开发者

• 更关心设计取舍和实现边界。

9.1.2 目标

9.1.2.1 讲清楚软件能做什么

• 不夸大能力，不暗示已有云端协作。

9.1.2.2 展示真实界面

• 截图和 GIF 应该来自当前版本。

9.2 内容结构

9.2.1 开头

9.2.1.1 一句话定位

• 本地 Markdown-first 脑图编辑器。

9.2.1.2 适用场景

• 写提纲、整理设计、拆解项目。

9.2.2 主体

9.2.2.1 文件工作流

• 新建、打开、保存、另存为、最近文件。

9.2.2.2 三视图同步

• 大纲、Markdown、脑图围绕同一棵树工作。

9.2.2.3 复杂脑图浏览

• 缩放、平移、小图和回到中心主题。

9.2.3 结尾

9.2.3.1 给出仓库地址

• 方便读者查看源码和提交反馈。

9.2.3.2 列出后续计划

• 只写已经准备做或正在评估的内容。

9.3 发布检查

9.3.1 功能检查

• 文档能打开。
• 脑图不重叠。
• 文件列表行为符合预期。

9.3.2 文字检查

• 操作步骤准确。
• 没有宣传不存在的功能。
• 截图说明和实际界面一致。

10. 示例脑图：设计一个小功能

10.1 需求背景

10.1.1 用户问题

• 用户希望启动更轻，不被示例文档打断。

10.1.2 产品目标

• 启动默认空白。
• 手册仍随程序输出。
• 用户需要时可以主动打开手册学习。

10.2 方案拆解

10.2.1 启动逻辑

10.2.1.1 去掉默认手册路径

• 主窗口 ViewModel 不再接收手册作为启动文件。

10.2.1.2 保留空白文档初始化

• 启动仍有中心主题和基础历史记录。

10.2.2 文档分发

10.2.2.1 手册复制到输出目录

• 方便用户从程序目录或打开对话框找到。

10.2.2.2 手册作为复杂示例

• 多级标题用于展示脑图层级。
• 备注用于展示长说明和换行。

10.2.3 验证

10.2.3.1 构建

• 确认项目可以正常编译。

10.2.3.2 打开手册

• 确认手册能被解析为多层级脑图。

10.2.3.3 启动体验

• 确认启动后不是自动打开手册。

11. 常见问题

11.1 为什么启动不是手册

• 启动默认空白更适合立即开始自己的内容。
• 手册仍然保留在程序输出中，需要时可以手动打开。

11.2 为什么 Markdown 中的普通行变成备注

• 枝见用标题表示节点层级。
• 普通行用于补充最近一个标题节点的说明。

11.3 为什么复杂格式没有完整保留

• 当前模型重点是标题、备注和树结构。
• 如果需要复杂排版，建议在 Markdown 编辑器或专用文档工具中继续处理。

11.4 如何避免脑图太挤

• 控制每个节点标题长度。
• 把解释性内容放到备注。
• 用多个二级分支分摊复杂内容。
• 用缩放、小图和平移浏览大图。

11.5 如何反馈问题

• 可以通过帮助菜单进入仓库、问题反馈或需求提交入口。
• 反馈时最好附上系统版本、操作步骤、示例文件和截图。

12. 快速复盘

12.1 记住三件事

12.1.1 标题形成节点

• Markdown 标题层级就是脑图层级。

12.1.2 备注补充上下文

• 普通文本会成为节点备注。

12.1.3 保存保持可读

• Markdown 文件可读、可改、可再次打开成脑图。

12.2 推荐下一步

12.2.1 新建自己的文档

• 从一个中心主题开始。

12.2.2 打开这份手册

• 观察复杂层级如何显示。

12.2.3 尝试导出

• 保存为 Markdown、OPML 或 XMind，对比不同工具中的结构表现。