[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-cased--kit":3,"tool-cased--kit":62},[4,18,28,37,45,53],{"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},10095,"AutoGPT","Significant-Gravitas\u002FAutoGPT","AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台，核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点，让用户只需设定目标，AI 即可自主规划步骤、调用工具并持续运行直至完成任务。\n\n无论是开发者、研究人员，还是希望提升工作效率的普通用户，都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体；研究人员能基于开源架构探索多智能体协作机制；而非技术背景用户也可直接选用预置的智能体模板，立即投入实际工作场景。\n\nAutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑，每个块负责单一动作，灵活且易于调试。同时，平台支持本地自托管与云端部署两种模式，兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本，即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛，让人人都能成为 AI 的创造者与受益者。",183572,"2026-04-20T04:47:55",[13,36,27,14,15],"语言模型",{"id":38,"name":39,"github_repo":40,"description_zh":41,"stars":42,"difficulty_score":10,"last_commit_at":43,"category_tags":44,"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":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":24,"last_commit_at":51,"category_tags":52,"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 真正成长为懂上",161692,"2026-04-20T11:33:57",[14,13,36],{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":59,"last_commit_at":60,"category_tags":61,"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":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":78,"owner_twitter":79,"owner_website":80,"owner_url":81,"languages":82,"stars":120,"forks":121,"last_commit_at":122,"license":123,"difficulty_score":59,"env_os":124,"env_gpu":125,"env_ram":125,"env_deps":126,"category_tags":132,"github_topics":77,"view_count":24,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":133,"updated_at":134,"faqs":135,"releases":166},10171,"cased\u002Fkit","kit","The toolkit for AI devtools context engineering. Build with codebase mapping, symbol extraction, and many kinds of code search.","kit 是一款专为 AI 开发工具打造的代码智能引擎，旨在解决大模型在理解复杂代码库时面临的“上下文缺失”难题。它通过构建精准的代码库映射、提取关键符号（如函数、类）以及提供多维度的代码搜索能力，让 AI 代理能够像资深工程师一样透彻理解项目结构、依赖关系和具体实现细节。\n\n无论是希望构建智能代码审查员、自动化代码生成器，还是想开发新一代 AI 原生 IDE 的开发者与研究人员，kit 都是理想的选择。它支持从本地仓库到远程 GitHub 项目（含私有库）的无缝加载，甚至能同时处理微服务架构下的多仓库关联分析。\n\nkit 的技术亮点在于其生产级的就绪状态与灵活的集成方式。用户既可以通过简洁的 Python API 直接调用，也能利用 MCP 协议、REST 接口或命令行工具将其嵌入现有工作流。特别值得一提的是，kit 提供了专门的 Claude Code 插件，赋予 AI 助手自主分析代码库的能力，使其能准确回答关于认证逻辑、类引用追踪或项目依赖等深层技术问题，极大提升了 AI 辅助编程的准确性与深度。","# kit 🛠️ Code Intelligence Toolkit\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcased_kit_readme_6529433e2d89.png\" width=\"360\">\n\n`kit` is a production-ready toolkit for codebase mapping, symbol extraction, code search, and building LLM-powered developer tools, agents, and workflows. \n\nUse `kit` to build things like code reviewers, code generators, even IDEs, all enriched with the right code context. Work with `kit` directly from Python, or with MCP + function calling, REST, or CLI.\n\nExplore the **[full documentation](https:\u002F\u002Fkit.cased.com)** for detailed usage, advanced features, and practical examples. Check out docs for kit's [local dev MCP server](https:\u002F\u002Fkit-mcp.cased.com), too.\n\n\n## Quick Installation\n\n### Install from PyPI\n\n```bash\nuv pip install cased-kit\n\n# With ML features for advanced analysis and vector search\nuv pip install 'cased-kit[all]'\n```\n\n### Install Globally with uv (easiest for CLI usage)\n\nIf you want to use the `kit` CLI globally without affecting your system Python, use `uv tool install`. This creates an isolated environment for `kit` while making the CLI available from anywhere:\n\n```bash\n# Install the base kit CLI globally\nuv tool install cased-kit\n\n# Everything (including MCP server and all features)\nuv tool install cased-kit[all]\n```\n\nAfter installation, the `kit` and `kit-dev-mcp` commands will be available globally. To manage your uv tool installations:\n\n```bash\n# List installed tools\nuv tool list\n\n# Uninstall if needed\nuv tool uninstall cased-kit\n```\n\n### Claude Code Plugin\n\nUse kit directly in [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) with the official plugin:\n\n```bash\n\u002Fplugin marketplace add cased\u002Fclaude-code-plugins\n\u002Fplugin install kit-cli\n```\n\nThe plugin gives Claude autonomous access to kit's codebase analysis tools. Claude will automatically use kit when you ask questions like:\n- \"How does authentication work in this codebase?\"\n- \"Find all usages of the UserModel class\"\n- \"What are the dependencies of this project?\"\n- \"Show me the file structure of src\u002F\"\n\nSee the [Claude Code Integration Guide](https:\u002F\u002Fkit.cased.com\u002Fintroduction\u002Fclaude-code) for details.\n\n## Toolkit Usage\n\n### Basic Python API\n\n```python\nfrom kit import Repository\n\n# Load a local repository\nrepo = Repository(\"\u002Fpath\u002Fto\u002Fyour\u002Flocal\u002Fcodebase\")\n\n# Load a remote public GitHub repo\nrepo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\")\n\n# Load a private GitHub repo (automatically uses KIT_GITHUB_TOKEN if set)\nrepo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Fprivate-repo\")\n\n# Or explicitly\nrepo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Fprivate-repo\", github_token=\"ghp_...\")\n\n# At a specific commit, tag, or branch\n# repo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\", ref=\"v1.2.3\")\n\n# For multiple repos (microservices, monorepos, team projects)\nfrom kit import MultiRepo\nrepos = MultiRepo([\"~\u002Fcode\u002Ffrontend\", \"~\u002Fcode\u002Fbackend\", \"~\u002Fcode\u002Fshared\"])\nrepos.search(\"handleAuth\")  # Search across all repos\n```\n\n```python\n# Explore a repo\nprint(repo.get_file_tree())\n# Output: [{\"path\": \"src\u002Fmain.py\", \"is_dir\": False, ...}, ...]\n\nprint(repo.extract_symbols('src\u002Fmain.py'))\n# Output: [{\"name\": \"main\", \"type\": \"function\", \"file\": \"src\u002Fmain.py\", ...}, ...]\n\n# Access git metadata\nprint(f\"Current SHA: {repo.current_sha}\")\nprint(f\"Branch: {repo.current_branch}\")\n\n# Read one file\nmain_py = repo.get_file_content(\"src\u002Fmain.py\")\n\n# Read many files in one round-trip\ncontents = repo.get_file_content([\n    \"src\u002Fmain.py\",\n    \"src\u002Futils\u002Fhelper.py\",\n    \"tests\u002Ftest_main.py\",\n])\nprint(contents[\"src\u002Futils\u002Fhelper.py\"])\n```\n\n### Command Line Interface\n\n`kit` provides a comprehensive CLI for repository analysis and code exploration.\n\n**Repository Analysis:**\n```bash\n# Get repository file structure\nkit file-tree \u002Fpath\u002Fto\u002Frepo\n\n# Extract symbols (functions, classes, etc.)\nkit symbols \u002Fpath\u002Fto\u002Frepo --format table\n\n# Search for code patterns\nkit search \u002Fpath\u002Fto\u002Frepo \"def main\" --pattern \"*.py\"\n\n# Find symbol usages\nkit usages \u002Fpath\u002Fto\u002Frepo \"MyClass\"\n\n# Export data for external tools\nkit export \u002Fpath\u002Fto\u002Frepo symbols symbols.json\n```\n\n**PR Reviews:**\n```bash\n# Initialize configuration\nkit review --init-config\n\n# Review GitHub PRs\nkit review --dry-run https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\nkit review https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n\n# Review local git diffs (no PR required!)\nkit review main..feature  # Compare branches\nkit review HEAD~3..HEAD   # Review last 3 commits\nkit review --staged       # Review staged changes\n```\n\n**PR Summaries:**\n```bash\n# Generate PR summaries for quick triage\nkit summarize https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\nkit summarize --update-pr-body https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n```\n\n**Commit Messages:**\n```bash\n# Generate intelligent commit messages from staged changes\ngit add .  # Stage your changes first\nkit commit  # Analyze and commit with AI-generated message\n```\n\n**Package Search** (requires Chroma API key):\n```bash\nkit package-search-grep numpy \"def.*fft\" --max-results 10  # Plain grep-style output\nkit package-search-grep numpy \"def.*fft\" --json           # Structured JSON output\nkit package-search-hybrid django \"authentication middleware\"\nkit package-search-read requests \"requests\u002Fmodels.py\"\n```\n\nSee the [CLI Documentation](https:\u002F\u002Fkit.cased.com\u002Fintroduction\u002Fcli) for comprehensive usage examples.\n\n## Key Toolkit Capabilities\n\n`kit` helps your apps and agents understand and interact with codebases, with components to build your own AI-powered developer tools.\n\n*   **Explore Code Structure:**\n    *   High-level view with `repo.get_file_tree()` to list all files and directories. You can also pass a subdirectory for a more limited scan.\n    *   Dive down with `repo.extract_symbols()` to identify functions, classes, and other code constructs, either across the entire repository or within a single file.\n    *   Use `repo.extract_symbols_incremental()` to get fast, cache-aware symbol extraction—best when dealing with small changes to repositories.\n\n*   **Pinpoint Information:**\n    *   Run fast regular expression searches across your codebase using `repo.search_text()` (automatically uses [ripgrep](https:\u002F\u002Fgithub.com\u002FBurntSushi\u002Fripgrep) when available for 10x speedup).\n    *   Track specific symbols (like a function or class) with `repo.find_symbol_usages()`.\n    *   Find code by structure with AST-based pattern matching (async functions, try blocks, class inheritance, etc.).\n\n*   **Prepare Code for LLMs & Analysis:**\n    *   Break down large files into manageable pieces for LLM context windows using `repo.chunk_file_by_lines()` or `repo.chunk_file_by_symbols()`.\n    *   Get the full definition of a function or class off a line number within it using `repo.extract_context_around_line()`.\n\n*   **Generate Code Summaries:**\n    *   Use LLMs to create natural language summaries for files, functions, or classes using the `Summarizer` (e.g., `summarizer.summarize_file()`, `summarizer.summarize_function()`).\n    *   Build a searchable index of these AI-generated docstrings with `DocstringIndexer` and query it with `SummarySearcher` for intelligent code discovery.\n\n*   **Analyze Code Dependencies:**\n    *   Map import relationships between modules using `repo.get_dependency_analyzer()` to understand your codebase structure.\n    *   Generate dependency reports and LLM-friendly context with `analyzer.generate_dependency_report()` and `analyzer.generate_llm_context()`.\n\n*   **Search Package Source Code (via Chroma):**\n    *   Search through popular package source code using `ChromaPackageSearch` for regex patterns and semantic queries.\n    *   Access source code from packages like numpy, django, fastapi, pandas, and more.\n    *   Integrated into kit-dev MCP for seamless package exploration in AI assistants.\n\n*   **Repository Versioning & Historical Analysis:**\n    *   Analyze repositories at specific commits, tags, or branches using the `ref` parameter.\n    *   Compare code evolution over time, work with diffs, ensure reproducible analysis results\n    *   Access git metadata including current SHA, branch, and remote URL with `repo.current_sha`, `repo.current_branch`, etc.\n\n*   **Multi-Repository Analysis:**\n    *   Analyze multiple repositories together with `MultiRepo` for microservices, monorepos, or team projects.\n    *   Unified search, symbol lookup, and dependency auditing across all repos.\n    *   CLI support: `kit multi search`, `kit multi deps`, `kit multi summary`.\n\n## MCP Server (kit-dev MCP)\n\n`kit` includes an enhanced MCP (Model Context Protocol), **kit-dev**, designed especially for individual local dev work. It includes kit's production-grade code intelligence and context building, and adds in multi-source documentation research and package searching.\n\n**Environment Variables:** `OPENAI_API_KEY`, `OPENAI_BASE_URL` (for proxies\u002Fcustom endpoints), `ANTHROPIC_API_KEY`\n\n**[→ Full kit-dev MCP Documentation](https:\u002F\u002Fkit-mcp.cased.com)**\n\n## kit-powered Features & Utilities\n\nAs both demonstrations of this library, and as standalone products,\n`kit` ships with MIT-licensed, CLI-based pull request review and summarization features.\n\n### PR Reviews\n\nThe pull request reviewer ranks with the better closed-source paid options, but at \na fraction of the cost with cloud models. At Cased we use `kit` extensively\nwith models like Sonnet 4 and gpt4.1, paying just for the price of tokens.\n\n```bash\nkit review --init-config\nkit review https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n```\n\n**[→ Complete PR Reviewer Documentation](src\u002Fkit\u002Fpr_review\u002FREADME.md)**\n\n### PR Summaries\n\nFor quick PR triage and understanding, `kit` includes a fast, cost-effective PR summarization feature.\nPerfect for teams that need to quickly understand what PRs do before deciding on detailed review.\n\n```bash\nkit summarize https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\nkit summarize --update-pr-body https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n```\n\n**Key Features:**\n- **5-10x cheaper** than full reviews (~$0.005-0.02 vs $0.01-0.05+)\n- **Fast triage**: Quick overview of changes, impact, and key modifications\n\n### Commit Messages\n\nGenerate intelligent commit messages from staged changes using the same repository intelligence:\n\n```bash\ngit add .       # Stage your changes\nkit commit      # Analyze and commit with AI-generated message\n```\n\n## Documentation\n\n**[Full Documentation](https:\u002F\u002Fkit.cased.com)** - Detailed usage, advanced features, and practical examples.\nFull REST documentation is also available.\n\n**[kit-dev MCP Documentation](https:\u002F\u002Fkit-mcp.cased.com)** - Complete guide for the enhanced MCP server\n\n**[Changelog](https:\u002F\u002Fkit.cased.com\u002Fchangelog)** - Track all changes and improvements across kit releases\n\n## License\n\nMIT License\n\n## Contributing\n\n- **Local Development**: Check out our [Running Tests](https:\u002F\u002Fkit.cased.com\u002Fdevelopment\u002Frunning-tests) guide to get started with local development.\n- **Project Direction**: See our [Roadmap](https:\u002F\u002Fkit.cased.com\u002Fdevelopment\u002Froadmap) for future plans and focus areas.\n\nTo contribute, fork the repository, make your changes, and submit a pull request.\n","# kit 🛠️ 代码智能工具包\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcased_kit_readme_6529433e2d89.png\" width=\"360\">\n\n`kit` 是一个生产就绪的工具包，用于代码库映射、符号提取、代码搜索，以及构建由大语言模型驱动的开发者工具、代理和工作流。\n\n使用 `kit` 可以构建诸如代码审查工具、代码生成器，甚至 IDE 等工具，并为其注入恰当的代码上下文。你可以直接从 Python 中使用 `kit`，也可以通过 MCP + 函数调用、REST 或 CLI 来操作。\n\n请查阅 **[完整文档](https:\u002F\u002Fkit.cased.com)**，了解详细的使用方法、高级功能及实用示例。同时，也别忘了查看 `kit` 的 **[本地开发 MCP 服务器文档](https:\u002F\u002Fkit-mcp.cased.com)**。\n\n\n## 快速安装\n\n### 从 PyPI 安装\n\n```bash\nuv pip install cased-kit\n\n# 若需启用机器学习功能以进行高级分析和向量搜索\nuv pip install 'cased-kit[all]'\n```\n\n### 使用 uv 全局安装（最便于 CLI 使用）\n\n若希望全局使用 `kit` CLI 而不影响系统 Python 环境，可使用 `uv tool install` 命令。这将为 `kit` 创建一个隔离环境，同时使 CLI 在任何位置均可调用：\n\n```bash\n# 全局安装基础版 kit CLI\nuv tool install cased-kit\n\n# 安装完整版（包括 MCP 服务器及所有功能）\nuv tool install cased-kit[all]\n```\n\n安装完成后，`kit` 和 `kit-dev-mcp` 命令将在全局可用。如需管理你的 uv 工具安装：\n\n```bash\n# 列出已安装的工具\nuv tool list\n\n# 如有需要，卸载\nuv tool uninstall cased-kit\n```\n\n### Claude Code 插件\n\n你可以在 [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) 中直接使用 `kit`，只需安装官方插件即可：\n\n```bash\n\u002Fplugin marketplace add cased\u002Fclaude-code-plugins\n\u002Fplugin install kit-cli\n```\n\n该插件会赋予 Claude 对 `kit` 代码库分析工具的自主访问权限。当你提出类似以下问题时，Claude 将自动调用 `kit`：\n- “这个代码库中的认证机制是如何工作的？”\n- “查找 UserModel 类的所有使用点”\n- “该项目有哪些依赖项？”\n- “展示 src 目录的文件结构”\n\n更多详情请参阅 **[Claude Code 集成指南](https:\u002F\u002Fkit.cased.com\u002Fintroduction\u002Fclaude-code)**。\n\n## 工具包使用\n\n### 基础 Python API\n\n```python\nfrom kit import Repository\n\n# 加载本地代码库\nrepo = Repository(\"\u002Fpath\u002Fto\u002Fyour\u002Flocal\u002Fcodebase\")\n\n# 加载远程公开 GitHub 仓库\nrepo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\")\n\n# 加载私有 GitHub 仓库（若设置了 KIT_GITHUB_TOKEN，则会自动使用）\nrepo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Fprivate-repo\")\n\n# 或者显式指定\nrepo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Fprivate-repo\", github_token=\"ghp_...\")\n\n# 指定特定的提交、标签或分支\n# repo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\", ref=\"v1.2.3\")\n\n# 处理多代码库（微服务、单体仓库、团队项目）\nfrom kit import MultiRepo\nrepos = MultiRepo([\"~\u002Fcode\u002Ffrontend\", \"~\u002Fcode\u002Fbackend\", \"~\u002Fcode\u002Fshared\"])\nrepos.search(\"handleAuth\")  # 在所有代码库中搜索\n```\n\n```python\n# 探索代码库\nprint(repo.get_file_tree())\n# 输出：[{\"path\": \"src\u002Fmain.py\", \"is_dir\": False, ...}, ...]\n\nprint(repo.extract_symbols('src\u002Fmain.py'))\n# 输出：[{\"name\": \"main\", \"type\": \"function\", \"file\": \"src\u002Fmain.py\", ...}, ...]\n\n# 访问 Git 元数据\nprint(f\"当前 SHA：{repo.current_sha}\")\nprint(f\"分支：{repo.current_branch}\")\n\n# 读取单个文件\nmain_py = repo.get_file_content(\"src\u002Fmain.py\")\n\n# 一次性读取多个文件\ncontents = repo.get_file_content([\n    \"src\u002Fmain.py\",\n    \"src\u002Futils\u002Fhelper.py\",\n    \"tests\u002Ftest_main.py\",\n])\nprint(contents[\"src\u002Futils\u002Fhelper.py\"])\n```\n\n### 命令行界面\n\n`kit` 提供了功能全面的命令行工具，用于代码库分析和代码探索。\n\n**代码库分析：**\n```bash\n# 获取代码库文件结构\nkit file-tree \u002Fpath\u002Fto\u002Frepo\n\n# 提取符号（函数、类等）\nkit symbols \u002Fpath\u002Fto\u002Frepo --format table\n\n# 搜索代码模式\nkit search \u002Fpath\u002Fto\u002Frepo \"def main\" --pattern \"*.py\"\n\n# 查找符号的使用位置\nkit usages \u002Fpath\u002Fto\u002Frepo \"MyClass\"\n\n# 导出数据供外部工具使用\nkit export \u002Fpath\u002Fto\u002Frepo symbols symbols.json\n```\n\n**PR 审查：**\n```bash\n# 初始化配置\nkit review --init-config\n\n# 审查 GitHub PR\nkit review --dry-run https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\nkit review https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n\n# 审查本地 Git 差异（无需 PR！）\nkit review main..feature  # 比较两个分支\nkit review HEAD~3..HEAD   # 审查最近的 3 次提交\nkit review --staged       # 审查暂存区的更改\n```\n\n**PR 摘要：**\n```bash\n# 生成 PR 摘要以便快速分类\nkit summarize https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\nkit summarize --update-pr-body https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n```\n\n**提交信息：**\n```bash\n# 根据暂存区的更改生成智能提交信息\ngit add .  # 先暂存更改\nkit commit  # 分析并提交，附带 AI 生成的提交信息\n```\n\n**包搜索**（需提供 Chroma API 密钥）：\n```bash\nkit package-search-grep numpy \"def.*fft\" --max-results 10  # 传统 grep 样式的输出\nkit package-search-grep numpy \"def.*fft\" --json           # 结构化 JSON 输出\nkit package-search-hybrid django \"authentication middleware\"\nkit package-search-read requests \"requests\u002Fmodels.py\"\n```\n\n更多详细用法，请参阅 **[CLI 文档](https:\u002F\u002Fkit.cased.com\u002Fintroduction\u002Fcli)**。\n\n## 工具包核心功能\n\n`kit` 帮助您的应用和智能体理解和交互代码库，提供构建自定义 AI 驱动开发工具的组件。\n\n*   **探索代码结构：**\n    *   使用 `repo.get_file_tree()` 获取高层次视图，列出所有文件和目录。您还可以指定子目录以进行更有限的扫描。\n    *   通过 `repo.extract_symbols()` 深入挖掘函数、类和其他代码结构，可针对整个仓库或单个文件执行。\n    *   使用 `repo.extract_symbols_incremental()` 进行快速且具备缓存感知的符号提取——尤其适用于处理代码库的小规模变更。\n\n*   **精准定位信息：**\n    *   使用 `repo.search_text()` 在整个代码库中执行快速正则表达式搜索（在可用时自动调用 [ripgrep](https:\u002F\u002Fgithub.com\u002FBurntSushi\u002Fripgrep) 以实现 10 倍加速）。\n    *   通过 `repo.find_symbol_usages()` 跟踪特定符号（如函数或类）的使用情况。\n    *   利用基于 AST 的模式匹配按代码结构查找内容（例如异步函数、try 块、类继承等）。\n\n*   **为 LLM 和分析准备代码：**\n    *   使用 `repo.chunk_file_by_lines()` 或 `repo.chunk_file_by_symbols()` 将大文件拆分为适合 LLM 上下文窗口的片段。\n    *   根据文件中的某一行号获取函数或类的完整定义，使用 `repo.extract_context_around_line()`。\n\n*   **生成代码摘要：**\n    *   利用 LLM 为文件、函数或类创建自然语言摘要，使用 `Summarizer`（例如 `summarizer.summarize_file()`、`summarizer.summarize_function()`）。\n    *   使用 `DocstringIndexer` 构建这些 AI 生成文档字符串的可搜索索引，并通过 `SummarySearcher` 查询以实现智能化代码发现。\n\n*   **分析代码依赖关系：**\n    *   使用 `repo.get_dependency_analyzer()` 绘制模块之间的导入关系图，帮助理解代码库结构。\n    *   通过 `analyzer.generate_dependency_report()` 和 `analyzer.generate_llm_context()` 生成依赖报告及适合 LLM 的上下文信息。\n\n*   **搜索软件包源码（通过 Chroma）：**\n    *   使用 `ChromaPackageSearch` 按正则模式和语义查询搜索热门软件包的源码。\n    *   可访问 numpy、django、fastapi、pandas 等软件包的源代码。\n    *   集成到 kit-dev MCP 中，便于在 AI 助手内无缝探索软件包。\n\n*   **仓库版本控制与历史分析：**\n    *   使用 `ref` 参数在特定提交、标签或分支上分析仓库。\n    *   对比代码随时间的变化，处理差异，确保分析结果的可重复性。\n    *   通过 `repo.current_sha`、`repo.current_branch` 等方法访问 Git 元数据，包括当前 SHA、分支和远程 URL。\n\n*   **多仓库分析：**\n    *   使用 `MultiRepo` 同时分析多个仓库，适用于微服务、单体仓库或团队项目。\n    *   实现跨所有仓库的统一搜索、符号查找和依赖审计。\n    *   提供 CLI 支持：`kit multi search`、`kit multi deps`、`kit multi summary`。\n\n## MCP 服务器（kit-dev MCP）\n\n`kit` 包含一个增强版的 MCP（模型上下文协议），即 `kit-dev`，专为个人本地开发工作设计。它不仅包含 `kit` 的生产级代码智能和上下文构建能力，还增加了多源文档检索和软件包搜索功能。\n\n**环境变量：** `OPENAI_API_KEY`、`OPENAI_BASE_URL`（用于代理或自定义端点）、`ANTHROPIC_API_KEY`\n\n**[→ 完整 kit-dev MCP 文档](https:\u002F\u002Fkit-mcp.cased.com)**\n\n## kit 驱动的功能与实用工具\n\n作为该库的示例展示，同时也是独立产品，`kit` 自带 MIT 许可的基于 CLI 的拉取请求评审和摘要生成功能。\n\n### PR 评审\n\n该拉取请求评审工具的表现可媲美一些优秀的闭源付费方案，但成本仅为后者的一小部分，且仅需支付云端模型的 token 费用。在 Cased，我们广泛使用 `kit` 结合 Sonnet 4 和 gpt4.1 等模型，只需支付 token 费用即可。\n\n```bash\nkit review --init-config\nkit review https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n```\n\n**[→ 完整 PR 评审文档](src\u002Fkit\u002Fpr_review\u002FREADME.md)**\n\n### PR 摘要\n\n为了快速对拉取请求进行分类和理解，`kit` 提供了一项快速且经济高效的 PR 摘要生成功能。非常适合团队在决定是否进行详细评审之前，快速了解 PR 的内容。\n\n```bash\nkit summarize https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\nkit summarize --update-pr-body https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n```\n\n**主要特点：**\n- 成本仅为完整评审的 5–10 分之一（约 $0.005–0.02，而完整评审约为 $0.01–0.05+）。\n- 快速分类：快速概览更改内容、影响及关键修改。\n\n### 提交信息\n\n利用相同的仓库智能，从暂存的更改中生成智能提交信息：\n\n```bash\ngit add .       # 暂存更改\nkit commit      # 分析并提交，附带 AI 生成的提交信息\n```\n\n## 文档\n\n**[完整文档](https:\u002F\u002Fkit.cased.com)** - 详细用法、高级功能和实用示例。同时提供完整的 REST 文档。\n\n**[kit-dev MCP 文档](https:\u002F\u002Fkit-mcp.cased.com)** - 增强版 MCP 服务器的完整指南。\n\n**[变更日志](https:\u002F\u002Fkit.cased.com\u002Fchangelog)** - 跟踪 `kit` 各版本的所有变更和改进。\n\n## 许可证\n\nMIT 许可证\n\n## 贡献\n\n- **本地开发：** 请参阅我们的 [运行测试](https:\u002F\u002Fkit.cased.com\u002Fdevelopment\u002Frunning-tests) 指南，开始本地开发。\n- **项目方向：** 请查看我们的 [路线图](https:\u002F\u002Fkit.cased.com\u002Fdevelopment\u002Froadmap) 以了解未来的计划和重点方向。\n\n如需贡献，请 fork 本仓库，做出更改后提交拉取请求。","# Kit 代码智能工具包快速上手指南\n\n`kit` 是一个生产级的代码库映射、符号提取和代码搜索工具包，专为构建基于大语言模型（LLM）的开发者工具、Agent 和工作流设计。它可以帮助您轻松构建代码审查器、代码生成器甚至增强型 IDE。\n\n## 环境准备\n\n*   **操作系统**：支持 Linux、macOS 和 Windows。\n*   **Python 版本**：建议 Python 3.9 及以上版本。\n*   **前置依赖**：\n    *   推荐使用 [`uv`](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) 进行包管理和工具安装（速度极快且隔离性好）。\n    *   若需使用 Git 相关功能（如 PR 审查、差异分析），请确保系统已安装 `git`。\n    *   （可选）若需高级分析和向量搜索功能，安装时需包含额外依赖。\n*   **网络提示**：由于 `kit` 托管于 GitHub 和 PyPI，国内用户若遇到下载缓慢问题，可配置国内镜像源（如清华源或阿里源）加速 `uv pip` 安装过程。\n\n## 安装步骤\n\n### 方式一：使用 uv 全局安装（推荐，最适合 CLI 使用）\n\n此方式将 `kit` 安装在独立的隔离环境中，并全局可用，不会污染系统 Python。\n\n```bash\n# 安装基础版 CLI\nuv tool install cased-kit\n\n# 安装完整版（包含 MCP 服务器、机器学习特性及向量搜索支持）\nuv tool install 'cased-kit[all]'\n```\n\n安装完成后，`kit` 和 `kit-dev-mcp` 命令即可在终端任意位置使用。\n\n### 方式二：通过 PyPI 安装到当前项目\n\n如果您希望在特定的 Python 虚拟环境中使用 `kit` 的 Python API：\n\n```bash\n# 使用 uv 安装基础版\nuv pip install cased-kit\n\n# 使用 uv 安装完整版（含高级分析功能）\nuv pip install 'cased-kit[all]'\n\n# 若使用 pip 且需国内加速，可指定镜像源：\n# pip install cased-kit -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n### 方式三：集成到 Claude Code\n\n若您是 [Claude Code](https:\u002F\u002Fclaude.ai\u002Fcode) 用户，可通过插件直接调用：\n\n```bash\n\u002Fplugin marketplace add cased\u002Fclaude-code-plugins\n\u002Fplugin install kit-cli\n```\n\n## 基本使用\n\n### 1. Python API 快速开始\n\n最基础的用法是加载一个代码库并探索其结构或提取符号。\n\n```python\nfrom kit import Repository\n\n# 加载本地代码库\nrepo = Repository(\"\u002Fpath\u002Fto\u002Fyour\u002Flocal\u002Fcodebase\")\n\n# 或者加载远程公共 GitHub 仓库\n# repo = Repository(\"https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\")\n\n# 获取文件树结构\nfile_tree = repo.get_file_tree()\nprint(file_tree)\n\n# 提取特定文件中的符号（函数、类等）\nsymbols = repo.extract_symbols('src\u002Fmain.py')\nprint(symbols)\n\n# 读取文件内容\ncontent = repo.get_file_content(\"src\u002Fmain.py\")\nprint(content)\n\n# 跨多个仓库搜索（适用于微服务或单体仓库）\nfrom kit import MultiRepo\nrepos = MultiRepo([\"~\u002Fcode\u002Ffrontend\", \"~\u002Fcode\u002Fbackend\"])\nresults = repos.search(\"handleAuth\")  # 在所有仓库中搜索 \"handleAuth\"\nprint(results)\n```\n\n### 2. 命令行界面 (CLI) 核心功能\n\n安装后，您可以直接在终端使用强大的 `kit` 命令。\n\n**查看代码结构与符号：**\n```bash\n# 获取仓库文件树\nkit file-tree \u002Fpath\u002Fto\u002Frepo\n\n# 以表格形式提取所有符号（函数、类等）\nkit symbols \u002Fpath\u002Fto\u002Frepo --format table\n\n# 搜索代码模式（底层自动调用 ripgrep 加速）\nkit search \u002Fpath\u002Fto\u002Frepo \"def main\" --pattern \"*.py\"\n```\n\n**智能代码审查与总结：**\n```bash\n# 初始化配置文件\nkit review --init-config\n\n# 审查 GitHub Pull Request\nkit review https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n\n# 审查本地 Git 分支差异（无需创建 PR）\nkit review main..feature\n\n# 生成 PR 摘要用于快速分类\nkit summarize https:\u002F\u002Fgithub.com\u002Fowner\u002Frepo\u002Fpull\u002F123\n```\n\n**辅助开发工作流：**\n```bash\n# 基于暂存区变更生成智能 Commit 消息\ngit add .\nkit commit\n```\n\n### 3. 进阶：多仓库与上下文构建\n\n`kit` 的核心优势在于为 LLM 提供精准的代码上下文。您可以利用它将大文件切片，或构建依赖关系图：\n\n```python\n# 将大文件按行切片，适配 LLM 上下文窗口\nchunks = repo.chunk_file_by_lines(\"src\u002Flarge_module.py\", max_lines=50)\n\n# 获取某行代码周围的完整上下文（包含类定义等）\ncontext = repo.extract_context_around_line(\"src\u002Fmain.py\", line_number=42)\n\n# 分析模块间的依赖关系\nanalyzer = repo.get_dependency_analyzer()\nreport = analyzer.generate_dependency_report()\n```\n\n更多高级功能（如 MCP 服务器配置、自定义 Agent 构建）请参阅 [官方文档](https:\u002F\u002Fkit.cased.com)。","某后端团队在接手一个包含多个微服务的遗留项目时，急需理清复杂的认证逻辑并修复一个隐蔽的权限漏洞。\n\n### 没有 kit 时\n- 开发人员不得不手动遍历数十个代码文件，依靠肉眼在庞大的文件树中查找 `AuthService` 相关的定义与调用，耗时且极易遗漏。\n- 面对跨仓库的微服务架构，无法一次性搜索所有服务中的符号使用情况，导致难以确认某个公共函数是否被意外修改或废弃。\n- 在向 AI 助手提问“认证流程如何实现”时，由于缺乏精准的代码上下文映射，AI 只能给出泛泛而谈的通用模板，无法结合项目实际逻辑。\n- 提取类和方法符号需要编写繁琐的正则脚本或依赖重型 IDE 索引，且在 CI\u002FCD 流水线中难以自动化集成。\n\n### 使用 kit 后\n- 通过 `kit symbols` 和 `kit usages` 命令，瞬间提取出全量代码库中的认证相关符号及其所有引用位置，精准定位到漏洞源头。\n- 利用 `MultiRepo` 功能同时加载前端、后端及共享库，一键跨仓库搜索 `handleAuth` 实现，彻底消除盲区。\n- 结合 Claude Code 插件，kit 自动为 AI 提供精确的代码库映射和上下文，使 AI 能直接回答“本项目中 JWT 令牌的具体刷新机制”，并给出基于真实代码的修复建议。\n- 通过简单的 Python API 或 CLI 即可将代码结构分析嵌入自动化工作流，无需配置复杂环境即可生成高质量的代码审查报告。\n\nkit 将原本需要数小时的人工代码考古工作压缩至分钟级，让开发者能基于完整的上下文智能地构建工具、代理和工作流。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcased_kit_6529433e.png","cased","Cased","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fcased_58b81b55.png","ai-powered infrastructure",null,"team@cased.com","casedinc","https:\u002F\u002Fcased.com","https:\u002F\u002Fgithub.com\u002Fcased",[83,87,91,95,99,103,107,110,114,117],{"name":84,"color":85,"percentage":86},"Python","#3572A5",86.8,{"name":88,"color":89,"percentage":90},"TypeScript","#3178c6",10.4,{"name":92,"color":93,"percentage":94},"HCL","#844FBA",1.2,{"name":96,"color":97,"percentage":98},"Tree-sitter Query","#8ea64c",0.7,{"name":100,"color":101,"percentage":102},"Shell","#89e051",0.6,{"name":104,"color":105,"percentage":106},"JavaScript","#f1e05a",0.1,{"name":108,"color":109,"percentage":106},"CSS","#663399",{"name":111,"color":112,"percentage":113},"C#","#178600",0,{"name":115,"color":116,"percentage":113},"Go","#00ADD8",{"name":118,"color":119,"percentage":113},"Rust","#dea584",1285,77,"2026-04-17T00:22:16","MIT","Linux, macOS, Windows","未说明",{"notes":127,"python":128,"dependencies":129},"该工具主要通过 Python、CLI、MCP 服务器或 REST API 使用。推荐使用 'uv' 工具进行全局安装以隔离环境。部分高级功能（如包搜索）需要 Chroma API Key；访问私有 GitHub 仓库需要设置 GITHUB_TOKEN；使用 LLM 相关功能（如总结、代码审查）需配置 OPENAI_API_KEY 或 ANTHROPIC_API_KEY。","未说明 (需支持 uv 工具及 PyPI 安装)",[130,131],"ripgrep (可选，用于加速搜索)","chroma (可选，用于包搜索功能)",[36,14,13,27],"2026-03-27T02:49:30.150509","2026-04-20T20:25:50.814593",[136,141,146,151,156,161],{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},45659,"构建向量索引时遇到 ChromaDB 批次大小超出限制的错误（Batch size exceeded）怎么办？","该问题是由于代码块数量超过 ChromaDB 内部最大批次限制导致的。维护者已在主分支（main）中修复了此问题，通过在 `ChromaDBBackend.add` 或 `VectorSearcher.build_index` 中实现分批处理逻辑来解决。请升级到最新版本（关注后续发布的版本，如 v3.3.0 之后的更新），或者直接从源码安装最新的主分支代码即可解决。","https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fissues\u002F139",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},45660,"如何在企业内网或使用代理服务器时配置 Kit MCP 的 OpenAI base_url？","Kit 现已支持配置 OpenAI 的 `base_url` 参数，以便通过内部代理访问 OpenAI 模型。请确保将 Kit 升级到最新版本（至少 v3.3.0），该版本显著减少了上下文数据膨胀并暴露了相关配置选项。升级后，您可以在配置中指定自定义的 `base_url` 指向您的内部代理地址。","https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fissues\u002F175",{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},45661,"在处理 .tsx 或 .py 文件时提示 'tags.scm not found' 或 'No query or parser available' 错误如何解决？","这是一个已知问题，通常发生在将 kit 作为依赖项安装在其他项目中时。该问题已在 v0.2.1 及更高版本中彻底修复。如果您仍在使用旧版本（如 v0.2.0），请务必升级到最新版本。如果使用的是 uv 安装，请运行更新命令确保获取到包含修复补丁的版本。","https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fissues\u002F13",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},45662,"运行 `kit --help` 时发现命令行选项与 README 文档描述不一致（缺少 file-tree 等命令）是什么原因？","这通常是因为安装的 kit 版本过旧。Kit 自 v1.0 起仅支持 Python 3.10+，如果您使用的是 Python 3.9 或更低版本，pip\u002Fuv 可能会解析并安装一个不兼容的旧版本。请检查您的 Python 版本（需 3.10+），并运行 `kit --version` 确认当前版本。卸载旧版本后，在正确的 Python 环境下重新安装即可看到完整的命令列表。","https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fissues\u002F162",{"id":157,"question_zh":158,"answer_zh":159,"source_url":160},45663,"使用 uv 安装 cased-kit 时失败，提示 'Metadata field Name not found' 或 'No solution found' 怎么办？","如果排除网络问题，这通常是由于 uv 的缓存损坏或版本兼容性引起的。首先尝试清除 uv 缓存或升级 uv 到最新版本。如果问题依旧，请检查是否处于公司防火墙或特殊网络环境下，这可能导致元数据拉取失败。确保您的操作系统和 Python 环境符合官方要求（Python 3.10+）。","https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fissues\u002F161",{"id":162,"question_zh":163,"answer_zh":164,"source_url":165},45664,"如何为 Kit 贡献新语言（如 C#、Kotlin、C++）的 Tree-sitter 查询支持？","Kit 欢迎社区贡献新语言的支持。您可以先在本地分支上实现该语言的 Tree-sitter SCM 查询文件（如 tags.scm），测试通过后，参考 GitHub 的标准流程创建 Pull Request (PR)。维护者会审核并合并代码。具体的 PR 创建指南可参考 GitHub 官方文档：https:\u002F\u002Fdocs.github.com\u002Fen\u002Fpull-requests\u002Fcollaborating-with-pull-requests\u002Fproposing-changes-to-your-work-with-pull-requests\u002Fcreating-a-pull-request","https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fissues\u002F165",[167,172,177,182,187,192,197,202,207,212,217,222,227,232,237,242,247,252,257,262],{"id":168,"version":169,"summary_zh":170,"released_at":171},360554,"v3.5.1","## 变更内容\n* 由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F183 中修复 Dependabot 安全告警\n* 由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F184 中移除过时的 poetry.lock 文件\n* 由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F185 中修复剩余的 npm Dependabot 告警\n* 文档：修正 kit-dev-mcp 工具列表，使其与实现一致，由 @possibilities 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F186 中完成\n* 修复：get_symbol_code 现在返回完整的源代码，而不仅仅是名称，由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F188 中完成\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv3.5.0...v3.5.1","2026-01-18T22:00:44",{"id":173,"version":174,"summary_zh":175,"released_at":176},360555,"v3.5.0","## 变更内容\n* 性能优化：@tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F179 中通过算法改进优化了热点路径\n* 性能优化：第二层级优化——向量重置和文件缓存，由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F180 中实现\n* 性能优化：第三层级优化——差异缓存和并行索引，由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F181 中实现\n* 功能新增：为 MCP 服务器添加大型代码库支持，由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F182 中完成\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv3.4.0...v3.5.0","2026-01-07T20:33:33",{"id":178,"version":179,"summary_zh":180,"released_at":181},360556,"v3.4.0","## 变更内容\n* 重构：整合 LLM 客户端，并由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F178 中提取 BaseReviewer\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv3.3.0...v3.4.0","2026-01-07T05:47:38",{"id":183,"version":184,"summary_zh":185,"released_at":186},360557,"v3.3.0","## 变更内容\n* 由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F177 中将 MCP 工具的输出上下文膨胀减少约 85%\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv3.2.3...v3.3.0","2026-01-05T21:50:57",{"id":188,"version":189,"summary_zh":190,"released_at":191},360558,"v3.2.3","## 变更内容\n* 由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F174 中修复了 Gemini 的代理式审核路由至 OpenAI API 的问题\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv3.2.2...v3.2.3","2026-01-05T21:11:25",{"id":193,"version":194,"summary_zh":195,"released_at":196},360559,"v3.2.1","## 变更内容\n* @jesus-mgtc 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F166 中新增了 C# 支持\n* @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F172 中修复了代理评审器中 OpenAI GPT-5 的 `max_completion_tokens` 参数\n\n## 新贡献者\n* @jesus-mgtc 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F166 中完成了首次贡献\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv3.2.0...v3.2.1","2026-01-02T01:54:31",{"id":198,"version":199,"summary_zh":200,"released_at":201},360560,"v3.2.0","## 变更内容\n* 由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F167 中添加了 Claude Code 插件文档\n* 由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F169 中修复了 JavaScript\u002FTypeScript 符号提取中的箭头函数检测问题\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv3.1.0...v3.2.0","2025-12-27T00:13:57",{"id":203,"version":204,"summary_zh":205,"released_at":206},360561,"v3.1.0","## 3.1.0 版本更新内容\n\n### 主要特性\n\n#### MultiRepo：多仓库分析 (#164)\n- 新增 `MultiRepo` 类，用于跨多个仓库的统一分析\n- 非常适合微服务、前后端分离以及团队协作项目\n- 统一文本搜索，支持正则表达式，覆盖所有仓库\n- 语义搜索，合并并按相关性排序结果\n- 跨仓库符号提取与查找\n- 跨仓库依赖审计（Python、JS、Rust、Go）\n- 仓库摘要，自动检测语言\n- CLI 支持：`kit multi search`、`kit multi symbols`、`kit multi deps`、`kit multi summary`\n\n#### Rust 依赖分析器 (#163)\n- 完全支持通过 tree-sitter 分析 Rust crate 依赖关系\n- 解析 `Cargo.toml` 文件，获取 crate 元数据和外部依赖\n- 提取 `use`、`mod` 和 `extern crate` 语句\n- 将 `crate::`、`self::`、`super::` 等路径解析为实际模块\n- 将依赖分类为内部依赖、外部依赖或标准库依赖（`std`、`core`、`alloc`、`proc_macro`、`test`）\n- 生成依赖图，并检测循环依赖\n- CLI：`kit dependencies . --language rust`\n\n#### JavaScript\u002FTypeScript 依赖分析器 (#159)\n- 完全支持通过 tree-sitter 分析 JS\u002FTS 代码库\n- 支持 ESM 导入：`import x from 'pkg'`、`import { x } from 'pkg'`\n- 支持 CommonJS：`require('pkg')`\n- 支持动态导入：`import('pkg')`\n- 支持重新导出：`export { x } from 'pkg'`、`export * from 'pkg'`\n- 支持 scoped 包（`@org\u002Fpkg`）\n- 自动检测 Node.js 内置模块（包括 `node:` 协议）\n- 解析目录导入的索引文件\n- CLI：`kit dependencies . --language javascript`\n\n### 错误修复\n- 修复 Go `go.mod` 解析逻辑，跳过指令关键字\n- 修复 `go.mod` retract 指令的解析问题，并新增 MultiRepo 测试用例\n\n### 文档更新\n- 新增 MultiRepo API 参考页面，包含使用场景和示例\n- 更新依赖分析器文档，新增 Rust 和 JavaScript 章节\n- 更新使用指南，添加 MultiRepo 快速入门说明\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv3.0.0...v3.1.0","2025-12-17T11:28:40",{"id":208,"version":209,"summary_zh":210,"released_at":211},360562,"v3.0.0","## 变更内容\n* 添加 Go 依赖分析器，并由 @tnm 在 https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F157 中优化性能\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.2.1...v3.0.0","2025-12-08T03:29:14",{"id":213,"version":214,"summary_zh":215,"released_at":216},360563,"v2.2.1","## Bug 修复\n\n- **GPT-5 模型兼容性** (#154)\n  - 修复了在使用 GPT-5 模型进行 PR 审查时出现的 OpenAI API 400 错误\n  - GPT-5 模型需要使用 `max_completion_tokens` 参数，而非已弃用的 `max_tokens` 参数\n  - 更新了 PR 审查模块中的所有 OpenAI API 调用（包括评审器、摘要生成器、提交生成器、本地评审器和矩阵测试器）\n  - 为 GPT-5 参数处理添加了全面的测试覆盖","2025-12-05T19:38:56",{"id":218,"version":219,"summary_zh":220,"released_at":221},360564,"v2.2.0","## What's New in 2.2.0\n\n### Windows UTF-8 Encoding Fix (#151, #153)\n- Fixed Windows cp950 decoding errors when using repositories with non-ASCII file paths\n- All subprocess calls now explicitly use UTF-8 encoding instead of system default  \n- Resolves issues for users on Traditional Chinese, Japanese, Korean, and other non-ASCII Windows systems\n- Added comprehensive UTF-8 test coverage for Chinese, Japanese, Korean, emoji, and other Unicode characters\n\n### Ripgrep Integration (#150)\n- `CodeSearcher.search_text()` now automatically uses ripgrep when available for 10x faster searches\n- 88% time reduction on typical searches (50-100ms vs 400-500ms)\n- Automatic fallback to Python implementation ensures compatibility\n- Full support for all SearchOptions (case sensitivity, context lines, gitignore)\n\n### Updated Model Support\n- Added Claude Sonnet 4.5 (`claude-sonnet-4-5`) as the new default model\n- Added Claude Haiku 4.5 (`claude-haiku-4-5`) for ultra-fast, economical reviews\n- Added Grok (X.AI) support with latest models\n- Added GPT-5.1, Gemini 3 Pro, and Gemini 2.5 Flash-Lite\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.1.3...v2.2.0","2025-11-24T02:35:19",{"id":223,"version":224,"summary_zh":225,"released_at":226},360565,"v2.1.3","## What's Changed\n* Vector search improvements for batch size by @tnm in https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F143\n* Add tree-sitter Zig language support by @sammyjoyce in https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F145\n\n## New Contributors\n* @sammyjoyce made their first contribution in https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F145\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.1.2...v2.1.3","2025-10-14T01:59:59",{"id":228,"version":229,"summary_zh":230,"released_at":231},360566,"v2.1.2","## What's Changed\n* fix for gemini generation config  by @tnm in https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F141\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.1.1...v2.1.2","2025-09-18T21:00:53",{"id":233,"version":234,"summary_zh":235,"released_at":236},360567,"v2.1.1","**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.1.0...v2.1.1","2025-09-18T20:16:06",{"id":238,"version":239,"summary_zh":240,"released_at":241},360568,"v2.1.0","## What's Changed\n* Introduce chroma package search and more by @tnm in https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F140\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.0.1...v2.1.0","2025-09-18T19:20:32",{"id":243,"version":244,"summary_zh":245,"released_at":246},360569,"v2.0.1","## What's Changed\n* Remove smart_context, reduce tools by @tnm in https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F136\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.0.0...v2.0.1","2025-09-15T23:29:11",{"id":248,"version":249,"summary_zh":250,"released_at":251},360570,"v2.0.0","## What's Changed\n* Fix tree-sitter compat layer by @tnm in https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F135\n* Add new MCP dev implementation by @tnm in https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fpull\u002F131\n\n\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv1.9.2...v2.0.0","2025-09-15T20:00:25",{"id":253,"version":254,"summary_zh":255,"released_at":256},360571,"v2.0.0rc4","**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.0.0rc3...v2.0.0rc4","2025-09-15T06:26:13",{"id":258,"version":259,"summary_zh":260,"released_at":261},360572,"v2.0.0rc3","**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.0.0rc2...v2.0.0rc3","2025-09-15T06:15:50",{"id":263,"version":264,"summary_zh":265,"released_at":266},360573,"v2.0.0rc2","**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fcased\u002Fkit\u002Fcompare\u002Fv2.0.0rc1...v2.0.0rc2","2025-09-15T05:51:20"]