context-doctor

Context Doctor

诊断并可视化上下文窗口预算的分配情况。

快速开始

运行可视化脚本：

python3 scripts/context-doctor.py

脚本会自动检测：

• 工作区路径（~/.openclaw/workspace 或 OPENCLAW_WORKSPACE 环境变量）
• OpenClaw 版本（通过 openclaw --version）
• 已安装的技能（系统级 + 工作区级）
• 引导文件的大小和状态

输出部分

1. 工作区文件

显示每个引导文件的：

• 状态：✓ 正常 / ✗ 缺失 / ⚠ 已截断（符号链接目标缺失 = 缺失）
• 字符数和 Token 数：原始大小和估算的 Token 数（字符数/4）
• 可视化进度条：与文件大小成比例

2. 已安装的技能

列出从系统和工作区技能目录中发现的所有 SKILL.md 文件。 技能按需加载，不属于引导内容——此处仅供了解。

3. Token 预算

细分引导开销：

• 系统提示词（框架）
• 工作区文件（扫描结果）
• 技能列表（元数据描述）
• 工具架构 + 摘要

显示引导内容占比，以及可用于对话的剩余空间。

诊断信号

信号	含义	操作
🔴 已截断	文件超出最大字符数，内容被静默截断	缩小文件或拆分内容
🟡 缺失	文件未找到或符号链接失效	检查路径并修复符号链接目标
🟢 引导内容 <10%	状况良好	无需操作
🟠 引导内容 >15%	占用较多	检查工作区文件是否过于臃肿

图片输出（用于聊天 / 分享）

直接生成 PNG 图片——无需截取终端屏幕：

python3 scripts/context-doctor.py --png /tmp/context-doctor.png

脚本通过 Rich SVG 导出渲染彩色终端风格图片。 需要：rich（pip3 install rich）以及以下工具之一：rsvg-convert（brew install librsvg）或 cairosvg（pip3 install cairosvg）。

Agent 工作流：用户在聊天中询问上下文健康状况时，使用 --png 运行并直接发送图片。成功时，输出路径会打印到标准输出。