团队记忆知识库 ccch713/deepddw

deepDDW — 让 DeepSeek Harness 具备记忆与知识库，局域网内任意设备可用

🌐 English · 简体中文这是中文说明。英文版见 README.md。

deepDDW 给 DeepSeek Harness（DSH）补齐三块拼图：记忆、知识库、文档搜索——而且全部支持局域网内任意设备访问。不用装 App，不改 DSH 一行源码。

- 🧠 记忆体 — 跨会话长期记忆，读写走 DSH 官方标准 MCP 接口
- 📚 知识库 — 文档入库与检索（行业资料、SOP、研究笔记）随时可查
- 🎒 AI 资产一键打包带走 — 记忆体 + 知识库一键打包为 ddw_assets_v1.zip（可导入 DDW AI Hub 或另一台 deepDDW）。你的数据你做主，不锁定
- 🌐 局域网多设备 — 部署一次，手机/平板/笔记本同网可用，共用同一个 DSH 工作台

60 秒上手：

npm i -g @deepseek-ai/dsh # 1. 服务器安装官方 DSH
git clone https://github.com/ccch713/deepddw.git && cd deepddw
./install.sh --with-dsh # 2. 安装 deepDDW ./install.sh --port 8600 # 3. 启动
4. 局域网任意设备打开 http://<服务器IP>:8600/（手机扫码自动配对）

📸 截图位：手机/平板访问工作台实拍（稍后补充）。

当前状态：v0.8.1 · MIT · CI（pytest + ruff）✅ · DSH for Teams —— 多用户、局域网多设备、记忆与知识库团队蒸馏 · 迁移导入导出 / 作用域提升 / 无痕会话 / 检索健康 · 组织连接服务端（bindcode-v1，可选） · 虚拟办公室（view-only 活动可视化） · AI 资产导出/导入（ddw_assets_v1，反锁定） · 入选 awesome-deepseek-harness · 路线图见文末

⚠️ 重要 —— 安装前必读

deepDDW 实现了独立的记忆体与知识库隔离机制。为避免冲突或记忆混乱，安装前请务必：

1. 备份你现有的记忆体与知识库内容（无论它们在 DSH 环境中的哪个位置）；
2. 卸载/停用你已安装的其他任何记忆体或知识库插件；
3. 然后再安装 deepDDW，让它接管记忆体与知识库。

如果 deepDDW 与其他记忆/知识库插件同时运行，可能导致数据冲突或命名空间之间的记忆混淆。特此警告。⚠️

为什么用 deepDDW？

大多数 DSH 扩展只提供记忆。deepDDW 是完整的工作台——记忆 + 知识库 + 文档检索 + 局域网多设备访问：

| 官方 DSH 的限制 | deepDDW 的解法 |
| 🔒 仅本机可用 | ✅ 局域网内任意设备访问：服务器部署后，电脑、笔记本、手机、平板，同一个网络内的智能设备全部可用 |
| 🧠 无记忆体 | ✅ 长期记忆写入/检索，对话经验可沉淀 |
| 📚 无知识库 | ✅ 知识库检索/入库，行业文档、SOP、研究笔记随时调用 |

一句话：把"个人玩具"变成"小组织能用的工具"——整体封装、简便部署、降低运维成本，让小型商业组织部署即可使用，基本可以支撑 20 人以下企业的日常 AI 工作流。

deepDDW 沉淀自真实的企业级部署实践——以开源（MIT）形式封装进 DSH 生态。

适用场景自查：哪一种是你的？

deepDDW 面向个人、家庭、部门与小微企业——大约 20 人、20 台设备、一个局域网以内。对号入座即可：

| 场景 | 典型形态 | 你能得到什么 |
| 🧑💻 个人 · 多设备 | 一个人；笔记本 + 手机 + 平板 | 在任意常开的自有机器（NAS / 迷你主机 / 旧电脑）部署一次，你的所有设备共用同一份记忆与知识库，数据不出自己的硬件；不想运维可用 Pro Cloud 托管（多设备同步代管 + 每日自动备份）。 |
| 👨👩👧 家庭 · 多人多设备 | 一个家庭；一台服务器，多名成员 | "部署一台，全家可用。"每位成员独立账号、记忆命名空间相互隔离；家庭蒸馏把大家近期的记忆要点去重合并进家庭共享空间（规则去重，没有 LLM Key 也能用）。 |
| 🏢 部门级 | 大组织里的一个部门（≤20 人） | 把 deepDDW 当部门工作台。可选开启 bindcode-v1 组织后端：员工 App 扫码绑定，服务器成为助手系列 App 的组织后端——成员保留个人模式（自己的模型、本机记忆体），随时可切回，解绑不删除任何个人数据。 |
| 🏪 小微企业 | 20 人以内公司，跑日常 AI 工作流 | 团队模式：多用户、团队蒸馏（LLM 提炼去重的团队共享记忆）、作用域提升、无痕会话、检索健康——开源版全含。在此之上需要 SSO / 审计日志 / 私有部署支持，见 Enterprise 档（商业化与支持）。 |

经验法则：一个网络内 ≤20 人的团队对应一个实例——你的场景如果能装进一个房间、一层楼或一条 VPN，deepDDW 就适合你。

它怎么工作？（技术线路）

📱 手机 / 💻 电脑 / 📱 平板 / 🖥️ 笔记本 —— 局域网内任意设备 │ （浏览器访问，无需安装 App） ▼ deepDDW 网关（局域网内一台服务器） ├─ /dsh/* 反代 → DSH 引擎（官方原版界面，模型配置/对话全原版） ├─ /api/* 反代 → DSH 的 RPC/API └─ /api/v1/* deepDDW 能力：知识库 / 记忆体 / 文档 / LLM 配置 │ │ DSH 官方 MCP 客户端（streamable-http） ▼ deepDDW MCP 工具（模型自动调用） ├─ mcp__deepddw__ddw_kb_search 知识库检索 ├─ mcp__deepddw__ddw_memory_put 写入记忆 ├─ mcp__deepddw__ddw_memory_search 检索记忆 └─ mcp__deepddw__ddw_docs_portal_search 文档检索

接入方式 = DSH 标准 MCP：DSH 原生支持 MCP 客户端，deepDDW 暴露标准 streamable-http 端点——零侵入、不改 DSH 一行源码，界面、设置、模型配置全部保持官方原版。

虚拟办公室（0.8.0）

打开 /ui/office.html，亲眼看到 deepDDW 在上班：每个子系统都是一位像素小人——门卫大白迎设备进门、接待小深接消息、记忆管家归档笔记、藏书员上架文档、计量员给 LLM 调用记账。动画全部由真实活动驱动（30 分钟无事件自动回 idle，拒绝"永远在打字"的假在岗），失败会弹横幅，今日战报按重要性加权。
渲染 100% 程序化绘制——零第三方美术资产、零运行时依赖。天生 view-only： API 只透出岗位名与白名单统计短语，文档内容 / 记忆 value / 对话原文一概不出端点。

为什么你在局域网内能用？

DSH 官方出于安全考虑只监听本机（localhost），手机/平板根本连不上。deepDDW 通过网关反代解决了这个矛盾：

- DSH 保持安全的本机绑定（官方安全设计不被破坏）
- deepDDW 网关统一对外，局域网内任意设备访问 http://<服务器IP>:8600/ 即进入 DSH 原版工作台
- 数据全部存储在你自己的服务器上，不出内网

部署一台，全家/全团队可用——这是官方 DSH 给不了的能力。

快速开始

1. 在服务器上安装 DSH（官方）
npm i -g @deepseek-ai/dsh

2. 安装 deepDDW（整体封装，一条命令）
git clone https://github.com/ccch713/deepddw.git
cd deepddw && ./install.sh --with-dsh

3. 启动 ./install.sh --port 8600

4. 局域网内任意设备打开： http://<服务器IP>:8600/ → DSH 原版工作台手机/平板可"添加到主屏幕"获得 App 体验

5. 在 DSH「设置 → 模型」填 API Key
6. 对话里让模型"搜索知识库"或"记住 xxx" → 自动调用 mcp__deepddw__* 工具

部署门槛：一台普通电脑/服务器（最低 8GB 内存，推荐 16GB 及以上），Python 3.11+，无 GPU 要求（LLM 走云端 API 或本机 Ollama）。

局域网多设备联机（0.2.0）

deepDDW 面向局域网内最多 20 台设备共享一个网关的场景：

- 设备身份：每台浏览器在 localStorage 持久化 device_id，启动页可设置设备名称；重连后身份不变（刷新/重启仍是同一台设备）。
- 在线状态：设备向网关注册/心跳；/api/v1/status（Token 保护）返回谁在线、活跃 WebSocket 数、请求计数、数据库大小与版本；启动页为管理员渲染实时状态卡片。
- 网关限流：滑动窗口，按 Token + 按 IP 双维度（默认 60 req/min/token，全网关总容量耗尽 → 503 过载保护）；可通过 config/deployment.yaml 的 security.rate_limit. 或 DDW_RATE_LIMIT_ 环境变量覆盖。
- SQLite 并发加固：所有连接统一 WAL + busy_timeout=5000 + synchronous=NORMAL，跨表写事务走进程级写锁（已用 20 并发写验证，无 database is locked）。

POST /api/v1/device/register # 注册/改名本设备（幂等） POST /api/v1/device/heartbeat # 心跳保活 GET /api/v1/status # 状态面板（需 Token）

0.2.0 还包含：

- 工作区隔离 — 设备可选工作区（默认 shared）；记忆/日志与 MCP 记忆工具按工作区隔离，文档按 slug 前缀过滤；旧客户端零影响。
- 会话跨设备续接 — 最近会话摘要（最多 5 条）+ "继续此会话"按钮：手机接着电脑端会话继续聊。
- 一键备份 / 恢复 — API 一键备份可下载；恢复前校验 SQLite 文件（文件头 + 完整性检查），替换主库前自动备份现状为 .pre-restore。
- 可选 TLS — 一键自签证书（scripts/gen_self_signed_cert.sh，1 年有效），security.tls. 启用即可 HTTPS 访问；默认关闭不影响 HTTP。外网访问推荐 Caddy/Nginx 反代（见 docs/tls.md）。
- 版本 / 升级检查 — /api/v1/version 返回最新版与升级标记（GitHub 探测，1h 缓存，离线降级）；启动页显示升级横幅。

安全与隐私

| 能力 | 说明 |
| 🔐 数据全本地 | 知识库/记忆存自己的服务器，不出内网 |
| 🏠 局域网免密 | 可选项，默认关闭：内网请求免 Token（开启需 DDW_LAN_BYPASS=1，仅建议可信内网）|
| 🌐 外网访问 | 可配 Token 门禁（支持短码），未授权一律 401 |
| 🛡️ DSH 安全绑定 | DSH 只监听本机，网关统一对外，不破坏官方安全设计 |

技术栈与许可

| 组件 | 说明 | 许可 |
| DSH 引擎 | DeepSeek Harness 官方原版（不改源码） | MIT |
| deepDDW 网关 | FastAPI + SQLite + MCP 双协议 | MIT |
| 记忆/知识库 | SQLite 存储（可接 agentmemory / 向量） | MIT |
| 搜索 | 可选 SearXNG | AGPL-3.0（服务端调用豁免）|

deepDDW 本体：MIT License — 自由使用、修改、商用，保留版权声明即可。

生态与反馈

- 官方插件扩展：deepDDW 保留 DSH 原生插件机制。您可通过 DSH 官方命令从 npm 官方仓库安装官方插件——这也是我们推荐的唯一渠道，以最大程度避免供应链投毒：
dsh plugin --profile web add <npm包名> # 仅官方 npm 仓库

第三方插件的安全责任由用户自行查验；deepDDW 仅保障记忆体与知识库的代码完整与安全，不窃取/不利用/不贩卖用户数据。详见 SECURITY.md。
- 知识蒸馏：我们建议您使用适合自己的知识蒸馏 skill / 工作流来沉淀知识——蒸馏方法论由您选择，deepDDW 提供"蒸馏产物 → 可检索知识库 → 模型可用"的完整管道；更多插件与工具正在扩展中
- 记忆/知识移植：知识库为标准 SQLite 结构，记忆按 namespace/key/value 组织——可从其他 Agent 或工具导出移植
- 反馈：非常欢迎您留下宝贵的使用反馈，我们将在后续版本中提供更强大的开源工具

作为 DDW AI 助手的企业后端

deepDDW 内置一个默认关闭的可选插件，让单个实例通过开放协议 bindcode-v1 成为 DDW AI 助手系列 App 的组织后端。管理员签发一枚短时效绑定码，员工在 App 里粘贴/扫码（设置 → 高级 → 连接企业服务器）完成绑定，之后这些成员的助手就跑在你自己的基础设施上。

开启前值得知道的三件事：

- LLM 供应商由部署者自配。 绑定成员的对话走本实例的 llm_gateway——你配置了什么供应商（DeepSeek、Ollama 或任意自建 OpenAI 兼容网关），成员就用什么。插件不指向任何托管服务，没有任何预置渠道。
- 绑定是身份关系，不是锁定。 成员随时可切回个人模式（自己的模型、本机记忆体），切换/解绑不改变设备上的任何个人数据（协议 §4）。服务端不持有员工个人数据，解绑不删除任何内容。
- 影响面很小。 成员级 access_token 只能调用插件的对话端点，碰不到管理 API。绑定码经 HMAC 签名、短时效、限用次、可吊销；公网端点按产品令牌限速（10 req/min）。

快速开始：

1) 在 config/deployment.yaml 开启（org_relay.enabled: true + product_tokens），然后：
curl -X POST :8500/api/v1/plugins/ddw-org-relay/admin/orgs -H "Authorization: Bearer $DDW_ACCESS_TOKEN" -H 'Content-Type: application/json' -d '{"name":"某某诊所"}'
curl -X POST :8500/api/v1/plugins/ddw-org-relay/admin/orgs/<org_id>/bindcode -H "Authorization: Bearer $DDW_ACCESS_TOKEN" -H 'Content-Type: application/json' -d '{"ttl_min":15,"max_uses":50}'
2) 员工 App：设置 → 高级 → 连接企业服务器 → 粘贴绑定码

完整端点、配置项与安全说明：plugins/ddw_org_relay/README.md。

Commercial · 商业化与支持

deepDDW 的承诺很简单：开源版永久免费、永久全功能。 我们只收两样东西的钱——"帮你省事"（托管与免运维）和"企业协作"（权限、审计与合规）。核心能力没有任何功能门控，不存在"Pro 才解锁"的暗门。

| 档位 | 价格 | 适合谁 | 你得到什么 |
| Open Source | 永久免费 | 个人开发者、自部署玩家 | MIT 协议，全功能开放，无功能门控 |
| Pro Cloud | ¥19/月 或 ¥199/年 | 不想自己运维的人 | 云端托管记忆 + 知识库、免运维、多设备同步代管、每日备份 |
| Founder License（终身） | ¥499 一次性 | 早期支持者 | 终身 Pro 权益。限前 100 名，售完即止，不再复售 |
| Enterprise | ¥9,800/年起 | 团队与企业 | 多用户与权限、SSO、审计日志、私有部署支持（远程）、商业授权书、24h 优先响应 |

- Enterprise 如需到场部署实施：¥3,000/次。
- 对公付款可提供增值税发票。
- 咨询与购买：GitHub Issues。

Pro Cloud：把运维交出来

你在自部署版里用到的全部能力，跑在云端：记忆与知识库托管、多设备同步代管、每日自动备份。¥19/月，或年付 ¥199（折合每月约 ¥16.6）。适合"想要 deepDDW 的完整体验，但不想管服务器"的人。

Founder License：一次买断，仅 100 席

¥499 一次买断，终身 Pro。这是留给早期支持者的永久席位——100 席，售完即止，售完不再复售。名额满后此档位永久下架，不会有第二波。

Enterprise：给团队与企业

多用户与权限管理、SSO 单点登录、审计日志、私有部署支持（远程）、商业授权书（法务与采购流程里必须存在的那张纸）、24h 优先响应。如需工程师到场部署实施，¥3,000/次。

Sponsor：请作者喝杯咖啡

暂时不需要任何付费档位？完全没关系——deepDDW 永远免费。给仓库点一个 Star，就是最实在的支持。

Roadmap

只列出已交付或真实在计划内的事项。

已交付：
- [x] 局域网多设备联机（0.2.0） — 设备身份/在线注册表、状态面板、网关限流、SQLite WAL 并发（最多 20 台设备）
- [x] 工作区隔离（P1-1） — 网关层按工作区隔离记忆/知识库（默认 shared，向后兼容）
- [x] 会话跨设备续接（P1-3） — "最近会话"摘要（最多 5 条）+ 继续按钮
- [x] 可选 TLS（P1-2） — 一键自签证书；外网访问 Caddy/Nginx 反代（见 docs/tls.md）
- [x] 备份 / 恢复 API（P2-1） — 一键备份可下载；恢复先校验，替换前自动备份现状 .pre-restore
- [x] 压测报告（P2-2） — 5/10/20 设备：0 错误，P95 ≤ 126ms，无 database is locked（见 docs/load-report.md）
- [x] 版本 / 升级检查（P2-3） — /api/v1/version 探测最新 Release（1h 缓存）；启动页升级横幅
- [x] Docker 一键部署 — docker compose -f deepddw-compose.yml up -d --build（已在真实 macOS arm64 主机验证：core + SearXNG 容器启动、health/MCP/chat 端到端全绿）
- [x] 会话 → 文档沉淀 — 对话经 ddw.docs.save / ddw.session.docs MCP 工具 + REST API 保存到知识库，按会话可检索可追溯
- [x] 知识库向量检索增强 — 混合检索（SQLite FTS5/LIKE + LanceDB，RRF 融合；可选，无 LanceDB 时自动降级纯关键词）
- [x] Windows 打包 — windows-build CI 工作流 PyInstaller one-dir 自动出包，以 Actions 产物分发，v0.1.0 发布已验证（见 docs/windows-packaging.md）
- [x] 反思与沉淀（LLM 化收尾） — 每日反思按风格指南（自动/专业/随意）生成、强制"进展/问题/明日注意"结构并避免与昨日重复；LLM 判定对话无价值时不再落日志
- [x] 组织连接 bindcode-v1 服务端（可选插件） — 作为 DDW AI 助手系列 App 的企业后端：HMAC 签名短时效绑定码、公网 bind/unbind/me 端点（产品令牌+限速）、成员级令牌直连 OpenAI 兼容对话端点（LLM 供给走部署者自配供应商，见 plugins/ddw_org_relay/）
- [x] 记忆检索质量 — 结果按相关性评分排序（命中数×层权重：用户规则优先于旧日志，近期日志加权），取代原插入序；扩写缓存过期行为已测试
- [x] AI 资产导出/导入 ddw_assets_v1（0.8.1） — "带走我的 AI 资产"：知识库 + 五层记忆一键打包为可迁移 zip（与 DDW AI Hub 同构中立格式）；支持导回本产品或降级带入 Hub 包（skills/flows 段格式保留、导入时忽略）——反锁定的产品化承诺

deepDDW — 企业级底座能力，开源给每个人。*