更新于 2026-10-22

架构

Rust 工作区

Crate	职责
`tokendance-cli`	命令解析、交互入口、诊断与会话查看
`tokendance-core`	Runtime、Provider 与工具接口、权限决策及 transcript 存储
`tokendance-sdk`	程序化 facade 与历史集成契约

当前 CLI 使用模拟 Provider 创建 Runtime。能够返回工具调用的 Provider 可通过 Runtime 使用已注册工具与权限检查，但预览 CLI 尚未接通真实 Provider 选择路径。

本地记录

CLI 将会话保存在当前工作目录的 .tokendance-rs/ 下。session.json 保存会话信息，transcript.jsonl 保存运行记录。使用 CLI 查看命令，避免将较早的 .tokendance/ 路径当成 Rust 会话目录。

较早实现

仓库的 packages/ 中仍保留 TypeScript 源码。其命令、npm import 契约、AgentHub 集成与 TokenDanceID helper 属于历史上下文。Rust npm wrapper 只转发给 Rust binary，没有 TypeScript fallback。

模型适配模块、SDK facade 和 CLI 入口需要分别判断。库模块存在或通过了测试，不代表对应的用户工作流已经由 CLI 暴露。

实现细节以公开源码工作区为准，本组指南对应的版本见开发状态。