常见问题

下面都是真实遇到过的问题,每条直接给做法。答不上来的我们宁可不说 —— 那种情况请到技术支持页反馈。

上手与 Key

配了 Key 还是没有反应 / 提示未配置 Key?

去「设置 → 模型」把 Key 填上(桌面按 Ctrl+T 或 /settings;手机在「设置」页签)。桌面也可以用命令存:/model key <供应商> <key> 或 /provider apikey set <供应商> <key>。填好后界面上应显示已配置的模型与状态。

若仍然不行,检查 Key 是否过期、余额是否用完 —— 这类报错由服务商返回,我们只负责转述。

用本地模型(Ollama / LM Studio)要注意什么?

把 BaseUrl 指到本地端口(不用带 /v1,程序会自动补),Key 随便填一个字符串即可(本地服务不校验)。本地小上下文模型建议开经济模式 --economy on,否则完整提示词可能超出模型窗口、被直接拒绝。

重装之后要不要重新配 Key?

要。Key 只存在本机(桌面 ~/.waycoder/api_keys.json,手机在 App 私有目录),不会跟着账号走。重装或换机器后重新填一次即可 —— 这与费用无关,费用本来就是你和模型服务商直接结算的。

编辑器里的大纲和 AI 怎么用?

编辑器底部有五页:问题、输出、查找、大纲、AI。大纲列出当前文件的函数与类型,每条带参数表和返回类型,点一条就跳到那一行,文字跟正文一样语法高亮。

AI 那一页是针对整个文件的对话:「询问」只问答、不改代码;「修改」会先给一份改完的完整文件、弹出 diff 让你逐行确认,点「应用」才写进去,一步就能撤销。每个文件的对话各存一份,运行中随时可以点「■ 停止」。

速度与花费

AI 很慢,或者请求超时?

都来码自身不中转请求:内容从你的机器直接发给你自己配置的模型服务商,所以速度取决于那家服务商当时的状况。最常见的解法是换一个更快的模型(Ctrl+M 或 /model)。超时后程序会按渐进加长的倍率自动重试若干次。

一次任务要花多少钱?能设上限吗?

/tokens 看当前会话的 Token 用量与费用估算,/stats 看会话统计。想设上限用 --max-budget-usd <金额>(-B),超支会自动停止。想省钱还可以开经济模式(--economy,Ctrl+E 循环切换)。

免费版与全能版

免费版能做什么?全能版呢?

免费版:编辑器,加上编译运行 C 语言与 VML 汇编(无优化器)。「全能版」是一次性内购(非订阅),解锁 27 门语言的编译器与优化器。购买和恢复都在「设置 → 全能版」里。

换了手机,怎么恢复已购买的全能版?

「设置 → 全能版 → 恢复购买」,用同一个账号即可,不会重复收费。重装 App 走的是同一步。

数据与隐私

我的代码和数据存在哪?怎么删?

桌面端:~/.waycoder/(配置、Key、模型目录、知识库)加上各项目里的 .waycoder/(记忆、会话、检查点)。手机端:全部在 App 私有目录里(工作区文件也在其中)。

删除这些目录、或卸载 App,本地数据即全部删除。我们不收集、不上传。唯一离开本机的数据是你在对话里主动发出的内容(直接发给你自己配置的模型服务商),以及你主动触发的更新 / 同步请求。

顺带说清两个 .waycoder/ 的分工:~/.waycoder/config.json 是唯一权威源,项目里的 .waycoder/ 只放项目级数据(记忆、会话、hooks)。

兼容与排错

为什么同一个模型在列表里出现了两次?

模型按「(id, 网关地址)」唯一:地址不同就是不同服务商,所以同一个 id 挂在两个网关下都会保留。选哪一个,请求就走哪一个网关,这是有意保留的。

权限确认太频繁,怎么少点几次?

Ctrl+P 循环切换权限模式(Ask / Auto / SmartAuto / Yolo),或 /permit yolo 一次全放行;一次性模式可用 waycoder -y。注意:跳过确认只作用于确认轴,不改变沙箱边界 —— 要限制可写范围与网络,另用 /perm。

TUI 里打中文变成乱码怎么办?

这是终端输入字节的编码问题,已在新版修掉(程序会按控制台代码页正确解码用户输入)。请升级到最新版:/update 检查、/update now 立即升级,或命令行 waycoder --update。若升级后仍能复现,请到技术支持页反馈,并说明终端程序与操作系统版本。

Windows 上命令行输出中文乱码怎么办?

中文 Windows 的 cmd 对管道输出用的是系统 OEM 代码页(GBK),而原生程序输出 UTF-8 —— 程序会按「启动的是什么」区分解码,这类漏点已在新版补齐。请先升级到最新版;若仍能复现,反馈时附上你执行的命令与截图。

手机端装不上(提示未知来源 / 小米的 USB 安装提醒)?

APK 是直接分发的,需要在系统里允许「未知来源」或「安装外部来源应用」;小米等机型通过 USB 安装时会多一次确认提示,按提示允许即可(被拦下就再点一次安装)。

不要为了装新包先卸载旧版 —— 那会连手机上的 API Key、会话与工作区一起删掉。正常覆盖安装即可保留数据。

编译报错怎么反馈?

在「命令行」页或编辑器里执行编译,把完整报错(语言、文件名、行号、错误文本)贴到技术支持页或 Issue 里。信息给全,能省一个来回。

能不能加某门语言 / 某个功能?

可以提。到技术支持页说明使用场景就行 —— 写清「要做什么、为什么现有方式不够」,比只写一个语言名有用得多。

名字与升级

这个软件改过名字?CoreCoder、WayCoder、都来码是什么关系?

是同一个软件,因为与现有商标冲突改过两次名:v0.16.3 由 CoreCoder 改为 WayCoder(道码);v0.96.569 又改为 都来码(Dolaima)(全球发行前回避与韩国 Waycoder co., ltd. 的商标冲突)。

改的只是用户看见的品牌名,代码里的技术名一概没动:可执行文件仍叫 waycoder、仓库目录仍是 WayCoder/、环境变量前缀仍是 WAYCODER_*、配置目录仍是 ~/.waycoder/。所以你以前存的 Key、会话与记忆都还在,文档里的 waycoder 命令照旧敲。

怎么升级?

桌面端:/update 检查新版本,/update now 下载并自替换;脚本 / CI 里用 waycoder --update(已是最新则直接退出)。Windows 会在退出后完成替换并重启,macOS / Linux 直接覆盖运行中的二进制。

手机端:从下载页取新 APK 覆盖安装(数据保留)。App Store 版按正常渠道更新。

我用的环境没有外网 / 在内网,还能用吗?

可以。把 BaseUrl 指向内网的 OpenAI 兼容网关或本地模型服务即可,Key 按那边的要求填。自动升级可以关掉:配置项 UpdateEnabled 设为 false(/config UpdateEnabled false)。


这里没有你要的答案?去技术支持页看联系方式,或者先读使用说明。