[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-shotgun-sh--shotgun":3,"tool-shotgun-sh--shotgun":64},[4,16,27,35,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":15},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,14],"Agent","插件","ready",{"id":17,"name":18,"github_repo":19,"description_zh":20,"stars":21,"difficulty_score":22,"last_commit_at":23,"category_tags":24,"status":15},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,2,"2026-04-10T01:20:03",[14,13,25,26],"图像","开发框架",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":22,"last_commit_at":33,"category_tags":34,"status":15},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[14,26],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":22,"last_commit_at":41,"category_tags":42,"status":15},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",85267,"2026-04-18T11:00:28",[25,43,44,14,13,45,46,26,47],"数据工具","视频","其他","语言模型","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":22,"last_commit_at":54,"category_tags":55,"status":15},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",75502,"2026-04-18T11:08:56",[13,14],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":15},7525,"codex","openai\u002Fcodex","Codex 是 OpenAI 推出的一款轻量级编程智能体，专为在终端环境中高效运行而设计。它允许开发者直接在命令行界面与 AI 交互，完成代码生成、调试、重构及项目维护等任务，无需频繁切换至浏览器或集成开发环境，从而显著提升了编码流程的连贯性与专注度。\n\n这款工具主要解决了传统 AI 辅助编程中上下文割裂的问题。通过将智能体本地化运行，Codex 能够更紧密地结合当前工作目录的文件结构，提供更具针对性的代码建议，同时支持以自然语言指令驱动复杂的开发操作，让“对话即编码”成为现实。\n\nCodex 非常适合习惯使用命令行的软件工程师、全栈开发者以及技术研究人员。对于追求极致效率、偏好键盘操作胜过图形界面的极客用户而言，它更是理想的结对编程伙伴。\n\n其独特亮点在于灵活的部署方式：既可作为全局命令行工具通过 npm 或 Homebrew 一键安装，也能无缝对接现有的 ChatGPT 订阅计划（如 Plus 或 Pro），直接复用账户权益。此外，它还提供了从纯文本终端到桌面应用的多形态体验，并支持基于 API 密钥的深度定制，充分满足不同场景下的开发需求。",75220,"2026-04-14T14:40:34",[46,13,14],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":80,"owner_location":80,"owner_email":81,"owner_twitter":80,"owner_website":82,"owner_url":83,"languages":84,"stars":101,"forks":102,"last_commit_at":103,"license":104,"difficulty_score":22,"env_os":105,"env_gpu":106,"env_ram":106,"env_deps":107,"category_tags":112,"github_topics":113,"view_count":22,"oss_zip_url":80,"oss_zip_packed_at":80,"status":15,"created_at":121,"updated_at":122,"faqs":123,"releases":154},9087,"shotgun-sh\u002Fshotgun","shotgun","Spec Driven Development 🤠 Write codebase-aware specs for AI coding agents so they don't derail.","Shotgun 是一款专为提升 AI 编程效率而设计的开发工具，致力于解决当前 AI 编码助手（如 Cursor、Claude Code、Codex 等）在处理大型功能开发时容易“跑偏”的痛点。很多时候，AI 虽然擅长完成小任务，但在面对复杂需求时，往往会遗忘上下文、重复构建已有代码或偏离原始需求，导致生成的代码难以维护。\n\nShotgun 通过“规范驱动开发”（Spec-Driven Development）模式改变了这一现状。它能深度读取并理解整个项目代码库，预先规划完整的功能实现路径，随后将大任务拆解为多个阶段清晰、文件级指令明确的拉取请求（PR）。这样一来，开发者不再需要面对单个包含上万行代码、难以审查的巨型 PR，而是获得一系列聚焦且可立即交付的小型 PR，显著提升了代码质量和审查效率。\n\n这款工具非常适合专业软件开发者和工程团队使用，尤其是那些希望将 AI 代理融入现有工作流，却又受限于其上下文管理能力的人群。其独特的技术亮点在于能够生成“感知代码库”的规范文档，确保 AI 在执行每一步时都紧扣项目实际结构，从而避免幻觉和错误重构。无论是个人开发者还是协作团队，Shotgu","Shotgun 是一款专为提升 AI 编程效率而设计的开发工具，致力于解决当前 AI 编码助手（如 Cursor、Claude Code、Codex 等）在处理大型功能开发时容易“跑偏”的痛点。很多时候，AI 虽然擅长完成小任务，但在面对复杂需求时，往往会遗忘上下文、重复构建已有代码或偏离原始需求，导致生成的代码难以维护。\n\nShotgun 通过“规范驱动开发”（Spec-Driven Development）模式改变了这一现状。它能深度读取并理解整个项目代码库，预先规划完整的功能实现路径，随后将大任务拆解为多个阶段清晰、文件级指令明确的拉取请求（PR）。这样一来，开发者不再需要面对单个包含上万行代码、难以审查的巨型 PR，而是获得一系列聚焦且可立即交付的小型 PR，显著提升了代码质量和审查效率。\n\n这款工具非常适合专业软件开发者和工程团队使用，尤其是那些希望将 AI 代理融入现有工作流，却又受限于其上下文管理能力的人群。其独特的技术亮点在于能够生成“感知代码库”的规范文档，确保 AI 在执行每一步时都紧扣项目实际结构，从而避免幻觉和错误重构。无论是个人开发者还是协作团队，Shotgun 都能帮助你们更稳健地利用 AI 能力，让大型功能落地变得更加可控和高效。","\u003Cdiv align=\"center\">\n\u003Cimg width=\"400\" height=\"150\" alt=\"Shotgun logo transparent background\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_fa5e55dc3307.png\" \u002F>  \n\n### Spec-Driven Development\n\n\n**Write codebase-aware specs for AI coding agents (Codex, Cursor, Claude Code) so they don't derail.**\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.11+-blue?style=flat&logo=python&logoColor=white\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.producthunt.com\u002Fproducts\u002Fshotgun-cli\u002Flaunches\u002Fshotgun-cli\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FProduct%20Hunt-%237%20Product%20of%20the%20Day-FF6154?style=flat&logo=producthunt&logoColor=white\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun?tab=contributing-ov-file\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-brightgreen?style=flat\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun?tab=MIT-1-ov-file\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue?style=flat\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002F5RmY6J2N7s\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdiscord-150+%20online-5865F2?style=flat&logo=discord&logoColor=white\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n[![Website](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-shotgun.sh-5865F2?style=social&logo=safari&logoColor=5865F2)](https:\u002F\u002Fshotgun.sh)      [![Follow @ShotgunCLI](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFollow%20@ShotgunCLI-1DA1F2?style=social&logo=x&logoColor=000000)](https:\u002F\u002Fx.com\u002FShotgunCLI)    [![YouTube](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-@shotgunCLI-FF0000?style=social&logo=youtube&logoColor=red)](https:\u002F\u002Fwww.youtube.com\u002F@shotgunCLI)\n\nLLM Proxy Status: [![Better Stack Badge](https:\u002F\u002Fuptime.betterstack.com\u002Fstatus-badges\u002Fv2\u002Fmonitor\u002F272wo.svg)](https:\u002F\u002Fstatus.shotgun.sh\u002F) API Status: [![Better Stack Badge](https:\u002F\u002Fuptime.betterstack.com\u002Fstatus-badges\u002Fv2\u002Fmonitor\u002F272wq.svg)](https:\u002F\u002Fstatus.shotgun.sh\u002F)\n\n\u003C\u002Fdiv>\n\n---\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd>\n\n**AI agents are great at small tasks but derail on big features.** They forget context, rebuild things that already exist, and go off-spec halfway through.\n\n**Shotgun fixes this.** It reads your entire codebase, plans the full feature upfront, then splits it into staged PRs—each with file-by-file instructions your AI agent can actually follow.\n\nInstead of one 10k-line monster PR nobody will review, you get 5 focused PRs that ship.\n\nWorks great with Cursor, Claude Code, Antigravity, or Codex. BYOK or use Shotgun credits ($10 = $10 in usage).\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n# 📦 Installation\n\n**Select your operating system below and click to view installation instructions:**\n\n\u003Cdetails>\n\u003Csummary>\u003Ch3>► MacOS Install Instructions (click to expand)\u003C\u002Fh3>\u003C\u002Fsummary>\n\n**Step 1: Install uv**\n\n```bash\n# Using Homebrew\nbrew install uv\n\n# Or using curl\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n```\n\n**Step 2: Run Shotgun**\n\n```bash\nuvx shotgun-sh@latest\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Ch3>► Linux Install Instructions (click to expand)\u003C\u002Fh3>\u003C\u002Fsummary>\n\n**Step 1: Install uv**\n\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n```\n\n**Step 2: Run Shotgun**\n\n```bash\nuvx shotgun-sh@latest\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Ch3>► Windows Install Instructions (click to expand)\u003C\u002Fh3>\u003C\u002Fsummary>\n\nOpen PowerShell and run these commands:\n\n```powershell\n# Set execution policy (one-time)\nSet-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force\n\n# Install uv\npowershell -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\n\n# Add to PATH (or restart terminal)\n$env:Path = \"C:\\Users\\$env:USERNAME\\.local\\bin;$env:Path\"\n\n# OPTIONAL: Enable code indexing (run as Administrator)\nImport-Module BitsTransfer\nStart-BitsTransfer -Source \"https:\u002F\u002Faka.ms\u002Fvs\u002F17\u002Frelease\u002Fvc_redist.x64.exe\" -Destination \"$env:TEMP\\vc_redist.x64.exe\"\nStart-Process -FilePath \"$env:TEMP\\vc_redist.x64.exe\" -ArgumentList \"\u002Finstall\", \"\u002Fquiet\", \"\u002Fnorestart\" -Wait\n\n# Run Shotgun\nuvx --python 3.12 shotgun-sh@latest\n```\n\n| Supported | Not Supported |\n|-----------|---------------|\n| Windows x64 (regular PCs) | 32-bit Python |\n| Python 3.11-3.13 | Python 3.14+ (no wheels yet) |\n\n**Important:** Run in **PowerShell**, not Command Prompt or VS Developer shells.\n\n\u003C\u002Fdetails>\n\n_💡 Restart your terminal after installation_\n\n_**Why uv?** It's 10-100x faster than pip and handles binary wheels reliably—no cmake\u002Fbuild tool errors._\n\nNeed help? [View uv installation docs](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F)\n\n### 3. Get Started\n\nWhen you launch Shotgun, it will guide you through:\n\n| Step | What Happens |\n|------|--------------|\n| **1. Codebase Indexing** | Builds a searchable graph of your entire repository |\n| **2. LLM Setup** | Configure OpenAI, Anthropic, or Gemini |\n| **3. First Research** | Start generating codebase-aware specs |\n\n_**💡 Pro tip:** Run Shotgun in your IDE's terminal for the best experience._\n\n---\n\n# 🎥 Demo\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FhGryc6YZr2o\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_b511766c779f.png\" alt=\"Watch the Shotgun demo\" width=\"720\" height=\"405\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n_Click the image above to watch the full demo on YouTube_\n\n---\n\n# 🎯 Usage\n\n### Launch Shotgun in your project directory:\n\n_See [install instructions](#-installation) for your platform first!_\n\n```bash\nuvx shotgun-sh@latest\n```\n\n### Planning vs Drafting\n\n| Mode | How It Works | When to Use It |\n|------|--------------|---------------|\n| **Planning** (default) | Shotgun proposes an execution plan, shows each step, and asks for confirmation before running agents that change files. You get checkpoints, can refine the plan, and can confirm or skip cascaded updates when one change affects other docs. | When you want control, visibility, and the ability to refine the plan before execution. |\n| **Drafting** | Shotgun runs the full plan in one go, without intermediate confirmations. Progress is still tracked internally, but you won’t be prompted at each step. | When you’re confident in the plan and want fast, end-to-end execution. |\n\n_The TUI opens automatically. **Press `Shift+Tab` to switch between Planning & Drafting** or `\u002F` for the command palette._\n\n### How the Router Works Internally\nUnder the hood, the Router relies on specialized sub-agents. You don’t select or manage them manually.\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\">\u003Cb>🔬 Research\u003C\u002Fb>\u003Cbr\u002F>Explore & understand\u003C\u002Ftd>\n\u003Ctd align=\"center\">→\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>📝 Specify\u003C\u002Fb>\u003Cbr\u002F>Define requirements\u003C\u002Ftd>\n\u003Ctd align=\"center\">→\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>📋 Plan\u003C\u002Fb>\u003Cbr\u002F>Create roadmap\u003C\u002Ftd>\n\u003Ctd align=\"center\">→\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>✅ Tasks\u003C\u002Fb>\u003Cbr\u002F>Break into steps\u003C\u002Ftd>\n\u003Ctd align=\"center\">→\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>📤 Export\u003C\u002Fb>\u003Cbr\u002F>Format for AI\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n> Planning and Drafting are the only execution modes you control; everything else is handled by the Router.\n\n_**Mode switching:** `Shift+Tab` cycles through modes_\n\n### ⌨️ Keyboard Shortcuts\n\n| Shortcut | Action |\n|----------|--------|\n| `Shift+Tab` | Switch modes |\n| `\u002F` | Open command palette |\n| `Ctrl+C` | Cancel operation (or copy if text selected) |\n| `Escape` | Exit Q&A \u002F stop agent |\n| `Ctrl+U` | View usage stats |\n\n### Tips for Better Results\n\n| Do This | Not This |\n|---------|----------|\n| ✅ `Research how we handle auth` | ❌ Jump straight to building |\n| ✅ `Shotgun please ask me questions first` | ❌ Assume Shotgun knows your needs |\n| ✅ `I'm working on payments, need refunds` | ❌ `Add refunds` (no context) |\n| ✅ Start in Planning mode, let Shotgun propose and refine a plan with you, then run it | ❌ Blast everything in one go without reviewing the plan first (unless you intentionally switch to Drafting mode) |\n\n**Result:** Your AI coding agent gets complete context—what exists, why, and what to build.\n\n **Note:** CLI available in [docs\u002FCLI.md](docs\u002FCLI.md), but TUI is recommended.\n\n### Context7 Documentation Lookup (Experimental)\n\nThe Research agent can fetch up-to-date library documentation via [Context7](https:\u002F\u002Fcontext7.com). When configured, the agent will prefer Context7 over web search for documentation lookups.\n\nTo enable it, set your Context7 API key:\n\n```bash\nshotgun config set-context7 --api-key \u003Cyour-context7-api-key>\n```\n\nTo remove it:\n\n```bash\nshotgun config clear-context7\n```\n\n---\n\n# 🤝 Share Specs with Your Team\n\nSharing specs to a workspace is available on **paid Shotgun plans**.\n\nShotgun lets you share specs externally by publishing them to a **workspace**. This creates a versioned, shareable snapshot your team can access outside the repo.\n\n### How to Share a Spec\n\n1. Hit `\u002F` → select _Share specs to workspace_\n2. Choose one option:\n- **Create new spec** — publish a fresh spec from your current `.shotgun\u002F` files\n- **Add new version** — publish an updated version of an existing spec\n3. Wait for upload to complete. When finished, you can:\n- **Open in Browser** — view the shared spec in the workspace\n- **Copy URL** — share the link with your team\n- **Done** — return to Shotgun\n\u003Cimg width=\"516\" height=\"181\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_b9df3192ef5a.png\" \u002F>\n\n\nYour local `.shotgun\u002F*.md` files remain unchanged.  \nThe workspace contains a **shareable, versioned snapshot** of the spec.\n\n---\n\n# ✨ Features\n\n### What Makes Shotgun Different\n\n\u003Ctable>\n\u003Ctr>\n\u003Cth width=\"25%\">Feature\u003C\u002Fth>\n\u003Cth width=\"35%\">Shotgun\u003C\u002Fth>\n\u003Cth width=\"40%\">Other Tools\u003C\u002Fth>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Codebase Understanding\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\nReads your \u003Cstrong>entire repository\u003C\u002Fstrong> before generating specs. Finds existing patterns, dependencies, and architecture.\n\u003C\u002Ftd>\n\u003Ctd>\nRequire manual context or search each time. No persistent understanding of your codebase structure.\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Research Phase\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\nStarts with research—discovers what you already have AND what exists externally before writing anything.\n\u003C\u002Ftd>\n\u003Ctd>\nStart at specification. Build first, discover problems later.\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Dedicated Agents Per Mode\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\nEach mode (research, spec, plan, tasks, export) uses a \u003Cstrong>separate specialized agent\u003C\u002Fstrong> with prompts tailored specifically for that phase. 100% user-controllable via mode switching.\n\u003C\u002Ftd>\n\u003Ctd>\nSingle-agent or one-size-fits-all prompts.\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Structured Workflow\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\nRouter-driven flow with Planning and Drafting modes; internally it runs Research → Spec → Plan → Tasks → Export with checkpoints in Planning mode.\n\u003C\u002Ftd>\n\u003Ctd>\nNo structure. Just \"prompt and hope.\"\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>Export Formats\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\n\u003Ccode>AGENTS.md\u003C\u002Fcode> files ready for Cursor, Claude Code, Windsurf, Lovable—your choice of tool.\n\u003C\u002Ftd>\n\u003Ctd>\nLocked into specific IDE or coding agent.\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003C\u002Ftable>\n\n### Case Study - Real Example:\n\nWe had to implement payments. Cursor, Claude Code, and Copilot all suggested building a custom payment proxy — 3-4 weeks of development. \n\n⭐ Shotgun's research found [LiteLLM Proxy](https:\u002F\u002Fdocs.litellm.ai\u002Fdocs\u002Fsimple_proxy) instead—**30 minutes to discover, 5 days to deploy, first customer in 14 hours.**\n\n****80% less dev time. Near-zero technical debt.****\n\n### **[📖 Read the full case study](docs\u002FCASE_STUDY.md)**\n\n---\n\n# Use Cases\n\n- **🚀 Onboarding** - New developer? Shotgun maps your entire architecture and generates docs that actually match the code\n- **🔧 Refactoring** - Understand all dependencies before touching anything. Keep your refactor from becoming a rewrite\n- **🌱 Greenfield Projects** - Research existing solutions globally before writing line one\n- **➕ Adding Features** - Know exactly where your feature fits. Prevent duplicate functionality\n- **📦 Migration** - Map the old, plan the new, track the delta. Break migration into safe stages\n\n**📚 Want to see a detailed example?** Check out our [Case Study](docs\u002FCASE_STUDY.md) showing Shotgun in action on a real-world project.\n\n---\n\n# FAQ\n\n**Q: Does Shotgun collect any stats or data?**\n\nA: We only gather minimal, anonymous events (e.g., install, server start, tool call). We don't collect the content itself—only that an event occurred. We use PostHog for analytics and error reporting to improve stability.\n\n**Q: Does my code leave my computer when indexing?**\n\nA: No. When you index your codebase, all indexing happens locally on your machine. The index is stored in `~\u002F.shotgun-sh\u002Fcodebases\u002F` and never sent to any server. Your code stays on your computer.\n\n![Indexing Privacy](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_02bc890c04a5.png)\n\n**Q: Local LLMs?**\n\nA: Planned. We'll publish compatibility notes and local provider integrations.\n\n**Q: What LLM providers are supported?**\n\nA: Currently OpenAI, Anthropic (Claude), and Google Gemini. Local LLM support is on the roadmap.\n\n**Q: Can I use Shotgun offline?**\n\nA: You need an internet connection for LLM API calls, but your codebase stays local.\n\n**Q: How does the code graph work?**\n\nA: Shotgun indexes your codebase using tree-sitter for accurate parsing and creates a searchable graph of your code structure, dependencies, and relationships.\n\n---\n# Contributing\n\nShotgun is open-source and we welcome contributions. Whether you're fixing bugs, proposing features, improving docs, or spreading the word—we'd love to have you as part of the community.\n\n### Ways to contribute:\n\n- **Bug Report:** Found an issue? [Create a bug report](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002Fnew?template=bug_report.md)\n- **Feature Request:** Have an idea to make Shotgun better? [Submit a feature request](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002Fnew?template=feature_request.md)\n- **Documentation:** See something missing in the docs? [Request documentation](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002Fnew?template=documentation.md)\n\n**Not sure where to start?** Join our Discord and we'll help you get started!\n\n\u003Cdiv align=\"left\">\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002F5RmY6J2N7s\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJoin%20our%20community-5865F2?style=for-the-badge&logo=discord&logoColor=white\" alt=\"Join Discord\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\n### Development Resources\n\n- **[Contributing Guide](docs\u002FCONTRIBUTING.md)** - Setup, workflow, and guidelines\n- **[Git Hooks](docs\u002FGIT_HOOKS.md)** - Lefthook, trufflehog, and security scanning\n- **[CI\u002FCD](docs\u002FCI_CD.md)** - GitHub Actions and automated testing\n- **[Observability](docs\u002FOBSERVABILITY.md)** - Telemetry, Logfire, and monitoring\n- **[Docker](docs\u002FDOCKER.md)** - Container setup and deployment\n\n---\n\n\u003Cdiv align=\"center\">\n\n## 🚀 Ready to Stop AI Agents from Derailing?\n\n**Planning → Drafting** — Two execution modes that give AI agents the full picture, backed by internal phases for Research → Specify → Plan → Tasks → Export.\n\n```bash\nuvx shotgun-sh@latest\n```\n\n\n### ⭐ Star us on GitHub\n\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F⭐%20Star%20on%20GitHub-181717?style=for-the-badge&logo=github&logoColor=white\" alt=\"Star Shotgun Repo\" \u002F>\n\u003C\u002Fa>\n\n### Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#shotgun-sh\u002Fshotgun&type=date&legend=bottom-right\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=shotgun-sh\u002Fshotgun&type=date&theme=dark&legend=bottom-right\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_bf3bccd9d71d.png\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_bf3bccd9d71d.png\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n\u003C\u002Fdiv>\n\n---\n\n**License:** MIT | **Python:** 3.11+ | **Homepage:** [shotgun.sh](https:\u002F\u002Fshotgun.sh\u002F)\n\n---\n\n## Uninstall\n\n```bash\nuv tool uninstall shotgun-sh\n```\n","\u003Cdiv align=\"center\">\n\u003Cimg width=\"400\" height=\"150\" alt=\"Shotgun logo transparent background\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_fa5e55dc3307.png\" \u002F>  \n\n### 规范驱动开发\n\n\n**为 AI 编码助手（Codex、Cursor、Claude Code）编写具备代码库感知能力的规范，以防止其偏离轨道。**\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.11+-blue?style=flat&logo=python&logoColor=white\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.producthunt.com\u002Fproducts\u002Fshotgun-cli\u002Flaunches\u002Fshotgun-cli\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FProduct%20Hunt-%237%20Product%20of%20the%20Day-FF6154?style=flat&logo=producthunt&logoColor=white\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun?tab=contributing-ov-file\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-welcome-brightgreen?style=flat\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun?tab=MIT-1-ov-file\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue?style=flat\" \u002F>\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002F5RmY6J2N7s\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdiscord-150+%20online-5865F2?style=flat&logo=discord&logoColor=white\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n[![Website](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-shotgun.sh-5865F2?style=social&logo=safari&logoColor=5865F2)](https:\u002F\u002Fshotgun.sh)      [![Follow @ShotgunCLI](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFollow%20@ShotgunCLI-1DA1F2?style=social&logo=x&logoColor=000000)](https:\u002F\u002Fx.com\u002FShotgunCLI)    [![YouTube](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F-@shotgunCLI-FF0000?style=social&logo=youtube&logoColor=red)](https:\u002F\u002Fwww.youtube.com\u002F@shotgunCLI)\n\nLLM 代理状态：[![Better Stack Badge](https:\u002F\u002Fuptime.betterstack.com\u002Fstatus-badges\u002Fv2\u002Fmonitor\u002F272wo.svg)](https:\u002F\u002Fstatus.shotgun.sh\u002F) API 状态：[![Better Stack Badge](https:\u002F\u002Fuptime.betterstack.com\u002Fstatus-badges\u002Fv2\u002Fmonitor\u002F272wq.svg)](https:\u002F\u002Fstatus.shotgun.sh\u002F)\n\n\u003C\u002Fdiv>\n\n---\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd>\n\n**AI 助手擅长处理小型任务，但在大型功能上容易失控。** 它们会忘记上下文、重复构建已存在的内容，甚至在中途偏离既定规范。\n\n**Shotgun 可以解决这一问题。** 它会读取你的整个代码库，提前规划完整功能，然后将其拆分为一系列分阶段的 PR——每个 PR 都包含逐文件的详细指令，AI 助手完全可以按照这些指令执行。\n\n与其提交一个无人愿意评审的 1 万行巨型 PR，不如生成 5 个聚焦于特定任务的 PR 并顺利合并。\n\nShotgun 与 Cursor、Claude Code、Antigravity 或 Codex 均可完美配合。你可以自行提供密钥，也可以使用 Shotgun 的积分（10 美元等同于 10 美元的使用额度）。\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n---\n\n# 📦 安装\n\n**请在下方选择您的操作系统，并点击查看安装说明：**\n\n\u003Cdetails>\n\u003Csummary>\u003Ch3>► MacOS 安装说明（点击展开）\u003C\u002Fh3>\u003C\u002Fsummary>\n\n**步骤 1：安装 uv**\n\n```bash\n# 使用 Homebrew\nbrew install uv\n\n# 或者使用 curl\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n```\n\n**步骤 2：运行 Shotgun**\n\n```bash\nuvx shotgun-sh@latest\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Ch3>► Linux 安装说明（点击展开）\u003C\u002Fh3>\u003C\u002Fsummary>\n\n**步骤 1：安装 uv**\n\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n```\n\n**步骤 2：运行 Shotgun**\n\n```bash\nuvx shotgun-sh@latest\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Ch3>► Windows 安装说明（点击展开）\u003C\u002Fh3>\u003C\u002Fsummary>\n\n打开 PowerShell 并运行以下命令：\n\n```powershell\n# 设置执行策略（仅需一次）\nSet-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force\n\n# 安装 uv\npowershell -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\n\n# 添加到 PATH（或重启终端）\n$env:Path = \"C:\\Users\\$env:USERNAME\\.local\\bin;$env:Path\"\n\n# 可选：启用代码索引（需以管理员身份运行）\nImport-Module BitsTransfer\nStart-BitsTransfer -Source \"https:\u002F\u002Faka.ms\u002Fvs\u002F17\u002Frelease\u002Fvc_redist.x64.exe\" -Destination \"$env:TEMP\\vc_redist.x64.exe\"\nStart-Process -FilePath \"$env:TEMP\\vc_redist.x64.exe\" -ArgumentList \"\u002Finstall\", \"\u002Fquiet\", \"\u002Fnorestart\" -Wait\n\n# 运行 Shotgun\nuvx --python 3.12 shotgun-sh@latest\n```\n\n| 支持 | 不支持 |\n|-----------|---------------|\n| Windows x64（普通 PC） | 32 位 Python |\n| Python 3.11–3.13 | Python 3.14+（暂无预编译轮子包） |\n\n**重要提示：** 请务必在 **PowerShell** 中运行，而非命令提示符或 VS 开发人员工具。\n\n\u003C\u002Fdetails>\n\n_💡 安装完成后请重启终端_\n\n_**为什么选择 uv？** 它比 pip 快 10 到 100 倍，并且能可靠地处理二进制轮子包——不会出现 cmake 或构建工具相关的错误。_\n\n需要帮助吗？[查看 uv 安装文档](https:\u002F\u002Fdocs.astral.sh\u002Fuv\u002Fgetting-started\u002Finstallation\u002F)\n\n### 3. 开始使用\n\n当你启动 Shotgun 时，它会引导你完成以下步骤：\n\n| 步骤 | 操作 |\n|------|--------------|\n| **1. 代码库索引** | 构建整个仓库的可搜索图谱 |\n| **2. LLM 设置** | 配置 OpenAI、Anthropic 或 Gemini |\n| **3. 初始研究** | 开始生成具备代码库感知能力的规范 |\n\n_**小贴士：** 在 IDE 的终端中运行 Shotgun，体验更佳。_\n\n---\n\n# 🎥 演示\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fyoutu.be\u002FhGryc6YZr2o\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_b511766c779f.png\" alt=\"观看 Shotgun 演示\" width=\"720\" height=\"405\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n_点击上方图片即可在 YouTube 上观看完整演示_\n\n---\n\n# 🎯 使用方法\n\n### 在项目目录中启动 Shotgun：\n\n_请先参阅适用于您平台的 [安装说明](#-installation)！_\n\n```bash\nuvx shotgun-sh@latest\n```\n\n### 计划模式与草稿模式\n\n| 模式 | 工作原理 | 适用场景 |\n|------|--------------|---------------|\n| **计划模式**（默认） | Shotgun 会提出执行计划，展示每一步操作，并在运行可能修改文件的代理之前请求确认。你可以设置检查点，细化计划，并在某项更改影响其他文档时决定是否继续级联更新。 | 当你需要控制权、清晰的可见性以及在执行前调整计划的能力时。 |\n| **草稿模式** | Shotgun 会一次性执行整个计划，不进行中间确认。进度仍会在内部跟踪，但你不会在每一步都被提示。 | 当你对计划充满信心，希望快速完成端到端的执行时。 |\n\n_TUI 会自动打开。**按 `Shift+Tab` 可在计划模式和草稿模式之间切换**，或按 `\u002F` 打开命令面板。_\n\n### 路由器的内部工作原理\n在底层，路由器依赖于专门的子代理。你无需手动选择或管理它们。\n\n\u003Ctable>\n\u003Ctr>\n\u003Ctd align=\"center\">\u003Cb>🔬 研究\u003C\u002Fb>\u003Cbr\u002F>探索并理解\u003C\u002Ftd>\n\u003Ctd align=\"center\">→\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>📝 规范化\u003C\u002Fb>\u003Cbr\u002F>定义需求\u003C\u002Ftd>\n\u003Ctd align=\"center\">→\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>📋 计划\u003C\u002Fb>\u003Cbr\u002F>制定路线图\u003C\u002Ftd>\n\u003Ctd align=\"center\">→\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>✅ 任务\u003C\u002Fb>\u003Cbr\u002F>分解为步骤\u003C\u002Ftd>\n\u003Ctd align=\"center\">→\u003C\u002Ftd>\n\u003Ctd align=\"center\">\u003Cb>📤 导出\u003C\u002Fb>\u003Cbr\u002F>格式化供 AI 使用\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n> 计划模式和草稿模式是你唯一可以控制的执行模式；其余部分均由路由器自动处理。\n\n_**模式切换：** 按 `Shift+Tab` 可循环切换模式_\n\n### ⌨️ 键盘快捷键\n\n| 快捷键       | 动作           |\n|--------------|----------------|\n| `Shift+Tab`  | 切换模式       |\n| `\u002F`          | 打开命令面板   |\n| `Ctrl+C`     | 取消操作（或复制选中文本） |\n| `Escape`     | 退出问答 \u002F 停止代理 |\n| `Ctrl+U`     | 查看使用统计   |\n\n### 获得更好结果的提示\n\n| 应该这样做         | 不应该这样做       |\n|--------------------|--------------------|\n| ✅ `研究我们如何处理认证` | ❌ 直接开始开发 |\n| ✅ `Shotgun，请先问我问题` | ❌ 认为Shotgun了解你的需求 |\n| ✅ `我在做支付相关工作，需要退款功能` | ❌ `添加退款功能`（缺乏上下文） |\n| ✅ 先从规划模式开始，让Shotgun与你一起提出并完善方案，然后再执行 | ❌ 不先审查方案就一次性全部执行（除非你故意切换到草稿模式） |\n\n**结果：** 你的 AI 编码代理将获得完整的上下文——现有内容、原因以及要构建的内容。\n\n**注意：** CLI 已在 [docs\u002FCLI.md](docs\u002FCLI.md) 中提供，但建议使用 TUI。\n\n### Context7 文档查找（实验性）\n\nResearch 代理可以通过 [Context7](https:\u002F\u002Fcontext7.com) 获取最新的库文档。配置后，代理在查找文档时会优先使用 Context7 而不是网络搜索。\n\n要启用它，请设置你的 Context7 API 密钥：\n\n```bash\nshotgun config set-context7 --api-key \u003Cyour-context7-api-key>\n```\n\n要移除它：\n\n```bash\nshotgun config clear-context7\n```\n\n---\n\n# 🤝 与团队共享规格说明\n\n在 **付费 Shotgun 方案** 上可以将规格说明共享到工作区。\n\nShotgun 允许你通过将其发布到 **工作区** 来对外共享规格说明。这会创建一个版本化的可共享快照，你的团队可以在仓库之外访问。\n\n### 如何共享规格说明\n\n1. 按下 `\u002F` → 选择 _将规格说明共享到工作区_\n2. 选择以下选项之一：\n- **创建新规格** — 从当前 `.shotgun\u002F` 文件中发布一份全新的规格\n- **添加新版本** — 发布现有规格的更新版本\n3. 等待上传完成。完成后，你可以：\n- **在浏览器中打开** — 查看工作区中的共享规格\n- **复制 URL** — 将链接分享给你的团队\n- **完成** — 返回 Shotgun\n\u003Cimg width=\"516\" height=\"181\" alt=\"image\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_b9df3192ef5a.png\" \u002F>\n\n\n你本地的 `.shotgun\u002F*.md` 文件保持不变。  \n工作区包含的是规格说明的 **可共享、版本化快照**。\n\n---\n\n# ✨ 功能\n\n### 使 Shotgun 不同之处\n\n\u003Ctable>\n\u003Ctr>\n\u003Cth width=\"25%\">功能\u003C\u002Fth>\n\u003Cth width=\"35%\">Shotgun\u003C\u002Fth>\n\u003Cth width=\"40%\">其他工具\u003C\u002Fth>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>代码库理解\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\n在生成规格之前，会读取你的 \u003Cstrong>整个代码库\u003C\u002Fstrong>。找到现有的模式、依赖关系和架构。\n\u003C\u002Ftd>\n\u003Ctd>\n每次都需要手动提供上下文或进行搜索。无法持续理解你的代码库结构。\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>研究阶段\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\n从研究开始——在编写任何内容之前，发现你已经拥有的内容以及外部存在的内容。\n\u003C\u002Ftd>\n\u003Ctd>\n直接从规格说明开始。先开发，之后才发现问题。\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>每个模式专用的代理\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\n每个模式（研究、规格、计划、任务、导出）都使用一个 \u003Cstrong>独立的专业代理\u003C\u002Fstrong>,其提示专门针对该阶段定制。可通过模式切换完全由用户控制。\n\u003C\u002Ftd>\n\u003Ctd>\n单一代理或通用提示。\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>结构化工作流\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\n基于路由器的流程，包含规划和草稿模式；内部流程为研究 → 规格 → 计划 → 任务 → 导出，并在规划模式中设有检查点。\n\u003C\u002Ftd>\n\u003Ctd>\n没有明确的结构。只是“输入提示，寄希望于结果”。\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003Ctr>\n\u003Ctd>\u003Cstrong>导出格式\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd>\n\u003Ccode>AGENTS.md\u003C\u002Fcode> 文件已准备好用于 Cursor、Claude Code、Windsurf、Lovable——你可以自由选择工具。\n\u003C\u002Ftd>\n\u003Ctd>\n受限于特定的 IDE 或编码代理。\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\n\u003C\u002Ftable>\n\n### 案例研究 - 实际例子：\n\n我们曾需要实现支付功能。Cursor、Claude Code 和 Copilot 都建议构建自定义支付代理——这将需要 3-4 周的开发时间。\n\n⭐ 而 Shotgun 的研究发现了一个名为 [LiteLLM Proxy](https:\u002F\u002Fdocs.litellm.ai\u002Fdocs\u002Fsimple_proxy) 的解决方案——**仅需 30 分钟发现，5 天部署完成，第一个客户在 14 小时内接入。**\n\n****开发时间减少了 80%。技术债务几乎为零。****\n\n### **[📖 阅读完整案例研究](docs\u002FCASE_STUDY.md)**\n\n---\n\n# 使用场景\n\n- **🚀 新员工入职** - 新开发者？Shotgun 会绘制你的整个架构图，并生成与代码实际匹配的文档。\n- **🔧 重构** - 在动手之前先了解所有依赖关系。避免重构变成重写。\n- **🌱 新项目** - 在写下第一行代码之前，先调研全球范围内已有的解决方案。\n- **➕ 添加功能** - 准确知道你的功能应该放在哪里。防止功能重复。\n- **📦 迁移** - 绘制旧系统的架构图，规划新系统，跟踪差异。将迁移过程分解为安全的步骤。\n\n**📚 想看详细示例吗？** 请查看我们的 [案例研究](docs\u002FCASE_STUDY.md)，其中展示了 Shotgun 在实际项目中的应用。\n\n---\n\n# 常见问题解答\n\n**问：Shotgun 会收集任何统计数据或数据吗？**\n\n答：我们只收集极少量的匿名事件（例如安装、服务器启动、工具调用）。我们不会收集具体内容——只记录事件的发生。我们使用 PostHog 进行分析和错误报告，以提高稳定性。\n\n**问：索引代码时，我的代码会离开我的电脑吗？**\n\n答：不会。当你索引代码库时，所有的索引操作都在你的本地机器上进行。索引存储在 `~\u002F.shotgun-sh\u002Fcodebases\u002F` 中，永远不会发送到任何服务器。你的代码始终留在你的电脑上。\n\n![索引隐私](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_02bc890c04a5.png)\n\n**问：本地 LLM 支持？**\n\n答：正在计划中。我们会发布兼容性说明和本地提供商集成信息。\n\n**问：支持哪些 LLM 提供商？**\n\n答：目前支持 OpenAI、Anthropic（Claude）和 Google Gemini。本地 LLM 支持也在计划中。\n\n**问：我可以在离线状态下使用 Shotgun 吗？**\n\n答：你需要互联网连接来进行 LLM API 调用，但你的代码库仍然保留在本地。\n\n**问：代码图是如何工作的？**\n\n答：Shotgun 使用 tree-sitter 对你的代码库进行索引，以实现准确的解析，并创建一个可搜索的代码结构、依赖关系和相互关系图。\n---\n# 贡献\n\nShotgun 是开源项目，我们欢迎各方贡献。无论是修复 bug、提出功能建议、改进文档，还是传播消息——我们都期待你成为社区的一员。\n\n### 贡献方式：\n\n- **Bug 报告：** 发现问题了吗？[创建 Bug 报告](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002Fnew?template=bug_report.md)\n- **功能请求：** 有让 Shotgun 更好的想法吗？[提交功能请求](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002Fnew?template=feature_request.md)\n- **文档：** 发现文档中缺少内容吗？[请求补充文档](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002Fnew?template=documentation.md)\n\n**不确定从哪里开始？** 加入我们的 Discord，我们会帮助你入门！\n\n\u003Cdiv align=\"left\">\n  \u003Ca href=\"https:\u002F\u002Fdiscord.com\u002Finvite\u002F5RmY6J2N7s\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJoin%20our%20community-5865F2?style=for-the-badge&logo=discord&logoColor=white\" alt=\"加入 Discord\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fdiv>\n\n### 开发资源\n\n- **[贡献指南](docs\u002FCONTRIBUTING.md)** - 环境搭建、工作流程与规范\n- **[Git 钩子](docs\u002FGIT_HOOKS.md)** - Lefthook、trufflehog 及安全扫描\n- **[CI\u002FCD](docs\u002FCI_CD.md)** - GitHub Actions 与自动化测试\n- **[可观测性](docs\u002FOBSERVABILITY.md)** - 遥测、Logfire 与监控\n- **[Docker](docs\u002FDOCKER.md)** - 容器化部署与运行\n\n---\n\n\u003Cdiv align=\"center\">\n\n## 🚀 准备好阻止 AI 助手失控了吗？\n\n**规划 → 起草** — 两种执行模式为 AI 助手提供全局视角，并辅以内部阶段：研究 → 明确需求 → 规划 → 任务分解 → 导出。\n\n```bash\nuvx shotgun-sh@latest\n```\n\n\n### ⭐ 在 GitHub 上给项目加星\n\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F⭐%20Star%20on%20GitHub-181717?style=for-the-badge&logo=github&logoColor=white\" alt=\"为 Shotgun 仓库加星\" \u002F>\n\u003C\u002Fa>\n\n### 星标历史\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F#shotgun-sh\u002Fshotgun?type=date&legend=bottom-right\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=shotgun-sh\u002Fshotgun&type=date&theme=dark&legend=bottom-right\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_bf3bccd9d71d.png\" \u002F>\n   \u003Cimg alt=\"星标历史图表\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_readme_bf3bccd9d71d.png\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n\u003C\u002Fdiv>\n\n---\n\n**许可证：** MIT | **Python：** 3.11+ | **官网：** [shotgun.sh](https:\u002F\u002Fshotgun.sh\u002F)\n\n---\n\n## 卸载\n\n```bash\nuv tool uninstall shotgun-sh\n```","# Shotgun 快速上手指南\n\nShotgun 是一款专为 AI 编程助手（如 Cursor、Claude Code、Codex）设计的规范驱动开发工具。它能读取整个代码库，生成感知上下文的开发规范，并将大型功能拆解为可执行的阶段性任务，防止 AI 在复杂任务中“跑偏”。\n\n## 环境准备\n\n### 系统要求\n- **操作系统**：macOS, Linux, Windows (x64)\n- **Python 版本**：3.11 - 3.13 (Windows 用户推荐 3.12)\n- **终端环境**：\n  - macOS\u002FLinux: 任意标准终端\n  - Windows: **必须使用 PowerShell** (不支持 CMD 或 VS Developer Shell)\n\n### 前置依赖\nShotgun 依赖 `uv` 包管理器进行安装和运行。`uv` 比传统 pip 快 10-100 倍，且能可靠处理二进制轮文件。\n\n> **💡 国内加速提示**：如果直接安装 `uv` 速度较慢，可尝试配置国内镜像或使用代理网络。\n\n## 安装步骤\n\n请根据您的操作系统选择对应的安装命令：\n\n### macOS\n```bash\n# 1. 安装 uv (推荐使用 Homebrew)\nbrew install uv\n\n# 或者使用 curl 安装\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# 2. 运行 Shotgun\nuvx shotgun-sh@latest\n```\n\n### Linux\n```bash\n# 1. 安装 uv\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# 2. 运行 Shotgun\nuvx shotgun-sh@latest\n```\n\n### Windows (PowerShell)\n请以**管理员身份**打开 PowerShell，依次执行以下命令：\n\n```powershell\n# 1. 设置执行策略 (仅需执行一次)\nSet-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force\n\n# 2. 安装 uv\npowershell -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\n\n# 3. 将 uv 添加到当前会话的 PATH (或重启终端)\n$env:Path = \"C:\\Users\\$env:USERNAME\\.local\\bin;$env:Path\"\n\n# 4. (可选) 启用代码索引所需的运行时库\nImport-Module BitsTransfer\nStart-BitsTransfer -Source \"https:\u002F\u002Faka.ms\u002Fvs\u002F17\u002Frelease\u002Fvc_redist.x64.exe\" -Destination \"$env:TEMP\\vc_redist.x64.exe\"\nStart-Process -FilePath \"$env:TEMP\\vc_redist.x64.exe\" -ArgumentList \"\u002Finstall\", \"\u002Fquiet\", \"\u002Fnorestart\" -Wait\n\n# 5. 运行 Shotgun\nuvx --python 3.12 shotgun-sh@latest\n```\n\n> **注意**：安装完成后，建议**重启终端**以确保环境变量生效。\n\n## 基本使用\n\n### 1. 启动工具\n进入您的项目根目录，运行以下命令启动 Shotgun 的交互式界面 (TUI)：\n\n```bash\nuvx shotgun-sh@latest\n```\n\n### 2. 初始化流程\n启动后，工具将自动引导您完成以下步骤：\n1.  **代码库索引 (Codebase Indexing)**：构建整个仓库的可搜索图谱。\n2.  **LLM 配置**：设置您的 API Key (支持 OpenAI, Anthropic, Gemini 等)。\n3.  **首次研究**：开始生成感知代码库的开发规范。\n\n> **💡 最佳实践**：建议在 IDE (如 VS Code, Cursor) 内置的终端中运行 Shotgun，以获得最佳体验。\n\n### 3. 核心模式切换\nShotgun 提供两种主要执行模式，可通过快捷键随时切换：\n\n| 模式 | 说明 | 适用场景 | 切换快捷键 |\n| :--- | :--- | :--- | :--- |\n| **Planning (规划模式)** | 默认模式。提出执行计划，展示每一步骤，并在修改文件前请求确认。允许您在执行前优化计划。 | 需要控制力、可见性，或任务较复杂时。 | `Shift+Tab` |\n| **Drafting (起草模式)** | 一次性执行完整计划，中间无确认提示。内部仍追踪进度，但不会打断用户。 | 对计划非常有信心，追求端到端快速执行时。 | `Shift+Tab` |\n\n### 4. 常用操作与快捷键\n\n- **打开命令面板**：按下 `\u002F` 键，可输入指令或选择功能（如分享规范）。\n- **取消操作\u002F停止 Agent**：按下 `Escape` 键。\n- **查看使用统计**：按下 `Ctrl+U`。\n- **复制文本**：选中文本后按 `Ctrl+C` (未选中时为中途中断)。\n\n### 5. 使用技巧\n为了获得最佳结果，建议遵循以下交互方式：\n- ✅ **先研究后构建**：输入 `\"Research how we handle auth\"` (研究我们如何处理认证)，让 AI 先理解现有架构。\n- ✅ **提供上下文**：明确告知背景，例如 `\"I'm working on payments, need refunds\"` (我在做支付模块，需要退款功能)。\n- ✅ **利用规划模式**：先在 Planning 模式下让 Shotgun 提出并细化计划，确认无误后再执行。\n- ❌ **避免模糊指令**：不要直接输入 `\"Add refunds\"` (添加退款) 而不提供任何上下文。\n\n通过这种方式，您的 AI 编程助手将获得完整的上下文信息（现有代码、架构原因及构建目标），从而生成高质量的代码。","某初创团队的后端工程师正利用 Cursor 或 Claude Code 等 AI 助手，试图在一个拥有数万行代码的遗留项目中重构整个用户认证模块并集成新的 OAuth2 登录功能。\n\n### 没有 shotgun 时\n- **上下文丢失**：AI 在生成长代码时经常“遗忘”项目现有的工具类或数据库结构，导致重复造轮子甚至覆盖原有逻辑。\n- **需求偏离**：开发进行到一半，AI 容易忽略初始约束，自行添加未请求的功能或采用不兼容的技术栈，最终产出与预期不符。\n- **审查灾难**：所有改动被打包成一个包含数千行代码的巨型 Pull Request，人类开发者根本无法有效审查，只能盲目合并或全部推翻重来。\n- **迭代挫败**：一旦出错，由于缺乏清晰的分步规划，开发者不得不反复手动修正提示词，陷入“生成 - 报错 - 重试”的死循环。\n\n### 使用 shotgun 后\n- **全局感知规划**：shotgun 先扫描整个代码库，基于现有架构生成一份精准的、分阶段的开发蓝图，确保 AI 完全理解项目上下文。\n- **原子化执行**：它将宏大需求拆解为多个小型、独立的 PR，每个 PR 仅包含具体的文件级指令，让 AI 专注完成单一任务而不跑偏。\n- **可控的代码交付**：开发者收到的是 5 个逻辑清晰、易于审查的小型 PR，而非一个难以维护的“代码怪兽”，大幅降低合并风险。\n- **流程自动化**：从规划到分步执行的流程由 shotgun 自动编排，工程师只需关注核心逻辑确认，显著提升了大型功能落地的成功率。\n\nshotgun 通过将宏大的开发目标转化为 AI 可精准执行的原子化步骤，彻底解决了大模型在复杂工程中容易“脱轨”的难题。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fshotgun-sh_shotgun_b511766c.jpg","shotgun-sh","ShotgunCLI","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fshotgun-sh_be0159b3.png","",null,"contact@shotgun.sh","https:\u002F\u002Fshotgun.sh","https:\u002F\u002Fgithub.com\u002Fshotgun-sh",[85,89,93,97],{"name":86,"color":87,"percentage":88},"Python","#3572A5",96.2,{"name":90,"color":91,"percentage":92},"Jinja","#a52a22",3.4,{"name":94,"color":95,"percentage":96},"HTML","#e34c26",0.4,{"name":98,"color":99,"percentage":100},"Dockerfile","#384d54",0.1,653,33,"2026-04-16T08:22:32","MIT","Linux, macOS, Windows","未说明",{"notes":108,"python":109,"dependencies":110},"推荐使用 uv 进行安装和管理（比 pip 快 10-100 倍）；Windows 用户需使用 PowerShell 运行，不支持 32 位 Python 或 Python 3.14+；建议在 IDE 终端中运行以获得最佳体验；可选配置 Context7 API 用于文档查找。","3.11+",[111],"uv",[14],[114,115,116,117,118,119,120],"cli","codebase-indexing","developer-tools","prd","spec-driven-development","specification-generation","technical-documentation","2026-03-27T02:49:30.150509","2026-04-18T22:38:05.438561",[124,129,134,139,144,149],{"id":125,"question_zh":126,"answer_zh":127,"source_url":128},40783,"如何在 macOS 上解决安装时出现的 'cmake: command not found' 错误？","该问题已通过更新安装方式解决。请不要再使用旧的 pip 安装方法，而是访问官方文档 https:\u002F\u002Fshotgun.sh\u002F 查看最新的安装说明。目前推荐使用 `uv` 进行安装，项目已添加自动化测试确保在 Mac、Linux 和 Windows 上都能正常安装。如果仍遇到问题，请参考官网最新指南。","https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002F18",{"id":130,"question_zh":131,"answer_zh":132,"source_url":133},40784,"推荐使用什么工具来安装 Shotgun？","强烈推荐使用 `uv` 工具进行安装，它比传统的 pipx 更快速且可靠。安装命令为：\n```bash\nuv tool install shotgun-sh\n```\n这是目前官方推荐的首选安装方式。","https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002F17",{"id":135,"question_zh":136,"answer_zh":137,"source_url":138},40785,"为什么我的大型规格文件（specification.md）内容被截断或丢失了？","Shotgun 的核心设计理念是规格、计划和任务必须能放入代理的上下文窗口中，以便整体推理。将规格拆分为多个文件会破坏这一机制。如果您遇到因文件过大导致的内容丢失：\n1. 数据恢复：版本 0.11 及以上引入了备份系统，所有被修改的文件都会自动备份到 `~\u002F.shotgun-sh\u002Fbackups\u002F` 目录，您可以从中恢复数据。\n2. 最佳实践：如果规格文件达到 160KB 这样的大小，建议缩小项目范围或将项目拆分为多个独立的 Shotgun 项目，而不是尝试拆分单个规格文件。","https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002F506",{"id":140,"question_zh":141,"answer_zh":142,"source_url":143},40786,"如何在不同的代码仓库中同时运行多个 Shotgun 会话？","在旧版本中，启动时会检查所有数据库文件并加锁，导致无法并发运行。此问题已在版本 0.13.0 中修复。修复后，Shotgun 仅在启动时加载当前工作目录对应的数据库，不再锁定其他项目的数据库文件。请确保您将 Shotgun 升级到最新版本（0.13.0 或更高）以支持在不同仓库中并行开发。","https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002F534",{"id":145,"question_zh":146,"answer_zh":147,"source_url":148},40787,"为什么在命令行中使用 `--model` 参数指定的模型没有被生效？","这是一个已知 Bug，在版本 0.10.12 中，命令行传入的 `--model` 参数会被 TUI 中上次设置的模型覆盖。该问题已在版本 0.10.13 中修复。如果您遇到此问题，请将 Shotgun 升级到 0.10.13 或更高版本，之后命令行指定的模型将优先于 TUI 的历史设置。","https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002F500",{"id":150,"question_zh":151,"answer_zh":152,"source_url":153},40788,"是否支持配置 LLM 端点以使用订阅制账户（如 Claude Code 订阅）？","是的，维护者已确认将使基础 URL（Base URLs）可配置，从而支持用户连接到自己的订阅端点而无需额外购买 Token。该功能正在开发中，旨在允许用户自定义 LLM 端点配置。请关注后续版本更新以获取该功能。","https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fissues\u002F8",[155,160,165,170,175,180,185,190,195,200,205,210,215,220,225,230,235,240,245,250],{"id":156,"version":157,"summary_zh":158,"released_at":159},324319,"0.13.0","## 🚀 发布 v0.13.0\n\n### 安装\n\n**使用 uvx（推荐 - 速度提升 10-100 倍）：**\n\n首先，如果您尚未安装 uv，请执行以下命令：\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# 或者使用 Homebrew：brew install uv\n```\n\n然后安装 shotgun-sh：\n```bash\n# 快速启动（临时使用）\nuvx shotgun-sh\n\n# 或者进行永久安装\nuv tool install shotgun-sh==0.13.0\n```\n\n**使用 pipx：**\n```bash\npipx install shotgun-sh==0.13.0\n```\n\n### PyPI\n在 PyPI 上查看：https:\u002F\u002Fpypi.org\u002Fproject\u002Fshotgun-sh\u002F0.13.0\u002F\n\n### 变更内容\n详情请参阅 [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fblob\u002Fmain\u002FCHANGELOG.md)。","2026-04-14T07:57:53",{"id":161,"version":162,"summary_zh":163,"released_at":164},324320,"0.13.0.dev1","## 变更内容\n* 修复：将 CodebaseGraphManager 的作用域限定为当前仓库，以支持并发会话（替代方案），由 @lchachurski 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F538 中完成\n\n## 新贡献者\n* @lchachurski 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F538 中完成了首次贡献\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.12.0.dev1...0.13.0.dev1","2026-04-14T07:19:03",{"id":166,"version":167,"summary_zh":168,"released_at":169},324321,"0.12.0.dev1","## 变更内容\n* 功能（tui）：添加选择器组件，用于替换“类型继续”提示，由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F466 中实现。\n* 构建（依赖项）：使用 Dependabot 机器人将单个目录下的 all-python-deps 组的依赖版本全部升级，共 9 处更新，由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F519 中完成。\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.11.0...0.12.0.dev1","2026-03-18T12:39:30",{"id":171,"version":172,"summary_zh":173,"released_at":174},324322,"0.11.0","## 🚀 发布 v0.11.0\n\n### 安装\n\n**使用 uvx（推荐 - 速度提升 10-100 倍）：**\n\n首先，如果您尚未安装 uv，请执行以下命令：\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# 或者使用 Homebrew：brew install uv\n```\n\n然后安装 shotgun-sh：\n```bash\n# 快速启动（临时使用）\nuvx shotgun-sh\n\n# 或者进行永久安装\nuv tool install shotgun-sh==0.11.0\n```\n\n**使用 pipx：**\n```bash\npipx install shotgun-sh==0.11.0\n```\n\n### PyPI\n在 PyPI 上查看：https:\u002F\u002Fpypi.org\u002Fproject\u002Fshotgun-sh\u002F0.11.0\u002F\n\n### 变更内容\n详情请参阅 [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fblob\u002Fmain\u002FCHANGELOG.md)。","2026-03-13T10:28:33",{"id":176,"version":177,"summary_zh":178,"released_at":179},324323,"0.11.0.dev2","## 变更内容\n* 功能(mcp)：由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F511 中添加了对所有代理的通用 MCP 服务器支持\n* 构建(deps)：由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F514 中批量更新了所有依赖项\n* 修复(mcp)：由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F515 中为路由器代理添加了 MCP 服务器支持\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.14...0.11.0.dev2","2026-03-12T11:20:31",{"id":181,"version":182,"summary_zh":183,"released_at":184},324324,"0.11.0.dev1","## 变更内容\n* 功能(mcp)：由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F511 中添加了对所有代理的通用 MCP 服务器支持\n* 构建(deps)：由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F514 中批量更新了所有依赖项\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.14...0.11.0.dev1","2026-03-12T09:57:19",{"id":186,"version":187,"summary_zh":188,"released_at":189},324325,"0.10.14","## 🚀 发布 v0.10.14\n\n### 安装\n\n**使用 uvx（推荐 - 速度提升 10-100 倍）：**\n\n首先，如果您尚未安装 uv，请执行以下命令：\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# 或者使用 Homebrew：brew install uv\n```\n\n然后安装 shotgun-sh：\n```bash\n# 快速启动（临时使用）\nuvx shotgun-sh\n\n# 或者进行永久安装\nuv tool install shotgun-sh==0.10.14\n```\n\n**使用 pipx：**\n```bash\npipx install shotgun-sh==0.10.14\n```\n\n### PyPI\n在 PyPI 上查看：https:\u002F\u002Fpypi.org\u002Fproject\u002Fshotgun-sh\u002F0.10.14\u002F\n\n### 变更内容\n详细信息请参阅 [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fblob\u002Fmain\u002FCHANGELOG.md)。","2026-03-10T10:11:51",{"id":191,"version":192,"summary_zh":193,"released_at":194},324326,"0.10.14.dev3","## 变更内容\n* 功能(代理)：添加 .shotgun\u002F 目录下构件的预代理备份，由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F509 中实现\n* 功能(模型)：添加对 GPT-5.4 和 GPT-5.4 Pro 的支持，由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F512 中实现\n* 修复(模型)：移除 GPT-5.4 Pro（Shotgun 账户不支持），由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F513 中实现\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.13...0.10.14.dev3","2026-03-10T09:59:53",{"id":196,"version":197,"summary_zh":198,"released_at":199},324327,"0.10.14.dev1","## 变更内容\n* 功能(代理)：添加 .shotgun\u002F 目录下构件的预代理备份，由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F509 中实现\n* 功能(模型)：添加对 GPT-5.4 和 GPT-5.4 Pro 的支持，由 @scottfrasso 在 https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F512 中实现\n\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.13...0.10.14.dev1","2026-03-10T09:00:10",{"id":201,"version":202,"summary_zh":203,"released_at":204},324328,"0.10.13","## 🚀 发布 v0.10.13\n\n### 安装\n\n**使用 uvx（推荐 - 速度提升 10-100 倍）：**\n\n首先，如果您尚未安装 uv，请执行以下命令：\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# 或者使用 Homebrew：brew install uv\n```\n\n然后安装 shotgun-sh：\n```bash\n# 快速启动（临时使用）\nuvx shotgun-sh\n\n# 或者进行永久安装\nuv tool install shotgun-sh==0.10.13\n```\n\n**使用 pipx：**\n```bash\npipx install shotgun-sh==0.10.13\n```\n\n### PyPI\n在 PyPI 上查看：https:\u002F\u002Fpypi.org\u002Fproject\u002Fshotgun-sh\u002F0.10.13\u002F\n\n### 变更内容\n详情请参阅 [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fblob\u002Fmain\u002FCHANGELOG.md)。","2026-03-03T11:27:13",{"id":206,"version":207,"summary_zh":208,"released_at":209},324329,"0.10.13.dev1","## What's Changed\r\n* chore: update project author to MimirAI by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F499\r\n* feat(config): make --model flag work universally and add config set-model by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F503\r\n* chore(build): remove logfire token embedding from builds by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F504\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.12...0.10.13.dev1","2026-03-03T11:08:57",{"id":211,"version":212,"summary_zh":213,"released_at":214},324330,"0.10.12","## 🚀 Release v0.10.12\n\n### Installation\n\n**Using uvx (Recommended - 10-100x faster):**\n\nFirst, install uv if you don't have it:\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# Or with Homebrew: brew install uv\n```\n\nThen install shotgun-sh:\n```bash\n# Quick start (ephemeral)\nuvx shotgun-sh\n\n# Or install permanently\nuv tool install shotgun-sh==0.10.12\n```\n\n**Using pipx:**\n```bash\npipx install shotgun-sh==0.10.12\n```\n\n### PyPI\nView on PyPI: https:\u002F\u002Fpypi.org\u002Fproject\u002Fshotgun-sh\u002F0.10.12\u002F\n\n### What's Changed\nSee [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fblob\u002Fmain\u002FCHANGELOG.md) for details.\n","2026-02-25T13:19:02",{"id":216,"version":217,"summary_zh":218,"released_at":219},324331,"0.10.12.dev1","## What's Changed\r\n* ci(deps): bump actions\u002Fcheckout from 4 to 6 in the all-github-actions group by @dependabot[bot] in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F476\r\n* build(deps): bump pydantic-ai to 1.63.0, anthropic to 0.83.0, and other deps by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F494\r\n* fix(tui): constrain indexing progress bar to single line by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F495\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.11...0.10.12.dev1","2026-02-25T13:03:09",{"id":221,"version":222,"summary_zh":223,"released_at":224},324332,"0.10.11","## 🚀 Release v0.10.11\n\n### Installation\n\n**Using uvx (Recommended - 10-100x faster):**\n\nFirst, install uv if you don't have it:\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# Or with Homebrew: brew install uv\n```\n\nThen install shotgun-sh:\n```bash\n# Quick start (ephemeral)\nuvx shotgun-sh\n\n# Or install permanently\nuv tool install shotgun-sh==0.10.11\n```\n\n**Using pipx:**\n```bash\npipx install shotgun-sh==0.10.11\n```\n\n### PyPI\nView on PyPI: https:\u002F\u002Fpypi.org\u002Fproject\u002Fshotgun-sh\u002F0.10.11\u002F\n\n### What's Changed\nSee [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fblob\u002Fmain\u002FCHANGELOG.md) for details.\n","2026-02-20T09:43:19",{"id":226,"version":227,"summary_zh":228,"released_at":229},324333,"0.10.11.dev1","**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.9...0.10.11.dev1","2026-02-20T09:29:57",{"id":231,"version":232,"summary_zh":233,"released_at":234},324334,"0.10.10","## 🚀 Release v0.10.10\n\n### Installation\n\n**Using uvx (Recommended - 10-100x faster):**\n\nFirst, install uv if you don't have it:\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# Or with Homebrew: brew install uv\n```\n\nThen install shotgun-sh:\n```bash\n# Quick start (ephemeral)\nuvx shotgun-sh\n\n# Or install permanently\nuv tool install shotgun-sh==0.10.10\n```\n\n**Using pipx:**\n```bash\npipx install shotgun-sh==0.10.10\n```\n\n### PyPI\nView on PyPI: https:\u002F\u002Fpypi.org\u002Fproject\u002Fshotgun-sh\u002F0.10.10\u002F\n\n### What's Changed\nSee [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fblob\u002Fmain\u002FCHANGELOG.md) for details.\n","2026-02-19T15:40:15",{"id":236,"version":237,"summary_zh":238,"released_at":239},324335,"0.10.10.dev1","## What's Changed\r\n* fix(telemetry): add key_provider tracking and remove PII from PostHog events by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F487\r\n* fix(ci): cache trufflehog binary to avoid flaky downloads by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F488\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.9...0.10.10.dev1","2026-02-19T15:21:17",{"id":241,"version":242,"summary_zh":243,"released_at":244},324336,"0.10.9","## 🚀 Release v0.10.9\n\n### Installation\n\n**Using uvx (Recommended - 10-100x faster):**\n\nFirst, install uv if you don't have it:\n```bash\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n# Or with Homebrew: brew install uv\n```\n\nThen install shotgun-sh:\n```bash\n# Quick start (ephemeral)\nuvx shotgun-sh\n\n# Or install permanently\nuv tool install shotgun-sh==0.10.9\n```\n\n**Using pipx:**\n```bash\npipx install shotgun-sh==0.10.9\n```\n\n### PyPI\nView on PyPI: https:\u002F\u002Fpypi.org\u002Fproject\u002Fshotgun-sh\u002F0.10.9\u002F\n\n### What's Changed\nSee [CHANGELOG.md](https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fblob\u002Fmain\u002FCHANGELOG.md) for details.\n","2026-02-19T12:23:01",{"id":246,"version":247,"summary_zh":248,"released_at":249},324337,"0.10.9.dev2","## What's Changed\r\n* feat(config): add OpenRouter as BYOK provider by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F485\r\n* feat(tui): add copy URL to clipboard button on auth screen by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F483\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.9.dev1...0.10.9.dev2","2026-02-19T10:17:48",{"id":251,"version":252,"summary_zh":253,"released_at":254},324338,"0.10.9.dev1","## What's Changed\r\n* refactor(utils): add aiofiles_open_text helper for UTF-8 encoding by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F481\r\n* feat(agents): rewrite export agent as stage-by-stage execution prompt by @scottfrasso in https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fpull\u002F482\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fshotgun-sh\u002Fshotgun\u002Fcompare\u002F0.10.8...0.10.9.dev1","2026-02-18T13:48:49"]