面向自建团队、受管团队与企业组织的 DSH Web 协作平台。
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、校验方式与升级流程记录在实现记录,本表只作概览。