PROJECT 04 · OPEN SOURCE · GIT CONTEXT
Context Loader
将本地 Git 工作树上下文确定、有界地渲染为 Markdown 或 JSON。
01 · Overview
项目概述
Context Loader 为一个本地 Git 工作树渲染确定性、有界的上下文：读取仓库状态与一组固定的根文件，不抓取、不执行仓库代码、不访问网络，也不写入目标仓库。
默认 Markdown 输出覆盖 Git 状态、开发指令、项目概览、声明命令、入口文件、近期提交与目录树；稳定的 JSON 接口面向机器调用方，附带内容哈希与状态码。
相同输入产生逐字节一致的输出，使上下文可复核、可复现；固定的文件选择与大小上限保持传输有界。
02 · Capabilities
核心能力
- 01
有界根上下文
只读取固定的根候选文件——AGENTS.md、README.md 与声明的入口文件——并施加显式大小上限。
- 02
Markdown 与 JSON 契约
输出稳定的 Markdown 分节或带内容哈希与机器可读状态码的版本化 JSON 文档。
- 03
确定性渲染
相同工具版本、参数与仓库状态产生逐字节一致的输出。
- 04
净化 Git 访问
以固定路径的 Git 可执行文件（不通过 PATH 解析）与净化环境运行，忽略系统级、全局与每条命令的配置、attributes 及钩子。
03 · Workflow
工作流程
- 01
定位 Git 根
- 02
采集有界根文件
- 03
渲染 Markdown / JSON
- 04
复核状态与哈希
04 · System View
系统视图
- 01
CLI 与契约层
- 02
仓库采集层
- 03
渲染与选择层
- 04
机器可读输出层
05 · Current State
当前状态
已实现
1.1.0 已发布至 PyPI（context-loader 发行版，project-context 命令），支持 Markdown 与 JSON 输出模式，运行时零第三方依赖。
当前阶段
保持声明的 JSON schema 与 Markdown 分节契约对机器调用方稳定。
后续方向
继续作为仓库根上下文的有界传输；指令层级的解析由调用方的 Agent 框架负责。
06 · Principles
设计原则
- 01
相同输入输出逐字节一致；不同检出或工作树可能改变结果。
- 02
固定选择不是自动脱敏：分享前先检查输出。
- 03
工具只采集与渲染，不抓取、不执行仓库代码、不访问网络。