dsh-livis-connector

将 Livis 接入 DeepSeek Harness 的原生 Cordis 插件。授权、Agent ID 绑定引导与连接状态都在 DSH 设置页完成，运行时不依赖 OpenClaw。

功能

• 在 DSH 设置页完成 Livis 账号授权和连接管理。
• 生成并展示 Agent ID，引导在 Livis App 中完成设置。
• 将 Livis 消息交给持久 DSH Agent，并把结果可靠回传。
• 支持取消、结果确认、断线重连和 job_id 幂等。
• 支持白名单文档上传，并限制在配置的目录内。
• refresh token 仅保存在 DSH Host，不会下发到浏览器页面。

环境要求

• Node.js ^22.19.0 || >=24.0.0
• DeepSeek Harness 0.1.0-rc.6
• 已在 DSH 中配置可用的模型和 API Key
• 可正常访问 Livis 账号授权与中继服务

DSH 仍处于 developer preview。本插件跟随其插件 API 演进，升级 DSH 前请先检查兼容性。

安装

使用 DSH 官方插件命令安装 GitHub 仓库：

dsh plugin --profile web add github:fyy99/dsh-livis-connector
dsh --profile web --dump-config

随后启动 Web profile：

dsh web

需要可复现部署时，请把 GitHub 依赖固定到经过验证的 commit SHA，而不是长期跟随默认分支。

也可以先执行 npm pack 生成 tarball，再把 tarball 路径交给同一个 dsh plugin --profile web add 命令。

连接 Livis

1. 打开 DSH，进入「设置 → 插件 → Livis」。
2. 点击「开始授权」，在打开的理想账号页面确认授权。
3. 等待页面显示已连接到 DSH，并复制生成的 Agent ID。
4. 在 Livis App 打开「我的 → 连接与服务 → 我的 Agent」，粘贴 Agent ID。
5. 从 Livis App 发送一条测试消息。第三步点亮后即可使用。

如果授权中断或过期，回到同一页面重新发起即可。插件不会在页面加载时自动开始授权。

配置

插件可在 DSH 插件配置中覆盖以下字段：

字段	默认值	用途
enabled	true	启用或停用连接器
stateDir	$DSH_HOME/livis	保存授权、身份和幂等任务状态
workspaceRoot	DSH 启动目录	Livis Agent 的工作区
uploadRoot	workspaceRoot	允许回传文件的根目录
provider / model	DSH 当前默认模型	同时设置时覆盖默认模型