本地插件定制 ishanshmalviya5/dsh-local-plugins

dsh-local-plugins

定制任意 dsh 插件——内置插件也行——更新、损坏或重装时都不丢改动。

设置 → Local Plugins：列出你定制的每个插件、用大白话写的状态，以及你接下来大概率想做的操作

能拿它做什么

| 你想…… | 你点…… | 你得到…… |
| 修好或微调插件，并留住改动 | + Add → Migrate，编辑，Commit，Apply | 改动在 dsh 里跑起来，更新和重装都不丢 |
| 拿到作者的新版本，又不丢自己的微调 | Update | 新版本加上你的改动；两边改了同一行会先问你，期间不会出问题 |
| 改动出问题时回退 | Deploy older commit… | 立刻回到早先的版本 |
| 定制 dsh 内置功能（比如某个模型服务商） | 同样的步骤，作用在内置插件上 | 你的版本跑起来；Unlink 还原原版 |
| 让 AI 智能体安全地改插件 | Work on it | 智能体在该插件目录里打开，上下文已填好；它不能开启任何东西——只有你能 |
| 整理提交历史，让更新更省事 | Squash my changes | 智能体把你的提交全部压成一个，叠在原始发布版之上；先建备份分支，并检查代码没变 |
| 把依赖固定到更新的版本 | Dependency overrides → Apply override | 覆盖项保存、部署并检查：真正装上了才显示 ✔ |
| dsh 升级或重装后恢复 | Reapply all | 你的定制重新开启 |
| 试某个确切版本 | + Add，name@1.2.3（或 …#v1.2.0） | 就是那个版本，而且固定不动 |
| 看自己相对原版改了什么 | 看卡片 | 「相对原版改了 3 个文件」，以及当前正在跑的是什么 |
| 不再定制某个插件 | Unlink，想的话再 Delete… | 原版回来了；你的成果留在回收站文件夹里，可以恢复 |
| 把成果也存到别处 | 它就是个普通 git 文件夹：~/.dsh/local-plugins/<plugin> | 加自己的 git remote 推上去 |

出问题时，它会告诉你当前配置是否仍然安全、下一步该做什么——不会只甩一句「失败」。

Apply 失败：什么都没开启，面板会告诉你下一步做什么

安装（2 分钟）

1. 在终端里执行（如果你用的是别的配置档，把 web 换成你的配置档名）：
dsh plugin --profile web add github:ishanshmalviya5/dsh-local-plugins

2. 重启 dsh web。
3. 打开 Settings → Local Plugins。

需要 git、npm 和 Node 26 或更新版本，系统为 macOS 或 Linux（详情）。

你的第一次定制

1. + Add → Migrate，挑一个你已经在用的插件。你之前手动改过的内容都会保留，作为起点。
2. 动手改——编辑 ~/.dsh/local-plugins/<plugin> 里的文件，或者点 Work on it，让 AI 智能体陪你一起改。
3. Commit，然后 Apply，再重启 dsh web。

整个循环就这些。在你点 Apply 之前，dsh 不会有任何变化；如果新版本构建不出来，或者过不了检查，旧版本照常运行。

更多场景

作者发布了新版本

点 Check now（dsh 启动后不久也会自动检查一次）。有新版本的插件会显示 Update available，点 Update。你的改动和新版本会自动合并。如果你和作者改了同样的行，卡片会列出这些文件，由你来选：修好它们（或点 Fix with agent）再点 Finish update，或者点 Abort 放弃这次尝试。整个过程里正在运行的插件不受影响，什么时候 Apply 由你决定。

一次有冲突的更新：涉及哪些文件，以及三个安全选项

某次改动把事情搞砸了

点 Deploy older commit…，挑一个能用的版本。如果 dsh 本身在你应用了某个改动之后立刻开始出问题，它会自己发现，把上一个能用的版本放回去，并弹出提示——你的改动已经保存好，你可以用 Work on it 去修。

如果 dsh 完全起不来，在终端里运行下面这条命令，把所有原始插件放回去：node ~/.dsh/local-plugins/.deployed/dsh-local-plugins/scripts/undo.mjs --all

我在定制一个内置插件，现在想退出

Unlink (restore original) 会把原始、未改动的插件还给 dsh。你的版本仍留在列表里（标为 Not applied），想切回来随时点 Apply。

我想从列表里删掉一个插件

先 Unlink，再 Delete… 并输入它的名字。你的工作成果会移到 ~/.dsh/local-plugins/.trash/，不会被抹掉。把文件夹移回来，点 Repair installation 就能恢复。

我不知道现在是什么状态

点 Repair installation。它会找出所有对不上的地方（比如崩溃之后，或者 dsh 升级之后），能安全修的直接修，修不了的告诉你，并且绝不会删掉你的工作成果。Recent operations 显示跑过哪些操作、花了多久，还有日志；Disk usage 显示每个插件占用的空间，并让你先预览再清理旧版本。

最近操作与磁盘占用

使用精确版本
npm 插件：name、name@1.2.3 或 name@beta。git 来源的插件：网址、github:owner/repo 或 git@host:owner/repo，末尾可选 #v1.2.0（某个发布版本）、#branch 或 #commit。锁定到发布版本或 commit 后，它永远不会自己变动。

各标签的含义

| 标签 | 含义 | 你要做什么 |
| Applied | dsh 正在运行你的最新版本 | 什么都不用做 |
| Changes pending | 你有更新的改动或未提交的改动，尚未运行 | Commit，然后 Apply |
| Update available | 作者发布了更新版本 | Update |
| Conflict | 某次更新涉及一些文件，需要你决定 | Finish update 或 Abort |
| Link lost / Reapply required | dsh 升级或重装了 | Reapply all（可放心重复执行） |
| Broken | 记录与文件对不上 | Repair installation |
| Disabled | 它让 dsh 崩溃，已被移出，好让 dsh 能启动 | Work on it，修好，Commit，Apply |
| Not applied | 你在跟踪它，但 dsh 用的是普通插件 | 想用自己的版本时点 Apply |

控制权始终在你手里

* 脚本需要你同意。 有些插件想以你的完整权限运行安装或构建脚本。这项默认关闭；你可以选 Allow this time 或 Always allow for this plugin，发布者变更时会再次询问。
插件正在请求权限：尚未上线任何内容
* 你的工作不会悄悄丢失。 取消关联、删除、回滚和崩溃恢复都会把你的改动留在某个地方，随时能取回。
* 只有完成并检查过的版本才会被启用 —— 绝不会是改了一半的版本。
* 它只与你跟踪的来源通信（插件的 git 或 npm 源）。

如何保证这些：Security · Recovery · How it works。

兼容性 —— dsh-local-plugins 0.3.0

| 平台 | 状态 |
| macOS（Apple silicon），Node 26 | ✅ 支持。 已对真实 dsh 手工端到端测试，也在 CI 中测试 |
| Linux（Ubuntu），Node 26 | 🟡 CI 中 lint、全部单元测试和包检查均通过。尚未对真实 dsh 做端到端测试 |
| Linux，Node 22 / 24 | 🟡 CI 结果相同，但超出支持范围（需要 Node 26 或更新版本） |
| Windows | ❌ 不支持 —— 它会明确提示，并且不启动 |

基于 dsh 0.2.0-rc.2 构建并测试。从 0.1 版本升级无需你做任何事：插件保持原样（详见 CHANGELOG）。

须知

* 如果某个插件在这款插件加载之前就让 dsh 崩溃，它自己修不了 —— 请用上面的 undo.mjs 命令。
* 上线前的检查只确认文件完整可读，不会先运行插件。
* 内置插件跟随 dsh 自带的版本，而不是更新的 npm 发布版。
* 它一次只做一件事；它忙的时候你点了，它会让你稍等。

面向开发者

HTTP API · 状态规则 · 故障排查 · 性能 · 发布检查清单 · 开发

欢迎贡献，AI 辅助的贡献也欢迎：先读 CONTRIBUTING.md（编码智能体另见 AGENTS.md）。

许可证

MIT — 见 LICENSE。