@tianyulinfeng1/dsh-plugin-deepseek-chat 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sweet560
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,138 @@
+# dsh-plugin-deepseek-chat
+
+English | [中文](https://github.com/sweet560/dsh-plugin-deepseek-chat/blob/main/README.md)
+
+Adds a **DeepSeek Chat** entry to the **DeepSeek Harness (DSH) desktop** sidebar. Clicking it opens `chat.deepseek.com` full-width in the main area and remembers the last conversation.
+
+> Repository: [GitHub](https://github.com/sweet560/dsh-plugin-deepseek-chat) | [Gitee mirror](https://gitee.com/wtt520wyl/dsh-plugin-deepseek-chat)
+
+![panel screenshot](https://raw.githubusercontent.com/sweet560/dsh-plugin-deepseek-chat/main/docs/screenshot.png)
+
+## Features
+
+- Sidebar icon entry, placed between **Plugins** and **Scheduled tasks**.
+- Full-width embedded `https://chat.deepseek.com/` (Electron `<webview>` through the desktop guest-lease bridge `window.dshDesktop.browser`).
+- **Last-conversation memory**: switching panels/sessions or restarting the app reopens the conversation you left, not a new chat.
+- Auth pages never overwrite that memory; a dead conversation falls back to the site root.
+- **Crash containment**: if the embedded page's process dies, is destroyed, or never starts, the panel shows a Retry card — the app window no longer goes blank (fixed in v0.4.0).
+- Inert on the plain Web surface (`dsh web`): the site sends `frame-ancestors 'none'`, so an iframe cannot carry it, and the guest bridge only exists in the desktop shell.
+
+## Requirements
+
+| Item | Requirement |
+|---|---|
+| DSH | Desktop `0.2.1-rc.2` or newer |
+| Platform | Windows / macOS / Linux desktop shell |
+| git | Only for the GitHub install route (pnpm fetches the repository) |
+
+## Install
+
+npm package: **`@tianyulinfeng1/dsh-plugin-deepseek-chat`** (the GitHub repository is still named `dsh-plugin-deepseek-chat`).
+
+### Option 1 — npm (recommended)
+
+```powershell
+dsh plugin --profile desktop add @tianyulinfeng1/dsh-plugin-deepseek-chat
+```
+
+You can also enter the package name `@tianyulinfeng1/dsh-plugin-deepseek-chat` in the Plugins page.
+
+### Option 2 — Plugins page (GitHub)
+
+1. Open DSH desktop and click **Plugins** in the sidebar.
+2. Click **Install a third-party plugin** above the list.
+3. Enter:
+
+   ```
+   github:sweet560/dsh-plugin-deepseek-chat
+   ```
+
+   `https://github.com/sweet560/dsh-plugin-deepseek-chat` works too.
+4. Click **Install** and wait for pnpm to finish.
+5. The plugin is enabled automatically; **DeepSeek Chat** appears in the sidebar.
+
+### Option 3 — CLI (GitHub)
+
+```powershell
+dsh plugin --profile desktop add github:sweet560/dsh-plugin-deepseek-chat
+```
+
+Then open **Plugins → Installed plugins** and make sure **DeepSeek Chat** is switched on (the CLI only installs the package).
+
+### Option 4 — local checkout (development)
+
+```powershell
+dsh plugin --profile desktop add file:"<absolute path to this repository>"
+```
+
+## Usage
+
+- The first visit shows the chat.deepseek.com sign-in page; sign in once.
+- Within one app run, switching panels or sessions keeps you signed in.
+- **Sign in again after restarting DSH**: DSH currently gives embedded browsers an in-memory partition (`dsh-sidebar-browser-<uuid>`, no `persist:` prefix), so cookies are dropped when the process exits. This plugin does not modify DSH's installation files, so it cannot bypass that. To sign in once and stay signed in, run the bundled patch script **[docs/patch-dsh-persistent-partition.cjs](https://github.com/sweet560/dsh-plugin-deepseek-chat/blob/main/docs/patch-dsh-persistent-partition.cjs)** (rc.3 ASAR-integrity aware, supports `--dry-run`, automatic backup and full verification); see **[docs/login-persistence.md](https://github.com/sweet560/dsh-plugin-deepseek-chat/blob/main/docs/login-persistence.md)**.
+- The conversation URL is stored in the app's localStorage (`dsh-plugin-deepseek-chat:last-url`), so the last conversation is restored after a restart (while signed in and while it still exists).
+
+## Persistent login (optional)
+
+DSH hands embedded browsers an **in-memory partition** (`dsh-sidebar-browser-${randomUUID()}`, no `persist:` prefix), so every app restart drops the cookies. To sign in once and stay signed in, replace that partition with a fixed `persist:` one inside `resources/app.asar` — the two statements are the same length, so the archive can be patched byte-for-byte in place.
+
+Cause, script, verification, rollback and per-platform paths:
+
+**→ [docs/login-persistence.md](https://github.com/sweet560/dsh-plugin-deepseek-chat/blob/main/docs/login-persistence.md)**
+
+Bundled patch script (Node 18+, no dependencies):
+
+```powershell
+# Patch (creates a timestamped backup first)
+node docs/patch-dsh-persistent-partition.cjs "F:\DeepSeek Harness\resources\app.asar"
+
+# Dry run: check without writing
+node docs/patch-dsh-persistent-partition.cjs "F:\DeepSeek Harness\resources\app.asar" --dry-run
+```
+
+The script understands the per-file ASAR `integrity` metadata shipped by `0.2.1-rc.3` (it recomputes and syncs `lib/main.js`'s SHA256), is idempotent (already patched returns 0), creates an automatic backup, verifies every block hash before and after writing, and supports `--dry-run`.
+
+Note: this modifies the installed application and is outside DSH's support; a DSH update overwrites `app.asar` and the patch must be re-applied (the `Partitions` data survives). Back up first and proceed at your own risk.
+
+## Known limitations
+
+- chat.deepseek.com detects the Electron embedding and occasionally shows a "usage environment is abnormal" notice. That is site-side behaviour, unrelated to this plugin.
+- Desktop only; `dsh web` in a browser shows no entry.
+- If the site changes its conversation URL scheme (currently `/a/chat/s/<id>`), the memory falls back to the site root.
+
+## Crash containment (v0.4.0)
+
+Earlier versions could leave the whole app a blank window a second or two after opening the panel, with no crash dialog and no `crash-*.log`.
+
+Root cause: React runs effect cleanups after it has removed the DOM, and Electron's `<webview>` throws from `getURL()` once detached. DSH treats any uncaught plugin error as `slot entry crashed in 'root'` and unmounts the root slot — the entire UI.
+
+The current implementation guards every guest call behind an `isConnected` check and `try/catch`, reads the URL before removing the element, wraps every event handler, puts a React error boundary around the panel, listens for `render-process-gone` / `destroyed` / `did-fail-load`, and has a 15-second start watchdog.
+
+## Development
+
+```powershell
+git clone https://github.com/sweet560/dsh-plugin-deepseek-chat.git
+cd dsh-plugin-deepseek-chat
+node test/check-client.mjs
+```
+
+`test/check-client.mjs` loads `lib/client.js` in a `node:vm` sandbox with fake React/DOM/bridge objects and checks registration, conversation memory, lease release, and crash containment.
+
+```
+lib/index.js           host half (empty; it only gives the client bundle a Loader entry)
+lib/client.js          browser half: entry, panel, webview lifecycle, crash containment
+cordis.patch.yml       bundle patch that inserts this plugin's Loader row
+locale/{zh,en}.json    Plugins-page title/description
+icon.svg               Plugins-page icon
+test/check-client.mjs  offline self-check
+```
+
+## Uninstall
+
+```powershell
+dsh plugin --profile desktop remove dsh-plugin-deepseek-chat
+```
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -1,3 +1,157 @@
-# Temporary Holding Version
+# dsh-plugin-deepseek-chat
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[English](https://github.com/sweet560/dsh-plugin-deepseek-chat/blob/main/README.en.md) | 中文
+
+在 **DeepSeek Harness（DSH）桌面版**的左侧栏加入 **DeepSeek 聊天** 入口，点开后 `chat.deepseek.com` 直接占满主内容区，并记住上次所在的会话。
+
+> 仓库：[GitHub](https://github.com/sweet560/dsh-plugin-deepseek-chat) ｜ [Gitee 镜像](https://gitee.com/wtt520wyl/dsh-plugin-deepseek-chat)
+
+![面板截图](https://raw.githubusercontent.com/sweet560/dsh-plugin-deepseek-chat/main/docs/screenshot.png)
+
+## 功能
+
+- 左侧栏图标入口，排在「插件」和「自动化任务」之间。
+- 主内容区全宽内嵌 `https://chat.deepseek.com/`（Electron `<webview>`，走桌面壳的 guest 租约桥 `window.dshDesktop.browser`）。
+- **记住上次会话**：切到别的面板、切换会话、重启 App 后再进来，直接回到上次那条对话，而不是新对话。
+- 登录/鉴权页不会覆盖记忆；记住的会话失效或打不开时自动回退到首页。
+- **崩溃隔离**：内嵌页进程退出、被销毁或启动超时，只在面板里显示「重试」，不会再出现整个 App 变空白窗口的问题（v0.4.0 修复，见下文）。
+- 纯 Web 表层（`dsh web` 在浏览器里打开）自动不注册——该站点 `frame-ancestors 'none'`，iframe 嵌不了，guest 租约桥也只有桌面壳提供。
+
+## 环境要求
+
+| 项 | 要求 |
+|---|---|
+| DSH | 桌面版 `0.2.1-rc.2` 或更新 |
+| 平台 | Windows / macOS / Linux 桌面壳 |
+| git | 仅「GitHub 安装」方式需要（pnpm 通过 git 拉取仓库） |
+
+## 安装
+
+npm 包名：**`@tianyulinfeng1/dsh-plugin-deepseek-chat`**（GitHub 仓库名仍是 `dsh-plugin-deepseek-chat`）。
+
+### 方式一：npm（推荐）
+
+```powershell
+dsh plugin --profile desktop add @tianyulinfeng1/dsh-plugin-deepseek-chat
+```
+
+插件页「安装第三方插件」里也可以直接填包名 `@tianyulinfeng1/dsh-plugin-deepseek-chat`。
+
+### 方式二：插件页安装（GitHub）
+
+1. 打开 DSH 桌面版，左侧栏点 **插件**。
+2. 点列表上方的 **安装第三方插件**。
+3. 在「包名或地址」里填入：
+
+   ```
+   github:sweet560/dsh-plugin-deepseek-chat
+   ```
+
+   也可以填 `https://github.com/sweet560/dsh-plugin-deepseek-chat`。
+4. 点 **安装**，等 pnpm 跑完（首次会拉取仓库并安装依赖）。
+5. 安装完成后插件自动启用，左侧栏出现 **DeepSeek 聊天**。
+
+### 方式三：命令行（GitHub）
+
+```powershell
+dsh plugin --profile desktop add github:sweet560/dsh-plugin-deepseek-chat
+```
+
+装完打开 **插件 → 已安装插件**，确认「DeepSeek 聊天」处于启用状态（命令行只负责装依赖，启用状态以插件页为准）。
+
+### 方式四：本地目录（二次开发）
+
+```powershell
+dsh plugin --profile desktop add file:"<本仓库绝对路径>"
+```
+
+## 使用
+
+- 第一次打开会停在 chat.deepseek.com 的登录页，登录一次即可。
+- 本次 App 运行期间，切换面板/会话不需要重新登录。
+- **重启 DSH 后需要重新登录一次**：DSH 目前给内嵌浏览器的是内存分区（`dsh-sidebar-browser-<uuid>`，没有 `persist:` 前缀），进程退出即清空 cookie。本插件不修改 DSH 的安装文件，所以不会绕过这一限制；想做到「登录一次、长期免登录」，可直接运行仓库自带的补丁脚本 **[docs/patch-dsh-persistent-partition.cjs](https://github.com/sweet560/dsh-plugin-deepseek-chat/blob/main/docs/patch-dsh-persistent-partition.cjs)**（已适配 `0.2.1-rc.3` 的 ASAR integrity，支持 `--dry-run`、自动备份与全量校验），说明见 **[docs/login-persistence.md](https://github.com/sweet560/dsh-plugin-deepseek-chat/blob/main/docs/login-persistence.md)**。
+- 会话链接记在 App 的 localStorage（key `dsh-plugin-deepseek-chat:last-url`），重启后仍会打开上次的会话（前提是已登录且该会话仍存在）。
+
+## 登录态持久化（可选，免登录）
+
+DSH 目前给内嵌浏览器分配的是**内存分区**（`dsh-sidebar-browser-${randomUUID()}`，无 `persist:` 前缀），所以每次重启 App 都会清空 cookie。想做到「登录一次、以后不再登录」，需要把桌面主进程里的那行分区名改成固定且带 `persist:` 前缀的值——两条语句**字节数相同**，可以直接在 `resources/app.asar` 里原地替换。
+
+完整原因、脚本、验证步骤、回滚方式和各平台路径都整理在这里：
+
+**→ [docs/login-persistence.md](https://github.com/sweet560/dsh-plugin-deepseek-chat/blob/main/docs/login-persistence.md)**
+
+补丁脚本（仓库自带，Node 18+，零依赖）：
+
+```powershell
+# 打补丁（自动备份）
+node docs/patch-dsh-persistent-partition.cjs "F:\DeepSeek Harness\resources\app.asar"
+
+# 只检查、不写盘
+node docs/patch-dsh-persistent-partition.cjs "F:\DeepSeek Harness\resources\app.asar" --dry-run
+```
+
+脚本已适配 `0.2.1-rc.3` 的逐文件 ASAR `integrity`（自动重算并同步 `lib/main.js` 的 SHA256），支持幂等重跑（已打补丁直接返回 0）、自动备份、写入前后全量校验，以及 `--dry-run` 预演。
+
+注意：这属于对已安装应用的修改，不在 DSH 支持范围内；DSH 升级会覆盖 `app.asar`，需要重新打补丁（`Partitions` 里的登录数据不会丢）。请先备份，风险自负。
+
+## 已知限制
+
+- chat.deepseek.com 会检测 Electron 内嵌环境，偶尔弹出「使用环境异常…建议使用官方产品」的提示；这是站点侧行为，与本插件无关。
+- 仅桌面版有效；`dsh web` 在浏览器里打开时不显示入口。
+- 站点若调整会话 URL 规则（当前识别 `/a/chat/s/<id>` 形式），「记住会话」可能失效并回退到首页。
+
+## 崩溃隔离（v0.4.0）
+
+早期版本出现过：点开面板、聊天页正常显示 1~2 秒后**整个 App 变成空白窗口**（只剩原生菜单和窗口按钮），没有崩溃对话框也没有 `crash-*.log`。
+
+根因是 React 卸载面板时**先移除 DOM、后执行 effect 清理**，而 Electron 的 `<webview>` 一旦脱离文档，`getURL()` 就会抛错；DSH 把插件里任何未捕获异常都当作 `slot entry crashed in 'root'`，直接卸载 `root` slot —— 整个 App UI 因此消失。
+
+现在的实现：
+
+- 所有 guest 调用先判断 `element.isConnected` 再 `try/catch`，清理阶段「先读 URL、再移除元素」；
+- 每个事件处理器都包 `try/catch`，异常只落在面板自己的状态里；
+- 面板外包一层 React 错误边界；
+- 监听 `render-process-gone` / `destroyed` / `did-fail-load`，guest 出问题时面板内显示「重试」；
+- 15 秒启动看门狗，guest 一直不 `dom-ready` 就转重试卡片。
+
+## 开发
+
+```powershell
+git clone https://github.com/sweet560/dsh-plugin-deepseek-chat.git
+cd dsh-plugin-deepseek-chat
+node test/check-client.mjs
+```
+
+`test/check-client.mjs` 是离线自检：在 `node:vm` 里加载 `lib/client.js`，用假的 React/DOM/租约桥验证注册、会话记忆、租约释放和崩溃隔离（DOM 先移除再清理不抛错、guest 崩溃不逃逸、反复开关不漏租约）。
+
+目录：
+
+```
+lib/index.js           宿主半侧（空实现，只为让 client bundle 有 Loader 入口）
+lib/client.js          浏览器半侧：入口、面板、webview 生命周期、崩溃隔离
+cordis.patch.yml       bundle 补丁：插入本插件的 Loader 行
+locale/zh.json         插件页显示名称/描述（中文）
+locale/en.json         插件页显示名称/描述（英文）
+icon.svg               插件页图标
+test/check-client.mjs  离线自检
+```
+
+## 卸载
+
+```powershell
+dsh plugin --profile desktop remove dsh-plugin-deepseek-chat
+```
+
+## 作者
+
+- **作者**：伍悦匿匿
+- **联系方式**：437830488@qq.com
+- **GitHub**：https://github.com/sweet560
+- **博客园**：https://www.cnblogs.com/wuyuenini/
+- **CSDN**：https://blog.csdn.net/weixin_42076389
+- **Gitee**：https://gitee.com/wtt520wyl
+- **Gitee 镜像仓库**：https://gitee.com/wtt520wyl/dsh-plugin-deepseek-chat
+
+## 许可证
+
+[MIT](LICENSE)

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-plugin-deepseek-chat bundle patch: one insert registers this plugin.
+# insert.name must be the package name; insert.id must be unique across the
+# composed loader tree.
+- insert:
+    - id: deepseek-chat
+      name: '@tianyulinfeng1/dsh-plugin-deepseek-chat'

package/icon.svg

@@ -0,0 +1,11 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M8.25 10.5c0-1.52 1.23-2.75 2.75-2.75h14c1.52 0 2.75 1.23 2.75 2.75v10.5c0 1.52-1.23 2.75-2.75 2.75h-9.1l-4.55 3.8c-.78.65-1.95.09-1.95-.93V10.5Z" stroke="url(#chat-bubble)" stroke-width="2.4" stroke-linejoin="round"/>
+  <path d="M13.4 13.6h9.2M13.4 18h5.6" stroke="#658EFF" stroke-width="2.2" stroke-linecap="round"/>
+  <defs>
+    <linearGradient id="chat-bubble" x1="7" y1="8" x2="29" y2="28" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#41E1AC"/>
+      <stop offset="0.65" stop-color="#658EFF"/>
+      <stop offset="1" stop-color="#41E1AC"/>
+    </linearGradient>
+  </defs>
+</svg>

package/lib/client.js

@@ -0,0 +1,549 @@
+/**
+ * Browser half of dsh-plugin-deepseek-chat.
+ *
+ * Registers one global left-sidebar panel — the same mechanism the Plugins and
+ * Scheduled tasks entries use:
+ *   `sidebar.panellist` (list) contributes the icon row, and the root `main`
+ *   keyed slot with the same key renders the panel page.
+ *
+ * The page hosts chat.deepseek.com in an Electron `<webview>`. The site sends
+ * `content-security-policy: frame-ancestors 'none'`, so an iframe cannot carry
+ * it; the desktop shell exposes `globalThis.dshDesktop.browser`, the same guest
+ * lease bridge the built-in sidebar browser uses: acquire a lease → create a
+ * webview named by the lease with its approved partition → load the URL.
+ *
+ * Failure containment is the hard rule of this file. DSH treats any uncaught
+ * error thrown by a plugin as a crash of its slot entry, and a crash inside the
+ * `root` slot unmounts the entire application UI (the native frame stays, every
+ * panel disappears). Electron throws from webview methods such as `getURL()`
+ * and `loadURL()` as soon as the element leaves the document, and React runs
+ * effect cleanups after the DOM removal — so every guest call here is attached-
+ * checked and wrapped, every event handler catches, and a React error boundary
+ * keeps a render failure inside this panel. A dead guest is reported in the
+ * panel with a Retry button; it never escapes to the shell.
+ *
+ * Leaving the panel unmounts this page and releases the guest, so the page
+ * remembers the last conversation URL and reopens there instead of starting a
+ * new chat every time.
+ */
+window.__ModuleLoader__.load({
+	id: "dsh-plugin-deepseek-chat",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		const react = require("react");
+
+		const PANEL_ID = "deepseek-chat";
+		const CHAT_URL = "https://chat.deepseek.com/";
+		/**
+		 * Storage identity for the guest partition. The main process keeps one
+		 * partition per identity for the lifetime of the process, so switching
+		 * panels or sessions keeps the page state and its login.
+		 */
+		const PARTITION_KEY = "panel:deepseek-chat";
+
+		const english = typeof navigator !== "undefined" && /^en\b/i.test(navigator.language ?? "");
+		const COPY = english ? {
+			label: "DeepSeek Chat",
+			loading: "Loading DeepSeek Chat…",
+			unsupported: "The embedded chat needs the desktop app.",
+			failed: "The chat page could not be opened",
+			crashed: "The embedded chat stopped responding",
+			timeout: "The embedded chat did not start",
+			retry: "Retry"
+		} : {
+			label: "DeepSeek 聊天",
+			loading: "正在加载 DeepSeek 聊天…",
+			unsupported: "内嵌聊天窗口需要桌面版 App。",
+			failed: "聊天页面打开失败",
+			crashed: "内嵌聊天进程已退出",
+			timeout: "内嵌聊天页面没有启动",
+			retry: "重试"
+		};
+
+		/** Where the last visited conversation URL is remembered; the shell keeps this storage across restarts. */
+		const STORAGE_KEY = "dsh-plugin-deepseek-chat:last-url";
+		/** Paths that are not a conversation: a brand-new chat, or an auth page. */
+		const NON_CONVERSATION_PATHS = new Set(["/", "/sign_in", "/login", "/signup", "/auth"]);
+
+		/**
+		 * Parse a chat.deepseek.com page URL.
+		 * @param value - candidate URL.
+		 * @returns the parsed URL for the site origin, or undefined.
+		 */
+		function parseChatUrl(value) {
+			if (typeof value !== "string" || value.length === 0 || value.length > 4096) return void 0;
+			try {
+				const url = new URL(value);
+				if (url.protocol !== "https:" || url.hostname !== "chat.deepseek.com") return void 0;
+				if (url.username !== "" || url.password !== "") return void 0;
+				return url;
+			} catch {
+				return void 0;
+			}
+		}
+
+		/**
+		 * Whether a URL deep enough to be a conversation page.
+		 * @param url - parsed chat URL, possibly undefined.
+		 * @returns true for a conversation, false for the new-chat root or an auth page.
+		 */
+		function isConversation(url) {
+			if (url === void 0) return false;
+			const path = url.pathname.replace(/\/+$/u, "") || "/";
+			return !NON_CONVERSATION_PATHS.has(path);
+		}
+
+		/**
+		 * Read the conversation remembered from the last visit.
+		 * @returns the URL to open; the site root when nothing usable is remembered.
+		 */
+		function rememberedTarget() {
+			try {
+				const saved = parseChatUrl(window.localStorage.getItem(STORAGE_KEY));
+				return isConversation(saved) ? saved.toString() : CHAT_URL;
+			} catch {
+				return CHAT_URL;
+			}
+		}
+
+		/**
+		 * Remember where the guest currently is.
+		 *
+		 * A brand-new chat clears the memory so the next visit starts clean. An auth
+		 * page never overwrites it, so a login detour does not lose the conversation.
+		 * @param raw - current page URL reported by the guest.
+		 */
+		function rememberTarget(raw) {
+			const url = parseChatUrl(raw);
+			if (url === void 0) return;
+			try {
+				const path = url.pathname.replace(/\/+$/u, "") || "/";
+				if (isConversation(url)) window.localStorage.setItem(STORAGE_KEY, url.toString());
+				else if (path === "/") window.localStorage.removeItem(STORAGE_KEY);
+			} catch {
+				/* storage unavailable: the panel still works, it just forgets */
+			}
+		}
+
+		/**
+		 * Whether the guest element is still in the document. Electron's webview
+		 * methods throw once it is detached, so this gates every guest call.
+		 * @param element - webview element.
+		 * @returns true while the element can still host a guest.
+		 */
+		function attached(element) {
+			try {
+				return element.isConnected === true;
+			} catch {
+				return false;
+			}
+		}
+
+		/**
+		 * Guest URL, or undefined when the element cannot report one. This is the
+		 * call that used to escape: React cleans up effects after removing the DOM,
+		 * and Electron then throws from `getURL()`.
+		 * @param element - webview element.
+		 * @returns the URL string, or undefined.
+		 */
+		function readUrl(element) {
+			if (!attached(element)) return void 0;
+			try {
+				const url = element.getURL();
+				return typeof url === "string" && url.length > 0 ? url : void 0;
+			} catch {
+				return void 0;
+			}
+		}
+
+		/**
+		 * Navigate the guest without ever throwing.
+		 * @param element - webview element.
+		 * @param url - target URL.
+		 * @returns false when the guest is gone, so the caller can report it.
+		 */
+		function navigate(element, url) {
+			if (!attached(element)) return false;
+			try {
+				const pending = element.loadURL(url);
+				if (pending !== void 0 && pending !== null && typeof pending.catch === "function") pending.catch(() => {});
+				return true;
+			} catch {
+				return false;
+			}
+		}
+
+		/**
+		 * Panel-list glyph, drawn on currentColor so the sidebar's active state owns
+		 * the ink. Matches the sidebar's 16/18px icon seat.
+		 * @param props - size passed by the sidebar panel list.
+		 * @returns the glyph element.
+		 */
+		function ChatGlyph({ size = 18 }) {
+			return react.createElement("svg", {
+				width: size,
+				height: size,
+				viewBox: "0 0 24 24",
+				fill: "none",
+				"aria-hidden": "true",
+				focusable: "false"
+			}, react.createElement("path", {
+				d: "M4.5 5.75C4.5 4.784 5.284 4 6.25 4h11.5c.966 0 1.75.784 1.75 1.75v8.5c0 .966-.784 1.75-1.75 1.75H9.56l-3.34 2.784c-.497.414-1.22.06-1.22-.586V5.75Z",
+				stroke: "currentColor",
+				strokeWidth: 1.3,
+				strokeLinejoin: "round"
+			}), react.createElement("path", {
+				d: "M8.5 9.25h7M8.5 12.25h4.5",
+				stroke: "currentColor",
+				strokeWidth: 1.3,
+				strokeLinecap: "round"
+			}));
+		}
+
+		const styles = {
+			root: {
+				display: "flex",
+				flexDirection: "column",
+				height: "100%",
+				minHeight: "0",
+				background: "var(--dsw-alias-bg-base)",
+				color: "var(--dsw-alias-label-primary)"
+			},
+			host: {
+				position: "relative",
+				flex: "1",
+				minHeight: "0",
+				display: "flex"
+			},
+			guest: {
+				width: "100%",
+				height: "100%",
+				border: "0",
+				background: "transparent",
+				display: "flex"
+			},
+			notice: {
+				position: "absolute",
+				inset: "0",
+				display: "flex",
+				flexDirection: "column",
+				alignItems: "center",
+				justifyContent: "center",
+				gap: "10px",
+				padding: "24px",
+				textAlign: "center",
+				color: "var(--dsw-alias-label-tertiary)",
+				font: "var(--dsw-font-xxs-12)",
+				background: "var(--dsw-alias-bg-base)"
+			},
+			button: {
+				color: "var(--dsw-alias-label-primary)",
+				background: "var(--dsw-alias-bg-layer-1)",
+				border: ".5px solid var(--dsw-alias-border-l3)",
+				borderRadius: "var(--dsw-radius-sm)",
+				padding: "4px 12px",
+				cursor: "pointer",
+				font: "var(--dsw-font-xxs-12)"
+			}
+		};
+
+		/**
+		 * Keeps a rendering failure inside this panel. DSH has no boundary of its own
+		 * around slot entries: an escaping error unmounts the root slot, which is the
+		 * whole application UI.
+		 */
+		class PanelBoundary extends react.Component {
+			constructor(props) {
+				super(props);
+				this.state = { failure: void 0 };
+			}
+
+			static getDerivedStateFromError(error) {
+				return { failure: String((error && error.message) || error) };
+			}
+
+			componentDidCatch(error) {
+				try {
+					console.error("dsh-plugin-deepseek-chat: panel render failed", error);
+				} catch {
+					/* console unavailable */
+				}
+			}
+
+			render() {
+				if (this.state.failure !== void 0) {
+					return react.createElement("div", { style: styles.root },
+						react.createElement("div", { style: styles.notice },
+							react.createElement("div", null, `${COPY.failed}: ${this.state.failure}`)));
+				}
+				return this.props.children ?? null;
+			}
+		}
+
+		/**
+		 * The global chat panel: a guest webview filling the main column.
+		 *
+		 * The guest is created only after the lease resolves, and it is mounted with
+		 * `name`/`partition`/`src` already set, because the main process inspects
+		 * exactly that bootstrap src when it approves the attachment. The first load
+		 * goes to the remembered conversation; navigation events keep that memory
+		 * current. A dead guest (crash, destroy, failed start) turns into a retry card
+		 * inside the panel; cleanup releases the lease and never calls into a detached
+		 * element.
+		 * @returns the panel element tree.
+		 */
+		function ChatPanel() {
+			const hostRef = react.useRef(null);
+			const lastUrlRef = react.useRef(void 0);
+			const [failure, setFailure] = react.useState(void 0);
+			const [loading, setLoading] = react.useState(true);
+			const [attempt, setAttempt] = react.useState(0);
+
+			const retry = react.useCallback(() => {
+				try {
+					setFailure(void 0);
+					setLoading(true);
+					setAttempt((value) => value + 1);
+				} catch {
+					/* the panel is gone */
+				}
+			}, []);
+
+			react.useEffect(() => {
+				const host = hostRef.current;
+				const bridge = globalThis.dshDesktop?.browser;
+				if (host === null) return;
+				if (bridge === void 0) {
+					try {
+						setFailure(COPY.unsupported);
+						setLoading(false);
+					} catch {
+						/* the panel is gone */
+					}
+					return;
+				}
+
+				let disposed = false;
+				let unsubscribeOpen;
+				let lease;
+				let watchdog;
+				const element = document.createElement("webview");
+				const initialTarget = rememberedTarget();
+				let restoring = initialTarget !== CHAT_URL;
+
+				Object.assign(element.style, styles.guest);
+				element.setAttribute("allowpopups", "");
+
+				/** Report a guest failure inside the panel; never throw. */
+				const fail = (error) => {
+					if (disposed) return;
+					try {
+						setLoading(false);
+						setFailure(String((error && error.message) || error));
+					} catch {
+						/* the panel is gone */
+					}
+				};
+
+				/** Remember the last document the guest reported. */
+				const remember = (raw) => {
+					if (raw === void 0) return;
+					lastUrlRef.current = raw;
+					rememberTarget(raw);
+				};
+
+				const onDomReady = () => {
+					if (disposed) return;
+					if (watchdog !== void 0) {
+						clearTimeout(watchdog);
+						watchdog = void 0;
+					}
+					if (!navigate(element, initialTarget)) fail(new Error(COPY.crashed));
+					else remember(initialTarget);
+				};
+				const onStopLoading = () => {
+					if (disposed) return;
+					const raw = readUrl(element);
+					if (raw === void 0) return;
+					remember(raw);
+					restoring = false;
+					try {
+						setLoading(false);
+					} catch {
+						/* the panel is gone */
+					}
+				};
+				const onNavigate = () => {
+					if (disposed) return;
+					remember(readUrl(element));
+				};
+				const onNavigateInPage = (event) => {
+					if (disposed || event?.isMainFrame !== true) return;
+					onNavigate();
+				};
+				const onFailLoad = (event) => {
+					if (disposed || event?.isMainFrame !== true) return;
+					// -3 is ERR_ABORTED: a superseded navigation, not a failure.
+					if (event.errorCode === -3) return;
+					if (restoring) {
+						// The remembered conversation is gone or unreachable; start clean.
+						restoring = false;
+						if (!navigate(element, CHAT_URL)) fail(new Error(COPY.crashed));
+						else remember(CHAT_URL);
+						return;
+					}
+					fail(`${event.errorDescription ?? event.errorCode}`);
+				};
+				/** The guest process exited or the guest was torn down underneath us. */
+				const onGuestGone = () => {
+					if (disposed) return;
+					fail(new Error(COPY.crashed));
+				};
+
+				const listeners = [
+					["dom-ready", onDomReady],
+					["did-stop-loading", onStopLoading],
+					["did-navigate", onNavigate],
+					["did-navigate-in-page", onNavigateInPage],
+					["did-fail-load", onFailLoad],
+					["render-process-gone", onGuestGone],
+					["destroyed", onGuestGone]
+				];
+
+				try {
+					for (const [name, handler] of listeners) {
+						element.addEventListener(name, handler, name === "dom-ready" ? { once: true } : void 0);
+					}
+				} catch (error) {
+					fail(error);
+				}
+
+				const start = async () => {
+					try {
+						const reservation = await bridge.acquire(PARTITION_KEY);
+						if (disposed) {
+							try {
+								Promise.resolve(bridge.release(reservation.lease)).catch(() => {});
+							} catch {
+								/* lease already gone */
+							}
+							return;
+						}
+						lease = reservation.lease;
+						element.setAttribute("name", reservation.lease);
+						element.setAttribute("partition", reservation.partition);
+						element.setAttribute("src", `about:blank#${reservation.lease}`);
+						try {
+							unsubscribeOpen = bridge.onOpenRequested(reservation.lease, (url) => {
+								if (!disposed && typeof url === "string") navigate(element, url);
+							});
+						} catch {
+							/* popup bridge unavailable: the guest still works */
+						}
+						host.append(element);
+						watchdog = setTimeout(() => {
+							watchdog = void 0;
+							if (disposed) return;
+							if (readUrl(element) === void 0) fail(new Error(COPY.timeout));
+						}, 15000);
+					} catch (error) {
+						fail(error);
+					}
+				};
+				void start();
+
+				return () => {
+					disposed = true;
+					// Read before removal: React cleans up after taking the DOM away, and
+					// Electron's getURL() throws on a detached webview.
+					remember(readUrl(element) ?? lastUrlRef.current);
+					if (watchdog !== void 0) {
+						clearTimeout(watchdog);
+						watchdog = void 0;
+					}
+					try {
+						if (typeof unsubscribeOpen === "function") unsubscribeOpen();
+					} catch {
+						/* already detached */
+					}
+					for (const [name, handler] of listeners) {
+						try {
+							element.removeEventListener(name, handler);
+						} catch {
+							/* already detached */
+						}
+					}
+					try {
+						element.remove();
+					} catch {
+						/* already detached */
+					}
+					const released = lease;
+					lease = void 0;
+					if (released !== void 0) {
+						try {
+							Promise.resolve(bridge.release(released)).catch(() => {});
+						} catch {
+							/* lease already gone */
+						}
+					}
+				};
+			}, [attempt]);
+
+			return react.createElement("div", { style: styles.root },
+				react.createElement("div", { style: styles.host, ref: hostRef },
+					failure === void 0 && loading
+						? react.createElement("div", { style: styles.notice }, COPY.loading)
+						: null,
+					failure === void 0
+						? null
+						: react.createElement("div", { style: styles.notice },
+							react.createElement("div", null, `${COPY.failed}: ${failure}`),
+							react.createElement("button", { type: "button", style: styles.button, onClick: retry }, COPY.retry))));
+		}
+
+		/** The registered panel: the boundary owns every rendering failure below it. */
+		function ChatPanelShell() {
+			return react.createElement(PanelBoundary, null, react.createElement(ChatPanel));
+		}
+
+		/** Client service this plugin reads; the loader waits for the slot registry. */
+		const inject = ["slots"];
+
+		/**
+		 * Register the left-sidebar entry and its main panel.
+		 * @param ctx - client plugin context.
+		 */
+		function apply(ctx) {
+			try {
+				// The panel needs the desktop guest bridge; on the Web surface an iframe
+				// cannot carry the site, so the plugin stays inert there.
+				if (globalThis.dshDesktop?.browser === void 0) return;
+
+				ctx.slots.inject("main", () => ctx.slots.register({
+					name: "main",
+					key: PANEL_ID
+				}, ChatPanelShell));
+
+				ctx.slots.inject("sidebar.panellist", () => ctx.slots.register({
+					name: "sidebar.panellist",
+					id: PANEL_ID,
+					order: 5,
+					label: () => COPY.label
+				}, ChatGlyph));
+			} catch (error) {
+				try {
+					console.error("dsh-plugin-deepseek-chat: registration failed", error);
+				} catch {
+					/* console unavailable */
+				}
+			}
+		}
+
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,9 @@
+/**
+ * Host half of dsh-plugin-deepseek-chat.
+ *
+ * The feature is browser-surface only: the right Sidebar guide card and the
+ * redirect into the built-in Browser tab both live in ./client.js. This half
+ * exists because the package is mounted as an ordinary Loader entry, and a
+ * client bundle is discovered through its entry.
+ */
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DeepSeek Chat",
+    "description": "Adds a chat.deepseek.com panel to the sidebar: full main-area chat with last-conversation memory."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "DeepSeek 聊天",
+    "description": "在左侧栏加入 chat.deepseek.com 聊天面板，占满主内容区并记住上次会话。"
+  }
+}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@tianyulinfeng1/dsh-plugin-deepseek-chat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "DeepSeek Chat (chat.deepseek.com) as a DSH sidebar panel: full main-area chat, last-conversation memory, and crash containment.",
+  "type": "module",
+  "main": "lib/index.js",
+  "icon": "./icon.svg",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "locale",
+    "icon.svg",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node test/check-client.mjs"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh-plugin",
+    "deepseek",
+    "chat",
+    "webview"
+  ],
+  "author": "sweet560",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sweet560/dsh-plugin-deepseek-chat.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sweet560/dsh-plugin-deepseek-chat/issues"
+  },
+  "homepage": "https://github.com/sweet560/dsh-plugin-deepseek-chat#readme",
+  "engines": {
+    "node": ">=20",
+    "dsh": ">=0.2.1-rc.2"
+  },
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
+    }
+  }
+}