Mon, 01 Jan 0001 00:00:00 +0000

Chip 机制设计决策#

1. 设计动机#

在 MCP（Model Context Protocol）调用链路中，LLM 生成的工具参数常常因为 JSON 转义、字段缺失、格式错乱等原因导致调用失败。一旦失败，原始的参数内容可能只出现在一次性的错误响应里，后续轮次中模型很难精确复现完全相同的内容，尤其是大段代码写入（be-write）或多行替换时。

Chip 机制的核心目标是把“失败现场”或“被删除的内容”临时保存下来，作为模型后续恢复操作的可靠数据来源。它相当于在进程内维护了一个轻量级的 FIFO 缓存队列，让 LLM 可以通过专用工具 be-insert-chip 把之前丢失或删除的内容重新插入到目标文件中，从而降低因一次调用失败而导致整轮任务中断的概率。

2. 何时会创建 chip#

当前有两种场景会触发 chip 记录：

2.1 工具调用失败时自动保存参数#

当某个工具调用返回错误，且入参序列化后的 JSON 长度大于 50 字节时，服务端会调用 SaveChip(tool, args, errMsg) 把原始参数保存为 chip。

func SaveChip(tool string, args map[string]any, errMsg string) string

参数 JSON 长度 ≤ 50 字节时不保存，避免记录过多无意义的短参数。
保存成功后返回 chip ID（如 a3f7b2）；不需要恢复时返回空字符串。

2.2 删除操作时保存被删除内容#

be-delete 在真正落盘前，会把被删除的非空内容通过 SaveContentChip 保存为 chip，并在返回的 warnings 中提示模型：

deletedContent := strings.Join(fileLines[start-1:end], "")
if deletedContent != "" {
 chipID, chipWarn := SaveContentChip("be-delete", deletedContent)
 warnings = append(warnings, fmt.Sprintf("deleted content saved as chip://%s", chipID))
}

这让误删后可以通过 be-insert-chip 把内容重新插回文件。

Decisions on better-edit-tools 文档

Chip 机制设计决策#

1. 设计动机#

2. 何时会创建 chip#

2.1 工具调用失败时自动保存参数#

2.2 删除操作时保存被删除内容#