在此页面上

9月27日, v2-demo 集成将其 DeepSeek Harness 包装器移入一个由网络主机和开发桌面共同提供的单一资产路径。一个实现为两个界面提供 CSS、JavaScript、图像和字体。

实际目标是在不拥有接口周围所有事物的情况下实现一致性。一个样式和行为来源应该足够;底层主机应继续拥有身份验证、原生权限、模型控制和计算机使用工具。

记录的变更

提交 d46b8766f3 于 9 月 27 日添加了 DSH UI 包装器和设计源材料。提交 04443359cf 将 Zortex 包装器资产移至 Web 和桌面共享路径。提交 17c16da9a1 随后限制了 DSH 令牌的使用,并改变了图形界面工具的发现方式。

重要的UI更改是这些提交中的第二个。共享文件位于演示存储库的lab/wrapper/public/下。其README指定两个界面都使用相同的CSS、JavaScript、图像和字体,并禁用缓存,以便重新加载可以反映编辑。没有第二个桌面主题可以独立更新。

相关的安装程序创建一个无依赖的主机插件,并在每个选定的 DSH 主目录中注册一个托管条目。桌面使用 DSH 支持的 Web 服务器/索引注入钩子和经过身份验证的 dsh-app 传输来加载包装器。原始 DSH 源代码树未打补丁以实现视觉更改。

安装边界

由此产生的流程有意地狭窄:

One wrapper source directory
             |
             v
Managed DSH host injection
             |
        +----+----+
        |         |
        v         v
     DSH web   DSH desktop
        |         |
        +----+----+
             |
             v
Native host features stay with DSH

产品共享包装器的产品图

图表:一个包装器资产路径,原生主机控件保持独立。

共享演示代码是减少偏差的一种手段,而不是平台行为完全相同的证明。Web 和桌面在窗口边框、操作系统文件选择器、权限、传输和原生集成方面仍然存在差异。包装器明确将这些内容置于主机控制之下。

可逆边界同样重要。文档化的安装程序在添加自己的托管块的同时备份并保留现有配置。仅删除该块并重新启动会禁用集成。独立代理仍然可用作运行包装器的另一种方式。Alt+Z 在本地切换包装演示,而无需永久替换原始主机。

这比将主题复制到每个主机并假设它们将保持同步是一种更好的开发形式。

为什么我们保留了原生控件

包装器的CSS特意使用了DSH自己的设计令牌来表示表面、标签和排版。它改变了一小部分身份和导航元素,例如页面提示、能力标签和紧凑的模型选择呈现。原始控件仍然可用。

共享集成不能使模型选择器成为摆设。它必须保留推理设置、导航、历史记录、键盘交互、批准和实时更新。浏览器级别的包装器也不能发明原生主机未授予的操作系统权限。

这些是设计约束,而不仅仅是视觉偏好。当AI工具可以对用户的文件或应用程序进行操作时,保持批准和活动界面可识别比为了更清晰的截图而隐藏它们更重要。一个失去关键主机反馈的一致包装器将是一种倒退,即使两个平台看起来更相似。

示例连接器和实时账户状态

server/data.ts 中的 Abilities 目录列出了所有连接器,并且已认证的账户状态作为其自身的状态源进行跟踪。

连接器磁贴需要区分已认证、已索引、已过时、演示和计划中的源状态。提供商的可靠性通过连接器验收测试建立,而不是通过绘制计数。

这就是为什么本说明说“共享包装器”而不是“您的所有应用程序现在都通过桌面连接”。前者得到了实现布局的支持。后者需要实时源证据和不同的测试。

操作说明

文档中记载的设置是本地链接安装。工程师向安装程序提供实际的Web和桌面DSH主目录,并重新启动每个主机一次。然后他们使用wrap:test命令进行存储库的包装器测试。旧的代理路径在单独的本地端口上为包装器提供服务,并且仍然是一个可逆的选项。

README 还记录了一个具体的注意事项:移动或删除存储库会破坏链接的资产路径。将包装器分发到另一台机器需要插件、其资产和注册的本地路径。打包、升级和支持的主机安装与共享源是分开的。

独立的代理实现还关注不太明显的行为:转发HTTP和WebSocket流量,考虑长期请求,以及在浏览器离开时规范关闭代码。这些细节影响用户是否看到响应式更新,而不仅仅是页面是否看起来正确。此处描述的行为遵循代理实现及其文档化的测试契约。

测试主机边界

包装器的 wrap:test 命令检查其自身的实现契约。主机级测试还包括登录、原生文件选择器、审批控制、键盘导航、版本差异和安装回滚。这些是主机行为,而不是共享CSS文件的属性。

安装程序和包装器代码在不修补主机源代码树的情况下仍然可检查和可逆。

这次变革的教训是架构上的:为共享行为保留一个来源,同时将平台责任留给其合法所有者。一个包装器减少了两个DSH表面之间的差异,同时保留了人们已经依赖的控制。

来源依据: ZortexHQ/v2-demo 历史记录,日期为 9 月 27 日;lab/wrapper/README.md、lab/wrapper/server.ts、lab/wrapper/shared.ts、lab/wrapper/host-plugin.ts 和 lab/wrapper/public/wrapper.css。