跳到主内容

dsh-fs-local 使用指南

为 ctx.fs 提供本地文件系统后端，支持文件读写、目录列表、符号链接解析等12个FileSystem原语，适用于需要在本地文件系统上执行文件操作的 dsh plugin

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

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

快速上手

为 ctx.fs 提供本地文件系统后端，支持文件读写、目录列表、符号链接解析等12个FileSystem原语，适用于需要在本地文件系统上执行文件操作的 dsh plugin

— 源: plugins.ai_summary

安装与验证

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

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

— 源: plugins.install

关键要点

  • editText holds the whole file (plus the edited copy) in memory — streaming exists only on the read path.
  • Binary detection is asymmetric — reads NUL-sample only the first 8192 bytes while edits scan the whole buffer, so a file with a late NUL reads fine but rejects edits.
  • Post-commit cleanup is best effort — a successful publication remains successful if removal of its owner-only staging directory fails, leaving private residue for later operator cleanup.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

踩坑提醒

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

— 来源：通用规则

dsh-fs-local 使用指南