Context Packages让你将项目积累的知识——事实、图结构、会话发现、注意事项和模式——捕获到一个可移植的、版本化的包中。为队友导出包，从共享库导入领域知识，或在每次会话启动时自动加载项目约定。
包层级
每个包可以包含一个或多个层。只包含你需要的——从有针对性的知识事实到全面的项目快照。
知识
从项目中提取的持久化事实、约束和领域知识。
图
捕获代码结构、依赖关系和调用关系的属性图节点和边。
会话
来自先前编码会话的会话发现和决策。
模式
为你的技术栈调优的Shell压缩模式和输出格式规则。
注意事项
代理应该了解的已知陷阱、边缘情况和警告。
CLI命令
完全通过命令行管理上下文包。所有操作支持JSON输出以便CI/CD集成。
| Command | Description |
|---|---|
lean-ctx pack create --name my-pkg --layers knowledge,graph | 从当前项目的上下文创建包 |
lean-ctx pack list | 列出所有已安装的包及其版本和自动加载状态 |
lean-ctx pack info my-pkg | 显示包元数据、层、统计信息和完整性哈希 |
lean-ctx pack export my-pkg -o my-pkg.lctxpkg | 将包导出为可移植的.lctxpkg文件以便共享 |
lean-ctx pack import my-pkg.lctxpkg | 从.lctxpkg文件导入包到本地注册表 |
lean-ctx pack install my-pkg | 安装并合并包上下文到当前项目 |
lean-ctx pack remove my-pkg | 从本地注册表中移除包 |
lean-ctx pack auto-load my-pkg on | 启用或禁用会话启动时的自动加载 |
Quick Start
# Create a package with knowledge and graph layers
lean-ctx pack create --name my-project-ctx --layers knowledge,graph
# Export for sharing
lean-ctx pack export my-project-ctx -o my-project-ctx.lctxpkg
# Teammate imports and installs
lean-ctx pack import my-project-ctx.lctxpkg
lean-ctx pack install my-project-ctx
# Enable auto-load for future sessions
lean-ctx pack auto-load my-project-ctx on自动加载
标记包进行自动加载。当ctx_overview在会话启动时运行，所有启用自动加载的包都会合并到活跃项目上下文中——知识事实、图数据和注意事项立即可用。
$ lean-ctx pack auto-load my-pkg on
完整性与安全
每个包包含从规范JSON序列化计算的SHA-256内容哈希。导入操作在合并前验证完整性。所有文件操作使用原子写入（tmp + rename）以防止损坏。
$ lean-ctx pack info my-pkg
集成
导入的知识事实以置信度上限合并。图节点和边添加到属性图中。注意事项按ID去重。会话发现丰富历史记录。一切与现有的LeanCTX管道集成。