feat: import DSH backgrounds from chat without launching dsh

Register /bg, /bg-theme, /bg-clear and beauticode_* tools on the user-started plugin. Reuse a live tray when present; otherwise apply in-process. beautiCode still never starts dsh web.

Author: starsstreaming

README.md

@@ -28,7 +28,7 @@
 
 beautiCode 是一个本地背景工具，**主要面向 DeepSeek Harness和Codex**。
 
-安装包已内置兼容的 DeepSeek Harness 运行时。启动 beautiCode，选中 DeepSeek Harness或Codex，就可以把电脑里的：
+它不包含、不安装、也不启动 DSH。请先自行安装 DeepSeek Harness 并运行 `dsh web`，再启动 beautiCode，选中 DeepSeek Harness 或 Codex，就可以把电脑里的：
 
 * 图片
 * 动态壁纸
@@ -80,7 +80,7 @@ beautiCode 可以让你：
 想直接使用 beautiCode，可以下载 [Windows 安装包](https://github.com/starsstreaming/beautiCode/releases/tag/v1.0.0)。
 安装包自带 Node.js，不需要另外安装 Node.js 或 npm。
 Codex Desktop 路径与原来一样：启动后选 **Codex Desktop**，托盘会按需拉起 Codex。
-DeepSeek Harness 由你自己运行：把插件装进 DSH profile，再启动 `dsh web`，然后在选择框里选 **DeepSeek Harness**。
+DeepSeek Harness 由你自己运行：把插件装进 DSH profile，再启动 `dsh web`，然后在选择框里选 **DeepSeek Harness**。beautiCode 绝不替你启动 DSH。页面打开后也可以用 `/bg`、`/bg-theme`、`/bg-clear`，或直接跟 AI 说把本机图片/视频设成背景。
 <img width="533" height="660" alt="image" src="https://github.com/user-attachments/assets/8c16eeb9-94d0-4f19-a816-b32fba8a110c" />
 
 

apps/tray/session-host.mjs

@@ -10,7 +10,7 @@
  *   GET  /health
  *   GET  /status
  *   POST /apply/image   { "imagePath": "..." }
- *   POST /apply/video   { "videoPath": "...", "imagePath"?: "..." }
+ *   POST /apply/video   { "videoPath": "...", "imagePath"?: "...", "startAt"?: number }
  *   POST /apply/clear   {}
  *   POST /reapply       {}   // republish active background into live sessions
  *   POST /theme/save    { "name": "..." }   // keep current image/video
@@ -27,6 +27,10 @@ import process from "node:process";
 import path from "node:path";
 import crypto from "node:crypto";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import {
+  removeDshControlFile,
+  writeDshControlFile,
+} from "../../integrations/deepseek-harness/control-client.mjs";
 
 if (Number(process.versions.node.split(".", 1)[0]) < 22) {
   console.error("session-host 需要 Node.js 22 或更高版本。");
@@ -186,7 +190,7 @@ function checkAuth(req) {
 }
 
 const server = http.createServer(
-  { maxHeaderSize: 16 * 1024, requestTimeout: 30_000 },
+  { maxHeaderSize: 16 * 1024, requestTimeout: 180_000 },
   async (req, res) => {
   try {
     if (!checkAuth(req)) {
@@ -226,7 +230,7 @@ const server = http.createServer(
             ? {
                 title: "连接 DeepSeek Harness",
                 steps: [
-                  "使用 integrations/deepseek-harness/cordis.patch.example.yml 启动 dsh web。",
+                  "自己运行 dsh web（需已加载 beautiCode 插件）。",
                   "在浏览器中打开 DSH Web 页面。",
                   "回到 beautiCode 托盘选择图片。",
                 ],
@@ -287,6 +291,14 @@ const server = http.createServer(
       if (typeof body.imagePath === "string" && body.imagePath) {
         videoInput.imagePath = path.resolve(body.imagePath);
       }
+      if (body.startAt != null) {
+        const startAt = Number(body.startAt);
+        if (!Number.isFinite(startAt) || startAt < 0) {
+          send(res, 400, { ok: false, error: "startAt 必须是非负数字（秒）。" });
+          return;
+        }
+        videoInput.startAt = startAt;
+      }
       const result = await session.apply(videoInput);
       send(res, result.ok ? 200 : 422, result);
       return;
@@ -404,12 +416,20 @@ const server = http.createServer(
   },
 );
 server.headersTimeout = 10_000;
+server.requestTimeout = 180_000;
 server.keepAliveTimeout = 5_000;
 server.maxRequestsPerSocket = 100;
 
 async function shutdown(code) {
   if (shuttingDown) return;
   shuttingDown = true;
+  if (hostKind === "dsh") {
+    try {
+      await removeDshControlFile({ dataRoot: session.dataRoot, pid: process.pid });
+    } catch {
+      /* ignore */
+    }
+  }
   const serverClosed = new Promise((resolve) => server.close(() => resolve()));
   server.closeIdleConnections?.();
   try {
@@ -441,6 +461,22 @@ process.on("SIGINT", () => void shutdown(0));
 process.on("SIGTERM", () => void shutdown(0));
 const addr = server.address();
 const listenPort = typeof addr === "object" && addr ? addr.port : 0;
+if (hostKind === "dsh") {
+  try {
+    await writeDshControlFile({
+      dataRoot: session.dataRoot,
+      url: `http://127.0.0.1:${listenPort}`,
+      token,
+      pid: process.pid,
+    });
+  } catch (error) {
+    console.error(
+      `session-host：无法发布 DSH 控制面，对话导入和斜杠命令将不可用：${
+        error instanceof Error ? error.message : String(error)
+      }`,
+    );
+  }
+}
 // Machine-readable ready line for the tray launcher (stdout).
 console.log(
   JSON.stringify({

docs/deepseek-harness.md

@@ -5,9 +5,10 @@ beautiCode 通过 DeepSeek Harness 的 Cordis 插件接口接入（`@beauticode/
 ## 已实现能力
 
 - 图片背景、MP4 视频背景与清除。首页（`data-phase="hero"`）壁纸保持原亮度；进入会话（`active` / `settling`）后才压暗。
+- 对话工具与斜杠命令：在 DSH 里说「把某个本机 MP4 设成背景」，或输入 `/bg`、`/bg-theme`、`/bg-clear`。插件自己完成导入，不需要托盘。若托盘已经在跑，则复用托盘，避免两套写入打架。
 - 视频默认静音；可请求开启声音。若浏览器自动播放策略阻止开启声音，会继续静音播放并返回 `blocked: true`。
 - 视频播放位置随已保存主题记录；切换主题、重新应用与页面恢复时从最近位置继续。
-- 摸鱼模式：隐藏 DSH 的 `#root`，背景舞台继续显示和播放；`Ctrl+Shift+Space` 可退出。属于实验性能力。
+- 摸鱼模式：隐藏 DSH 的 `#root`，背景舞台继续显示和播放；`Ctrl+Shift+Space` 可退出。
 - 深色、浅色、跟随系统三种背景色调。
 - 图片/视频主题的保存、切换和删除。
 - 页面刷新或稍后打开时，会恢复当前背景与模式。找不到 `#root` 时应用失败并回滚，不会静默画坏页。
@@ -30,7 +31,7 @@ dsh plugin --profile web add file:%LOCALAPPDATA%\Programs\beautiCode\integration
 
 ## 启用插件
 
-把下面的条目加到 profile 自己的 patch 层（`~/.dsh/cordis.patch.yml` 或 profile 目录的 `cordis.patch.yml`），然后重启 `dsh web`：
+把下面的条目加到 profile 自己的 patch 层（`~/.dsh/cordis.patch.yml` 或 profile 目录的 `cordis.patch.yml`），然后自己启动 `dsh web`：
 
 ```yaml
 - insert:
@@ -43,7 +44,7 @@ dsh plugin --profile web add file:%LOCALAPPDATA%\Programs\beautiCode\integration
 
 ## 控制端
 
-启动 beautiCode，在选择框里选 DeepSeek Harness（或直接 `start-tray.ps1 -TargetHost dsh`）。托盘连接你正在运行的 DSH 网页：
+启动 beautiCode，在选择框里选 DeepSeek Harness（或直接 `start-tray.ps1 -TargetHost dsh`）。托盘只连接你正在运行的 DSH 网页：
 
 ```powershell
 powershell -NoProfile -ExecutionPolicy Bypass -File apps\tray\start-tray.ps1 -TargetHost dsh -DshUrl http://127.0.0.1:3080
@@ -60,7 +61,23 @@ npm run bc -- clear --port 3080
 
 自定义数据目录时，控制端与插件必须使用同一个 `BEAUTICODE_DATA_ROOT`，否则令牌文件不一致。未设置时两边都默认 `%LOCALAPPDATA%\beautiCode`。
 
-> beautiCode 不会自动启动 DSH。若 `dsh web` 未运行或未加载插件，托盘会提示你先启动 DSH 网页，而不是替你拉起进程。
+> beautiCode 不会自动启动 DSH。若 `dsh web` 未运行或未加载插件，托盘会提示你先启动 DSH 网页，而不是替你拉起进程。网页已开但关掉时，「应用或重新应用」只会重新打开页面。
+
+### 对话导入与斜杠命令
+
+插件在 DSH 的 `tools` / `commands` 服务出现后注册（不把它们写成硬依赖，以免没有 agent 的 webServer 组合挂不上桥）。
+
+| 入口 | 作用 |
+|---|---|
+| `beauticode_apply_video` / `beauticode_apply_image` | 按本机绝对路径导入 |
+| `beauticode_theme_list` / `beauticode_theme_use` | 列出或切换已保存主题 |
+| `beauticode_clear` / `beauticode_status` | 清除或查看当前背景 |
+| `beauticode_set_fish` / `beauticode_set_muted` | 摸鱼、背景声音 |
+| `/bg <绝对路径>` | 按扩展名导入图片或 MP4 |
+| `/bg-theme <名称>` | 切换已保存主题 |
+| `/bg-clear` | 清除背景 |
+
+没有托盘时，插件在 DSH 进程里启动同一套 `DshSession`（校验、拷贝、媒体服务、live verify）。托盘若已在跑，则继续走 `dsh-control.json`，避免抢同一把写入锁。页面必须已打开，否则 verify 会失败并回滚。
 
 ## 安全边界
 

integrations/deepseek-harness/README.zh-CN.md

@@ -2,61 +2,22 @@
 
 该 Cordis 插件向 DSH Web 注入 beautiCode 浏览器客户端，并提供本机鉴权接口。支持图片、MP4、播放位置、静音、摸鱼模式、深浅色调以及清除背景。
 
-插件以 `@beauticode/dsh-plugin` 的形态放在本仓库（安装包也会带上同一目录）。beautiCode **不附带、不启动** DeepSeek Harness；请用你自己的 `dsh` 装插件并启动网页。
+插件会注册对话工具（`beauticode_*`）和斜杠命令（`/bg`、`/bg-theme`、`/bg-clear`），把本机文件导入为背景。不需要托盘；托盘若已在跑则复用它。
 
-## 安装
+beautiCode **不启动** DeepSeek Harness。请先自己运行 `dsh web`，再打开 beautiCode 选择 DeepSeek Harness。
 
-```sh
-# 源码目录
-dsh plugin --profile web add file:<beautiCode 路径>/integrations/deepseek-harness
-
-# Windows 安装包
-dsh plugin --profile web add file:%LOCALAPPDATA%\Programs\beautiCode\integrations\deepseek-harness
-```
-
-包尚未发布到 npm，请按路径安装，不要用 `dsh plugin add @beauticode/dsh-plugin`。
+安装包和托盘会把插件写入你的 DSH profile。源码环境也可以手动：
 
-## 启用
-
-把下面的条目加到 profile 自己的 patch 层（`~/.dsh/cordis.patch.yml` 或 profile 目录的 `cordis.patch.yml`），然后重启 `dsh web`：
-
-```yaml
-- insert:
-    - id: beauticode-bridge
-      name: '@beauticode/dsh-plugin'
-      inject: [webServer]
+```sh
+dsh plugin --profile web add file:%CD%/integrations/deepseek-harness
+dsh web
 ```
 
-也可以参考 `cordis.patch.example.yml`。默认端口是 `3080`；托盘用 `-DshUrl` 才能连其他端口。
-
-## 控制
-
-插件只暴露本机接口。托盘 / CLI 与插件默认共用 `%LOCALAPPDATA%\beautiCode`（或 `BEAUTICODE_DATA_ROOT`）里的 `dsh-bridge.token`。自定义数据根时两边必须一致。
-
-接口一览（均以 `/__beauticode/` 前缀）：
-
-| 路径 | 方法 | 鉴权 | 说明 |
-|---|---|---|---|
-| `/version` | GET/HEAD | 无 | 桥接协议与版本 |
-| `/client.js` | GET | 无 | 浏览器注入脚本 |
-| `/events` | GET (SSE) | 同源 | 浏览器客户端事件流 |
-| `/apply` | POST | Bearer | 应用图片/视频/清除 |
-| `/mode` | POST | Bearer | 摸鱼/静音/色调 |
-| `/status` | GET | Bearer | 当前状态与回执汇总 |
-| `/ack` | POST | 同源 | 浏览器渲染/模式回执 |
-
-## 安全边界
-
-- DSH Web 必须绑定本机回环地址。
-- 控制端点需要随机令牌；浏览器回执只接受同源请求。
-- 媒体 URL 仅允许带令牌的回环 HTTP 地址。
-- 插件只注入与鉴权，不改动 DSH 源码，也不结束/重启用户的 DSH 进程。
-
-## DOM 契约与失败方式
-
-背景舞台依赖 DSH 页面结构：`#root` 为硬依赖；`data-phase` 标记用于进入会话后压暗。
+手动接入时：
 
-- 找不到 `#root` → 渲染回执返回明确错误，应用事务失败并回滚。
-- `data-phase` 缺失时不硬失败（首页无会话标记是正常的）。
+1. 修改 `cordis.patch.example.yml` 中的 `file:///.../index.mjs`。
+2. 确保 DSH 和 beautiCode 使用相同的 `BEAUTICODE_DATA_ROOT`。
+3. 自己运行 `dsh web`（或带 `--patch`）。
+4. 打开页面后输入 `/bg <本机绝对路径>`，或直接跟 AI 说把某个视频/图片设为背景。
 
-摸鱼模式通过隐藏 `#root` 的 CSS 实现，属于实验性能力。
+安全边界：DSH Web 必须绑定本机回环地址；控制端点需要随机令牌；媒体 URL 仅允许带令牌的回环 HTTP 地址；浏览器回执只接受同源请求。