Faaah 今日发布

Faaah（Filesystem As An AI Handler）是一个基于纯文本文件协议的 OpenAI 兼容本地代理工具，核心理念是复用已有的 AI 编程助手订阅作为通用的本地 API 服务器，从而避免为业余项目单独购买 API 密钥。

其工作原理非常直观：Faaah 监听本地的 OpenAI 格式请求，将请求内容写入指定文件夹的 .txt 文件；用户将提示词粘贴给自己的 AI 编程 agent（如 Claude Code、opencode 等），由 agent 将回复写入另一个 .txt 文件；Faaah 读取响应文件，将其封装为 OpenAI 兼容的 JSON 返回给客户端。整个过程围绕文件夹中的文本文件展开，遵循 Unix 哲学中「一切皆文件」的思路。

Faaah 完全零外部依赖，核心实现仅有 308 行 Python 代码，使用 Python 内置的 http.server 模块实现。安装只需一行命令「uv tool install git+https://github.com/sebastiancarlos/faaah」。启动后在本地 127.0.0.1:8000 监听，支持通过命令行参数自定义端口和队列目录。

该工具的另一个亮点是兼容性强：任何支持 OpenAI API 格式的工具（如 GraphRAG、LangChain、LlamaIndex、LiteLLM、openai SDK）都可以将 Faaah 作为本地后端使用。此外还支持「人工介入」机制——如果 agent 运行出错或触发用量限制，用户可以直接打开响应文件手动填写答案，保存后 Faaah 会自动继续处理，相当于给自动化流程留了一个手动 override 的后门。