ctxvault

# CtxVault 状态：v0.6.2 公开版本产物。当前公开界面：上下文健康医生。 了解您的 AI 工具所看到的内容。 CtxVault 是一个用于 AI 工作本地上下文管理的工具包。v0.6.2 版本专注于一个公开路径：本地上下文健康医生，它在 AI 面临的上下文到达代理之前报告陈旧、冲突、不支持或不安全的上下文。 ## 上下文健康医生 扫描本地仓库、文件夹或文件，并编写声明/上下文/内存/操作健康报告： ```bash PYTHONPATH=src python3 -m ctxvault.cli doctor --path /path/to/repo --output .ctxvault/health ``` 医生读取用户选择的本地文件。它在选择的输出路径和回滚路径下编写生成的 CtxVault 产物，包括 JSON、Markdown、运行收据、证据清单、备份清单和索引文件。它不会修改扫描的源文件、调用模型或提供程序、执行运行时或适配器、获取网络或促进内存。添加 `--include-report` 以将完整的 JSON 报告打印到 stdout。 ## 报告层 | 层 | 报告检查的内容 | | --- | --- | | 声明 | 不支持的公共、安全、性能、兼容性、认可、稳定协议或目标写入声明。 | | 上下文 | 陈旧的版本声明、冲突的指令、重复的规则、缺失的原始引用和隐藏的终端失败。 | | 内存 | 没有源、生命周期、删除或回滚字段的类似内存的内容。 | | 操作 | 没有证据、批准和回滚的发布或操作语言。 | ## v0.6.2 范围 此版本中包含： - `doctor --path` 用于本地上下文健康医生扫描。 - `schemas/json/ctxvault-context-health-report-v0.schema.json`。 - `fixtures/v0.6.2-context-health-doctor/`，包含经过净化的样本和干净的仓库。 - 具有副作用标志和回滚删除路径的本地收据。 - 上下文契约词汇作为支持报告结构。 - 作为声明边界纪律的证明的安全公共 OSS 证据收据。 不包含或声明： - 安全保证 - 基准、性能、可靠性或编码改进声明 - 通用兼容性声明 - 稳定协议声明 - 自动补救 - 目标仓库源文件修改 - 模型、提供程序、浏览器、云、MCP、运行时或适配器执行 - 包注册表发布 - 外部联络 ## 在本地验证 ```bash python3 -m pytest tests/test_context_health_doctor.py tests/test_cli.py ``` 聚焦的测试涵盖模式验证、样本发现、干净仓库的允许状态、生成的报告和收据、回滚路径、缺失路径的失败关闭行为、生成的 `.ctxvault` 排除和旧版 `doctor --root` 兼容性。 ## 版本产物 - `release/v0.6.2/RELEASE_NOTES.md` - `release/v0.6.2/github-release.md` - `release/v0.6.2/publication/v062-publication-receipt-2026-05-16.json` - `src/ctxvault/context_health.py` - `src/ctxvault/cli.py` - `tests/test_context_health_doctor.py`