Code Mind

本地优先的思维导图编辑器，兼具 AI 协作策划能力。通过开放的节点级 REST API，让 AI Agent、IDE 插件、CLI 工具直接读写脑图数据，实现"用户在脑图提需求 → AI 读取上下文 → AI 规划写入 → AI 开发总结回写"的完整闭环。

核心特性

思维导图编辑

• 键盘优先的节点编辑（Tab 创建子节点、Enter 创建同级）
• 节点拖拽、关系线、区域框、优先级标记、颜色标签
• 分支折叠/展开、自动布局、3D 图谱预览
• 亮色/暗色主题、中英双语

AI 集成

• AI 生成脑图 / 扩展节点 / 补全笔记 / 建议关系线
• 支持 LM Studio 或任何 OpenAI 兼容 API
• 内置模板（概念图、项目规划、人物关系）

协作 API（v1.6 新增）

• 节点级 CRUD：GET/POST/PATCH/DELETE 单节点，无需传输整个文档
• 树结构端点：GET /tree 返回嵌套 JSON，AI 一次调用理解项目全貌
• 批量操作：POST /batch 原子性执行多个增删改
• JSON 片段导入：POST /import-fragment 递归创建子树
• API Key 认证：设置面板一键生成，X-API-Key header 保护
• Compact 模式：?compact=true 省略 43% 冗余字段，节省 AI token
• 实时刷新：API 写入后前端 2 秒内自动检测并刷新，新节点有淡入动画

数据存储

• 本地 JSON 文件，零云依赖
• 数据目录基于 exe 位置，任意目录启动均可
• 多地图管理、快照备份

---

与类似产品对比

维度	Code Mind	Miro	Tana	Heptabase	Xmind
本地优先	✅	❌ 云端	❌ 云端	❌ 云端	✅
节点级 API	✅	❌ 画板级	✅	❌	❌
AI Agent 可写入	✅	✅ MCP	✅	✅ MCP	❌
Token 优化	✅ compact	❌	❌	❌	❌
实时反馈	✅ 轮询+动画	✅ WS	❌	❌	❌
免费	✅	❌	❌	❌	部分
面向开发者	✅	❌	❌	❌	❌

---

Structure

• main.go / serve.go: 单一二进制入口（无参数=桌面 GUI；serve=headless HTTP server，端口 7979；mcp=stdio MCP 适配器）
• internal/mindmap: 文档模型、导入导出
• internal/store: 本地 JSON 持久化 + Settings 存储
• internal/server: REST API（含协作 API、AI 代理、认证中间件）
• internal/mcp: stdio MCP 适配器（HTTP API 的薄视图）
• frontend: Vite + TypeScript 客户端
• build: 打包输出 + API-GUIDE.md（面向 AI Agent 的使用指南）
• docs: 开发计划与总结

Current Features

• 键盘优先编辑：Tab 子节点、Enter 同级、F2 重命名、Space 编辑
• 首次运行语言选择（中/英）
• 设置面板：语言、主题、AI 配置、协作 API Key
• AI 语义关系建议、节点笔记补全、知识图谱生成
• AI 连接测试（LM Studio / OpenAI 兼容）
• 优先级标记 P0-P3、节点颜色
• 分支折叠/展开、节点拖拽
• 手动关系线（可编辑标签）
• 自动层级布局
• 3D 浮动图谱（搜索、拖拽旋转、跳转）
• 本地 JSON 持久化
• Markdown 导出、Markdown/TXT 导入
• 协作 API：节点级 CRUD、批量操作、片段导入、compact 模式
• 实时刷新：API 写入后前端自动检测并刷新
• Wails 桌面打包

Shortcuts

• Tab: add child node
• Enter: add sibling node
• Delete: delete selected node subtree
• Space: enter editing with cursor at the end
• F2: rename selected node
• Arrow keys: move selection by direction
• Shift + Arrow keys: extend selection
• Ctrl/Cmd + C: copy current primary subtree
• Ctrl/Cmd + V: paste subtree under current primary node
• Ctrl/Cmd + L: tidy hierarchy layout
• Ctrl/Cmd + S: save

Detailed shortcut notes live in docs/keyboard-shortcuts.md.

Run

Root dev mode:

npm install
npm run dev

npm run dev 会同时启动 Vite 和本地 Go API。AI 测试不会直接访问 LM Studio，而是先访问本地 /api/*，再由 Go 后端转发到你配置的 LM Studio 地址。

Backend only:

go run . serve

Production frontend build:

npm run build

After building the frontend, the Go server serves frontend/dist.

Desktop

Wails desktop dev:

$w = Join-Path (go env GOPATH) 'bin\wails.exe'
& $w dev

Wails desktop build:

$w = Join-Path (go env GOPATH) 'bin\wails.exe'
& $w build -nopackage

Current desktop output:

• build/bin/CodeMind.exe

Verify

Backend tests:

go test ./...

Frontend build:

cd frontend
npm run build