filewash

filewash — 面向 AI Agent 的隐私优先文件工具

为不能将文件发送给第三方的 Agent 和应用提供文件处理层。 压缩、转换、调整大小、合并/拆分 PDF、剥离元数据和移除背景 — 以 MCP 服务、按量计费的 REST API 和 npm SDK 的形式提供。默认零留存：文件在内存中处理，绝不存储或记录日志。

基于 filewash.app 的客户端 WASM 工具构建。采用相同逻辑， 现在可供 Agent 调用。

为什么要开发它

所有其他文件工具 API 和 MCP 服务，都是上传至服务器服务的封装。 对于法律、医疗保健、金融以及任何受 GDPR 约束的工作流来说，这完全不可行 — 将文档传入大模型时也会带来风险。filewash 专为不留存你的文件而构建，并提供了其他 MCP 服务都没有的两种工具：移除背景和清除元数据。

MCP 服务（Claude Desktop、Cursor、Claude Code）

// claude_desktop_config.json  →  mcpServers
{
  "filewash": { "command": "node", "args": ["/path/to/filewash-api/src/mcp/server.js"] }
}

你的 Agent 现在拥有 11 种工具。可以让它：“在我上传这些照片之前，剥离其中的位置元数据”，或*“合并这些合同并旋转扫描页面”*。

REST API

# discover
curl https://api.filewash.app/v1/tools

# strip EXIF/GPS from a photo (returns the cleaned image)
curl -X POST https://api.filewash.app/v1/tools/image_strip_metadata \
  -H "Authorization: Bearer $FILEWASH_KEY" \
  -F '[email protected]' -o clean.jpg

# merge PDFs
curl -X POST https://api.filewash.app/v1/tools/pdf_merge \
  -H "Authorization: Bearer $FILEWASH_KEY" \
  -F '[email protected]' -F '[email protected]' -o merged.pdf

每个响应都包含 X-Filewash-Meta（操作结果）和 X-Filewash-Quota-Remaining。

工具

工具	类别	功能
pdf_merge	pdf	将多个 PDF 合并为一个
pdf_split	pdf	提取指定页面
pdf_rotate	pdf	将页面旋转 90°
pdf_strip_metadata	隐私	移除作者/标题/制作程序/日期
image_compress	image	以目标质量进行有损重新编码
image_convert	image	jpeg ↔ png ↔ webp ↔ avif
image_resize	image	调整大小（绝不放大）
image_strip_metadata	隐私	剥离 EXIF/GPS/ICC/XMP
image_remove_background	image	移除背景 → 透明 PNG（本地 AI 模型，无需上传）
image_watermark	image	平铺文字水印
qr_generate	generate	根据文本/URL 生成 QR 码 PNG

定价（计划中）

套餐	价格	配额	留存
Free	$0	每月 100 次操作	内存中
Pro	~$19/月	每月 10,000 次操作	内存中
Business	~$99/月	不限量	零留存保证 + 审计日志 + BAA

本地运行

npm install
npm run test:engine   # 10 tools, end-to-end, no browser
npm run mcp           # stdio MCP server
npm run rest          # REST API on :8787  (try key "demo")

隐私

REST API 不会将任何文件写入磁盘；MCP 服务只会将输出写入你指定的路径。不会记录任何文件内容。Business 套餐额外提供合同约定的零留存保证和审计日志。