功能总览
VML 只是包里的一层。日常真正动手的是这四块:命令行(四种形态)、 内置库(三层)、文件管理器(工作区就在设备里)、编辑器与会话。 每一块都能在手机上用,也都能在桌面上用。
一、命令行:一个入口,四种形态
背后是同一个智能体、同一份配置、同一批工具;换的只是你从哪儿看着它干活。
| 形态 | 怎么进 | 适合 |
|---|---|---|
| ① 手机 / 桌面的「命令行」页 | 底部五个页签之一;输入框直接敲命令 | 跑程序:既是 shell,也是运行 VML 程序的地方 ——
vml run examples/c/app/tetris.c,输出就留在页面上,随时回看 |
| ② 桌面全屏终端(默认) | waycoder |
ANSI 全屏 TUI:状态栏、槽位、行内确认框都在里面;
输入框里 !命令 直接交给系统 shell(Windows 用 cmd),输出回到聊天 |
| ③ 纯命令行 | waycoder --cli |
逐行读入、纯文本回复 —— 脚本、CI、没有全屏终端的环境;
配合 -p "…" 做一次性任务,--json 出一份结构化结果给外部程序解析 |
| ④ 浏览器网页版 | waycoder --web |
三栏网页界面;加 --web-lan 可以让手机当界面、借电脑的算力
(手机编不了 dotnet / gcc / Keil,这条正好补上) |
桌面端还有一个图形界面版本(waycoder --gui),与上面四种共用同一份同会话与配置。
斜杠命令与直通
在 ②③④ 里,/ 开头是内置命令(/model 换模型、/config 改配置、
/session 管会话、/perm 调权限 …),! 开头是把这一行直接交给系统 shell。
完整的键位与命令表见 使用说明。
还能让它在后台自己干
--watch:盯着文件里的AI!/AI?注释,看到就动手;--batch:一份清单多个仓库并行,每个任务 clone 到独立副本里跑,最后汇总成报告;- 子智能体:复杂任务自己拆成几个并行的小任务,各管一段。
二、内置库:三层,随包附带
标准库、示例与帮助文档都打在安装包里(约 36 MB / 4300+ 个文件), 第一次运行 VML 程序时解压到工作区 —— 只有首次或库更新后才需要,之后启动很快。 它分三层,越往下越不该在新程序里直接用:
| 层 | 里面有什么 | 谁该用 |
|---|---|---|
| 共享库 | 三层字符串(string / wstring / ustring)、
格式化输入输出(printf / scanf 及宽字符变体)、表达式求值
(parserexp / parserexpf)、数学与浮点(math /
float / softdouble / softint64),
以及 os / file / network / memory /
device / convert |
所有语言都能直接调:一份实现在 27 门语言间共用,换语言不用换心智模型 |
| 绘图与界面 | tty_* 彩色文字(光标定位、清屏、窗口尺寸)·
ui_* 图像(开窗、图元、触摸与按键、定时器、音效、存档)·
ui_3d_* 三维(视口、网格、相机、光照) |
新写的程序只该用这一层;详见 VML 介绍 |
| 兼容层 | conio / crt(老式字符界面)、graphics(BGI) |
只服务老程序:一行不改就能编能跑,内部转发到上面那一层,不模拟显存 |
这些库不是每种语言手抄一遍:都由生成器从同一份 C 实现生成 27 份绑定, 所以签名不会各写各的。函数清单在编辑器里直接可查(见下一节的补全与大纲)。
三、文件管理器:工作区就在设备里
「文件」页管的是你的工作区:代码、示例、随手记录都放这里。
手机端开启「所有文件访问」后工作区落在 sdcard/waycoder/workspace(卸载重装不丢),
没开时放在 App 私有目录。
能做什么
- 新建文件 / 新建文件夹 / 导入;重命名、删除;
- 压缩与分享:创建 ZIP、解压到此处、把整个目录「打包并分享 ZIP」(微信发过去,对方导入解压即可用);
- 按类型给动作,不让你自己猜:文本进编辑器;源码给「VML 编译 / VML 运行」;
.glb/.gltf/.obj给 3D 预览;.sql能直接运行;.dbf能查看编辑;其余类型交给系统应用打开。
点开头的文件与目录默认都不显示(.gitignore、.env 这类也藏起来),
设置里有开关;示例的图标目录 .resource 是唯一的例外开关。
四、编辑器与会话
编辑器
- 语法高亮 + 行号,按扩展名认语言;
- 补全:候选来自随包的函数签名表(不是猜),上下键选、回车或空格接受;
- 大纲:列出当前文件的类 / 接口 / 枚举 / 结构体 / 函数 / 方法,带参数表与返回类型,点一条跳到那一行;
- 底部面板五页:问题(编译错误与位置)、输出、查找、大纲、AI;
- AI 针对整个文件:问答或多轮修改,改动先出 diff,逐块确认后才落盘;
- 外接键盘可用(方向键、翻页、Home/End、Del),手机上还有一个可拖的蓝色「水滴」快速挪光标。
会话与记忆
- 会话历史:新建、切换、清空全部、单条删除;
- 多槽位并行(桌面):F1–F10 十个独立会话,各有一套用户与智能体,可以一边跑任务一边聊别的;
- 记忆:
.waycoder/memory/*.md一条事实一个文件,外加MEMORY.md索引; 新会话按相关度自动检索并注入提示词 —— 项目约定、你的偏好不用每次重讲。
五、远程:SSH 终端与文件传输
手机上干不了的活,交给你的电脑或服务器。两条路都共用账号体系 (设置 → 账号),一次存好,之后点一行就连。
SSH 终端
- 内置的是真终端:`ESC[H` 光标定位、逐格颜色、备用屏都按终端语义重画 ——
vim、top显示正常,claude code、codex这类命令行 AI 也能挂在手机上用; - 连上之后连接表单自动收起,终端铺满屏;顶栏只留
user@host:port与「断开」; - 手机键盘上没有的那几个键单独给一排:^C / ^D / Esc / Tab / 方向键 / 粘贴 / 清屏,横向可滚;
- 双指捏合改字号(松手才重排),点一下终端聚焦输入框;
- 给模型也能用:
ssh工具带command/account参数, 智能体可以自己登上去跑一条命令再把结果带回来。
FTP / SFTP 传输
- 文件与目录前面都有勾选框:勾选即传,整个目录也行(目录保持目录结构);
- 本地这一端就是你文件页当前所在的目录,不用再选一次路径;
- 目录里
.开头的隐藏文件与目录自动跳过; - 传输走任务页:有进度、能取消、传完给结果,失败会说明是哪一项。
六、免费与解锁的分界
| 能力 | 免费版 | 全能版 |
|---|---|---|
| 编辑器、大纲、补全、AI 改代码 | ✅ | ✅ |
| 命令行(四种形态)、文件管理器 | ✅ | ✅ |
| 内置库、示例程序 | ✅ | ✅ |
| C 语言与 VML 汇编的编译运行 | ✅ | ✅ |
| 其余 25 门语言的编译器与优化器 | 🔒 | ✅ |
「全能版」是一次性内购(非订阅)。详见 定价。
都来码 Dolaima