voicetreelab/voicetree

解决的问题

Voicetree 解决了管理多个 AI 代理时的混乱局面，以及当 LLM 被海量对话历史压垮时出现的「上下文腐烂」问题。它解决了手动代理协调的难题和人与 AI 之间缺乏共享记忆的问题，提供了一种空间化的方式来组织任务、计划和进展。

工作原理

该系统使用基于图的「思维导图」，其中节点是 Markdown 文件，边是维基链接。代理（如 Claude Code、Gemini 或 Codex）存在于这个图中。当代理在某个节点上启动时，它会接收该节点的内容作为任务，并通过可配置的半径和本地嵌入的语义搜索，获得周围节点的上下文访问权限。

代理可以递归地将任务分解为子图，生成自己的并行子代理（以原生终端形式出现），以处理依赖图。人类和代理共享相同的 API 和内存图，使系统能够在运行时自我重构。

适用人群

专为需要外部化工作记忆并保持对代理工作流的高层级监督的开发者和研究人员设计，适用于构建复杂的人机协同（HITL）编码代理系统。

主要亮点

• 空间记忆：使用图布局来组织代理和任务，模仿心理模型，降低认知负荷。
• 人机共享记忆：人类和代理都与同一个基于 Markdown 的超图数据库进行交互。
• 递归分解：代理可以将大任务分解为更小的连接节点，并协调子代理来解决它们。
• 语音转图：包含语音模式，可无手操作捕捉想法，并将口头思考转化为结构化思维导图。
• 代理优先 API：提供轻量级 API 和 CLI（vt），支持对代理的 CRUD 操作、生命周期钩子和图导航。