DeepSeek Harness 官方系统运维与移动端直通手册 [IDAPC]

系统概述:DeepSeek Harness(@deepseek-ai/dsh v0.1.1-rc.2)是 DeepSeek 官方出品的 AI 多智能体编排与工作台系统,支持主 Agent、子智能体(Subagent Team)派发、多工作区管理与丰富的插件生态。 移动端直通:专供 CEO Jake 在 Samsung Tab / S23 Ultra / 任意手机与电脑 端免装 App / 免 Tailscale 直接通过永久公网 HTTPS 网址(https://dsh.hsdesign.biz/)一键直通,支持触屏缩放、会话树查看与多 Agent 协同流监视。 门户集成:已作为第 8 张核心卡片正式挂载至公司统一入口 App Portalhttps://hs-app-portal.pages.dev/https://portal.hsdesign.biz/)。


一、系统架构拓扑

[CEO 移动端 (Samsung Tab / S23 / iPhone / PC)]
               │  HTTPS / WSS (全球 CDN 边缘加速,免装客户端)
               ▼
[Cloudflare Edge / Named Tunnel `dshtunnel` (HTTP/2 4-Edge Redundancy)]
               │  固定专属域名: https://dsh.hsdesign.biz
               ▼
[Windows 宿主原生 cloudflared.exe] (直通 127.0.0.1:8080,零 WSL 网络翻译延迟)
               │  Local TCP Loopback
               ▼
[Debian WSL 1/2 Systemd 守护服务 `dsh-official.service`]
               │  Node.js v22.23.2 + @deepseek-ai/[email protected]
               │  监听端口: 127.0.0.1:8080
               │  信任域名: dsh.hsdesign.biz (解除 --trusted-host 跨域拦截)
               ▼
[DeepSeek 官方大模型矩阵与 Agent 体系]
  ├─ 默认大模型: deepseek-v4-flash-vision-exp (支持图文多模态) / deepseek-v4-flash
  ├─ 认证密钥: DEEPSEEK_API_KEY (sk-25cf0faa62a84c9ea1adb6f1f9af8841)
  └─ 多智能体体系: @deepseek-ai/dsh-tool-subagent (spawn / fork 并发任务分发)

二、关键端点与凭据配置

配置项详细参数 / 路径说明
永久专属域名https://dsh.hsdesign.biz/永久固定 Cloudflare HTTPS 网址,支持 PWA 安装
统一门户入口https://hs-app-portal.pages.dev/第 8 个 PUBLIC 核心卡片【DeepSeek Harness】
本地服务端口http://127.0.0.1:8080Debian WSL 内部监听端口
Systemd 服务/etc/systemd/system/dsh-official.service24/7 开机自启与毫秒级崩溃自愈
Cloudflare Tunnel6ab401d8-e585-4909-ad76-55c4793d5563 (dshtunnel)4 节点边缘冗余(KUL / SIN)
默认大模型deepseek-v4-flash-vision-exp极速响应,支持多模态视觉图像输入
备用大模型deepseek-v4-flash / deepseek-v4-pro官方大模型目录内嵌
用户工作区与配置/root/.dsh/包含 profiles/web/cordis.patch.yml 与存储

三、常用运维与管理命令

1. Linux (Debian WSL) 服务管理

  • 查看服务状态与运行日志
    systemctl status dsh-official.service --no-pager
    journalctl -u dsh-official.service -f
  • 重启服务
    systemctl restart dsh-official.service
  • 停止服务
    systemctl stop dsh-official.service

2. 自动化探活与健康检查

  • 执行 10 轮高频自动化探活测试
    python3 "/mnt/d/ida ceo/collaborative-browser/probe_dsh.py"
    (实测 10/10 探活全部通过,返回 HTTP 200 OK,平均延迟 ~200ms)

四、移动端(Tab / 手机)最佳操作体验

  1. 一键添加至主屏幕(PWA)
    • 在 Samsung Tab 或 S23 手机 Chrome/三星浏览器中打开 https://dsh.hsdesign.biz/
    • 点击地址栏右侧的 「Install」 或浏览器菜单的 「添加到主屏幕」,即可像原生 App 一样全屏沉浸式使用。
  2. 多 Agent 协同与工作区操作
    • 左侧侧边栏随时管理 Session 与 Workspaces;
    • 支持多智能体 @deepseek-ai/dsh-tool-subagent 任务后台并行派发与实时流式输出;
    • 适配移动端虚拟键盘呼出与自适应响应式布局。

五、AgentTeams 插件(2026-08-26 安装)[IDAPC]

  • 插件@nanmicoder/dsh-agent-teams v0.1.13(npm,队长制 + 持久化邮箱成员直达 + 依赖任务 DAG + 实时活动面板)
  • 安装dsh plugin --profile web add -w @nanmicoder/dsh-agent-teams(需 pnpm;corepack enable pnpm 已启用)
  • 配置stateDir: .agent-teams(团队状态在工作区 <workspace>/.agent-teams/
  • 验证dsh --profile web --dump-configagent-teams 行;页面 boot graph 含 agent-teams/client.js?rev=...
  • 查阅方式(Tab/手机)portal.hsdesign.biz →【DeepSeek Harness】卡(第 8 卡)→ dsh.hsdesign.biz → 打开创建团队的会话 → 活动面板(分段进度/成员树/任务 DAG/成员动作卡)
  • ⚠️ 缓存坑:插件重启后旧页面无面板——强刷(URL 加 ?v=<日期> 或清除缓存),首次加载的新设备无此问题
  • 使用:自然语言向主会话说「组团队…」或 /team <任务> 类指令;队长=主会话(验收+叫停权),成员=可持续唤醒子 Agent(直连邮箱,无需队长中转)