PerryLink/dsh-plugin-upgrade-015

⬆️ dsh-plugin-upgrade-015
- 1024 商店渠道：先执行一次 npm i -g dsh1024，然后执行 dsh1024 plugin --profile web add dsh-plugin-upgrade-015（会计入 deepseek1024.com 安装排名）。
Gitee
dshfind

面向 DeepSeek Harness 的已合并、版本锁定的插件升级技能——0.1.3-alpha.1 → 0.1.5-rc.1，以两条封闭路径承载。

路径 A 0.1.3-alpha.1 → 0.1.5-alpha.1，路径 B 0.1.5-alpha.1 → 0.1.5-rc.1：一张走廊卡片，外加一个零依赖的接缝扫描器，覆盖合并后的 20 个接缝目录，因此一个已停止静默挂载的客户端半区绝不会被误认为“类型检查通过”。

官方仓库。 这是 dsh-plugin-upgrade-015 的唯一官方仓库，由 PerryLink 维护。它取代了两个版本锁定的包 dsh-plugin-upgrade（路径 A）和 dsh-plugin-upgrade-rc1（路径 B）。其他账户下的同名仓库均无关联。

License
DSH plugin
dsh-doctor
DSH Market
Node
CI
Version
npm version
npm downloads

English · 简体中文 · Español · Português · हिन्दी

兼容性

| 层面 | 状态 |
|---|---|
| Harness | DeepSeek Harness 0.1.5-rc.1（标签 dsh-v0.1.5-rc.1 = 183f08e9c6dd；路径 A→B 交接 dsh-v0.1.5-alpha.1 = 5dda764ed3aa；走廊起点 0.1.3-alpha.1）。对等版本范围 @deepseek-ai/dsh-skill >=0.1.2-rc.1 =0.1.5-alpha.1 =24.0.0 |
| 平台 | 任何能运行 Node 的地方；扫描器仅依赖文件系统，且平台中立 |
| 模型 | 完全支持纯文本模型；该技能是一个 Markdown 正文，无工具或视觉要求 |
| 范围 | 两条封闭航段，一个跨度：航段 A 0.1.3-alpha.1 → 0.1.5-alpha.1 加上航段 B 0.1.5-alpha.1 → 0.1.5-rc.1。走廊永不拓宽：0.1.5-rc.1 之后的一跳就是一个新包。 |
| 航段 | 两条航段都存在于本包中：航段 A 保留 S1–S10 + M1 接缝，航段 B 保留 C1、C2、C4、C5、H1–H4、P1 —— 每个都有自己的证据、卡片章节、夹具和回滚路径。没有需要安装的兄弟包。 |
| C3 | 已退役：航段 B 的卡片把陈旧类型行误报为绿灯 C3，这与航段 A 的 M1 是同一缺陷。该折叠记录在卡片上；--seams C3 不匹配任何内容。 |
| 兄弟包 | 不要在同一配置中挂载已退役的 dsh-plugin-upgrade：两者都注册代理技能 plugin-upgrade-015，因此第二次挂载会在技能名称上冲突。该包在 npm 上已弃用，其仓库已退役；本包取代了它的两条航段。 |

你将获得

两半，一个接缝目录：

- 一个捆绑的代理技能（plugin-upgrade-015） —— 合并后的走廊卡片和一个修复并验证的循环。正文首先将调用者路由到与其对等频段匹配的航段；模型仅在任务确实需要时才加载它，并且该包不贡献任何系统提示段落，也不贡献任何工具。
- 一个零依赖 CLI（dsh-plugin-upgrade-015-scan） —— 报告合并后的二十个接缝（S3、S8、S9、M1、S4、S5、S6、S7、S2、S1、S10、C1、C2、P1、C4、C5、H1、H2、H4、H3）的 file:line 事实，这些接缝于 2026-09-09（航段 A）和 2026-09-10（航段 B）从测试框架标签范围重新读取。任何错误严重级别的命中都会以退出码 1 退出，因此它可以直接接入 CI。

关键在于这条走廊存在的目的就是消灭这种故障模式：这个跨度的破坏大多是静默的，且来自两端。 类型行可能已陈旧，因此仓库会针对旧目录进行编译（接缝 M1），而裸 conversation 客户端槽位被删除且没有别名，同时 ctx.slots.inject() 仅在声明存在时才运行其回调 —— 因此仍然针对它的客户端一半会停止挂载，没有错误、没有日志行、也没有构建失败（接缝 C1）。有三类破坏能在 typecheck + test 下存活：

1. 本地门禁编译了陈旧的类型行 —— 旧的 paths 别名，或固定在 0.1.5-alpha. 的开发/测试类型（接缝 M1）；
2. 日志写入器省略了 V3 必需的 stream 字段，因此会话可以导入，但随后拒绝恢复（接缝 S3）；
3. 测试是针对旧形状进行模拟的，因此它们会通过，而宿主会丢弃该贡献（接缝 C1）。
诚实的规模评估：B 支线的工作区扫描发现，该家族的客户端半边只使用了 8 个槽位键，所有这些键在 rc.1 中都仍然存在——对它们而言，rc.1 的破坏是潜在的，而非实际的。针对裸 conversation 键的第三方客户端插件才是会出问题的，而且它们会悄无声息地出问题。A 支线的扫描发现了相反的质地：40 个仓库，其中 11 个命中了 M1，而修复过时的路径暴露了 3 个此前“全绿”的仓库中真实存在的 TypeScript 错误。

快速开始

1. 将该 bundle 安装到你的 profile 中
dsh plugin --profile web add dsh-plugin-upgrade-015

2. 验证该行已挂载
dsh --profile web --dump-config | grep -A3 'id: dsh-plugin-upgrade-015'

3. 扫描你正在升级的插件
npx dsh-plugin-upgrade-015-scan --repo ../my-plugin

然后让 agent 使用 plugin-upgrade-015 技能，或者用位于
skills/plugin-upgrade-015/references/v0.1.3-alpha.1-to-v0.1.5-rc.1.md 的卡片自行驱动循环（A 支线是 §1，B 支线是 §2，合并后的接缝索引是 §3）。

安装与卸载

dsh plugin --profile web add dsh-plugin-upgrade-015            # 从 npm 安装
dsh plugin --profile web add "github:PerryLink/dsh-plugin-upgrade-015#main"   # 从源码安装
dsh plugin --profile web remove dsh-plugin-upgrade-015         # 卸载（可逆）

安装该 bundle 只会注册一个技能；移除该行即移除该技能。CLI 是一个普通的 npx 目标，完全不需要 profile。

配置

每个键都是可选的，并且位于 profile 补丁中：

| 键 | 默认值 | 含义 |
|---|---|---|
| enabled | true | 注册打包的技能。设为 false 可保持依赖挂载但静默。 |
| skillName | plugin-upgrade-015 | 要在 skillsRoot 下注册的目录，以及目录中显示的名称。 |
| skillsRoot | 包自身的 ./skills | /SKILL.md 所在的位置。将其指向你自己的卡片以复用这套机制。 |
| userInvocable | true | 除了模型之外，人类是否也可以按名称调用该技能。 |

- insert:
- id: dsh-plugin-upgrade-015
name: dsh-plugin-upgrade-015
config:
skillName: plugin-upgrade-015

该插件挂载时会大声报错：缺失的 SKILL.md、空正文，或没有 name 的 frontmatter，都会导致挂载失败，而不是注册一个空技能。

接口面

技能 — plugin-upgrade-015（默认可由模型和用户调用）。正文：支线路由表、8 条硬规则和 6 步循环。引用：合并后的走廊卡片。脚本：检测器，随技能目录一同发布，以便相对路径能够解析。

CLI — dsh-plugin-upgrade-015-scan：

dsh-plugin-upgrade-015-scan [--repo ] [--json ] [--seams S3,C1,P1] [--quiet]

| 标志 | 含义 |
|---|---|
| --repo  | 要扫描的仓库（默认：cwd）。 |
| --json  | 同时写出机器可读的报告（repo、scannedAt、files、hits[]、bySeam）。 |
| --seams S3,C1,P1 | 限制为合并目录中的特定接缝。 |
| --quiet | 抑制人类可读渲染（与 --json 搭配使用）。 |

退出码：0 无错误严重级别的命中 · 1 至少一个错误严重级别的命中 · 2 用法或扫描失败。一次干净的扫描是必要的，但不充分——退出标准是在真实主机上的冒烟测试，外加对日志写入方（leg A）的恢复往返测试，以及对客户端部分（leg B）的真实浏览器断言。

二十个接缝

顺序遵循 lib/scan.mjs 中的目录（先 leg A，后 leg B），这也是 test/card.test.mjs 将卡片固定到的顺序。

| Id | 严重级别 | 在通往 0.1.5-rc.1 的路上发生了什么变化 |
|---|---|---|
| S3 | error | assistant/message 增加了一个必填的 stream 字段（会话格式 V3）：没有它写入的日志可以成功导入，但随后拒绝恢复（Session.fromRestore 抛出 invalid settlement fields）。 |
| S8 | error | SessionHandle.read() 返回 SessionHandleReadResult（{ eventState, events }）而不是事件数组；数组操作必须解包 .events。 |
| S9 | error | SystemPrompt 的配置将 persona 重命名为 personaPrefix / personaSuffix。替换为 includeHarnessIdentity: false 并不等价——它会删除 harness 身份块。 |
| M1 | error | 本地门禁编译的是过期的类型行：dev/test 类型固定在 0.1.5-alpha.，或者 tsconfig 的 paths 别名解析到一个不存在的检出目录，会使 TypeScript 静默回退到已发布的类型。门禁是绿的，尺子是错的。 |
| S4 | error | tool/code-dispatch 被重命名为 tool/ptc-dispatch；旧标签在 V3 会话中不再被识别。 |
| S5 | error | ctx.agent 被移除：调用方必须显式传入 Agent（例如 setup(agentCtx, agent) 的第二个参数）。 |
| S6 | error | Inbox 是一个类型接口，而不是可构造的类；fixtures 使用官方不支持的形状，运行时代码读取 agent.inbox。 |
| S7 | warn | SubprocessHandle.pid 被移除（只剩下 SubprocessTerminalHandle.pid）；从测试 fixtures 中删除该字段。 |
| S2 | warn | EpochHeader.system 被移除：系统提示现在是表面节点 0 的 system/message。 |
| S1 | warn | 会话格式 V3 和带世代后缀的日志名称——当前世代是 session.v3.jsonl.zstd，因此硬编码 session.jsonl.zstd 的脚本会静默失败。 |
| S10 | warn | 插件编写的会话事件必须经过主机的故障关闭适配门禁：Session.append 没有 ignorable 写入通道，因此无条件追加可能使会话不可读。 |
| C1 | error | 裸客户端槽位 conversation 被删除，替换为 main + main.conversation，且没有别名。ctx.slots.inject() 仅在声明存在时触发，因此针对它的插件会静默停止挂载。 |
| C2 | error | @deepseek-ai/dsh-client-ui-sidebar-textpreview 被重命名为 …-sidebar-documentpreview；旧名称已不复存在，且没有兼容垫片包。 |
| P1 | error | peer 范围必须保留其第二段：在 npm semver 的预发布元组规则下，仅 >=0.1.2-rc.1 、--dump-config），加上针对会话日志写入方（leg A）的恢复往返测试，以及针对每个客户端侧命中（leg B）的真实浏览器断言。

安全边界

- 只读扫描。 CLI 从不在被扫描的仓库内写入；--json 只写入你传入的路径。
- 无网络，无 shell。 扫描器除 Node 标准库外不导入任何内容，且从不启动进程。
- 无密钥。 包中没有任何内容读取凭据、环境令牌或会话数据。
- 沙箱化冒烟配方。 卡片的真实主机检查使用 mkdtemp 创建的 DSH_HOME；它从不触碰你真实的 ~/.dsh。

开发

npm install                        # 或：pnpm install（仓库附带 pnpm-lock.yaml）
npm test                           # node --test：扫描器、卡片目录一致性、真实 Cordis + SkillRegistry
npm run verify:self-contained      # 每个导入都在包内解析
npm run verify:artifacts           # 打包的 tarball 携带 skill、CLI 和 patch，并排除测试
npm run check:readmes              # 五种语言 README 一致性
npm pack

扫描器每条 leg 都有一对合成夹具：fixtures/leg-a-bad-repo（leg A 的会话/配置接缝，故意呈现每一个错误接缝）与 fixtures/leg-a-good-repo（已适配），以及 fixtures/bad-repo（leg B 的客户端槽位接缝）与 fixtures/good-repo（已适配）——外加一个针对已固定到 0.1.5-rc.1 的家族仓库的实时负例，这样目录中的回归会使测试套件失败，而不是让下游用户受影响。test/card.test.mjs 断言合并后的卡片索引与 lib/scan.mjs 恰好命名相同的二十个接缝 id，且严重性相同，并且 CARD_ONLY 恰好为 ['H3']——将证据绑定规则作为机器门禁。

主题

dsh、dsh-plugin、deepseek-harness、deepseek、cordis、plugin-upgrade、migration、skill、version-card、scanner、client-slots（与 package.json 关键词对应；dsh-plugin 是该生态的可见性渠道）。

PerryLink DSH 插件家族

本项目是由 PerryLink 维护的 40 个 DeepSeek Harness 插件之一。如果这个对你有帮助，其他的很可能也一样：

| 插件 | 一句话简介 |
|---|---|
| dsh-auto-review | 审批链上的第二模型自动审查，默认失败关闭 | |
| dsh-autotier | 自动强/廉价模型层级路由，带确定性风险防护和 /tier 命令 | |
| dsh-background-agents | 持久化后台子代理，带 Web UI 侧边栏、消息传递和中断 | |
| dsh-budget | DeepSeek Harness 的成本治理：预算、碳排与延迟集于一个面板。 | |
| dsh-catalog | PerryLink 系列的 DSH Desktop Market 标准目录源 | |
| dsh-cert-mcp | 只读 MCP 服务器，暴露认证注册表：等级、快照与五维证据 | |
| dsh-checkpoint-rewind | 统一的会话 + 工作区 + 配置检查点，一键 /rewind | |
| dsh-claude-move | 将 Claude Code、Codex、OpenCode 和 Hermes 的会话、记忆与技能迁移至 DSH | |
| dsh-click | DeepSeek Harness 的跨平台原生桌面控制——Windows 优先。 | |
| dsh-composer-history | Web 编辑器的终端风格输入历史：方向键、Ctrl+R 搜索 | |
| dsh-data-quality | 确定性的数据集剖析、清洗与引用验证 | |
| dsh-defend | DeepSeek Harness 的提示注入、越狱与密钥泄露防御。 | |
| dsh-doublecheck | 工程纪律守卫：需求拷问、测试门禁、对抗性审查 | |
| dsh-draw | DeepSeek Harness 的统一静态图像生成路由。 | |
| dsh-fast | 只读性能诊断：负载、溢出、压缩与缓存命中率 | |
| dsh-fund-research | 中国公募基金研究，附带密封、可追溯的源快照 | |
| dsh-github | GitHub PR/issue/CI 集成，每次写入均需审批 | |
| dsh-industry-research | 行业与公司研究包：产业链图谱、政策时间线、公司卡片 | |
| dsh-kit | 一键安装核心系列组件的入门包 | |
| dsh-library | 本地文档知识库，支持混合搜索与引用感知注入 | |
| dsh-local-ai | 本地 Ollama 模型发现与基于任务的路由，支持云端回退 | |
| dsh-lsp-actions | LSP 诊断、格式化、补全、代码操作、符号与重命名 | |
| dsh-mask | 在模型边界进行 PII 脱敏，并配有宿主侧还原表 | |
| dsh-mcp-panel | MCP 管理控制台：/mcp 命令、设置标签页和试用调用 | |
| dsh-memento | 需审批的跨会话记忆协议（ctx.memory + SQLite） | |
| dsh-observe | 从会话事件流导出 OpenTelemetry 和 Langfuse 遥测数据 | |
| dsh-output-styles | 可在运行时切换的模型输出风格 | |
| dsh-permission-rules | 声明式允许/拒绝/询问规则，外加进程级网络策略 | |
| dsh-plugin-certification | 社区认证注册表，提供可复现检查的等级和徽章 | |
| dsh-plugin-doctor | 面向 DSH 插件的零依赖静态 + 沙箱冒烟检测器 | |
| dsh-plugin-guide | 插件开发知识库、agent 技能以及 dsh-plugin-dev CLI 工具链 | |
| dsh-plugin-kit | 面向 PerryLink DSH 插件的共享零运行时依赖工具包 | |
| dsh-plugin-portal | 零依赖静态门户，将整个插件家族渲染为一个页面 | |
| dsh-reach | 多渠道审批/提问桥接：微信、Telegram、飞书 + 会话控制台 | |
| dsh-research-report | 可验证的研究报告：证据台账、清单密封、逐条断言裁定 | |
| dsh-score | 多维度插件质量评分，配有基于证据的排行榜 | |
| dsh-session-pin | 在 Web 侧边栏固定会话和工作区，并支持每个固定项单独配色 | |
| dsh-session-sync | 基于 Git 的跨设备会话同步，支持保留双方的合并方式 | |
| dsh-skill-pack-security | 安全审计技能包，外加 plugin_vet 供应链门禁 | |
| dsh-talk | 语音优先的会话循环：语音转文字输入和文字转语音回复 | |
| dsh-team-rooms | 跨会话团队房间：共享消息总线、任务板和时线 | |
| dsh-test-drive | 隔离的安装与冒烟测试试驾，附通过/失败矩阵 | |
| dsh-ticktick | TickTick/滴答清单任务桥接：会话头部面板外加十一个 agent 工具 | |
| dsh-translate | 供应商参数翻译与确定性 JSON 修复 | |
| dsh-wechat | 微信 ↔ DSH 桥接（腾讯 iLink 机器人），由 pan17 共同开发，并由其托管仓库 | |
| dsh-personal-directive | 带顶栏开关的个人指令注入器（liucai2026/dsh-personal-directive 的分支） | |

属于 PerryLink DSH 插件家族的一部分——涵盖会话、记忆、权限、投递、可观测性和开发者工具的 40 多个仓库。请在 perrylink-dsh-catalog.perrylink.workers.dev 或 dsh-plugin 主题 浏览目录。

许可证

Apache-2.0——参见 LICENSE。安装时依赖及其许可证列于 THIRD_PARTY_NOTICES.md；未捆绑任何内容。