独立插件合集 SparkElf/dsh-plugins-plus

dsh-plugins-plus

这是 SparkElf 维护的 DeepSeek Harness（dsh）独立插件仓库。这里的插件通过 profile composition bundle 安装到上游 dsh（dsh plugin --profile <name> add <package-or-git-spec>；每个包自行声明 Cordis 插件入口），并且不依赖 deepseek-harness-plus 产品分支。

仓库边界

- deepseek-harness-plus 跟踪 dsh 与 Plus 产品，并通过固定版本的 manifest 组合第三方插件。
- 本仓库保存 SparkElf 自有插件的源码，使这些插件也能直接用于原版 dsh。所有权与分发规则记录在 Plus 插件所有权与分发决策 中。

插件

- @sparkelf/dsh-plugin-ping：提供 /ping 连通性命令；无需模型调用即可回复 pong。
- @sparkelf/dsh-mobile-bridge：完整的 Host 与 Client 插件，提供出站 E2EE 隧道、配对二维码和一等公民的“移动连接”设置页。手机端只注入连接 facade；Harness 各功能包继续拥有自己的响应式界面。
- @sparkelf/dsh-mobile-bridge-server：多用户盲中继，支持邮箱验证码、可选的微信身份通道、页面内相机扫码和持久手机登录，让手机通过自有服务器访问本地 Harness。
- @sparkelf/dsh-dataops-integration：独立DSH的完整DataOps Host + Web Client连接插件，拥有Authorization Code + PKCE、持久target、session-lifetime access credential、Settings和generic MCP组合；不修改DSH core，也不在DataOps托管容器中挂载。
- @sparkelf/dsh-dataops-managed：DataOps托管workspace的JWT与HTTP MCP插件；复用当前DataOps会话权限，不发起OAuth，也不提供连接或断开操作。
- @sparkelf/dsh-chart：完整的 Host + Web Client 交互图表 capability。Host 记录可 durable replay 的完整 ECharts option，Client 在 Harness 消息流中渲染并负责 resize、主题切换和 disposal。当前为 opt-in 发布候选，不默认挂载，也不在正式发布前声明生产 npm pin。
- @sparkelf/dsh-credential-manager：Host + Web Client 凭据管理插件，提供凭据列表、连接器模板、工作区 vault 持久化与右侧栏管理入口；不依赖 Plus 产品分支。
- @sparkelf/dsh-query-result-analysis：有界分页、checkpoint和hierarchical reduction的独立DataOps query-result分析插件；每个模型批次和归并进入持久DSH子会话，由普通AgentLoop记录模型可见内容并拥有重试。
- @sparkelf/dsh-mineru：独立的PDF解析工具。它直接读取official file upload向模型提供的只读路径并调用MinerU，不接管附件上传、prompt或Client UI。
- @sparkelf/dsh-officecli：把官方 OfficeCLI 二进制接入单入口 officecli 工具；结构化 argv 原样执行，直接读写原始 .docx/.xlsx/.pptx，不另造预览链路。
- @sparkelf/dsh-office-viewer-fonts：向 Better Sidebar Office Viewer 提供政务字体资产和 OfficeCLI 政务文档 Skill，不依赖 Univer。
- @sparkelf/dsh-plugin-supervisor：独立的 Plus runtime Supervisor，提供 Host Session捕获/恢复入口、dsh-plus-supervisor Node executable、local command socket和进度页；不依赖 Plus fork源码。

CI / CD

- CI（ci.yml）：每次 push 和 PR 都执行 pnpm install、tsc --noEmit、Vitest 单元测试和可发布制品构建。
- CD（publish.yml）：v tag 触发后，重新执行 typecheck、测试和构建，再使用 NPM_TOKEN secret 将包发布到 npm。
- UI 系统测试只断言可操作交互和可见状态变化；间距、对齐、像素几何、计算样式和截图由人在目标视口审查，截图不作通过条件。真实DataOps取数、分析、图表和刷新回放用例要求已配置且已连接的profile及显式业务prompt/marker；缺少输入时只记为skip，不作为验收通过。

添加插件

1. 创建 packages/<name>，按照 Cordis 插件模式实现 name、inject 和 apply；上游 dsh 的 @deepseek-ai/dsh-command-compact 可作为参考。
2. 在包旁添加不需要密钥的单元测试。
3. 插件不得依赖 deepseek-harness-plus；只能依赖已发布的上游包（@deepseek-ai/cordis、@deepseek-ai/dsh-）。
4. 更新包版本，并通过 v<repo-version> tag 发布。
5. 根文档和面向用户的包 README 必须在同一 README.md 中维护“中文”和“English”两个对应章节，内容变更时同步更新。

本仓库收录 SparkElf 维护的独立 DeepSeek Harness（dsh）插件。这些插件通过配置档组合包安装到上游 dsh（dsh plugin --profile <name> add <package-or-git-spec>；每个包各自声明 Cordis 插件入口），从不依赖 deepseek-harness-plus 产品分支。

仓库边界

- deepseek-harness-plus 跟进 dsh 与 Plus 产品，通过版本锁定的清单组合第三方插件。
- 本仓库持有 SparkElf 插件的源码，让它们在原版 dsh 上依然可用。归属与分发规则记录在 Plus 插件归属与分发决策中。

插件

- @sparkelf/dsh-plugin-ping：提供 /ping 连通性命令，直接回复 pong，不调用模型。
- @sparkelf/dsh-mobile-bridge：完整的 Host 与 Client 插件，提供出站 E2EE 隧道、配对二维码，以及一等公民的 Mobile Bridge 设置区。手机端只注入连接门面；各 Harness 包各自保留自己的响应式 UI。
- @sparkelf/dsh-mobile-bridge-server：多用户盲中继，支持邮箱验证码与可选的微信身份通道、页内摄像头扫码、手机端持久登录，让手机通过自托管服务器访问本地 Harness。
- @sparkelf/dsh-dataops-integration：面向独立 DSH 的完整 Host + Web Client DataOps 连接插件。它负责 Authorization Code + PKCE、持久目标、会话期访问凭证、设置，以及通用 MCP 组合；不改动 DSH 核心，也不挂载到 DataOps 托管的容器中。
- @sparkelf/dsh-dataops-managed：面向 DataOps 托管工作区的 JWT 与 HTTP MCP 插件。它复用当前 DataOps 会话权限，不需要 OAuth，也没有连接/断开控件。
- @sparkelf/dsh-chart：完整的 Host + Web Client 交互式图表能力。Host 记录完整的 ECharts option，供持久回放；Client 在 Harness 会话中渲染图表，并负责尺寸调整、主题切换与销毁。目前是需手动启用的候选版本，默认不挂载，在真正发布之前不承诺生产环境的 npm 版本锁定。
- @sparkelf/dsh-query-result-analysis：独立的 DataOps 查询结果分析插件，支持有界分页、检查点与分层归约。每个模型批次与归约都在持久的 DSH 子会话中运行，由子会话的常规 AgentLoop 记录模型可见内容并负责重试。
- @sparkelf/dsh-mineru：独立的 PDF 解析工具。它读取展示给模型的官方文件上传路径，调用 MinerU，但不负责附件接收、提示词准入或 Client UI。
- @sparkelf/dsh-officecli：通过 officecli 工具暴露官方 OfficeCLI 二进制。结构化 argv 原样作用于原始 .docx/.xlsx/.pptx 文件，不另设预览路径。
- @sparkelf/dsh-office-viewer-fonts：为 Better Sidebar Office Viewer 提供公文（government-document）字体资源与 OfficeCLI 公文技能，不依赖 Univer。
- @sparkelf/dsh-plugin-supervisor：独立的 Plus 运行时 Supervisor，包含 Host Session 捕获/恢复入口、dsh-plus-supervisor Node 可执行文件、本地命令 socket 和进度页，不依赖 Plus fork 源码。

CI / CD

- CI（ci.yml）：每次 push 和 PR 都运行 pnpm install、tsc --noEmit、Vitest 单元测试，以及可发布产物构建。
- CD（publish.yml）：打 v 标签时，先重复类型检查、测试和构建，再用 NPM_TOKEN secret 把包发布到 npm。
- UI 系统测试只断言可操作的交互和可见的状态变化。间距、对齐、像素几何、计算后的 CSS 和目标视口下的截图由人工审查；截图不作为通过标准。真实的 DataOps 查询、分析、图表和重载回放用例，需要已配置的连接配置档，外加明确的业务提示词/标记；缺少输入时只产生跳过，绝不作为验收证据。

添加插件

1. 创建 packages/<name>，按 Cordis 插件模式实现 name、inject 和 apply；参考上游 dsh 的 @deepseek-ai/dsh-command-compact。
2. 在包旁边添加无需密钥的单元测试。
3. 插件保持独立于 deepseek-harness-plus，只依赖已发布的上游包（@deepseek-ai/cordis、@deepseek-ai/dsh-）。
4. 提升包版本，通过 v<repo-version> 标签发布。
5. 面向仓库和用户的包文档，必须在同一个 README.md 中保留对应的「中文」和「English」两节，内容变化时同步更新。