andrewyng/context-hub
GitHub: andrewyng/context-hub
Context Hub 是面向 AI 编程智能体的版本化文档获取工具,通过搜索、获取、注释和反馈机制解决 API 幻觉和会话遗忘问题,让智能体越用越聪明。
Stars: 10798 | Forks: 955
# Context Hub
编程智能体会产生 API 幻觉,并且容易忘记在一次会话中学到的内容。Context Hub 为它们提供经过整理、版本化的文档,并具备随着任务执行不断变智能的能力。所有内容均在此仓库中以 Markdown 形式开放和维护——您可以确切地检查您的智能体阅读了什么,并进行回馈贡献。
[](LICENSE)
[](https://www.npmjs.com/package/@aisuite/chub)
[](https://nodejs.org)
## 快速开始
```
npm install -g @aisuite/chub
chub search openai # find what's available
chub get openai/chat --lang py # fetch current docs (Python version)
```
## 工作原理
Chub 专为您的编程智能体设计(而非供您直接使用!)。您可以通过提示词让智能体使用它(例如,“使用 CLI 命令 chub 获取调用 OpenAI 的最新 API 文档。运行 'chub help' 以了解其工作原理。”),或者通过创建一个使用 Chub 的智能体技能(使用 [SKILL.md](cli/skills/get-api-docs/SKILL.md)),并理想地提示您的智能体记住使用此技能。(如果您使用的是 Claude Code,请创建目录 ~/.claude/skills/get-api-docs 并将 SKILL.md 放入其中。)
**大多数情况下,这很简单 —— 搜索、获取、使用:**
```
chub search "stripe payments" # find relevant docs
chub get stripe/api --lang js # fetch the doc
# Agent 阅读文档,编写正确代码。完成。
```
**当智能体发现有遗漏时**,它可以在本地添加注释以备下次使用:
```
chub annotate stripe/api "Needs raw body for webhook verification"
# 下次会话,annotation 会在 chub get 时自动出现。
```
**反馈将回传给作者** —— `chub feedback stripe/api up` 或 `down` —— 对文档进行投票,以便随着时间推移为所有人提供更好的文档。
## 内容类型
版本化、特定语言。“需要了解的内容。”
```
chub get openai/chat --lang py # Python variant
chub get openai/chat --lang js # JavaScript variant
```
除了 API 文档之外,更多内容类型(如智能体技能)已在规划路线图中。
## 命令
| 命令 | 用途 |
|---------|---------|
| `chub search [query]` | 搜索文档和技能(无查询 = 列出所有) |
| `chub get [--lang py\|js]` | 通过 ID 获取文档或技能 |
| `chub annotate ` | 为文档或技能附加注释 |
| `chub annotate --clear` | 移除注释 |
| `chub annotate --list` | 列出所有注释 |
| `chub feedback ` | 对文档投赞成或反对票(发送给维护者) |
有关命令、标志和管道模式的完整列表,请参阅 [CLI 参考](docs/cli-reference.md)。
## 自我改进的智能体
Context Hub 旨在实现一个让智能体随着时间推移不断变强的循环。
**注释 (Annotations)** 是智能体附加到文档的本地笔记。它们跨会话持久保存,并在未来的获取中自动显示——因此智能体可以从过往经验中学习。参见 [反馈与注释](docs/feedback-and-annotations.md)。
**反馈 (Feedback)**(带有可选标签的赞成/反对评级)会发送给文档作者,作者根据有效和无效的内容更新内容。文档对所有人都会变得更好——而不仅仅是您的本地注释。
```
Without Context Hub With Context Hub
─────────────────── ─────────────────
Search the web Fetch curated docs
Noisy results Higher chance of code working
Code breaks Agent notes any gaps/workarounds
Effort in fixing ↗ Even smarter next session
Knowledge forgotten
↻ Repeat next session
```
## 关键特性
### 增量获取
文档除主入口点外,还可以包含多个参考文件。仅获取所需内容——不浪费 token。使用 `--file` 获取特定参考,或使用 `--full` 获取所有内容。参见 [CLI 参考](docs/cli-reference.md)。
### 注释与反馈
注释是智能体附加到文档的本地笔记——它们跨会话持久保存,并在未来的获取中自动显示。反馈(赞成/反对评级)发送给文档作者,以便为所有人改进内容。参见 [反馈与注释](docs/feedback-and-annotations.md)。
## 贡献
任何人都可以贡献文档和技能——API 提供商、框架作者和社区。内容是带有 YAML 前言的纯 Markdown,作为 Pull Requests 提交。有关格式和结构,请参阅 [内容指南](docs/content-guide.md)。
智能体反馈(来自实际使用的赞成/反对评级)回传给作者,帮助发现需要修复的问题,并随着时间的推移提高整体质量。
## 许可证
[MIT](LICENSE)
标签:AI代理, API文档, DLL 劫持, DNS解析, GNU通用公共许可证, IPv6支持, LLM, Markdown, MITM代理, Node.js, NPM包, OSV-Scalibr, RAG, Ruby, Unmanaged PE, 上下文管理, 人工智能, 代码生成, 全文检索, 大语言模型, 威胁情报, 安全可观测性, 幻觉缓解, 开发者工具, 开源项目, 提示词工程, 文档检索, 文档结构分析, 暗色界面, 渗透测试工具, 版本控制, 用户模式Hook绕过, 知识库, 策略决策点, 编码助手, 自定义脚本, 防御加固