✨ v2.1.0 体验优化专项（6 项）

1. 首次启动三步引导：工作文件夹 → 环境检测/一键安装 → API Key 配置并测试；修复首次白屏，完成引导自动拉起服务；
2. 上传下载智能同步：A/B 电脑按「文件修改时间 vs 远端提交时间」比对（谁新谁赢），预览面板（上传/下载/跳过/冲突 + 勾选）、冲突三选一（保留本地/使用远程）、同步模式/时间容差/排除规则/自动同步；
3. 环境一键安装 + 打包内置便携环境：缺失项旁一键安装；Node/Git/pnpm/dsh 便携环境打包进应用（离线优先、sha256 版本锁定），未内置自动回退网络；
4. 版本更新提示与下载加速：右下角非阻断通知（[立即更新][稍后提醒][查看日志]）+ 进度窗口；下载升级为 4 线程分片 + 断点续传 + 镜像测速 + SHA256 校验（发布侧随包上传 SHA256SUMS）；
5. 工作文件夹设置与数据迁移：设置 → 通用 → 工作文件夹（当前路径 + 更改位置并迁移）；原子迁移（流式复制 → 完整性校验 → 切换 → 旧目录备份 → 失败回滚）；
6. 会话背景自定义：设置 → 外观 → 会话背景（跟随主题 / 纯色 / 8 组渐变 / 上传图片自动压缩 ≤2K）+ 填充/透明度/模糊调整，仅作用于对话区域。

🛡️ v2.1.2 ~ v2.1.5 加固与修复

1. 便携环境真正内置（三级解析）：内置环境为解压目录形态（resources/portable-env/node|git|pnpm|dsh-cli/）随包分发；新增 env-resolver 三级优先级（内置 → 工作区 → 系统），环境检测显示 [内置]/[工作区]/[系统] 来源标签；缺失项一键安装自动启用内置环境（[启用内置环境] 按钮），npm/pnpm/dsh 安装前自动确保便携 Node；
2. EXE 命名 ASCII 化：productName/executableName 改为 DSH-Desktop（修复中文名导致 exe 文件名乱码）；构建后自动校验（verify-build.mjs：exe 名正则 + 内置环境完整性 + VC 运行库 + feature-registry）；
3. 首次引导可跳过：三步引导每步底部「跳过引导」，确认后直接进入主界面（环境与 Key 可稍后配置）；
4. Win10 LTSC 精简系统兼容：内置 VC++ 运行库 DLL（vcruntime140 等）随包分发，node.exe 免系统安装即可运行；
5. API Key 保存即同步：保存 Key 自动启用厂商 + 补齐默认模型 → 实时同步 dsh 模型选择器与凭据，不再反复弹「输入 API Key」；
6. 设置 → 高级 → 日志卡片：查看应用/dsh 服务日志、一键导出 zip、清空，排查问题直接附上；
7. 服务端口配置 hover 提示：自动探测 / 固定端口悬停说明；
8. 版本更新保护机制：feature-registry.json 功能注册表 + 更新包安装前冒烟测试（失败中止更新）+ 替换后二次校验失败自动回滚 + logs/update-report.md 更新留档。

📸 先看一眼

主界面（内嵌 dsh 对话）	会话管理（便签卡片）
Agent 管理（GitHub 导入）	知识库（提炼 / 检索 / 迭代）
Skill 管理（插件 / 技能市场）	设置（子菜单布局）
高级配置（环境 / 备份 / 同步 / 一键更新）

✨ 为什么值得下载

🟢 一个文件夹 = 你的整个工作台

• 绿色免安装：Node / npm / pnpm / Git / dsh 全部内置，双击即用，不写注册表、不污染 %APPDATA%；
• 拷贝即迁移：整个文件夹拷到任意 Win10/Win11 电脑继续用 —— 对话、技能、插件、模型配置原样带过去；
• dsh 版本升级无忧：客户端动态解析 dsh 启动入口、通用配置同步，dsh 升级后照常使用。

🛰️ 赛博朋克工作台 + 全局换肤

• 自定义无边框标题栏、霓虹流光导航栏、玻璃拟态面板、Canvas 粒子欢迎页、底部状态栏（端口 / 地址 / 状态灯 / 一键启停）；
• 主题插件全局化：主题插件（tokens.json + theme.css）作用于整个客户端——标题栏、侧边栏、工作台、弹窗、设置、托盘图标全部跟随；内置示例主题「霓虹粉」，切换即时生效。

🌐 全域模型对接中心

• 14 家预设厂商（OpenAI / Anthropic / Gemini / Grok / Mistral + DeepSeek / 千问 / 智谱 / Kimi / 文心 / 混元 / 星火 / MiniMax + Ollama 本地）+ 自定义 OpenAI 兼容端点（OpenRouter / SiliconFlow / One API…）；
• API Key 强制加密（Electron safeStorage），界面掩码显示，明文永不落盘；
• 连接测试（含延迟/失败原因）、拉取模型列表、三类默认模型（对话 / 提炼降本 / Embedding）；
• 配置模型自动同步 dsh —— dsh 对话内模型选择器直接可选你配置的大模型。

💬 开箱即聊

• 内嵌真实 DeepSeek Harness Web 界面直接对话，首次启动无引导打扰；
• API Key 统一在桌面端「模型与 API」配置，保存即热重载生效。

🧩 六大功能模块

1. 核心工作台：内嵌 dsh 对话 + 会话导入（文件夹/文件）+ 「提炼会话」一键智能提炼（六步 Skill 流水线：蒸馏 → 代码萃取 → 向量化 → 去重合并 → 归档 → 反馈，进度实时展示）；
2. 会话管理：便签式分组卡片，会话重命名 / 收藏 / 移动 / 导出 / 删除；
3. Agent 管理：GitHub URL 导入 Agent 项目，运行与多 Agent 协同；
4. 知识库：从会话提炼碎片化知识（自动时间戳 + 关键词标签），关键词检索、合并去重迭代；
5. Skill 管理：插件 / 技能双市场，联网搜索安装、🔥 前 10 推荐、已安装双列管理；
6. 设置：通用（语言 / Agent 预设）、模型与 API（全域对接中心）、外观（主题 / 明暗）、快捷键、关于、高级配置（环境 / 服务 / 备份 / 同步）、全局行为规则（永久指令可视化编辑）。

🛟 数据安全与运维

• 一键备份 / 自动备份（每天每周 + 滚动保留）/ 恢复 / 出厂重置；
• A/B 电脑 Git 异地同步（技能 / 插件 / 知识 / 会话全量镜像，凭据除外）；
• 环境检测一键更新 Node / Git / pnpm / dsh；应用内自动 / 手动更新。

🧩 功能总览

快捷键：Ctrl+B 收起/展开侧边栏 · Ctrl+N 新建对话 · Ctrl+, 打开设置

🚀 快速上手

方式一：直接下载绿色版（推荐）

DSH-Desktop/
├── app/                  ← 程序本体（app\DSH-Desktop.exe）
├── workspace/            ← 工作文件夹（运行环境 + 全部数据，随文件夹拷走）
│   ├── runtime/          ← 便携 Node / npm / pnpm / Git / dsh
│   ├── data/             ← 对话记录、设置、凭据、profiles
│   ├── skills/           ← 技能
│   ├── themes/           ← 主题插件
│   ├── backups/          ← 备份
│   └── logs/             ← 日志（含 update-report.md 更新留档）
└── 启动 DSH 桌面.bat     ← 双击启动

1. 解压后双击「启动 DSH 桌面.bat」；
2. 底部状态栏点「启动服务」，自动拉起 dsh（端口被占自动顺延）；
3. 「设置 → 模型与 API」填 DeepSeek（或其他厂商）API Key → 测试连接 → 勾选模型 → 设默认对话模型；
4. 到「核心工作台」直接对话（dsh 内可切换模型），聊完点「提炼会话」沉淀到知识库。

💡 换机：整个文件夹拷过去即可，无需重新安装任何东西。

方式二：从源码构建

# 环境要求：Node.js ≥ 18（实测 v24 正常）
npm install
npm run dev          # 开发模式（热更新）
npm test             # 单元测试（255 项）
npm run prepare:env  # 下载并解压打包内置便携环境（Node/Git/pnpm/dsh 目录 + env-manifest.json）
npm run pack:dir     # 打包为绿色目录（构建 + verify-build 校验，输出到 ../DSH-Desktop/app）
node scripts/release.mjs   # 生成更新包 zip + SHA256SUMS

推送 vX.Y.Z tag 即触发 GitHub Actions 自动构建发布（typecheck + 单测 + 打包 + 生成更新包 + 创建 Release 上传资产）。

🧭 技术栈

src/
├── main/       主进程：dsh 服务 / 会话 / 知识库 / Agent / 插件 / 技能市场 /
│               模型中心（厂商注册表 + 适配器 + 加密存储）/ 主题 / 备份 / 同步 /
│               更新 / 迁移 / 窗口 / 托盘 / IPC / 全局规则
├── preload/    安全白名单 API（contextBridge）
├── renderer/   React 19 界面
│   └── src/
│       ├── components/layout/   TitleBar / Sidebar / Footer
│       ├── components/views/    6 大模块视图 + settings 子页
│       ├── components/ui/       shadcn 风格组件（button/card/dialog/tabs/…）
│       ├── hooks/               useDshService / useTheme
│       └── lib/                 主题注入 / cn / appInfo
└── shared/     主进程与渲染层共享的类型与纯逻辑

❓ 常见问题

SmartScreen 提示「已保护你的电脑」？
未签名应用的正常提示：点「更多信息 → 仍要运行」即可。程序不联网上传任何数据。

杀毒软件误报？
便携应用偶发误报，将整个文件夹加入白名单即可。

端口被占用？
dsh 默认 3080，应用自动探测并在占用时自动顺延；也可在「设置 → 高级配置 → 服务与运行」固定端口。

Win10 LTSC / 精简系统无法启动服务？
v2.1.5 起内置 Node 已随包携带 VC++ 运行库 DLL（vcruntime140 等），无需系统安装；若仍异常，到「设置 → 高级配置 → 日志」导出日志排查，或查看 工作文件夹\logs\dsh.log。

模型选择器里没有模型？
到「设置 → 模型与 API」启用厂商、勾选模型（模型为空会自动用该厂商预设默认补齐），保存 Key 即自动启用厂商并同步 dsh（无需手动启用）。

更新失败会损坏当前版本吗？
不会。更新包安装前会执行冒烟测试（exe/内置环境/asar 完整性），失败自动中止；替换后二次校验，失败自动回滚到旧版本，logs/update-report.md 留档。

如何安装主题插件？
将主题插件目录（含 theme-plugin.json / tokens.json / theme.css）放入工作文件夹 themes/ 下，重启后在「设置 → 外观」选择。

dsh 升级后客户端异常？
客户端动态解析 dsh 启动入口、配置同步采用 dsh 标准结构且不覆盖已有配置；升级后如仍异常，在「高级配置 → 环境检测」一键更新 dsh 即可。

🗺️ 里程碑

📄 许可证

MIT © 2026 DSH 桌面

本应用与 DeepSeek Harness（MIT）均为开源项目，可自由使用、修改与分发。