太棒了背景
> 为Claude Code提供高级团队的工程知识——架构模式、编码标准、安全审计——自动注入,而不会烧毁您的上下文窗口。
30秒内开始```bash
1. Install the plugin
claude plugin install awesome-context
2. Set your API key (get one free at awesomecontext.awareness.market)
export AC_API_KEY=ac_your_key_here
3. Load rules for your project
/awesome-context:rules
______________________________________________________________________
## 问题
Claude Code功能强大,但它不知道你团队的规则。
每次你开始一个会话,你都会回到起点:手动粘贴编码标准,提醒它你的技术栈,解释安全要求,复制粘贴架构指南。即使你这样做,随着对话的深入,长的上下文窗口也会导致克劳德“忘记”规则。
结果:人工智能生成的代码可以工作,但违反了你的约定,跳过了安全检查,或者选择了错误的架构模式。
______________________________________________________________________
## What AwesomeContext做什么
**AwesomeContext是Claude Code的MCP服务器,可在Claude需要时自动注入128多种工程规则、模式和技能。**
- **对话开始时**:Claude自动知道你的技术栈的编码规则
- **设计前**:Claude了解架构模式和权衡
- **审核时**:Claude应用了深度安全检查表(OWASP、DeFi、智能合约)
- **承诺前**:Claude根据团队标准检查您的代码
所有这一切都发生在后台。你只需编写代码。
**关键创新**:AwesomeContext没有注入原始Markdown文档(每个文档花费数千个令牌),而是将规则压缩到神经张量中,并按需解码——实现 **96-99%的代币节省** 同时保持完全的语义准确性。
______________________________________________________________________
## 这是给谁的
|用户|痛点| AwesomeContext如何帮助|
|------|-----------|--------------------------|
| **个人开发者** |Claude编写的代码不符合您的标准|每次会话都会自动加载您的规则|
| **技术负责人** |使用AI的团队得到不一致、非标准的输出|一个共享的规则集,为每个人注入|
| **安全工程师** |Claude不知道特定于域的漏洞模式|按需注入专门的安全检查表|
| **顾问/自由职业者** |每个项目有不同的客户端标准|每个会话加载特定于项目的规则|
______________________________________________________________________
## 快速入门(云端——推荐)
没有GPU,没有Docker,没有编译。只需安装和使用。
### 1.获得免费的API密钥
注册地址: 令人惊叹的互联网、意识、市场 并复制您的密钥。
### 2.安装插件```bash
claude plugin install awesome-context
3.设置API密钥```bash
export AC_API_KEY=ac_your_key_here
### 4.开始使用它
在任何项目上打开Claude Code并运行:```bash
/awesome-context:rules # Auto-detect your stack and load relevant rules
就是这样。克劳德现在知道你的编码标准、安全要求和本次会议的最佳实践。
你可以做的四件事
/awesome-context:rules --加载您的规则
自动检测你的技术栈(TypeScript、Python、Go、React、Django等),并加载正确的编码标准、安全指南和模式。```
You: /awesome-context:rules
→ Detected: TypeScript + React + Next.js
→ Loaded: TypeScript strict mode rules, React hook conventions,
Next.js App Router patterns, OWASP web security checklist
→ Claude now knows the rules for this project.
### `/awesome-context:architect` --在构建之前获得架构指导
在为新功能编写代码之前,请询问架构模式。Claude注入了生产级决策框架,因此可以正确地进行权衡。```
You: /awesome-context:architect
You: I need to add real-time notifications to my app.
Claude: Here's the analysis for your Next.js + Postgres stack:
→ WebSocket: Best for bi-directional, many simultaneous connections
→ SSE: Simpler, HTTP-based, good for server-push only (your case)
→ Polling: Only if you need IE11 support
Recommendation: SSE via Next.js Route Handlers, here's the pattern...
/awesome-context:review --提交前检查代码
Claude根据加载的规则检查您的分阶段更改——在样式违规、安全问题和反模式到达您的仓库之前捕捉它们。```
You: /awesome-context:review
Claude: Found 2 issues in your staged changes:
✗ Line 47: Raw SQL string concatenation — SQL injection risk (OWASP A03)
Fix: Use parameterized queries → db.query('SELECT * FROM users WHERE id = $1', [id])
✗ Line 83: console.log left in production code
Fix: Use your logger utility instead
✓ Everything else looks good.
### `/awesome-context:security` --深度安全审计
为您的域注入专门的安全知识:OWASP网络漏洞、DeFi智能合约漏洞、加密陷阱、访问控制审查。```
You: /awesome-context:security
You: Audit this Solidity contract for me.
Claude: Running DeFi security checklist:
✗ Reentrancy vulnerability on line 34 — update state before external calls
✗ Integer overflow on line 67 — use SafeMath or Solidity 0.8+
✗ Access control missing on withdrawAll() — add onlyOwner modifier
✓ No tx.origin authentication issues found
4个MCP工具(自动激活)
除了斜线命令,该插件还注册了Claude调用的4个工具 自动地 基于上下文——无需手动调用:
| 工具 | 当克劳德调用它时 | 它的作用 |
|---|---|---|
get_rules |
对话开始时 | 加载项目的技术堆栈规则 |
architect_consult |
在设计决策之前 | 注入架构模式和权衡 |
skill_injector |
针对特定领域的任务 | 提取安全、测试或基础设施知识 |
compliance_verify |
检查代码时 | 对照加载的标准进行检查 |
> 插件中描述了这些工具,以便Claude知道 当 打电话给他们——你不必记得问。
支持的技术栈
语言:TypeScript、Python、Go、Java、Rust、C++、Solidity
框架:React、Next.js、Django、FastAPI、Spring Boot、Express
基础设施:Docker、CI/CD、Postgres、ClickHouse
领域:DeFi/智能合约、OWASP安全、REST API设计、TDD、数据库迁移
128+可用模块
| 类别 | 计数 | 示例 |
|---|---|---|
| 编码规则 | 12+ | TypeScript严格模式,Python风格,Go习惯用法,Java模式 |
| 技能 | 43+ | TDD工作流程、安全审查、DeFi审核、API设计 |
| 代理 | 13 | 架构审查员、安全审查员、代码审查员、测试指南 |
| 命令 | 31+ | 计划、构建修复、e2e、检查点、重构 |
| 钩子 | 1 | 预提交检查 |
浏览所有模块: /awesome-context:skills
自助主机(高级)
如果你想在本地运行所有东西——你自己的模型,你自己的规则,没有云依赖。
先决条件
- Python 3.10+
- Node.js 18+
- 具有≥8GB VRAM的GPU(可选——CPU回退可用)
1.克隆和安装```bash
git clone --recurse-submodules https://github.com/everest-an/AwesomeContext.git
cd AwesomeContext
Python dependencies
pip install -e ".[dev]"
MCP server dependencies
cd mcp-server && npm install && cd ..
### 2.编写规则
这是一个一次性步骤,将所有128个规则模块编码为压缩张量:```bash
# Preview what will be compiled (no model loading)
python scripts/compile.py --dry-run
# Full compilation (~17-47 min on GPU, downloads model on first run)
python scripts/compile.py
# Incremental — only recompile changed files
python scripts/compile.py --delta
``````
Found 128 modules (13 agents, 43 skills, 12 rules, 31 commands, ...)
Loading model: Qwen/Qwen3-4B (device=cuda, dtype=torch.bfloat16)
Compiling: 100%|████████████████| 128/128 [17:42<00:00, 8.30s/module]
Compilation complete. 128 modules → data/tensors/
3.启动后端```bash
python scripts/serve.py
Running at http://127.0.0.1:8420
### 4.构建并启动MCP服务器```bash
cd mcp-server
npm run build
npm start
5.配置克劳德代码
添加 ~/.config/claude-code/mcp.json (或您项目的MCP配置):```json
{
"mcpServers": {
"awesome-context": {
"command": "node",
"args": ["path/to/AwesomeContext/mcp-server/dist/index.js"],
"env": {
"AC_API": "http://127.0.0.1:8420"
}
}
}
}
______________________________________________________________________
## 压缩是如何工作的
标准方法:将完整的Markdown规则文件注入Claude的上下文中——每条规则2000-5000个令牌,随着对话的增长而丢失。
真棒上下文方法:
1. **离线**:通过语言模型(Qwen3)运行每个规则文档。捕获深层隐藏状态表示并将其保存为紧凑的张量文件。
1. **运行时**:当您查询规则时,对意图进行编码,通过余弦相似度找到最接近的匹配张量,将其解码回一个短指令字符串——以毫秒为单位。
结果:相同的语义内容以\<150个标记交付,而不是5000+。```
User Intent → Cosine Search → Load Tensor (mmap) → Decode → Dense Prompt (< 150 tokens)
支持的型号
| 型号 | 硬件 | 内存 | 用例 |
|---|---|---|---|
| Qwen3-4B (默认) | GPU≥8GB | ~8GB bf16 | 最佳平衡 |
| Qwen3-14B | GPU≥24GB | ~28GB bf16 | 最高保真度 |
| Qwen2.5-Coder-1.5B | CPU | ~6GB fp32 | 不需要GPU |
自动检测:如果CUDA可用,则使用Qwen3-4B,否则回退到Qwen2.5-1.5B。覆盖 AC_MODEL.
演出
代币节省
| 场景 | 原始代币 | 精彩情境后 | 节省 |
|---|---|---|---|
| 单技能 | 2000-5000 | \<150 | 96-97% |
| 架构咨询(3个模块) | 6000-15000 | \<150 | 98-99% |
| 合规性检查(5条规则) | 10000–25000 | \<150 | 99%+ |
运行时间速度
| 操作 | 时间 |
|---|---|
| 第一次查询(模型预热) | 1.5-5秒 |
| 缓存查询 | \<100ms |
| 编译(一次性,每个模块) | GPU上10-28秒 |
API参考(Self-Hosting)
POST /v1/latent/query
所有MCP工具均在内部使用。
请求:```json
{
"intent": "implement debounced search",
"session_id": "sess_abc123",
"tool_name": "architect_consult",
"top_k": 3
}
**答复:**```json
{
"dense_prompt": "【Injected Rules】: 1. Use React Hook conventions; 2. Reference utils/debounce...",
"metrics": {
"tokens_saved": 1250,
"retrieval_time_ms": 0.8,
"total_time_ms": 1920.1,
"modules_matched": 3
},
"matched_modules": [
{ "module_id": "skills/coding-standards", "score": 0.91 }
]
}
GET /v1/modules/list --列出所有已编译的模块
GET /v1/health --健康检查
GET /v1/metrics --性能统计
环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
AC_API_KEY |
- | 云API密钥(插件模式) |
AC_MODEL |
自动检测 | 模型覆盖(Qwen/Qwen3-4B, Qwen/Qwen3-14B, Qwen/Qwen2.5-Coder-1.5B-Instruct) |
AC_API |
http://127.0.0.1:8420 |
后端URL(自托管MCP服务器) |
项目结构```
AwesomeContext/
├── src/
│ ├── adapter/ # Model adaptation (encode, decode, realignment)
│ ├── compiler/ # Offline compilation pipeline
│ ├── gateway/ # Runtime query engine
│ ├── api/ # FastAPI backend
│ └── shared/ # Types, hashing, tensor I/O
├── mcp-server/ # MCP Server (TypeScript/Node.js)
├── vendor/
│ └── everything-claude-code/ # Rule source (128 modules)
├── data/ # Compiled tensors (gitignored)
├── scripts/ # compile.py, serve.py, verify_tensors.py
└── landing/ # Next.js website + dashboard
______________________________________________________________________
## 测试```bash
# All unit tests
python -m pytest tests/unit/ -v
# TypeScript type check
cd mcp-server && npx tsc --noEmit
# Verify compiled tensors
python scripts/verify_tensors.py
建立在
- Qwen3 --编码和解码的语言模型
- 模型上下文协议 --AI工具集成标准
- 安全张量 --快速、安全的张量序列化
作者
- 珠穆朗玛峰 --创建者和首席开发人员
- 郝 --共同创造者和建筑师
许可证
Apache许可证2.0
awesomecontext.awareness.market · Powered by Qwen3 · Integrated via MCP
