Claude Code 实战指南（二）：Memory Bank 模式与上下文治理全景深度解析

your-repo/
├──.claude/
│   └── CLAUDE.md               # Claude Code 启动唯一加载的全局索引
├── memory-bank/                # AI 的外部记忆库
│   ├── projectbrief.md         # 项目宪法（硬性目标）
│   ├── productContext.md       # 业务逻辑与用户故事
│   ├── systemPatterns.md       # 架构规范与代码模板
│   ├── activeContext.md        # 运行内存（当前会话状态）
│   └── progress.md             # 里程碑记录
├── app/                        # 真实业务代码
│   ├── main.py
│   └── auth/
│       └── jwt_handler.py
└──.gitignore

“阅读 memory-bank/ 下的所有文件。我需要添加 JWT 鉴权。请根据产品需求更新 activeContext.md，列出今天的计划。”

Active Context
Current Focus: 实现核心 JWT 鉴权模块 (基于 RS256)
Next Steps:
[ ] 1. 在 app/auth/jwt_handler.py 中实现基于 python-jose[cryptography] 的 JWT 签发逻辑。
[ ] 2. 构建 OAuth2PasswordBearer 依赖注入。
[ ] 3. 更新 app/main.py 注册路由。

执行 activeContext.md 中的第一步。

# app/auth/jwt_handler.py
from jose import jwt
from datetime import datetime, timedelta

# 从环境变量中读取非对称密钥
SECRET_KEY = "YOUR_RSA_PRIVATE_KEY" 
ALGORITHM = "RS256"

def create_access_token(data: dict, expires_delta: timedelta):
    to_encode = data.copy()
    expire = datetime.utcnow() + expires_delta
    to_encode.update({"exp": expire})
    
    # 严格遵循架构规范中的 RS256 算法
    encoded_jwt = jwt.encode(to_encode, SECRET_KEY, algorithm=ALGORITHM)
    return encoded_jwt

# app/main.py
from fastapi import FastAPI
from app.routers import auth

app = FastAPI(title="JWT Auth Service")
app.include_router(auth.router, prefix="/api/v1/auth", tags=["Authentication"])

我们今天完成了 JWT API。请更新 activeContext.md 和 progress.md，清理临时调试代码，然后运行 /compact。

# 恢复上一会话的上下文
claude --resume

# 触发带保护性指令的上下文压缩，防止模型“变笨”
/compact 深入保留关于 JWT 鉴权路由的依赖注入逻辑，忽略早期的 Python 环境配置讨论

> tree -L 3 -I 'node_modules|venv|__pycache__|.git'
Locate (精准定位文件): 强制要求 Claude 使用 rg (ripgrep) 或 grep 查找关键代码行。

> rg -n "OAuth2PasswordBearer" app/
app/auth/jwt_bearer.py:12:oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")
Read (定点读取): 只将带有行号目标的文件送入上下文。

> cat app/auth/jwt_bearer.py

pycache/
*.py[cod]
.venv/
poetry.lock
package-lock.json
node_modules/
.pytest_cache/