DSH 插件数据链路:Host 管数据,Client 只管画

你之前问过我一个问题:DSH 插件要展示数据,数据是不是只能从 Client 来?如果不是,那从哪来?Host 端的数据又从哪来?Host 和 Client 到底怎么通信?

我当时的回答里掺了一些冗余信息,比如拿 localStorage 举例子,混淆了"数据到了浏览器之后存哪"和"数据从哪来"。这篇整理后的版本只保留必要的事实,并且用具体插件做例子。核心结论一句话:数据归 Host 管。Client 不自己去"找"数据,它发起一次对 Host 的调用,Host 返回结果,Client 负责渲染。

一、先反驳一个常见的误解

有一种说法是:"Client 端也可以持有数据,比如 localStorage,所以 Client 不一定依赖 Host。"

这个说法技术上没错,但在讨论"插件展示数据"这个场景里,它把两个不同的问题混在了一起。localStorage 是数据到达浏览器之后 的落脚点,不是数据的源头。用户信息、凭据、文件内容、外部 API 返回------这些需要宿主能力才能拿到的东西,Client 半从一开始就碰不到。

dsh-work-chat 的架构直接印证了这一点:Host 半负责凭据、网页端接口、SSE 流式发送和本地持久化,Client 半只通过同源 /workchat/* 路由访问宿主,不直接出网。Client 连外部数据都碰不到,只能问 Host 要。

所以更准确的说法是:Client 可以缓存 Host 给过它的数据,但不能替代 Host 成为数据的源头。

二、用一个具体例子走完整条链路:用户信息从登录到展示

假设你有一个登录插件负责认证,另一个展示插件负责在界面上显示"当前用户是谁"。这条链怎么走?

第一步:登录插件的 Host 半拿到凭据并验证。

用户提交用户名和密码,Client 把凭据发给登录插件的 Host 半。Host 校验通过后,生成或读取用户信息。这个信息存在 Host 侧------可能在本地文件、数据库,或者内存会话里。dsh-model-usage 的凭据处理方式是一个直接参考:凭据仅在 Host 解析和使用,ZCode 会话沿用本机加密凭据文件。浏览器从头到尾不知道密钥长什么样。

第二步:展示插件的 Host 半拿到用户信息。

登录插件和展示插件的 Host 半跑在同一个 Node 运行时里。DSH 基于 Cordis 插件系统,插件之间通过服务机制协作。登录插件的 Host 半可以把"当前用户"注册成一个服务,展示插件的 Host 半通过 ctx.get 拿到它。不需要 Client 端"互相找",共享发生在 Host 进程内部。

第三步:展示插件的 Host 半把数据下发给自己的 Client 半。

这里有两种主流方式。

第一种是 Typert Remote 。Host 半的类继承 TypertRemoteService,给方法标上 @Remote,Client 半通过 ctx.remote.<namespace>.<method>() 调用。dsh-greeting 是官方风格的参考实现:send/list 走严格模式,双向 zod 校验加完整类型,契约由 pnpm typert:gen 生成。数据从 Host 到 Client 的过程是类型安全的。

第二种是 HTTP 路由 。Host 注册路由,Client 发请求拿数据。dsh-provider-usage 走的就是这条路:Client 每 60 秒打一次 GET /stats,适配器代码和密钥只活在宿主进程内,密钥不进浏览器。dsh-model-usage 同样使用带认证的 /model-usage 前缀路由。

第四步:Client 半渲染界面。

展示插件的 Client 半拿到用户信息(比如用户名、角色、头像 URL),画出来。它不关心数据是登录插件从文件读的还是从数据库查的,它只负责展示。

整条链里,Client 没有"自己去找数据"的动作。它发起调用,Host 返回结果。

三、Host 端的数据到底从哪来?

没有统一规定。插件 Host 半的代码里怎么写,数据就怎么来。几个真实插件的做法:

从外部 API 拉。 dsh-provider-usage 的适配器在 Node 侧请求各家模型的用量接口(DeepSeek、Kimi、OpenRouter 等),密钥留在宿主进程,HTML 在下发前经净化兜底。dsh-model-usage 同样在 Host 侧并行取数、做 TTL 缓存和单飞控制。

从本地凭据服务读。 dsh-doubao-work-connect 的 Host 半注册路由,返回当前登录状态和额度信息,状态值包括 signed-in、signed-out、cached 等,Client 通过 GET /plugins/.../status 拿到。凭据的读取和缓存逻辑全在宿主侧。

执行宿主能力。 dsh-greeting 的 exec 方法在宿主内经 ctx.shell 执行命令,返回结构化结果(exitCode、stdout 等),输出只回调用方 UI,不进会话日志。Client 能触发,但执行发生在 Host。

四、通信方式不止一种,但选型有优先级

方式 适用场景 实例
Typert Remote 结构化数据、类型安全的跨端调用 dsh-greeting 的 send/list
HTTP 路由 轮询、状态接口、文件/HTML 下发 dsh-provider-usage 的 /stats
WebSocket 实时推送、长连接 特定配对或流式场景

Typert Remote 是官方主推的强类型 RPC 通道,但 HTTP 路由在实际插件里同样常见。选哪个取决于插件设计,不是硬性规定。dsh-work-chat 的 Host 半还用了 SSE 做流式发送,说明通信形态可以按需组合。

五、总结

回到你最初的问题:

  • 数据从哪来? Host 半决定。可以调 API、读文件、查数据库、跑命令,或者从其他插件通过 Cordis 服务拿。
  • Client 怎么展示? 发起对 Host 的调用,拿到结果,渲染。
  • Host 和 Client 怎么通信? Typert Remote 是主通道,HTTP 路由是常见替代,WebSocket 在特定场景使用。
  • localStorage 呢? 它是数据到达浏览器后的缓存落脚点,不是源头。在这个讨论里可以删掉。

如果你正在写 DSH 插件,记住一个判断标准就够了:这件事需要凭据、文件系统、外部网络、或者宿主进程的状态吗?如果需要,数据源头在 Host;Client 只负责说"我要什么"和"画出来"。

相关推荐
feixing_fx16 分钟前
CSS 变量(Custom Properties):构建可扩展的主题切换系统
前端·css·前端框架·html·css3
十有八七1 小时前
手搓 Agent(一):先有大脑——大模型只会做一件事
前端·人工智能·后端
锋行天下1 小时前
「踩坑实录」给 LangGraph Agent 接两个 FastMCP,我被 langchain 偷偷改了工具名
前端·人工智能·后端
跳跳的小星星2 小时前
自研组件】Vue2 + ElementUI 通用列表页封装 wkjp-list-page,一套配置搞定搜索、动态表格、分页、增删改
前端
tryCbest2 小时前
Vue3—— 第 18 篇:Vue 2 到 Vue 3 迁移指南——升级避坑全记录
前端·vue.js
保利威视频SaaS小张2 小时前
企业直播接入笔记 12|企业内训直播怎么做签到和学时统计,防挂机这件事比想象中难
java·前端·数据库·笔记·视频云·polvy·polyv
bysking3 小时前
GitHub Actions 快速入门+场景实践案例
前端·后端·github
广州华水科技3 小时前
单北斗GNSS变形监测系统在大坝安全维护中的重要性
前端
anyup3 小时前
自带 uni-app x 页面级能力,uView Pro X 8 个开箱即用的工具函数
前端·vue.js·uni-app