团队协作套件 xyingsoft/dsh-chat

dsh-chat

面向自建团队、受管团队与企业组织的 DSH Web 协作平台。

English · 设计 Wiki · 参与贡献

License: MIT

这是什么

dsh-chat 是一组 DeepSeek Harness（DSH）插件，在 DSH Web 上提供组织化的团队协作：身份与设备、组织与权限、文本私聊、工作项与评审、通知收件箱与审计。

它遵循 DSH 的「一切皆插件」模型 —— 没有特权聊天内核。除纯类型包 @dsh-chat/contract 外，所有能力都是可独立装载、可独立卸载的 Cordis 插件。

当前状态

尚未发布。 P0-a 的骨架步骤与验收清单已全部覆盖，插件已在 DSH Desktop v2.0.4 上装载并渲染（截图）。

| 阶段 | 范围 | 状态 |
| P0-a | 写入协议、投递语义、审计同事务三项架构承诺 | §43 骨架步骤与 §44.1.2 验收清单已全部覆盖 |
| P0-b | 第二因素、恢复、在线可见范围、本地搜索、协议协商的完整验收 | 未开始（协议协商的编解码已实现） |
| P1–P4 | 群聊与资源、协作会话与 Bot、治理与分析、企业与 E2EE | 未开始 |

逐阶段进度、已完成项与未完成项见 TODO.md。 阶段划分与验收条件见迭代计划。

当前可用的能力

以下命令经真实 HTTP 走通，共 506 个测试：

- 私聊 —— 发送、按设备租约拉取、确认投递、编辑、撤回
- 组织 —— 创建组织/工作区/项目、邀请成员、接受邀请
- 工作项 —— 创建、分派并发通知、添加依赖（含成环检测）、评审关口
- 通知 —— 收件箱游标补拉、5 分钟窗口聚合、SSE 事件流

所有写端点都有跨源防护、认证注入与审计同事务。身份侧另有设备注册与 Ed25519 请求签名（nonce 去重、时间偏移容忍窗口）。

集成验收起的是三个真实 OS 进程：一个 relay 加两个各有本地库的 host。

已知未完成项

| 项 | 影响 |
| 会话列表的数据源 | 组件与呈现规则已就绪并测过，但 host 缺按会话聚合的查询端点 |

第二因素、恢复、在线状态、群聊、附件属后续关口，其入口按文档要求显式缺失，不伪装为可用。

文档

本仓库的 docs/README.md 是实现、评审与验收的唯一依据（面向 AI 迭代的单文件设计文档，框架清晰、不冗余）。

单文件总纲覆盖：产品边界（八条声明）、三层架构、插件化模型、写入协议、关键机制、部署分层、工程结构、迭代路线图（P0–P4）与 AI 迭代工作流。

详细规格（完整字段、错误码、验收细节）归档在 docs/archive/：

| 归档 | 内容 |
| 01-requirements/ | 产品定位与边界、协作能力需求 |
| 02-architecture/ | 三层架构、插件化模型、服务端与部署分层 |
| 03-details/ | 身份权限、投递持久化、性能限流、安全合规、可观测性、契约附录 |
| 04-roadmap/ | 操作状态矩阵、最小骨架、迭代计划、测试策略 |
| _meta/ | 文档维护规范、实现记录、功能清单、DSH 装载验证 |

本项目强制「文档先行」：任何涉及需求变更或架构调整的修改，必须先更新文档再写代码。详见文档维护规范。

根目录的 DESIGN.md 是重构前的单文件原稿，仅作历史归档，不再作为实现依据。

技术栈

| 插件框架 | @deepseek-ai/cordis 4.0.1 |
| DSH 运行时 | 0.1.2-alpha.1，对应 DSH Desktop v2.0.4 |
| 语言 | TypeScript，ESM-only |
| Node | ^22.19.0 \|\| >=24.0.0 |
| 客户端 | React 18 + CSS Modules |
| 配置校验 | @deepseek-ai/schemastery |
| 持久化 | P0 SQLite（L1），P1 起 PostgreSQL + Redis + 对象存储（L2） |

DSH 运行时不从 npm 安装 —— 上游自 0.1.2-alpha.1 起改为 vendored tarball 分发，npm 上的 latest 标签指向一个远早于当前的版本。
精确版本、来源 commit、校验方式与升级流程记录在实现记录，本表只作概览。

许可

MIT