dsh-deskwork (senguo-query)

DSH Deskwork

DSH 运行时基线：0.1.6-alpha.2（精确锁定的预发布版本）。桌面运行时固定 Electron 44.0.0，原因和验证见升级记录。本次升级尚未启用上游 Browser Use / Computer Use 提供方。 登录你的业务系统，让 AI 帮你把事办完。

An AI desktop workspace for ERP and business operations, powered by DeepSeek Harness.

English · 文档导航 · 设计说明 · 路线图 · 参与贡献 · MIT License

DSH Deskwork 将 DeepSeek Harness（DSH）打包进桌面工作台，让用户在熟悉的 ERP 和其他业务系统中，通过对话查询信息、操作页面、调用业务接口和完成工作流。

产品交互借鉴 VS Code / Cursor 的工作台：业务页面与 AI 并排协作，也可以切换为专注任务的 Agent 对话。面向已有业务系统，尽量降低系统改造和员工使用成本。

项目状态：通用 MVP 已实现，预览验收中。 从空工作台添加网址，得到固定标签、独立对话与浏览器身份。已有真实 DSH＋Electron 双站点确认和回读测试；真实 DeepSeek、已登录网站操作及用户 Mac 验收待完成。森果仅是可选测试样例。范围见 M1 规格，证据和兼容限制见 本轮验证。

运行 npm run dev 查看交互预览，npm start 打开桌面客户端。安装、连接与测试说明见预览指南。

两种工作模式

Copilot：页面与 AI 并排协作

左侧是传统业务系统，右侧是 DSH 对话。打开系统就像打开浏览器标签页：用户自行输入账号、完成验证码或单点登录，然后让 AI 在选定的已登录会话中协助操作。

┌──────────────────────────────────┬───────────────────────────┐
│ 业务系统 / 浏览器标签页           │ DSH Copilot               │
│                                  │                           │
│ 采购 · 销售 · 库存 · 财务         │ “找出今天待审核的采购单”  │
│                                  │                           │
│ 用户与 AI 共用当前业务页面        │ 查看步骤、确认、暂停、接手 │
└──────────────────────────────────┴───────────────────────────┘

• 用户手动登录，不必把账号密码写进对话。
• AI 获取所选页面的上下文，并通过浏览器工具读取、导航、填写和操作。
• 用户可以观察执行过程、暂停任务或接手页面。
• 涉及提交、删除、审批等操作时，根据动作类型展示待执行内容并请求确认。

Agent：以任务和对话为中心

M1 的轻量 Agent 与 Copilot 使用同一浏览器会话，只把对话扩展为主区域，随时可「查看页面」。后续再增加两条可组合的执行路径：

路径	连接方式	适用情况
已登录系统 + 业务 API	通过受控执行层复用选定会话，调用经过验证的业务接口	系统已有网页，适合逐步沉淀接口能力
用户配置的 MCP	用户配置 MCP 服务、凭据和可用工具	已有系统集成或专门的业务工具

两种模式共用系统连接、会话选择和任务上下文。从 Copilot 切换到 Agent 后，应能继续处理同一个任务。首次登录或会话过期时，仍可打开业务页面，由用户完成认证后恢复任务。

三条执行路径，一个业务工作台

flowchart TD
    User[用户] --> Copilot[Copilot：业务页面 + 对话]
    User --> Agent[Agent：任务对话]
    Copilot --> DSH[DSH 任务执行核心]
    Agent --> DSH
    DSH --> Tools[受控工具层与连接管理]
    Tools --> Browser[浏览器操作]
    Tools --> API[经验证的业务 API]
    Tools --> MCP[用户配置的 MCP]
    Browser --> ERP[ERP / 业务系统]
    API --> ERP
    MCP --> Business[业务系统与外部工具]

复用登录会话意味着在用户已有权限内执行。会话凭据由宿主侧受控管理，不作为普通文本提供给模型或任意 MCP。能打开页面并不代表能直接调用所有接口；接口路径需要适配认证、请求参数和业务语义，并验证执行结果。

从具体业务开始

下面是计划验证的场景示例，并非已经交付的功能：

• 查询与导出：“查一下今天待审核的采购单，按供应商汇总。”
• 辅助录单：“根据这份明细填写采购单，提交前让我确认。”
• 核对与整理：“对比订单和入库记录，列出数量不一致的条目。”
• MCP 业务任务：“用我配置的库存工具，查询这些商品的可用库存。”

M1 聚焦配置、原样浏览与通用操作闭环。不同网站通过网址接入，不要求先开发连接器。两个结构不同的测试站点验证相同工具的可用性，森果是可选真实样例；测试场景不定义产品模块。

设计原则

• 配置即接入：一个网址对应一个固定入口，保留网站原有页面与业务结构。
• 用户掌握身份和权限：登录由用户完成，执行范围绑定选定系统与账户。
• 协作与自主执行连续：切换界面保留任务上下文，并明确当前连接与身份。
• 工具有明确边界：页面内容和接口返回是业务数据，不能自行扩大 Agent 的权限。
• 业务结果可核对：记录关键步骤和实际结果，区分成功、失败与需要人工处理。
• 能力逐步沉淀：从网页操作起步，将验证过的接口与流程整理为可复用工具。

开发方式

AI 负责实现、测试、实验和日常维护，人聚焦产品规格、必要决策与审核。主要文档按 AI 的任务上下文组织，详见 AGENTS.md 与贡献入口。

仓库内容

入口	职责
AGENTS.md	人与 AI 共同遵循的仓库规则
文档导航	原则、标准、设计、决策、假设和实验
贡献指南	环境准备与统一检查入口
假设登记	候选技术需要证明的事项

M1 使用 Electron + DSH + 宿主 CDP 适配器，Browser Harness 保留为独立验证候选。通用产品边界见 ADR-0005，已有运行时与分发选择见 ADR-0004，结论边界见实验记录。

License

本仓库代码与文档采用 MIT License。后续引入的 DSH、桌面运行时及其他第三方依赖遵循各自许可证；本仓库的 MIT 许可不替代第三方许可。