故障排查

找不到 tokendance 命令

Cargo build 不会注册全局命令。在仓库中运行 cargo run --locked -p tokendance-cli -- --help，或通过路径调用 binary。需要全局入口时，按照安装说明安装本地构建。

响应始终以 mock response 开头

这是当前 Rust CLI 的预期行为。单次运行与交互入口都创建模拟 Provider。设置 API key、修改配置或执行 gateway init 都不会让它切换到真实模型。

--json 出现在响应文字中

将输出参数放在提示词之前：tokendance run --json "hello"。首个提示词参数之后的文字都会作为提示词处理。

配置有效，但没有生效

config validate --project . --json 只校验配置文件，不能证明 CLI 执行路径已消费这些配置。不传 --project 时，校验命令不会加载项目配置。

会话列表为空

CLI 从当前目录的 .tokendance-rs/sessions/ 读取会话。回到启动运行的目录再查看；较早 TypeScript 使用的 .tokendance/ 会话目录与此不同。

旧指南中的命令不存在

查看实际构建的 binary 的 tokendance --help。Rust 预览暴露的命令少于旧 TypeScript CLI，以当前 CLI 参考与开发状态为准。

提交可复现的问题

在 tokendance-code 创建 issue，附上源码 revision、操作系统、实际命令、预期行为和脱敏输出。文档问题可使用页面下方的编辑入口。

在 GitHub 编辑此页