Skip to content
Ci-TuPublic

About

DeepForge: 一站式管理多台 DeepSeek Harness (DSH) 的响应式 Web 控制台 — Docker 部署,多实例接入、快速切换、Telegram 通知

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

DeepForge

一站式管理多台 DeepSeek Harness(DSH)的响应式 Web 控制台。

Docker 单容器部署,接入任意数量的 DSH 实例(填网址 + 账号 + 密码),电脑全功能布局,手机窄屏自适应,任务完成/需人工介入时 Telegram 通知。

状态:规划中。本仓库目前只含需求、参考资料与任务书(prompt.md),实现在服务器侧 AI 完成。


为什么做这个

现有部署:三台云服务器各跑一套 dsh,每台都有「密码门 + 域名反代」(见 docs/03-dsh-gateway-architecture.md)。痛点:

  1. 三台三个网址三套凭据,手机浏览器收藏夹切换麻烦;
  2. 手机上开 dsh 完整 Web UI(三栏布局)体验差;
  3. agent 跑长任务必须盯着网页,没有推送;agent 提问/要权限时人不在电脑前就卡死。

参考插件 dsh-mobile-remote 证明了「轻量移动控制台 + 推送 + 审批桥」的价值,但它是单实例、桌面版 LAN 语义。DeepForge 把它泛化成多实例、Docker、响应式 Web。

需求(与所有者确认过的边界)

# 需求 说明
R1 保留电脑网页的账号密码登录 三台现有 3079 密码门不动,DeepForge 是增量不是替换
R2 响应式单页,不做原生 App 窄屏 UI 参考 dsh-mobile-remote 的交互(Activity 条、审批卡、无限上翻),宽屏与官方 dsh 一致的会话列表+对话流
R3 多实例接入:设置里填 网址+账号+密码 凭据只存 DeepForge 容器(加密持久化),不进 git/日志
R4 部署在 HostDzire(23.19.230.222) 与 dsh-lax 同机,注意端口和资源隔离
R5 快速切换 + 并行使用 见下「多实例策略」
R6 Telegram 通知:完成/需人工选择 任一实例的 agent 空闲、提问、要权限时推 TG,可从 TG 深链直达对应实例

多实例策略(R5,核心设计题)

  • 顶部实例切换器:一键切换当前操作的 DSH(快捷路径,键盘 Ctrl+1/2/3 可选)
  • 聚合首页:所有实例的运行中会话一屏展示(状态点:运行/空闲/待审批),点进即达
  • 待办聚合:所有实例的「需人工选择」(审批/问询)聚合成一个待办列表 + TG 推送;处理时必须显式选实例,不允许批量审批(安全边界:审批语义不可含糊)
  • 并行派发:向多个实例同时发任务允许(明确的目标选择 UI),但回复流按实例隔离,不合并渲染

四层架构(目标形态)

手机/电脑浏览器
      │ HTTPS
      ▼
┌─────────────────────────────────────────────────┐
│  DeepForge 容器(HostDzire, 23.19.230.222)      │
│  ┌───────────┐  ┌──────────────┐  ┌──────────┐  │
│  │ 前端 SPA   │  │ 后端 API      │  │ TG 通知器 │  │
│  │ 响应式     │──│ 多实例连接池   │──│ 完成审批  │  │
│  └───────────┘  └──────────────┘  └──────────┘  │
│       凭据加密存储(容器卷)                       │
└────────┬────────────────┬───────────────┬────────┘
         │                │               │
         ▼                ▼               ▼
   dsh-kr.citu.cc   dsh-sjc.citu.cc  dsh-lax.citu.cc
   (密码门:3079)     (密码门:3079)     (密码门:3079)
         │                │               │
         ▼                ▼               ▼
      dsh web          dsh web         dsh web
   127.0.0.1:3080   127.0.0.1:3080  127.0.0.1:3080

DeepForge 作为纯客户端(basic auth + dsh 会话 cookie)访问各实例的 HTTP 面,不要求在各 dsh 上装任何插件。实时流走各实例已有的 WebSocket /api/remote.mux。

仓库结构

DeepForge/
├── README.md                    ← 本文件
├── prompt.md                    ← 服务器侧 AI 的任务书(从这里开始)
├── docs/
│   ├── 01-requirements.md       ← 完整需求与交互设计
│   ├── 02-competitor-notes.md   ← dsh-mobile-remote 插件分析(可抄什么)
│   ├── 03-dsh-gateway-architecture.md ← 现有三台 3079 密码门架构(必须兼容的事实)
│   └── 04-pitfalls.md           ← 全部已知坑(dsh/1Panel/CF/反代/Windows)
├── reference/
│   └── vendor/
│       ├── dsh-mobile-remote/   ← 参考插件源码包 v3.1.5(含完整 docs/)
│       └── dsh-mobile-app/      ← 参考插件配套 Flutter App 源码 v3.1.5+22

凭据与安全

  • 本仓库不含任何真实凭据。三台实例的 IP、面板密钥、密码等只在各自服务器与所有者本地;文档中出现的一律是占位符。
  • DeepForge 自身的会话登录(R1)与实例凭据存储分开:用户登录 DeepForge 的凭据 ↔ DeepForge 代理各 dsh 的凭据,两层独立。
  • reference/vendor/ 中的 dsh-release.jks 为上游 dsh-mobile 项目的公开签名材料(随其源码包分发,用于 APK 构建签名一致性),非本项目凭据。

License

参考插件源码遵循其原 License(MIT,见 vendor 目录内)。本项目代码 License 待实现落地时确定。

About

DeepForge: 一站式管理多台 DeepSeek Harness (DSH) 的响应式 Web 控制台 — Docker 部署,多实例接入、快速切换、Telegram 通知

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors