---
## ⚡ 插件概览与问题背景
超长代码库上下文与冗长的构建/测试输出流会迅速填满大语言模型的上下文窗口，造成严重的 Token 资金浪费、显著增加推理延迟，并导致智能体注意力涣散与幻觉。
**`dsh-context-lens`** 提供了完整的上下文优化管线：
1. **工作区焦点聚焦 (`context_lens_focus`)**：对当前正在编辑的核心文件保持 100% 完整源码，将其余依赖代码库自动精简为轻量级 AST 骨架。
2. **多语言 AST 结构骨架化**：支持 TypeScript, JavaScript, Python, Go, C/C++, Rust, SQL DDL，完整保留类型、类结构与函数签名，将源码体积削减 **70–85%**。
3. **启发式测试日志压缩**：自动消除测试通过的冗余输出，精准萃取关键报错堆栈、断言差异与失败上下文，将日志体积削减高达 **90%**。
4. **会话 Token 遥测与预算守卫**：实时精确统计压缩前后节省的 Token 数量，支持自定义预算水位预警并在 DSH 界面直观显示。
```mermaid
graph LR
subgraph RawContext [原始工作区与终端输出流]
Code[📁 多文件源码: 包含冗长实现细节] --> LensEngine[dsh-context-lens 压缩引擎]
Logs[📋 测试与构建日志: 包含海量通过噪音] --> LensEngine
end
subgraph LensEngine [上下文加工管线]
LensEngine --> Focus{焦点状态研判}
Focus -->|当前聚焦文件| RawKeep[保留完整源码细节]
Focus -->|非聚焦代码库| AST[AST 骨架提取: 类型、类名、方法签名]
LensEngine --> LogFilter[日志精简器: 过滤噪音，保留报错堆栈]
end
subgraph Savings [Token 收益与推理加速]
AST --> Agent[🤖 DSH 智能体: 极速紧凑的高价值上下文]
RawKeep --> Agent
LogFilter --> Agent
Agent --> Tracker[📊 实时 Token 节省率监控]
end
style RawContext fill:#1e1e2e,stroke:#89b4fa,stroke-width:2px,color:#cdd6f4
style LensEngine fill:#181825,stroke:#cba6f7,stroke-width:2px,color:#cdd6f4
style Savings fill:#11111b,stroke:#a6e3a1,stroke-width:2px,color:#cdd6f4
```
---
## ✨ 核心特性深度解析
### 1. 🧬 跨语言 AST 结构骨架提取器
* **支持语言**：TypeScript, JavaScript, Python, Go, C/C++, Rust 以及 SQL DDL。
* **架构完整性**：保留所有模块导入、类定义、接口、导出类型、函数签名与文档注释，剔除内部庞大实现细节。
* **多行签名提取**：无缝解析复杂的跨行泛型参数、长参数列表与返回类型注解。
* **纯正则轻量化实现**：零重型原生依赖，零二进制解析器包袱，极速跨平台运行。
### 2. 📋 启发式终端日志精简引擎
* **支持测试与构建工具**：Jest, Vitest, Pytest, Go test, Cargo, Webpack, Vite, TSC, Maven, Gradle。
* **定向错误萃取**：精准识别报错摘要、异常调用堆栈、断言匹配差异 (`Expected ... Received ...`) 与错误上下文窗口。
* **3 种压缩模式**：
- `raw`：过滤基础噪音行，保留总体执行日志。
- `balanced`：在压缩率与报错上下文之间保持平衡（默认推荐）。
- `aggressive`：严格仅保留报错行与堆栈帧。
* **ANSI 码清理**：预先剥离终端控制字符与彩色 ANSI 转义序列。
### 3. 🎯 会话文件焦点范围管理 (`context_lens_focus`)
* 允许针对当前任务设定一组活跃聚焦文件或目录。
* 焦点文件保持完整代码，未聚焦文件自动折叠为 AST 结构骨架。
* 焦点状态在会话级别严格隔离 (`sessionId`)，可通过 UI 或 API 一键清除。
### 4. 📊 Token 消耗遥测与预算守卫
* 采用精准分词估算逻辑，实时计算压缩前后的 Token 变化。
* 统计累计节省 Token、压缩比率与会话预算百分比。
* 支持设置预警阈值 (`budgetAlertPercent`)，预算临界时动态发出提示。
### 5. 🖥️ 视觉界面与双侧边栏原生集成
完全遵循 `.cl-*` 设计标准与 DeepSeek Harness `--dsw-alias-*` 主题变量系统：
* **对话顶栏微件**：挂载于 `conversation.session.header.utilities` 槽位（`order: 7`）。常态化显示效率徽章（`◐ Lens`, `◐ 
