andrewyng/context-hub

GitHub: andrewyng/context-hub

Context Hub 是面向 AI 编程智能体的版本化文档获取工具,通过搜索、获取、注释和反馈机制解决 API 幻觉和会话遗忘问题,让智能体越用越聪明。

Stars: 10798 | Forks: 955

# Context Hub 编程智能体会产生 API 幻觉,并且容易忘记在一次会话中学到的内容。Context Hub 为它们提供经过整理、版本化的文档,并具备随着任务执行不断变智能的能力。所有内容均在此仓库中以 Markdown 形式开放和维护——您可以确切地检查您的智能体阅读了什么,并进行回馈贡献。 [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![npm](https://img.shields.io/npm/v/@aisuite/chub)](https://www.npmjs.com/package/@aisuite/chub) [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](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绕过, 知识库, 策略决策点, 编码助手, 自定义脚本, 防御加固