[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-getnao--nao":3,"tool-getnao--nao":61},[4,18,26,36,44,52],{"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":10,"last_commit_at":24,"category_tags":25,"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":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"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 真正成长为懂上",146793,2,"2026-04-08T23:32:35",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":10,"last_commit_at":50,"category_tags":51,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,14],{"id":53,"name":54,"github_repo":55,"description_zh":56,"stars":57,"difficulty_score":10,"last_commit_at":58,"category_tags":59,"status":17},4292,"Deep-Live-Cam","hacksider\u002FDeep-Live-Cam","Deep-Live-Cam 是一款专注于实时换脸与视频生成的开源工具，用户仅需一张静态照片，即可通过“一键操作”实现摄像头画面的即时变脸或制作深度伪造视频。它有效解决了传统换脸技术流程繁琐、对硬件配置要求极高以及难以实时预览的痛点，让高质量的数字内容创作变得触手可及。\n\n这款工具不仅适合开发者和技术研究人员探索算法边界，更因其极简的操作逻辑（仅需三步：选脸、选摄像头、启动），广泛适用于普通用户、内容创作者、设计师及直播主播。无论是为了动画角色定制、服装展示模特替换，还是制作趣味短视频和直播互动，Deep-Live-Cam 都能提供流畅的支持。\n\n其核心技术亮点在于强大的实时处理能力，支持口型遮罩（Mouth Mask）以保留使用者原始的嘴部动作，确保表情自然精准；同时具备“人脸映射”功能，可同时对画面中的多个主体应用不同面孔。此外，项目内置了严格的内容安全过滤机制，自动拦截涉及裸露、暴力等不当素材，并倡导用户在获得授权及明确标注的前提下合规使用，体现了技术发展与伦理责任的平衡。",88924,"2026-04-06T03:28:53",[14,15,13,60],"视频",{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":75,"owner_email":75,"owner_twitter":75,"owner_website":75,"owner_url":76,"languages":77,"stars":113,"forks":114,"last_commit_at":115,"license":116,"difficulty_score":32,"env_os":117,"env_gpu":118,"env_ram":118,"env_deps":119,"category_tags":129,"github_topics":130,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":150,"updated_at":151,"faqs":152,"releases":183},5716,"getnao\u002Fnao","nao","👾 nao is an open source analytics agent. (1) Create context with nao-core cli, (2) deploy nao chat interface for everyone","nao 是一款开源的分析智能体框架，旨在让数据团队快速构建并部署专属的数据问答助手。它解决了传统数据分析中业务人员依赖技术人员取数、沟通成本高以及大模型回答不可控的痛点。通过 nao，用户只需使用命令行工具配置数据源、元数据和业务规则，即可生成一个支持自然语言交互的聊天界面，让非技术人员也能直接用英语提问并即时获得可视化分析结果。\n\n这款工具特别适合数据工程师、分析师以及希望降低数据使用门槛的企业团队。其核心亮点在于“上下文构建器”，允许用户像管理文件系统一样灵活组织数据、文档和工具，且不限数据类型；同时具备“数据栈无关性”，可兼容任意数据仓库和大模型。此外，nao 强调安全与可靠性，支持私有化部署以保障数据隐私，并提供独特的单元测试框架，让团队在上线前就能验证智能体的回答准确率，持续追踪性能表现。从初始化项目到启动聊天界面，nao 让搭建过程变得简单高效，是连接数据资产与业务洞察的桥梁。","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgetnao.io\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\".github\u002Fimages\u002FIcon_template_IOS.svg\" \u002F>\n      \u003Cimg src=\".github\u002Fimages\u002FIcon_template_IOS.svg\" height=\"128\" alt=\"nao logo\" \u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">nao\u003C\u002Fh1>\n\n\u003Ch3 align=\"center\">\n  The #1 Open-Source Analytics Agent\n\u003C\u002Fh3>\n\n\u003Cp align=\"center\">\n  🌐 \u003Ca href=\"https:\u002F\u002Fgetnao.io\">Website\u003C\u002Fa> · 📚 \u003Ca href=\"https:\u002F\u002Fdocs.getnao.io\">Documentation\u003C\u002Fa> · 💬 \u003Ca href=\"https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fnaolabs\u002Fshared_invite\u002Fzt-3cgdql4up-Az9FxGkTb8Qr34z2Dxp9TQ\">Slack\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr\u002F>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgetnao.io\">\n    \u003Cimg src=\".github\u002Fimages\u002Fnao_UI.png\" alt=\"nao Chat Interface\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr\u002F>\n\n## What is nao?\n\nnao is a framework to build and deploy analytics agent. \u003Cbr\u002F>\nCreate the context of your analytics agent with nao-core cli: data, metadata, modeling, rules, etc. \u003Cbr\u002F>\nDeploy a UI for anyone to chat with your agent and run analytics on your data.\n\n## Key Features\n\nFor **data teams**:\n\n- 🧱 **Open Context Builder** — Create a file-system like context for your agent. Add anything you want in the context: data, metadata, docs, tools, MCPs. No limit.\n- 🏳️ **Data Stack Agnostic** — Works with any data warehouse, stack, type of context, LLM.\n- 🕵🏻‍♀️ **Agent Reliability Visibility** — Unit test your agent performance before deploying it to users. Version the context and track the performance of your agent over time. Get users feedbacks to improve the agent and track their usage.\n- 🔒 **Self-hosted & secure** — Self-host your analytics agent and use your own LLM keys to guarantee maximum security for your data.\n\nFor **business users**:\n\n- 🤖 **Natural Language to Insights** — Ask questions in plain English, get analytics straight away\n- 📊 **Native Data Visualization** — Create and customize visualizations directly in the chat interface\n- 🧊 **Transparent Reasoning** — See the agent reasoning and sources clearly\n- 👍 **Easy Feedback** — Send feedback to the data team when a answer is right or wrong\n\n## ⚡️ Quickstart your agent in 1 minute\n\n- **Step 1**: Install nao-core package\n\n    ```bash\n    pip install nao-core\n    ```\n\n\u003Cbr\u002F>\n\n- **Step 2**: Initialize a nao project\n\n    ```bash\n    nao init\n    ```\n\n    It will ask you:\n    - To name your project\n    - If you want to connect a database _(optional)_\n    - If you want to add a repo in agent context _(optional)_\n    - To add an LLM key _(optional)_\n    - If you want to setup a Slack connection _(optional)_\n\n    💡 You can skip any optional question and configure them later in your `nao_config.yaml` file.\n\n    This will create:\n    - A new folder with your project name\n    - An architecture for your context files\n    - A `nao_config.yaml` configuration file\n    - A `RULES.md` file\n\n\u003Cbr\u002F>\n\n- **Step 3**: Verify your setup\n\n    cd to the project folder and run:\n\n    ```bash\n    nao debug\n    ```\n\n\u003Cbr\u002F>\n\n- **Step 4**: Synchronize your context\n\n    ```bash\n    nao sync\n    ```\n\n    This will populate your context folder with your context files (data, metadata, repos, etc.)\n\n\u003Cbr\u002F>\n\n- **Step 5**: Launch the chat and ask questions\n\n    ```bash\n    nao chat\n    ```\n\n    This will start the nao chat UI. It will open the chat interface in your browser at `http:\u002F\u002Flocalhost:5005`.\n    From there, you can start asking questions to your agent.\n\n## Evaluation framework\n\nUnit test your agent performance before deploying it to users. First, create a folder `tests\u002F` with questions and expected SQL in yaml.\nThen, measure agent's performance on examples with nao test command:\n\n```bash\nnao test\n```\n\nView results in tests panel:\n\n```bash\nnao test server\n```\n\n## Commands\n\n```bash\nnao --help\nUsage: nao COMMAND\n\n╭─ Commands ────────────────────────────────────────────────────────────────╮\n│ chat         Start the nao chat UI.                                       │\n│ init         Initialize a new nao project.                                │\n│ sync         Sync context from your context sources (databases, repos)    │\n│ test         Measure agent's performance on test examples.                │\n│ debug        Debug and troubleshoot your nao setup.                       │\n│ --help (-h)  Display this message and exit.                               │\n│ --version    Display application version.                                 │\n╰───────────────────────────────────────────────────────────────────────────╯\n```\n\n## 🐳 Docker\n\nPull the image from DockerHub:\n\n```bash\ndocker pull getnao\u002Fnao:latest\n```\n\nRun nao chat with Docker using the example project bundled in the image:\n\n```bash\ndocker run -d \\\n  --name nao \\\n  -p 5005:5005 \\\n  -e BETTER_AUTH_URL=http:\u002F\u002Flocalhost:5005 \\\n  getnao\u002Fnao:latest\n```\n\nRun nao chat with Docker using your local nao project:\n\n```bash\ndocker run -d \\\n  --name nao \\\n  -p 5005:5005 \\\n  -e BETTER_AUTH_URL=http:\u002F\u002Flocalhost:5005 \\\n  -v \u002Fpath\u002Fto\u002Fyour\u002Fnao-project:\u002Fapp\u002Fproject \\\n  -e NAO_DEFAULT_PROJECT_PATH=\u002Fapp\u002Fproject \\\n  getnao\u002Fnao:latest\n```\n\nAccess the UI at http:\u002F\u002Flocalhost:5005 (or at any URL you configured).\n\nSee the [DockerHub page](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fgetnao\u002Fnao) for more details.\n\nFor end-to-end self-hosted deployment (for example on Cloud Run with PostgreSQL), see the [Deployment Guide](https:\u002F\u002Fdocs.getnao.io\u002Fnao-agent\u002Fself-hosting\u002Fdeployment-guide).\n\n## 👩🏻‍💻 Development\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, commands, and guidelines.\n\n## 📒 Stack\n\n### Backend\n\n- Fastify: https:\u002F\u002Ffastify.dev\u002Fdocs\u002Flatest\u002F\n- Drizzle: https:\u002F\u002Form.drizzle.team\u002Fdocs\u002Fget-started\n- tRPC router: https:\u002F\u002Ftrpc.io\u002Fdocs\u002Fserver\u002Frouters\n\n### Frontend\n\n- tRPC client: https:\u002F\u002Ftrpc.io\u002Fdocs\u002Fclient\u002Ftanstack-react-query\u002Fusage\n- Tanstack Query: https:\u002F\u002Ftanstack.com\u002Fquery\u002Flatest\u002Fdocs\u002Fframework\u002Freact\u002Foverview\n- Shadcn: https:\u002F\u002Fui.shadcn.com\u002Fdocs\u002Fcomponents\n\n## ⛹️‍♀️ Join the Community\n\n- Star the repo\n- Subscribe to releases (Watch → Custom → Releases)\n- Follow us on [LinkedIn](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fgetnao)\n- Join our [Slack](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fnaolabs\u002Fshared_invite\u002Fzt-3cgdql4up-Az9FxGkTb8Qr34z2Dxp9TQ)\n- Contribute to the repo!\n\n## 🫰🏻 Partners\n\nnao Labs is a proud Y Combinator company!\n\n\u003Ca href=\"https:\u002F\u002Fycombinator.com\u002F\">\n    \u003Cimg src=\"https:\u002F\u002Fupload.wikimedia.org\u002Fwikipedia\u002Fcommons\u002Fthumb\u002Fb\u002Fb2\u002FY_Combinator_logo.svg\u002F1200px-Y_Combinator_logo.svg.png\" alt=\"YCombinator\" style=\"padding: 10px\" width=\"70px\">\n\u003C\u002Fa>\n\n## 📄 License\n\nThis project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.\n","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgetnao.io\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\".github\u002Fimages\u002FIcon_template_IOS.svg\" \u002F>\n      \u003Cimg src=\".github\u002Fimages\u002FIcon_template_IOS.svg\" height=\"128\" alt=\"nao logo\" \u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">nao\u003C\u002Fh1>\n\n\u003Ch3 align=\"center\">\n  第一开源分析智能体\n\u003C\u002Fh3>\n\n\u003Cp align=\"center\">\n  🌐 \u003Ca href=\"https:\u002F\u002Fgetnao.io\">官网\u003C\u002Fa> · 📚 \u003Ca href=\"https:\u002F\u002Fdocs.getnao.io\">文档\u003C\u002Fa> · 💬 \u003Ca href=\"https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fnaolabs\u002Fshared_invite\u002Fzt-3cgdql4up-Az9FxGkTb8Qr34z2Dxp9TQ\">Slack\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr\u002F>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgetnao.io\">\n    \u003Cimg src=\".github\u002Fimages\u002Fnao_UI.png\" alt=\"nao 聊天界面\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr\u002F>\n\n## nao 是什么？\n\nnao 是一个用于构建和部署分析智能体的框架。\u003Cbr\u002F>\n使用 nao-core CLI 创建你的分析智能体上下文：数据、元数据、建模、规则等。\u003Cbr\u002F>\n部署一个用户友好的聊天界面，让任何人都可以与你的智能体互动，并对你的数据进行分析。\n\n## 核心功能\n\n**面向数据团队**：\n\n- 🧱 **开放的上下文构建器** — 为你的智能体创建类似文件系统的上下文。在上下文中添加任何内容：数据、元数据、文档、工具、MCP 等，没有任何限制。\n- 🏳️ **数据栈无关** — 适用于任何数据仓库、技术栈、上下文类型以及大语言模型。\n- 🕵🏻‍♀️ **智能体可靠性与透明度** — 在将智能体部署给用户之前，先对其进行单元测试以评估其性能。对上下文进行版本管理，并跟踪智能体随时间的性能表现。收集用户反馈以改进智能体，并追踪其使用情况。\n- 🔒 **自托管且安全** — 自行托管你的分析智能体，并使用你自己的大语言模型密钥，以确保数据的最大安全性。\n\n**面向业务用户**：\n\n- 🤖 **自然语言转洞察** — 用简单的英语提问，即可立即获得分析结果。\n- 📊 **原生数据可视化** — 直接在聊天界面中创建和自定义可视化图表。\n- 🧊 **透明的推理过程** — 清晰地查看智能体的推理逻辑及数据来源。\n- 👍 **便捷的反馈机制** — 当回答正确或错误时，可直接向数据团队发送反馈。\n\n## ⚡️ 一分钟快速启动你的智能体\n\n- **步骤 1**：安装 nao-core 包\n\n    ```bash\n    pip install nao-core\n    ```\n\n\u003Cbr\u002F>\n\n- **步骤 2**：初始化一个 nao 项目\n\n    ```bash\n    nao init\n    ```\n\n    系统会提示你：\n    - 为项目命名\n    - 是否连接数据库（可选）\n    - 是否在智能体上下文中添加代码库（可选）\n    - 添加大语言模型密钥（可选）\n    - 是否设置 Slack 连接（可选）\n\n    💡 你可以跳过任何可选问题，并在后续的 `nao_config.yaml` 文件中进行配置。\n\n    此操作将创建：\n    - 一个以项目名称命名的新文件夹\n    - 用于存放上下文文件的目录结构\n    - 一个 `nao_config.yaml` 配置文件\n    - 一个 `RULES.md` 文件\n\n\u003Cbr\u002F>\n\n- **步骤 3**：验证你的设置\n\n    进入项目文件夹并运行：\n\n    ```bash\n    nao debug\n    ```\n\n\u003Cbr\u002F>\n\n- **步骤 4**：同步上下文\n\n    ```bash\n    nao sync\n    ```\n\n    这将把你的上下文文件（数据、元数据、代码库等）填充到上下文文件夹中。\n\n\u003Cbr\u002F>\n\n- **步骤 5**：启动聊天界面并提问\n\n    ```bash\n    nao chat\n    ```\n\n    这将启动 nao 聊天界面。聊天窗口将在浏览器中打开，地址为 `http:\u002F\u002Flocalhost:5005`。从此处，你可以开始向你的智能体提问。\n\n## 评估框架\n\n在将智能体部署给用户之前，先对其进行单元测试。首先，在 `tests\u002F` 文件夹中创建包含问题和预期 SQL 查询的 YAML 文件。然后，使用 nao test 命令测量智能体在这些示例上的表现：\n\n```bash\nnao test\n```\n\n通过以下命令查看测试结果：\n\n```bash\nnao test server\n```\n\n## 命令列表\n\n```bash\nnao --help\n用法：nao COMMAND\n\n╭─ 命令 ────────────────────────────────────────────────────────────────╮\n│ chat         启动 nao 聊天界面。                                       │\n│ init         初始化一个新的 nao 项目。                                │\n│ sync         从你的上下文源（数据库、代码库）同步上下文          │\n│ test         测量智能体在测试样例中的性能。                        │\n│ debug        调试和排查你的 nao 设置问题。                           │\n│ --help (-h)  显示此消息并退出。                                     │\n│ --version    显示应用程序版本。                                     │\n╰───────────────────────────────────────────────────────────────────────────╯\n```\n\n## 🐳 Docker\n\n从 DockerHub 拉取镜像：\n\n```bash\ndocker pull getnao\u002Fnao:latest\n```\n\n使用镜像中自带的示例项目，通过 Docker 运行 nao 聊天界面：\n\n```bash\ndocker run -d \\\n  --name nao \\\n  -p 5005:5005 \\\n  -e BETTER_AUTH_URL=http:\u002F\u002Flocalhost:5005 \\\n  getnao\u002Fnao:latest\n```\n\n或者，使用你本地的 nao 项目通过 Docker 运行 nao 聊天界面：\n\n```bash\ndocker run -d \\\n  --name nao \\\n  -p 5005:5005 \\\n  -e BETTER_AUTH_URL=http:\u002F\u002Flocalhost:5005 \\\n  -v \u002Fpath\u002Fto\u002Fyour\u002Fnao-project:\u002Fapp\u002Fproject \\\n  -e NAO_DEFAULT_PROJECT_PATH=\u002Fapp\u002Fproject \\\n  getnao\u002Fnao:latest\n```\n\n访问 UI：`http:\u002F\u002Flocalhost:5005`（或你所配置的任何 URL）。\n\n更多详细信息请参阅 [DockerHub 页面](https:\u002F\u002Fhub.docker.com\u002Fr\u002Fgetnao\u002Fnao)。\n\n如需端到端自托管部署（例如在 Cloud Run 上搭配 PostgreSQL），请参考 [部署指南](https:\u002F\u002Fdocs.getnao.io\u002Fnao-agent\u002Fself-hosting\u002Fdeployment-guide)。\n\n## 👩🏻‍💻 开发\n\n开发环境搭建、常用命令及贡献指南，请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。\n\n## 📒 技术栈\n\n### 后端\n\n- Fastify: https:\u002F\u002Ffastify.dev\u002Fdocs\u002Flatest\u002F\n- Drizzle: https:\u002F\u002Form.drizzle.team\u002Fdocs\u002Fget-started\n- tRPC 路由器: https:\u002F\u002Ftrpc.io\u002Fdocs\u002Fserver\u002Frouters\n\n### 前端\n\n- tRPC 客户端: https:\u002F\u002Ftrpc.io\u002Fdocs\u002Fclient\u002Ftanstack-react-query\u002Fusage\n- Tanstack Query: https:\u002F\u002Ftanstack.com\u002Fquery\u002Flatest\u002Fdocs\u002Fframework\u002Freact\u002Foverview\n- Shadcn: https:\u002F\u002Fui.shadcn.com\u002Fdocs\u002Fcomponents\n\n## ⛹️‍♀️ 加入社区\n\n- 给本仓库点个 Star\n- 订阅发布通知（Watch → Custom → Releases）\n- 关注我们的 [LinkedIn](https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fgetnao)\n- 加入我们的 [Slack](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fnaolabs\u002Fshared_invite\u002Fzt-3cgdql4up-Az9FxGkTb8Qr34z2Dxp9TQ)\n- 参与仓库贡献！\n\n## 🫰🏻 合作伙伴\n\nnao Labs 是 Y Combinator 的优秀成员！\n\n\u003Ca href=\"https:\u002F\u002Fycombinator.com\u002F\">\n    \u003Cimg src=\"https:\u002F\u002Fupload.wikimedia.org\u002Fwikipedia\u002Fcommons\u002Fthumb\u002Fb\u002Fb2\u002FY_Combinator_logo.svg\u002F1200px-Y_Combinator_logo.svg.png\" alt=\"YCombinator\" style=\"padding: 10px\" width=\"70px\">\n\u003C\u002Fa>\n\n## 📄 许可证\n\n本项目采用 Apache 2.0 许可证授权——详情请参阅 [LICENSE](LICENSE) 文件。","# nao 快速上手指南\n\nnao 是一个开源的分析智能体（Analytics Agent）框架，允许数据团队构建上下文并部署聊天界面，让业务用户通过自然语言直接查询数据、生成可视化图表。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Linux, macOS 或 Windows (WSL 推荐)\n*   **Python**：版本 3.8 或更高\n*   **包管理器**：`pip` (通常随 Python 安装)\n*   **可选依赖**：\n    *   若需容器化部署，需安装 **Docker**。\n    *   若需连接数据库，请确保网络可访问对应的数据仓库。\n\n> 💡 **国内加速建议**：如果 `pip install` 速度较慢，建议使用国内镜像源（如清华源或阿里源）进行安装。\n\n## 安装步骤\n\n### 方式一：使用 pip 安装（推荐）\n\n直接使用 pip 安装核心包 `nao-core`。\n\n**使用默认源：**\n```bash\npip install nao-core\n```\n\n**使用国内镜像源（推荐国内用户）：**\n```bash\npip install nao-core -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n### 方式二：使用 Docker\n\n如果您希望跳过环境配置直接运行，可以使用 Docker 镜像。\n\n```bash\ndocker pull getnao\u002Fnao:latest\n```\n\n## 基本使用\n\n以下是从零开始构建并运行一个本地分析智能体的最小化流程。\n\n### 1. 初始化项目\n\n在项目目录下运行初始化命令。该命令会引导您创建项目结构、配置文件及规则文件。\n\n```bash\nnao init\n```\n\n执行过程中会根据提示输入：\n*   项目名称\n*   是否连接数据库（可选）\n*   是否添加代码仓库到上下文（可选）\n*   是否配置 LLM API Key（可选，可稍后在 `nao_config.yaml` 中配置）\n*   是否配置 Slack 连接（可选）\n\n> 💡 所有可选配置均可在后续通过编辑生成的 `nao_config.yaml` 文件完成。\n\n### 2. 验证与同步上下文\n\n进入生成的项目文件夹，首先运行调试命令检查配置是否正确：\n\n```bash\nnao debug\n```\n\n确认无误后，同步数据源、元数据等到本地上下文文件夹：\n\n```bash\nnao sync\n```\n\n### 3. 启动聊天界面\n\n运行以下命令启动本地 Web 服务：\n\n```bash\nnao chat\n```\n\n命令执行后，浏览器将自动打开或在终端显示访问地址（默认为 `http:\u002F\u002Flocalhost:5005`）。您可以在界面中输入自然语言问题（例如：“上个季度的销售额是多少？”），nao 将自动解析意图、生成 SQL 并返回数据分析结果或可视化图表。\n\n---\n\n### 附：常用命令速查\n\n| 命令 | 说明 |\n| :--- | :--- |\n| `nao init` | 初始化新项目 |\n| `nao sync` | 从数据源同步上下文 |\n| `nao chat` | 启动聊天 UI 界面 |\n| `nao debug` | 诊断当前配置问题 |\n| `nao test` | 运行单元测试评估智能体性能 |","某电商公司的数据分析师团队每天需响应运营部门关于销售趋势、库存周转及用户行为的临时数据查询请求。\n\n### 没有 nao 时\n- 业务人员不懂 SQL，每次取数都需提交工单等待排期，简单问题往往耗时半天才能拿到结果。\n- 分析师陷入重复性的“写查询 - 导报表”循环，难以专注于深度的归因分析与策略建模。\n- 数据口径缺乏统一文档沉淀，不同分析师对“活跃用户”等指标的定义偶尔不一致，导致决策困惑。\n- 业务方无法直观看到分析过程，对数据结果的信任度低，常需反复沟通确认来源。\n\n### 使用 nao 后\n- 运营人员直接在 nao 的聊天界面用自然语言提问（如“上周华东区复购率最高的品类”），秒级获得精准答案与图表。\n- 分析师利用 nao-core 一次性构建包含数据字典、业务规则和分析模型的上下文环境，将重复咨询自动化。\n- 通过版本化上下文管理，确保全公司基于统一的指标定义进行对话，从源头消除数据歧义。\n- 业务方可在界面中清晰查看 nao 的推理逻辑与数据来源，并通过点赞\u002F点踩功能即时反馈，帮助团队持续优化代理表现。\n\nnao 将传统的数据提取流程转变为实时的智能对话体验，让数据团队从繁琐的取数工作中解放出来，真正驱动业务增长。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fgetnao_nao_98b7c7e9.png","getnao","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fgetnao_1f80dcab.png","",null,"https:\u002F\u002Fgithub.com\u002Fgetnao",[78,82,86,90,94,98,102,106,110],{"name":79,"color":80,"percentage":81},"TypeScript","#3178c6",64.8,{"name":83,"color":84,"percentage":85},"Python","#3572A5",33.2,{"name":87,"color":88,"percentage":89},"CSS","#663399",0.7,{"name":91,"color":92,"percentage":93},"Shell","#89e051",0.5,{"name":95,"color":96,"percentage":97},"Jinja","#a52a22",0.4,{"name":99,"color":100,"percentage":101},"Dockerfile","#384d54",0.2,{"name":103,"color":104,"percentage":105},"JavaScript","#f1e05a",0.1,{"name":107,"color":108,"percentage":109},"HTML","#e34c26",0,{"name":111,"color":112,"percentage":109},"Makefile","#427819",964,114,"2026-04-08T15:23:09","NOASSERTION","Linux, macOS, Windows","未说明",{"notes":120,"python":121,"dependencies":122},"该工具主要通过 Python 包 'nao-core' 或 Docker 容器运行。核心功能依赖外部 LLM 密钥（可自托管或使用自有密钥），支持连接任意数据仓库。运行聊天界面默认占用本地 5005 端口。可通过 Docker 快速部署，也支持在 Cloud Run 等环境配合 PostgreSQL 进行端到端自托管部署。","未说明 (需支持 pip 安装 nao-core)",[123,124,125,126,127,128],"nao-core","Fastify","Drizzle","tRPC","Tanstack Query","Shadcn",[13,16,35],[131,132,133,134,135,136,137,138,139,140,141,142,143,144,145,146,147,148,149],"agentic-analytics","analytics","analytics-engineering","bigquery","business-intelligence","chat-with-your-data","context-engineering","data","data-analysis","data-analyst","data-engineering","databricks","postgresql","self-hosted","snowflake","sql","text-to-sql","slackbot","slack-bot","2026-03-27T02:49:30.150509","2026-04-09T09:31:50.990483",[153,158,163,168,173,178],{"id":154,"question_zh":155,"answer_zh":156,"source_url":157},25928,"修改 nao_config.yaml 后运行同步，为什么已删除的表或仓库仍然存在于文件夹树中？","这是一个已知问题，已在 PR #166 合并后原生修复。现在的实现逻辑会在同步过程中自动清理配置文件中已移除的表或仓库对应的文件，无需手动删除。","https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fissues\u002F41",{"id":159,"question_zh":160,"answer_zh":161,"source_url":162},25929,"如何在 UI 界面中查看当前运行的 nao-core 版本或提交哈希？","可以在设置（Settings）页面中找到版本信息。此外，可以使用快捷键 `Cmd+K` 直接跳转到设置页面。对于 Docker 用户，也可以通过命令行检查镜像标签：`docker image inspect getnao\u002Fnao:latest --format 'nao {{index .Config.Labels \"org.opencontainers.image.version\"}}'`。","https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fissues\u002F305",{"id":164,"question_zh":165,"answer_zh":166,"source_url":167},25927,"如何在同一个 Redshift 数据库中支持不同的 Schema？","该问题已在后续版本中修复。之前尝试通过在配置列表中创建具有相同主机但不同 Schema 的新数据库条目会导致运行 `nao sync` 时删除所有模板数据，现在此行为已得到修正，用户可以正常配置多个 Schema。","https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fissues\u002F192",{"id":169,"question_zh":170,"answer_zh":171,"source_url":172},25930,"前端代码库中推荐使用什么表单管理库？","项目目前倾向于使用 TanStack Form 进行表单管理，以保持与 React Query (TanStack Query) 技术栈的一致性。虽然曾考虑过 Formik，但维护者建议坚持使用与查询库同生态的解决方案以便于复用和维护。","https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fissues\u002F75",{"id":174,"question_zh":175,"answer_zh":176,"source_url":177},25931,"在 Docker 环境中配置 MCP 服务器时，如果显示“Running”但聊天代理无法使用工具怎么办？","这通常是由于容器内网络配置问题导致的。确保在 `docker-compose.yml` 中正确配置了 `extra_hosts`，例如添加 `- \"host.docker.internal:host-gateway\"`，以便容器能够访问宿主机上运行的服务（如本地 Metabase）。同时检查 `mcp.json` 中的环境变量是否正确传递。","https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fissues\u002F202",{"id":179,"question_zh":180,"answer_zh":181,"source_url":182},25932,"切换浏览器标签页时，部署版的 nao 总是断开连接，如何解决？","该问题在特定浏览器（如 Firefox 和 Chrome）的某些版本中曾被报告，但根据维护者反馈，在最新版本中已不再复现（\"do not bug anymore\"）。如果遇到此问题，请尝试更新 nao 到最新版本或清除浏览器缓存。","https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fissues\u002F519",[184,189,194,199,204,208,213,218,222,226,230,234,238,242,247,252,257,262,266,270],{"id":185,"version":186,"summary_zh":187,"released_at":188},163282,"v0.1.4","## 变更内容\n* 功能新增：新增 Azure OpenAI 提供商支持，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F525 中实现。\n* 修复：支持 Snowflake MCP 服务器，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F571 中实现。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.1.3...v0.1.4","2026-04-08T12:51:17",{"id":190,"version":191,"summary_zh":192,"released_at":193},163283,"v0.1.3","## 变更内容\n* 通过设置界面使侧边栏可折叠，由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F563 中实现\n* 功能（CLI）：为 `nao test` 添加 `-u\u002F--username` 和 `--password` 标志，用于 CI 自动化认证，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F566 中实现\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.1.2...v0.1.3","2026-04-08T09:12:38",{"id":195,"version":196,"summary_zh":197,"released_at":198},163284,"v0.1.2","## 变更内容\n* 由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F540 中实现了更优秀的 MCP 工具 UI\n* 修复：支持对表中的复杂类型（数组、JSON 等）进行性能分析，由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F544 中完成\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F550 中优化了 WhatsApp 集成\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F552 中实现了 WhatsApp 用户内存管理、链接代码管理以及 Redis 支持\n* 由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F510 中新增了话题分享聊天功能\n* 由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F554 中修复了一个 bug\n* 由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F555 中重构并去重了共享类型\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F439 中实现了上下文中的查询历史功能\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.1.0...v0.1.2","2026-04-07T17:27:27",{"id":200,"version":201,"summary_zh":202,"released_at":203},163285,"v0.1.0","## 变更内容\n* 修复：在深色模式下使 GitHub 图标可见，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F494 中完成\n* 修复：解决聊天回放错误及工具导航问题，由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F464 中完成\n* 当 X 轴为日期时，按时间顺序对图表数据进行排序，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F493 中完成\n* 从示例 nao_config.yaml 中移除 Notion 配置，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F497 中完成\n* 添加 AGENTS.md 文件，包含 Cursor Cloud 的开发说明，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F498 中完成\n* 功能\u002F233：分享聊天体验，由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F486 中完成\n* 改进聊天输入队列的 UI，并添加后续提示占位符，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F495 中完成\n* 性能优化：将 Docker 构建时间从约 10 分钟优化至约 2 分钟，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F503 中完成\n* 在 Docker 内部使用 CLI，由 @Rish-it 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F505 中完成\n* 新增 Telegram 频道，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F500 中完成\n* 新增 WhatsApp 频道，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F506 中完成\n* 改进消息推送提供商表单及 Slack 流程，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F507 中完成\n* 实现新图表，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F508 中完成\n* 解决多租户问题，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F513 中完成\n* 修复 FastAPI 服务器中 cli_path 解析错误，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F516 中完成\n* 将链接代码部分移至 Telegram 和 WhatsApp 页面，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F518 中完成\n* 功能：为批量删除聊天添加危险区域（软删除），由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F478 中完成\n* 如果启用了 SMTP，则添加重置密码功能，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F509 中完成\n* 添加实时故事功能，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F526 中完成\n* 修复带有大数值的图表 Y 轴截断问题，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F522 中完成\n* 修复当 NAO_DEFAULT_PROJECT_PATH 发生变化时项目未找到的问题，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F524 中完成\n* 功能：在管理员设置中为上下文文件夹添加文件资源管理器，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F491 中完成\n* 在执行 SQL 查询前添加最大查询大小检查，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F532 中完成\n* 修复 (CLI)：在 ai_summary 模板提示中支持 Bedrock，由 @Flamki 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F536 中完成\n* 修复：更新 HTML 元数据使其与 nao 相关，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F538 中完成\n* 修复：在 to_json Jinja 过滤器中保留非 ASCII 字符，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F539 中完成\n* 解决 \u002Fsignup 路由问题，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F541 中完成\n* 功能：在聊天输入中实现图片上传及图片处理功能，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F501 中完成\n* 为 SQL 查询结果表格添加分页功能（#520），由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F523 中完成\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0","2026-03-31T11:17:16",{"id":205,"version":206,"summary_zh":75,"released_at":207},163286,"v0.1.0rc2","2026-03-31T10:30:10",{"id":209,"version":210,"summary_zh":211,"released_at":212},163287,"v0.1.0rc1","它来了！（见里程碑）","2026-03-29T20:46:27",{"id":214,"version":215,"summary_zh":216,"released_at":217},163288,"v0.0.59","## 变更内容\n* 修复：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F474 中为构建流水线和 CLI 添加了 Windows 支持\n* 功能（CLI）：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F473 中为 `nao chat` 命令添加了 `--ngrok` 标志\n* @teoria 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F393 中添加了 MySQL 后端支持\n* 添加 Google Vertex AI - 修复 #469，@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F472 中完成\n* 功能：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F475 中为 monorepo 设置支持 `local_path` 上下文源\n* 开发中：系统级日志支持，@Rish-it 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F446 中实现\n* 功能（CLI）：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F477 中通过可选依赖使 nao-core 的安装更加轻量\n* 修复：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F480 中处理了构建脚本中的 Windows cp1252 编码问题\n* CI：清理夜间工作流中的过时 PR 预览以及手动分发任务，@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F483 中完成\n* 修复（CLI）：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F484 中使 `build.py` 能够在 Windows 上运行\n* 修复（CLI）：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F485 中优雅地处理缺少特定于平台的 npm 包的情况\n* @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F465 中添加了一个用于显示指定编号引用的弹出窗口\n* @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F487 中改进了 Slack 表单，并移除了在 Slack 中显示的引用\n* 性能（CLI）：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F488 中将版本检查放在后台线程中执行，以避免阻塞 CLI 启动\n* 修复：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F492 中防止侧边栏用户菜单中的电子邮件被垂直截断\n* 修复：@Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F490 中将日志设置页面包裹在 `SettingsPageWrapper` 中，以实现一致的布局\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.0.58...v0.0.59","2026-03-20T11:56:35",{"id":219,"version":220,"summary_zh":75,"released_at":221},163289,"v0.0.59rc6","2026-03-20T11:28:31",{"id":223,"version":224,"summary_zh":75,"released_at":225},163290,"v0.0.59rc5","2026-03-19T13:36:55",{"id":227,"version":228,"summary_zh":75,"released_at":229},163291,"v0.0.59rc4","2026-03-19T13:15:24",{"id":231,"version":232,"summary_zh":75,"released_at":233},163292,"v0.0.59rc3","2026-03-19T13:04:27",{"id":235,"version":236,"summary_zh":75,"released_at":237},163293,"v0.0.59rc2","2026-03-19T10:11:38",{"id":239,"version":240,"summary_zh":75,"released_at":241},163294,"v0.0.59rc1","2026-03-19T09:58:03",{"id":243,"version":244,"summary_zh":245,"released_at":246},163295,"v0.0.58","## 变更内容\n* 修复：在侧边栏用户菜单中截断过长的邮箱地址或用户名，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F453 中完成\n* 功能\u002F237 管理员聊天记录回放，由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F425 中完成\n* 将布局职责下放到子页面，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F461 中完成\n* 修复：阻止非管理员用户访问仅限管理员的路由，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F460 中完成\n* 修复(CLI)：处理 BigQuery 分区过滤要求，由 @manypozo 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F433 中完成\n* 归档故事修复 #386，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F463 中完成\n* 新增 ClickHouse 连接功能，由 @poupou-web3 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F317 中完成\n\n## 新贡献者\n* @manypozo 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F433 中完成了首次贡献\n* @poupou-web3 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F317 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.0.57...v0.0.58","2026-03-18T00:00:20",{"id":248,"version":249,"summary_zh":250,"released_at":251},163296,"v0.0.57","## 变更内容\n* 在共享故事时发送邮件，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F438 中实现\n* 自动化文档更新，参考 #304，由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F428 中实现\n* 修复：在跟踪事件中关联 project_id 和 domain_host，由 @paulpriyanshu 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F445 中实现\n* LLM 配置部分现已支持响应式布局，由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F450 中实现\n* 功能\u002F227 数据库性能分析上下文，由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F399 中实现\n\n## 新贡献者\n* @paulpriyanshu 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F445 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.0.56...v0.0.57","2026-03-13T16:18:48",{"id":253,"version":254,"summary_zh":255,"released_at":256},163297,"v0.0.56","## 变更内容\n* 由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F424 中引入的新 Markdown 格式化功能\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F426 中添加的 GPT 5.4 功能\n* 由 @cainemerrick98 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F379 中实现的 KPI 卡片功能\n* 由 @cainemerrick98 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F417 中为显示图表添加的堆叠条形图验证功能\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F413 中添加的聊天输入框中的“+”菜单\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F427 中实现的在系统提示中添加日期和时区的功能\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F430 中修复的聊天菜单问题\n* 由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F423 中实现的 Microsoft Teams 机器人功能\n* 由 @varunguleriaCodes 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F411 中修复的：在现有 nao_config.yaml 存在时，在 nao init 中运行更新流程的问题\n* 由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F436 中改进的 Slack 和 Teams 表单\n* [新数据库连接器] Microsoft Fabric 数据仓库 \u002F SQL 分析端点，由 @d-axel-b 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F392 中实现\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F437 中添加的 PR 预览部署功能\n* 由 @Rish-it 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F435 中添加的 GitHub 和 Slack 社区链接到侧边栏的功能 (#431)\n* 由 @socallmebertille 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F443 中修复的：将反馈发送至正确 ID 消息的问题\n* 由 @Bl3f 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F442 中实现的标题栏功能\n* 由 @MatLBS 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F444 中修复的：将 Teams 添加到使用情况图表，并对 Fabric 依赖项进行懒加载\n\n## 新贡献者\n* @cainemerrick98 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F379 中完成了首次贡献\n* @varunguleriaCodes 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F411 中完成了首次贡献\n* @d-axel-b 在 https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F392 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.0.55...v0.0.56","2026-03-12T22:36:07",{"id":258,"version":259,"summary_zh":260,"released_at":261},163298,"v0.0.55","## 变更内容\n* 功能\u002F在聊天中按@提及搜索，由@Rish-it在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F366中实现\n* 功能\u002F实现聊天SDK，由@MatLBS在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F397中实现\n* 添加网络搜索（来自大模型提供商的原生功能）#269，由@Bl3f在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F384中实现\n* 修复\u002F技能调用问题，由@MatLBS在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F407中修复\n* 使nao测试中的数据框差异比较忽略行顺序，由@ClaireGz在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F408中实现\n* 添加boxlite以运行Python及依赖项，由@Bl3f在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F373中添加\n* 功能\u002F沙箱Docker容器，由@Bl3f在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F412中实现\n* 修复：功能\u002F266当前上下文使用问题，由@socallmebertille在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F404中修复\n* 功能\u002F新的Slack设置流程，由@MatLBS在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F405中实现\n* 功能(CLI)：支持模板中的AI注释（提示词 + AI摘要），由@Flamki在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F382中实现\n* 在CLI中支持AWS区域，由@Bl3f在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F420中实现\n\n## 新贡献者\n* @Rish-it在https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F366中做出了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.0.54...v0.0.55","2026-03-10T09:30:15",{"id":263,"version":264,"summary_zh":75,"released_at":265},163299,"v0.0.55rc3","2026-03-06T12:26:07",{"id":267,"version":268,"summary_zh":75,"released_at":269},163300,"v0.0.55rc2","2026-03-06T09:29:45",{"id":271,"version":272,"summary_zh":273,"released_at":274},163301,"v0.0.54","## What's Changed\r\n* Chat: create tool call group exploration summar by @Standlc in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F374\r\n* Fix story editor, markdown lib version and tables by @Bl3f in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F376\r\n* Feature\u002Fagent conversation compaction by @Standlc in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F377\r\n* Make the app responsive on mobile by @Bl3f in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F378\r\n* feat(frontend): add SQL pretty print formatting by @Balurc in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F381\r\n* Fix MCP HTTP transport detection for streamable-http and SSE by @MatLBS in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F389\r\n* fix: ensure connections are closed after sync operations by @Dozie2001 in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F355\r\n* refactor parser_database_config by @teoria in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F394\r\n* CLI fix : Ollama config by @socallmebertille in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F402\r\n* Add AWS Bedrock as LLM Provider by @rsivapr in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F383\r\n\r\n## New Contributors\r\n* @teoria made their first contribution in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F394\r\n* @rsivapr made their first contribution in https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fpull\u002F383\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fgetnao\u002Fnao\u002Fcompare\u002Fv0.0.53...v0.0.54","2026-03-05T08:23:26"]