<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Node.js on Trevor's Blog</title><link>https://hitrevor.com/tags/node.js/</link><description>Recent content in Node.js on Trevor's Blog</description><generator>Hugo</generator><language>zh-CN</language><lastBuildDate>Tue, 17 Nov 2026 08:11:07 +0800</lastBuildDate><atom:link href="https://hitrevor.com/tags/node.js/index.xml" rel="self" type="application/rss+xml"/><item><title>DeepSeek Harness：我有个插件已经装不回来了</title><link>https://hitrevor.com/posts/dsh-plugin-source/</link><pubDate>Tue, 17 Nov 2026 08:11:07 +0800</pubDate><guid>https://hitrevor.com/posts/dsh-plugin-source/</guid><description>同一个 profile 里四个插件，四种依赖写法：版本号、钉 sha、本地 tarball、软链源码。今天重装，其中一种直接 ENOENT，而它先报的却是 corrupted。</description><content:encoded><![CDATA[<p>我顺手敲了一下 <code>dsh plugin --profile web list</code>，出来一行数字：8 packages。八个依赖，四行是我自己装的第三方插件，其余四行是官方的 bundle。看着挺整齐，直到我去翻它们的版本是怎么写的。</p>
<p>四种写法，四套逻辑。其中一种，我今天已经装不回来了。</p>
<h2 id="先说我看到的那四条">先说我看到的那四条</h2>
<p>profile 的 <code>package.json</code> 里，这四个插件的依赖声明分别是四种形态：一个纯版本号，一个纯版本号，一个钉了四十位 sha 的 GitHub 地址，一个指向 <code>/tmp</code> 下的本地 tarball。</p>
<p><img alt="四种来源写法对照" loading="lazy" src="/images/dsh-plugin-source/fig1.png"></p>
<p>四条里第一条是版本号 <code>1.8.0</code>，第二条也是版本号 <code>0.1.1</code>，第三条是 <code>github:LanFeng97/dsh-workspace-create-dialog#7c4d0ef...</code>，第四条是 <code>file:/tmp/dsh-plugin-build/dsh-plugin-profile-ping-0.1.0.tgz</code>。</p>
<p>官方文档里把这几种都叫「装插件」，<code>dsh plugin add</code> 后面接什么都能装进去。装的时候没区别，装完之后区别全在升级和重装这两件事上。</p>
<h2 id="版本号是最省心的一种">版本号是最省心的一种</h2>
<p><code>dsh-plugin-sticky-wall</code> 和 <code>dsh-plugin-ark-image-gen</code> 走的是普通 npm 依赖，写版本号。前者 1.8.0，后者 0.1.1。</p>
<p>这种的好处是可以查：根据 <code>npm view dsh-plugin-sticky-wall versions</code> 的输出，五个版本列出来，<code>0.0.0-stage</code>、<code>1.4.0</code>、<code>1.7.0</code>、<code>1.7.1</code>、<code>1.8.0</code>，<code>latest</code> 正好是 1.8.0。也就是说我手上是最新的，没落后。</p>
<p>它的代价是作者一改你就要跟。<code>latest</code> 往前走一步，下次 <code>pnpm update</code> 或者重装 profile，你拿到的就是新版本，没有中间档位可选。</p>
<h2 id="钉-sha-的那种冻结得很干净">钉 sha 的那种，冻结得很干净</h2>
<p><code>dsh-workspace-create-dialog</code> 是从 GitHub 直接装的，末尾挂着一段四十位的 sha。</p>
<p>这种写法把版本锁死在那一次提交上。作者之后改了什么、重构了几次、加了什么依赖，跟你都没关系，你拿到的东西每次重装都一模一样。想升级得自己去查新 sha，改 <code>package.json</code> 再装。</p>
<p>我顺手核了一下这个 sha 是不是当前最新的。仓库 <code>LanFeng97/dsh-workspace-create-dialog</code> 的默认分支是 <code>main</code>，末次 push 在 2026 年 10 月 13 日。</p>
<p><code>commits?per_page=1</code> 回来第一条正好就是 <code>7c4d0ef91a0ad9d49efa71ec5a637a53e6d87b2f</code>。也就是说我钉的这一版，此刻就是 HEAD。</p>
<p>这个仓库目前 1 个 star。钉 sha 这种装法，在冷门仓库上其实是最靠谱的选择，因为它不依赖作者打 tag、不走 npm 发布、也不怕仓库被改名，代价只是你得自己记得来核一次。</p>
<p><img alt="npm 版本列表与 GitHub 当前 HEAD" loading="lazy" src="/images/dsh-plugin-source/fig2.png"></p>
<h2 id="本地-tarball-那条今天已经断了">本地 tarball 那条，今天已经断了</h2>
<p><code>dsh-plugin-profile-ping</code> 写的是 <code>file:/tmp/dsh-plugin-build/dsh-plugin-profile-ping-0.1.0.tgz</code>。</p>
<p>这是我当初自己打包塞进去的。我建了个最小的 <code>package.json</code>，只放这一条依赖，跑 <code>npm install</code>，得到的是这个：</p>
<blockquote>
<p>npm warn tarball data for dsh-plugin-profile-ping@file:/tmp/dsh-plugin-build/&hellip;tgz (null) seems to be corrupted. Trying again.
npm error code ENOENT
npm error path /tmp/dsh-plugin-build/dsh-plugin-profile-ping-0.1.0.tgz
npm error enoent ENOENT: no such file or directory</p>
</blockquote>
<p><img alt="最小复现：npm install 的原始报错" loading="lazy" src="/images/dsh-plugin-source/fig3.png"></p>
<p><code>/tmp/dsh-plugin-build</code> 这个目录，已经不在了。macOS 会定期清 <code>/tmp</code>，这个过程不需要你同意。</p>
<p>最误导人的是它先报了两行 <code>corrupted</code>，第三行才说实话 <code>ENOENT</code>。看到 corrupted，人的第一反应是包的格式坏了、去重新打包；实际原因简单得多，是那个文件本身没了。</p>
<p>而 <code>pnpm-lock.yaml</code> 里记的这段也一样跟着死：<code>version: file:../../../../../tmp/dsh-plugin-build/dsh-plugin-profile-ping-0.1.0.tgz</code>。五个 <code>..</code> 层层退到根目录，再钻进 <code>/tmp</code>。</p>
<p>也就是说，我这个 profile 现在只要重装一次，就会卡在这一个包上。不是整个 profile 全废，是它装不完整。</p>
<h2 id="它其实留了退路只是没指过去">它其实留了退路，只是没指过去</h2>
<p><code>~/.dsh/plugin-archives/</code> 里躺着 <code>dsh-plugin-profile-ping-0.1.0.tgz</code>，4,162 字节，日期是 11 月 4 日。</p>
<p>我把依赖路径改成指向这份，再跑一次安装，结果是 <code>added 1 package in 102ms</code>。</p>
<p>同一个包、同一份字节，换个路径就活了。那份 tarball 的日期是 2026 年 11 月 4 日。所以我这四条里唯一坏掉的那条，修法只有一行：把 <code>/tmp/dsh-plugin-build/</code> 换成 <code>~/.dsh/plugin-archives/</code>。</p>
<p>顺手把它拆开看了一眼，一共七个条目。<code>index.js</code> 6,954 字节是主体，<code>README.md</code> 1,788 字节，<code>icon.svg</code> 647 字节，<code>package.json</code> 526 字节，<code>locale</code> 下两个 json 分别 199 和 196 字节，<code>cordis.patch.yml</code> 只有 71 字节。</p>
<p>七个条目解压后合计 10,381 字节，压成 4,162 字节的 tarball，压掉了 59.9%。</p>
<p><img alt="tarball 内部的七个条目" loading="lazy" src="/images/dsh-plugin-source/fig4.png"></p>
<p><code>package.json</code> 里有一行 <code>&quot;private&quot;: true</code>。带这个标记的包永远不会发到 npm 上去，所以我这份本地包没有公开版本可查，除了我自己手上的文件，没有任何备份。</p>
<h2 id="第四种是-link-到源码目录">第四种是 link 到源码目录</h2>
<p>superagent 那个 profile 里又是另一套写法：<code>dsh-superagent: link:/Users/trevorwang/dsh-superagent</code>。</p>
<p><code>link:</code> 是软链到本地源码目录，不是拷贝。改完代码不用重新安装，下次启动就是新的。开发插件的时候这是最顺手的形态，试错成本几乎为零。</p>
<p>代价也直接：没有版本号，没有 sha，没有 tarball。目录一挪、名字一改，这个 profile 就变成了指向空气的软链。它能不能装回来，取决于你那个源码目录还在不在。</p>
<h2 id="每个插件都自带一张插条">每个插件都自带一张插条</h2>
<p>四种来源写进 <code>package.json</code> 的方式差别很大，但装进去之后长得一模一样，因为它们都遵循同一个约定。</p>
<p>四个插件的 <code>package.json</code> 里都有一行 <code>dsh.bundle.patch</code>，指向自己目录下的 <code>cordis.patch.yml</code>。那个文件里是一条插入声明，写明自己的 loader id 和包名。</p>
<p><code>dsh-workspace-create-dialog</code> 那份的注释写得最清楚，原文写道：「bundle patch：把本插件的 loader 行插进 web profile 名单。由 <code>package.json</code> 的 <code>dsh.bundle.patch</code> 声明，安装时作为 profile bundle 层生效。」</p>
<p>带前端界面的还多一层。sticky-wall 写了 <code>client.platform: &quot;web&quot;</code>，workspace-create-dialog 写得更细，<code>client.inject</code> 里挂了三个 UI 包：renderer、layout 和 workspace。剩下两个纯后端插件，<code>dsh</code> 字段里只有 <code>bundle</code>，没有 <code>client</code>。</p>
<p>所以「来源」只决定版本怎么解析，装进去之后大家走的是同一条路。这也意味着一个本地 tarball 插件和一个 npm 正式版插件，在运行时的待遇完全一样，看不出谁是野的。</p>
<h2 id="四个里只有一个声明了版本范围">四个里只有一个声明了版本范围</h2>
<p>这是我觉得最该被注意的一处。</p>
<p><code>dsh-workspace-create-dialog</code> 的 <code>dsh</code> 字段里除了 bundle 和 client，还有一条 <code>engines</code>：<code>&gt;=0.2.0-rc.2 &lt;0.3.0 || &gt;=0.3.0-0</code>。它明确告诉你，这个插件在哪些 Harness 版本上能跑。</p>
<p>剩下三个，一个都没写。sticky-wall 的 <code>dsh</code> 字段就两样，<code>bundle</code> 和 <code>client.platform</code>。ark-image-gen 和 profile-ping 只有 <code>bundle</code>。</p>
<p><img alt="四个插件的 dsh 字段对照" loading="lazy" src="/images/dsh-plugin-source/fig5.png"></p>
<p>不写 <code>engines</code> 的插件，装到不兼容的版本上不会被拦。它不会在安装时报错，也不会在启动时警告你，通常是跑起来之后某个功能悄悄不动了，你得自己往回找。</p>
<p>这也解释了一件事：为什么升级 Harness 之后，出问题的往往是那些不起眼的小插件。声明了范围的至少还能在装的时候拦你一道，没声明的只能靠你记得它存在。</p>
<h2 id="装得进去不代表装得回来">装得进去，不代表装得回来</h2>
<p>我现在看一个插件，会先看它依赖那一行是怎么写的。</p>
<p>版本号的最省心，但也最容易被作者推着走。钉 sha 的最稳，代价是你得自己盯着上游。本地 tarball 最自由，但只要那个路径不在你的掌控里，它随时会变成今天早上我遇到的样子。link 到源码最方便开发，连版本这个概念都没有。</p>
<p>四种装法都能装进去，装的过程中你感觉不到任何差别。真正决定它活多久的，是那个路径在哪、谁能删掉它，以及到期之前有没有人替你留一份。</p>
<p>再补一句我这半天的判断：<code>dsh plugin</code> 这个命令本身不做什么，帮助里写得很直白，它只是把剩下的参数原样转发给 pnpm，在 profile 目录里执行。</p>
<p>所以插件的来源规则就是 npm 的来源规则，<code>file:</code> 指向不存在的文件会 <code>ENOENT</code>，跟 dsh 一点关系都没有。知道这一层之后，那些看起来发生在 Harness 身上的问题，都能直接套 npm 的常识去查。</p>
<p>顺便说，如果你的 <code>/tmp</code> 里也躺着某个 <code>file:</code> 依赖，不妨现在就去 <code>ls</code> 一眼。真没了的话，<code>~/.dsh/plugin-archives/</code> 里可能还留着一份。</p>
<p>你现在装的插件里，有几种是靠本地路径活着的？手边这几个我打算都挪进 archive 里，你觉得还有别的地方该一起清一遍吗。</p>
]]></content:encoded></item></channel></rss>