YJLTF/dsh-plugin-offline-packager

dsh-plugin-offline-packager

DeepSeek Harness（DSH）离线打包插件 — 在联网环境中把任意 DSH 插件打包成自包含的离线安装包（.tgz），拷贝到无网络的 DSH 环境后用一条命令直接安装，全程无需访问 npm registry。

它同时为 dsh-admin 的插件市场提供离线包来源：打包生成的 .tgz 可上传到 dsh-admin 插件市场，借助其插件管理功能在离线环境中分发与安装 DSH 插件。

它解决什么问题

dsh plugin add 本质是把参数转发给离线 profile 目录里的 pnpm add。对普通插件执行这条命令时，pnpm 需要联网解析并下载插件的每一个 npm 依赖，离线环境必然失败。本插件把"依赖下载"这一步提前到联网机器上完成：在暂存目录装好插件的全部生产依赖，再通过 npm 的 bundleDependencies 机制把整个 node_modules 依赖闭包一起塞进 tarball。离线机器拿到的就是一个不缺文件的完整安装包。

特性

• 对话即打包：注册一个名为 offline-pack 的 Tool，在 DSH Web UI 里用自然语言让 AI 调用即可，无需记命令。
• 三种插件来源：npm 包名（@deepseek-ai/dsh-base）、GitHub 仓库（github:user/repo、https://github.com/user/repo，支持 #branch 指定分支）、本地路径（./my-plugin）。
• 自包含离线包：完整生产依赖闭包随 tarball 携带（bundleDependencies），离线安装零 registry 访问。
• peerDependencies 智能排除：由 DSH 宿主（cordis）提供的 peer 依赖不打入离线包，也顺带清除构建阶段混入的 peer 传递依赖，避免与宿主的实例重复、类型不兼容。
• 自动构建：GitHub / 本地来源会自动在暂存目录内安装依赖并执行 prepare / build，构建产物直接进包，不污染原目录。
• 离线元数据：每次打包生成同名 .meta.json（包名、来源、打包时间、DSH 版本、打包器版本、捆绑依赖清单），便于离线环境审计与管理。
• 内建离线安装指引：打包结果会附带针对 pnpm ≥ 11 供应链策略（minimumReleaseAge）的离线安装注意事项与解决命令，AI 可直接转述给用户。
• 自身零依赖：本插件经 esbuild 打成单文件 lib/index.js，自身 .tgz 也不声明任何运行时依赖，同样可以离线安装。
• 兼容 dsh 0.1.6-alpha.2：基于 @deepseek-ai/dsh-tools@0.1.6-alpha.2、@deepseek-ai/cordis@^4.0.2 构建与类型校验。

工作原理

1. 按来源把插件源码放入临时暂存目录：npm 来源直接 npm pack 下载解压；GitHub 来源浅克隆；本地来源复制（跳过 node_modules 与 .git）。
2. 需要构建的插件（GitHub / 本地来源、存在构建脚本而产物缺失）在暂存目录内 npm install 并执行 prepare / build。
3. 安装生产依赖（显式排除 peer），把实际装出的顶层依赖写入 bundleDependencies，使 npm pack 携带完整 node_modules。
4. npm pack --ignore-scripts 出包（构建早已完成，避免 prepare 重复执行），并写出 .meta.json。

安装本插件

前提条件

• 已安装 DeepSeek Harness (DSH)（已在 0.1.5-alpha.1 / 0.1.5-alpha.2 / 0.1.6-alpha.2 上验证）
• Node.js >= 22，npm，以及系统里有 pnpm（dsh plugin 依赖它转发）
• 从 GitHub 来源打包时需要 git

步骤

# 1. 克隆或进入项目目录
cd dsh-plugin-offline-packager

# 2. 安装依赖并构建
npm install

# 3. 安装到 DSH profile（以 web profile 为例）
dsh plugin --profile web add .

若 pnpm 提示忽略了本包的构建脚本（prepare 负责构建，会重新生成 lib/），按提示允许即可：pnpm approve-builds，或在 profile 的 pnpm-workspace.yaml 的 allowBuilds 映射中加入 dsh-plugin-offline-packager。