DeepSeek Harness 插件

dsh-lan-sparkwei

DSH bundle: expose the Web GUI on the LAN (bind 0.0.0.0) and add a deepseek/balance RPC that queries the official DeepSeek balance with the PC-side credential(英文原文)

跳到安装方式

来源信息

GitHub 仓库
SparkWeiyang/dsh-lan
最近更新
2026年8月16日
分类
界面增强
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/SparkWeiyang/dsh-lan
插件名:dsh-lan-sparkwei
作者:SparkWeiyang

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-lan

DeepSeek Harness (DSH) 的局域网开放插件。一个 bundle 提供两个能力:

1. 局域网开放:把 Web GUI 绑定到 0.0.0.0dsh-web-app 自动枚举所有 IPv4 地址作为浏览器信任栅栏白名单,无需任何补丁或启动参数。 2. deepseek/balance RPC:用 PC 端已配置的 DEEPSEEK_API_KEY 凭证查询 DeepSeek 官方账户余额(GET https://api.deepseek.com/user/balance),密钥永不出 PC,手机等远程客户端直接调用即可。

> 仓库:https://github.com/SparkWeiyang/dsh-lan · topic: dsh-plugin

安装

# 从 npm(若已发布)
dsh plugin --profile web add dsh-lan

# 或从本地目录
dsh plugin --profile web add file:../dsh-lan

然后把 dsh-lan 加入 web profile 的 bundle 列表(必须在 @deepseek-ai/dsh-web-app 之后)。 编辑 $DSH_HOME/profiles/web/package.json

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-lan"
      ]
    }
  }
}

使用

dsh web              # 绑定 0.0.0.0:3080,局域网可访问
dsh web --port 8080  # 换端口

启动后 web-runtime 会打印局域网 URL(如 (LAN: http://192.168.x.x:3080))。

余额查询 RPC

客户端向 harness 发送标准 RPC 信封(Typert 端点约定 payload.args):

{
  "type": "client-request",
  "rpcId": "uuid",
  "method": "deepseek/balance",
  "payload": { "args": {} }
}

响应 result.value 即 DeepSeek 官方余额:

{
  "is_available": true,
  "balance_infos": [
    { "currency": "CNY", "total_balance": "8.27", "granted_balance": "0.00", "topped_up_balance": "8.27" }
  ]
}

PC 端凭证未配置时返回 internal 错误(DEEPSEEK_API_KEY credential is not configured)。

原理

  • bundle patch(cordis.patch.yml):覆盖 webserverhost: 0.0.0.0(端口仍随 --port 可调),并插入 deepseek-service 行加载本插件。
  • 运行时插件(lib/index.js):一个 TypertRemoteService 子类(serviceKey=deepseek@Remote('balance')),以 SRC 模式注册端点 deepseek/balance;实现内用 ctx.credentials.resolve('DEEPSEEK_API_KEY') 取得 PC 端凭证后调用官方接口。

安全警告

DSH Web carrier 没有鉴权层(信任栅栏只是可达性策略)。绑定 0.0.0.0 后,同网段任何人都可驱动会话执行命令。请仅在可信网络暴露,或在前面加反向代理 + 认证。