通过DeepSeek Harness接入插件包

如果你的团队已经拥有一个部署并运行中的 DeepSeek Harness (DSH) 对话系统实例，你不需要重新拉取整个客户端仓库。只需通过安装并启用 @jingyun-ai/jingyun-dsh 品牌定制插件包，即可瞬间在已有的 DSH 实例上接入完整的会员体系、支付通道、算力管控以及应用市场。

本指南将指导你完成插件包的集成、配置与启动过程。

---

🛠️ 第一步：安装插件依赖包

在你的已有 DSH 实例项目的根目录下，使用对应的包管理器将井云插件包安装为项目依赖：

# 使用 npm 安装
npm install @jingyun-ai/jingyun-dsh

# 或者使用 pnpm 安装 (推荐)
pnpm add @jingyun-ai/jingyun-dsh

# 或者使用 yarn 安装
yarn add @jingyun-ai/jingyun-dsh

---

⚙️ 第二步：在 DSH 配置中启用插件

DeepSeek Harness (DSH) 底层采用轻量级插件框架 Cordis 进行模块装配。你需要在你的 DSH 插件注册表或配置文件中声明并启用此插件：

2.1 方式 A：通过 dsh.config.yml (或 cordis.yml) 配置文件配置

在你的项目配置文件中，在 plugins 列表中加入该插件模块：

# dsh.config.yml 示例
plugins:
  # 其他已有插件...
  group:database: {}
  group:auth: {}
  
  # 启用并加载井云品牌定制与商业化插件
  @jingyun-ai/jingyun-dsh:
    # 可以在此处填入可选配置参数（通常推荐使用下文独立的 json 配置文件进行对接）

2.2 方式 B：通过代码动态加载 (如果你的 DSH 采用代码级引导)

如果你的 DSH 是通过编写脚本（如 index.js）手动启动的，可以通过 Cordis 的 ctx.plugin 方法动态注册：

import { Context } from 'cordis';
import JingyunDshPlugin from '@jingyun-ai/jingyun-dsh';

const ctx = new Context();

// 注册井云商业化插件
ctx.plugin(JingyunDshPlugin);

await ctx.start();

---

📝 第三步：创建商业对接配置文件

插件加载后，需要知道对接哪个井云租户、API 服务地址以及前端展示品牌。

1. 在已有 DSH 项目的根目录下，新建一个配置文件：
   📄 jingyun-config.json
2. 在文件中填入你的专属商业化参数配置：

{
  "api_url": "https://api.jingyun.studio",
  "tenant_host": "your_tenant_key_here",
  "domain": "https://your_tenant_key_here.jingyun.online",
  "custom_name": "我的定制 AI 助手",
  "custom_logo": "https://your-domain.com/static/my-logo.png"
}

🔍 字段配置说明：

• api_url：井云平台 SaaS 后台或私有化部署的 API 服务接口地址（通常官方 SaaS 默认使用 https://api.jingyun.studio）。
• tenant_host：你在 井云 Studio 后台 获取到的租户唯一 Key（例如：a8c2d1b0）。
• domain：你为客户端/Web 网页分配的加载域名或租户的专属二级域名（用于对接安全防刷鉴权）。
• custom_name：客户端主界面和标题栏需要显示的自定义品牌名称。
• custom_logo：自定义 Logo 图标的在线 CDN 图片 URL，将自动替换 DSH 系统默认的 Logo。

---

🚀 第四步：启动已有 DSH 服务

完成上述配置后，以你原有的方式启动 DSH 系统：

# 示例：通过 bin.js 启动 DSH Web 实例
node node_modules/@deepseek-ai/dsh/lib/bin.js --profile web

在控制台日志中，你应该能看到如下类似的插件加载成功提示：

[Cordis] apply plugin @jingyun-ai/jingyun-dsh
[Jingyun] Loading tenant configuration from jingyun-config.json...
[Jingyun] Successfully connected to Tenant: your_tenant_key_here

---

💡 第五步：工作原理与注入效果

启用插件后，@jingyun-ai/jingyun-dsh 会自动对你的 DSH 页面执行切面注入（AOP），无需你修改任何前端 React/HTML 代码，主要实现以下变化：

sequenceDiagram
    participant User as 用户浏览器
    participant DSH as DSH Web 服务 (已有实例)
    participant Plugin as jingyun-dsh 插件包
    participant JY as 井云云端后台 (SaaS)

    User->>DSH: 访问网页端口
    DSH->>Plugin: 装载并初始化前端运行时
    Plugin->>JY: 根据 tenant_host 获取商业配置
    JY-->>Plugin: 返回品牌信息、会员套餐列表、计费费率
    Plugin->>User: 注入渲染自定义 Logo/应用名/专家选择器
    User->>Plugin: 点击"升级会员"或"算力充值"
    Plugin->>User: 自动拉起内置 JYUpgradeModal / JYRechargeModal 支付弹窗

1. 品牌视觉替换：DSH 默认的头部、侧边栏 Logo 和名称都会被自动重写为 jingyun-config.json 里的自定义品牌名与 Logo 图片。
2. 账号登录拦截：客户端会在相关操作前强行拉起手机号短信登录弹窗（JYLoginModal），替代原有的简易账号系统，并将用户数据归集到你的井云商户后台。
3. 算力与计费控制：用户每次发送消息，插件会拦截输入/输出，核算 Token 后向井云云端接口发起账单扣费。余额不足时会自动弹出 JYUpgradeModal 升级套餐。
4. 云端资产连通：历史对话和专属知识库会自动走井云云端存储同步，实现跨设备登录时的数据不丢失。