rvs（rust-verb-shell）：一款面向人类和 AI Agent 的结构化 Shell

项目地址

开源仓库：rust-verb-shell:基于Rust的verb-noun风格Shell项目 - AtomGit

采用 MulanPSL-2.0 许可证，欢迎 Fork、Issue、PR。后续教程中所有命令均以此仓库的最新 dev 分支为准。

设计理念

rvs 的定位是「结构化、沙盒优先的 Shell」——既给人用，也给 AI 用。

verb-noun 命名

命令名采用全小写 kebab-case，格式为 verb-noun、verb-noun-noun2……遵循 verb-noun 语义命名规范。

正确写法（rvs native）：

get-child-item get-child-item -recurse set-location /tmp get-content README.md new-item -item-type directory -name demo remove-item demo -recurse get-system-info get-network-interface get-file-hash

参数同样全小写 kebab-case（-recurse、-item-type、-force）。同时保留 POSIX 常用别名作为肌肉记忆桥接：ls / cd / pwd / cat / mkdir / rm / echo / clear，输入别名时 rvs 会提示 💡 对应的完整命令名。

沙盒安全

通过 --sandbox 参数启动沙盒模式，将所有文件系统操作限制在指定目录内：

rvs --sandbox /tmp/sandbox

沙盒模式下拒绝执行外部二进制，防止绕过路径检查。不带 --sandbox 时默认完全文件系统访问。

结构化输出

人类交互默认输出可读表格；AI 或脚本调用时加 --json 参数，只输出合法 JSON，零噪声：

rvs --json get-child-item

AI 友好

所有输出避免字符画、Logo 等 AI 难以解析的内容。命令名采用 verb-noun 语义命名，让 AI 能通过名称推断用途（get-child-item 就是列出子项，set-location 就是切换目录）。

版本号：CalVer YY.M.P

rvs 从 26.7.0 起采用日历版本号（CalVer），格式为YY.M.P：

当前最新版本：v26.7.0（2026 年 7 月首次发布）。低心智负担，看一眼版本号就知道是什么时候发布的。跨月自然进位，月份永远两位数以内。

人类用法速查（面向开发者）

安装与启动

编译（需要 Rust 工具链）：

git clone https://atomgit.com/k4m7v2pz/rust-verb-shell.git cd rust-verb-shell cargo build --release ./target/release/rvs # 或直接 cargo run cargo run -- rvs

进入 REPL 交互模式后，直接输入命令即可：

2026-07-25 20:30:00 UTC+08:00 user@host:/home/user [linux/x86_64] rvs — rust-verb-shell (v26.7.0) user@host: demo@my-pc cwd: /home/user no sandbox (full FS access). use --sandbox <DIR> to restrict. commands use Verb-Noun style (get-child-item, set-location, ...). aliases: ls / cd / pwd / cat / mkdir / rm / echo / clear; 'exit' to quit. >

常用命令速查

管道与过滤

rvs 内建管道，支持按条件过滤、排序、选择列：

get-child-item -recurse | where-object "size > 1024" | sort-object -descending size | select-object -first 5

等价于 POSIX 的find . -size +1k | sort -rn | head -5。

切换传统 Shell

不熟悉 rvs 语法？或临时需要 POSIX 管道？一行命令切换到 bash/zsh/nu：

enter-shell bash # 现在在 bash 里，exit 回到 rvs exit

sshd 环境下也一样工作：rvs -c 'enter-shell bash -c "ls | grep foo"'。

td>0 起递增，跨月重置为 0

当前最新版本：v26.7.0（2026 年 7 月首次发布）。低心智负担，看一眼版本号就知道是什么时候发布的。跨月自然进位，月份永远两位数以内。

AI / Agent 速查

对话式 AI（ChatGPT / 腾讯元宝 / 豆包等）

当用户问「帮我列出当前目录文件」或「读取那个配置文件」时，对话 AI 应该生成 rvs 语法：

命令模板：

# 列目录 get-child-item [path] [-recurse] 读文件 get-content <path> 切换目录 set-location <path> 创建目录 new-item -item-type directory -name <name> 查看进程 get-process [name] 管道过滤 get-child-item -recurse | where-object "size > 1024"

不要输出 PowerShell 的 PascalCase（Get-ChildItem），rvs 所有命令和参数都是全小写 kebab-case。如果用户传入的指令是 POSIX 风格的管道（如ls | grep foo），提示用enter-shell bash切换到 bash 后再执行。

代码 Agent（VSCode Copilot / Trae IDE / AtomCode 等）

Agent 调用 rvs 时应走--json模式，输出是合法 JSON，无需额外解析：

# 单个命令 rvs --json get-child-item /tmp 输出示例（简化） {"ok":true,"command":"get-child-item","args":["/tmp"],"output":["file1.txt","file2.rs"],"exit_code":0}

标准调用流程：

rvs --json -c '<command>' # 或管道喂多行 echo -e "get-location\nget-child-item" | rvs --json

常用调试命令：

# 检查路径是否存在 rvs --json test-path /some/file 获取系统信息 rvs --json get-system-info 获取文件信息 rvs --json get-item /path 列出所有可用命令 rvs --json get-command

沙盒模式调用（处理不可信输入时）：

rvs --sandbox /tmp/safe-box --json get-child-item

一句话总结

rvs = 全小写 Verb-Noun 命令 + 可选沙盒 + 人类表格输出 + AI 的--json模式。项目在 rust-verb-shell:基于 Rust 的 PowerShell 风格 Shell 项目 - AtomGit，版本号 CalVerYY.M.P，当前v26.7.0。