QuackStack

✨ 隆重推出 QuackStack：您的代码库小助手！

厌倦了在复杂代码库中迷失方向？想让您的 AI 编码工具更懂您的项目？QuackStack 应运而生！💡 这款互动式命令行工具，让您可以轻松地与代码库“对话”，深入理解项目架构，并为您的 AI 工具提供精准的上下文信息。

---

🎯 产品亮点与优势

• 本地 AI 嵌入，数据安全有保障： QuackStack 在您的本地计算机上生成索引，无需任何 API 调用。 您的代码数据始终安全无虞，不会上传到任何外部服务器。
• 轻松对话，探索代码： 运行 quack 即可开始与您的代码库进行自然语言对话。它能回答您的问题，提供相关的代码片段，让您快速理解复杂逻辑、查找实现细节或探索不熟悉的代码。对话会话持续打开，保持完整的上下文。
• 智能上下文生成： 使用 quack --context 为主流 AI 编码助手（如 Cursor, Windsurf, Cline, Continue, Aider）生成深度项目架构洞察的上下文文件。您的 AI 工具将真正理解您的代码库结构、模式和设计决策。
• 实时同步，上下文永不过时： 运行 quack --watch，QuackStack 会自动检测文件更改并重新生成上下文文件，确保您的 AI 助手始终拥有最新项目知识。
• 多项目管理无冲突： 每个项目都在数据库中拥有独立的命名空间。在任何项目文件夹中运行 quack，它都会自动管理单独的索引，让您在不同项目之间自由切换。

---

❓ 常见问题解答

QuackStack 如何与我的 AI 编码工具（如 Copilot, Cursor）协同工作？

Copilot 和 Cursor 基于即时上下文建议代码。QuackStack 则赋予它们对整个代码库的深入理解。它是一个完美的补充工具，能生成 .cursorrules 文件，让 Cursor 对您的特定项目、模式和架构更加智能。

我的代码是否会被发送到外部服务器？

不会！QuackStack 完全在您的机器上生成嵌入。您的代码在索引过程中绝不会离开您的计算机。只有您的自然语言查询（例如“身份验证在哪里处理？”）和少量相关的代码片段才会被发送到 AI 提供商，用于生成对话式答案。

首次索引需要多长时间？

首次索引时间取决于您的代码库大小。一个典型的项目（1000-5000 个文件）大约需要 2-5 分钟。之后，只有更改的文件会被重新索引，更新几乎是即时的。大型 monorepos 首次可能需要 10-15 分钟。

QuackStack 是免费的吗？

QuackStack 本身 100% 免费且开源。您的唯一费用可能来自：1) 用于对话式答案的 AI 提供商 API 使用（Gemini 提供免费套餐！），2) 数据库托管（Neon/Supabase 提供免费套餐）。大多数开发者每月花费 0-5 美元，具体取决于使用情况。

---

🚀 立即开始

安装 QuackStack 简单快捷，只需一行命令！

1. 全局安装（推荐）：在终端运行：

   npm install -g quackstack@latest

2. 验证安装：运行 quack --help 查看所有可用命令。
3. 开始使用：导航到任何项目目录，然后运行 quack，即可开始您的代码探索之旅！

支持 Cursor、Windsurf、Cline、Continue 和 Aider 等主流 AI 工具。

---