Skip to content

v0.2.0 - Multi-Language Tree-sitter AST, Tool Delta Shadow State & CoT Manager

Choose a tag to compare

View all tags
@255308153 255308153 released this 17 Sep 06:29
· 35 commits to main since this release
v0.2.0
de7dee0

CtxGuard v0.2.0: 工业级多语言 AST、影子状态增量差分与智能守护系统

CtxGuard v0.2.0 是一次重磅架构升级，深度融合并超越了业界顶级上下文优化方案，全面引入了基于 Tree-sitter 纯 C 绑定的多语言 AST 代码骨架引擎、会话级 Tool Delta 影子状态机增量差分、终端超长日志智能截断、跨厂商思考链生命周期治理以及敏感凭证安全脱敏器。

核心新特性与优化亮点

1. 工业级 Tree-sitter 纯 C 多语言 AST 代码骨架引擎 (TreeSitterSkeletonizer)

  • 9+ 门语言原生支持：Python, JavaScript, TypeScript, TSX, Go, Rust, Java, C, C++ 毫秒级语法树解析。
  • 微秒级性能：基于官方预编译纯 C 绑定，单文件解析耗时 < 1ms，比纯 Python AST 方案快 5~10 倍。
  • 100% 语法鲁棒性：逐字节精准定位函数与类体，完美免疫注释括号、模板字符串及 JSX 嵌套。
  • 无损可逆展开：提取签名与 Docstring，折叠实现体并存入本地 SQLite 指纹池，支持通过 ctx_expand 随时无损调阅。

2. Tool 调用影子状态机与增量差分器 (ToolDeltaCompressor)

  • 会话级影子快照：维护每个 Session 的环境与文件状态快照（针对 list_dir、find_by_name、git status 等探针指令）。
  • Jaccard 集合相似度探测：智能识别同源状态探测（相似度 >= 0.5 触发）。
  • 集合增量差分：精确计算 + Added 与 - Removed 项，折叠海量未变更条目为 ... (K items unchanged)，将 2500+ Tokens 的状态刷新压缩至 30 Tokens（Token 消耗削减 90%+）。

3. 终端超长日志全局 Head-Tail 智能截断器 (LogTruncator)

  • 针对超长构建与测试日志：自动识别 npm test、cargo build、pip install 产生的数千行长日志。
  • 智能滑动窗口：保留头部 25 行（环境参数、版本信息）与尾部 75 行（核心报错堆栈与退出代码），中间折叠并存入指纹池（Token 消耗降低 80%+）。

4. 跨轮次思考链（CoT / Thinking）生命周期治理 (ThinkingManager)

  • DeepSeek-R1：多轮历史中自动剥离 reasoning_content 与 标签，严格遵守 DeepSeek 官方规范，杜绝思考过程二次计费。
  • Google Gemini：自动剔除历史 块，保持 Payload 纯净。
  • Anthropic Claude 3.7：在前置窗口内保留 thinking + signature 保证 100% 享受官方 KV Cache 缓存折扣；当思考累积超限（默认 16K）或冷重整时安全修剪历史废弃思考，杜绝爆窗。

5. 敏感数据与 API 密钥安全脱敏器 (SecretRedactor)

  • 多凭证类型识别：自动拦截并脱敏 OpenAI / Anthropic / GitHub / AWS / JWT 密钥及 Bearer Tokens。
  • 私钥与证书保护：PEM 私钥证书与数据库连接密码自动打码，杜绝明文凭据外泄至云端。

自动化测试与工程质量

  • 测试用例：全量 156/156 单元测试与端到端测试 100% 通过（耗时 4.36s）。
  • 零外部服务依赖：纯 Python + C 扩展架构，无需 Docker / Redis / Milvus，单文件免运维。

安装与使用

# 方式一：从 Release 附件 Wheel 包直接安装
pip install ctxguard-0.2.0-py3-none-any.whl

# 方式二：直接从 GitHub 仓库安装
pip install -U git+https://github.com/255308153/CtxGuard.git

# 启动代理网关
ctxguard start --port 8787
Assets 4
Loading