DeepSeek Harness(开发者预览)是本机 Agent 运行时,见 deepseek.com/harness 与 deepseek-ai/deepseek-harness。团队常用 npx @deepseek-ai/dsh web 起 Web UI,默认 http://127.0.0.1:3080;远程访问优先 SSH 本地转发进回环,不要把可写 Agent 端口裸露到公网。会话可追溯(Trajectory:恢复、分叉、检索、回放),但不等于开箱即用的多人 SaaS。「读懂英文文档 / 报错」用有道查词或文本翻译;客户端安装走 /zh/download/。读文档与报错的单人流程见 Harness 文档与有道。
小团队卡点通常不是「会不会 npx」,而是:谁在哪台机器起实例、远程怎么进 UI、会话怎么交接、密钥与工作区别被误共享。下面按部署、远程、共用、有道、停手写可执行边界。
127.0.0.1。懂英文说明 → 有道。装翻译客户端 → 下载页。别把「清缓存重装有道」当成 Harness 部署步骤。
团队 Web 部署:本机先跑通,再谈共用
公开快速体验是装 Node 后执行 npx @deepseek-ai/dsh web;本机启动常会打开浏览器,地址多见 127.0.0.1:3080。源码路径则是克隆仓库后按 README 安装构建,再用仓库内的 dsh web 入口——以你检出的那版说明为准。开发者预览会改插件与 API,团队应钉版本(npm 包版本或 git commit),并在内部 wiki 写清「当前可复现的一组命令」,避免每人 npx 到不同预览构建。
工作目录很重要:从哪个目录启动,往往决定默认工作区根。约定「演示仓库」与「生产敏感目录」分开;不要把含密钥的家目录整棵挂进可写 Agent。模型密钥、凭据文件权限按仓库与本机安全习惯收紧——有道只帮你读英文警告文案,不替你保管 API Key。
Harness 公开页强调「一切皆插件」:模型、工具、技能、会话、沙箱、存储、调度、UI 都可组合;模式名(如 Standard / Code / Minimal / Creator)以当前页面为准。团队内统一「默认模式 + 允许的工具面」,比每人各调一套 Creator 试验更少踩坑。
远程同事怎么进 Web:SSH 转发,而不是公网 3080
官方 README 写明:本机启动会开浏览器;经 SSH 启动时通常只打印主机侧 URL,因为本地转发地址由 SSH 客户端或编辑器持有。需要无头跑服务时可用 --no-open(具体旗标以当前 CLI 帮助为准)。默认监听回环,意图是「本机控制面」,不是「局域网随便点」。
远程开发机上的稳妥模式:在服务器起 dsh web(常加 --no-open),同事本机建立到该机的本地端口转发,再在浏览器打开本机的 127.0.0.1:3080(或你转发的本地端口)。隧道通但页面拒绝连接,多半是远端进程没起来——先查远端是否在听 3080,再查隧道,不要先怪有道或浏览器扩展。
把 Web 绑到全网卡、或对公网裸开 3080,等于把「能读文件、能跑命令的 Agent 控制面」交给能扫到端口的人。社区已有关于「Web 侧缺少独立登录、多用户主机上 loopback 共享风险」的讨论;预览阶段以收紧暴露面为默认策略。需要 HTTPS / 反向代理时,先读当前仓库的 Web / 安全相关文档,再由基建同学评审——本文不给「一键公网开放」配方。
「共用」指什么:会话可追溯 ≠ 多人同写一个实例
公开产品叙事里,模型所见会写入可追加的会话日志;Trajectory 视图可按来源检查,并支持恢复、分叉、检索、回放。这对团队很有用:复盘一次失败工具调用、把某条轨迹分叉给同事继续试,比口头描述「刚才 Agent 乱改了文件」靠谱。
但「共用」容易被理解成:一台永远在线的共享 Harness,全组浏览器登录同一 UI。预览版更贴近每人(或每台任务机)一个可写实例,用同一钉住的版本与配置复现;交接物是会话记录、配置片段、仓库 commit,而不是把含密钥的 $DSH_HOME 整目录扔进网盘。多进程、多 profile 同时写同一会话根目录,容易踩「单写者」类问题——运维文档若提到 single-writer,按文档隔离会话根。
插件生态允许第三方扩展 UI(例如会话只读快照、本地导出类分享)。这类能力不是官网首页的一等「团队空间」产品;安装前核对发布者、版本与目标 profile,确认主 UI 仍停在回环、分享面权限是否只读。官方诊断更完整的路径仍是会话日志导出;可读摘要与无损诊断包用途不同,别混用。
术语协作:内部词表 + 有道查词,英文原词不改
团队最容易吵的不是 UI,而是口头译名不统一:有人说「会话」、有人说「Session」;插件、Trajectory、sandbox、profile 各译一套,Issue 检索与交接笔记就对不上。约定一张内部术语表:英文原词固定、中文释义可本地化、禁止改包名与 CLI 旗标。查生词、对按钮旁短句用有道划词/查词;整节 README 或安全讨论再贴文本翻译出大意,然后回到英文页抄命令。
值班英文报错栈:有道只译大意(依赖、端口、权限、网络);搜 GitHub 仍用英文关键词。路径被译成中文或夹全角符号时以终端为准。乱码方框走 乱码排查;与「Harness 起不来」分流。词典/翻译边界见 翻译与词典区别。单人读文档流程不在此重复,见 Harness 文档与有道。
Onboarding 清单建议并列两项:「Node 版本符合当前 README」与「有道已装且能译一句英文」。装错平台或更新异常看下载页与更新失败文,不要重装 Node 碰运气。
安装有道:只走下载页
平台包、版本与可用性以 /zh/download/ 为准。装好后先译一句短英文确认结果区正常,再读 Harness 材料或对照 SSH 报错。勿把 Harness 仓库、npx 行或所谓「Harness APK」当成有道安装来源。
何时停手
本机 dsh web 已通、文档能读懂,但远程打不开:查隧道与远端监听,不重装有道。会话能回放但同事复现失败:对齐钉住的包/commit 与工作目录,不共享凭据目录。npx 失败:回 README / Discussions,查 Node 与网络。预览版菜单或旗标变更:以你打开的那版 CLI/文档为准;过时截图只作参考。