dsh-chameleon (bundle)

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# 🦎 dsh-chameleon

**自修改桌面工作台** —— DeepSeek Harness (DSH) 的独立桌面客户端：完整 dsh web 功能 + 编辑模式（agent 边对话边改工作台，免重启热更新）。

> ⚠️ **编辑模式为半成品**（实验性）：当前可改补丁层/插件并热更新，但 HMR 链路、工具集覆盖面与组合层变更仍有已知缺口（详见 `docs/DEVELOPMENT.md`），请勿在生产会话中依赖。

## 功能介绍

| 类别 | 说明 |
|---|---|
| 🖥️ 独立客户端 | 双击即启动（3998 端口）；独立 `DSH_HOME`（`~/.dsh-chameleon`），与 web 完全隔离、可同时运行 |
| 🚀 长上下文流畅 | 消息列表渐进渲染 + 后台不节流 + zstd 本地回放，40 万 token 会话流畅滚动 |
| 🎨 UI 微调 | 无边框窗口 + 原生控件；智能拖拽区（样式表规则，重渲染不丢）；会话日志按钮自动避让 |
| ✏️ 编辑模式 | `selfedit` 预设：改补丁层/插件/UI 实时生效，编辑历史与回滚、`workbench_*` 工具集（**半成品**） |
| 🗑️ 会话删除（可选插件） | 头部按钮 + 侧栏菜单项（不跳转），弹框显示会话名与序列号；运行中可删（先停再删）；删除后原地刷新不重载。一行安装：`dsh plugin add github:lsz-asd/dsh-plugin-session-delete` |
| 🔌 插件生态 | 完整继承官方 dsh web 插件面（工具 / 会话 / 审批 / UI 等 130+ 组合行）+ 自研 workbench 插件 ×3；设备信息（12 个 `win_*` 工具）、sleep、会话健康等常用插件一行 `dsh plugin add` 按需安装 |

## 安装说明

**只需装两样东西：dsh 本体（运行时）+ 我们的客户端。** 除此之外不需要任何大依赖——不需要 pnpm、不需要单独的 Harness 源码；客户端**不内置**（更不会重复安装）运行时，保持轻量。

### 1. 装 dsh 本体（运行时）

```sh
npm install -g @deepseek-ai/dsh
```

需要 **Node.js ≥ 20**（建议 24）：https://nodejs.org

### 2. 装客户端

```sh
# 获取源码
git clone https://github.com/lsz-asd/dsh-chameleon.git
cd dsh-chameleon/apps/desktop

# 安装客户端（Electron 壳 + 几 KB 客户端代码，npm 或 pnpm 皆可）
npm install        # 或 pnpm install

# 启动（Windows 双击快捷方式，或）
npm start
```

首次启动自动创建独立 home（`~/.dsh-chameleon`）、写入 chameleon profile，并把客户端的 4 个小包复制进 Harness 的模块回退目录——**没有任何包管理器安装**，几秒完成；之后秒开。

> 客户端**复用你已装的 dsh 本体**：优先用全局安装（`npm i -g` 的位置），其次 PATH，最后才是本地副本——不会重复下载数百 MB 的 Harness。

### 可选：打包为安装程序（Windows）

```sh
cd apps/desktop
npm run dist    # electron-builder 生成 NSIS 安装器（dist/ 目录）
```

### 插件安装（可选，任意 profile）

```sh
dsh plugin --profile  add github:lsz-asd/dsh-plugin-session-delete   # 会话删除
dsh plugin --profile  add github:lsz-asd/dsh-plugin-device-info      # 设备信息（12 个 win_* 工具）
```

重启 profile 生效。

> **插件管理是唯一需要 pnpm 的路径**（`dsh plugin` 内部转发 pnpm）：`npm install -g pnpm`。客户端基线完全不需要。

## 更新计划

- [ ] **编辑模式完善**：HMR 链路加固、工具集补全（组合层变更热生效）
- [ ] **Windows 安装包**：发布 NSIS 安装器（`npm run dist` 产物上架 Release；**不内置 dsh 运行时**，复用系统 dsh 本体，客户端保持轻量）
- [ ] **会话删除增强**：fork 级联删除、删除事件总线广播（替代 reload）
- [ ] **插件市场页**：客户端内浏览/安装发布插件（对接 `dsh plugin`）
- [ ] **会话迁移工具**：跨 home 导入/导出会话

## 结构

```
apps/desktop/    Electron 壳（自举独立 home + Chrome 注入）
packages/        workbench-core / workbench-ui / workbench-runtime
bundle/          补丁装配层
presets/selfedit 编辑模式预设
scripts/         自举与验证脚本
```

## 版本历史

### v0.3.0 · 2026-08-14

- **轻量安装重构**：客户端不再内置 `@deepseek-ai/dsh`（依赖树由 ~646MB 降至纯 Electron 壳），改为**复用系统 dsh 本体**（全局安装 → PATH → 本地副本）
- **基线零 pnpm**：profile 自举不再跑 `pnpm install`——客户端把自己的 4 个小包（bundle + workbench ×3）同步进 Harness 的扁平模块回退目录，随装随走；pnpm 仅剩「可选插件管理」一条路径
- **bundle 瘦身**：移除指向本机绝对路径的 `@huanlin/dsh-plugin-session-delete` 依赖与补丁行（已独立成仓，按需 `dsh plugin add` 安装）
- **升级迁移**：旧 pnpm 流程装出的 profile 自动归一化（清掉 `file:` 依赖与陈旧 `@dsh-external` 副本）
- 客户端首次自举即向独立 home 播种编辑模式预设

### v0.2.0 · 2026-08-14

- 会话删除重构：侧栏 "..." 菜单项**不跳转对话**，直接弹出确认框
- 弹框显示**会话名称与序列号**；运行中的会话显示警告（"删除会立即停止其任务…"）但仍可删除
- **当前会话可直接删除**；删除运行中会话时 host 先停止 agent（cancel + 等待静止）再清理
- 删除后**原地刷新列表**（不重载页面），并从内存 store 摘除会话（修复"已删会话残留在未分组"）
- 侧栏菜单按客户端列表匹配会话（修复 fork 后缀等标题差异导致的"点了没反应"）

### v0.1.0 · 2026-08-14

- 首个发布版：独立客户端（独立 home、双击启动、免重启热更新）
- 会话删除插件（当时随 bundle 分发：头部按钮 + 侧栏菜单项 + 风险确认 + 端到端清理）
- 编辑模式（selfedit 预设 + workbench 工具集 + 3 个编辑技能）