枝见 Zhijian

Zhijian 是一个基于 C# 和 Avalonia 的本地 Markdown-first 脑图编辑器。它围绕同一份树结构提供大纲、Markdown 和脑图三种编辑视角，适合写文章提纲、整理功能设计、梳理项目结构和维护可读的 Markdown 脑图文档。

项目仓库：https://github.com/dotnet9/Zhijian

枝见主窗口

本页截图和 GIF 已按当前界面重新制作，并使用程序启动时默认加载的使用手册，便于观察文件列表、小图、缩放、画布拖拽和层级调整。

项目定位

启动后默认加载随程序输出的 使用手册.md，首屏就是一份真实的多层级脑图。
大纲、Markdown 和脑图共用 MindMapNode 模型，任一视图修改都会同步。
文件菜单覆盖新建、新窗口、打开、打开文件夹、最近文件、保存、另存为、打开文件位置和关闭。
编辑菜单覆盖撤销、重做、结构调整、删除节点和复制为 Markdown。
主题、语言、帮助和关于菜单放在标题栏，常用操作带图标和快捷键。
macOS 下标题栏菜单、窗口快捷键和脑图缩放使用 ⌘，Windows/Linux 使用 Ctrl。
语言切换使用 Lang.Avalonia.Json，支持中文简体、中文繁体、英语和日语。
首次启动引导会精准高亮标题栏文件菜单、大纲编辑区、Markdown 切换、脑图画布和底部导航，并提供“跳过”按钮。
src/Zhijian/App.config 集中管理新手引导、默认语言、最近文件数、历史步数和运行状态文件名。
左侧通过“文件 / 大纲”两个 Tab 切换：单独打开文件时会列出这个文件；打开文件夹时会列出目录下所有支持的脑图文件。
应用层提供窗口、菜单、按钮、列表、输入控件、ToolTip、全局消息和深色主题。
CodeWF.MindView 只依赖 Avalonia，提供可复用的脑图编辑器、小图、节点模型和文档编解码。

主要功能

功能	说明
大纲编辑	支持键盘创建、删除、升降级节点，也可通过节点菜单添加同级、添加子级、上移、下移、备注和删除。
文件工作流	支持空白新建、打开单文件、打开文件夹、最近文件、保存、另存为、打开文件位置和未保存关闭提示。
脑图编辑	支持节点内联编辑、备注、删除、缩放、画布平移、中心主题定位和拖拽调整父子关系。
备注同步	节点备注在大纲和脑图中同步显示，使用灰色文字与标题区分；空备注失焦后自动隐藏。
小图概览	小图按真实节点坐标绘制脑图全局结构，点击小图可以定位到对应区域。
多语言	通过 `Lang.Avalonia.Json` 提供中文简体、中文繁体、英语和日语界面。
新手引导	首次启动高亮真实文件菜单、大纲编辑区、Markdown 切换、脑图画布、小图和状态栏，并提供“跳过”。
配置管理	通过 `App.config` 管理新手引导、默认语言、最近文件数、历史步数和运行状态文件名。
文件格式	支持 Markdown、OPML 和 XMind 文件交换。

运行演示

文件菜单已经补齐为日常编辑需要的完整入口。

标题栏菜单按真实操作分组，覆盖文件、编辑、主题、语言、帮助和关于。

标题栏菜单

首次启动引导会对准真实控件，文件步骤直接高亮标题栏文件菜单。

新手引导

主题和语言可以直接从标题栏菜单切换。

主题和语言切换

复制为 Markdown 会写入剪贴板并显示桌面全局消息。

复制 Markdown 提示

打开的单个文件会显示在左侧文件列表；打开文件夹后则可以先浏览支持的脑图文件，再加载到大纲和脑图视图。

文件列表流程

大纲和脑图菜单都提供高频结构操作。

节点菜单

节点创建、快捷键和焦点回落也可以从键盘完成。

创建节点

大纲圆点菜单支持点击和右键打开，也可拖拽调整结构。

备注与标题使用文字大小和前景色区分，不再额外加背景块。

备注同步

脑图节点工具条提供备注和删除等高频入口。

脑图节点工具条

脑图侧可以拖拽调整父子层级或同级顺序。

脑图拖拽

小图、缩放和画布拖拽用于处理更大的脑图。

小图导航

小图概览

画布拖拽

关于菜单提供打开网站、更新日志、关于和感谢入口。

工程组织

src/
  CodeWF.MindView/          可复用脑图控件、节点模型、小图和文件编解码
  CodeWF.MindView.Themes/   脑图控件默认 Avalonia 资源
  Zhijian/                  桌面应用、大纲视图、文件服务、主窗口和 ViewModel
docs/
  架构说明、源码设计文档和更新后的截图/GIF

CodeWF.MindView 不引用桌面外壳库，方便其他 Avalonia 项目复用；Zhijian 应用层负责标题栏菜单、对话框、文件工作流和大纲视图。

复用 CodeWF.MindView

新的 Avalonia 应用可以只引用脑图控件库和主题库：

<ItemGroup>
  <ProjectReference Include="..\CodeWF.MindView\CodeWF.MindView.csproj" />
  <ProjectReference Include="..\CodeWF.MindView.Themes\CodeWF.MindView.Themes.csproj" />
</ItemGroup>

在 App.axaml 注册资源：

<Application
    xmlns="https://github.com/avaloniaui"
    xmlns:mindThemes="using:CodeWF.MindView.Themes">
    <Application.Styles>
        <mindThemes:MindViewThemes />
    </Application.Styles>
</Application>

页面中使用 MindMapEditor。普通接入只需要绑定节点集合和当前选择：

<UserControl
    xmlns="https://github.com/avaloniaui"
    xmlns:mind="https://codewf.com">
    <mind:MindMapEditor
        Roots="{Binding Roots}"
        SelectedNode="{Binding SelectedNode, Mode=TwoWay}" />
</UserControl>

MindMapEditor 内置基础节点创建、删除、升降级、同级移动、拖拽移动和自动布局。只有当应用需要撤销历史、未保存状态或业务限制时，才需要额外实现 IMindMapEditorController 并绑定 Controller。文件打开、保存、最近文件和未保存提示可以参考 IMindMapFileService 及 src/Zhijian 的应用层实现。

开源项目感谢

枝见的开发离不开这些优秀开源平台和项目：

快速开始

环境要求：

.NET 10 SDK

dotnet restore Zhijian.slnx
dotnet build Zhijian.slnx
dotnet run --project src/Zhijian/Zhijian.csproj

仓库与发布

仓库地址：https://github.com/dotnet9/Zhijian
win-x64 发布地址：TBD
linux-x64 发布地址：TBD