使用说明

从下载到跑起第一个任务，大约 5 分钟。看完这一页你应该能自己把都来码用起来。

本页内容

一、第一次使用
二、五种界面入口 + 一次性模式
三、常用斜杠命令
四、快捷键
五、四种「轴」：模式怎么分
六、配置文件与数据放在哪
七、手机端快速上手

一、第一次使用

1. 下载解压

在下载页取对应平台的压缩包，解压后得到一个单文件可执行程序：

Windows：waycoder.exe（x64 或 ARM64）
Linux / macOS：waycoder（x64 或 ARM64）

它已经编译成原生单文件，不需要安装 .NET 运行时，拷到任意目录、加进 PATH 即可。macOS 版未签名公证，首次运行需要右键「打开」，或去掉文件的 quarantine 标记。

下载页另有图形版（waycoder-gui，桌面窗口界面）：解压出来是 waycoder-gui.exe 加几个原生库（SkiaSharp 等），放在同一个目录下运行即可。两者共用同一份配置与工作区（~/.waycoder/）。下面以终端版为例。

2. 配置模型与自己的 API Key

# 第一次运行：直接进全屏终端界面
waycoder

然后在界面里配置模型：

按 Ctrl+T 打开设置（或输入 /settings），进「模型」一组；
或者用命令：/provider list 看服务商、/model key <供应商> <key> 存 Key、/model 选模型（Ctrl+M 也能直接打开模型选择框）。

都来码不自带模型额度。Key 是你自己向服务商（DeepSeek / OpenAI / 通义 / 智谱 / Ollama …）申请的，费用由你与那家服务商直接结算 —— 我们不代收、不经手、也不中转请求。

填入的 Key 只存在本机（~/.waycoder/api_keys.json），不会回传给我们。

用本地模型（Ollama / LM Studio）时，把 BaseUrl 指到本地端口、Key 随便填即可（本地服务不校验）。BaseUrl 不用带 /v1，程序会自动补。本地小上下文模型建议开经济模式（--economy on），否则完整提示词可能超出模型窗口。

3. 第一次对话

waycoder
# 进入界面后直接输入需求，例如：
把 src 下所有 TODO 整理成一份清单

遇到黄色确认栏时按 Y 放行、N 拒绝、A 本会话内全部放行。想先看它打算怎么做，用 Shift+Tab 切到计划模式。

二、五种界面入口 + 一次性模式

入口	命令	说明
全屏终端界面（默认）	`waycoder`	不带参数启动的落点。多轮对话、F1–F10 槽位、侧栏、行内权限确认
网页版	`waycoder --web [端口]`	浏览器三栏界面，默认端口 `9527`，启动后自动打开浏览器
纯命令行	`waycoder --cli`	逐行读入 → 纯文本回复，适合脚本、CI、没有全屏终端的环境
图形界面	`waycoder --gui [文件]`	独立桌面窗口（Avalonia）；带文件参数则直接打开内置编辑器
Watch 模式	`waycoder --watch`	监听源码里的 `AI!` 注释，文件一保存就自动执行

# 五种界面
waycoder                          # 全屏终端界面（默认）
waycoder --web                    # 网页版（默认端口 9527）
waycoder --cli                    # 纯命令行
waycoder --gui                    # 图形界面
waycoder --watch                  # 监听 AI! 注释

# 一次性模式：跑完即退出
waycoder -p "把 src 下所有 TODO 整理成一份清单"
echo "列出目录并统计行数" | waycoder          # 管道读提示词
waycoder --json -p "修复 login 的空指针"      # stdout 只输出一个结构化 JSON，供 IDE / CI 解析

# 给槽位投递任务（F1–F10，可同时投多个）
waycoder -pa "只读不改，只做分析" -p1 "分析 A 模块" -p2 "分析 B 模块"

Watch 模式怎么用：在代码里写一行注释 # AI! 这里为什么会报错，保存文件，都来码会自动把注释当提示词执行，结果回填到代码里。AI? 表示只提问、不改动。

三、常用斜杠命令

在界面里输入 / 会自动补全，/help 看全部。Ctrl+U 打开命令面板（高频动作 + 全部斜杠命令）。

命令	说明
`/help`	全部命令与快捷键
`/mode`	切换工作模式（`build` / `plan` / `chat`，等同 Shift+Tab）
`/model`	模型目录管理：`<id>` 切大模型 / `small <id>` 切小模型 / `list` / `test` / `import`
`/provider`	服务商管理：`list` / `add` / `select` / `apikey set <供应商> <key>`
`/connect`	连接层：一键切换命名连接、`chain on` 开启回退链
`/config`	命令行配置：`list` / `get <key>` / `set <key> <值>`
`/settings`	图形化设置界面（等同 `Ctrl+T`）
`/permit`	权限模式（确认轴）：`ack` / `auto` / `smart` / `yolo`
`/perm`	沙箱边界（边界轴）：`off` / `project` / `network-off` / `hard`
`/edit`	打开内置源码编辑器（语法高亮 / 行号 / 查找替换 / 保存后 Lint 摘要）
`/diff`	逐文件预览本次改动（`/diff <关键词>` 按文件名过滤）
`/session`	会话管理：`list` / `save` / `load` / `resume`
`/compact`	手动压缩上下文（对话变长、变慢时用）
`/reset`	清空对话历史，重开一轮
`/tokens`	看 Token 用量与费用估算
`/git`	Git 操作（`status` / `log` / `diff`），另有 `/autocommit` 自动提交
`/undo`	回退：编辑级（按文件）或检查点级（`/timeline` 看时间线）
`/kb`	自主学习知识库：`mine` 提炼 git 经验 / `search` / `diagnose <报错>` / `review` 间隔重复
`/init`	项目初始化：扫描项目生成 `AGENT.md`（`/init claude` 生成 CLAUDE.md）
`/update`	检查更新；`/update now` 立即升级并自替换
`/mcp`	MCP 服务管理（查看 / 重连）
`/exit`	退出并保存会话（等同 `Ctrl+C`）

更多命令（/join 从别的智能体会话接着跑、/teach 教学模式、/doctor 自检、/theme 主题、/free 免费模型、/repro 导出可复现脚本……）见 /help 与常见问题。

四、快捷键

下表是聊天界面（全屏终端）的键位。对话框打开时键盘归对话框，唯一例外是 Ctrl+C（唯一的系统键，任何时候都能退出）。

🌐 全局

键	功能
`F1`–`F10`	切换工作区槽位
`Esc`	中断当前 Agent（运行中）
`Ctrl+Z`	优雅暂停（本批次后停）
`Ctrl+C`	退出（先保存会话）
`Ctrl+Q`	紧急退出（强制保存，立即）
`Ctrl+S`	打开会话列表
`Ctrl+L`	全屏强制重绘

✏ 编辑

键	功能
`Enter`	发送消息
`Shift+Enter`	输入区换行
`Ctrl+Insert`	复制选中（`Ctrl+C` 被占用为退出，改用此键）
`Ctrl+V`	粘贴
`Tab`	路径补全 / 插 4 空格
`↑↓`	输入历史（输入区非空时）
`←→`	输入区光标移动
`Home` / `End`	输入区行首 / 行尾

📋 行内选择（权限确认 / 计划审批 / 提问）

这一栏在输入框下方就地展开，不弹窗。

键	功能
`↑↓` / `Home` / `End`	在选项间移动
`Enter`	确认 / 问卷下一步
`Esc`	拒绝 / 取消
`Y` / `N` / `A`	允许 / 拒绝 / 全部允许（权限确认）
`Space`	勾选 / 取消勾选（多选）
`←→` / `Tab`	翻页（多题问卷）
`1`–`9`	直选第 N 项（多选页则切换勾选）

🔄 模式

键	功能
`Shift+Tab`	切模式 Build→Plan→Chat（或 `/mode`）
`Ctrl+P`	权限模式循环（Ask/Auto/SmartAuto/Yolo）
`Ctrl+E`	经济模式循环（关→自动→省→极致）
`Ctrl+M` / `/model`	打开模型选择对话框
`Ctrl+N`	快速切换 connect（下一个）
`Ctrl+U`	命令面板
`Ctrl+G`	切换推理深度

🧭 导航

键	功能
`↑↓`	聊天滚动（输入区为空时）
`Ctrl+↑` / `Ctrl+↓`	聊天滚动 3 行
`PgUp` / `PgDn`	聊天列表翻页
`Ctrl+Home` / `Ctrl+End`	聊天跳到顶 / 底部
`Ctrl+T`	打开设置
`Ctrl+B`	切换侧栏
`Ctrl+O`	交换大小模型

🖱 鼠标

操作	功能
左键点击	选中 / 确认
滚轮	列表 / 面板滚动
拖拽标题栏	移动浮窗
拖拽边缘	缩放浮窗

🛠 工具

键	功能
`Ctrl+D`	Diff 预览修改文件
`Ctrl+R`	生成同步二维码（扫码跨设备）
`Ctrl+F`	搜索对话历史
`Ctrl+H`	打开帮助面板（这张表）
`Ctrl+W`	主题选择对话框（轮转主题用 `/theme next`）
`Alt+T`	查看最近一条思考的全文（思考在聊天区折叠成一行，点它也可以）

终端拿不准的键，一律有斜杠命令兜底。Unix / macOS 终端下 Ctrl+M 与 Enter 同码、Ctrl+H 与 Backspace 同码 —— 收不到，请改用 /model、/help；终端开了流控（XOFF）时 Ctrl+S 会冻结，请改用 /session；macOS 上 F1–F10 是媒体键，需配合 Fn 按。

复制是 Ctrl+Insert（Ctrl+C 是退出）；macOS 没有 Insert 键，用终端原生复制。

本程序不用三键组合（Ctrl+Shift+字母 在 Windows 上会被终端抢键），也不占用系统的复制 / 粘贴 / 剪切键。

五、四种「轴」：模式怎么分

都来码的模式分成四个互相独立的方向，一个问题只有一个回答者：

轴	管什么	取值	怎么切
行为轴工作模式	干什么活、有哪些工具	Build（建造，默认，全工具）· Plan（计划，只读工具 + 精简提示词，产出计划待审批）· Chat（聊天，0 工具 0 提示词）	`Shift+Tab` 循环 · `/mode build\|plan\|chat` · 启动时 `--mode`
确认轴权限模式	危险操作执行前何时打断	Ask（必问，默认）· Auto（改必问）· SmartAuto（危必问）· Yolo（不问）	`Ctrl+P` 循环 · `/permit ack\|auto\|smart\|yolo` · 启动时 `--permit` / `-y`
边界轴沙箱	能碰什么（可写范围 / 网络）	off（默认，无边界）· project（仅项目根可写）· network-off（禁网络）· hard（仅项目根 + 禁网络）	`/perm off\|project\|network-off\|hard`
省钱轴经济模式	花多少 token（提示词档位 + 压缩阈值 + 输出上限）	off · auto · on（默认）· extreme（最小提示词 + 核心工具）	`Ctrl+E` 循环 · `/config economy …` · 启动时 `--economy`

一句话决策链：工具有没有看工作模式（Chat = 0 个，Plan = 只读白名单，Build = 全量或经济精简）；能碰什么看沙箱；要不要确认看权限模式；花多少 token 看经济模式。

别把两套同名概念混起来（这是最容易踩的一处）：

/permit 管要不要确认，/perm 管能碰什么 —— 只差一个字母，管的是两件事。

--permit tiny / /permit chat 是切到工作模式 Chat（纯聊天）；而 --tiny 是精简提示词 + 小窗口（工具仍是全量的）。两者名字像，含义不同。

-y / --yolo 只跳过确认，不解除沙箱边界。

六、配置文件与数据放在哪

桌面端：配置和数据都在用户目录下的 ~/.waycoder/（Windows 上是 %USERPROFILE%\.waycoder\）：

路径	内容
`~/.waycoder/config.json`	主配置（唯一权威源）——模型、经济模式、沙箱、主题等全部设置项
`~/.waycoder/api_keys.json`	各服务商的 API Key
`~/.waycoder/connections.json`	命名连接（connect）、服务商、模型回退链
`~/.waycoder/provider/*.json`	模型目录（按供应商分类）
`~/.waycoder/kb/`	自主学习知识库（`/kb`）
项目里的 `.waycoder/`	项目级数据：`memory/` 结构化记忆、`hooks/`、会话、检查点

配置只在本机。这些文件不会被上传到任何服务器；删除它们（或删除 ~/.waycoder/）就等于抹掉本机的全部设置与 Key。

唯一离开本机的数据是：你在对话里主动发出的内容（直接发给你自己配置的模型服务商），以及你主动触发的更新 / 同步请求。

配置项也可以直接命令行读写：waycoder --config get Model、waycoder --config set Temperature 0.3；界面里的等价命令是 /config。

七、手机端快速上手

1. 配置 Key

打开 App →「设置」→「模型」→ 选服务商 → 填入你自己的 API Key。配好后首页会显示已配置的状态。

口径与桌面端完全一致：App 不自带模型额度，Key 是你向服务商申请的，费用与服务商直接结算；Key 只存在手机本地（App 私有目录），不会回传给我们。

2. 五个页签各能干什么

页签	能做什么
首页	欢迎与引导、当前配置状态（哪一个服务商 / 模型）
对话	与 AI 聊天 / 下任务，流式输出，可中断与排队
命令行	模拟终端：跑 shell 命令，也是运行 VML 程序的地方
文件	沙箱工作区的文件浏览与管理；点开文件可进编辑器
设置	服务商 / 模型 / API Key、编辑器与显示选项、全能版、关于

内置编辑器带语法高亮与行号，能直接改工作区里的文件；底部面板分五页 —— 问题、输出、查找、大纲、AI：大纲列出当前文件的函数与类型（带参数表和返回类型），点一条跳到那一行；AI针对整个文件问答或改代码，改代码会先出 diff 让你逐行确认。改完在「命令行」页编译运行。

3. 跑一个示例程序

App 自带一批示例（按语言分目录）。在「命令行」页输入：

vml run examples/c/demo_std.c
# 其它语言的示例在 examples/<语言>/ 下，例如一个经典小游戏
vml run examples/c/tetris.c

每个程序第一次运行时，App 会把随包的标准库解压到工作区（约 39 MB / 5200+ 个文件），界面上会有进度提示 —— 只有首次或库更新后才需要，之后启动很快。

4. 免费版与全能版

免费版就能用编辑器，并编译运行 C 语言与 VML 汇编；「全能版」是一次性内购（非订阅），解锁 27 门语言的编译器与优化器。购买与恢复都在「设置 → 全能版」里。换手机或重装 App 后，用同一个账号点「恢复购买」即可，不额外收费。

还没解决的问题，看常见问题；找不到答案就去技术支持页反馈。