架构

模块边界

TokenDanceCode 由四个模块组成，各司其职：

Runtime（核心引擎） — 管理模型 provider、tool 注册与执行、权限判定、对话 transcript 等全部运行时逻辑。你直接通过 CLI 或 SDK 使用它，不需要理解内部细节。

SDK（程序化入口） — 让外部系统（如 AgentHub）或你自己的脚本以代码方式启动对话线程、订阅事件流、处理远程审批。它暴露的是稳定的公共 API，核心内部类不对外暴露。

CLI（命令行工具） — tokendance 命令本体，包含交互式终端和所有斜杠命令。当你在终端里输入 tokendance run，就是它在工作。

AgentHub 集成层 — 连接本地 runtime 与 AgentHub 远程协作平台的桥接代码，负责事件上报、远程审批转发和会话持久化。

运行数据

TokenDanceCode 将所有本地状态写入 .tokendance 目录：

• Transcript — 每次对话的完整 JSONL 记录，可搜索、可回放、可导出
• Task / Todo — 任务与待办项的状态持久化
• Memory — 跨会话的记忆存储
• Subagent 事件日志 — 子代理的独立执行记录
• Worktree 元数据 — 隔离工作区的元信息管理

所有数据通过 SDK facade 统一访问。AgentHub 可以持久化和广播这些事件，但你不应该直接依赖核心运行时内部类来读写状态。

在 GitHub 编辑此页