wolmilchsau——停止让法学硕士思考。让它写代码。
更聪明的方法: 当一个问题可以用一个小程序来解决时,不要一步一步地让LLM推理。给它一个沙箱,让它编写一个TypeScript解决方案,并在毫秒内获得确定性结果。
版权所有(c)2026 Michael Lechner。根据MIT许可证获得许可。
🇩🇪 德语版
______________________________________________________________________
问题:LLMs浪费时间“思考”
LLM通常花费数十个令牌和宝贵的推理时间来解决简单程序可以在毫秒内解决的问题:
- 解析和转换数据
- 复杂的计算或聚合
- 基于正则表达式的文本处理
- 排序、过滤和格式化
沃尔米尔肖 为您的AI代理提供一个JavaScript/TypeScript执行沙箱。代理可以编写一个小程序,运行它,并得到一个精确的结果,而不是循环一长串的思想。
如何告诉你的法学硕士使用它
将此添加到系统提示中:
*“如果一个任务可以用一个小程序更容易或更可靠地解决(例如数据转换、计算、解析),请使用 execute_script 工具。不要对你能计算的东西进行推理。"*______________________________________________________________________
运作原理
循环: 代理编写代码→ wollmilchsau经营它→ 返回带有源映射的结构化结果或错误→ 代理修复并重试。 通过设计进行自我纠正。
______________________________________________________________________
特性
| 特性 | 描述 |
|---|---|
| 🔐 沙盒V8 | 没有网络,没有文件系统,没有Node.js API |
| ⚡ 在建ESB | 在微秒内绑定TypeScript,无子进程 |
| 🗺️ 源地图 | 错误指向确切的TypeScript行 |
| 🖼️ 工具图标 | MCP兼容客户端中的可视化表示 |
| 📦 工件集成 | 通过以下方式自动保存大量输出 openArtifact() |
| 📊 结构化输出 | 基于JSON模式的结果,用于可靠的工具解析 |
| 🗂️ ZIP请求日志记录 | 每个LLM代码执行的完整审计跟踪 |
| 🔌 标准 + SSE | 本地(Claude Desktop)和远程工作 |
______________________________________________________________________
入门指南
安装(Linux)
# via install script
curl -sfL https://raw.githubusercontent.com/hmsoft0815/wollmilchsau/main/scripts/install.sh | sh
# or download .deb / .rpm from releases\[!注意\] 由于V8依赖性(CGO),我们为 Linux amd64 只有。对于macOS/Windows,从源代码构建。
从源代码构建
# requires build-essential (Linux) or llvm (macOS)
make build
# → build/wollmilchsau码头工人
docker build -t wollmilchsau .
docker run -p 8000:8000 wollmilchsau跑
# stdio mode (default, for Claude Desktop)
./build/wollmilchsau
# SSE/HTTP mode (for remote agents)
./build/wollmilchsau -addr :8080
# with full request logging (ZIP archives)
./build/wollmilchsau -log-dir /var/log/wollmilchsau
# enable artifact service (required for artifact.* and openArtifact())
./build/wollmilchsau -enable-artifacts -artifact-addr localhost:50051
# show version and tool schema
./build/wollmilchsau -version
./build/wollmilchsau -dump命令行标志
| 标志 | 描述 |
|---|---|
-addr | SSE的监听地址(例如。 :8080).如果为空,则使用stdio。 |
-log-dir | 用于存储完整请求/响应ZIP存档的目录(可选)。 |
-enable-artifacts | 必需 实现工件服务集成(artifact 全局对象, wollmilchsau.openArtifact,以及 execute_artifact 工具)。 |
-artifact-addr | 的gRPC地址 mlcartifact 服务器(例如。 localhost:50051).可选,如果为空,则使用默认值。 |
-dump | 将MCP工具模式转储到stdout并退出。 |
-version | 显示版本信息并退出。 |
______________________________________________________________________
Claude桌面集成
添加到配置文件中:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"wollmilchsau": {
"command": "wollmilchsau",
"args": ["-log-dir", "/your/log/path"]
}
}
}______________________________________________________________________
MCP工具
execute_script
执行一个Types/JavaScript代码段。
code--要运行的代码timeoutMs--可选,默认10秒
execute_project
执行一个多文件TypeScript项目。
files--数组{name, content}物体entryPoint--条目文件(例如。main.ts)timeoutMs--可选
check_syntax
在不执行的情况下验证TypeScript语法。返回带有源位置的诊断结果。
______________________________________________________________________
沙盒约束
执行环境严格隔离以确保安全:
- 无网络:
fetch,XMLHttpRequest残疾的 - 无计时器:
setTimeout,setInterval残疾的 - 没有Node.js API: 不
fs,os,process,DOM - 内存限制: 128MB堆
- CPU限制: 可配置超时(默认10秒)
- 纯逻辑: 非常适合计算、转换和解析
______________________________________________________________________
工件集成
当 mlcartifact 如果正在运行,大型输出(图表、报告、数据集)可以保存为持久工件。
沃尔米尔肖 为此提供了高级API:
const fh = wollmilchsau.openArtifact("report.csv", "text/csv");
fh.write("id,name\n1,Alpha\n2,Beta");
const meta = fh.close();
// Returns: { id, uri, name, mimeType, fileSize }使用时 openArtifact(), 沃尔米尔肖 自动添加MCP resource_link 允许LLM客户端立即显示或下载工件。
\[!提示\] 这对于代理编写数据处理代码并自动持久化和链接结果的报告生成工作流尤其强大。
______________________________________________________________________
堆栈
| 组件 | 库 | 目的 |
|---|---|---|
| MCP协议 | mark3labs/mcp-go | JSON-RPC 2.0 |
| TS捆绑 | evanw/esbuild | 快速进程内转译 |
| JS执行 | rogchap/v8go | CGo绑定到V8 |
| 源映射 | 自定义 | VLQ解码和位置分辨率 |
______________________________________________________________________
📜 许可和道德使用
根据 MIT许可证.
🕊️ 作者注 *(无约束力)*
我恳请这个软件 不 用于:
- 军事目的或武器开发
- 支持对乌克兰军事侵略的活动
此外,我明确要求 股份有限公司Isensix。 及其收购方 德怀尔欧米茄 请勿使用此软件。
*这是一种道德诉求,而不是对麻省理工学院许可证的法律修改。*
