工作区只读文件浏览器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/file-browser-2。
技能介绍
要解决的问题
在 Agent 里让模型「看仓库」时,若直接放开 exec 或绝对路径,很容易出现路径逃逸、误读二进制大文件,或在错误目录里乱翻。你需要的是:固定根目录、相对路径、只读,并把结果收成结构化 JSON,便于在对话里继续推理。
技能如何工作
技能约定工作区根为 WORKSPACE(资料中的 OpenClaw / skill-platform workspace),所有路径都相对该根解析;输入会先清洗,拒绝绝对路径与越界访问。
- 列目录:
exec("scripts/list_files.sh", [rel_path]),返回{success, data, error},data为条目名数组。 - 读文件:
exec("scripts/read_file.sh", [rel_path]),data为文本内容;非文本、过大或无法按文本读取时走error。 - 流程:从用户意图解析
list/read与相对路径 → 调对应脚本 → 解析 JSON → 用自然语言反馈;空路径默认"."(工作区根)。
安全上强制只读:不写、不删、不执行用户自定义命令;verbose 时可记录访问;超大文本(>10k 字符)可截断或摘要。
适用边界与注意点
- 仅适用于 POSIX 风格 工作区内的 文本浏览;Windows / macOS / Linux 可用,但非 POSIX 文件系统可能有差异。
- 不支持写入、删除或任意 shell;不适合替代 IDE 全文检索或 Git 历史分析。
- 性能受单次脚本执行与文件大小限制影响,不适合高并发批量拉取超大目录树。
使用场景
- 在 Cursor/Codex 会话里先列出 `src/` 下有哪些模块,再决定让模型读哪一个配置文件
- 用户说「读一下 SKILL.md 前几段」时,用相对路径在工作区内取文本给模型总结
- 排查 Agent 生成的补丁前,快速浏览 workspace 根目录结构,确认脚本与资源是否在预期位置
- verbose 调试时按访问日志核对模型是否只在允许目录内 list/read
适合人员
- 每天在 Agent 里改 monorepo、需要让模型先看目录再读单个文件的工程师
- 编写 SKILL.md 指令、要在固定 workspace 里演示 list/read 工作流的技能作者
- 运维用 OpenClaw 工作区跑自动化任务、要求路径不能越界的安全审查同学
- 教新人用 CLI Agent 读项目文档、但不想开放任意 shell 的技术导师