捕获代理的有效能力表面，提交它，并在部署前看到语义上有意义的变更。
ContextWeaver 目前正在测试一个刻意狭窄的产品假设： 能力快照 + 语义漂移。
给定一个 OpenAPI 文档、一个捕获的 MCP tools/list 响应，或一个原生的
ContextWeaver 目录，D1 实验会产生一个确定性的规范化快照，你可以检查、验证，
并与后续的候选版本进行比较。它不需要模型账户、网关、工具执行器或 Weaver
Stack。
状态： alpha，具体来说是一个产品实验。实现可以工作且经过测试； 用户价值假设尚未得到证实。该项目正在积极衡量独立用户是否在真实项目上尝试 此工作流后继续使用它。
克隆仓库并安装该检出版本，以确保维护的示例夹具和正在评估的代码保证匹配：
git clone --depth 1 https://github.com/dgenio/contextweaver.git
cd contextweaver
python -m pip install .运行维护的 OpenAPI 示例：
python -m contextweaver.d1 snapshot examples/d1/openapi_before.json --source-type openapi --output ./cw-before.json
python -m contextweaver.d1 snapshot examples/d1/openapi_after.json --source-type openapi --output ./cw-after.json
python -m contextweaver.d1 inspect ./cw-after.json
python -m contextweaver.d1 verify ./cw-after.json
python -m contextweaver.d1 diff ./cw-before.json ./cw-after.json候选夹具故意：
使 customer_id 在现有的 listInvoices 能力上成为必填项；
更改其描述；
添加一个新的 getInvoice 能力。
差异将能力的新增/移除与对现有逻辑能力的更改分开，并报告已更改的结构化路径。
契约变更与仅文档变更分开。涉及 required、type 或 enum 等字段的更改
会被标记为可能破坏性以供审查。
该标记故意保守：ContextWeaver 不声称是完整的 JSON-Schema 兼容性检查器。
完整演练：能力漂移实验。
Related MCP server: MCP Gateway
python -m contextweaver.d1 snapshot ./openapi.yaml --source-type openapi --output ./capabilities.json
python -m contextweaver.d1 verify ./capabilities.jsonAPI 更改后：
python -m contextweaver.d1 snapshot ./openapi.yaml --source-type openapi --output ./capabilities-candidate.json
python -m contextweaver.d1 diff ./capabilities.json ./capabilities-candidate.json如果您已经有一个保存为 JSON 的 MCP tools/list 响应：
python -m contextweaver.d1 snapshot ./tools-list.json \
--source-type mcp \
--output ./capabilities.json对于 MCP，D1 通过其上游逻辑名称比较工具，因此输入模式编辑会显示为对同一
能力的更改，而不是无法解释的移除/添加对。历史性的模式敏感路由 ID 会单独
保留为 normalized_id 以供检查。
捕获实时 MCP 服务器是单独的操作。snapshot、inspect、diff 和 verify
不会执行发现的能力。
python -m contextweaver.d1 snapshot ./catalog.json \
--source-type native \
--output ./capabilities.jsonverify 的含义verify 检查 D1 快照契约：结构、确定性排序、逻辑 ID 唯一性以及规范能力摘要。
它不是：
部署批准；
安全认证；
身份验证或授权；
工具实现正确性的保证；
路由质量评估；
生产运行时证明。
否定答案对这个项目是有用的证据。不要仅仅因为能力快照听起来整洁就添加 ContextWeaver。
在以下情况下使用更简单的东西：
普通的 Git diff、配置审查和测试已经使您的能力变更显而易见；
您的工具/API 表面很小且很少更改；
提供者原生的工具搜索是您唯一想解决的问题；
您需要代理循环、工具执行器、IAM 层或生产编排器；
维护另一个已提交的工件比它消除的审查/调试问题成本更高。
如果您尝试 D1 并得出结论认为 Git/测试更便宜，那是一个有效的产品结果—— 请说出来。
当前的生存实验提出了一个比代码是否工作更强的问题：
能力快照和语义漂移报告是否足以改善真实的审查/手动/风险流程，使独立用户 继续使用它们？
该项目区分：
qualified exposure
-> understood the problem
-> chose to evaluate
-> attempted setup
-> reached first useful output
-> used on a real project
-> retained independently / removed星标、分叉、下载、成功的演示以及维护者创建的集成不被视为保留采用。
控制产品决策在 #758 中跟踪，分发质量门 在 #855 中跟踪。无辅助的 首次成功和保留在 #658 中跟踪，真正的采用在 #551 中跟踪。
ContextWeaver 已经包含大量历史运行时功能。该代码仍然存在，当前发布的行为 应保持真实和安全，但现有实现不是项目应继续扩展它的证据。
两个更广泛的假设明确以证据为先：
D2 — 有界/阶段感知的上下文编译： 有条件的。它必须展示超越当代提供者/ 运行时原生机制的重要价值。
D3 — 自定义确定性工具选择： 一个证伪轨道。它必须在目标用户真正关心的 事情上击败现代提供者原生的工具搜索/延迟加载或简单的检索基线。
在 D1 实验期间，项目不会在没有具体外部阻塞或批准的证伪实验的情况下扩展 路由复杂性、运行时捆绑机制、内存/会话表面、框架广度、网关范围、向量存储 或模型辅助增强。
如果您正在维护使用这些历史表面的现有集成，相关文档仍然可用：
D1 实现支持范围明确的工程声明，例如在文档化的源/适配器契约下确定性快照 构建以及结构化语义差异输出。它尚不支持用户需要或保留该产品的更强声明。
历史性的 token 减少标题故意不用于推销 D1。这些较旧基准声明的当前证据完整性 工作在 #841 中跟踪。
参见 声明与证据 了解声明注册表，以及 能力漂移实验 了解确切的 D1 契约和限制。
D1 故意通过以下方式暴露：
python -m contextweaver.d1 ...而不是立即提升到历史性的顶级 CLI 或大型新公共 Python API。这是故意的。 实验应通过真实的保留使用来赢得永久表面，然后项目才承担另一个兼容性义务。
ContextWeaver 可以独立使用。它对兄弟 Weaver 项目没有硬依赖。
更广泛的 Weaver Stack 包含相邻的实验/组件，用于规划、执行边界、护栏、经验教训 和评估。该生态系统不是评估 D1 所必需的，Stack 一致性也不是保留一个不能 独立证明自己的 ContextWeaver 功能的理由。
仅当您确实需要那些相邻职责时，才参见 生态系统地图。
pip install contextweaverPython 3.10–3.14 由仓库 CI 矩阵覆盖。
当前包版本：0.18.1
项目 | 发布 |
ContextWeaver（此仓库，v0.18.1） | 当前包发布 |
仓库是 pre-1.0。对于错误和安全修复，请优先使用最新的受支持补丁版本，并在依赖 历史运行时 API 之前检查变更日志。
路线图故意是产品决策序列，而不是功能队列。
里程碑 | 状态 | 含义 |
v0.18.1 — D1 生存实验基线 | ✅ 当前（v0.18.1） | 离线 snapshot/inspect/diff/verify 存在；用户价值仍未验证。 |
D1 分发门 | 🔬 证据优先 | 使前门易于理解，招募合格的评估者，衡量首次成功和保留。 |
D1 决策 | ⏸ 下一个决策 | 根据有能力的分发后的保留价值，继续、进一步缩小或终止。 |
D2 / D3 | 🧪 有条件的 | 仅当 D1 证据或独立问题发现证明有界证伪实验合理时才运行。 |
绿色 CI 运行本身不会推进此路线图。
在生存实验期间最有价值的贡献是狭窄且与证据相关的：
真实的 D1 评估者阻塞；
当前误导或静默丢失的语义差异案例；
确定性规范化正确性；
包仍发布的行为的安全/发布维护；
显示更简单替代方案获胜的负面证据。
请不要仅仅为了完整性而添加框架适配器、路由策略、存储后端、运行时阶段或 生态系统集成。
参见 CONTRIBUTING.md 和 AGENTS.md 了解仓库 工程约定。
参见 SECURITY.md 了解受支持版本和漏洞报告指南。不要在公共 采用/评估报告中包含凭据、客户数据、专有模式或私人提示。
Apache-2.0。参见 LICENSE。
This server cannot be deployed
Find, vet, and run MCP tools through a secure audited gateway with prompt-injection risk scoring
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
MCP server for progressive tool usage at any scale (see https://klavis.ai)