ContextLattice

# 上下文格子 <p align="center"> <a href="https://contextlattice.io/" target="_blank" rel="noopener noreferrer"> <img src="docs/readme/contextlattice-architecture-readme-v2-2026-04-28.png" alt="Context Lattice 架构概览海报" width="100%" /> </a> </p> <p align="center"> <strong>开启智能代理。</strong> </p> <p align="center"> 本地优先的智能层，为 AI 代理提供持久的连续性、可解释的检索、便携的上下文和跨不同平台的验证学习能力。 </p> <p align="center"> <a href="#快速入门"><img src="https://img.shields.io/badge/界面-命令行优先-111111?style=for-the-badge" alt="命令行优先"></a> <a href="https://github.com/sheawinkler/ContextLattice/releases/tag/v4.0.4"><img src="https://img.shields.io/badge/版本-v4.0.4-333333?style=for-the-badge" alt="ContextLattice v4.0.4"></a> <a href="#快速入门"><img src="https://img.shields.io/badge/部署-Docker%20Compose-4b5563?style=for-the-badge" alt="Docker Compose"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/许可证-Apache%202.0-1f2937?style=for-the-badge" alt="Apache License 2.0"></a> </p> [](https://glama.ai/mcp/servers/sheawinkler/context-lattice) <p align="center"> <a href="https://contextlattice.io/">概览</a> | <a href="https://contextlattice.io/architecture.html">架构</a> | <a href="https://contextlattice.io/wiki.html">维基</a> | <a href="https://contextlattice.io/roadmap.html">路线图</a> | <a href="https://contextlattice.io/installation.html">安装</a> | <a href="https://contextlattice.io/integration.html">集成</a> | <a href="https://contextlattice.io/premium.html">高级功能</a> | <a href="https://contextlattice.io/app.html">应用界面</a> | <a href="https://contextlattice.io/troubleshooting.html">故障排除</a> | <a href="https://contextlattice.io/updates.html">更新日志</a> </p> ## 缺失的层 模型可以推理，平台可以执行，但两者都无法在聊天、工具、账户或计算机更改后可靠地记住任务。上下文格子填补了这一空白，而无需将每个提示转换为一个巨大的转录记录。 - **持久的连续性。** 重新打开具有检查点、决策、风险、存储库身份、证明和下一步骤的精确活动任务。 - **可解释的检索。** 将上下文窗口花费在具有最高影响力的证据上，然后解释为什么选择、反对、推迟或省略每个结果。 - **便携的上下文。** 在代理、平台、账户和机器之间移动签名、最小权限的继续数据包，而不放弃出处或执行控制权。 - **验证的技能演化。** 将重复成功的任务转换为经过评估、人类批准的技能；保持策略候选人在确定性证据获得晋升之前仅为影子模式。 - **隐私边界的聚合信号。** 从明确选择加入的、剪辑的统计数据中学习，同时原始提示和记忆保持本地。生产环境的群体学习是一个受控的激活预览，在独立的隐私和实用性审查通过之前被阻止。 ## 不仅仅是记忆 上下文格子封装了围绕代理智能的完整操作层：持久的写入、作用域上下文包、确定性的合成、时间声明、图链接、技能索引发现、行为出处、代理会话、连续性身份、实用程序账本经济、上下文护照、加密上下文网格、代理拟合、策略实验室、Pi/Droid 运行器适配器，以及用于支持的平台的自动指令钩子。 **命令行界面是主要界面**。仪表板使行为和证明可见。HTTP 和 MCP 仍然是应用程序和平台需要的配套集成表面。 `v4.0.4` 是当前的发布基准。活动应用程序路径是 Go/Rust；Python 保留用于构建、开发、迁移和审计工具，而不是实时请求处理。公共本地模式是无账户的。付费工件添加托管分发、 工作区治理、保护操作和高级分析，而无需将本地内存移动到强制云。 ## 架构快照 <table> <tr> <td width="50%"> <a href="https://contextlattice.io/architecture.html"> <img src="docs/public_overview/assets/architecture-service-map.svg" alt="Context Lattice 服务地图" width="100%" /> </a> </td> <td width="50%"> <a href="https://contextlattice.io/architecture.html"> <img src="docs/public_overview/assets/architecture-write-flow.svg" alt="具有持久出队扇出的写入流程" width="100%" /> </a> </td> </tr> <tr> <td width="50%"> <a href="https://contextlattice.io/architecture.html"> <img src="docs/public_overview/assets/architecture-retrieval-flow.svg" alt="检索和学习反馈流程" width="100%" /> </a> </td> <td width="50%"> <a href="https://contextlattice.io/architecture.html"> <img src="docs/public_overview/assets/architecture-task-coordination.svg" alt="任务协调和代理通信流程" width="100%" /> </a> </td> </tr> </table> ## 操作员维基 使用新的操作员维基作为 `public/main` 的规范“最佳工具 + 图形”运行时手册。 - 网站维基（推荐）：`https://contextlattice.io/wiki.html` - 仓库镜像：`docs/wiki/README.md` - 检索收据和信任模型：[`docs/retrieval-receipts.md`](docs/retrieval-receipts.md) - 范围：端点地图、检索模式策略、继续行为、发布就绪的演练和代理模板 ### 认知核心命令行界面 命令行界面是规定的代理界面。HTTP 和 MCP 仍然是集成备选。 ```bash # 正常任务生命周期：紧凑的上下文，一个可重用的会话，自动的结果学习。 contextlattice doctor --pretty contextlattice context "调试当前发布回归" --project contextlattice --pretty contextlattice remember "检查点摘要" --project contextlattice --pretty contextlattice resume --project contextlattice --pretty contextlattice correct "检索已过时" --category stale --project contextlattice --pretty contextlattice finish "已验证结果" --success --project contextlattice --pretty # 在不混合模型可见、线路或提供者总数的情况下衡量有用工作。 contextlattice utility status --project contextlattice --pretty # 记录声明，然后由指定的独立验证者证明结果。 contextlattice utility record --session-id <id> --context-pack-quality-sample-id <id> --outcome-id <id> --utility-value 1 --utility-unit acceptance_points --verification-event-id <id> --verification-evidence-digest sha256:<64-hex> --verification-passed true --verifier-kind deterministic_test --verifier-id <independent-verifier> --pretty contextlattice utility verify --agent-id <independent-verifier> --session-id <id> --sample-id <id> --outcome-id <id> --utility-value 1 --utility-unit acceptance_points --verification-event-id <id> --verification-evidence-digest sha256:<64-hex> --verification-passed true --verifier-kind deterministic_test --verifier-id <independent-verifier> --pretty # 付费分析和门控仅为建议；它们从不重写检索策略。 contextlattice utility analytics --project contextlattice --pretty contextlattice utility gate --project contextlattice --utility-unit acceptance_points --minimum-pairs 2 --pretty # 适用于保留最后一个受信任数据包的客户端的可选增量传输。 # 完整的数据包是安全的后备，并直接成为下一个基线。 contextlattice context "继续发布证明" --project contextlattice \ --base-packet-file agent-packet.json --raw > packet-update.json contextlattice packet-reconstruct --base-packet-file agent-packet.json \ --delta-file packet-update.json --raw > next-agent-packet.json # 没有身份元数据的预升级数据包安全接收到新的完整数据包。 # 数据包摘要检测漂移但不验证来源；保留受信任存储中的基准。 # 高级认知和操作表面如下。 # 询问应该检索什么证据，从哪里检索，以及何时停止。 contextlattice_retrieval_plan "调试当前发布回归" --project contextlattice --pretty # 策略实验室是命令行优先的，除非显式操作应用可逆的收据。 contextlattice_policy_lab status --project contextlattice --pretty # 检查受管辖的检索操作。公共安装发现合同； # 付费工件提供有状态的工作区策略和操作。 contextlattice retrieval-governance status --feature receipts --project contextlattice --pretty # 坚持具有明确出处的结构化、时间感知断言。 contextlattice_claim_write \ --project contextlattice \ --subject release \ --predicate current_version \ --object 4.0.3 \ --statement "当前公共版本是 4.0.3。" \ --pretty # 查询当前、历史、已取代或矛盾的声明。 contextlattice_claim_query "当前公共版本" --project contextlattice --include-superseded --pretty # 返回声明级别的支持、反对、时间状态、不确定性和缺少的证明。 contextlattice_synthesis_pack_v2 "证明发布准备就绪" --project contextlattice --pretty # 在打开另一个执行通道之前解析一个持久的任务身份。 contextlattice_continuity_reconcile "交付连续性身份" \ --project contextlattice --repo contextlattice --task-id frontier-t1 \ --branch main --agent-id codex_gpt5 --pretty # 追加生命周期证据，检查当时存在的目标，并记录决策更改的原因。 contextlattice_objective_transition "交付连续性身份" --type progressed \ --project contextlattice --actor codex_gpt5 \ --idempotency-key frontier-t1-contract-proof \ --summary "HTTP 和 CLI 合同已验证" --pretty contextlattice_objective_graph --project contextlattice --pretty contextlattice_decision_change --project contextlattice --objective-id <objective-id> \ --idempotency-key frontier-t1-semantic-abstention \ --before "重用每个语义匹配" --after "在精确丢失后需要确认" \ --confidence-before 0.45 --confidence-after 0.92 --evidence <evidence-ref> \ --actor codex_gpt5 --rationale "模糊匹配必须放弃。" \ --reason-code evidence_changed --pretty # 仅从合格的结果中派生候选者，然后检查它。 contextlattice_policy_candidate --project contextlattice --pretty contextlattice_policy_status --pretty # 从重复的验证运行中构建，测试单独的隔离，然后仅在批准后导出。 contextlattice_skill_draft --payload-file workflow-runs.json --pretty contextlattice_skill_evaluate --draft-id <draft-id> --payload-file holdouts.json --pretty contextlattice_skill_export --draft-id <draft-id> --human-approved --approver <identity> --pretty contextlattice_skill_retire --draft-id <draft-id> --operator <identity> --reason "临时证明完成" --pretty # 控制具有能力的代理，解析其有效配置文件，并请求仅限于顾问的运行器/模型选择，而无需将执行移动到网关。 contextlattice agent-fit steering-watch --project contextlattice --agent-id codex_gpt5 --once --raw contextlattice agent-fit profile-resolve --project contextlattice --agent-id codex_gpt5 --raw contextlattice agent-fit runner-select --payload-file runner-candidates.json --raw contextlattice agent-fit context-prep-schedule --project contextlattice --payload-file prep-request.json --raw # 连续性零：打开已经组装的唯一明确活动任务。 # 可选工件以仅写入所有者；不会将本地路径发送到网关。 contextlattice_continuity_zero --project contextlattice --agent codex \ --output continuity-zero.json --pretty # 在不放弃信任或传输的情况下，在机器之间携带签名证据。 contextlattice_passport_export "准备发布交接" --project contextlattice --output passport.json --pretty contextlattice_passport_verify --file passport.json --pretty contextlattice_mesh_identity --pretty # 便携式继续：授予狭窄的权限，在本地密封，通过选择的通道移动，然后在不导入或执行任何内容的情况下解密和协调。 contextlattice_agent_tools portable-continuation grant-create \ --payload-file grant-request.json --output grant.json --pretty contextlattice_agent_tools portable-continuation manifest-create \ --payload-file continuation-request.json --output continuation-envelope.json --pretty contextlattice_agent_tools portable-continuation manifest-reconcile \ --payload-file reconciliation-request.json --envelope-file continuation-envelope.json --pretty contextlattice_agent_tools portable-continuation status --pretty ``` 计划者仍然处于`shadow_only`状态：学习到的候选者是建议，而不是隐藏的配置重写。技能导出在审查和安装通过正常的技能索引工作流程之前保持为非活动文件。护照重放从不执行导入的文本，网格从不拥有传输。参见 [`docs/continuity-identity.md`](docs/continuity-identity.md)，[`docs/cognition-proof-core.md`](docs/cognition-proof-core.md)，[`docs/outcome-policy-skill-foundry.md`](docs/outcome-policy-skill-foundry.md)，和 [`docs/context-passport-mesh.md`](docs/context-passport-mesh.md)，了解合同、安全边界和 HTTP 备用。 ## 快速入门 ### 代理快速入门：安装 + 集成 如果您是 AI 代理，并且因为用户要求您安装或集成上下文格子，请直接遵循本部分。不要等待用户将另一个提示复制回给您。 人类用户也可以将以下代码块粘贴到 Codex、Claude Code、Hermes、OpenCode、OMP、Mercury 或另一个具有终端功能的代理中。 ```text 您正在集成上下文格子。 存储库： https://github.com/sheawinkler/ContextLattice.git 目标： - 在本地安装和启动上下文格子。 - 验证运行时是否健康。 - 将目标存储库与上下文格子支持的代理配置文件集成。 - 除非用户明确要求，否则不要安装第三方代理平台二进制文件。 重要： - `contextlattice_adopt integrate` 为支持的配置文件写入托管指令块。 - 安装流程可能会为检测到的 OMP 和 Mercury 用户指令文件添加托管指令钩子；它们不会安装 OMP、Mercury、Codex、Claude Code、Hermes、Hermes Ultra、Pi、Droid 或其他代理二进制文件。 - 可选的 Pi/Droid 运行器执行需要它们的命令行界面（`brew install pi-coding-agent`，`brew install --cask droid`）。 - 保留存储库指令文件中的现有用户文本。 - 如果您已经在上下文格子检出中，请不要克隆重复的存储库。 安装上下文格子： git clone https://github.com/sheawinkler/ContextLattice.git cd ContextLattice cp .env.example .env gmake quickstart 验证上下文格子： curl -fsS http://127.0.0.1:8075/health | jq contextlattice_adopt status --pretty 集成目标存储库： cd /path/to/target/repo contextlattice_adopt integrate --repo . --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --pretty contextlattice_adopt integrate --repo . --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --check --pretty contextlattice_doctor --repo . --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --skip-provider-smoke --pretty 如果任何步骤失败： - 报告确切的失败命令和路径。 - 仅修复本地设置问题导致失败。 - 重新运行检查。 - 如果上下文格子无法访问，请继续使用降级内存模式，并明确说明。 ``` 有关完整的代理合同，请参见 `docs/public_overview/templates/agents/universal.md`。 ### 1) 克隆和配置 ```bash git clone git@github.com:sheawinkler/ContextLattice.git cd ContextLattice cp .env.example .env ``` ### 2) 启动（推荐） ```bash gmake quickstart ``` `gmake quickstart` 提示运行时配置文件，然后启动选定的堆栈。它是规范的首次安装路径；签名安装程序是引导程序的替代方案，而不是竞争性的控制表面。 ### 3) 验证 ```bash curl -fsS http://127.0.0.1:8075/health | jq scripts/agent/agent-runtime-proof-pack --pretty scripts/agent/agent-adoption-proof-matrix --skip-provider-smoke --progress --pretty ``` 预期结果： - `/health` 返回 `{"ok": true, ...}` - `agent-runtime-proof-pack` 完成引导、作用域回忆、检查点、交接、完成、状态、提示上下文包和运行时遥测阶段。 - `agent-adoption-proof-matrix` 验证配置的代理配置文件，并报告塑造每个运行的技能、上下文、会话、图和交接证据，带有运行卡导出的跟踪命令。 ## 模型运行时 任务推理默认设置为 `ORCH_INFER_PROVIDER=auto`。`gateway-go` 检测主机配置文件并在选择路由之前探测本地后端。 - Apple Silicon 默认优先级：`mlx,vllm-metal,ane_sidecar,llama-cpp,ollama`。 - CUDA/ROCm 默认优先级：`sglang,vllm,openai-compatible,llama-cpp,lmstudio,ollama`。 - 通用 CPU 默认优先级：`openai-compatible,llama-cpp,lmstudio,ollama`。 - 支持的提供商 ID 包括 `sglang`、`vllm`、`vllm-metal`、`mlx`、`mtplx`（MLX 的别名）、`openai-compatible`、`lmstudio`、`llama-cpp`、`tgi`、`tensorrt-llm`、`ane_sidecar` 和 `ollama`。 - `/v1/inference/runtime-policy` 返回实时提供商健康状况和资源感知模型指导。如果主机内存/VRAM 无法识别，它将回退到通用本地建议：首先使用 Q4/IQ4 7B-9B 模型，进行基准测试，然后扩大规模。 - 当前的选择性本地模型短期列表位于 `docs/runtime/local-model-options.md`；它包括小型/中型 MLX、GGUF 和 HF/safetensors 候选模型，以及前沿提供商连接指导。GGUF 模型使用外部 llama.cpp 兼容连接器；ContextLattice 不会在 Lite 中启动或捆绑 llama.cpp。 - 大型 Qwen3.6 Dream Mode 模型仅可选择加入；ContextLattice 不会默认捆绑或拉取这些模型。默认 GGUF 推荐为 `mudler/Qwen3.6-35B-A3B-Claude-4.7-Opus-Reasoning-Distilled-APEX-MTP-GGUF`，适用于 llama.cpp 兼容的高级用户。抹消的变体仅在 `CONTEXTLATTICE_DREAM_ALLOW_PRIVATE_EVAL_MODELS=true`（`GO_DREAM_ALLOW_UNCENSORED_MODELS=true` 仍然是一个遗留别名）后可用于私有评估。 - 推理运行时必须通过其 API 发出最终助手内容。仅推理响应会失败，并附有修复说明，而不是被接受。对于 MLX Qwen 思维模板，请使用 `scripts/inference_mlx_server.sh --model /path/to/mlx/model --template-profile qwen-final-content`，然后使用 `scripts/inference_template_conformance.sh --provider mlx --model /path/to/mlx/model` 验证。 - Dream Mode 默认情况下会反思 LLM 生成的假设，并在最佳输出未达到 sigma 目标时执行一次有界的深化传递（`GO_DREAM_REFLECT_ENABLED=true`，`GO_DREAM_DEEPEN_ON_WEAK_OUTPUT=true`，`GO_DREAM_REFLECTION_MIN_SCORE=0.74`）。如果结构化 LLM 合成不可用，Dream Mode 返回 `dream_unavailable`；非 LLM 证据打包属于 context-pack 或 review。 - Ollama 仍然是一个兼容性回退，而不是首选的始终在线嵌入路径。 - 本地助手默认强制执行一个活动的 LLM 后端（`CONTEXTLATTICE_SINGLE_ACTIVE_INFER_BACKEND=true`）。 检查实时路由和基准测试配置的后端： ```bash scripts/inference_runtime_policy.sh scripts/benchmark_inference_backends.sh scripts/inference_template_conformance.sh --provider mlx --model /path/to/mlx/model ``` 嵌入默认使用 Rust `fastembed-rs` 侧车。Ollama 仍然可用作显式兼容性回退，而不是首选的嵌入路径。 有用的模型运行时旋钮： ```bash ORCH_INFER_PROVIDER=auto ORCH_INFER_PROVIDER_PRIORITY=mlx,vllm-metal,ane_sidecar,sglang,vllm,openai-compatible,llama-cpp,ollama ORCH_INFER_AUTO_PROBE_ENABLED=true SGLANG_BASE_URL=http://127.0.0.1:30000 VLLM_BASE_URL=http://127.0.0.1:8000 VLLM_METAL_BASE_URL=http://127.0.0.1:8000 MLX_API_BASE=http://127.0.0.1:18087/v1 LLAMA_CPP_BASE_URL=http://127.0.0.1:8080 ``` ## 代理 CLI 安装程序和快速启动路径在 `$HOME/.contextlattice/bin` 下安装代理助手。 ```bash contextlattice_agent_adapter profiles contextlattice_adopt status --pretty contextlattice_doctor --agents codex --skip-provider-smoke --pretty contextlattice_agent_start --soft --compact contextlattice_agent_trace --session-id <session-id> --tree contextlattice_pack "what should the next agent know?" --project my-project --pretty contextlattice_search -h contextlattice_write -h contextlattice_checkpoint -h contextlattice_skills_index search "browser automation" --pretty contextlattice_passport_export "portable task context" --project my-project --output passport.json --pretty contextlattice_mesh_status --pretty ``` - `contextlattice_agent_adapter` 是引导、context-pack、检查点、移交、状态、事件和完成流程的一流生命周期助手。 - `contextlattice_agent_adapter state --state working|awaiting_user|blocked|done --session-id <id> --pretty` 报告具有权威、来源、TTL、本地会话 ID、任务 ID、存储库、工作树、分支、cwd 和用户/阻塞字段的语义代理生命周期状态。 - `contextlattice_agent_discover --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --repo . --pretty` 报告具有解释的本地进程/配置文件/钩子/存储库指令证据的最佳努力。发现是诊断证据；显式钩子或适配器状态仍然是权威的。 - `contextlattice_adopt` 是本地就绪、安装指导、配置文件和生命周期证明的零摩擦前门；`contextlattice_doctor` 结合就绪、证明和跟踪证据在一个有界的报告中。 - `contextlattice_agent_start` 运行代理的轻量级启动守卫。 - `contextlattice_agent_trace` 将有界的运行轨迹呈现为终端树、JSON 或 Markdown 运行卡。 - `contextlattice_pack` 编译带有排名证据、要检查的文件、风险、检查、源覆盖和引用提示的有界提示就绪数据包。 - `contextlattice_checkpoint` 写入检查点并验证回读。 - `contextlattice_skills_index` 在不加载每个技能到启动上下文的情况下发现能力。 - `contextlattice_passport_*` 签名、验证、差异、重放和导入有界上下文而不执行导入的指令。 - `contextlattice_mesh_*` 管理公共接收者身份、授予、加密文件/JSON 信封、干燥运行协调和显式应用；传输仍然由调用者拥有。 - `contextlattice_source_backfill` 是一个可选的开发助手，通过 `scripts/install_global_agent_tools.sh --include-dev-python-tools` 安装，用于有界数据导入。 - 钩子包详细信息：`docs/agent-hooks.md`。 ## 代理运行时会话 ContextLattice 跟踪实时代理工作，作为与运行器或模型提供商无关的一流会话。 - 通过 `GET|POST /v1/agents/sessions` 和 `GET /v1/agents/sessions/{session_id}` 启动/列出/读取会话。 - 通过 `POST /v1/agents/sessions/event` 或 `POST /v1/agents/sessions/{session_id}/events` 发出规范化事件。 - 通过 `GET /v1/agents/sessions/{session_id}/trace` 检查有界的运行轨迹；轨迹报告上下文、可能有用的技能、源覆盖、图形触摸、移交、检查点和时间线事件，而不包含原始提供商有效载荷。 - 从 `GET /telemetry/agents/runtime` 读取实时运行时遥测。 - 通过 `POST /memory/context-pack`、`POST /tools/context_pack` 或全局 `contextlattice_pack` 编译任务上下文；响应包括 `context_compiler`、排名证据、确定性 `agent_guidance` 用于主题/风险标记/候选注意力链接、提示部分和有界 `reference_prompt`。 - 通过全局 `contextlattice_synthesis_pack "<task>" --project <project> --pretty`、`POST /memory/synthesis-pack` 或 `POST /tools/synthesis_pack` 请求合成包 v1，当下一个代理需要分组的高信号发现、主题重力、图形/跨项目桥梁、必须记住的约束、推荐的下一步行动、开放问题和语义标签时。 - 通过 `scripts/agent/contextlattice-session watch --session-id <id> --continuation-token <token>` 监视长时间运行的召回；继续响应包括 `retrieval_progress.v1`、仪表板状态链接和代理可见的转向，当异步工作准备就绪时。 - 预飞行、context-pack 和 Dream Mode 返回具有 `objective_state`、`action_executed`、`evidence`、`objective_delta`、`risk_or_blocker` 和 `next_action` 的 `objective_runtime_state.v1`。 - 使用 `scripts/agent/contextlattice-agent-adapter` 或全局 `contextlattice_agent_adapter` 作为代理引导、context-pack、检查点、移交、状态、事件和完成流程的一流产品路径。 - 使用 `contextlattice_agent_adapter state --state working|awaiting_user|blocked|done --session-id <id> --pretty` 报告具有权威、源、TTL、本地会话 ID、任务 ID、存储库、工作树、分支、cwd 和用户/阻塞字段的语义代理生命周期状态。 - 使用全局 `contextlattice_agent_discover --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --repo . --pretty` 进行最佳努力的本地进程/配置文件/钩子/存储库指令发现。发现解释了 ContextLattice 为什么认为一个代理是空闲的、工作的、等待的、被阻塞的或集成的；它不取代显式钩子或适配器状态。 - 在将 ContextLattice 移交给新代理/帐户之前，使用 `scripts/agent/contextlattice-adopt` 或全局 `contextlattice_adopt`；`doctor` 结合网关健康、助手安装状态、shell PATH、存储姿势、会话存储、配置文件覆盖、最佳努力发现、运行时医生检查、生命周期证明和运行轨迹证据到一个有界的报告中。 - 在目标存储库中运行 `contextlattice_adopt integrate --repo . --agents codex,claude-code,opencode,hermes-agent,hermes-ultra,omp,mercury-agent,pi,droid --pretty` 以编写托管的 `AGENTS.md`、`CLAUDE.md`、`HERMES.md`、`MERCURY.md`、`PI.md` 和 `DROID.md` 指令块，而不覆盖用户文本。 - 运行 `contextlattice_doctor --agents codex --skip-provider-smoke --pretty` 以获得最快的新的代理采用证明。 - 相同的医生适用于其他代理配置文件：`contextlattice_doctor --agents claude-code --skip-provider-smoke --pretty`、`contextlattice_doctor --agents opencode --skip-provider-smoke --pretty` 或 `contextlattice_doctor --agents codex,claude-code,opencode --skip-provider-smoke --pretty`。 - 运行 `scripts/agent/agent-runtime-proof-pack --pretty` 或全局 `contextlattice_agent_runtime_proof --pretty` 以获得一个命令的实时证明，即引导、作用域召回、检查点、移交、完成、状态和运行时遥测已连接端到端。 - 使用 `scripts/agent/contextlattice-session` 进行 CLI 启动/事件/完成/失败/状态/运行时/跟踪流程。 - 使用 `scripts/agent/agent-run-trace --session-id <id> --tree` 或全局 `contextlattice_agent_trace --session-id <id> --tree` 查看终端跟踪，然后使用 `--markdown` 导出运行卡。 - 使用全局 `contextlattice_runner_quality --pretty` 检查有界的运行者质量遥测，以获取适配器成功/阻塞/失败率、context-pack 质量链接、精确提示令牌节省、建模推理避免信号和仅限于顾问的运行者建议。存储库本地 `scripts/agent/runner-quality --pretty` 仍然可用于开发回退。 - 使用 `scripts/agent/contextlattice-session sweep-stale-audits --all-projects --pretty` 以进行干燥运行首先清理过时的目标运行时审计/预飞行会话；仅在检查匹配项后添加 `--confirm`。 规范的事件家族包括 `session.started`、`agent.state.working`、`agent.state.awaiting_user`、`agent.state.blocked`、`agent.state.done`、`context_pack.completed`、`retrieval.continuation.progress`、`retrieval.continuation.ready`、`retrieval.continuation.degraded`、`dream.completed`、`graph.neighbors_returned`、`graph.edge_touched`、`decision.made`、`test.ran`、`handoff.created`、`writeback.completed` 和 `session.completed`。 代理生命周期和检索生命周期故意是分开的。`agent_lifecycle.state` 描述了参与者（`idle`、`working`、`awaiting_user`、`blocked`、`done`）；`retrieval_lifecycle.status` 描述了源获取进度。这可以防止异步检索预热被误读为阻塞或降级的代理。 运行者质量故意与两个生命周期表面分开。它是仅限于顾问的遥测，用于操作员选择，而不是自动调度。有关紧凑的适配器测量循环及其解释限制，请参见 `docs/runtime/runner-quality-loop.md`。 ## 下载安装程序 - macOS DMG：`https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-macOS-universal.dmg` - macOS 签名/ notarization 操作员说明：`docs/releases/macos-signing-notarization.md` - Homebrew cask：`brew tap sheawinkler/contextlattice && brew install --cask contextlattice` - Windows MSI：`https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-windows-x64.msi` - Linux 包：`https://github.com/sheawinkler/ContextLattice/releases/latest/download/ContextLattice-linux-bootstrap.tar.gz` ## 资源配置文件 | 配置文件 | CPU | RAM | 存储 | | --- | --- | --- | --- | | Lite 核心 | `2-4` vCPU | `8-12 GB` | `25-80 GB` | | Lite 高级 | `4-6` vCPU | `12-16 GB` | `80-140 GB` | | 完整 | `6-8` vCPU | `12-20 GB` | `100-180 GB` | 可选的约束磁盘保护：设置 `QDRANT_HOT_STORAGE_MAX_BYTES` 以使启动/存储验证在 Qdrant 热通道超过您选择的文件字节上限之前失败。这是一个防护措施，而不是文件系统配额。 可选的外部模型存储：设置 `OLLAMA_DATA` 为绝对路径，以将本地 Ollama 模型 blob 保存在受限的内部磁盘上。如果未设置，则现有的 home-directory 模型存储仍然是向后兼容的默认设置；启动存储验证拒绝挂载漂移。 ## 内存图 - `GET|POST /v1/memory/edges` 持久化显式类型关系。 - `POST /v1/memory/edges/backfill` 审计或应用确定性追溯边和选择加入相同项目的 `inferred_related` 评分。默认情况下为干燥运行。 - `POST /v1/memory/neighbors` 返回显式/推断边邻居与语义/主题邻居合并。 ```bash contextlattice_memory_graph_repair --project my-project --pretty contextlattice_memory_graph_repair --project my-project --write --confirm-project my-project --max-writes 500 --pretty contextlattice_memory_graph_efficacy --refresh-cases --project my-project --graph-max-cases 3 --pretty # 存储库本地高级回退；推断评分是选择加入的。 ./scripts/agent/memory-edge-backfill --project my-project --max-writes 500 ./scripts/agent/memory-edge-backfill --project my-project --include-inferred --min-confidence 0.90 ./scripts/agent/memory-edge-inferred-retrofill --project my-project --corpus disk --profile exploratory ``` ## 源回填 将现有数据带入 ContextLattice，而不更改摄取边界。 回填默认情况下为干燥运行，写入通过 `/memory/write` 进行，写入需要 `--write --confirm-write <project>`。 ```bash ./scripts/agent/source-backfill-memory --source jsonl --path exports/tasks.jsonl --project my-project --pretty ./scripts/agent/source-backfill-memory --source sqlite --path app.db --table notes --project my-project --pretty ./scripts/agent/source-backfill-memory --source parquet --path warehouse/events.parquet --project my-project --pretty ./scripts/agent/source-backfill-memory --source postgres --dsn "$DATABASE_URL" --query "select id,title,body from notes limit 100" --project my-project --pretty ./scripts/agent/source-backfill-memory --source jsonl --path exports/tasks.jsonl --project my-project --write --confirm-write my-project --apply-edges --pretty ``` 支持的适配器：文件/目录、JSONL、JSON、CSV、SQLite、DuckDB（通过 DuckDB）、Postgres（通过可选的 `psycopg`）。导入能力涵盖记录、行字节、文档字节、总字节和结构化列表项。默认情况下，类似机密的字段被遮蔽，图形边缘修复是可选且有界的。 ## 技能索引和隔离区发现 ContextLattice 公开了一个本地的 Go 技能索引，以便代理可以在不将每个 `SKILL.md` 加载到提示上下文的情况下发现相关能力。在本地安装中，活动索引默认情况下将 `${HOME}/.codex/skills` 挂载为只读。 - 活动索引端点：`GET|POST /v1/skills/index/search` - 活动索引工具：`GET|POST /tools/skills_index_search` - 活动索引状态/重新索引端点：`POST /v1/skills/index/reindex`（本地原生扫描；不加载提示） - 搜索端点：`GET|POST /v1/skills/quarantine/search` - 工具别名：`GET|POST /tools/skills_quarantine_search` - 重新索引端点：`POST /v1/skills/quarantine/reindex`（默认关闭；显式启用） 运行时旋钮： ```bash ORCH_SKILLS_QUARANTINE_ENABLED=true ORCH_SKILLS_QUARANTINE_HOST_BIN_DIR=${HOME}/.local/bin ORCH_SKILLS_INDEX_HOST_ACTIVE_ROOT_DIR=${HOME}/.codex/skills ORCH_SKILLS_INDEX_HOST_SYSTEM_ROOT_DIR=${HOME}/.codex/skills/.system ORCH_SKILLS_INDEX_ROOTS=/opt/contextlattice/skills_active:/opt/contextlattice/skills_system ORCH_SKILLS_QUARANTINE_HOST_ROOT_DIR=${HOME}/.codex/skills_quarantine ORCH_SKILLS_QUARANTINE_SEARCH_CMD=/opt/contextlattice/skills/bin/codex-skills-quarantine-search ORCH_SKILLS_QUARANTINE_REINDEX_CMD=/opt/contextlattice/skills/bin/codex-skills-quarantine-reindex ORCH_SKILLS_QUARANTINE_TIMEOUT_SECS=8 ORCH_SKILLS_QUARANTINE_DEFAULT_LIMIT=20 ORCH_SKILLS_QUARANTINE_MAX_LIMIT=100 ORCH_SKILLS_QUARANTINE_REINDEX_ENABLED=false CODEX_SKILLS_QUARANTINE_ROOT=/opt/contextlattice/skills_quarantine CODEX_SKILLS_QUARANTINE_INDEX_DIR=/opt/contextlattice/skills_quarantine/index CODEX_SKILLS_QUARANTINE_INDEX=/opt/contextlattice/skills_quarantine/index/skills_index.jsonl ``` ## 安全与隐私 - 默认本地优先。 - API密钥保护操作路由。 - 类似秘密的内容编辑控制。 - 高级计费/提供商路由映射故意不公开在文档中。 ## 文档索引 - 概述：`https://contextlattice.io/` - 架构：`https://contextlattice.io/architecture.html` - 本地AI工作空间比较：`https://contextlattice.io/local-ai-workspaces.html` - 扩展内存：`https://contextlattice.io/scaling-memory.html` - 维基：`https://contextlattice.io/wiki.html` - 安装：`https://contextlattice.io/installation.html` - 集成：`https://contextlattice.io/integration.html` - 故障排除：`https://contextlattice.io/troubleshooting.html` - 更新：`https://contextlattice.io/updates.html` - 计划和分发边界：`docs/public_overview/premium.html` - 取回收据和信任模型：[`docs/retrieval-receipts.md`](docs/retrieval-receipts.md) - 版本说明，新版本优先；旧版本为历史记录： - `docs/releases/v4.0.4.md`（故障关闭主机监督，有限恢复，真实卸载和安全升级迁移） - `docs/releases/v4.0.3.md`（生产仪表板运行时，模式感知探针，响应式图形路径和付费重放完整性） - `docs/releases/v4.0.2.md`（CLI、仪表板、文档、安装程序、发布门和通道许可之间的产品真相） - `docs/releases/v4.0.1.md`（公共安装程序边界修复，无需更改Aggregate Signal运行时语义） - `docs/releases/v4.0.0.md`（隐私边界的Aggregate Signal，明确同意，群体抑制和证明持有付费治理） - `docs/releases/v3.26.0.md`（零入口连续性，故障关闭目标选择和治理外部适配器意图） - `docs/releases/v3.25.0.md`（证据合格的技能演化，原子铸造交接和精确收据治理） - `docs/releases/v3.24.0.md`（签名协作授予，源证明导入和加密重放安全继续） - `docs/releases/v3.23.0.md`（Agent Fit转向，顾问选择，自适应配置文件和明确上下文准备） - `docs/releases/v3.22.0.md`（Policy Laboratory模拟，作用域学习，可逆生命周期，矛盾和存储治理） - `docs/releases/v3.21.0.md`（取回收据，信任隔离，消融，因果证明和治理付费操作） - `docs/releases/v3.20.3.md`（完整评估门和治理效率策略资格） - `docs/releases/v3.20.2.md`（源相同付费发布测试和精确工件来源） - `docs/releases/v3.20.1.md`（当前发布来源绑定和历史证明分离） - `docs/releases/v3.20.0.md`（验证Utility Ledger，精确上下文经济和顾问付费分析） - `docs/releases/v3.19.1.md`（无恐慌终端会话命令，规范生命周期事件和旧客户端修复） - `docs/releases/v3.19.0.md`（摘要验证Agent Packet增量，精确重建和一个间隙感知证明时间线） - `docs/releases/v3.18.0.md`（耐用连续性身份，保留锁定语义协调，共享目标图和见证决策来源） - `docs/releases/v3.17.5.md`（最新配置状态，有限所有者迁移和故障关闭语义读取器） - `docs/releases/v3.17.4.md`（回归锁定公共工件边界和完整安装程序发布） - `docs/releases/v3.17.3.md`（所有者本地存储，工作前批准，证据合格建议和精确运行时真相） - `docs/releases/v3.17.2.md`（操作员选择Ollama存储，验证安装真相和来源环境配置文件） - `docs/releases/v3.17.0.md`（规范商业真相，自包含安装程序，严格公共边界和微型包装身份） - `docs/releases/v3.16.1.md`（主要CLI的合约有效紧凑生命周期收据） - `docs/releases/v3.16.0.md`（紧凑Agent Packet，会话真相，单调异步，结果学习，统一CLI和证明工作台） - `docs/releases/v3.15.1.md`（Node 24 LTS在本地工具，容器，软件包和发布操作中的融合） - `docs/releases/v3.15.0.md`（有界图修复，明确图功效，水合邻居和耐用铸造退休） - `docs/releases/v3.14.0.md`（签名Context Passport和加密Context Mesh） - `docs/releases/v3.13.0.md`（结果训练的金丝雀策略和Skill Foundry） - `docs/releases/v3.12.0.md`（时间声明图，自适应检索规划和Proof-Carrying Synthesis v2） - `docs/releases/v3.11.2.md`（证据保留稀疏Context Packs和接地确定性合成） - `docs/releases/v3.11.1.md`（在长期代理环境中升级安全的运行程序发现） - `docs/releases/v3.11.0.md`（合成包，异步预热，结果校准，内存激活证据和公共核心一致性） - `docs/releases/v3.10.2.md`（Go本地反馈提交，幂等性，首选项投影和严格所有权覆盖） - `docs/releases/v3.10.1.md`（检测OMP/Mercury指令钩子和默认采用覆盖） - `docs/releases/v3.10.0.md`（可选Pi/Droid运行适配器，运行质量顾问和CLI优先公共界面） - `docs/releases/v3.9.1.md`（仪表板对比，设置清晰，公共站点对齐和当前版本指导） - `docs/releases/v3.9.0.md`（代理可操作上下文包结果遥测和观察提供商使用） - `docs/releases/v3.8.0.md`（MongoDB驱动程序v2迁移和Context Pack质量账本） - `docs/releases/v3.7.1.md`（MongoDB驱动程序v3.7版本的 安全补丁） - `docs/releases/v3.7.0.md`（代币器精确提示经济，有限代币影响账本和发布说明卫生） - `docs/releases/v3.6.2.md` - `docs/releases/v3.5.0.md` - `docs/releases/v3.4.25.md` - `docs/releases/v3.4.14.md` - `docs/releases/v3.4.13.md` - `docs/releases/v3.4.12.md` - `docs/releases/v3.4.11.md` - `docs/releases/v3.4.10.md` - `docs/releases/v3.4.5.md` - `docs/releases/v3.4.2.md` - `docs/releases/v3.4.1.md` - 本地模型选项：`docs/runtime/local-model-options.md` ## 许可证 Apache License 2.0 (`LICENSE`).