🦎 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 本体（运行时）

npm install -g @deepseek-ai/dsh

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

2. 装客户端

# 获取源码
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）

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