fyy99/dsh-livis-connector
30最近提交 2026年8月14日
dsh-livis-connector DSH 插件
该插件允许用户在 DSH 设置页中直接授权 Livis 账号，生成 Agent ID 并引导在 Livis App 中绑定。Livis 消息会被可靠地转发给持久 DSH Agent，并将结果回传。支持断线重连、任务幂等以及可配置的文件上传限制。
如何安装 dsh-livis-connector DSH 插件
dsh plugin --profile web add github:fyy99/dsh-livis-connector复制不会执行命令。安装 dsh-livis-connector DSH 插件前请核对仓库和版本。
dsh-livis-connector DSH 插件数据来源
dsh-livis-connector DSH 插件快照日期：2026年8月16日
discovered
dsh-livis-connector DSH 插件能做什么
- 在 DSH 设置页中完成 Livis 账号授权和连接管理。
- 生成并展示 Agent ID，引导用户在 Livis App 中粘贴绑定。
- 将 Livis 消息发送给持久 DSH Agent 处理，并将结果可靠回传。
- 支持取消、结果确认、断线重连和 job_id 幂等。
- 限制文件上传到配置的白名单目录，且 refresh token 仅保存在 DSH 主机，不泄露给浏览器。
dsh-livis-connector DSH 插件适合哪些场景
- 通过 Livis App 与 DSH Agent 对话，无需打开 DSH Web 界面。
- 从 Livis 发送文件给 DSH Agent 处理，并接收处理结果。
- 为 DSH 交互提供移动端友好界面（通过 Livis）。
- 网络中断后自动重连，确保消息不丢失。
- 在设置页中重复授权和绑定流程，管理多个 Livis Agent。
dsh-livis-connector DSH 插件适合谁
- 使用 Livis 作为消息平台、希望利用 DSH 驱动 AI Agent 的用户。
- 已经部署 DeepSeek Harness、需要扩展访问渠道的开发者或团队。
dsh-livis-connector DSH 插件的限制
- 需要 Node.js ^22.19.0 || >=24.0.0 以及 DeepSeek Harness 0.1.0-rc.6 或兼容版本。
- DSH 处于 developer preview 阶段，插件 API 可能演进，升级 DSH 前需检查兼容性。
- Livis Agent 的审批策略固定为 never，需要本地批准的操作会失败。
- 文件上传限制在配置的 `uploadRoot` 目录内，且必须使用绝对路径。
- DSH Web 服务器不应监听 0.0.0.0，管理 RPC 仅允许 loopback。
dsh-livis-connector DSH 插件的仓库 README 摘录
以下文字摘自 dsh-livis-connector DSH 插件的上游仓库 fyy99/dsh-livis-connector 的 README，版权归原作者，仅作引用。
将 Livis 接入 [DeepSeek Harness](https://github.com/deepseek-ai/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 仓库： ```bash dsh plugin --profile web add github:fyy99/dsh-livis-connector dsh --profile web --dump-config ``` 随后启动 Web profile： ```bash 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 插件配置中覆盖以下字段： |
阅读完整 README仓库许可: MIT
dsh-livis-connector DSH 插件常见问题
如何安装 dsh-livis-connector？
在 DSH 环境中运行 `dsh plugin --profile web add github:fyy99/dsh-livis-connector`，然后运行 `dsh --profile web --dump-config` 验证配置，最后用 `dsh web` 启动 Web profile。如需可复现部署，建议将插件固定到特定 commit SHA 而非默认分支。
如何将我的 Livis 账号连接到 DSH？
打开 DSH，进入「设置 → 插件 → Livis」，点击「开始授权」，在 Livis 账号页面确认授权。等待页面显示「已连接到 DSH」，复制生成的 Agent ID，在 Livis App 中打开「我的 → 连接与服务 → 我的 Agent」，粘贴 Agent ID，然后从 Livis 发送一条测试消息，插件即可点亮使用。
可以从 Livis 向 DSH Agent 上传文件吗？
可以，插件支持从 Livis 上传文件，但仅限于配置的 `uploadRoot` 目录（默认为 DSH 启动目录）。你可以通过设置 `uploadRoot` 配置项为绝对路径来限制上传范围，目录外的文件将被拒绝。
使用这个插件数据安全吗？
插件将 refresh token 仅保存在 DSH 主机，不会下发到浏览器页面。Livis relay 会处理令牌、Agent ID、消息、回复和用户上传的文件。插件采用固定为 never 的审批策略，需要本地批准的操作会安全失败。建议使用专用低权限 API Key，并在无敏感数据的工作区运行 DSH，不要将 DSH Web 监听 0.0.0.0。
如果 Livis 连接中断会怎样？
插件支持自动重连。同时通过 `job_id` 实现幂等，确保重连期间重复发送的消息只被处理一次。最终状态任务会默认在 `stateDir/jobs.json` 中保留 24 小时，重启后也可恢复。