Menu
文件操作工具集 — 读取、按行读取、写入、追加、精确编辑、列目录、目录树、文件信息、搜索、复制、移动、创建目录、删除文件。默认受沙箱保护，环境变量可放开沙箱外路径。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | file |
| description | 文件操作工具集 — 读取、按行读取、写入、追加、精确编辑、列目录、目录树、文件信息、搜索、复制、移动、创建目录、删除文件。默认受沙箱保护，环境变量可放开沙箱外路径。 |
| version | 1.1 |
| category | core |
| enabled | true |
| tags | ["file","core","filesystem"] |
file 提供本地文件系统操作。路径解析保留，可通过环境变量放开沙箱外路径。
plugins/file/
| 工具 | 用途 |
|---|---|
read_file | 读取整个文件，支持 UTF-8 / UTF-8 BOM / GBK 回退，无大小限制 |
read_file_range | 按行读取，支持 start_line/end_line 或 tail 读取日志尾部 |
write_file | 完整覆盖写入文件，自动创建父目录 |
append_file | 追加写入文件，不存在则创建 |
edit_file | 精确编辑：insert / replace_line / replace_range / replace_text，默认创建 .bak 备份 |
list_dir | 列出目录内容，文件夹置前排序 |
tree_dir | 输出目录树，默认跳过 .git、node_modules、.venv、dist、build 等大目录 |
stat_file | 查看文件或目录类型、大小、创建时间、修改时间 |
search_files | 搜索文件名、文件内容或代码定义，支持 scope、context_lines 和 fd/rg 加速 |
copy_file | 复制文件，目标必须是完整文件路径，默认不覆盖 |
move_file | 移动或重命名文件，目标必须是完整文件路径，默认不覆盖 |
make_dir | 创建目录，默认递归创建父目录 |
delete_file | 删除文件，严格禁止删除目录 |
| 参数 | 说明 |
|---|---|
mode (enum) | insert / replace_line / replace_range / replace_text |
text | 插入内容、新行内容或替换后的文本 |
line / column | 起始行号 / 列号（1-based） |
end_line / end_column | 结束行号 / 列号（replace_range 模式） |
old_text | replace_text 模式下要替换的原文 |
expected_count | 期望匹配次数，默认 1；设为 -1 跳过检查 |
create_backup | 是否创建 .bak 备份，默认 true |
| 参数 | 说明 |
|---|---|
start_line / end_line | 行号范围（1-based），end_line=0 按 max_lines 截断 |
tail | 读取末尾 N 行；大于 0 时优先于行号范围 |
max_lines | 最大返回行数，默认 500，上限 50000 |
| 参数 | 说明 |
|---|---|
mode (enum) | file / name（文件名）/ text / content（内容）/ code（代码定义） |
scope (enum) | workspace / user / both |
root | 搜索根目录，非空时优先于 scope |
file_glob | 文件名 glob 过滤，如 *.py |
max_results | 最大结果数，默认 50，上限 5000 |
context_lines | 匹配行上下文行数，默认 0，上限 100 |
regex | query 是否按正则处理 |
路径解析保留（兼容相对路径和绝对路径）。以下环境变量可选地控制路径访问范围：
| 环境变量 | 效果 |
|---|---|
VOTX_FILE_OUTSIDE_SANDBOX=1 | 允许所有 file 工具操作沙箱外路径 |
VOTX_FILE_READ_OUTSIDE_SANDBOX=1 | 允许 read_file、read_file_range、list_dir、tree_dir、stat_file、search_files 访问沙箱外路径 |
VOTX_FILE_EDIT_OUTSIDE_SANDBOX=1 | 允许 write_file、append_file、edit_file、copy_file、move_file、make_dir 操作沙箱外路径 |
VOTX_FILE_WRITE_OUTSIDE_SANDBOX=1 | 同上，作为写入类操作的别名 |
VOTX_FILE_DELETE_OUTSIDE_SANDBOX=1 | 允许 delete_file 删除沙箱外文件 |
不设置时默认允许项目根和用户目录；设置后允许全路径访问。
read_file / read_file_range：返回文件内容文本（read_file_range 带行号前缀和文件头信息）write_file / append_file / edit_file / copy_file / move_file：返回工具结果 JSON（含文件 artifact）list_dir / tree_dir：返回目录列表/树形结构文本stat_file：返回文件/目录元信息（类型、大小、修改/创建时间）delete_file / make_dir：返回 OK: 前缀的成功消息search_files：返回匹配结果列表ERROR: 前缀的错误信息read_file_range 的 tail 或行号范围，不用 read_file 全量读取edit_file 的 replace_text，并设置 expected_count=1 确保精准匹配search_filescopy_file 和 move_file 的目标路径必须是完整文件路径；目标是目录时会报错delete_file 只删除文件，拒绝删除目录read_file 支持 UTF-8 → UTF-8 BOM → GBK 自动回退；如仍失败，指定 encoding="gbk"old_text 是否与文件内容完全一致（包括空格、换行），调整 expected_countscope 包含目标目录；尝试 include_hidden=true 或调整 file_globwrite_file 是完整覆盖写入，不是追加；追加用 append_fileedit_file 的 replace_text 模式默认 expected_count=1，如果原文出现多次会报错；设为 -1 跳过检查tree_dir 默认跳过 .git、node_modules 等大目录，需要查看时设 include_hidden=true 或 max_depth 更大search_files 的 max_results 上限 5000，context_lines 上限 100，超限自动截断通用下载编排器。下载公开可访问、开源授权或用户本人授权的数字资源；提供 inspect_download_url、download_direct_file、download_video、list_downloads 四个工具。
本地双层知识库检索与问答。用户要求从知识库、资料目录或本地文档中查信息、总结、核对来源时使用。先按 data_structure.md 分层导航，再渐进检索候选文件；遇到 PDF/Excel 时先读取本 Skill 的 references 处理指南。
双模式记忆管理：保存、读取、搜索、删除、审阅和清理用户记忆。被动模式只处理临时层；主动审阅读取临时+永久并将有价值内容晋升到永久层。用户要求记住、忘记、搜索记忆、审阅记忆、清理记忆时使用。
VOTX Agent run_command tool usage guide for safe local command execution.
创建或更新 VOTX Agent Skill 的指导技能。用于设计 SKILL.md、工具型或指令型 Skill、scripts/references/assets 资源、触发描述、渐进式披露结构，以及验证现有 Skill 是否适配框架。
将复杂用户请求自动分解为可执行步骤计划，可视化进度，支持暂停/继续/中止。受用户 config.json 中 task_plan.accept_task 控制。