功能总览

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 门语言的编译器与优化器🔒✅

「全能版」是一次性内购(非订阅)。详见 定价。

🧭 下一步:怎么用

第一次上手、快捷键、配置文件放在哪、手机端怎么开始 —— 都在使用说明里。

读使用说明

📚 想查某个函数

随包的说明文档里按语言与库分类列了每个函数的签名与说明,App 内可直接搜。

打开文档