[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"tool-swark-io--swark":3,"similar-swark-io--swark":162},{"id":4,"github_repo":5,"name":6,"description_en":7,"description_zh":8,"ai_summary_zh":8,"readme_en":9,"readme_zh":10,"quickstart_zh":11,"use_case_zh":12,"hero_image_url":13,"owner_login":14,"owner_name":15,"owner_avatar_url":16,"owner_bio":17,"owner_company":18,"owner_location":18,"owner_email":19,"owner_twitter":18,"owner_website":20,"owner_url":21,"languages":22,"stars":31,"forks":32,"last_commit_at":33,"license":34,"difficulty_score":35,"env_os":36,"env_gpu":37,"env_ram":38,"env_deps":39,"category_tags":45,"github_topics":49,"view_count":57,"oss_zip_url":18,"oss_zip_packed_at":18,"status":58,"created_at":59,"updated_at":60,"faqs":61,"releases":91},9120,"swark-io\u002Fswark","swark","Create architecture diagrams from code automatically using large language models (LLMs).","Swark 是一款专为 Visual Studio Code 设计的开源扩展，能够利用大语言模型（LLM）自动从代码生成架构流程图。它主要解决了开发者在面对陌生项目、遗留代码或快速迭代的 AI 生成代码时，难以快速理清系统结构和依赖关系的痛点。通过一键生成可视化的架构图，Swark 帮助用户在几分钟内掌握代码库的全貌，有效辅助新人入职、代码审查、文档更新以及设计缺陷排查。\n\n这款工具特别适合软件工程师、技术负责人以及需要维护复杂系统的开发人员使用。其独特的技术亮点在于深度集成了 GitHub Copilot，无需额外配置 API 密钥或进行繁琐的身份验证即可直接使用，且目前支持免费层级。得益于大模型的强大理解力，Swark 天然支持所有编程语言，突破了传统可视化工具需针对特定语言逐个适配的限制。此外，它注重隐私安全，代码数据仅与 GitHub Copilot 交互，不经过其他第三方服务，并输出基于 Mermaid.js 的标准图表代码，方便用户后续灵活编辑与优化。","\u003Ch1 align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fswark.io\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets\u002Flogo\u002Fswark-logo-dark-mode.png\">\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_readme_4c2d9002404b.png\">\n      \u003Cimg alt=\"Swark logo\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_readme_4c2d9002404b.png\" width=\"30%\">\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cb>Automatic Architecture Diagrams from Code\u003C\u002Fb>\u003Cbr \u002F>\n  Free • Open Source • Powered by LLMs\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=swark.swark\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fvisual-studio-marketplace\u002Fv\u002Fswark.swark?label=Visual%20Studio%20Marketplace\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\">\n    \u003Cimg alt=\"GitHub Issues\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fswark-io\u002Fswark\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fblob\u002Fmain\u002FCONTRIBUTING.md\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-Welcome-brightgreen\" alt=\"PRs welcome!\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## Swark\n\nSwark is a VS Code extension that allows creating architecture diagrams from code automatically using large language models (LLMs).\\\nSwark is **directly integrated with GitHub Copilot**, and requires no authentication or API key.\n\n\u003Ch1 align=\"center\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_readme_ead411f9caa6.png\" width=\"85%\"\u002F>\n\u003C\u002Fh1>\n\n### Why Swark?\n\n-   🌟 **Free and Open Source**: All you need is GitHub Copilot, which is now available for free. You can review Swark’s code to understand how it works, and contribute to make it better.\n-   🌍 **Universal Language Support**: Classic code visualization solutions are deterministic and require to incrementally add support in new languages or frameworks. With Swark, all the “logic” is encapsulated within the LLM, and therefore it natively support all languages.\n-   🔑 **Seamless Integration**: Swark integrates directly with GitHub Copilot. No additional setup, authentication, or API keys required.\n-   🛡️ **Privacy First**: Your source code is shared only with GitHub Copilot — no other external APIs or providers involved.\n-   🧜‍♀️ **Mermaid.js**: Swark generates diagrams in Mermaid.js, a popular diagram-as-code framework. You can edit and refine the diagrams as needed.\n\n### Use Cases\n\n-   🔎 **Learn a New Codebase**: Instantly generate architecture diagrams to gain a high-level understanding of unfamiliar repositories. Ideal for onboarding and tackling new projects.\n-   🤖 **Review AI-Generated Code**: As AI-generated projects become more common, Swark helps you quickly visualize their structure and ensure they meet your standards.\n-   📕 **Improve Documentation**: Keep your documentation fresh and detailed with up-to-date architecture diagrams that take minutes to create.\n-   🕰️ **Understand Legacy Code**: Quickly visualize and comprehend the structure of legacy codebases, making it easier to maintain and refactor.\n-   🧩 **Spot Design Flaws**: Visualize your repo’s dependency graph to identify unwanted dependencies or areas for optimization.\n-   ✅ **Test Coverage Insights**: Include test files in Swark’s input to see test coverage at a glance and address gaps.\n\n## Requirements\n\n-   **GitHub Copilot**: Swark is integrated with GitHub Copilot to invoke LLM queries. Install it via [Visual Studio Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=GitHub.copilot). Notice that **GitHub Copilot now offers a free tier**.\n-   **[Optional] Mermaid Markdown Preview**: To preview the diagram in VS Code you can install the [Markdown Preview Mermaid Support](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=bierner.markdown-mermaid) extension. Alternatively, you can use the provided links to open it in Mermaid Live Editor.\n\n## Installation\n\nSimply install Swark via the [VS Code Extension Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=swark.swark).\n\n## How to Use\n\n1. In VS Code, open the [Command Palette](https:\u002F\u002Fcode.visualstudio.com\u002Fdocs\u002Fgetstarted\u002Fuserinterface#_command-palette) and run: **Swark: Create Architecture Diagram**.\\\n   Alternatively, you can use Swark's default keybindings: `cmd+shift+r` (Mac) or `ctrl+shift+r` (Windows).\n2. Select a folder to use in Swark's file search.\n3. Within a few seconds, a tab will open displaying your architecture diagram.\n\n\u003Ch1 align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F5b885430-d958-47a0-9daa-f64542844fba\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_readme_9b88a343d7ab.gif\" width=\"85%\" alt=\"Swark Demo\"\u002F>\u003C\u002Fa>\n\u003C\u002Fh1>\n\n### Output\n\nSwark saves its output in `swark-output` folder under your workspace root folder.\\\nOn each run, Swark creates two output files:\n\n-   **Diagram file**: Contains the diagram's Mermaid code. This file is presented when you run Swark.\\\n    Filename: `\u003Cdate>__\u003Ctime>__diagram.md`\n-   **Log file**: Contains information about the run, configuration, and files used to create the diagram. Can be used for debugging and issue reporting.\\\n    Filename: `\u003Cdate>__\u003Ctime>__log.md`\n\nFor example:\n\n```bash\nworkspace-root\n└── swark-output\n    ├── 2025-01-09__20-18-38__diagram.md\n    └── 2025-01-09__20-18-38__log.md\n```\n\n## How it Works\n\n1. **File Retrieval**: Swark retrieves code files within the chosen folder. Swark automatically adjusts the number of retrieved files to match the LLM max token limit.\n2. **Prompt Building**: Based on the retrieved files, Swark builds a prompt to generate an architecture diagram. The code files are included in the prompt, together with instructions on how to build the diagram.\n3. **LLM Request**: Swark invokes LLM request to GitHub Copilot via VS Code [Language Model API](https:\u002F\u002Fcode.visualstudio.com\u002Fapi\u002Fextension-guides\u002Flanguage-model).\n4. **Diagram Preview**: Upon a successful response, the diagram is presented. This is done by creating a markdown file that includes the diagram in [Mermaid](https:\u002F\u002Fmermaid.js.org\u002F) syntax and previewing it.\n\n### Code Access and File Sharing\n\nIt's important to note that source code is **only shared with GitHub Copilot**, and with no other external APIs or providers.\n\n## Extension Settings\n\nThis extension contributes the following settings:\n\n| Setting                  | Description                                                                                                                              |\n| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |\n| `swark.maxFiles`         | Max number of files to read.\u003Cbr>The number of files read is also affected by the LLM max token limit.                                    |\n| `swark.fileExtensions`   | List of file extensions to include in search.                                                                                            |\n| `swark.excludePatterns`  | List of glob patterns to exclude from file search.\u003Cbr>Defaults include: `**\u002F.*` for hidden files, `**\u002Fnode_modules\u002F**` for node modules. |\n| `swark.languageModel`    | Language model to use for diagram generation.                                                                                            |\n| `swark.fixMermaidCycles` | Automatically fix cycles in the generated Mermaid diagram to prevent rendering failures.                                                 |\n\n## Release Notes\n\nSee [CHANGELOG.md](CHANGELOG.md).\n\n## Contributing\n\nSwark welcomes community contributions.\nPlease see our [Contribution Guide](CONTRIBUTING.md) for details on how to contribute.\n\n## Privacy Notice\n\nThis extension collects telemetry data to help improve the product experience. The data collected includes:\n\n-   Extension activation and usage events\n-   Selected model information\n-   Number of files processed and prompt length\n-   LLM response time\n-   Error events\n\nNo source code, file contents, or personal information is ever included in the telemetry data.\n\nWe use [@vscode\u002Fextension-telemetry](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-extension-telemetry) module to collect this data. The data is sent to Azure Application Insights and is used solely to improve Swark's functionality and user experience.\n\nYou can disable telemetry collection by setting `\"telemetry.telemetryLevel\": \"off\"` in your VS Code settings.\n\n## License\n\nSwark is licensed under the [GNU Affero General Public License v3.0](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fblob\u002Fmain\u002FLICENSE)\n","\u003Ch1 align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fswark.io\">\n    \u003Cpicture>\n      \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets\u002Flogo\u002Fswark-logo-dark-mode.png\">\n      \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_readme_4c2d9002404b.png\">\n      \u003Cimg alt=\"Swark logo\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_readme_4c2d9002404b.png\" width=\"30%\">\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cb>从代码自动生成架构图\u003C\u002Fb>\u003Cbr \u002F>\n  免费 • 开源 • 基于大语言模型\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=swark.swark\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fvisual-studio-marketplace\u002Fv\u002Fswark.swark?label=Visual%20Studio%20Marketplace\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\">\n    \u003Cimg alt=\"GitHub Issues\" src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002Fswark-io\u002Fswark\" \u002F>\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fblob\u002Fmain\u002FCONTRIBUTING.md\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPRs-Welcome-brightgreen\" alt=\"欢迎提交 Pull Request!\" \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## Swark\n\nSwark 是一款 VS Code 扩展，能够利用大型语言模型（LLMs）自动从代码中生成架构图。\\\nSwark **与 GitHub Copilot 直接集成**，无需任何身份验证或 API 密钥。\n\n\u003Ch1 align=\"center\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_readme_ead411f9caa6.png\" width=\"85%\"\u002F>\n\u003C\u002Fh1>\n\n### 为什么选择 Swark？\n\n-   🌟 **免费且开源**：你只需要 GitHub Copilot，而现在它已经可以免费使用。你可以查看 Swark 的源码来了解其工作原理，并为改进它做出贡献。\n-   🌍 **支持所有编程语言**：传统的代码可视化工具通常是基于规则的，需要逐步添加对新语言或框架的支持。而 Swark 将所有“逻辑”封装在 LLM 中，因此天然支持所有语言。\n-   🔑 **无缝集成**：Swark 直接与 GitHub Copilot 集成，无需额外设置、认证或 API 密钥。\n-   🛡️ **隐私至上**：你的源代码仅会共享给 GitHub Copilot——不会涉及任何其他外部 API 或服务提供商。\n-   🧜‍♀️ **Mermaid.js 格式**：Swark 生成的图表采用 Mermaid.js 格式，这是一种流行的“代码即图表”框架。你可以根据需要编辑和优化这些图表。\n\n### 使用场景\n\n-   🔎 **学习新代码库**：快速生成架构图，帮助你从宏观层面理解不熟悉的代码仓库。非常适合新人入职和接手新项目。\n-   🤖 **审查 AI 生成的代码**：随着 AI 生成代码的普及，Swark 可以帮助你快速可视化其结构，确保符合预期标准。\n-   📕 **完善文档**：通过几分钟内生成的最新架构图，保持文档的新鲜度和详细性。\n-   🕰️ **理解遗留代码**：快速可视化并理解旧代码库的结构，便于维护和重构。\n-   🧩 **发现设计缺陷**：通过可视化代码库的依赖关系图，识别不必要的依赖或可优化的部分。\n-   ✅ **测试覆盖率分析**：将测试文件纳入 Swark 的输入，一目了然地查看测试覆盖率并填补空白。\n\n## 系统要求\n\n-   **GitHub Copilot**：Swark 与 GitHub Copilot 集成，用于调用 LLM 查询。可通过 [Visual Studio Marketplace](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=GitHub.copilot) 安装。请注意，**GitHub Copilot 现已提供免费层级**。\n-   **[可选] Mermaid Markdown 预览**：若要在 VS Code 中预览图表，可安装 [Markdown Preview Mermaid Support](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=bierner.markdown-mermaid) 扩展。或者，也可以使用提供的链接在 Mermaid Live Editor 中打开。\n\n## 安装\n\n只需通过 [VS Code 扩展市场](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=swark.swark) 安装 Swark。\n\n## 使用方法\n\n1. 在 VS Code 中，打开 [命令面板](https:\u002F\u002Fcode.visualstudio.com\u002Fdocs\u002Fgetstarted\u002Fuserinterface#_command-palette)，运行：**Swark: 创建架构图**。\\\n   或者，你也可以使用 Swark 的默认快捷键：`cmd+shift+r`（Mac）或 `ctrl+shift+r`（Windows）。\n2. 选择一个文件夹作为 Swark 的文件搜索范围。\n3. 几秒钟后，会打开一个标签页，显示你的架构图。\n\n\u003Ch1 align=\"center\">\n    \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F5b885430-d958-47a0-9daa-f64542844fba\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_readme_9b88a343d7ab.gif\" width=\"85%\" alt=\"Swark 演示\"\u002F>\u003C\u002Fa>\n\u003C\u002Fh1>\n\n### 输出\n\nSwark 会将输出保存到工作区根目录下的 `swark-output` 文件夹中。\\\n每次运行时，Swark 会生成两个文件：\n\n-   **图表文件**：包含 Mermaid 代码的图表文件。这是你在运行 Swark 时看到的文件。\\\n    文件名：`\u003C日期>__\u003C时间>__diagram.md`\n-   **日志文件**：包含本次运行的信息、配置以及用于生成图表的文件列表。可用于调试和问题报告。\\\n    文件名：`\u003C日期>__\u003C时间>__log.md`\n\n例如：\n\n```bash\nworkspace-root\n└── swark-output\n    ├── 2025-01-09__20-18-38__diagram.md\n    └── 2025-01-09__20-18-38__log.md\n```\n\n## 工作原理\n\n1. **文件检索**：Swark 会检索所选文件夹中的代码文件。Swark 会自动调整检索的文件数量，以适应 LLM 的最大 token 限制。\n2. **构建提示词**：根据检索到的文件，Swark 构建用于生成架构图的提示词。提示词中会包含代码文件以及如何构建图表的说明。\n3. **LLM 请求**：Swark 通过 VS Code 的 [语言模型 API](https:\u002F\u002Fcode.visualstudio.com\u002Fapi\u002Fextension-guides\u002Flanguage-model) 向 GitHub Copilot 发起 LLM 请求。\n4. **图表预览**：成功响应后，图表会被呈现出来。实现方式是创建一个包含 Mermaid 语法的 Markdown 文件，并进行预览。\n\n### 源码访问与文件共享\n\n需要注意的是，源代码**仅会共享给 GitHub Copilot**，不会与其他任何外部 API 或服务提供商共享。\n\n## 扩展设置\n\n此扩展提供了以下设置：\n\n| 设置                  | 描述                                                                                                                              |\n| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |\n| `swark.maxFiles`         | 最大读取文件数。\u003Cbr>实际读取的文件数量还受 LLM 最大 token 限制的影响。                                    |\n| `swark.fileExtensions`   | 搜索时要包含的文件扩展名列表。                                                                                            |\n| `swark.excludePatterns`  | 用于从文件搜索中排除的 glob 模式列表。\u003Cbr>默认包括：`**\u002F.*` 用于隐藏文件，`**\u002Fnode_modules\u002F**` 用于 node 模块。 |\n| `swark.languageModel`    | 用于生成图表的语言模型。                                                                                            |\n| `swark.fixMermaidCycles` | 自动修复生成的 Mermaid 图表中的循环，以防止渲染失败。                                                 |\n\n## 发行说明\n\n请参阅 [CHANGELOG.md](CHANGELOG.md)。\n\n## 贡献\n\nSwark 欢迎社区贡献。\n有关如何贡献的详细信息，请参阅我们的 [贡献指南](CONTRIBUTING.md)。\n\n## 隐私声明\n\n此扩展会收集遥测数据，以帮助改善产品体验。收集的数据包括：\n\n- 扩展激活和使用事件\n- 所选模型信息\n- 处理的文件数量和提示长度\n- LLM 响应时间\n- 错误事件\n\n遥测数据中绝不会包含源代码、文件内容或个人信息。\n\n我们使用 [@vscode\u002Fextension-telemetry](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fvscode-extension-telemetry) 模块来收集这些数据。数据将发送到 Azure Application Insights，仅用于改进 Swark 的功能和用户体验。\n\n您可以通过在 VS Code 设置中将 `\"telemetry.telemetryLevel\": \"off\"` 设置为关闭来禁用遥测数据收集。\n\n## 许可证\n\nSwark 根据 [GNU Affero 通用公共许可证 v3.0](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fblob\u002Fmain\u002FLICENSE) 进行许可。","# Swark 快速上手指南\n\nSwark 是一款免费的 VS Code 开源扩展，能够利用大语言模型（LLM）自动从代码生成架构流程图。它直接集成 GitHub Copilot，无需额外配置 API Key，支持所有编程语言。\n\n## 环境准备\n\n在开始使用前，请确保满足以下条件：\n\n1.  **编辑器**：已安装 [Visual Studio Code](https:\u002F\u002Fcode.visualstudio.com\u002F)。\n2.  **核心依赖**：必须安装 **GitHub Copilot** 扩展。\n    *   Swark 通过 VS Code 的 Language Model API 调用 Copilot，因此需要登录 GitHub 账号并激活 Copilot 服务（目前 Copilot 提供免费层级）。\n    *   安装地址：[Visual Studio Marketplace - GitHub Copilot](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=GitHub.copilot)\n3.  **可选依赖（推荐）**：为了在 VS Code 内直接预览生成的图表，建议安装 **Markdown Preview Mermaid Support** 扩展。\n    *   若不安装此扩展，生成的文件可通过链接在 Mermaid Live Editor 网页版中查看。\n    *   安装地址：[Visual Studio Marketplace - Markdown Preview Mermaid Support](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=bierner.markdown-mermaid)\n\n## 安装步骤\n\n通过 VS Code 扩展市场直接安装：\n\n1.  打开 VS Code，点击左侧活动栏的 **扩展 (Extensions)** 图标（或按下 `Ctrl+Shift+X` \u002F `Cmd+Shift+X`）。\n2.  在搜索框中输入 `Swark`。\n3.  找到由 `swark` 发布的扩展，点击 **安装 (Install)** 按钮。\n4.  或者，直接访问 [Swark 扩展页面](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=swark.swark) 点击安装。\n\n## 基本使用\n\n安装完成后，只需几步即可生成架构图：\n\n1.  **打开项目**：在 VS Code 中打开包含源代码的文件夹。\n2.  **启动命令**：\n    *   打开命令面板：按下 `Ctrl+Shift+P` (Windows\u002FLinux) 或 `Cmd+Shift+P` (Mac)。\n    *   输入并选择：`Swark: Create Architecture Diagram`。\n    *   **快捷键方式**：直接使用默认快捷键 `Ctrl+Shift+R` (Windows\u002FLinux) 或 `Cmd+Shift+R` (Mac)。\n3.  **选择范围**：在弹出的文件选择器中，确认或选择要分析的代码文件夹。\n4.  **查看结果**：\n    *   等待几秒钟，VS Code 将自动打开一个新标签页，显示生成的 Mermaid 架构流程图。\n    *   如果安装了 Mermaid 预览扩展，你将直接看到渲染后的图形；否则将看到 Mermaid 代码及查看链接。\n\n**输出说明**：\n生成的文件会自动保存在工作区根目录下的 `swark-output` 文件夹中，包含：\n*   `\u003C日期>__\u003C时间>__diagram.md`：包含架构图代码的文件。\n*   `\u003C日期>__\u003C时间>__log.md`：包含运行日志、配置及所用文件列表，便于调试。\n\n> **隐私提示**：您的源代码仅通过官方渠道发送给 GitHub Copilot 进行处理，Swark 不会将代码发送至其他任何第三方 API 或服务提供商。","资深后端工程师李明刚接手一个由前团队遗留的、缺乏文档的复杂微服务项目，急需在两天内理清模块间的调用关系以修复一个关键的生产环境故障。\n\n### 没有 swark 时\n- **人工梳理耗时极长**：面对数十个源文件，只能靠肉眼阅读代码和搜索引用来脑补架构，花费数小时仍难以构建完整的全局视图。\n- **理解偏差风险高**：由于缺乏可视化参照，极易误解深层嵌套的依赖关系，导致修复方案可能引入新的耦合问题。\n- **文档更新滞后**：手动绘制架构图不仅繁琐，且一旦代码变动，图表立刻过时，团队不敢将其作为正式参考依据。\n- **隐私合规顾虑**：不敢随意将核心业务代码上传至第三方在线绘图工具进行分析，担心敏感逻辑泄露。\n\n### 使用 swark 后\n- **秒级生成全景图**：直接在 VS Code 中一键运行，swark 利用 GitHub Copilot 自动分析全量代码，瞬间输出基于 Mermaid.js 的精准架构流程图。\n- **依赖关系一目了然**：生成的图表清晰展示了服务间的数据流向和潜在循环依赖，帮助李明迅速定位到故障根源所在的异常调用链。\n- **图表即代码易维护**：输出的 Mermaid 代码可直接嵌入项目文档，后续代码迭代时只需重新运行 swark 即可同步更新，确保持续准确。\n- **企业级安全保障**：整个过程数据仅流经受信任的 GitHub Copilot 接口，无需配置额外 API 密钥，完美符合公司的代码隐私合规要求。\n\nswark 将原本需要数天的人工逆向工程工作压缩至分钟级，让开发者能专注于逻辑修复而非图表绘制，极大提升了遗留系统的维护效率。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fswark-io_swark_fc6d7fe7.png","swark-io","swark.io","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fswark-io_386986d5.png","AI-Powered Software Architect",null,"contact@swark.io","https:\u002F\u002Fswark.io","https:\u002F\u002Fgithub.com\u002Fswark-io",[23,27],{"name":24,"color":25,"percentage":26},"TypeScript","#3178c6",99.7,{"name":28,"color":29,"percentage":30},"JavaScript","#f1e05a",0.3,1659,103,"2026-04-18T07:22:05","AGPL-3.0",1,"Windows, macOS, Linux","无本地 GPU 需求（基于云端 GitHub Copilot API）","未说明",{"notes":40,"python":38,"dependencies":41},"该工具是 VS Code 扩展，无需本地部署 LLM 或配置 Python 环境。核心依赖是安装并登录 GitHub Copilot（目前有免费层级），代码分析由 Copilot 云端完成。可选安装 Mermaid 预览插件以在编辑器内直接查看图表，否则需使用链接在浏览器中查看。",[42,43,44],"Visual Studio Code","GitHub Copilot 扩展","Markdown Preview Mermaid Support (可选)",[46,47,48],"插件","开发框架","语言模型",[50,51,52,53,54,55,56],"architecture","llm","system-design","visualization","vscode-extension","language-model","developer-tools",2,"ready","2026-03-27T02:49:30.150509","2026-04-18T22:35:24.651428",[62,67,72,77,82,87],{"id":63,"question_zh":64,"answer_zh":65,"source_url":66},40929,"生成的 Mermaid 图表出现循环错误（Setting Node as parent of Node would create a cycle）怎么办？","该错误通常发生在父节点和子节点名称相同时。解决方法包括：\n1. 重新运行 Swark 以生成新的结果。\n2. 手动编辑图表代码，重命名父节点以确保名称唯一。\n3. 尝试在 Copilot 聊天中直接切换模型（例如切换到 Sonnet），有时不同模型的输出能避免此问题。","https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F7",{"id":68,"question_zh":69,"answer_zh":70,"source_url":71},40930,"Swark 是否支持生成 C4 架构图？为什么我的图表层级较少？","目前 Swark 并未被专门指令生成标准的 C4 图，而是侧重于增加图表深度，通常生成包含 2 个层级的图表。未生成更复杂 C4 图的主要原因是 LLM 的 Token 限制。建议尝试使用上下文窗口更大的模型（如 Claude，支持 200k tokens）：\n1. 在 Copilot 菜单中选择 Claude 模型并至少使用一次。\n2. 或者在设置中更改 `swark.languageModel` 配置。","https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F12",{"id":73,"question_zh":74,"answer_zh":75,"source_url":76},40931,"如何在 VS Code 中查看生成的 Mermaid 图表而不安装额外插件？","Swark 已集成直接链接功能。生成的输出中包含一个指向 Mermaid Live Editor 的链接，点击即可直接在浏览器中可视化图表，无需在 VS Code 中安装额外的 Mermaid 扩展或手动复制粘贴代码。链接格式通常为 `https:\u002F\u002Fmermaid.live\u002Fedit#pako:\u003Ccompressed_payload>`。","https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F4",{"id":78,"question_zh":79,"answer_zh":80,"source_url":81},40932,"如何配置 Swark 使用特定的语言模型（如 Gemini 或 Claude）？","VS Code 的语言模型 API 支持多种模型。用户可以通过以下方式选择偏好模型：\n1. 在 VS Code 设置中添加或修改配置项 `swark.languageModelFamily`。\n2. 或者在使用时，通过 GitHub Copilot 的菜单界面直接切换当前会话使用的模型（例如从默认模型切换到 `claude-3.5-sonnet` 或 `gemini-1.5-pro`）。","https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F2",{"id":83,"question_zh":84,"answer_zh":85,"source_url":86},40933,"Swark 支持分析哪些文件类型？如何添加自定义文件扩展名（如 .sql, .cpy）？","Swark 默认支持常见代码文件，但用户可以通过配置扩展支持其他类型（如 .sql, .sh, .cpy 等）。\n操作方法：在 VS Code 设置中修改 `swark.fileExtensions` 配置项，添加所需的文件扩展名列表。\n注意：由于提示词是专为架构 diagram 设计的，对于 SQL 或 Shell 脚本等非典型架构文件，生成的图表效果可能因内容而异。","https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F30",{"id":88,"question_zh":89,"answer_zh":90,"source_url":71},40934,"在使用 VS 2022 创建的 Blazor Web App 模板上运行 Swark 时报错怎么办？","如果在特定模板（如 Blazor Web App）上遇到 \"Command resulted in an error\"，这可能与项目结构或 LLM 处理复杂度有关。\n建议尝试：\n1. 确保已正确安装 VS Code 扩展并重启。\n2. 检查项目路径是否正确。\n3. 如果问题依旧，可能是由于模型 Token 限制导致无法处理整个项目，尝试缩小分析范围或切换至具有更大上下文窗口的模型（如 Claude）。",[92,97,102,107,112,117,122,127,132,137,142,147,152,157],{"id":93,"version":94,"summary_zh":95,"released_at":96},324482,"v1.4.3","## [1.4.3](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.4.2...v1.4.3) - 2025-03-21\n\n### 新增\n\n-   支持 `lua` 和 `dart` 编程语言。\n-   支持 Gemini 2.0 Flash 语言模型。","2025-03-21T09:51:01",{"id":98,"version":99,"summary_zh":100,"released_at":101},324483,"v1.4.2","## [1.4.2](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.4.0...v1.4.2) - 2025-02-01\n\n### 新增\n\n-   在可用模型中添加“OpenAI o3-mini”：\n\u003Cimg width=\"1458\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fe59b8eaa-95a4-42c4-a216-8555fbeef685\" \u002F>\n\n\n### 变更\n\n-   更新输出内容，增加使用说明：\n![image](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdd7b5d85-47ee-4eac-a13d-9695a658180c)\n\n","2025-02-01T19:15:28",{"id":103,"version":104,"summary_zh":105,"released_at":106},324484,"v1.4.0","## [1.4.0](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.3.10...v1.4.0) - 2025-01-18\n\n### 新增功能\n\n- 增加了自动修复 Mermaid 循环图的功能，以防止图表渲染问题（[#7](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F7)）：\n\n![](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F9611e441-db89-42c0-a5fc-f2bcf0c34809)\n\n- 在 Swark 的输出中添加了切换已配置语言模型的链接：\n![](https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F18320fd1-31e5-42b3-a350-c8d9a0cecca4)","2025-01-18T11:38:42",{"id":108,"version":109,"summary_zh":110,"released_at":111},324485,"v1.3.10","## [1.3.10](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.3.9...v1.3.10) - 2025-01-14\n\n### 变更\n\n-   将 GitHub Copilot 扩展设置为依赖项，因为 Swark 的正常运行需要它。","2025-01-14T20:36:37",{"id":113,"version":114,"summary_zh":115,"released_at":116},324486,"v1.3.9","## [1.3.9](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.3.8...v1.3.9) - 2025-01-12\n\n### 新增\n\n-   添加对 Mermaid 图中环的检查 ([#7](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F7))","2025-01-12T21:39:45",{"id":118,"version":119,"summary_zh":120,"released_at":121},324487,"v1.3.8","## [1.3.8](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.3.7...v1.3.8) - 2025-01-10\n\n### 变更\n\n- 更新了 README.md 的多个部分。\n- 通过从包中移除 `demo.gif` 来减小扩展体积。\n- 当在所选文件夹中未找到任何文件时，抛出错误，并提示用户更新 `swark.fileExtensions` 设置。","2025-01-10T18:25:50",{"id":123,"version":124,"summary_zh":125,"released_at":126},324488,"v1.3.7","## [1.3.7](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.3.6...v1.3.7) - 2025-01-09\n\n### 变更\n\n- 将默认模型从 `claude-3.5-sonnet` 更改为 `gpt-4o`，原因是许多用户无法使用 Claude 模型。","2025-01-09T18:21:54",{"id":128,"version":129,"summary_zh":130,"released_at":131},324489,"v1.3.6","\n## [1.3.6](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.3.5...v1.3.6) - 2025-01-08\n\n### 修复\n\n-   从 LLM 中提取 Mermaid 块，以确保图表正确渲染并创建链接。（[#8](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F8)）\n","2025-01-08T21:37:26",{"id":133,"version":134,"summary_zh":135,"released_at":136},324490,"v1.3.5","## [1.3.5](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.3.4...v1.3.5) - 2025-01-07\n\n### 变更\n\n- 改进无可用语言模型时的错误提示信息：\n\u003Cimg width=\"561\" alt=\"截图 2025-01-07 20:07:34\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F32fe1adc-9a4d-4f40-a695-a70d3536b21c\" \u002F>\n\n- 当配置的模型不可用时，默认使用 `gpt-4o`：\n\u003Cimg width=\"572\" alt=\"截图 2025-01-07 20:05:51\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F6d607e51-89b1-4610-bf4c-5a1db26a6a08\" \u002F>\n\n- 添加对可用模型的遥测功能。","2025-01-07T18:20:23",{"id":138,"version":139,"summary_zh":140,"released_at":141},324491,"v1.3.4","## [1.3.4](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.3.0...v1.3.4) - 2024-12-31\n\n### 变更\n\n-   在 VS Code 中提示 LLM 时显示进度。","2024-12-31T15:25:48",{"id":143,"version":144,"summary_zh":145,"released_at":146},324492,"v1.3.0","## [1.3.0](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fcompare\u002Fv1.2.0...v1.3.0) - 2024-12-26\r\n\r\n### Added\r\n\r\n-   Add extension deactivation telemetry.\r\n-   Add telemetry of programming languages used.\r\n-   Write diagram to file in path `workspace\u002Fswark-output\u002Ftimestamp__diagram.md`, e.g. `swark\u002Fswark-output\u002F2024-12-25__20-25-34__diagram.md`.\r\n-   Write log file that includes the run information and files used. Path: `workspace\u002Fswark-output\u002Ftimestamp__log.md`:\r\n\u003Cimg width=\"2672\" alt=\"Screenshot 2024-12-26 at 12 38 13\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fff922b4e-e15c-4482-b0b7-e14d0c8d70f1\" \u002F>\r\n","2024-12-26T10:40:33",{"id":148,"version":149,"summary_zh":150,"released_at":151},324493,"v1.2.0","### Added\r\n\r\n-   Generate links to Mermaid Live Editor to view or edit the diagram. ([#4](https:\u002F\u002Fgithub.com\u002Fswark-io\u002Fswark\u002Fissues\u002F4))\r\n\r\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F96ad620f-cdea-433b-b39e-a2953e3e5def\r\n\r\n### Changed\r\n\r\n-   Set default model to `claude-3.5-sonnet`.","2024-12-23T20:25:42",{"id":153,"version":154,"summary_zh":155,"released_at":156},324494,"v1.1.1","### Fixed\r\n\r\n-   Fixed duplicate logo rendering on Visual Studio Marketplace (both light and dark mode logos showed).","2024-12-22T18:58:58",{"id":158,"version":159,"summary_zh":160,"released_at":161},324495,"v1.1.0","### Added\r\n\r\n-   Support additional language models: `gpt-4o`, `openai-o1`, `claude-3.5-sonnet`.\r\n-   Users can now configure the language model to use via the `swark.languageModel` setting.\r\n\r\n### Changed\r\n\r\n-   Modify prompt to not generate additional text besides the architecture diagram.","2024-12-22T13:10:29",[163,175,183,191,199,207],{"id":164,"name":165,"github_repo":166,"description_zh":167,"stars":168,"difficulty_score":169,"last_commit_at":170,"category_tags":171,"status":58},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",[172,47,173,174],"Agent","图像","数据工具",{"id":176,"name":177,"github_repo":178,"description_zh":179,"stars":180,"difficulty_score":169,"last_commit_at":181,"category_tags":182,"status":58},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",[47,173,172],{"id":184,"name":185,"github_repo":186,"description_zh":187,"stars":188,"difficulty_score":57,"last_commit_at":189,"category_tags":190,"status":58},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 真正成长为懂上",160015,"2026-04-18T11:30:52",[47,172,48],{"id":192,"name":193,"github_repo":194,"description_zh":195,"stars":196,"difficulty_score":35,"last_commit_at":197,"category_tags":198,"status":58},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,"2026-04-16T14:50:03",[172,46],{"id":200,"name":201,"github_repo":202,"description_zh":203,"stars":204,"difficulty_score":57,"last_commit_at":205,"category_tags":206,"status":58},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[47,173,172],{"id":208,"name":209,"github_repo":210,"description_zh":211,"stars":212,"difficulty_score":57,"last_commit_at":213,"category_tags":214,"status":58},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,"2026-04-10T01:20:03",[46,172,173,47]]