context-overlaylisted

# Context Overlay ## 使用边界 - `context-overlay` 是 OpenAI-compatible request proxy，位于 SDK client 和上游模型服务之间。 - 用于按规则注入 context、skill、policy、memory、profile、prompt patch，或把特定请求 route 到另一个上游。 - 它不运行 agent loop、不执行 tools、不解释模型输出。 - 它应保留 OpenAI-compatible 字段，例如 `tools`、`image_url`、`response_format`、`stream`。 - 不要把 secrets 写进 overlay 文本、skill JSON 或公开配置；优先用环境变量展开。 - 暴露到公网前必须配置 `auth.api_key`，不要公开无认证 proxy。 - 需要安装、开公网 tunnel、改服务端口或改长期配置时，先征得用户同意。 ## 安装与最小配置 - PyPI 安装：`pip install context-overlay` - GitHub 源码：https://github.com/black-yt/context-overlay ## 上游版本锚点 - 当前 skill 对照 context-overlay GitHub `VERSION`：`0.0.5`。 - 当前 skill 对照 GitHub HEAD：`e7a7c83924a225c443c454c80aab0735ca1bbe6c`。 - 维护本 skill 前，先重新检查上游 `VERSION` 和 HEAD；如果任一变化，必须阅读 README、`pyproject.toml`、CLI help 和相关源码后再更新。 安装模板： ```bash pip install context-overlay ``` 开发版本模板： ```bash git clone https://github.com/black-yt/context-overlay.git cd context-overlay pip install -e ".[dev]" pytest -q ``` ## 源码追溯 - 如果配置字段、transform 行为或转发逻辑不确定，优先追溯已安装包源码。 - `inspect.getsource(...)` 适合查看 `apply_rules`、`load_config`、`SkillStore`、FastAPI app 创建逻辑。 - `module.__file__` 可定位包安装路径，再按需打开源码文件。 - 源码只用于阅读和定位问题，不要改源码，不要直接改 `site-packages` 或长期环境；需要改库时，先 clone 仓库并使用 editable install，且必须征得用户同意。 ```python import inspect import context_overlay from context_overlay import apply_rules, load_config, SkillStore from context_overlay.server import create_app print(context_overlay.__file__) print(inspect.getsource(load_config)) print(inspect.getsource(