dsh-tool-fs 使用指南

提供 read、read_image、write、edit 四个面向模型的文件系统工具，通过 ctx.fs 读写本地文件，支持大文件流式读取和窗口分页，需要配合策略插件实现读后写/编辑的安全检查

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

提供 read、read_image、write、edit 四个面向模型的文件系统工具，通过 ctx.fs 读写本地文件，支持大文件流式读取和窗口分页，需要配合策略插件实现读后写/编辑的安全检查

— 源: plugins.ai_summary

dsh plugin --profile web add npm:@deepseek-ai/dsh-tool-fs

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

read — one ctx.fs.stat (type + size routing + version), then readText/streamText, then builds the line window, then emits fs/observed with a plain ctx.emit. (1 stat.)
write — ctx.waterfall('fs/write-intent', target, exec, () => undefined) for the optional guard, then ctx.fs.writeText(target, content, intent), then fs/observed. (0 stat.)
edit — ctx.waterfall('fs/edit-intent', target, exec, () => undefined) for the optional guard, then ctx.fs.editText(target, edit, intent), then fs/observed. (0 stat.)
read handles UTF-8 text files only — images use the separate extension-routed read_image tool; PDF, audio, and video remain deferred. A directory target is FS_NOT_REGULAR_FILE.
No inline image preview on the tool-result card — UI surfaces render the image result generically (the durable reference, not pixels); inline rendering is deferred to the UI packages.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则