fyy99/dsh-livis-connector
30Last commit Aug 14, 2026
dsh-livis-connector DSH plugin
This plugin allows users to authorize a Livis account directly in the DSH settings page, generate an Agent ID, and guide the binding process in the Livis App. Livis messages are reliably forwarded to a persistent DSH Agent, and results are sent back. It supports reconnection, job idempotency, and configurable file upload restrictions.
How to install the dsh-livis-connector DSH plugin
dsh plugin --profile web add github:fyy99/dsh-livis-connectorCopying does not run this command. Review the repository and version before installing the dsh-livis-connector DSH plugin.
dsh-livis-connector DSH plugin data source
dsh-livis-connector DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-livis-connector DSH plugin can do
- Complete Livis authorization and connection management inside the DSH settings page.
- Generate and display an Agent ID, with guidance to paste it in the Livis App.
- Relay Livis messages to a persistent DSH Agent and return the results reliably.
- Support cancellation, result confirmation, disconnection reconnection, and job_id idempotency.
- Restrict file uploads to a whitelisted directory and keep refresh tokens only on the DSH host.
Where the dsh-livis-connector DSH plugin fits
- Chat with a DSH Agent through the Livis App without opening the DSH web interface.
- Send files from Livis to the DSH Agent for processing and receive results back.
- Provide a mobile-friendly interface for DSH interactions via Livis.
- Automatically reconnect after network interruptions to ensure message delivery.
- Manage multiple Livis agents by repeating the authorization and binding process in the settings page.
Who the dsh-livis-connector DSH plugin is for
- Users who already use Livis as a messaging platform and want to leverage AI agents powered by DSH.
- Developers or teams who have deployed DeepSeek Harness and need to expand access channels to end users via Livis.
dsh-livis-connector DSH plugin limitations
- Requires Node.js ^22.19.0 || >=24.0.0 and DeepSeek Harness 0.1.0-rc.6 or compatible versions.
- DSH is in developer preview; the plugin's API may evolve, and compatibility must be checked before upgrading DSH.
- The Livis Agent's approval policy is fixed to 'never', so operations requiring local approval will fail.
- File uploads are restricted to the configured `uploadRoot` directory and must use absolute paths.
- The DSH Web server should not be exposed to 0.0.0.0; management RPC only allows loopback.
dsh-livis-connector DSH plugin: from the repository README
Quoted from the fyy99/dsh-livis-connector README, the upstream source of the dsh-livis-connector DSH plugin. Copyright remains with the original authors.
将 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 插件配置中覆盖以下字段： |
Read the full READMERepository license: MIT
dsh-livis-connector DSH plugin questions
How do I install dsh-livis-connector?
Run `dsh plugin --profile web add github:fyy99/dsh-livis-connector` in your DSH environment. Then run `dsh --profile web --dump-config` to verify the configuration, and start the web profile with `dsh web`. For reproducible deployments, pin the plugin to a specific commit SHA instead of the default branch.
How do I connect my Livis account to DSH?
Open DSH, go to Settings → Plugins → Livis, click 'Start Authorization', and confirm the authorization in the Livis account page. Once the page shows 'Connected to DSH', copy the generated Agent ID, paste it into the Livis App under 'My → Connections & Services → My Agent', and send a test message from Livis. The plugin will then light up and be ready.
Can I upload files from Livis to the DSH Agent?
Yes, the plugin supports file uploads from Livis, but only within the configured `uploadRoot` directory (defaults to the DSH startup directory). You can restrict uploads by setting the `uploadRoot` configuration to an absolute path. Files outside this directory will be rejected.
Is my data secure with this plugin?
The plugin stores refresh tokens only on the DSH host, never in the browser. Livis relay handles tokens, Agent ID, messages, replies, and uploaded files. The plugin uses a fixed approval policy of 'never' for operations requiring local approval, so such operations will fail safely. It is recommended to use a dedicated low-privilege API key and run DSH in a workspace without sensitive data. Do not expose DSH Web to 0.0.0.0.
What happens if the Livis connection is interrupted?
The plugin supports automatic reconnection. It also maintains job idempotency via `job_id`, so if a message is sent multiple times due to reconnection, it will be processed only once. Final state tasks are kept in `stateDir/jobs.json` for 24 hours by default, allowing recovery after a restart.