@jinshuxuan/dsh-context-budget

LIMITATIONS

Known limitations

1. **预览是字符预算**：`keepHeadChars` / `keepTailChars`；都为 0 时才回落到按行。极短行数的超长结果（单行 JSON）现在也会外置。 2. **`accept + content` 会丢结构化 value**：只对文本型结果使用，别把机制套到有结构化输出的工具上。 3. **`agent.ctx` 没有文档承诺**：拿不到时 G1 整体跳过，绝不用全局 ctx 收紧（那会影响所有会话）。 4. **L0 的 token 是估算**：优先用 `assistant/message.data.usage`（含 `cacheReadTokens`），缺样本才按 2.2 字符/token 粗估。**用于比较构成，不用于计费。** 5. **`read_many` 不能替代 `read`**：它走 `ctx.fs` 读取，但 DSH 文档明确写 "Direct ctx.fs reads emit no fs/observed"，所以它不满足"编辑前必须先读"的策略——因此**不要**在精简档里把 `read` 裁掉。 6. **`/budget` 不进模型工具表**（commands registry），但它的输出会进会话。 7. **G2 的收益依赖会话长度**：一条结果进入上下文后会被重发，剩余步数越多越划算；短任务里外置可能持平甚至略亏。