别敲命令，别输网址。双击鲸鱼，直接开干。

DeepSeek Harness（dsh）是 DeepSeek 开源的智能体框架。它的 Web 界面离你的工作只差一条命令和一个网址——这个插件把这两步也删了。

🐋 概述

好工具会消失。

用老办法打开 DSH Web 界面，每次都要重复同样的仪式：

打开终端 → 输入 "dsh web" → 等它启动 → 打开浏览器 → 敲网址 → 回车

六步。十秒钟。每次都一样。一天开十次，一个月就有一百分钟花在"抵达工具"上——而不是做事。这种摩擦单次看微不足道，但它每次、永远地抽你的税。税是隐形的，所以从来没人质疑它。

适合谁？ 每天不止一次使用 DSH Web 界面的 Windows 用户——无论是一般使用者还是重度 agent 玩家，只要不想每次手输 http://127.0.0.1:3080，想要"双击即达"的入口。

这个插件存在的意义，就是删掉这套仪式：

🖱️ 一键直达。 双击鲸鱼。服务启动、浏览器就位，你已经在里面了。没有第二步。
🔁 天生幂等。 已经在运行？直接开浏览器。连点十下也不坏——没有端口冲突，没有重复实例。
🕳️ 复杂藏在暗处。 启动脚本放在 %LOCALAPPDATA%，桌面上只有一个干净的应用图标。
🌍 处处可用。 启动器是纯 ASCII——GBK、UTF-8、任何 Windows 代码页都能正确解析。
🤖 Agent 原生。 web_launcher 模型工具让 agent 自己就能安装、打开、检查入口——入口成为工作流的一部分，而不是绕路。

"最好的界面是没有界面，其次是一键。"

✅ 兼容性


dsh	已在 `0.1.0-rc.6`（web profile）实测；走标准 `dsh plugin add` 安装流程（`dsh.bundle` 清单）
Node	`^22.19 \|\| >=24`（`engines` 声明）
平台	Windows 10/11 支持桌面快捷方式；`web_launcher` 工具的 `status` / `open` 动作全平台可用
最后验证	2026-08-15（dsh `0.1.0-rc.6`，插件安装 + 单元测试）

📦 安装 / 升级 / 卸载

需要已有 dsh profile（如 web）。

安装

# 从 npm
dsh plugin --profile web add dsh-web-launcher

# 或直接从 GitHub
dsh plugin --profile web add github:hanwuji1/dsh-web-launcher

升级

dsh plugin --profile web update dsh-web-launcher

卸载

dsh plugin --profile web remove dsh-web-launcher

然后清理残留：删除桌面的 DeepSeek Harness Web.lnk 快捷方式和 %LOCALAPPDATA%\dsh-web-launcher 目录。

还没装 dsh？ 独立 PowerShell 安装：

powershell -ExecutionPolicy Bypass -File install.ps1        # 默认端口 3080
powershell -ExecutionPolicy Bypass -File install.ps1 -Port 8080

🚀 快速开始

安装插件（见上文）。
重启一次 dsh web——插件在启动时激活，自动把 DeepSeek Harness Web 应用放到桌面。
双击应用 → 服务启动、轮询就绪、浏览器自动打开。
可复现验证：在任意会话里让 agent 调用 web_launcher，动作 status——应返回 running: true 与 http://127.0.0.1:3080。

最小配置（可选）——完整配置见下文。

🤖 web_launcher 工具

动作	效果
`install`	（重新）创建启动器与鲸鱼图标应用快捷方式（Windows）
`open`	用默认浏览器打开 Web 界面
`status`	检查 DSH Web 服务是否在运行

⚙️ 配置

在 profile 的 cordis.patch.yml（如 ~/.dsh/profiles/web/cordis.patch.yml）中覆盖插件行。patch 会整体替换该行 config，请保留需要保留的键：

- id: dsh-web-launcher
  config:
    autoInstall: true          # 激活时创建/刷新启动器（默认 true）
    createShortcut: true       # 同时创建/刷新应用快捷方式（默认 true）
    port: 3080                 # Web 端口（默认 3080）
    shortcutName: Start-DSH-Web.cmd              # 启动器文件名（默认）
    linkName: DeepSeek Harness Web.lnk           # 应用快捷方式名（默认）
    launcherDir: ""            # 启动器目录；留空 = %LOCALAPPDATA%\dsh-web-launcher
    desktopDir: ""             # 桌面目录；留空 = 自动检测

不涉及任何环境变量或敏感信息。

🔐 权限与数据

领域	插件做了什么
写入文件	`%LOCALAPPDATA%\dsh-web-launcher\Start-DSH-Web.cmd`；桌面 `DeepSeek Harness Web.lnk`
读取文件	不读你的任何数据——只读包内自带的模板与图标
进程	调用 `powershell.exe`（WScript.Shell）创建快捷方式；启动器以你的用户权限运行 `dsh web`
网络	仅回环地址：`status` 探测 `http://127.0.0.1:<port>`；`open` 交给系统默认浏览器
凭据	无——从不读取、存储或发送凭据

🔧 工作原理

┌───────────────────────────┐   ┌───────────────────────────────┐
│  DeepSeek Harness Web     │──▶│  cmd /c Start-DSH-Web.cmd     │
│  （桌面 .lnk，鲸鱼图标）   │   │  （藏在 %LOCALAPPDATA%）      │
└───────────────────────────┘   └───────────────┬───────────────┘
                                                │
                        ┌───────────────────────┼───────────────────────┐
                        ▼                       ▼                       ▼
                 dsh 存在吗？            端口在监听吗？          启动 dsh web
                 （友好报错）           （直接开浏览器）        （轮询 → 开浏览器）

cordis.patch.yml — 声明 dsh.bundle 清单；dsh plugin add 自动把它归入 profile 的 bundle 栈。
lib/launcher.js — 模板渲染（纯 ASCII）、桌面/启动器目录解析、端口探测（fetch + 超时）、WScript.Shell 创建 .lnk。
lib/index.js — Cordis 插件（name / inject: ['tools'] / Config schema）+ 基于 defineTool 的 web_launcher 工具。
tools/make-icon.mjs — 从官方 Harness favicon 轮廓再生成多尺寸 whale.ico（SVG → PNG → PNG-in-ICO）。
tools/make-banner.mjs — 再生成 README 顶部 banner。

🩺 故障排查

症状	原因与解决
`transport failure for /api/...: HTTP 403`	浏览器信任围栏拦截了跨源调用。打开 DevTools → Network → 失败请求 → 复制它的 `Origin` 头。如果不是 `http://127.0.0.1:3080`，说明有第三方在调用本地 API——浏览器扩展（本地模型/翻译类）、残留标签页或嵌入的 iframe。禁用扩展或关掉该页面即可。`--trusted-host` 参数不会放宽 Origin 校验。
`EADDRINUSE` / 端口被占用	已有实例在运行——启动器检测到监听端口会直接打开浏览器。想换端口就在 `cordis.patch.yml` 里设置 `port`。
双击提示 `dsh` 未找到	先安装 CLI：`npm install -g @deepseek-ai/dsh`
桌面图标丢失或变成通用图标	调用 `web_launcher` 的 `install` 动作重建快捷方式与图标
日志在哪里？	启动器控制台会显示 `dsh web` 输出；profile 状态在 `~/.dsh` 下

回滚：dsh plugin --profile web remove dsh-web-launcher 并删除卸载一节列出的两个文件——插件不会留下任何其他痕迹。

🛠️ 开发

无构建步骤 — lib/ 是纯 ESM JavaScript；除 dsh 的 peer 依赖外零运行时依赖。
测试：npm test（node:test——无需任何第三方依赖）。
再生成资源：node tools/make-icon.mjs 与 node tools/make-banner.mjs（需要 sharp；本地未安装时设置 SHARP_PATH 指向其 node_modules）。
发布：bump package.json 的 version → npm publish → git push。dsh.bundle 清单意味着 dsh plugin update 会自动激活新版本。
贡献：欢迎 PR——较大的改动请先开 issue。

❓ 常见问题

Q: 会以管理员权限运行命令吗？ 不会。启动器以你的普通用户权限运行 dsh web。

Q: 会干扰正在运行的服务吗？ 不会。它检测到端口在监听就直接进浏览器。

Q: 为什么用 .cmd 而不是 exe？ 零依赖、无构建链、可审计——60 行，运行前可以通读。

Q: 非 Windows 系统？ 工具仍然注册（status / open 全平台可用）；桌面快捷方式按设计仅限 Windows。

⭐ 支持

如果这个插件每天帮你省下几秒钟，点个 Star —— 它能让更多人找到这个项目，也让维护者知道：这笔"摩擦税"删得值。

发现 bug 或有新想法？提 Issue —— 欢迎 PR。

🗂️ 项目结构

dsh-web-launcher/
├── lib/                  # 插件代码（ESM，零运行时依赖）
│   ├── index.js          # Cordis 插件 + web_launcher 工具
│   ├── launcher.js       # 模板、快捷方式、状态、浏览器辅助
│   └── template.cmd.txt  # ASCII 启动器模板
├── icons/                # whale.ico + 多尺寸 PNG（生成物）
├── assets/               # banner.svg、favicon.whale.svg（图标源）
├── tools/                # 图标/banner 生成器（sharp）
├── tests/                # node:test 单元测试
└── install.ps1           # 独立安装（无需 dsh）

📜 许可证与安全

MIT —— 见 LICENSE。

如需私下报告安全问题，请使用仓库的 Security 标签页（GitHub Security Advisory），不要公开发 issue。

hanwuji1/dsh-web-launcher