Files
AirPlan-V2/commands/ctx.md
AirLongDian 9ad232af38 docs: 全部 12 个命令文件完整化 — 消除 P0/P1 操作歧义
P0: 9 个存根命令文件从 11 行模板扩展为完整操作文档
- dbg: 7 步工作流表格 + 证据类型 + 子命令 + Dbg↔Do 集成路径
- ctx: 三级降级压缩 + 质量校验 + Token 估算 + 陈旧锁清理
- dep: SSH 部署流程 + MD5 校验 + systemd 管理
- tst: 5 种测试框架 + run 命令 + T-TEST 集成
- sec: advisory/blocking 双模式 + 文件/目录/Woker result 三种扫描
- rvr: 审查模式 + highRiskAudit + code-to-design + Eng merge 集成
- sdb: 6 种后端 + diff 模式 + Dbg 取证集成
- ndb: 网络抓包 + Dbg 取证集成
- xdb: kmsgrab/xvfb/fallback 三后端 + Dbg/Do GUI 验证集成

P1: 3 个有内容文件的歧义修复
- do: AirDbg 路由具体命令 + 证据采集(xdb/ndb/sdb/tst)命令
- arc: 三阶段→命令映射表 + phase 推进方式
- eng: monitor 轮询循环伪代码(Agent 无时钟概念,必须循环调 monitor)

全部命令统一使用 `python scripts/airplan.py` 路径(清除旧 $HOME/plugins 引用)

63 项功能测试全通过

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-11 15:57:12 +08:00

66 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
description: "AirPlan ctx mode - context manager: compression, token estimation, stale lock detection"
argument-hint: "[enter|compress|validate|estimate|status]"
allowed-tools: "[Read, Glob, Grep, Bash, Write, Edit]"
---
# /ctx
AirContext 管理上下文压缩、Token 估算、陈旧锁检测。三级降级压缩策略:重试 → 换模型 → 截断。
## 硬规则
1. **压缩质量校验** — 压缩后必须调用 `--sub validate` 验证关键信息ADR 引用、TODO、文件路径保留率 ≥70%
2. **压缩前备份** — 每次压缩自动备份原文件为 `.bak`
3. **陈旧锁清理** — 检测到锁持有进程已死则自动清理
## 三级降级压缩
1. **RETRY** — 重新压缩(换 prompt
2. **FALLBACK_MODEL** — 换模型压缩
3. **TRUNCATE** — 放弃压缩,保留原始上下文,通知用户
## 子命令
### enter — 初始化上下文管理器
```bash
python scripts/airplan.py --mode ctx --project . --sub enter
```
### compress — 压缩上下文
```bash
python scripts/airplan.py --mode ctx --project . --sub compress
```
读取 `AirPlan/context.md`执行三级降级压缩。emit `context.compacted` 事件。
### validate — 校验压缩质量
```bash
python scripts/airplan.py --mode ctx --project . --sub validate
```
检查压缩是否保留关键模式文件路径、ADR-XXXX、TODO/FIXME、INV-X。返回 `{validation_ok, level, tokens}`
### estimate — Token 估算
```bash
python scripts/airplan.py --mode ctx --project . --sub estimate
```
按内容类型(中文/英文/代码/Markdown分比率估算 token 数。
### status — 查看状态
```bash
python scripts/airplan.py --mode ctx --project . --sub status
```
## 集成路径
**Eng 压缩检查**:每轮 `monitor_engine()` 后可调 `--sub validate` 检查上下文质量。
**Do Worker 压缩**:长任务 Worker 可在执行前调 `--sub compress` 精简上下文。