just-bash：面向 AI Agent 的模拟 Bash 与安全边界
介绍 just-bash 的 TypeScript 模拟命令和虚拟文件系统，保留数据查询示例，并说明宿主权限、资源限制与沙箱边界。
直接回答：just-bash 在 JavaScript 环境模拟 Bash 与文件操作，默认内存文件系统可减少直接接触宿主资源，但它不是免疫逃逸的安全边界。文件系统适配器、网络和自定义命令会改变风险。
解决什么问题
给 AI Agent 一个真 shell 能力极强但麻烦巨大：
- 需要服务器/容器/文件系统等基础设施
- 沙箱隔离稍不留神就是安全事故（Agent 执行
rm -rf不是段子）
just-bash 的思路：模拟而非真实。命令在内存虚拟文件系统里跑，Agent 以为自己在用 Bash，默认内存配置不直接提供宿主文件；扩展配置可能开放宿主或网络访问。
上手
import { Bash } from 'just-bash';
const bash = new Bash();
await bash.exec('echo "hello" > /tmp/a.txt');
await bash.exec('cat /tmp/a.txt'); // 输出 hello
await bash.exec('ls /tmp');
文件读写、管道、常用命令都在内存文件系统内完成，是否保留痕迹还取决于宿主日志、持久化与应用配置。
杀手级用法：让 Agent 自己查大数据
场景：让 AI 聊天机器人回答 50MB JSON 数据集的问题。
传统做法：把数据塞进上下文——Token 爆炸，一次提问烧掉几万 Token 还塞不下。
just-bash 做法：
// 数据加载进虚拟文件系统
const bash = new Bash({ files: { '/data/users.json': bigJsonString } });
// Agent 生成命令而不是吞数据
await bash.exec(`cat /data/users.json | jq '[.[] | select(.age > 30)] | length'`);
Agent 只需生成 jq/grep/awk 命令，返回结果而非全量数据——可减少传给模型的数据，但节省量与准确率需测量；生成的筛选条件或字段假设也可能错误。
支持的命令与特性
常用文本处理与文件命令（cat/grep/sed/awk/jq 类）、管道、重定向等。复杂命令与真实 Bash 的边角行为有差异，以官方支持清单为准。
适用场景
- AI 数据分析助手（CSV/JSON/日志文件的即时查询）
- Agent 的沙箱代码执行与文件操作
- 浏览器内的交互式教程/练习环境
常见问题（FAQ）
Q：是否天然免疫逃逸？
A：不是。不能把模拟解释器作为对恶意代码的绝对隔离。对不可信任务，限制文件适配器、网络、自定义命令，并按风险放到独立进程或容器。
Q：MB 数据都毫无压力吗？
A：取决于解析、命令和并发；限制内存、CPU/执行时间与输出长度，测试大文件和循环。
Q：示例是否完整 Agent 系统？
A：不是，bigJsonString 由应用提供；还需权限校验、取消、错误处理与结果验证。
参考资料
资料核对日期：2026 年 9 月 29 日。本文基于公开文档整理，代码片段和评估方案未作独立运行或性能验证；厂商测试结果已注明来源。
