dsh-atomic-write 使用指南

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

快速上手

零依赖原子文件写入库，通过独占创建临时文件+rename确保写入原子性，防止部分写入、符号链接劫持和权限错误，适用于需要安全更新配置文件和凭证存储的开发者

— 源: plugins.ai_summary

安装与验证

dsh plugin --profile web add npm:@deepseek-ai/dsh-atomic-write

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

— 源: plugins.install

关键要点

• Exclusive-create temp (wx, random suffix): the open refuses to follow a symlink planted at a guessable temp path.
• rename replaces a symlinked target itself, never writing through to its referent.
• Same-directory sibling keeps the rename on one filesystem, so the swap stays atomic.
• Parent directories are created; on any failure the temp is removed and the failure rethrown; readers observe either the old or the new complete content.
• String content only — no Buffer or stream form until a consumer needs one.

— 源: plugin_wiki.readme_zh (fallback readme_raw)

踩坑提醒

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

— 来源：通用规则