Skip to content

docs(context): 新增 Context Layer 上下文治理层架构方案; - #1099

Merged
ThreeFish-AI merged 1 commit into
feature/1.x.xfrom
ThreeFish-AI/context-architecture-design
Aug 4, 2026
Merged

docs(context): 新增 Context Layer 上下文治理层架构方案;#1099
ThreeFish-AI merged 1 commit into
feature/1.x.xfrom
ThreeFish-AI/context-architecture-design

Conversation

@ThreeFish-AI

Copy link
Copy Markdown
Owner

背景

  • 本次变更要解决的问题:negentropy 缺少统一的上下文层,记忆 / 知识 / 工具 / 技能的上下文信号在运行期分散组装(_dynamic_instructionmodel_resolverskills_injector),存在三大结构性缺口——① 存储层检索未统一(HybridPlanner 覆盖 KB+KG 但不含 Memory);② 双通道割裂(ContextAssembler 注入记忆+KG 摘要但不接地 KB chunks);③ 信任信号未归一且代码回退可绕过治理。
  • 关联上下文/Issue/文档:对标 Snowflake Horizon Context;理论基线见 Context Engineering 调研;SSOT 锚定 framework.md / self-evolving-agents.md / skills.md

核心变更

  • 新增设计文档 docs/concepts/design/context-layer.md(504 行,3 张 Mermaid 图,IEEE 引用),作为「上下文层」单一权威参考。
  • 架构定位:Context Layer 为横向治理织物,横亘 Memory/KB/KG/Tools/Skills 之上,不替代既有子系统(正交分解:机制与策略分离)。
  • Context Catalog:用 PostgreSQL VIEW(非新物理表,SSOT 防 Split-Brain)+ 信任信号归一化公式(按 item_type 加权到 [0,1])。
  • 统一激活:扩展 HybridPlanner 接入 Memory 源 + ContextAssembler 接地 KB chunk + 新增 ContextGuard 引擎级治理兜底(含回退路径,对标 Horizon「不可绕过」)。
  • 进化集成:第 7 个进化杠杆 context_strategy(沿用既有 6 个 TargetHandler 状态机)+ 三阶段演进路线(全程 additive + 特性开关 + fail-soft)。
  • 登记同步knowledge-map.md(系统概念与设计段)+ research/readme.md(认知与上下文段)。

风险与回滚

  • 主要风险:纯文档变更,无运行时风险;方案所规划改动均为设计提案,尚未落地代码。
  • 回滚方式:git revert 单个 commit 即可。

验证证据

  • 单元测试:N/A(纯文档)。
  • 集成测试:N/A。
  • E2E/Workflow:build_docs_pack(纯函数)秒级确认文档入 nav(entry_slug: concepts/design/context-layer,位次 10/10);全部相对链接可跳转(含代码锚点);Mermaid 结构平衡(11 subgraph / 11 end,配色对齐 self-evolving-agents.md)。
  • 覆盖率/关键截图:N/A。

影响范围

  • 前端:无。
  • 后端:无(仅设计文档,未改任何代码)。
  • GitHub Actions / 文档:新增 context-layer.md + 2 处索引登记。

Next Best Action

  • 请 Review 文档(章节深度 / 信任公式权重 / 演进路线优先级);认可后,Phase 1(Context Catalog 视图 + 信任归一纯函数 + HybridPlanner 接入 Memory,默认关)风险最低,可作为首个实现 PR。

🤖 Generated with Claude Code, CodeX, Gemini

对标 Snowflake Horizon Context(Collect/Enrich/Activate 三相 + Structural/Operational/Semantic/Behavioral 四信号层 + 引擎级治理不可绕过)设计 negentropy 统一上下文治理层:横向治理织物横亘 Memory/KB/KG/Tools/Skills 之上,不替代既有子系统。

核心内容:
- Context Catalog 逻辑视图(PostgreSQL VIEW 非新表,SSOT 防 Split-Brain)+ 信任信号归一化公式
- 统一激活:扩展 HybridPlanner 接入 Memory 源 + ContextAssembler 接地 KB chunk + ContextGuard 兜底治理(含回退路径)
- 五子系统上下文契约(Memory/KB/KG/Tools/Skills)+ context_strategy 进化杠杆(第 7 个 TargetHandler)
- 三阶段演进路线(Phase1 目录+信任归一+Memory入Planner / Phase2 Router+Guard / Phase3 Universal Search+溯源)
- 3 条 ADR + 风险对策 + 与 framework/self-evolving/skills 自洽性核对

同步登记 knowledge-map「系统概念与设计」段与 research/readme「认知与上下文」段。

🤖 Generated with [Claude Code](https://github.com/claude), [CodeX](https://openai.com), [Gemini](https://github.com/apps/gemini-code-assist)
Co-Authored-By: Aurelius Huang<threefish.ai@gmail.com>
@ThreeFish-AI
ThreeFish-AI merged commit 05ad6dd into feature/1.x.x Aug 4, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant