dsh_update 工具手册（源码 tools/dsh-u…

# 任务说明与操作指引

重要前置说明

• 我无法直接访问你的本地机器执行命令，以下为可落地的操作步骤，请在终端中按序执行。
• 假设 dsh-update 与 dsh-run 是该仓库自带的 CLI 工具（通常通过 node tools/xxx.js 或全局软链接调用），请先确认调用方式。

第一步：升级前准备

• 查看当前版本，便于回滚比对：
• cd /usr/local/dsh && git log --oneline -1
• git status（确认工作区干净，避免升级时冲突）
• 建议建分支备份：git checkout -b backup-before-update

第二步：执行升级

• 拉取远端最新代码：
• git fetch origin
• git checkout master（或 main，以仓库默认分支为准）
• git pull --ff-only origin master
• 若 dsh-update 本身提供增量更新能力，也可直接运行：
• node tools/dsh-update.js（或全局命令 dsh-update），按其输出提示完成更新
• 针对性确认目标文件已更新：git log --oneline -5 -- tools/dsh-update.js
• 如有依赖变更，执行 npm install（视仓库是否有 package.json）

第三步：验证（dsh-run 输出工具手册）

• 运行验证命令：
• dsh-run --help（或 node tools/dsh-run.js --help / dsh-run help，以该工具约定为准）
• 验收标准：
• 退出码为 0（可用 echo $? 检查）
• 输出完整的用法说明、参数列表，无报错堆栈或乱码
• 若输出异常：git diff 排查变更，必要时 git checkout backup-before-update 回滚

常见问题提示

• 命令找不到：检查 PATH 或重新建立全局软链接（如 npm link）
• 权限不足：对 /usr/local/dsh 目录用 sudo 或修正目录属主

如需进一步排查，把上述命令的实际输出贴给我即可。