DeepSeek Harness 插件开发与生态算法指南
深入了解 DeepSeek Harness 官方开源插件的标准文件结构、7-Zip 万能解包流程、鲸鱼币经济体系以及排行榜权重综合计算公式。
一、DeepSeek Harness 官方标准插件结构规范
支持 .7z、.zip、.tar.gz 等多种主流打包格式，服务端自动解压校验
DeepSeek Harness (DSH) 插件采用轻量模块化设计，一个标准的 DSH 开源插件压缩包根目录或单一主目录下，包含核心清单文件 `plugin.json` (或 `manifest.json`)、说明文档 `README.md` 以及入口脚本。
📦 官方标准目录树 (Directory Tree)：
dsh-my-plugin/
├── plugin.json # 必选：插件核心元数据声明清单
├── README.md # 必选：中文使用说明与交互范例
├── index.js # 系统半体：后端逻辑 / MCP 工具调度
├── client.js # 客户端半体：UI 浮窗 / 快捷按键响应 (可选)
├── prompts/ # 提示词库：CoT 结构化提示词模板 (可选)
│ └── main.md
└── assets/ # 静态素材：图标与效果预览图 (可选)
└── icon.png📄 plugin.json 规范事实源示例：
{
"id": "dsh-infinite-gen",
"name": "无限生成加速引擎",
"version": "1.0.0",
"description": "多轮思维链自动提纯与无损续写",
"author": "创作者开发者昵称",
"platform": "all", // all | desktop-exe | linux | web
"harnessVersion": ">=1.0.0",
"entry": "index.js",
"permissions": ["network", "storage"],
"tags": ["deepseek", "productivity", "cot"],
"category": "tools"
}智能容错解包支持：
若压缩包由 7-Zip 或系统自带工具多包了一层同名文件夹，本平台的开源 7z-CLI 服务端解析器会自动穿透单层包裹并精准定位 `plugin.json`。若缺少该文件，系统将基于文件名和 `README.md` 进行智能元数据推导，确保即传即用。
二、DeepSeek Harness 桌面端与插件市场「一键安装联动协议规范」
定义网页端、文档及第三方服务如何通过系统级 URI Scheme 安全唤起官方桌面客户端 (EXE) 并完成免命令行秒级装载
本协议定义了 DeepSeek 插件市场（网页端/第三方服务） 如何通过自定义 URI Scheme 协议安全唤起 DeepSeek Harness 官方桌面端客户端（EXE） 并完成插件的一键导入与自动装载。
1协议基础定义 (URI Scheme)
dsh://
/plugin/install
2参数定义与数据字典 (Query Parameters)
所有 Query 参数均需经过标准的 URL 编码（encodeURIComponent）：
| 参数名 (Key) | 类型 (Type) | 是否必填 | 说明与示例 |
|---|---|---|---|
| id | string | 必填 | 插件唯一标识符，英文小写。例如：open-design、latex-ocr |
| name | string | 必填 | 插件中文/英文展示名称。例如：打开 Design 视觉设计助手 |
| version | string | 必填 | 插件语义化版本号。例如：1.0.0、latest |
| repo | string | 必填 | 官方/开源仓库地址或 npm 包名。例如：nexu-io/open-design 或 @deepseek-ai/dsh-latex-ocr |
| permissions | string | 可选 | 插件所需权限描述（客户端弹窗提示用）。例如：网络访问, 本地文件读取 |
| downloadUrl | string | 可选 | 离线 zip/tar 安装包直链地址（备用回退分发渠道）。 |
3标准 URL 示例 (URI Scheme Examples)
4网页端（前端）触发代码规范
/**
* 唤起 DeepSeek Harness 桌面客户端一键安装插件
*/
export function installPluginToDesktop(plugin: {
id: string;
name: string;
version: string;
repo: string;
permissions?: string;
downloadUrl?: string;
}) {
const params = new URLSearchParams({
id: plugin.id,
name: plugin.name,
version: plugin.version || 'latest',
repo: plugin.repo || plugin.id,
permissions: plugin.permissions || '常规权限',
downloadUrl: plugin.downloadUrl || '',
});
const deepLink = `dsh://plugin/install?${params.toString()}`;
// 1. 通过隐藏 iframe 安全静默拉起协议
const iframe = document.createElement('iframe');
iframe.style.display = 'none';
iframe.src = deepLink;
document.body.appendChild(iframe);
setTimeout(() => document.body.removeChild(iframe), 2000);
}5桌面端（Electron / Tauri / Native EXE）生命周期处理规范
桌面客户端在接收到系统级 dsh:// 请求后，需严格遵循以下安全交互与自动装载流程：
协议捕获与窗口置顶
解析 URL Query 参数，主进程唤醒客户端并置顶显示。
元数据与权限弹窗
弹出安装授权面板，明确向用户展示插件名称、版本与申请权限。
用户确认与拉取包
用户点击确认后，客户端优先拉取 GitHub 仓库或备用下载源。
热重载与完成通知
解压至 ~/.dsh/plugins/，热加载插件并弹出成功通知。
6Windows 系统注册表关联规范（供打包工具参考）
安装包（Inno Setup / NSIS / Electron Builder / Tauri）或应用初始化时向系统注册表写入 dsh:// 关联：
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Classes\dsh] @="DeepSeek Harness Protocol" "URL Protocol"="" [HKEY_CURRENT_USER\Software\Classes\dsh\DefaultIcon] @="\"C:\\Users\\Administrator\\AppData\\Local\\Programs\\DeepSeek-Harness\\icon.ico\",0" [HKEY_CURRENT_USER\Software\Classes\dsh\shell] [HKEY_CURRENT_USER\Software\Classes\dsh\shell\open] [HKEY_CURRENT_USER\Software\Classes\dsh\shell\open\command] @="\"C:\\Users\\Administrator\\AppData\\Local\\Programs\\DeepSeek-Harness\\DeepSeek Harness.exe\" \"%1\""
DeepSeek Harness 官方桌面客户端 (EXE) 已内置支持该协议
无需任何繁复配置，安装官方桌面端后即可在任意浏览器或第三方平台享受「一键装载」极致体验。
三、创作者荣誉等级体系
创作者等级越高，享有越显著的生态荣誉与榜单加成
创作者荣誉等级与榜单加权积分对照表
| 创作者等级 | 累计获得鲸鱼币 | 荣誉头衔徽章 | 额外榜单加权积分 |
|---|---|---|---|
| Lv.1 初级探索者 | 0 ~ 9 币 | 初级探索者 | 基础积分 (+0) |
| Lv.2 活跃极客 | 10 ~ 29 币 | 活跃极客 | +50 点权重积分 |
| Lv.3 资深创作者 | 30 ~ 99 币 | 资深创作者 | +150 点权重积分 |
| Lv.4 生态领航者 | 100 ~ 299 币 | 生态领航者 | +300 点权重积分 |
| Lv.5 社区巨鲸 | 300+ 币 | 社区巨鲸 | +500 点顶级加权积分 |
四、鲸鱼币获取与生态应用场景
每日签到、投币打榜、自主定价与悬赏认领
📅 1. 每日签到 (+1 币)
每天在导航栏或控制台签到立得 1 鲸鱼币，连续签到满 7 天额外奖励 +2 币连签大礼包。
💰 2. 创作者自主定价
创作者可将插件设为 1~5 鲸鱼币专享下载（一次解锁，终身免费升级），收益 100% 归创作者。
🙋♂️ 3. 需求悬赏认领
在需求广场认领并解决社区用户的定制需求，方案被采纳后直接获取悬赏池中的全部鲸鱼币。