[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-statespace-tech--statespace":3,"tool-statespace-tech--statespace":62},[4,18,28,36,45,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":24,"last_commit_at":42,"category_tags":43,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,44],"语言模型",{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":51,"last_commit_at":52,"category_tags":53,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":24,"last_commit_at":60,"category_tags":61,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":67,"readme_en":68,"readme_zh":69,"quickstart_zh":70,"use_case_zh":71,"hero_image_url":72,"owner_login":73,"owner_name":74,"owner_avatar_url":75,"owner_bio":76,"owner_company":77,"owner_location":77,"owner_email":77,"owner_twitter":78,"owner_website":77,"owner_url":79,"languages":80,"stars":104,"forks":105,"last_commit_at":106,"license":107,"difficulty_score":24,"env_os":108,"env_gpu":109,"env_ram":109,"env_deps":110,"category_tags":113,"github_topics":115,"view_count":24,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":135,"updated_at":136,"faqs":137,"releases":173},9935,"statespace-tech\u002Fstatespace","statespace","Shareable data apps for AI agents","Statespace 是一款专为 AI 智能体设计的可共享数据应用构建工具。它巧妙利用了 AI 熟悉 Unix 命令和文件系统的特性，让开发者能够将本地文件、命令行工具（如 sqlite3、grep、python 等）快速封装成标准化的数据应用。\n\n在 AI 应用中，模型往往难以直接安全地访问私有数据或执行复杂操作。Statespace 通过“自描述”的 Markdown 文件定义应用界面与工具权限，利用正则表达式等机制对 AI 可执行的命令进行严格约束，既赋予了智能体操作数据的能力，又确保了系统的安全性。此外，它支持将应用部署到云端生成公共 URL，或直接作为 MCP 服务器接入，方便不同智能体按需调用，有效节省了上下文令牌。\n\n这款工具特别适合开发者、数据工程师及 AI 应用构建者使用。无论是需要探索数据库 schema、封装遗留 API，还是制定业务规则供团队共享，Statespace 都能提供简洁高效的解决方案。其核心理念在于“任何能在 Shell 中运行的工具皆可被 AI 使用”，极大地降低了构建可信 AI 数据接口的门槛，让数据交互变得更加灵活与安全。","\u003Cbr>\n\n\u003Cdiv align=\"center\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fstatespace-tech\u002Fstatespace\u002Fmain\u002Fdocs\u002Fassets\u002Fimages\u002Fheader_light.png\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstatespace-tech_statespace_readme_dabf9a5652d4.png\" alt=\"Statespace\" width=\"375\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n\n\u003Cbr>\n\n*Shareable data apps for AI agents*\n\n[![Test Suite](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Factions\u002Fworkflows\u002Ftest.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Factions\u002Fworkflows\u002Ftest.yml)\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-007ec6?style=flat-square)](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fblob\u002Fmain\u002FLICENSE)\n[![crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fv\u002Fstatespace?style=flat-square)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fstatespace)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1323415085011701870?label=Discord&logo=discord&logoColor=white&color=5865F2&style=flat-square)](https:\u002F\u002Fdiscord.gg\u002FrRyM7zkZTf)\n[![X](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStatespace-black?style=flat-square&logo=x&logoColor=white)](https:\u002F\u002Fx.com\u002Fstatespace_tech)\n\n\u003C\u002Fdiv>\n\n---\n\n**Website: [https:\u002F\u002Fstatespace.com](https:\u002F\u002Fstatespace.com\u002F)**\n\n**Documentation: [https:\u002F\u002Fdocs.statespace.com](https:\u002F\u002Fdocs.statespace.com\u002F)**\n\n---\n\nAI doesn't know your data, but it knows Unix and filesystems. Statespace lets you transform your files and CLI tools into shareable data apps that any agent can discover and use. Build database explorers, share business rules, or document legacy APIs. Once you’ve created an app, deploy and monitor it with our [cloud platform](https:\u002F\u002Fstatespace.com\u002F).\n\n## Installation\n\n```bash\n$ curl -fsSL https:\u002F\u002Fstatespace.com\u002Finstall.sh | bash\n```\n\n## Quickstart\n\n### 1. Create it\n\nRun `statespace init` in the current directory:\n\n```bash\n$ statespace init\n```\n\n### 2. Build it\n\nAdd constrained CLI tools to `README.md` or any other Markdown file:\n\n```yaml\n---\ntools:\n  - [grep]\n  - [python, scripts\u002Fsummarize.py]\n  - [sqlite3, data\u002Fapp.db, { regex: \"^(SELECT|EXPLAIN)\\\\b.*\" }]\n---\n\n# Instructions\n- Only run read-only queries against the database\n- Use `summarize.py` for aggregations and report generation\n- Use `grep` to search across local files and logs\n```\n\nAlternatively, let your coding agent build it out for you:\n\n```bash\n$ claude \"Document my database schema and add tools to query it\"\n```\n\n### 3. Run it\n\nRun your app locally:\n\n```bash\n$ statespace run --port 8000\n```\n\nAgents and HTTP clients can now read pages and execute tools:\n\n```bash\n# Read a page\n$ curl http:\u002F\u002Flocalhost:8000\u002FREADME.md\n\n# Execute a CLI tool\n$ curl -X POST http:\u002F\u002Flocalhost:8000\u002FREADME.md \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"command\": [\"grep\", \"-r\", \"revenue\", \".\"]}'\n```\n\n### 4. Deploy it\n\nDeploy your app to the cloud:\n\n```bash\n$ statespace deploy --name demo\n```\n\nYour app is now live at a public URL:\n\n```bash\n$ curl https:\u002F\u002Fdemo.statespace.app\u002FREADME.md\n```\n\n### 5. Share it\n\nPoint any agent at the URL directly:\n\n```bash\n$ claude \"Use the API at https:\u002F\u002Fdemo.statespace.app to break down revenue by region\"\n```\n\nOr wire it up as an MCP server:\n\n```json\n\"mcpServers\": {\n  \"statespace\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"statespace-mcp\", \"https:\u002F\u002Fdemo.statespace.app\"]\n  }\n}\n```\n\n## Features\n\n- 🔌 **Any CLI tool** — `psql`, `sqlite3`, `grep`, `python` — if it runs in a shell, it works\n- 🔒 **Safe by default** — regex constraints mean agents can only run what you explicitly allow\n- 🧠 **Self-describing** — Markdown pages are both the documentation and the interface\n- 📖 **Composable** — split across pages so agents load only what they need and save tokens\n- 🚀 **Shareable** — deploy to a URL, wire up as an MCP server, or share with teammates\n\n## Community & Contributing\n\n- **Discord**: Join our [community server](https:\u002F\u002Fdiscord.gg\u002FrRyM7zkZTf) for real-time help and discussions\n- **X**: Follow us [@statespace_tech](https:\u002F\u002Fx.com\u002Fstatespace_tech) for updates and news\n- **Issues**: Report bugs or request features on [GitHub Issues](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues)\n\n## License\n\nThis project is licensed under the terms of the MIT license.\n","\u003Cbr>\n\n\u003Cdiv align=\"center\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fstatespace-tech\u002Fstatespace\u002Fmain\u002Fdocs\u002Fassets\u002Fimages\u002Fheader_light.png\" \u002F>\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstatespace-tech_statespace_readme_dabf9a5652d4.png\" alt=\"Statespace\" width=\"375\" \u002F>\n  \u003C\u002Fpicture>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n\n\u003Cbr>\n\n*面向AI智能体的可共享数据应用*\n\n[![测试套件](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Factions\u002Fworkflows\u002Ftest.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Factions\u002Fworkflows\u002Ftest.yml)\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-007ec6?style=flat-square)](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fblob\u002Fmain\u002FLICENSE)\n[![crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fv\u002Fstatespace?style=flat-square)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fstatespace)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1323415085011701870?label=Discord&logo=discord&logoColor=white&color=5865F2&style=flat-square)](https:\u002F\u002Fdiscord.gg\u002FrRyM7zkZTf)\n[![X](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStatespace-black?style=flat-square&logo=x&logoColor=white)](https:\u002F\u002Fx.com\u002Fstatespace_tech)\n\n\u003C\u002Fdiv>\n\n---\n\n**官网：[https:\u002F\u002Fstatespace.com](https:\u002F\u002Fstatespace.com\u002F)**\n\n**文档：[https:\u002F\u002Fdocs.statespace.com](https:\u002F\u002Fdocs.statespace.com\u002F)**\n\n---\n\nAI并不了解你的数据，但它熟悉Unix和文件系统。Statespace可以帮助你将文件和CLI工具转化为可共享的数据应用，任何智能体都能发现并使用它们。你可以构建数据库浏览器、分享业务规则，或记录遗留API。一旦创建了应用，就可以通过我们的[云平台](https:\u002F\u002Fstatespace.com\u002F)进行部署和监控。\n\n## 安装\n\n```bash\n$ curl -fsSL https:\u002F\u002Fstatespace.com\u002Finstall.sh | bash\n```\n\n## 快速入门\n\n### 1. 创建应用\n\n在当前目录下运行 `statespace init`：\n\n```bash\n$ statespace init\n```\n\n### 2. 构建应用\n\n将受约束的CLI工具添加到 `README.md` 或其他Markdown文件中：\n\n```yaml\n---\ntools:\n  - [grep]\n  - [python, scripts\u002Fsummarize.py]\n  - [sqlite3, data\u002Fapp.db, { regex: \"^(SELECT|EXPLAIN)\\\\b.*\" }]\n---\n\n# 使用说明\n- 只能对数据库执行只读查询\n- 使用 `summarize.py` 进行聚合和报告生成\n- 使用 `grep` 在本地文件和日志中搜索\n```\n\n或者，让你的编程智能体为你完成构建：\n\n```bash\n$ claude \"请记录我的数据库模式，并添加用于查询的工具\"\n```\n\n### 3. 运行应用\n\n在本地运行你的应用：\n\n```bash\n$ statespace run --port 8000\n```\n\n现在，智能体和HTTP客户端可以读取页面并执行工具：\n\n```bash\n# 读取页面\n$ curl http:\u002F\u002Flocalhost:8000\u002FREADME.md\n\n# 执行CLI工具\n$ curl -X POST http:\u002F\u002Flocalhost:8000\u002FREADME.md \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"command\": [\"grep\", \"-r\", \"revenue\", \".\"]}'\n```\n\n### 4. 部署应用\n\n将你的应用部署到云端：\n\n```bash\n$ statespace deploy --name demo\n```\n\n你的应用现在已上线，并可通过公共URL访问：\n\n```bash\n$ curl https:\u002F\u002Fdemo.statespace.app\u002FREADME.md\n```\n\n### 5. 分享应用\n\n直接将URL提供给任何智能体：\n\n```bash\n$ claude \"请使用 https:\u002F\u002Fdemo.statespace.app 上的API，按地区分解收入\"\n```\n\n或者将其配置为MCP服务器：\n\n```json\n\"mcpServers\": {\n  \"statespace\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"statespace-mcp\", \"https:\u002F\u002Fdemo.statespace.app\"]\n  }\n}\n```\n\n## 特性\n\n- 🔌 **任意CLI工具** — `psql`、`sqlite3`、`grep`、`python` — 只要在Shell中运行即可\n- 🔒 **默认安全** — 通过正则表达式约束，确保智能体只能执行你明确允许的操作\n- 🧠 **自描述** — Markdown页面既是文档，也是界面\n- 📖 **可组合** — 内容分散在不同页面上，智能体只需加载所需部分，从而节省资源\n- 🚀 **可共享** — 可部署到URL、配置为MCP服务器，或与团队成员共享\n\n## 社区与贡献\n\n- **Discord**：加入我们的[社区服务器](https:\u002F\u002Fdiscord.gg\u002FrRyM7zkZTf)，获取实时帮助和讨论\n- **X**：关注我们[@statespace_tech](https:\u002F\u002Fx.com\u002Fstatespace_tech)，了解最新动态和资讯\n- **问题**：在[GitHub Issues](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues)中提交Bug或功能请求\n\n## 许可证\n\n本项目采用MIT许可证授权。","# Statespace 快速上手指南\n\nStatespace 是一个将本地文件和 CLI 工具转换为 AI Agent 可发现、可执行的共享数据应用的平台。它让 AI 通过标准的 Unix 文件系统接口安全地访问你的数据。\n\n## 环境准备\n\n*   **操作系统**：支持 Linux、macOS 或 Windows (WSL)。\n*   **前置依赖**：\n    *   确保已安装常用的 Shell 工具（如 `bash`, `curl`）。\n    *   若需使用特定数据库或脚本功能，请预先安装对应工具（如 `sqlite3`, `python`, `psql` 等）。\n*   **网络要求**：需要能够访问 `statespace.com` 以下载安装脚本和部署应用。\n\n## 安装步骤\n\n运行以下命令一键安装 Statespace CLI 工具：\n\n```bash\ncurl -fsSL https:\u002F\u002Fstatespace.com\u002Finstall.sh | bash\n```\n\n安装完成后，在终端输入 `statespace --version` 验证安装是否成功。\n\n## 基本使用\n\n### 1. 初始化项目\n\n在项目根目录下运行初始化命令，生成基础配置文件：\n\n```bash\nstatespace init\n```\n\n### 2. 配置工具与规则\n\n编辑生成的 `README.md`（或任意 Markdown 文件），在文件顶部的 Frontmatter 区域定义允许 AI 使用的 CLI 工具及安全约束。\n\n示例配置如下：\n\n```yaml\n---\ntools:\n  - [grep]\n  - [python, scripts\u002Fsummarize.py]\n  - [sqlite3, data\u002Fapp.db, { regex: \"^(SELECT|EXPLAIN)\\\\b.*\" }]\n---\n\n# Instructions\n- Only run read-only queries against the database\n- Use `summarize.py` for aggregations and report generation\n- Use `grep` to search across local files and logs\n```\n\n> **说明**：上述配置允许 AI 使用 `grep` 搜索文件，运行指定的 Python 脚本，并仅允许对 SQLite 数据库执行以 `SELECT` 或 `EXPLAIN` 开头的只读查询。\n\n### 3. 本地运行\n\n启动本地服务器，默认端口为 8000：\n\n```bash\nstatespace run --port 8000\n```\n\n此时，AI Agent 或 HTTP 客户端即可通过该端口读取文档或执行受控命令：\n\n```bash\n# 读取页面内容\ncurl http:\u002F\u002Flocalhost:8000\u002FREADME.md\n\n# 执行 CLI 工具（例如搜索包含 \"revenue\" 的内容）\ncurl -X POST http:\u002F\u002Flocalhost:8000\u002FREADME.md \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"command\": [\"grep\", \"-r\", \"revenue\", \".\"]}'\n```\n\n### 4. 部署与分享\n\n将应用部署到云端，生成公共访问 URL：\n\n```bash\nstatespace deploy --name demo\n```\n\n部署成功后，你可以直接将生成的 URL（如 `https:\u002F\u002Fdemo.statespace.app`）提供给任何 AI Agent 使用，或将其配置为 MCP 服务器：\n\n```json\n\"mcpServers\": {\n  \"statespace\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"statespace-mcp\", \"https:\u002F\u002Fdemo.statespace.app\"]\n  }\n}\n```","某电商公司的数据分析师希望让内部 AI 助手安全地查询遗留的 SQLite 销售数据库并生成区域营收报告，但受限于数据敏感性和复杂的命令行操作。\n\n### 没有 statespace 时\n- **接入门槛高**：开发者需手动编写复杂的 API 中间件或 LangChain 插件，耗时数天才能将数据库暴露给 AI。\n- **安全风险大**：难以精细控制 AI 的权限，一旦提示词被注入，AI 可能执行 `DROP TABLE` 等危险写操作。\n- **上下文浪费**：为了让 AI 理解表结构，必须在每次对话中重复粘贴庞大的 Schema 定义，消耗大量 Token。\n- **协作困难**：其他团队成员若想复用该数据能力，必须重新配置本地环境或复制代码，无法一键共享。\n\n### 使用 statespace 后\n- **分钟级构建**：只需在 Markdown 文件中声明允许的工具（如 `sqlite3`）和只读正则约束，运行 `statespace init` 即可生成应用。\n- **默认安全**：通过正则表达式严格限制 SQL 语句仅能以 `SELECT` 或 `EXPLAIN` 开头，从根源杜绝数据篡改风险。\n- **自描述接口**：Markdown 文档既是操作指南也是 AI 接口，AI 按需读取页面获取 Schema，显著节省 Token 并提升理解力。\n- **无缝共享**：执行 `statespace deploy` 即可生成公共 URL 或 MCP 服务地址，任何同事的 AI 代理均可直接调用，无需本地部署。\n\nstatespace 将原本孤立的命令行工具转化为安全、可组合且即时共享的数据应用，让 AI 真正“读懂”并安全使用企业私有数据。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fstatespace-tech_statespace_9076c48c.png","statespace-tech","Statespace","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fstatespace-tech_d8b28f35.png","Agent-native web tools",null,"statespace_tech","https:\u002F\u002Fgithub.com\u002Fstatespace-tech",[81,85,89,93,97,100],{"name":82,"color":83,"percentage":84},"Rust","#dea584",91.2,{"name":86,"color":87,"percentage":88},"Shell","#89e051",4.2,{"name":90,"color":91,"percentage":92},"Nix","#7e7eff",1.9,{"name":94,"color":95,"percentage":96},"Just","#384d54",1.2,{"name":98,"color":95,"percentage":99},"Dockerfile",0.9,{"name":101,"color":102,"percentage":103},"Python","#3572A5",0.5,870,67,"2026-04-19T06:03:40","MIT","Linux, macOS","未说明",{"notes":111,"python":109,"dependencies":112},"该工具主要通过一键脚本安装（curl ... | bash），无需手动配置 Python 环境或深度学习依赖。其核心功能是将现有的 CLI 工具（如 grep, sqlite3, python 等）封装为 AI 可调用的接口，因此运行环境需预先安装这些被调用的系统工具。支持部署为 MCP 服务器或直接通过 HTTP 访问。",[],[114,16,13,15,14,27],"其他",[116,117,118,119,120,121,122,123,124,125,126,127,128,129,130,131,132,133,134],"data-engineering","data-science","database","sql","artificial-intelligence","analytics","machine-learning","agent","information-retrieval","context-engineering","markdown","rust","ai","api","web-api","mcp","rag","text-to-sql","self-documenting","2026-03-27T02:49:30.150509","2026-04-20T10:23:55.504224",[138,143,148,153,158,163,168],{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},44609,"如何在 ToolFront 中使用自定义 LLM 提供商（如 OpenRouter 或任意 OpenAI 兼容接口）？","您可以直接使用任何 Pydantic AI 模型提供商和 URL。例如，使用 OpenRouter 的代码如下：\n\n```python\nfrom toolfront import Database\nfrom pydantic_ai.models.openai import OpenAIChatModel\nfrom pydantic_ai.providers.openrouter import OpenRouterProvider\n\nopenrouter_model = OpenAIChatModel(\n    'anthropic\u002Fclaude-3.5-sonnet',\n    provider=OpenRouterProvider(api_key='your-openrouter-api-key'),\n)\n\ndb = Database(\"postgres:\u002F\u002Fuser:pass@localhost:5432\u002Fmydb\")\nanswer = db.ask(\"What's the revenue of our top-5 products\", model=openrouter_model)\n```\n\n更多支持的提供商列表请参考 Pydantic AI 文档。","https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues\u002F53",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},44610,"如何为 Database 对象指定特定的 AI 模型（例如 Mistral）？","不应在初始化 `Database` 时传递 `model` 参数（这会导致连接错误），而应在调用 `ask` 方法时指定模型。正确用法如下：\n\n```python\nfrom toolfront import Database\n\ndb = Database(\"sqlite:\u002F\u002Fdatabase\u002Fhearing_wellness.db\")\n# 在 ask 方法中传入 model 参数\nprint(db.ask(\"How many people participated in the survey?\", model=\"mistral:mistral-large-latest\"))\n```\n\n请参阅官方文档中关于 AI 模型的部分获取更多信息。","https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues\u002F57",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},44611,"使用 uvx 运行 toolfront 时遇到 'no matches found' 错误怎么办？","这是由于最新版本中某些可选依赖项的问题导致的。作为临时解决方案，建议锁定到之前的稳定版本（0.1.10）：\n\n```bash\nuvx --with cryptography \"toolfront[mysql]==0.1.10\" \u003Chost>\n```\n\n请将 `\u003Chost>` 替换为您的实际数据库主机地址。开发团队正在积极修复此问题。","https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues\u002F35",{"id":154,"question_zh":155,"answer_zh":156,"source_url":157},44612,"ToolFront 是否支持 Microsoft SQL Server？","目前尚未完全支持，但即将推出。您可以关注相关的 Pull Request 以获取最新进展，或者在 Discord 社区中询问具体问题。","https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues\u002F5",{"id":159,"question_zh":160,"answer_zh":161,"source_url":162},44613,"是否有命令可以直接更新 ToolFront CLI 而无需重新安装？","是的，该功能已合并。您可以使用顶层命令 `statespace update` 或 `statespace upgrade` 来更新 CLI。系统会考虑向后兼容性，仅在发生重大破坏性变更时强制升级。此外，首次运行命令时可能会收到更新通知。","https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues\u002F120",{"id":164,"question_zh":165,"answer_zh":166,"source_url":167},44614,"企业用户如何通过代理配置自定义的 OpenAI Base URL？","您可以通过使用自定义模型提供商来实现这一目标，这实际上覆盖了代理的默认模型设置。具体配置方法请参考官方文档中的“自定义模型提供商”章节，允许您通过单个端点消费任何模型并进行可观测性管理。","https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues\u002F60",{"id":169,"question_zh":170,"answer_zh":171,"source_url":172},44615,"访问 toolfront.ai 根域名时页面无法加载是怎么回事？","主着陆页暂时下线维护，但很快就会恢复。在此期间，所有关于如何使用该库的信息都可以在官方文档站点 (https:\u002F\u002Fdocs.toolfront.ai\u002F) 找到。","https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fissues\u002F54",[174,179,184,189,194,199],{"id":175,"version":176,"summary_zh":177,"released_at":178},352043,"v0.1.9","## 下载 statespace 0.1.9\n\n| 文件 | 平台 | 校验和 |\n|--------|----------|----------|\n| [statespace-aarch64-apple-darwin.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-aarch64-apple-darwin.tar.xz.sha256) |\n| [statespace-aarch64-unknown-linux-gnu.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-aarch64-unknown-linux-gnu.tar.xz) | ARM64 Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-aarch64-unknown-linux-gnu.tar.xz.sha256) |\n| [statespace-x86_64-unknown-linux-gnu.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-x86_64-unknown-linux-gnu.tar.xz) | x64 Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-x86_64-unknown-linux-gnu.tar.xz.sha256) |\n| [statespace-aarch64-unknown-linux-musl.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-aarch64-unknown-linux-musl.tar.xz) | ARM64 MUSL Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-aarch64-unknown-linux-musl.tar.xz.sha256) |\n| [statespace-x86_64-unknown-linux-musl.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-x86_64-unknown-linux-musl.tar.xz) | x64 MUSL Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.9\u002Fstatespace-x86_64-unknown-linux-musl.tar.xz.sha256) |\n\n\n","2026-04-03T02:39:59",{"id":180,"version":181,"summary_zh":182,"released_at":183},352044,"v0.1.7","## 下载 statespace 0.1.7\n\n| 文件 | 平台 | 校验和 |\n|--------|----------|----------|\n| [statespace-aarch64-apple-darwin.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-aarch64-apple-darwin.tar.xz.sha256) |\n| [statespace-aarch64-unknown-linux-gnu.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-aarch64-unknown-linux-gnu.tar.xz) | ARM64 Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-aarch64-unknown-linux-gnu.tar.xz.sha256) |\n| [statespace-x86_64-unknown-linux-gnu.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-x86_64-unknown-linux-gnu.tar.xz) | x64 Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-x86_64-unknown-linux-gnu.tar.xz.sha256) |\n| [statespace-aarch64-unknown-linux-musl.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-aarch64-unknown-linux-musl.tar.xz) | ARM64 MUSL Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-aarch64-unknown-linux-musl.tar.xz.sha256) |\n| [statespace-x86_64-unknown-linux-musl.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-x86_64-unknown-linux-musl.tar.xz) | x64 MUSL Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.7\u002Fstatespace-x86_64-unknown-linux-musl.tar.xz.sha256) |\n\n\n","2026-03-15T01:15:08",{"id":185,"version":186,"summary_zh":187,"released_at":188},352045,"v0.1.6","## 下载 statespace 0.1.6\n\n| 文件 | 平台 | 校验和 |\n|--------|----------|----------|\n| [statespace-aarch64-apple-darwin.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-aarch64-apple-darwin.tar.xz.sha256) |\n| [statespace-aarch64-unknown-linux-gnu.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-aarch64-unknown-linux-gnu.tar.xz) | ARM64 Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-aarch64-unknown-linux-gnu.tar.xz.sha256) |\n| [statespace-x86_64-unknown-linux-gnu.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-x86_64-unknown-linux-gnu.tar.xz) | x64 Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-x86_64-unknown-linux-gnu.tar.xz.sha256) |\n| [statespace-aarch64-unknown-linux-musl.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-aarch64-unknown-linux-musl.tar.xz) | ARM64 MUSL Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-aarch64-unknown-linux-musl.tar.xz.sha256) |\n| [statespace-x86_64-unknown-linux-musl.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-x86_64-unknown-linux-musl.tar.xz) | x64 MUSL Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.6\u002Fstatespace-x86_64-unknown-linux-musl.tar.xz.sha256) |\n\n\n","2026-03-13T15:53:36",{"id":190,"version":191,"summary_zh":192,"released_at":193},352046,"v0.1.5","## 下载 statespace 0.1.5\n\n| 文件 | 平台 | 校验和 |\n|--------|----------|----------|\n| [statespace-aarch64-apple-darwin.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-aarch64-apple-darwin.tar.xz) | Apple Silicon macOS | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-aarch64-apple-darwin.tar.xz.sha256) |\n| [statespace-aarch64-unknown-linux-gnu.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-aarch64-unknown-linux-gnu.tar.xz) | ARM64 Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-aarch64-unknown-linux-gnu.tar.xz.sha256) |\n| [statespace-x86_64-unknown-linux-gnu.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-x86_64-unknown-linux-gnu.tar.xz) | x64 Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-x86_64-unknown-linux-gnu.tar.xz.sha256) |\n| [statespace-aarch64-unknown-linux-musl.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-aarch64-unknown-linux-musl.tar.xz) | ARM64 MUSL Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-aarch64-unknown-linux-musl.tar.xz.sha256) |\n| [statespace-x86_64-unknown-linux-musl.tar.xz](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-x86_64-unknown-linux-musl.tar.xz) | x64 MUSL Linux | [校验和](https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Freleases\u002Fdownload\u002Fv0.1.5\u002Fstatespace-x86_64-unknown-linux-musl.tar.xz.sha256) |\n\n\n","2026-03-02T04:44:32",{"id":195,"version":196,"summary_zh":197,"released_at":198},352047,"v0.1.3","**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fcompare\u002Fv0.1.2...v0.1.3","2026-02-18T04:43:09",{"id":200,"version":201,"summary_zh":202,"released_at":203},352048,"cli-v0.1.2","**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fstatespace-tech\u002Fstatespace\u002Fcommits\u002Fcli-v0.1.2","2026-01-19T15:23:57"]