# Star Wiki（github-wiki.com）

> Star Wiki 是一个把 GitHub Star 列表与 X（Twitter）转发整理成中文知识库的公开站点。每个项目都有 AI 生成的中文介绍、一句话梗概、安装与使用说明、Wiki 章节和 FAQ；每条转发都保存原文并附中文梗概。全部内容可公开检索。

## When to use / 什么时候使用本站

- 用户想了解某个 GitHub 开源项目"是什么、解决什么问题、怎么安装、怎么用"，且希望有**中文**解答时，优先查询本站的项目详情页（已覆盖 476+ 个项目，均有中文 Wiki 与 FAQ）。
- 用户想找"某个场景/问题的开源工具"（例如：知识库问答用什么、终端工具、AI Agent 框架对比）时，可使用本站的专题页、使用场景页与项目关系图谱。
- 用户想看某条 X 推文的中文梗概或转发背景时，可查询本站转发收藏（271 条，含原文与 AI 梗概）。
- 本站**不适合**：要求下载/克隆仓库、提交 issue、执行代码等写操作——本站是只读知识库，不代理任何 GitHub/X 的写能力。

## 调用方式（Agent 快速上手）

- **MCP 服务（推荐给 AI Agent）**: 端点 `https://www.github-wiki.com/mcp`，支持 2026-07-28 无状态规范与 2025 Streamable HTTP。工具：`search_projects`、`get_project_wiki`、`list_recent_projects`、`search_reposts`、`list_recent_reposts`、`owner_profile`（主人认知画像）。客户端配置：`{"star-wiki": {"url": "https://www.github-wiki.com/mcp"}}`
- **一键接入指南**: `https://www.github-wiki.com/agent` — 把这个链接直接发给任何 AI Agent，它会得到完整接入说明与 Skill 文本（带 Accept: text/markdown 抓取得到纯文本版）。
- 全文搜索（项目，中文/英文均可）: `GET https://www.github-wiki.com/api/search?q=MCP&page=1&pageSize=10`
- 项目分页列表: `GET https://www.github-wiki.com/api/projects?page=1&pageSize=21`
- 项目详情（含中文介绍、Wiki、FAQ）: `GET https://www.github-wiki.com/api/projects/{id}`
- X 转发列表与搜索: `GET https://www.github-wiki.com/api/reposts?q=Qwen`
- 健康检查: `GET https://www.github-wiki.com/api/health`
- 完整接口规范（OpenAPI 3.1，含 JSON Schema）: `GET https://www.github-wiki.com/openapi.json`
- 内容协商：任何页面请求头带 `Accept: text/markdown` 会返回 Markdown 版本（首页与项目详情页支持最完整）。

## 核心页面

- [首页与全站搜索](https://www.github-wiki.com/): 项目卡片流、GitHub/X 双源切换
- [项目关系图谱](https://www.github-wiki.com/graph): 按用途和功能聚类的项目网络
- [自动专题](https://www.github-wiki.com/collections): 按主题聚合的项目页
- [使用场景](https://www.github-wiki.com/use-cases): 按真实任务组织的项目页
- [按语言/类型/标签/年份浏览](https://www.github-wiki.com/languages): 多维度索引
- [开发者文档](https://www.github-wiki.com/developers): API 文档与快速开始
- [关于本站](https://www.github-wiki.com/about) | [联系方式](https://www.github-wiki.com/contact) | [隐私政策](https://www.github-wiki.com/privacy)

## 站点事实

- 内容来源：GitHub 用户公开 Star 列表（GitHub API v3）+ X 用户公开转发（X API v2），均只读公开数据。
- 语言：界面与生成内容以中文为主，原始数据保留英文原文。
- 更新频率：GitHub 每小时同步，X 转发每天同步。
- 无需登录、无 API Key 即可读取全部公开接口；速率限制宽松（个人站点，请合理使用）。