前言¶
DSH 通过插件扩展外部能力。若要把 Livis 的消息、文件上传和结果回传接入持久 DSH Agent，单独处理授权、绑定、连接状态和任务幂等会比较零散。fyy99/dsh-livis-connector 是一个原生 Cordis 插件，将 Livis 接入 DeepSeek Harness，授权、Agent ID 绑定引导与连接状态都在 DSH 设置页完成，运行时不依赖 OpenClaw。
这是什么¶
fyy99/dsh-livis-connector 是 fyy99 维护的独立社区连接器，许可证为 MIT。它解决的问题是在 DSH Web 设置页完成 Livis 账号授权和连接管理，并把 Livis 消息交给持久 DSH Agent 后可靠回传结果。
它不隶属于或代表 DeepSeek、理想汽车或 Livis；相关名称归各自权利人所有。
核心能力¶
- 在 DSH 设置页完成 Livis 账号授权和连接管理
- 生成并展示 Agent ID，引导在 Livis App 中完成设置
- 将 Livis 消息交给持久 DSH Agent，并把结果可靠回传
- 支持取消、结果确认、断线重连和
job_id幂等 - 支持白名单文档上传，并限制在配置的目录内
refresh token仅保存在 DSH Host，不会下发到浏览器页面- 运行时不依赖 OpenClaw
环境要求¶
- Node.js：
^22.19.0 || >=24.0.0 - DeepSeek Harness：
0.1.0-rc.6 - DSH 仍处于 developer preview；本插件跟随其插件 API 演进，升级 DSH 前请先检查兼容性
安装与启用¶
下面介绍安装和启动 Web profile 的步骤。先安装 GitHub 仓库，再 dump 当前配置，最后启动 Web profile。
1、使用 DSH 官方插件命令安装 GitHub 仓库：
dsh plugin --profile web add github:fyy99/dsh-livis-connector
2、安装后执行配置 dump，确认插件配置已经进入当前 profile：
dsh --profile web --dump-config
3、启动 Web profile：
dsh web
连接 Livis¶
连接流程如下：
1、打开 DSH，进入「设置 → 插件 → Livis」。
2、点击「开始授权」，等待页面显示已连接到 DSH，并复制生成的 Agent ID。
3、在 Livis App「我的 → 连接与服务 → 我的 Agent」粘贴 Agent ID。
4、从 Livis App 发送一条测试消息，确认消息进入 DSH Agent 并能收到回传。
授权中断或过期时，回到同一页面重新发起即可；插件不会在页面加载时自动开始授权。
可复现部署¶
需要可复现部署时，把 GitHub 依赖固定到经过验证的 commit SHA，而不是长期跟随默认分支。
也可以先执行 npm pack 生成 tarball，再把 tarball 路径交给同一个 dsh plugin --profile web add 命令：
npm pack
安全与注意¶
- 不要把 DSH Web 监听到
0.0.0.0。管理 RPC 只允许 loopback，但 DSH Web 本身不提供用户登录认证。 - Livis relay 会处理账号令牌、设备与 Agent ID、消息、回复，以及用户明确上传的文件。
- 三个目录字段必须使用绝对路径。
- 生产端点强制
HTTPS/WSS；仅localhost测试允许明文协议。 - 远端文本始终作为普通用户消息进入模型，不会作为 DSH 斜杠命令执行。
- Livis Agent 的审批策略固定为
never；需要本地批准的操作会失败。 - 建议使用专用低权限 API Key，不要使用
danger-full-access，并让 DSH 在无敏感数据的工作区运行。 - 插件会在当前
dsh进程权限下运行，安装前应先检查源码与 MIT 许可证。 - 发现安全问题应通过仓库 Security Advisories 私下报告，不要在公开 Issue 提交令牌、Agent ID、消息内容或本机路径。
结尾¶
fyy99/dsh-livis-connector 的价值是把 Livis 授权、Agent ID 绑定、消息回传和上传限制放进 DSH 设置页，减少外部连接的手工配置。它适合作为 DSH Web profile 下的社区连接器使用，但需要保持版本兼容性和低权限运行边界。
GitHub 仓库：https://github.com/fyy99/dsh-livis-connector
目录页线索：https://www.skillhub.cn/plugins/fyy99/dsh-livis-connector（未在本材料中验证，不作为确定事实）
