write - 文件写入
创建或覆盖写入文件
写入内容到文件。文件不存在则自动创建,已存在则整体覆盖。自动创建父目录。
修改已有文件时优先使用 edit,它只传改动的部分;write 用于新建文件或整体重写。
依赖
无额外依赖,默认可用。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
path |
string | 是 | 文件路径 |
content |
string | 是 | 要写入的内容 |
安全检查
写入前会做几项检查,异常时在结果中给出提示:
- 文件被外部改动:若文件在 Agent 读取之后被其他程序修改过,会附带提醒,避免覆盖他人改动。
- 语法检查:内容若是 JSON / YAML / TOML 且解析失败,会拒绝写入并保持文件原样——这类文件半截即损坏,也能顺带拦下模型输出被截断的情况。源码文件(如
.py)只在本次写入引入了新语法错误时给出告警,不阻止写入。 - 凭证保护:存放 API Key 的
~/.cow/.env不允许通过本工具写入,请使用env_config工具。
使用场景
- 创建新的代码文件或脚本
- 生成配置文件
- 保存处理结果