实验项目

TokenDanceCode

TokenDanceLab/TokenDanceCode 的定位：一个 Codex / Claude Code 风格的 CLI 实验项目。

定位

TokenDanceCode 是 TokenDanceLab 的 CLI/Agent 实验项目，用来探索 Codex、Claude Code 这类命令行 Agent 的交互方式、执行边界和工程化体验。

它不是 AgentHub 的替代品。AgentHub 关注多 Agent 协作、桌面端和团队工作流；TokenDanceCode 更像一个轻量 CLI 实验场。

适合做什么

试验命令行 Agent 的任务输入、执行反馈和结果呈现。
验证与 TokenDance Gateway 的模型 API 调用体验。
沉淀未来可被 AgentHub Runtime adapter 借鉴的 CLI 交互模式。
作为开源、低承诺的产品想法验证，不把未完成能力写成稳定承诺。

当前产品形态

主题	说明
入口	全局命令行 Coding Agent，目标命令为 `tokendance`
界面	滚动式 CLI 体验，不做全屏 TUI、GUI、Web 或 IDE 插件
模型	当前 CLI 可自动启用 Anthropic-compatible provider；OpenAI provider 映射和测试已存在，但 CLI 自动选择仍不作为默认承诺
架构	Core Runtime 与 CLI Shell 分离，Runtime 输出结构化事件，CLI 负责渲染
工具	文件、shell、git/diff/review 等能力按权限和审查边界逐步实现

本地试用路径

当前项目以源码仓库为准。下面是公开文档可保留的实验性试用路径；OpenAI provider 映射已存在，但 Gateway/OpenAI-compatible CLI 自动选择仍不作为默认入口承诺，真实可用命令以仓库 README、docs/ 和当前实现为准。

powershell

git clone https://github.com/TokenDanceLab/TokenDanceCode.git
cd TokenDanceCode
python -m pip install -e .
$env:ANTHROPIC_API_KEY = "<your-anthropic-compatible-key>"
tokendance

配置与凭据

配置	建议	边界
Anthropic-compatible key	用于当前默认实验路径的本地环境变量	不要提交到仓库、issue、截图或示例配置
OpenAI/Gateway provider	作为 provider 映射方向记录，按仓库当前 README 和实现试用	CLI 自动选择 Gateway 仍不是稳定公开承诺
工作目录	在本地仓库内运行，先用小任务验证文件读取和 diff 输出	不要把私有绝对路径写进公开报告
命令执行	从只读命令开始，逐步进入写入和 shell 操作	写入、shell、git 操作应有明确审查和确认边界

试用时应该观察

任务输入是否清晰进入 runtime，进度和最终结果是否能读懂。
文件读取、diff、命令输出和错误状态是否有结构化边界。
失败时是否能区分模型凭据、网络、命令、权限和代码问题。
CLI 交互里哪些模式值得反馈给 AgentHub Desktop 或 Runtime adapter 设计。

与 AgentHub 的关系

维度	TokenDanceCode	AgentHub
使用场景	个人命令行实验和本地 Agent 体验	多 Agent 协作、Desktop、Web、Hub/Edge、团队工作流
状态承诺	实验项目，低承诺公开说明	产品线，官网和文档持续对齐公开状态
事件价值	沉淀 CLI runtime 事件和交互模式	把 runtime 事件归一为可协作、可审查、可审计的产品事件
Gateway 使用	OpenAI provider 映射存在；CLI 自动选择 Gateway 仍未承诺	通过 adapter 或服务端配置模型 API 边界

实验边界

当前以 GitHub 仓库为公开入口，具体安装、命令和配置以仓库 README 为准。
OpenAI provider 映射存在，但 Gateway/OpenAI-compatible CLI 自动选择仍未作为默认承诺；不要把 TokenDance API key 试用路径写成已稳定能力。
不要把它理解成 AgentHub Desktop 的替代品；它更适合作为命令行 Agent 交互实验。
真实模型 key 应走本地环境变量或 TokenDance Gateway，不写进仓库、issue 或公开截图。
能力描述应保持低承诺：可探索、可试用、可反馈，不写成企业级稳定 SLA。