[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-bgauryy--octocode-mcp":3,"tool-bgauryy--octocode-mcp":61},[4,18,26,36,44,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":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",157379,2,"2026-04-15T23:32:42",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},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",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},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",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":73,"owner_location":76,"owner_email":73,"owner_twitter":73,"owner_website":73,"owner_url":77,"languages":78,"stars":91,"forks":92,"last_commit_at":93,"license":94,"difficulty_score":32,"env_os":95,"env_gpu":95,"env_ram":95,"env_deps":96,"category_tags":101,"github_topics":102,"view_count":32,"oss_zip_url":73,"oss_zip_packed_at":73,"status":17,"created_at":123,"updated_at":124,"faqs":125,"releases":156},7877,"bgauryy\u002Foctocode-mcp","octocode-mcp","MCP server for semantic code research and context generation on real-time using LLM patterns | Search naturally across public & private repos based on your permissions | Transform any accessible codebase\u002Fs into AI-optimized knowledge on simple and complex flows | Find real implementations and live docs from anywhere","Octocode-mcp 是一款专为 AI 辅助编程设计的开源工具，旨在让 AI 助手具备资深工程师的代码研究与上下文理解能力。它通过 MCP（模型上下文协议）服务器，将 AI 直接连接到 GitHub、GitLab 仓库及本地代码库，支持基于权限的自然语言搜索、实时实现查找以及动态文档生成。\n\n该工具主要解决了 AI 在开发过程中因缺乏深层代码上下文而导致的“猜测式”回答问题。无论是梳理复杂的项目流程，还是定位具体的函数实现，Octocode-mcp 都能帮助 AI 从海量代码中提取精准知识，从而提供有据可依的建议。\n\n它非常适合开发者、技术团队以及希望提升 AI 编程效率的研究人员使用。其独特亮点在于集成了 LSP（语言服务器协议）智能，使 AI 能像编译器一样理解代码结构，支持跳转定义、查找引用和分析调用层级。此外，它还采用模块化的\"Agent Skills\"机制，提供包括代码审计、RFC 文档生成、PR 审查及提示词优化在内的多种专业技能，让用户能根据需求灵活扩展 AI 的能力边界，真正实现从“盲目猜测”到“精准认知”的开发模式转变。","# Octocode: Research Driven Development for AI\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbgauryy_octocode-mcp_readme_15f61f177d13.png\" width=\"400px\" alt=\"Octocode Logo\">\n  \n  \u003Ch3>Stop Guessing. Start Knowing.\u003C\u002Fh3>\n  \u003Cp>\u003Cstrong>Empower your AI assistant with the skills of a Senior Staff Engineer.\u003C\u002Fstrong>\u003C\u002Fp>\n  \n  \u003Cp>\n    \u003Ca href=\"https:\u002F\u002Foctocode.ai\">\u003Cstrong>octocode.ai\u003C\u002Fstrong>\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n---\n\n## Installation\n\n> **Prerequisites**: GitHub authentication required. See [Authentication Setup](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-mcp\u002Fdocs\u002FAUTHENTICATION_SETUP.md).\n\n### Recommended: Octocode CLI\n\n```bash\nnpx octocode-cli\n```\n\nInteractive setup wizard with GitHub OAuth, MCP server installation, and skills marketplace.\n\n### Alternative Methods\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>One-Click Install (Cursor)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n[\u003Cimg src=\"https:\u002F\u002Fcursor.com\u002Fdeeplink\u002Fmcp-install-dark.svg\" alt=\"Install in Cursor\">](https:\u002F\u002Fcursor.com\u002Fen\u002Finstall-mcp?name=octocode&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJvY3RvY29kZS1tY3BAbGF0ZXN0Il19)\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Manual MCP Configuration\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nAdd to your MCP configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"octocode\": {\n      \"command\": \"npx\",\n      \"args\": [\"octocode-mcp@latest\"]\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Research Skill (Direct Install)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```bash\nnpx add-skill https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-research\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## MCP Server\n\nThe [Octocode MCP Server](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fpackages\u002Foctocode-mcp) connects your AI assistant to code:\n\n- **GitHub & GitLab**: Search repositories, find usage patterns, read implementations, explore PRs\n- **Local Tools**: Search code, browse directories, find files in your local codebase\n- **LSP Intelligence**: Go to Definition, Find References, Call Hierarchy -- compiler-level understanding\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fde8d14c0-2ead-46ed-895e-09144c9b5071\n\n---\n\n## Skills\n\n> [Agent Skills](https:\u002F\u002Fagentskills.io\u002Fwhat-are-skills) are a lightweight, open format for extending AI agent capabilities.\n> Skills index: [skills\u002FREADME.md](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fskills\u002FREADME.md)\n\n| Skill | What it does |\n|-------|--------------|\n| [**Researcher**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-researcher) | Code search & exploration — local LSP + external (GitHub, npm\u002FPyPI) |\n| [**Research**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-research) | Multi-phase research with sessions, checkpoints, state persistence |\n| [**Engineer**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-engineer) | Understand, write, analyze, audit code — AST + LSP + dependency graph |\n| [**Plan**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-plan) | Evidence-based planning: Understand > Research > Plan > Implement |\n| [**RFC Generator**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-rfc-generator) | Formal technical decisions with alternatives, trade-offs, and recommendations |\n| [**PR Reviewer**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-pull-request-reviewer) | PR & local code review across 7 domains with LSP flow tracing |\n| [**Roast**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-roast) | Brutal code critique with file:line citations and severity levels |\n| [**Prompt Optimizer**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-prompt-optimizer) | Turn weak prompts into enforceable agent protocols |\n| [**Doc Writer**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-documentation-writer) | 6-phase pipeline producing 16+ validated docs |\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F5b630763-2dee-4c2d-b5c1-6335396723ec\n\n---\n\n## Documentation\n\nFor the full documentation index, start here:\n[docs\u002FREADME.md](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fdocs\u002FREADME.md)\n\nRecommended quick links:\n- [Authentication Setup](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-mcp\u002Fdocs\u002FAUTHENTICATION_SETUP.md)\n- [Configuration Reference](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fdocs\u002FCONFIGURATION_REFERENCE.md)\n- [Local Tools + LSP Reference](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-mcp\u002Fdocs\u002FLOCAL_TOOLS_REFERENCE.md)\n- [CLI Skills Guide](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-cli\u002Fdocs\u002FSKILLS_GUIDE.md)\n- [Skills Index](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fskills\u002FREADME.md)\n- [Troubleshooting](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fdocs\u002FTROUBLESHOOTING.md)\n\n### The Manifest\n\n**\"Code is Truth, but Context is the Map.\"** -- Read the [Manifest for Research Driven Development](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002FMANIFEST.md) to understand the philosophy behind Octocode.\n\n---\n\n### Contributing\n\nSee the [Development Guide](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fdocs\u002FDEVELOPMENT_GUIDE.md) for monorepo setup, testing, and contribution guidelines.\n\n---\n\n\u003Cdiv align=\"center\">\n  \u003Csub>Built with care for the AI Engineering Community\u003C\u002Fsub>\n\u003C\u002Fdiv>\n","# Octocode：以研究驱动的 AI 开发\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbgauryy_octocode-mcp_readme_15f61f177d13.png\" width=\"400px\" alt=\"Octocode Logo\">\n  \n  \u003Ch3>停止猜测，开始洞察。\u003C\u002Fh3>\n  \u003Cp>\u003Cstrong>用资深技术专家的能力赋能你的 AI 助手。\u003C\u002Fstrong>\u003C\u002Fp>\n  \n  \u003Cp>\n    \u003Ca href=\"https:\u002F\u002Foctocode.ai\">\u003Cstrong>octocode.ai\u003C\u002Fstrong>\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n---\n\n## 安装\n\n> **先决条件**：需要 GitHub 身份验证。请参阅 [身份验证设置](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-mcp\u002Fdocs\u002FAUTHENTICATION_SETUP.md)。\n\n### 推荐：Octocode CLI\n\n```bash\nnpx octocode-cli\n```\n\n交互式设置向导，支持 GitHub OAuth、MCP 服务器安装以及技能市场。\n\n### 其他方法\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>一键安装（Cursor）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n[\u003Cimg src=\"https:\u002F\u002Fcursor.com\u002Fdeeplink\u002Fmcp-install-dark.svg\" alt=\"在 Cursor 中安装\">](https:\u002F\u002Fcursor.com\u002Fen\u002Finstall-mcp?name=octocode&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJvY3RvY29kZS1tY3BAbGF0ZXN0Il19)\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>手动 MCP 配置\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n将以下内容添加到你的 MCP 配置文件中：\n\n```json\n{\n  \"mcpServers\": {\n    \"octocode\": {\n      \"command\": \"npx\",\n      \"args\": [\"octocode-mcp@latest\"]\n    }\n  }\n}\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>研究技能（直接安装）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n```bash\nnpx add-skill https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-research\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## MCP 服务器\n\n[Octocode MCP 服务器](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fpackages\u002Foctocode-mcp) 将你的 AI 助手与代码连接起来：\n\n- **GitHub 和 GitLab**：搜索仓库、查找使用模式、阅读实现、探索 PR\n- **本地工具**：搜索代码、浏览目录、在本地代码库中查找文件\n- **LSP 智能**：跳转到定义、查找引用、调用层次结构——具备编译器级别的理解\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fde8d14c0-2ead-46ed-895e-09144c9b5071\n\n---\n\n## 技能\n\n> [Agent Skills](https:\u002F\u002Fagentskills.io\u002Fwhat-are-skills) 是一种轻量级、开放的格式，用于扩展 AI 代理的能力。\n> 技能索引：[skills\u002FREADME.md](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fskills\u002FREADME.md)\n\n| 技能 | 功能 |\n|-------|--------------|\n| [**研究员**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-researcher) | 代码搜索与探索——本地 LSP + 外部（GitHub、npm\u002FPyPI）|\n| [**研究**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-research) | 多阶段研究，支持会话、检查点和状态持久化 |\n| [**工程师**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-engineer) | 理解、编写、分析、审计代码——AST + LSP + 依赖图 |\n| [**计划**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-plan) | 基于证据的规划：理解 > 研究 > 计划 > 实施 |\n| [**RFC 生成器**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-rfc-generator) | 形成正式的技术决策，包含备选方案、权衡及建议 |\n| [**PR 审查员**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-pull-request-reviewer) | 跨 7 个领域的 PR 和本地代码审查，支持 LSP 流程追踪 |\n| [**吐槽**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-roast) | 带有文件:行号引用和严重等级的严厉代码批评 |\n| [**提示优化器**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-prompt-optimizer) | 将薄弱的提示转化为可执行的代理协议 |\n| [**文档撰写者**](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-documentation-writer) | 6 阶段流程，生成 16+ 篇经过验证的文档 |\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F5b630763-2dee-4c2d-b5c1-6335396723ec\n\n---\n\n## 文档\n\n如需完整的文档索引，请从这里开始：\n[docs\u002FREADME.md](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fdocs\u002FREADME.md)\n\n推荐快速链接：\n- [身份验证设置](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-mcp\u002Fdocs\u002FAUTHENTICATION_SETUP.md)\n- [配置参考](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fdocs\u002FCONFIGURATION_REFERENCE.md)\n- [本地工具 + LSP 参考](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-mcp\u002Fdocs\u002FLOCAL_TOOLS_REFERENCE.md)\n- [CLI 技能指南](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-cli\u002Fdocs\u002FSKILLS_GUIDE.md)\n- [技能索引](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fskills\u002FREADME.md)\n- [故障排除](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fdocs\u002FTROUBLESHOOTING.md)\n\n### 行动纲领\n\n**“代码是真理，但上下文才是地图。”** —— 阅读 [以研究驱动开发的行动纲领](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002FMANIFEST.md)，了解 Octocode 背后的哲学。\n\n---\n\n### 贡献\n\n请参阅 [开发指南](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fdocs\u002FDEVELOPMENT_GUIDE.md)，了解 monorepo 设置、测试及贡献规范。\n\n---\n\n\u003Cdiv align=\"center\">\n  \u003Csub>为 AI 工程社区精心打造\u003C\u002Fsub>\n\u003C\u002Fdiv>","# Octocode-MCP 快速上手指南\n\nOctocode 是一款基于“研究驱动开发”理念的 AI 工具，旨在通过 MCP（Model Context Protocol）赋予 AI 助手资深工程师的能力。它支持连接 GitHub\u002FGitLab、本地代码库及 LSP（语言服务器协议），让 AI 能够真正理解代码上下文、搜索实现模式并执行深度代码审查。\n\n## 环境准备\n\n在开始之前，请确保满足以下前置条件：\n\n*   **操作系统**：支持 macOS、Linux 或 Windows (WSL)。\n*   **Node.js 环境**：需安装 Node.js (推荐 v18+) 以运行 `npx` 命令。\n*   **GitHub 账号**：必须拥有 GitHub 账号并完成认证配置。\n    *   *注意*：首次使用前，请务必阅读并配置 [GitHub 认证设置](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fpackages\u002Foctocode-mcp\u002Fdocs\u002FAUTHENTICATION_SETUP.md)，否则无法拉取远程仓库数据。\n*   **AI 编辑器**：推荐使用支持 MCP 协议的编辑器（如 Cursor、VS Code + MCP 插件等）。\n\n> **提示**：国内开发者若遇到 npm 源连接缓慢问题，建议在终端临时配置淘宝镜像源：\n> ```bash\n> export NPM_CONFIG_REGISTRY=https:\u002F\u002Fregistry.npmmirror.com\n> ```\n\n## 安装步骤\n\n你可以根据需求选择以下任意一种方式进行安装：\n\n### 方式一：使用 Octocode CLI（推荐）\n这是最完整的安装方式，包含交互式向导、GitHub OAuth 授权、MCP 服务器安装及技能市场访问。\n\n```bash\nnpx octocode-cli\n```\n运行后跟随终端提示完成配置即可。\n\n### 方式二：Cursor 编辑器一键安装\n如果你使用的是 Cursor 编辑器，可直接点击下方链接自动配置：\n\n[![Install in Cursor](https:\u002F\u002Fcursor.com\u002Fdeeplink\u002Fmcp-install-dark.svg)](https:\u002F\u002Fcursor.com\u002Fen\u002Finstall-mcp?name=octocode&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJvY3RvY29kZS1tY3BAbGF0ZXN0Il19)\n\n### 方式三：手动配置 MCP\n如果你需要自定义 MCP 配置文件（通常在 `~\u002F.mcp.json` 或编辑器的 MCP 设置中），请添加以下内容：\n\n```json\n{\n  \"mcpServers\": {\n    \"octocode\": {\n      \"command\": \"npx\",\n      \"args\": [\"octocode-mcp@latest\"]\n    }\n  }\n}\n```\n\n## 基本使用\n\n安装完成后，Octocode 将以“技能（Skills）”的形式增强你的 AI 助手。你可以在对话中直接调用这些能力。\n\n### 1. 激活技能\n在支持 MCP 的聊天窗口中，尝试询问以下类型的问题，AI 将自动调用相应的 Octocode 技能：\n\n*   **代码研究与探索**：\n    > \"帮我查找项目中所有使用 `axios` 发起 POST 请求的地方，并分析其错误处理逻辑。\"\n    > *(触发技能：Researcher \u002F Research)*\n\n*   **深度代码审查**：\n    > \"请作为资深工程师审查当前打开的文件，重点检查潜在的性能瓶颈和安全性问题。\"\n    > *(触发技能：Engineer \u002F Roast \u002F PR Reviewer)*\n\n*   **技术方案规划**：\n    > \"我需要添加一个用户登录功能，请基于现有代码结构生成一份包含权衡分析的技术实施方案 (RFC)。\"\n    > *(触发技能：Plan \u002F RFC Generator)*\n\n### 2. 核心能力示例\nOctocode 不仅仅是聊天，它能执行具体操作：\n*   **跨仓库搜索**：直接在对话中搜索 GitHub 上的开源项目实现模式。\n*   **LSP 智能感知**：利用编译器级别的理解为 AI 提供“跳转到定义”、“查找引用”和“调用层级”信息。\n*   **本地代码遍历**：安全地浏览本地目录结构和文件内容。\n\n### 3. 进阶：直接安装特定技能\n如果你只需要某项特定能力（例如仅需要代码研究功能），可以直接安装该技能包：\n\n```bash\nnpx add-skill https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Ftree\u002Fmain\u002Fskills\u002Foctocode-research\n```\n\n---\n*更多详细技能列表与配置参考，请访问官方 [Skills Index](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fblob\u002Fmain\u002Fskills\u002FREADME.md)。*","某资深后端工程师需要在周五下班前，紧急为一个遗留的微服务模块添加新的支付回调逻辑，该模块依赖多个内部私有仓库和复杂的第三方 SDK。\n\n### 没有 octocode-mcp 时\n- **盲目搜索代码**：只能在 GitHub 网页端手动翻阅多个私有仓库，难以定位具体的函数实现位置，耗时且容易遗漏关键文件。\n- **上下文断裂**：AI 助手因无法访问私有代码库和本地 LSP 信息，只能基于通用知识“幻觉”出错误的调用方式，导致生成的代码无法运行。\n- **文档滞后缺失**：现有的技术文档已半年未更新，找不到最新的接口定义和错误码说明，必须逐行阅读源码来推测业务逻辑。\n- **决策缺乏依据**：在制定技术方案时，无法快速对比历史类似功能的实现模式，只能凭经验猜测，增加了重构风险。\n\n### 使用 octocode-mcp 后\n- **语义化精准定位**：octocode-mcp 直接连接 GitHub 和本地环境，通过自然语言搜索即可跨仓库找到真实的支付回调实现案例和最新 PR 记录。\n- **实时上下文增强**：利用 LSP 智能分析，octocode-mcp 让 AI 助手具备“高级架构师”视角，准确理解本地依赖图和函数引用关系，生成可直接运行的代码。\n- **动态文档生成**：调用内置的 Doc Writer 技能，octocode-mcp 自动从最新代码中提取接口定义，即时生成包含错误码和处理流程的验证文档。\n- **证据驱动规划**：通过 Plan 和 Researcher 技能，octocode-mcp 基于现有代码库的实际模式输出技术方案，明确列出替代方案与权衡点，确保决策可靠。\n\noctocode-mcp 将 AI 助手从“只会猜的实习生”升级为“懂你代码库的资深专家”，彻底消除了研发过程中的信息盲区。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbgauryy_octocode-mcp_c62312e7.png","bgauryy",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fbgauryy_75769fd0.jpg","Software Architect | Building solutions for code research across millions of repositories | Creator of Octocode http:\u002F\u002Foctocode.ai\r\n 🐙","Tel Aviv ","https:\u002F\u002Fgithub.com\u002Fbgauryy",[79,83,87],{"name":80,"color":81,"percentage":82},"TypeScript","#3178c6",98.8,{"name":84,"color":85,"percentage":86},"JavaScript","#f1e05a",1.2,{"name":88,"color":89,"percentage":90},"Shell","#89e051",0,789,65,"2026-04-14T23:06:50","MIT","未说明",{"notes":97,"python":95,"dependencies":98},"该工具是一个基于 MCP (Model Context Protocol) 的服务器，主要通过 npx (Node.js 包管理器) 运行，无需本地部署大型 AI 模型或 GPU。核心前置条件是必须配置 GitHub 身份验证 (OAuth)。它旨在增强现有 AI 助手（如 Cursor）的能力，使其能够访问本地代码库、LSP 智能以及 GitHub\u002FGitLab 远程仓库。",[99,100],"npx (Node.js)","GitHub Authentication",[14,15,52,35,13],[103,104,105,106,107,108,109,110,111,112,113,114,115,116,117,118,119,120,121,122],"ai","claude-ai","cursor-ai","development","mcp","modelcontextprotocol","octocode","ai-agents","ai-tools","code-intelligence","code-search","cursor","github-api","model-context-protocol","semantic-search","vibe-coding","github","agent","context","llm","2026-03-27T02:49:30.150509","2026-04-16T08:12:32.687787",[126,131,136,141,146,151],{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},35278,"如何优化 MCP 工具的 Token 消耗以减少上下文占用？","维护者已在版本 6.1.0 中将总 Token 消耗减少至 4k，并计划在后续版本（如 5.0.0-alpha.6 及以后）中继续优化，目标是让每个工具的上下文描述少于 1k tokens。用户可以通过升级到最新版本来获得优化效果。","https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fissues\u002F126",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},35279,"在 Cursor 中使用 Grok-4-fast 模型时 Octocode MCP 无响应怎么办？","该问题通常与特定模型兼容性或临时配置有关。用户反馈在重新尝试或等待维护者更新后问题解决。建议确保使用的是最新版本的 Octocode MCP，并在遇到问题时尝试重启 Cursor 或切换模型测试。如果问题持续，可关注仓库更新或访问官网 https:\u002F\u002Foctocode.ai\u002F 获取最新支持信息。","https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fissues\u002F132",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},35280,"在 Cursor 中安装 Octocode MCP 时报语法错误（syntax error near unexpected token）如何解决？","这是由于打包逻辑中的 bug 导致的。维护者已在版本 2.3.21 中修复。请执行以下命令清除缓存并重新安装：\n```\nrm -rf ~\u002F.npm\u002F_npx\n```\n然后重新运行 `npx octocode-mcp`。注意：该项目是完全免费的，请勿与其他同名项目混淆。","https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fissues\u002F43",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},35281,"Octocode MCP 存在哪些安全风险？是否已修复？","安全审计曾发现 5 个可操作问题，包括 shell 注入风险、遥测数据发送未加密、配置文件权限过宽等。所有问题已在版本 12.1.0 中修复。维护者进行了 64 项回归测试验证修复效果。建议用户立即升级到 v12.1.0 或更高版本以确保安全。","https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fissues\u002F321",{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},35282,"如何关闭最终状态消息中显示的\"Octocode 已被使用\"提示？","该提示已在版本 7.0.10 中被移除。用户只需升级到 `octocode-mcp@7.0.10` 或更高版本即可不再看到此类通知。维护者确认此问题已修复。","https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fissues\u002F194",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},35283,"在 Windows + WSL 环境下使用 Antigravity 配合 Claude\u002FGPT 模型时报错\"Agent terminated due to error\"怎么办？","该问题与 WSL 环境兼容性有关。有用户反馈将开发环境从 WSL 切换回原生 Windows 后问题解决。建议尝试在原生 Windows 终端中运行，或检查 Antigravity 和 Octocode MCP 的最新版本是否已支持 WSL。目前暂无官方修复，但社区建议避免在 WSL 中混合使用某些模型。","https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fissues\u002F257",[157,162,167,172,177,182,187,192,197,202,207,212],{"id":158,"version":159,"summary_zh":160,"released_at":161},280320,"9.1.1","## 变更内容\n* 由 @bgauryy 在 https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F237 中添加了发布工作流\n\n\n**完整变更日志**: https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fcompare\u002F9.1.0...9.1.1","2025-12-15T20:10:38",{"id":163,"version":164,"summary_zh":165,"released_at":166},280321,"9.1.0","# 更改日志 - PR #236：构建系统现代化\n\n## [未发布]\n\n### 版本: \"9.1.0\"\n\n### 新增\n- **独立二进制分发** - 针对所有主流平台的预编译二进制文件，无需 Node.js 依赖\n  - macOS（Apple Silicon & Intel）\n  - Linux（x64、ARM64、Alpine\u002Fmusl）\n  - Windows（x64）\n- **单行安装脚本** - `curl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fbgauryy\u002Foctocode-mcp\u002Fmain\u002Finstall\u002Finstall.sh | sh`\n- **Bun 构建脚本** - 通过 `bun build --compile` 支持交叉编译\n  - `build:bin` - 为当前平台构建\n  - `build:bin:all` - 为所有平台构建\n  - `build:bin:darwin-arm64`、`build:bin:darwin-x64`、`build:bin:linux-x64` 等\n- **tsup 配置** - 使用基于 esbuild 的现代打包工具替代 Rollup\n- **类型导出** - `FileContentQuery` 类型现从 schema 中显式导出\n\n### 变更\n- **构建系统** - 从 Rollup 迁移到 tsup（esbuild）\n  - 使用 esbuild 编译速度更快\n  - 通过 `tsup.config.ts` 配置更简单\n  - 默认启用 Tree-shaking\n- **Schema 验证** - `FileContentQuerySchema` 重构为使用 `superRefine()`\n  - 错误信息更清晰，包含具体路径（`['fullContent']`、`['startLine']`）\n  - 可同时报告多个验证失败\n- **包搜索 Schema** - 重构为使用扁平化的字段定义，避免深层类型推断\n- **依赖升级**\n  - `@typescript-eslint\u002F*`: 6.x → 8.x\n  - `zod`: 3.23.8 → 3.24.0\n  - `typescript`: 5.9.2 → 5.9.3\n  - 新增：`tsup`、`tslib`、`eslint-config-prettier`、`eslint-plugin-prettier`\n- **错误处理** - 替换空的 catch 块以避免使用未使用的错误变量（符合 ESLint v8 规范）\n\n### 移除\n- **Rollup 配置** - `rollup.config.js` 和 `rollup-plugin-string` 依赖\n- **单独的 TypeScript 构建配置** - `tsconfig.build.json`（现由 tsup 处理编译）\n- **包中的类型声明** - 不再发布 `.d.ts` 文件（面向二进制分发）\n\n### 破坏性变更\n- **GitHubReposSearch 验证** - 现在必须至少提供 `keywordsToSearch` 或 `topicsToSearch` 之一\n  - 仅使用 `owner` 筛选器的查询将无法通过验证\n  - 错误信息：`\"至少需要提供 'keywordsToSearch' 或 'topicsToSearch' 中的一个\"`\n\n### 修复\n- **格式一致性** - 统一了代码库中条件表达式的格式\n- **类型安全** - 改进了 `createSuccessResult\u003CT extends Record\u003Cstring, unknown>>` 中的泛型约束\n\n---\n\n## 迁移指南\n\n### 对于二进制用户（新增！）\n```bash\n# 安装独立二进制（无需 Node.js）\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002Fbgauryy\u002Foctocode-mcp\u002Fmain\u002Finstall\u002Finstall.sh | sh\n\n# 配置 MCP 客户端\n{\n  \"mcpServers\": {\n    \"octocode\": {\n      \"command\": \"~\u002F.local\u002Fbin\u002Foctocode-mcp\"\n    }\n  }\n}\n```\n\n### 对于 npm 用户\n无需更改 - `npx octocode-mcp` 仍可正常工作。\n\n### 对于 API 消费者\n如果您正在使用仅包含 owner 的 `githubSearchRepositories` 查询","2025-12-15T19:03:39",{"id":168,"version":169,"summary_zh":170,"released_at":171},280322,"8.0.0","# 更改日志 - Octocode MCP v8.0.0\n\n> **简而言之**: 重大版本更新，引入本地文件系统研究功能、新的许可模式，并增强了提示命令。\n\n\n## 🚀 新特性\n\n### 本地文件系统研究（`octocode-mcp-local` v1.0.1）\n全新的 MCP 服务器包，用于使用原生 Unix 工具探索本地代码库。\n\n- **`local_ripgrep`** - 基于正则表达式的快速模式搜索，支持上下文行和分页\n- **`local_view_structure`** - 目录树视图，显示文件大小并支持过滤\n- **`local_find_files`** - 根据元数据（时间、大小、权限）查找文件\n- **`local_fetch_content`** - 读取文件内容或按模式提取部分内容\n\n> **来源**: [PR #219](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F219), [PR #222](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F222)\n\n### 新的提示命令\n\n| 命令 | 描述 |\n|---------|-------------|\n| `\u002Fplan` | 面向复杂开发的 AI 架构师——调研、规划、实施 |\n| `\u002Freview_pull_request` | 以缺陷优先为导向的专家级 PR 审查 |\n| `\u002Freview_security` | 对代码仓库进行全面的安全审计 |\n\n> **来源**: [PR #220](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F220)\n\n---\n\n## 🔄 重大变更\n\n### 许可证变更：MIT → PolyForm Small Business 1.0.0\n\n所有软件包现采用 **PolyForm Small Business 许可证**：\n- ✅ 个人及小型企业（员工少于 100 人、年收入低于 100 万美元）可免费使用\n- ⚠️ 大型企业需获取商业许可证\n\n**受影响的软件包**:\n- `octocode-mcp`（根目录）\n- `packages\u002Foctocode-mcp`\n- `packages\u002Foctocode-local`\n- `packages\u002Foctocode-utils`\n\n> **来源**: [PR #220](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F220) | 许可证文件: `LICENSE`, `packages\u002F*\u002FLICENSE`\n\n### 移除的命令\n- `\u002Fkudos` - 用于赞赏代码仓库（已移除）\n- `\u002Fuse` - 快速参考指南（已移除）\n\n> **来源**: [PR #220](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F220) | `packages\u002Foctocode-mcp\u002Fsrc\u002Ftools\u002Fcontent.json`\n\n### 软件包重命名\n- `@octocodeai\u002Flocal` → `octocode-mcp-local`\n- 二进制文件名: `local` → `octocode-mcp-local`\n\n> **来源**: [PR #221](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F221), [PR #222](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F222)\n\n---\n\n## 📦 依赖项更新\n\n| 软件包 | 旧版本 | 新版本 |\n|---------|-------------|-------------|\n| `octocode-mcp` | 7.0.17 | **8.0.0** |\n| `octocode-utils` | 5.0.0 | **6.0.0** |\n| `octocode-mcp-local` | - | **1.0.1** |\n| `typescript`（开发依赖） | - | 5.9.2 |\n\n---\n\n## 📝 文档更新\n\n- 添加了 Cursor 的一键安装按钮（[PR #223](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F223)）\n- 为 15+ 种 MCP 客户端提供了全面的安装指南（[PR #221](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F221)）\n- 更新了 README，为所有安装命令添加了 `@latest` 版本标签\n- 新增了针对 `octocode-local` 软件包的 ARCHITECTURE.md 文件\n- 简化了 AGENTS.md 文件，提供了面向单体仓库的指导说明\n\n> **来源**: [PR #221](https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocod","2025-11-26T17:27:46",{"id":173,"version":174,"summary_zh":175,"released_at":176},280323,"7.0.13","# PR #211：提示词全面重构\n\n**创建日期：** 2025年11月20日  \n\n## 📊 变更概览\n\n| 指标         | 值     |\n|--------------|--------|\n| 修改文件数   | 16     |\n| 新增行数     | +3,201 |\n| 删除行数     | -96    |\n| 净变更       | +3,105 |\n\n---\n\n## 🎯 新增内容\n\n### ✨ 新特性\n\n#### 🔒 安全评审提示词（`review_security.ts`）\n- **全新AI驱动的安全评审系统**\n- 实现系统化的漏洞评估工作流\n- **核心能力：**\n  - 采用攻击者视角进行威胁建模\n  - 绘制攻击面（如敏感信息泄露、注入攻击、SSRF、RCE、认证\u002F授权问题、CSRF等）\n  - 提供结构化的安全分析，并附带置信度等级\n  - 集成OWASP备忘单系列\n  - 接受`repoUrl`参数，支持定向分析\n- **输出：** 精炼的发现结果，附带GitHub链接及影响评估\n\n### 🔄 变更\n\n#### 简化提示词架构\n- **移除`research.ts`和`use.ts`中的冗余预处理逻辑**\n  - 取消基于正则表达式的工具名称替换\n  - 内容直接传递，无需额外处理\n  - 代码更加简洁易维护\n\n#### 增强提示词注册功能（`prompts.ts`）\n- **带有验证的条件式注册机制**\n- 在注册每个提示词前进行检查：\n  - ✅ 提示词元数据存在\n  - ✅ 名称为非空字符串\n  - ✅ 描述为非空字符串\n  - ✅ 内容为非空字符串\n- **优雅降级：** 缺失或无效的提示词不会导致系统崩溃\n\n#### 构建配置加固（`rollup.config.js`）\n- 将`noEmitOnError: false`改为`noEmitOnError: true`\n- **更严格的校验：** 现在当src目录及测试代码中出现TypeScript错误时，构建将直接失败\n- 有效防止有问题的代码被部署\n\n### ❌ 移除\n\n#### 废弃“感谢”提示词\n- 删除了`src\u002Fprompts\u002Fkudos.ts`文件（共36行）\n- 此前该提示词用于帮助用户感谢研究过程中引用的仓库\n- 功能现已退役，转而聚焦于安全相关功能\n\n---\n\n## 📁 修改文件列表\n\n### 源代码（8个文件）\n1. **`packages\u002Foctocode-mcp\u002Frollup.config.js`**（+1, -1）\n   - 提升构建严格性\n\n2. **`packages\u002Foctocode-mcp\u002Fsrc\u002Fprompts\u002Fkudos.ts`**（已删除）\n   - 移除了感谢提示词\n\n3. **`packages\u002Foctocode-mcp\u002Fsrc\u002Fprompts\u002Fprompts.ts`**（+39, -4）\n   - 引入条件式注册逻辑\n\n4. **`packages\u002Foctocode-mcp\u002Fsrc\u002Fprompts\u002Fresearch.ts`**（+3, -29）\n   - 简化实现\n\n5. **`packages\u002Foctocode-mcp\u002Fsrc\u002Fprompts\u002Freview_security.ts`**（新增，+96）\n   - 安全评审提示词\n\n6. **`packages\u002Foctocode-mcp\u002Fsrc\u002Fprompts\u002Fuse.ts`**（+2, -20）\n   - 简化实现\n\n7. **`packages\u002Foctocode-mcp\u002Fsrc\u002Ftools\u002Fcontent.json`**（元数据更新）\n   - 用`reviewSecurity`替换了`kudos`\n\n8. **`packages\u002Foctocode-mcp\u002Fsrc\u002Ftools\u002FtoolMetadata.ts`**（+9, -1）\n   - 新增`isToolAvailableSync()`辅助函数\n   - 更新了提示词接口\n\n### 测试用例（8个文件）\n- **`tests\u002Fprompts\u002Fprompts.test.ts`**（+478, -0）\n- **`tests\u002Fprompts\u002Fresearch.test.ts`**（+257, -0）\n- **`tests\u002Fprompts\u002Freview_security.test.ts`**（+383, -0）\n- **`tests\u002Fpr","2025-11-20T17:03:08",{"id":178,"version":179,"summary_zh":180,"released_at":181},280324,"7.0.10","特性：添加 MCP 注册中心支持，并实现自动化发布\n\n- 添加用于 MCP 注册中心注册的 server.json 文件\n- 实现自动化发布工作流\n- 通过合理包含文件，优化软件包分发\n- 添加完善的 CI\u002FCD 文档\n- 清理工具输出提示信息\n\n本次发布使 Octocode 在官方 MCP 注册中心中可被发现，并建立了稳定的自动化发布流水线。","2025-11-10T14:06:55",{"id":183,"version":184,"summary_zh":185,"released_at":186},280325,"7.0.0","# PR #142：主要架构重构——错误处理、类型系统与代码组织\n\n## 概述\n\n此 PR 对代码库进行了全面的重构，重点在于提升可维护性、优化代码组织结构以及改善开发者体验。此次变更整合了错误处理逻辑、集中管理类型定义，并在所有 GitHub API 工具中引入了可复用的实用模式。\n\n**版本**：6.3.0 → 7.0.0（主版本号递增）\n\n## 总结统计\n\n- **更改文件数**：30 个文件\n- **新增行数**：1,113 行\n- **删除行数**：1,277 行\n- **净变化**：-164 行（功能改进的同时代码量减少）\n- **新增文件**：2 个（errorConstants.ts、tools\u002Futils.ts）\n- **分支**：`add-suggestions` → `main`\n- **基础 SHA**：`d8000ff1f230b800014849addada3b462f25685c`\n- **头部 SHA**：`a451ff57810a8f38abed159dd1f1dddfd25cc950`\n- **状态**：已打开（未合并）\n- **草稿**：否\n- **评论数**：0\n- **评审意见**：0\n- **创建日期**：2025年10月6日\n- **最后更新日期**：2025年10月12日\n\n## 关键变更\n\n### 1. 集中式错误处理系统\n\n**新文件**：`src\u002Fgithub\u002FerrorConstants.ts`（227 行）\n\n创建了一个全面的错误管理系统，包含：\n\n- **错误码**：为所有 GitHub API 错误定义了标准化的错误码常量：\n  - `AUTH_REQUIRED` — 401 身份验证错误\n  - `RATE_LIMIT_PRIMARY` — 403 主要速率限制错误\n  - `RATE_LIMIT_SECONDARY` — 403 次要速率限制（滥用检测）\n  - `FORBIDDEN_PERMISSIONS` — 403 权限错误\n  - `NOT_FOUND` — 404 资源未找到\n  - `INVALID_REQUEST` — 422 验证错误\n  - `SERVER_UNAVAILABLE` — 502\u002F503\u002F504 服务器错误\n  - `NETWORK_CONNECTION_FAILED` — 网络连接错误\n  - `REQUEST_TIMEOUT` — 请求超时错误\n  - `UNKNOWN` — 未知错误类型\n\n- **错误消息**：集中管理错误消息模板，提供：\n  - 用户友好的错误提示\n  - 可操作的解决建议\n  - 详细的错误原因说明\n  - 在适用情况下指向 GitHub API 文档的链接\n\n- **速率限制配置**：\n  - 为速率限制重置预留 1 秒缓冲时间（GitHub 最佳实践）\n  - 为次要速率限制设置 60 秒的回退机制\n  - 正确区分主要和次要速率限制\n\n**重构文件**：`src\u002Fgithub\u002Ferrors.ts`（新增 300 行，删除 123 行）\n\n- 将错误处理模块化为多个专注的功能：\n  - `handleRequestError()` — 处理 Octokit 的 RequestError\n  - `handle403Error()` — 复杂的 403 错误分类\n  - `handleSecondaryRateLimit()` — 处理次要速率限制\n  - `handlePrimaryRateLimit()` — 处理主要速率限制\n  - `handlePermissionError()` — 处理权限\u002F作用域错误\n  - `handleKnownHttpError()` — 标准 HTTP 错误处理\n  - `handleJavaScriptError()` — 处理 JavaScript 错误\n\n- 增强了错误检测能力：\n  - GraphQL 速率限制检测\n  - 次要速率限制模式匹配\n  - 网络错误模式匹配\n\n- 改进了错误提示生成","2025-10-15T12:30:06",{"id":188,"version":189,"summary_zh":190,"released_at":191},280326,"6.3.0","6.3.0\n\n- 添加 researchGoal\n- 改进生产监控\n\n","2025-10-03T14:08:02",{"id":193,"version":194,"summary_zh":195,"released_at":196},280327,"6.2.0","## [6.2.0] - 2025-09-29 - 模式重构与上下文改进\n\n### 重大增强：模式架构重构\n\n#### 新增\n- **集中式模式描述**：新增 `schemDescriptions.ts` 模块，将所有工具的模式描述统一整合\n  - 消除了各单独模式文件中的代码重复\n  - 提供一致、集中的参数描述\n  - 便于工具文档的维护和更新\n  - 支持结构化分类（范围、过滤器、处理等）\n\n#### 优化\n- **GitHub API 参数清理**：在所有工具中移除已弃用及未使用的 GitHub API 参数\n  - **拉取请求搜索**：移除 `locked`、`review`、`checks`、`milestone`、`project`、`team-mentions`、`language`、`visibility`、`app` 等参数\n  - **代码搜索**：移除 `language` 参数（与 `extension` 重复）\n  - **仓库搜索**：移除 `language` 参数，使筛选更加简洁\n  - **参数重命名**：将 `getFileChanges` 重命名为 `withContent`，以提高一致性和清晰度\n\n- **模式架构现代化**：全面重构模式组织结构\n  - 精简基础模式，仅保留必要的通用字段\n  - 移除冗余的模式定义和导入\n  - 提升类型安全性和验证一致性\n  - 通过集成工具名称，优化批量查询模式的生成\n\n#### 技术改进\n- **代码可维护性**：集中式描述将维护开销降低约 70%\n- **API 合规性**：移除了导致问题的已弃用 GitHub API 参数\n- **类型安全**：增强了 TypeScript 类型，提升了参数验证能力\n- **测试覆盖率**：更新所有测试以反映模式变更，同时保持完全覆盖\n- **性能**：通过降低模式复杂度，实现了轻微的性能提升\n\n#### 移除\n- **已弃用参数**：清理了占用接口空间的未使用 GitHub API 参数\n- **冗余代码**：移除了重复的模式定义和描述\n- **遗留导入**：清理了未使用的导入和依赖项\n\n### 生产环境影响\n\n#### 开发者体验提升\n- **更简洁的 API**：简化后的参数集合使工具更易于使用\n- **更好的文档**：集中式描述确保了文档的一致性和清晰度\n- **降低复杂度**：更少的参数减轻了用户的认知负担\n- **提升类型安全**：更干净的模式提供了更好的 TypeScript 支持\n\n#### 技术优势\n- **可维护性**：集中式描述使更新工作变得更加容易\n- **API 合规性**：移除已弃用参数避免了未来可能出现的问题\n- **代码质量**：架构更加整洁，职责分离更为清晰\n- **测试可靠性**：更新后的测试套件确保了持续的可靠性","2025-09-28T23:04:34",{"id":198,"version":199,"summary_zh":200,"released_at":201},280328,"6.1.1","重大变更\n\n    模式复杂度降低\n    移除冗余参数：从所有工具模式和实现中移除了 verbose 字段，降低了模式复杂度\n    简化基础模式：将 BaseBulkQueryItemSchema 和 BaseSingleQuerySchema 合并为统一的 BaseQuerySchema\n    精简参数校验：用更简单的 SimpleArraySchema 工具替换复杂的柔性数组模式\n    参数命名标准化\n    代码搜索：queryTerms → keywordsToSearch，语义更清晰\n    仓库搜索：新增 topicsToSearch 参数，与 keywordsToSearch 分开\n    提交搜索：更新为在所有搜索工具中统一使用 keywordsToSearch\n    工具查询优化\n    仓库搜索增强：实现了对同时包含 topicsToSearch 和 keywordsToSearch 的查询的自动扩展\n    搜索策略分离：基于主题和基于关键词的搜索现以独立优化的查询运行\n    提升搜索精度：通过更清晰的参数描述增强了过滤能力\n    模式描述改进\n    文档增强：提供更具操作性和针对性的参数描述\n    更好的校验：改进了 Zod 模式的定义，约束更加明确\n    减少歧义：去除可空\u002F可选类型，采用清晰简单的类型\n\n🚀 性能提升\n令牌效率\n在不需要时移除响应中的仅用于 verbose 的字段\n简化模式定义以减少解析开销\n通过自动查询扩展优化批量查询处理\n搜索优化\n仓库搜索现在会自动将主题和关键词分离为优化的并行查询\n从仓库质量筛选器中移除 is:not-fork 过滤条件，以扩大发现范围\n增强匹配范围控制，实现更精准的过滤\n\n🔄 破坏性变更\n参数重命名：queryTerms → keywordsToSearch（影响所有搜索工具）\n移除 verbose 参数：所有工具均不再支持该参数\n模式结构：简化后的基础模式可能影响直接使用模式的情况\n\n🎯 主要优势\n减少令牌用量：简化模式并移除 verbose 字段显著降低了令牌消耗\n更好的搜索结果：分离主题\u002F关键词搜索提供了更精准、更全面的结果\n提升开发者体验：更清晰的参数名称和描述提高了易用性\n性能提升：优化的查询处理和自动扩展提高了响应速度\n可维护性：简化模式结构使未来的功能增强更加容易\n\n🔮 未来影响\n此次优化为以下方面奠定了基础：\n更高效的 AI 助手交互\n通过专用查询策略提升搜索结果质量\n更便捷的工具扩展和维护\n通过提高令牌效率降低运营成本","2025-09-27T16:25:51",{"id":203,"version":204,"summary_zh":205,"released_at":206},280329,"6.0.0","### 🎯 **概述**\r\n此 PR 为 Octocode MCP 服务器实施了一套全面的令牌精简与优化策略，重点在于精简代码库并提升 AI 助手的响应效率。\n\n### 🔧 **主要变更**\r\n\r\n#### **1. 工具移除与简化**\r\n- **移除了 NPM\u002F包搜索工具**（`packageSearch`、`npmViewPackage`）\r\n  - 完全移除了对 NPM 生态系统的支持（`src\u002Fnpm\u002F` 目录）\r\n  - 删除了包搜索相关的模式定义和命令构建器\r\n  - 更新了文档，明确仅支持 GitHub 相关功能\r\n\r\n- **移除了 GitHub 提交搜索工具**（`githubSearchCommits`）\r\n  - 删除了提交搜索的实现代码及模式定义\r\n  - 简化了工具清单与注册流程\r\n  - 更新了相关文档中的引用\r\n\r\n#### **2. 响应格式优化**\r\n- **新的统一响应结构**（`src\u002Fresponses.ts`）\r\n  - 实现了 `createResponseFormat()`，支持 YAML 输出格式\r\n  - 新增了 `cleanJsonObject()`，用于移除空值或 null 值\r\n  - 集成了 `octocode-utils` 工具库以进行 YAML 转换\r\n  - 流程化了安全处理链路\r\n\r\n- **模式现代化改造**\r\n  - 将所有工具的模式更新为使用标准化的 `ToolResponse` 接口\r\n  - 简化了所有 GitHub 工具的输入输出类型\r\n  - 移除了冗余的元数据字段及过于繁琐的选项\r\n\r\n#### **3. 缓存系统重构**\r\n- **新实现的 `withDataCache()`**\r\n  - 用更高效的数据专用缓存机制替换了原有的 `withCache()`\r\n  - 改进了缓存键的生成方式，去除了冗长的参数\r\n  - 增加了基于操作成功与否的条件性缓存逻辑\r\n  - 加强了针对不同操作类型的 TTL 管理\r\n\r\n#### **4. GitHub API 集成改进**\r\n- **文件操作优化**（`src\u002Fgithub\u002FfileOperations.ts`）\r\n  - 更新了参数名称（`filePath` → `path`）\r\n  - 简化了响应结构\r\n  - 加强了绝对路径的处理能力\r\n  - 改进了错误处理与类型安全性\r\n\r\n- **拉取请求搜索增强**（`src\u002Fgithub\u002FpullRequestSearch.ts`）\r\n  - 流畅化了 PR 数据结构\r\n  - 简化了仓库引用方式\r\n  - 强化了文件变更的处理逻辑\r\n  - 改进了错误响应格式\r\n\r\n- **仓库搜索细化**（`src\u002Fgithub\u002FrepoSearch.ts`）\r\n  - 移除了冗余字段（`language`、`forks`、`total_count`）\r\n  - 增加了按星数和更新日期的智能排序功能\r\n  - 简化了仓库数据结构\r\n  - 提升了响应的一致性\r\n\r\n#### **5. 文档与配置更新**\r\n- **工具文档更新**\r\n  - 在所有文档中移除了对已删除工具的引用\r\n  - 更新了功能矩阵与能力说明\r\n  - 简化了认证要求\r\n  - 修订了使用示例和配置指南\r\n\r\n- **包配置**\r\n  - 更新了包描述，明确仅支持 GitHub 相关功能\r\n  - 移除了与 NPM 相关的关键字及依赖项\r\n  - 更新了工具清单与注册信息\r\n  - 清理了构建配置\r\n\r\n#### **6. 安全与性能提升**","2025-09-24T20:58:41",{"id":208,"version":209,"summary_zh":210,"released_at":211},280330,"v5.0.0","https:\u002F\u002Fgithub.com\u002Fbgauryy\u002Foctocode-mcp\u002Fpull\u002F116","2025-08-25T15:46:12",{"id":213,"version":214,"summary_zh":215,"released_at":216},280331,"v2.3.28","Added MCP features\r\n Sampling and Prompts ","2025-08-22T12:48:55"]