前言¶
DSH（DeepSeek Harness）生态遵循「一切皆插件」的理念，其中 dsh-chat 负责会议室协议，dsh-weave 负责跨机消息传输。在搭建跨机协作的「多 agent 会议室」时，上游 dsh-weave 版本 0.1.0-rc.14 存在四个底层缺陷，导致群聊不可用或功能受限。huahua-dsh-chatroom 插件旨在为这些缺陷提供适配修复、机制研究、排障报告及维护路线图，让开发者能够通过一条命令复现修复并持续演进。
这是什么¶
这是一个由 azure5100 维护的 DSH 插件，定位为 dsh-chat / dsh-weave 跨机群聊的适配修复与运维文档集。它通过提供四合一幂等补丁脚本、DSH 插件集成、可视化全景图以及完整的机制研究文档，解决了跨机会议室内联调与运维中的具体问题。
核心功能¶
该插件主要包含以下能力：
- 跨机群聊与文件传输：基于
dsh-chat和dsh-weave实现跨机群聊，并实现了跨机文件传输功能（R1 里程碑），支持附件引用协议与双向文件互传。 - dsh-weave 适配修复：针对
dsh-weave0.1.0-rc.14的四个缺陷提供修复方案：- Fix1：修复未注入
dshBridge服务时的异常抛出。 - Fix2：修复 UDP 端口随机漂移问题，固定绑定端口
64605。 - Fix3 & Fix4：修复历史消息拉取时的帧限制问题，将响应上限从 64KB/4KB 提升至 4MB。
- Fix1：修复未注入
- 四合一幂等补丁脚本：提供
patch-weave.ps1，支持一键应用所有修复，具备幂等性（重复执行自动跳过）和语法校验功能。 - DSH 插件集成：提供
dsh.bundle格式的插件包，支持自动守护补丁状态，并提供 Agent 工具与 Host RPC 接口。 - 机制研究与文档：包含机制研究文档、排障证据链（集成报告、复盘报告、专项报告）以及单文件可视化全景图。
安装与启用¶
使用前需确保已安装 DSH 及其依赖的三件套（dsh-chat, dsh-weave, dsh-bridge），且 Node.js 版本不低于 22.19.0。
安装插件¶
通过官方插件目录安装：
dsh plugin --profile web add github:azure5100/huahua-dsh-chatroom
启用与配置¶
安装完成后，插件会自动检查并应用 dsh-weave 的修复补丁。如果目标版本未打补丁，插件会自动备份并应用 Fix1–Fix4，随后提示重启 DSH Web Profile 以使配置生效。
典型用法¶
安装并重启后，可以使用以下工具与接口：
- 查询补丁状态
查看当前环境是否已应用 Fix1–Fix4。
chatroom_patch_status
- 手动应用补丁
如果环境发生变化（如手动升级了依赖），可手动触发补丁应用。
chatroom_patch_apply
- 访问 Host RPC
通过 HTTP 接口查询状态或补丁信息。
curl http://localhost:端口号/dsh-chatroom status
curl http://localhost:端口号/dsh-chatroom patch
适用场景与注意¶
- 适用场景：需要进行跨机 DSH 群聊的开发者、运维人员，以及需要排查和修复
dsh-weave跨机传输问题的团队。 - 版本兼容性：插件依赖的目标
dsh-weave版本为0.1.0-rc.14。插件以 MIT 许可证发布。 - 依赖与冲突：
- 插件依赖
@deepseek-ai/cordis,@deepseek-ai/dsh-tools,@deepseek-ai/dsh-typert-protocol,@deepseek-ai/schemastery。 - 插件的 Loader 行 ID 为
dsh-chatroom-kit，需确保该 ID 在项目中唯一，避免与dsh-chat、dsh-weave、dsh-bridge冲突。
- 插件依赖
- 代码合规：插件提供了完整的上游核心代码快照（
upstream-patched/），并明确标注了 MIT 归属与修改说明，允许开发者查看全部代码。
总结¶
huahua-dsh-chatroom 是一套针对 DSH 跨机群聊环境的补丁与运维工具集。它解决了上游 dsh-weave 的关键缺陷，提供了从手动脚本到自动插件的一体化解决方案，并辅以详尽的机制研究与文档。对于希望在 DSH 生态中构建稳定跨机协作环境的开发者，这是一个可以直接落地的参考实现。
