Skip to content

A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.

Design one location, a recommended drive and one-copy disk use for the onboarding

AdamPlatin123aff677728134
diff --git a/docs/plans/2026-10-16-desktop-app.md b/docs/plans/2026-10-16-desktop-app.md
index f45b98cd..f68ec666 100644
--- a/docs/plans/2026-10-16-desktop-app.md
+++ b/docs/plans/2026-10-16-desktop-app.md
@@ -56,7 +56,7 @@
- 首次启动分别选数据位置(默认 `~/.ds-bot`)和总工作区(默认 `~/DeepSeek Bot`),以后能在设置里改(见下面「改位置」)。两个位置不能一个在另一个里面,也不能在用户 DSH 的数据里。用的是系统对话框。
- 发现用户 DSH 里已有团队时,问要不要导入,只在首次启动问一次。导入复制 Bot、群、记忆、会话、附件、模型设置和密钥,旧位置一个字节都不改。导入以后两个团队各走各的,不同步。
- DSH 正在用这个团队时,请用户先关掉。「正在用」和插件的 home-lock 同一个规则:锁在 60 秒内刷新过,且同一台机器上锁里的进程还活着(Windows 会重用进程号,只看进程号会把旧锁当成活的)。
- - 目标里已经有 `.credentials.yaml` 或 `.env` 时不覆盖,导入结果里记成「保留」。复制用的暂存文件夹不论成功、失败还是中途退出都会删掉。
+ - 目标里已经有 `.credentials.yaml` 或 `.env` 时不覆盖,导入结果里记成「保留」;只含引擎自己写的 `client-connection/` 记录的 `.credentials.yaml` 不算用户的,照常换成旧的。复制用的暂存文件夹不论成功、失败还是中途退出都会删掉。
- 引擎先在新数据位置启动一次再复制,这样 DSH 不会把旧团队的文件夹当成自己的项目。
- 旧团队工作文件夹里的文件复制到新的总工作区,不覆盖已有的文件。
- 模型设置只取 profile 里模型的那几行(DeepSeek API 和账号、其他服务商、默认模型、预设)。几个 profile 都有时让用户选一份。DSH 里另外配的 MCP、技能和 DSH Agent 不导入。
diff --git a/docs/plans/2026-10-26-start-window.md b/docs/plans/2026-10-26-start-window.md
new file mode 100644
index 00000000..5dd705e3
--- /dev/null
+++ b/docs/plans/2026-10-26-start-window.md
@@ -0,0 +1,335 @@
+# 启动窗口:领航鲸
+
+- 日期:2026-10-26
+- 相关:[Windows 上手流程](2026-10-26-windows-onboarding.md) 第 3、4、8 节,#559
+- 一起改:[Windows 上手流程](2026-10-26-windows-onboarding.md)(第 3 节、第 8 节、「改动的已定设计」、验收)、[桌面应用](2026-10-16-desktop-app.md)(结构、窗口)、[UI 标准](../design/ui-standard.md)(3.1、4.4、8.3、12、14)
+- 代码:新的 `app/src/start/`(`start.html`、`start.css`、`start.js`、`whale.js`、`text.mjs`)、`app/src/start-window.mjs`、`app/src/start-frame.mjs`、`app/scripts/start-assets.mjs`;`app/src/main.mjs`、`preload.cjs`、`window-frame.mjs`
+
+## 为什么
+
+- 引擎第一次启动要 3 到 20 秒,以后要 3 到 12 秒。第 3 节定了这段时间显示什么(真实阶段、说明、卡片、恢复页),没定它怎么动。
+- 主 Bot 的鲸鱼是 DS Bot 自己生成的形象,用户进团队后第一眼看到的也是它。启动时让它替用户「干活」,用户进门前就认识了它,也先见过它的状态动作。
+- 等待只取这些原则:
+ - 有事做、有解释的等待显得短(Maister)。
+ - 看得见真实的工作更让人放心,假进度适得其反(Buell 和 Norton;Harrison 等)。
+ - 1 秒内不显示进度;超过 10 秒,要看得见进度和出路(NN/g)。
+ - 入场不超过 1 秒,不为动画推迟启动(Android 启动画面)。
+ - 天天看的画面动得越少越好(Kowalski)。
+- 启动页是本地文件,引擎的页面在 `http://127.0.0.1`,两者跨源。同一个窗口里 `loadURL` 时,Chromium 不保留旧画面,也做不了跨文档过渡;不改 DSH 就接不上。窗口会先空一下,再露出 DSH 自己的加载过程,「打开团队」这一步用户其实看不到。
+- 所以启动页放进单独的小窗口,团队界面在隐藏的主窗口里加载,挂载好了才露面。小窗口一直有 Mica,交接时没有空白帧。
+
+## 已定的行为
+
+### 1. 两个窗口(待定)
+
+- 每次启动先出来**启动窗口**:
+ - 内容区 720 × 540;显示器工作区不到 588 高时为 720 × 500。
+ - 不能缩放、最大化和全屏,只有最小化和关闭两个系统按钮。
+ - 无边框,40 px 的标题带可以拖动,里面什么都不放。
+ - Windows 11 22H2 及以后用 Mica。
+ - 在光标所在的显示器上居中。
+- 启动窗口从不改大小。首次启动、以后的启动、卡片、失败页都在这一个尺寸里。
+- **主窗口**照旧 1320 × 860:
+ - 启动窗口第一次画好以后,主窗口隐藏着建好。
+ - 引擎起来后,在里面加载引擎的本机地址(同一个地址和端口)。例外:导入卡开着、用户还没回答时不加载(插件一收到 `state` 就会建出空白团队),等回答以后、〔复制过来〕的第一段复制完以后才加载。
+ - `dsBotApp.ready()` 之后才显示,启动窗口随后关掉。
+- 交接前关掉启动窗口(× 或 Alt+F4)就退出应用,走现在的退出流程:停引擎,正在复制的就停下。
+- 交接前再双击图标,恢复并聚焦启动窗口;交接后聚焦主窗口。
+- 首次启动的选择框和提示都挂在启动窗口上。选择框从不自己弹出,只在用户点了选文件夹的按钮或链接之后出现。
+- 换位置时(〔移到…〕,今天的 `notePage(t.moving)`),主窗口先隐藏,启动窗口按「以后的启动」的样子显示「正在搬 DeepSeek Bot 的数据…」(同一个卷上只是改名,这一页一闪而过)。任务栏进度照旧,搬完照旧重开;工作文件在重开后由应用后台复制,不经过启动窗口。
+
+### 2. 布局
+
+首次启动的布局(坐标是内容区里的 DIP):
+
+| 部分 | 位置 | 内容 |
+|---|---|---|
+| 标题带 | y 0–40 | 空,可以拖动 |
+| 标题行 | y 52–72 | 左:标题,15/20、600;右(对齐 x 672):已用秒数,13/18,等宽数字,宽度固定 |
+| 水道 | x 48–672,y 76–180 | 88 px 的鲸鱼;下边缘是水线,鲸鱼越过它的部分被裁掉 |
+| 三站 | 在水线上,x 168 / 360 / 552 | 16 px 标记;站与站之间一条 1 px 的 `--bt-line-2` 细线,就是画出来的水线;标记下面是阶段名,13/18 |
+| 提示行 | y 220–248,居中 | 10 秒、45 秒的提示和〔打开日志文件夹〕 |
+| 纸面 | x 48–672,y 260–496 | 说明,或者卡片 |
+| 底注 | x 48,y 504–522 | 「社区开源项目,不是 DeepSeek 官方产品」,13/18 |
+
+- 标记的四种样子:
+ - 没开始:一圈细线。
+ - 进行中:`--bt-ink` 圈加 6 px 实心点。
+ - 完成:`--bt-green` 圆底对勾。
+ - 失败:`--bt-danger` 圆底叉。
+- 阶段名:完成和进行中用 `--bt-ink`,进行中带流光;没开始用 `--bt-ink-2`。
+- 说明直接写在 Mica 上。
+- 卡片是不透明的 `--bt-card`:1 px `--bt-line` 边,圆角 12,内边距 16 × 20。卡片正文比纸面高时,正文在卡片里滚动,按钮行固定在卡片底部。
+- 以后的启动:
+ - 没有标题行、三站、说明和底注。
+ - 64 px 的鲸鱼在 x 360,下面一行字(15/20、600,居中)。整组下移 80 px,落在窗口的视觉中心。
+ - 要出卡片时,整组用 `SPRING_SHAPE` 上移回原位,卡片出现在下面的纸面里。
+
+### 3. 鲸鱼的总规则
+
+- 只为真实的事动:阶段开始和完成、出卡片、失败、就绪,以及用户的指针和点击。
+- 鲸鱼面朝右。主进程报告一个阶段完成时,它向右游到下一站:不会提前,也从不往回游。
+- 等用户回答时静止。等得越久动得越慢,从不变快。
+- 换动作时从当前姿势接着走:读出当前的 `transform`,停掉循环,再用弹簧走到下一个动作的起点。不跳回原位。
+- 一个阶段等满 250 ms 才显示「进行中」;更快完成的阶段直接打勾。
+- 循环状态出现后至少停 400 ms;失败和交接不等。
+- 游动排队:前一段游完才游下一段,排着的那段不再下蹲。排队不会让交接晚超过 600 ms。
+- 大动作只放在 SVG 外面的 HTML 包层上,用 `translate`、`rotate`、`scale`、`transform`,交给合成线程。SVG 里只动眼睛和尾巴。
+- 循环用 CSS 动画,按 `html` 上的状态属性选。一次性动作用 WAAPI,结束时 `commitStyles()` 再 `cancel()`。
+- 每段一次性动作带序号,新状态到了就丢掉旧的。等动画结束的地方都配一个计时器兜底,因为最小化的窗口不走动画。
+- 弹簧只用 `motion.js` 的常量。头像动作的关键帧沿用插件的写法(`styles.js` 的 `bt-hop`、`bt-bob` 等),换算成像素。
+
+| 时刻 | 鲸鱼 | 时长和曲线 |
+|---|---|---|
+| 首次启动入场 | 从水线下浮上来,12° 的倾斜回正;尾巴甩一下;睁眼 | `SPRING_STRETCH` 560 ms;睁眼 160 ms |
+| 准备数据文件夹 | 搜索:前倾探头,眼睛左右扫 | 1 s;眼睛 1.6 s |
+| 一个阶段完成 | 下蹲 120 ms,向右滑 192 px,尾巴划两下,眼睛晚 80 ms 跟上;身后的标记弹出对勾;到站点一下头 | `SPRING_SHAPE` 420 ms;对勾 `SPRING_POP` |
+| 启动本机引擎 | 工作:上下晃、尾巴摆、眨眼 | 1.6 s、1.1 s、2.4 s;52.8 s 内不完全重复 |
+| 10 秒 | 看向用户 600 ms,慢眨一次眼;所有循环放慢到 0.85 倍 | — |
+| 45 秒 | 换成思考:歪头慢慢起伏、眯眼;尾巴停下 | 2.2 s;换动作用 `SPRING_SHAPE` |
+| 打开团队 | 发消息:向前冲,每冲一次尾巴划两下 | 1.1 s |
+| 应用主动问(卡片、180 秒) | 跳两下,然后静止,看着卡片 | 1.3 s × 2 |
+| 用户自己引出的卡片 | 不跳,静止 | — |
+| 失败 | 从当前姿势下沉 4 px、低头 4°,眼皮变重,然后完全静止 | `SPRING_SHAPE` |
+| 就绪(首次启动,或重试后第一次成功) | 压扁再拉长,「^ ^」眼;拉到最长时潜下水线 | 460 ms 加 `SPRING_SHAPE` |
+| 就绪(以后的启动) | 直接潜下去 | `SPRING_TAP` 290 ms |
+
+- 动画三档用团队里设的那一档:主窗口的页面报告给应用,应用记在自己的 userData 里,下次启动时用。没有记录时(首次启动)按「正常」。
+ - 安静:只有上表的状态动作。没有眼睛跟随、点击转圈、抚摸、尾巴、点头、看向用户、涟漪和「^ ^」眼。
+ - 正常:加上眼睛跟随指针、尾巴、点头、看向用户、涟漪、「^ ^」眼。首次启动等待时,点鲸鱼它会转一圈;等用户回答时可以抚摸(UI 标准 8.5)。
+ - 活泼:再加上等用户回答时一直跳(8.4)。
+- 涟漪是一个 56 × 12 的细线椭圆,只在首次启动出现两次:浮上来和潜下去的地方。以后的启动没有涟漪。
+- 鲸鱼对读屏隐藏(`aria-hidden`)。进度由三站的文字、`aria-current="step"` 和礼貌朗读区说出来:「{阶段}:进行中」「{阶段}:已完成」。
+
+### 4. 首次启动,逐拍
+
+时间从页面拿到 `?start=first` 的那一帧算起。
+
+1. 入场:
+ - 0 ms,鲸鱼在第 1 站从水线下浮上来。
+ - 120 ms,涟漪。
+ - 160 ms,标题淡入。
+ - 220 / 270 / 320 ms,三站从左到右淡入。
+ - 360 ms,睁眼。
+ - 420 ms,底注淡入。
+ - 560 ms,到位。
+ 入场全是 CSS,不等脚本。入场时来的卡片和就绪,等它到位再处理。
+2. 到 560 ms「准备数据文件夹」还没完成、并且已经等了 250 ms,第 1 站才显示进行中,鲸鱼搜索。已经完成的话,直接游到第 2 站。
+3. 600 ms 起,说明逐段出现:
+ - 每段用 `bt-veil-in`,.22 s,段与段隔 0.8 s。
+ - 每段从第一帧起就排在最终位置,只是透明度为 0。出现时旁边什么都不动。
+ - 交接时还没出现的段落,不再出现。
+ - 各段的文字:
+ - 「DeepSeek Bot 是一支替你干活的 Bot 团队:你告诉主 Bot 要做什么,它安排其他 Bot 一起完成。」(14/22,`--bt-ink`)
+ - 没有要导入的团队、数据文件夹里也没有团队时:「下一步:接上一个模型。推荐用 DeepSeek 账号登录(没有账号可以用手机号注册),也可以粘贴 DeepSeek API Key。DeepSeek 按用量收费。」(14/22,`--bt-ink-2`)。要导入时,这一段从第一帧起就不占位置。
+ - 「聊天和设置保存在这台电脑上(对话内容会发给你选的模型服务)。」(13/18,`--bt-ink-2`)
+ - 「数据保存在 `C:\Users\<用户名>\.ds-bot`,Bot 默认在 `C:\Users\<用户名>\DeepSeek Bot` 里工作。都可以在 设置 → 通用 → 位置 里改。」(13/18,路径用等宽字体)
+ - 第 3 站开始、而且 DSH 会挂出「预览版说明」时:「接下来会先显示 DeepSeek Harness 的「预览版说明」。DeepSeek Bot 建在 DeepSeek Harness 上,点「继续」就行。」(14/22,`--bt-ink`)
+4. 「启动本机引擎」:鲸鱼在第 2 站工作。5 秒起,标题行右边显示「已用 N 秒」,每秒改一次,数字不滚动。没有百分比。
+5. 10 秒:提示行出现「第一次启动会慢一些,Windows 可能在检查刚装好的文件。」鲸鱼看向用户一次,循环放慢。第 2 站完成时,这行字淡出。
+6. 45 秒:提示换成「比平时慢,可能是杀毒软件在检查新文件,请再等一会儿。」,90 ms 后行尾出现 28 px 的〔打开日志文件夹〕。鲸鱼改成思考。
+7. 180 秒:见第 6 节。
+8. 引擎起来:主进程在隐藏的主窗口里加载引擎的页面,开始 20 秒的就绪检查。鲸鱼游到第 3 站,改成发消息。导入卡开着、还没回答时只给第 2 站打勾:不加载页面、不游到第 3 站、不开始 20 秒检查,三件事都等回答以后(〔复制过来〕的等第一段复制完)。
+9. `dsBotApp.ready()`:见第 8 节。
+
+- 卡片等用户回答时,已用秒数暂停并隐藏,回答后接着走。10 秒、45 秒和 180 秒都按这个时钟算:用户自己想了多久,不算在引擎头上。
+
+### 5. 以后的启动
+
+- 0 ms:64 px 的鲸鱼在窗口中间浮上来(`SPRING_TAP` 290 ms),不倾斜,眼睛睁着,没有涟漪。60 ms 后,「正在打开你的团队…」淡入。
+- 前 1 秒什么都不再动。1 秒后鲸鱼开始工作(只上下晃和眨眼),那行字带流光。
+- 10 秒起,下面显示「已用 N 秒」。
+- 45 秒:「比平时慢,请再等一会儿。」〔打开日志文件夹〕。
+- 180 秒:和首次启动一样。
+- 就绪时没有庆祝:字淡出 .16 s,鲸鱼从当前姿势潜下去;120 ms 后主窗口显示。
+- `DS_BOT_HOME` 的一次性运行用这一套,只是不出卡片。
+
+### 6. 卡片、180 秒和导入
+
+- 所有卡片用同一套变形:
+ - 出现:说明淡出 .16 s;卡片的底色和边线两层从 0 高长到内容的高度(`clip-path`,走 `SPRING_SHAPE`;底色 .22 s 淡入);内容先按最终尺寸排好,晚 70 ms 淡入;焦点移到主按钮。
+ - 回答后:内容 .16 s 退场(下沉 6 px、缩到 .975、模糊 3px),卡片收回,说明晚 70 ms 回来。
+ - 以后的启动:整组先上移,卡片再出现。
+- 卡片等用户时,进行中的那一站停掉流光,阶段名保持 `--bt-ink`。
+- 鲸鱼跳不跳:
+ - 应用主动问的卡片(推荐盘、找不到数据文件夹、导入、180 秒),跳两下再静止,看着卡片。
+ - 用户自己引出的卡片(「其他位置…」选完后的「会放在…」、停止复制的确认),不跳。
+ - 同一件事又出了新问题(复制时空间不够),跳一下。
+- 选位置的卡片只有推荐盘这一种,只在首次启动出现,〔放到 D 盘〕〔仍然放在 C 盘〕都已经试写通过(上手流程第 3 节);以后的启动还会出「找不到数据文件夹」卡:
+ - 推荐盘:「C 盘只剩 1.2 GB。放到 D 盘(剩 412 GB)?」〔放到 D 盘〕(主按钮,拿到焦点)〔仍然放在 C 盘〕,按钮行末尾一个小链接「其他位置…」。默认位置不能用时,第一句换成原因(「DeepSeek Bot 没有权限在 `C:\Users\<用户名>` 里写文件。」),第二句一样;按钮只有〔放到 D 盘〕(主按钮)和小链接「其他位置…」,没有〔仍然放在 C 盘〕;没有可推荐的盘时只有〔选择其他位置…〕。
+ - 「其他位置…」打开系统选择框,卡片留在后面。定出的根就是用户选的文件夹时(上手流程第 3 节的规则),卡片直接收回,照常启动,不确认。应用在里面加了一层 `DeepSeek Bot` 时,同一张卡变形成「会放在 `D:\DeepSeek Bot`」〔继续〕(主按钮)〔重新选〕。选的位置不能用,同一张卡写一句原因(「DeepSeek Bot 没有权限在 `D:\Data` 里写文件。」「`C:\Users\<用户名>\OneDrive\文档` 在 OneDrive 里,同步会打断正在写入的聊天记录。」「`D:\Projects\DeepSeek Bot` 里已经有别的文件。」),〔重新选〕(主按钮),来时那张卡的〔放到 D 盘〕〔仍然放在 C 盘〕照旧留着;选择框被取消就回到来时的卡。「会放在…」和被拒绝的卡也有脚注。
+ - 脚注都是「以后可以在 设置 → 通用 → 位置 里改。」
+ - 没有更好的盘时不出卡片:提示行写「C 盘只剩 1.2 GB」,10 秒的提示来时换掉它。
+- 重装(`C:\Users\<用户名>\.ds-bot` 里有团队、没有保存的位置)不出卡片,盘不够也不出:说明的小字改写成「接着用上次的数据:6 个 Bot、2 个群聊(`C:\Users\<用户名>\.ds-bot`)。可以在 设置 → 通用 → 位置 里改。」,「下一步:接上一个模型…」那一段不显示。
+- 180 秒:「启动比平常慢很多。可以再等一会儿,或者重试。」〔继续等待〕(主按钮)〔重试〕〔打开日志文件夹〕
+ - 〔继续等待〕:卡片收回,180 秒后再问。
+ - 〔重试〕:重启引擎,时钟从 0 开始,鲸鱼抖一抖,回到工作。
+ - 卡片还在时引擎起来了:卡片收回,照常游到第 3 站。
+- 找不到数据文件夹(多见于以后的启动):文字和按钮按第 3 节已定的,主按钮在前。〔重试〕后还是找不到:按钮下面出现「还是找不到这个文件夹。」(`--bt-danger`,4 秒后淡出)。鲸鱼的眼睛左右看一遍,不跳。
+- 导入(第 4 节)都在纸面里,用同一套变形:
+ - 导入卡一句话:「DeepSeek Harness 里有 6 个 Bot 和 2 个群聊(对话 1.2 GB,工作文件 3.4 GB)。复制过来?」,下面一行小字「复制后会多占 4.6 GB,DeepSeek Harness 里的原件不动。」,〔复制过来〕(主按钮,拿到焦点)〔先不复制〕,脚注「也可以在 设置 → 通用 → 位置 里复制。」「详细」是和失败页一样的折叠区:找到的名字和段数、会复制什么、「模型设置:DeepSeek API · DeepSeek-V4-Pro 更换」、两个勾选框;展开时卡片的边用 `SPRING_SHAPE` 长高,内容晚 70 ms 淡入。
+ - 卡片一出现,第 2 站就开始预热,没被 DSH 占着时检查对话同时进行,鲸鱼在第 2 站跳两下后静止;预热好了也只给第 2 站打勾,不游到第 3 站。答〔先不复制〕时鲸鱼点一下头,预热好的引擎接着当正式引擎用,不重启。
+ - 空间不够(只查第一段):「空间不够:复制要约 1.7 GB,C 盘只剩 1.5 GB,还差 0.2 GB。」〔选择其他位置…〕(主按钮)〔先不复制〕
+ - 复制中:
+ - 卡片标题「正在复制 Bot 团队…」,三步用和三站一样的标记和对勾,竖着排:「检查对话 23/143」→「复制 Bot 和对话 820 MB / 1.2 GB」→「启动团队」。
+ - 当前一步下面是 4 px 的真实进度条(`scaleX`,`SPRING_LIST`),不往回走。
+ - 剩余时间按整分钟写:「还要大约 2 分钟」「不到 1 分钟」。变动满一分钟才改,不倒数到 0。
+ - 任务栏进度显示在启动窗口上。
+ - 鲸鱼工作,每完成一步点一下头。
+ - 停止复制:确认在卡片里就地展开:「停下后不会留下复制了一半的团队,DeepSeek Harness 里的团队不受影响。」〔继续复制〕(主按钮)〔停止复制〕(危险色文字)。鲸鱼静止。
+ - DSH 正在用这个团队(答〔复制过来〕后):鲸鱼静止,不晃。每 2 秒重查一次,不显示任何东西;锁一放开,卡片直接变成复制中。卡上一个〔先不复制〕(主按钮)。「正在下载」的卡也有〔先不复制〕(主按钮),加「下载太慢?手动下载」;下载失败时〔重试〕〔手动下载〕。
+ - 复制失败:鲸鱼用失败的姿势。
+ - 工作文件不经过启动窗口:团队打开后由应用在后台复制,进度在 设置 → 通用 → 位置 和 Main Bot 聊天里的「复制好了」卡上。
+
+### 7. 失败、更新和界面没加载出来
+
+- 失败后 1 秒内:
+ - 标题换成「DeepSeek Bot 没能启动」。
+ - 失败的那一站换成危险色的叉,停掉流光。
+ - 已用秒数和提示行淡出。
+ - 纸面变成恢复卡:一句原因、五个按钮、「详细信息」。
+ - 焦点移到〔重试〕。窗口不隐藏。
+- 〔复制详细信息〕点过后,按钮上的字变成「已复制」,1.6 秒后变回来。「详细信息」最多展开 168 px,日志在框里滚动。
+- 有新版本时:
+ - 恢复卡在原因和按钮之间展开一条更新条。〔下载并安装〕成为唯一的主按钮,〔重试〕变成普通按钮。
+ - 下载中显示「正在下载 {版本}(37%,78/212 MB)」、4 px 的进度条和「下载太慢?手动下载」。
+ - 下载完显示「正在安装,装好后会重新打开。」
+ - 下载失败显示「下载失败。」〔重试〕〔手动下载〕。
+ - 鲸鱼抬一次头,看向更新条,然后又静止。
+- 恢复卡上的选择:
+ - 〔重试〕:已完成的站保持完成,失败的那一站回到进行中,鲸鱼抖一抖,回到工作。
+ - 〔换个位置…〕和〔用新的空白团队开始…〕:先选文件夹(定根和首次启动同一条规则);然后鲸鱼沉到水线下,三站一起淡回未开始,鲸鱼在第 1 站重新浮上来。
+ - 重新开始的这一轮成功时,照首次启动庆祝一次;以后的启动也一样。
+- 团队界面 20 秒没加载出来:
+ - 主窗口始终不显示。
+ - 第 3 站换成危险色的叉,标题换成「团队界面没有加载出来。」,卡片里是〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕。
+ - 〔重新载入〕:在隐藏的主窗口里重新载入,回到第 3 站,20 秒重新算。
+ - `ready()` 晚到了也直接交接,不庆祝。
+
+### 8. 交接
+
+首次启动,以及重试后第一次成功。`t0` 是 `ready()` 到达后、鲸鱼停在第 3 站的那一刻:
+
+| 时间 | 启动窗口 | 主进程 |
+|---|---|---|
+| 0 | 第 3 站弹出对勾;「^ ^」眼;开始压扁 | — |
+| 160 ms | 已用秒数和提示行淡出 | — |
+| 460 ms | 拉到最长时潜下水线;标题、三站、纸面、底注淡出 .16 s | — |
+| 560 ms | 涟漪 | — |
+| 620 ms | 发 `handoffShow` | 启动窗口离开任务栏;主窗口以启动窗口的中心居中(不超出工作区),显示在启动窗口上面 |
+| 880 ms | 潜完,发 `handoffDone` | 主窗口显示满 250 ms 后关掉启动窗口,最晚 400 ms |
+
+- 以后的启动:字淡出 .16 s,鲸鱼 290 ms 潜下去;120 ms 时发 `handoffShow`,290 ms 时发 `handoffDone`。
+- 页面没发 `handoffShow` 时,主进程自己显示主窗口:首次启动在 1.5 秒后,以后的启动在 0.8 秒后。
+- 启动窗口有焦点时,主窗口直接显示并拿到焦点。
+- 启动窗口没有焦点时,主窗口不抢焦点,放在启动窗口原来的层次上,任务栏按钮闪烁。
+- 启动窗口最小化着时,主窗口也最小化着出现,任务栏按钮闪烁。
+- 主窗口第一次露面时,DSH 的加载、第一次挂载侧栏(#559)都已经做完,「预览版说明」已经显示出来。
+- 两个窗口各用各的颜色:启动窗口是 DeepSeek 主题的浅色或深色,主窗口是用户自己的主题。
+
+### 9. 减少动态效果
+
+- 跟随 `prefers-reduced-motion`(Windows 上是 设置 → 辅助功能 → 视觉效果 → 动画效果)。窗口开着时切换,也立刻生效:正在跑的动画直接到终点。
+- 鲸鱼一直是静止的画面:没有浮上来、游动、循环、跳、涟漪、尾巴、跟随和抚摸。换站时淡出 .12 s,换到新的一站,再淡入 .12 s。
+- 状态只靠眼睛直接切换:平时睁眼,45 秒起眯眼,就绪时显示「^ ^」600 ms,失败时眼皮变重。
+- 对勾、卡片、提示行和更新条只淡入 .12 s、淡出 .16 s,没有模糊、位移和缩放。卡片高度直接到位(内容先是透明的);以后的启动整组上移也直接到位;没有流光。
+- 交接只淡出 .12 s,然后显示主窗口。
+- 信息一样不少:已用秒数照常走,三站的文字、提示行、按钮和朗读都在。
+
+### 10. 颜色、Mica 和标题带
+
+- 颜色是 UI 标准 2.1 节的 DeepSeek 主题,浅色、深色各一套,定义在 `start.css` 的 `:root` 上。由 `start-assets.mjs` 从 `themes.js` 和 `inks.js` 生成,用 `--check` 对照。鲸鱼用 `--bt-ink-deepseek`(`#4D6BFE` / `#6A84FF`)。
+- 浅色还是深色看 `nativeTheme.themeSource`:
+ - 主进程把团队界面最后一次报告的值和动画档,记在 userData 的 `start-frame.json` 里,建启动窗口之前先设好。
+ - 没有记录时跟随系统。
+ - 不写 `DSH_HOME` 和 `~/.dsh`。
+- Windows 11 22H2 及以后:
+ - 窗口用 `backgroundMaterial: 'mica'`,背景 `#00000000`;页面的 `html`、`body` 透明。
+ - 系统按钮颜色 `#00000000`,符号用 `--bt-ink`,按钮下面也是 Mica。
+ - Mica 上最浅的字用 `--bt-ink-2`,不用 `--bt-ink-3`。
+- 其他 Windows:窗口背景和系统按钮颜色都用 `--bt-main`。页面照样透明,自己不用分辨是哪种情况。
+- 一屏最多两处大面积强调色:鲸鱼和唯一的主按钮。
+- 没有警告色(`--bt-warn` 未定):空间不足、OneDrive 和慢的提示都用中性墨色。
+- 字体:`-apple-system, BlinkMacSystemFont, "Segoe UI", "Microsoft YaHei UI", system-ui, sans-serif`;路径和日志用 `ui-monospace, Consolas, monospace`。字号只有 13/18、14/22、15/20(600),数字用等宽数字。
+- macOS 和 Linux:系统标题栏,没有标题带,其余一样。
+
+### 11. 实现
+
+- `main.mjs` 启动时的顺序:
+ 1. `setMenu`。
+ 2. 读 `start-frame.json`,设 `themeSource`。
+ 3. `hostPort()`,挪到建窗口之前。
+ 4. 建启动窗口(`show: true`),`loadFile`。
+ 5. 动态导入其余模块。
+ 6. 位置检查(结果变成卡片)。
+ 7. 启动引擎。
+ 启动窗口画好后,再建隐藏的主窗口。
+- 启动页的文件:
+ - `start.html`:CSP `default-src 'self'; base-uri 'none'; object-src 'none'`,没有内联样式和脚本。
+ - `start.css`。
+ - `start.js`:桥和界面。
+ - `whale.js`:鲸鱼的状态机。
+ - `text.mjs`:中英文,主进程也用。
+- 所有状态的 DOM 一开始就在页面里,用 `hidden` 和属性切换,运行时不插入大块节点。
+- 鲸鱼的 SVG 由 `start-assets.mjs` 从 `characterMarkup('whale', 'deepseek')` 生成后写进 `start.html`,遮罩 id 固定。同一个脚本把 `motion.js` 的弹簧和主题色写进 `start.css`。`npm test` 跑它的 `--check`。
+- 预载只在页面地址正好是启动页时暴露 `dsBotStart`(`onState`、`act`)。
+- 主进程每次都发完整的状态,页面重新载入后再发一次。预载记住最后一份,有人订阅时先补发。
+- 主进程只接受来自启动窗口主框架、地址完全相同的 `act`,而且名字要在白名单里。
+- 主进程管:阶段、180 秒和 20 秒两个计时器、交接的兜底计时器、任务栏进度、更新状态。页面按时钟算 5 秒、10 秒和 45 秒。
+- `main.log` 记三个阶段各用了多久。
+- 启动窗口在交接时销毁,它的渲染进程一起退出。
+
+## 改动的已定设计
+
+| 原来的设计 | 现在 |
+|---|---|
+| [Windows 上手流程](2026-10-26-windows-onboarding.md) 第 3 节「启动页和引擎的页面共用这个窗口」 | 启动页在单独的启动窗口里;引擎的页面在隐藏的主窗口里加载,`dsBotApp.ready()` 之后主窗口才显示(待定) |
+| 同上「选择框挂在窗口上」 | 挂在启动窗口上,从不自己弹出 |
+| 同上 首次启动说明的第三条「聊天和设置保存在这台电脑上……· 社区开源项目,不是 DeepSeek 官方产品」 | 拆成两处:前半句在说明里;「社区开源项目,不是 DeepSeek 官方产品」是首次启动每一屏的底注,卡片不盖住它 |
+| 同上 20 秒没就绪时「回到启动页」 | 启动窗口一直在,主窗口不显示 |
+| 同上「首次启动期间再双击图标:恢复并聚焦已有窗口」 | 聚焦正在显示的那个窗口 |
+| 同上 第 8 节 以后的启动「只写『正在打开你的团队…』」 | 另外 10 秒起显示已用秒数;45 秒显示「比平时慢,请再等一会儿。」;180 秒同首次启动 |
+| 同上「改动的已定设计」:窗口先加载启动页,再加载引擎的本机地址 | 启动窗口先出来;主窗口隐藏着加载引擎的本机地址(同一个地址和端口),就绪后才显示 |
+| 同上 验收「进程启动后 2 秒内窗口可见」「没有一个 `dialog.show*` 不挂在主窗口上」 | 两条里的窗口都指启动窗口 |
+| [桌面应用](2026-10-16-desktop-app.md)「窗口」 | 加上启动窗口:720 × 540,不能缩放,只有最小化和关闭,Mica |
+| [UI 标准](../design/ui-standard.md) 4.4 头像尺寸 | 加 88(启动窗口,首次启动) |
+| 同上 8.3 状态动作 | 加只在启动窗口里有的动作:浮上来、游到下一站、点头、潜下去、尾巴摆 |
+| 同上 3.1 字族 | 启动窗口加 `"Microsoft YaHei UI"`,记进第 14 节 |
+| 同上 12 可访问性 | 新出现的卡片和恢复页,焦点移到主按钮 |
+
+## 变更
+
+- 2026-10-26:定下启动窗口的样子和动作。依据:三套独立方案和两轮评审的合成、Electron 44 上的探针(Mica、系统按钮颜色、隐藏窗口的渲染)、可以打开看的原型。
+- 2026-10-26:位置卡片按上手流程第 3、4 节的简化改写:一张推荐盘的卡代替「找到以前的数据」「盘不够」「位置不能用」「总工作区在 OneDrive」四张,确认只在应用改了路径时出现;重装不出卡;导入卡一句话两个按钮,详情折叠;复制中三步,工作文件不经过启动窗口。评审后补正:默认位置不能用的卡没有〔仍然放在 C 盘〕;每张卡写明主按钮;跳两下的卡片加上「找不到数据文件夹」。
+- 2026-10-27:导入卡加一行小字写明复制后多占多少、原件不动;换位置的页面改叫「正在搬 DeepSeek Bot 的数据…」(上手流程 §8 的〔移到…〕改成真正的搬)。评审后补正:导入卡开着时引擎起来只打勾、不加载页面(§1、§4 第 8 拍);占用卡和下载卡有〔先不复制〕;被拒绝的卡留着来时的按钮和脚注;空间例子改成 1.7 / 1.5 / 0.2 GB。
+
+## 待定
+
+| 问题 | 选项 | 建议 |
+|---|---|---|
+| 启动页放在哪里? | 单独的启动窗口(本文);主窗口里叠一层透明的 `WebContentsView`,团队界面在下面加载,就绪后淡出;按原来的设计在同一个窗口里 `loadURL` | 单独的启动窗口:真正的小窗,一直有 Mica,交接没有空白帧,「打开团队」也是真的。覆盖层是第二选择:同样没有空白帧,但启动时就是大窗口,还要管两套焦点。原来的做法会露出 DSH 自己的加载,第 3 站的对勾和庆祝只能不做 |
+| 鲸鱼的尾巴能单独动吗? | 启动页把生成器的输出按尾柄(`27.9, 61.1`)裁成两层,不加新形状;生成器加一个尾巴单独成层的选项;尾巴不动 | 先用裁切,只在启动窗口里用。以后插件也要用时,再给生成器加选项。去掉也只少了尾巴,其余不变 |
+
+## 不做什么
+
+- 不画百分比进度条:引擎不报百分比。复制和下载的进度条用真实的字节数。
+- 不编造阶段,不为动画推迟启动。庆祝只在首次启动和重试后第一次成功时有,主窗口在 `ready()` 后约 620 ms 露面。
+- 不放轮播的提示和笑话。鲸鱼不说话、不冒气泡、不挡卡片和按钮,也不要用户做什么。失败时不哭不闹。
+- 鲸鱼没有「?」徽标(UI 标准 8.2:大头像不显示徽标),不侧身跃出水面,不喷水。
+- 不画 DSH 的鲸鱼标志,不用其他产品的动画、插图、声音和字体。
+- 不往引擎的页面里注入 CSS 或 DOM 来接画面,不改 DSH。
+- 不用 Rive、Lottie 和网络字体:CSP `default-src 'self'` 不允许 WASM,也不另加运行时。
+- 标题带里不放能点、能抚摸的东西。
+
+## 已知限制
+
+- 主窗口在隐藏时启动 DSH 和 ds-bot。`dsBotApp.ready()`、#559 的重新挂载检查和系统按钮颜色的测量,都在看不见的窗口里跑,要在 M4 验证。
+- 从没显示过的 Mica 窗口第一次 `show()` 时,可能先露出一两帧空的 Mica。M4 用 60 帧录像检查;有的话,改成先把主窗口放在启动窗口下面,启动窗口潜完再关。
+- `#00000000` 的系统按钮颜色,只在一台 Windows 11(26200,深色,窗口不在前台)上验证过是透明的。前台、浅色、悬停和按下都没验证。按钮画成不透明的系统,改用不透明的 `--bt-main` 窗口。
+- 未打包、机器忙时实测:进程启动后 1.35–1.57 秒窗口才建好,页面第一次画出来还要再等 0.9–1.0 秒。启动页的第一帧和空窗口一模一样,这段看不出来,但入场会晚。
+- SVG 里的尾巴和眼睛、内容的模糊淡入和流光不走合成线程。杀毒软件在扫描、引擎又在启动时,可能卡顿;那时先去掉尾巴。
+- 动画档和浅深色要等团队界面报告一次才记得住。在应用外改过主题时,下次启动先用旧的。
+- 第 2 站结束是从引擎的 HTTP 起来推断的:DSH 不报命名的阶段(「需要 DSH 提供的」第 11 条)。
+- 工作区不到 588 高的显示器上,窗口只有 500 高,说明和长卡片要在纸面里滚动。
+- 启动时多一个渲染进程(约 40–60 MB),交接后销毁。
+- 交接的 250–400 ms 里两个窗口同时存在。启动窗口已经不在任务栏,但 Alt+Tab 里可能短暂看到两个。
\ No newline at end of file
diff --git a/docs/plans/2026-10-26-windows-onboarding.md b/docs/plans/2026-10-26-windows-onboarding.md
index a98b10a0..de29a858 100644
--- a/docs/plans/2026-10-26-windows-onboarding.md
+++ b/docs/plans/2026-10-26-windows-onboarding.md
@@ -2,7 +2,7 @@
- 日期:2026-10-26
- 相关:#523、#559、#384、#500、#551(PR #567)、#529、#561、#515、#423、#499、#428、#265;Discussions #530、#150
-- 一起改:[桌面应用](2026-10-16-desktop-app.md)(结构、窗口、模型、首次启动和导入、改位置、安装和更新、暂时不做、已知限制)、[Bot 运行配置](2026-10-10-bot-runtime.md)(新 Bot 的模型来源和那条已知限制)、[DSH 让步总账](2026-10-13-dsh-concessions.md)(预览版说明关不掉、设置卡借用 `settings.models.sign-in` 的操作、借 `settings.onboarding` 步骤打开「模型」)、[UI 标准](../design/ui-standard.md) 第 11 节(术语「提供商」)
+- 一起改:[桌面应用](2026-10-16-desktop-app.md)(结构、窗口、模型、首次启动和导入、改位置、安装和更新、暂时不做、已知限制)、[Bot 运行配置](2026-10-10-bot-runtime.md)(新 Bot 的模型来源和那条已知限制)、[DSH 让步总账](2026-10-13-dsh-concessions.md)(预览版说明关不掉、设置卡借用 `settings.models.sign-in` 的操作、借 `settings.onboarding` 步骤打开「模型」)、[UI 标准](../design/ui-standard.md) 第 11 节(术语「提供商」);启动页的样子和卡片的动作在 [启动窗口](2026-10-26-start-window.md)
- 代码:`app/src/main.mjs`、`first-run.mjs`、`import.mjs`、`updates.mjs`、`preload.cjs`、`host.mjs`、`host-process.mjs`、`downloads.mjs`、`move-data.mjs`、新的 `app/src/start/`;`app/electron-builder.yml`、`app/build/installer.nsh`;`ds-bot/index.js`;`ds-bot/src/client/model-menu.js`、`team-actions.js`、`sidebar.js`、`settings.js`、`diagnostics.js`、`i18n.js`、`ds-bot/src/client/index.js`;`ds-bot/src/host/models.js`、`roster.js`、`turns.js`、`providers.js`、`channel.js`、`parts.js`;`.github/workflows/release.yml`、`.github/ISSUE_TEMPLATE/`;`README.md`、`README.zh.md`
## 为什么
@@ -89,16 +89,18 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 小字写明位置:「数据保存在 `C:\Users\<用户名>\.ds-bot`,Bot 默认在 `C:\Users\<用户名>\DeepSeek Bot` 里工作。都可以在 设置 → 通用 → 位置 里改。」
- 最后一个阶段,DSH 会挂出「预览版说明」时(会话准备好、主视图里没有非空会话):「接下来会先显示 DeepSeek Harness 的「预览版说明」。DeepSeek Bot 建在 DeepSeek Harness 上,点「继续」就行。」
- 超过 10 秒:「第一次启动会慢一些,Windows 可能在检查刚装好的文件。」超过 45 秒:「比平时慢,可能是杀毒软件在检查新文件,请再等一会儿。」加「打开日志文件夹」。
-- **一般情况下什么都不问**,用默认位置。只在状态需要时出现一张卡片,每张都说明以后在哪里改:
- - 找到以前的 DS Bot 数据但没有保存的位置(重装过):「找到了之前的 DeepSeek Bot 数据:6 个 Bot、2 个群聊(`C:\Users\<用户名>\.ds-bot`)。旧数据会保留在原处。」〔接着用(推荐)〕〔用新的空白团队开始…〕
- - 数据所在的盘不到 5 GB:「C 盘只剩 1.2 GB。聊天和 Bot 的文件会越来越多,最好放到别的盘。」〔选择其他位置…〕〔仍然放在 C 盘〕
- - 位置不能用(没有写入权限、在 OneDrive 里、整个磁盘、别人的非空文件夹):一句话说明原因,加〔选择其他位置…〕。OneDrive 里的总工作区只提醒,不拒绝。
- - 保存过的数据文件夹找不到了:「找不到数据文件夹 `D:\DeepSeek Bot\data`。可能是移动硬盘没插上,或者文件夹被移走、删除了。旧数据不会被改动。」〔重试〕〔重新找到它…〕〔用新的空白团队开始…〕
-- 选择框挂在窗口上,从上一级文件夹开始。选了磁盘根目录或别人的非空文件夹时,自动在里面加一层子文件夹,并显示结果:「会放在 `D:\DeepSeek Bot\data`」〔就用这里〕〔重新选〕。两个位置分开改。DSH 数据的规则只在那个文件夹真的存在时才检查。
-- 首次启动的位置检查和「换数据位置」用同一套规则(不能是整个磁盘、不能是别人的非空文件夹),外加一次试写。
-- `locations.json` 只在引擎第一次成功启动(`ready`)、导入问题也答完之后才写。同时写一份 UTF-16LE 的 `locations.ini` 给卸载程序读;应用自己新建的数据文件夹里放一个不含任何机密的 `.deepseek-bot` 标记。「首次启动没走完就退出时什么都不记」的规则不变。
+- **一般情况下什么都不问**,用默认位置。先看是不是重装(下一条),再看要不要出位置卡片。选位置的卡片只有推荐盘这一张,它上面的按钮都已经试写通过,不会点了再被拒绝;每张卡都说明以后在哪里改:
+ - 数据所在的盘不到 5 GB(有团队要导入时,不到「5 GB + 导入卡上要多占的数」),而且有更好的盘:「C 盘只剩 1.2 GB。放到 D 盘(剩 412 GB)?」〔放到 D 盘〕〔仍然放在 C 盘〕,按钮行末尾一个小链接「其他位置…」。按 Enter 就是放到 D 盘。没有更好的盘就不出卡片,只在提示行写一句「C 盘只剩 1.2 GB」,照常启动。
+ - 默认位置不能用(没有写入权限):第一句换成原因「DeepSeek Bot 没有权限在 `C:\Users\<用户名>` 里写文件。」,第二句一样;按钮只有〔放到 D 盘〕和小链接「其他位置…」,没有〔仍然放在 C 盘〕。没有可推荐的盘时只有〔选择其他位置…〕。
+ - 保存过的数据文件夹找不到了(多见于以后的启动):「找不到数据文件夹 `D:\DeepSeek Bot\data`。可能是移动硬盘没插上,或者文件夹被移走、删除了。旧数据不会被改动。」〔重试〕〔重新找到它…〕〔用新的空白团队开始…〕。〔重新找到它…〕不走定根的规则:选中的文件夹本身或它下面的 `data` 里有 `.deepseek-bot` 标记和 `bot/state.json`(所以 `~/.dsh` 永远不算),又通过位置规则(不在 DSH 的家里、不在程序目录里),就把它写成数据文件夹;旁边有 `workspace` 时总工作区一起改过去,没有就不动。否则卡上写「这里没有 DeepSeek Bot 的数据。」,〔重新找到它…〕留着。
+- **重装不问。** 没有保存的位置、而 `C:\Users\<用户名>\.ds-bot` 里有团队时(重装过,或者 `%APPDATA%` 被清过),直接接着用:不出推荐盘的卡片,盘不够只在提示行写一句「C 盘只剩 1.2 GB」,要搬去 设置 → 通用 → 位置 →〔移到…〕;写不进去直接是恢复页。说明的小字改写成「接着用上次的数据:6 个 Bot、2 个群聊(`C:\Users\<用户名>\.ds-bot`)。可以在 设置 → 通用 → 位置 里改。」,不写总工作区的路径:启动页不知道旧团队登记的总工作区,插件启动后经 `teamWorkspaceChanged` 报告一次,应用据此写 `locations.json` 的 `workspace`。「下一步:接上一个模型…」那一段也不显示。想要空白团队的人去 设置 → 通用 → 位置 →「用新的空白团队开始…」。只认默认位置:放在别处、又没有保存位置的旧数据找不到,和今天一样。
+- **推荐的盘**怎么来:只在数据所在的盘不到门槛(5 GB,有团队要导入时加上要多占的数:对话 1.2 GB 加默认要复制的工作文件 3.4 GB,就是不到 9.6 GB)、或默认位置不能用时查一次(重装接着用时不查),正常启动不查。这一步在引擎预热之前,所以迁移用户先看到推荐盘的卡,再看到导入卡。用完整路径的 `%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -NoProfile -NonInteractive`(`windowsHide`,5 秒超时)读 `Win32_LogicalDisk` 和 `Get-Partition | Get-Disk`:只要固定盘(`DriveType` 3)、`FreeSpace` 不为空、总线不是 USB、SD、MMC 或虚拟盘的,再用 `fs.statfs` 确认一次。盘不够时排除数据现在所在的盘;默认位置不能用时可以推荐同一个盘上的 `X:\DeepSeek Bot`。取剩余空间最大、而且不少于 20 GB 的一个。`X:\DeepSeek Bot` 已经存在时按下面定根的规则判断,不能用就不推荐这个盘。试写只建缺的那几层,写完删掉自己建的。PowerShell 失败、超时或被策略禁掉,都当作没有更好的盘。macOS 和 Linux 不推荐盘,空间不够只在提示行写一句。
+- **一个位置。** 用户换位置时只选一个文件夹,由它定出根 `R`:选的是磁盘根目录,`R` 是它下面的 `DeepSeek Bot`;选的文件夹不存在或是空的,`R` 就是它;选的文件夹是 DeepSeek Bot 以前的根(`data` 里有 `.deepseek-bot` 标记,没有团队或者只有一个没说过话的空白团队),`R` 也是它;其余非空的文件夹,`R` 是它下面的 `DeepSeek Bot`。`R` 已经存在、非空、又不是以前的根时,不能用。数据放在 `R\data`,Bot 的文件放在 `R\workspace`(子文件夹的名字待定);两者是兄弟,互不包含,和默认的 `~\.ds-bot`、`~\DeepSeek Bot` 一样是同一个父文件夹下的兄弟,所有规则不变。〔放到 D 盘〕就是 `D:\DeepSeek Bot\data` 加 `D:\DeepSeek Bot\workspace`。默认安装的路径不改(待定)。设置里也是一处:「位置」一行显示两个路径,一个〔移到…〕一起搬(第 8 节);要分开放的在「高级」里。
+- 只有点了「其他位置…」才打开系统选择框,挂在窗口上,从推荐的盘开始,没有推荐的盘就从现在的数据文件夹的上一级开始。选完先定根,`R\data` 和 `R\workspace` 都对照现在的数据文件夹和总工作区过一遍位置规则,再试写。都通过了:`R` 就是用户选的文件夹时直接用,不再确认;应用加了一层 `DeepSeek Bot` 时,同一张卡片变成「会放在 `D:\DeepSeek Bot`」〔继续〕〔重新选〕,只在应用改了用户选的路径时才确认。没通过(没有写入权限、在 OneDrive 里、`R` 是别人的非空文件夹),卡片写一句原因,〔重新选〕作主按钮,来时那张卡的〔放到 D 盘〕〔仍然放在 C 盘〕照旧留着;选择框被取消就回到来时的卡。DSH 数据的规则只在那个文件夹真的存在时才检查。
+- 首次启动的位置检查和「移到…」用同一套规则检查定出的根:不能是整个磁盘、不能是别人的非空文件夹,外加一次试写。
+- `locations.json` 只在引擎第一次成功启动(`ready`)、导入问题也答完之后才写。同时写一份 UTF-16LE 的 `locations.ini` 给卸载程序读。应用自己新建的数据文件夹里放一个不含任何机密的 `.deepseek-bot` 标记,这个标记在建文件夹时就写、不等 `ready`:首次启动没走完就退出时,留下的文件夹下次才认得出是自己建的(定根规则里的「以前的根」),不会被当成别人的非空文件夹。「首次启动没走完就退出时什么都不记」的规则不变:记的只是 `locations.json`。每次启动先删掉上次留下的暂存(路径记在 `%APPDATA%` 里,加上数据文件夹里所有的 `.import-*` 和 `.import-check-*`)。
- 然后加载引擎的页面:DSH 的「预览版说明」→「继续」。DSH 自己的「开始使用」和「添加一个 API Key」不再自动出现:应用在自己的 profile 补丁(和 `search-patch.mjs` 一样经 `runProfile` 的 `patchFiles` 传入)里设 `ui-settings-models` 的 `credentialOnboarding: false`,这是 DSH 有文档的配置。补丁会替换这一行的整个 `config`,所以每次升级锁定的 DSH 都对照新版本重写这一行。应用的补丁里只有这一行。
-- **启动失败**时,启动页当场变成恢复页(不再等 GitHub、不再隐藏窗口、不再弹英文「Error」框):标题「DeepSeek Bot 没能启动」,一句对应的原因(没有写入权限 / 磁盘空间不够 / 程序文件不完整,可能被杀毒软件拦掉了一部分 / 本机引擎启动到一半停下了 / 出了点意外),每种都给〔重试〕〔换个数据文件夹…〕〔用新的空白团队开始…〕〔打开日志文件夹〕〔复制详细信息〕,再加一个「详细信息」折叠区(日志最后 200 行,已脱敏)。
+- **启动失败**时,启动页当场变成恢复页(不再等 GitHub、不再隐藏窗口、不再弹英文「Error」框):标题「DeepSeek Bot 没能启动」,一句对应的原因(没有写入权限 / 磁盘空间不够 / 程序文件不完整,可能被杀毒软件拦掉了一部分 / 本机引擎启动到一半停下了 / 出了点意外),每种都给〔重试〕〔换个位置…〕〔用新的空白团队开始…〕〔打开日志文件夹〕〔复制详细信息〕(换位置按第 3 节定根的规则,数据和总工作区一起搬,搬的规则同第 8 节:同一个卷上改名,不同的卷上复制完再删旧的;还没有团队时只是换个空文件夹),再加一个「详细信息」折叠区(日志最后 200 行,已脱敏)。
- 启动超过 180 秒:「启动比平常慢很多。可以再等一会儿,或者重试。」〔继续等待〕〔重试〕〔打开日志文件夹〕,引擎同时继续启动。
- 后台更新器发现了新版本时,恢复页上显示「DeepSeek Bot {版本} 已经发布,可能修好了这个问题。」〔下载并安装〕,带下载百分比和「下载太慢?手动下载」(打开镜像页)。
- 引擎起来了但 DS Bot 界面 20 秒内没报告就绪(ds-bot 在界面挂载完成后调用 `dsBotApp.ready()`):回到启动页,显示「团队界面没有加载出来。」〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕。
@@ -112,20 +114,27 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
条件:`~/.dsh`(或 `DSH_HOME`)里有 Bot 团队,而数据文件夹里还没有。
-- 导入卡在启动页上出现,引擎同时在新数据位置预热(已定的「先在新数据位置启动一次再复制」照旧,只是和提问并行,不再空等)。
-- 标题「要把 DeepSeek Harness 里的 Bot 团队复制过来吗?」,内容先列名字、数量和大小,再说会复制什么、不会复制什么:
- - 「在 `C:\Users\<用户名>\.dsh` 里找到 6 个 Bot(Chief、写手、程序员等)和 2 个群聊,143 段对话。对话和记忆约 1.2 GB,工作文件约 3.4 GB。」
+- 导入卡在启动页上出现。卡片一出现,两件事就在后台开始,不等用户回答:引擎在新数据位置预热(已定的「先在新数据位置启动一次再复制」照旧),先查团队有没有被 DSH 占着(下面的判断规则):没占着才把对话复制进暂存文件夹 `.import-<时间>`(在数据文件夹里,和复制时用的是同一个),锁定版 DSH 以暂存为家读一遍它们;占着就只预热引擎,什么都不复制。复制暂存期间锁出现过或刷新过,这份暂存作废,锁放开后重新复制。这份暂存就是复制时要用的那一份:不再另建 `.import-check-<时间>`,对话只复制一次。暂存的路径记在 `%APPDATA%` 里;导入卡开着时关掉启动窗口、更新重开、被杀掉,下次启动都先删掉它。导入卡开着、第一段还没复制完时,主窗口不加载引擎的页面(插件一收到 `state` 就会建出一个空白团队),第 3 站「打开团队」和 20 秒的界面检查也等用户回答以后才开始。点〔先不复制〕:等检查用的引擎退出后删掉暂存,预热好的引擎接着当正式引擎用,主窗口这时才加载它的页面,一秒都不多等。点〔复制过来〕:预热的引擎拿着团队的锁,先停掉它再接着复制 Bot 和附件,复制完起正式引擎,和今天一样。
+- 卡片只有一句话和两个按钮:「DeepSeek Harness 里有 6 个 Bot 和 2 个群聊(对话 1.2 GB,工作文件 3.4 GB)。复制过来?」〔复制过来〕〔先不复制〕,下面一行小字「复制后会多占 4.6 GB,DeepSeek Harness 里的原件不动。」,脚注「也可以在 设置 → 通用 → 位置 里复制。」按 Enter 就是复制。「详细」展开才有:
+ - 「在 `C:\Users\<用户名>\.dsh` 里找到 6 个 Bot(Chief、写手、程序员等)和 2 个群聊,143 段对话。」
- 「会复制:Bot、群聊、记忆、对话、附件、模型设置和 API Key。不会复制:MCP、技能和 DSH Agent。DeepSeek Harness 里的内容不会改动,复制以后两边各用各的。」
- 模型设置自动选一份:先选有 key 的,再按 desktop、web、行数最多的顺序。显示提供商和默认模型,旁边有「更换」,可以按同样的格式换另一份。
- - 可重新生成的文件夹(`node_modules`、`.venv`、`__pycache__`、`.pnpm-store`、`.next` 等)合计 200 MB 以上时,默认勾选「不复制可以重新生成的文件夹」。工作文件超过 2 GB 或空间不够时,提供「先不复制工作文件」(之后能在设置里补)。
- - 〔复制过来(推荐)〕〔先不复制〕,脚注「也可以在 设置 → 通用 → 位置 里复制。」
-- 复制前先查空间:按今天的顺序,约「对话 + 附件 × 2 + 工作文件 + 500 MB」(检查用的对话副本在复制开始前就删掉了;附件先进暂存再复制到目标,算两份)。空间不够就说清楚差多少,并给〔先不复制工作文件〕〔换个位置…〕〔先不复制〕。
-- 复制时显示分步进度和数字:「检查对话 23/40」→「复制 Bot 和对话 820 MB / 1.2 GB」→「复制工作文件 1,204 个」→「启动团队」,带剩余时间估计和任务栏进度。〔停止复制〕会就地确认,并说明停下后会留下什么:不留下复制了一半的团队,DSH 里的团队不受影响,已复制的工作文件留在总工作区,下次复制不会覆盖已有文件。
-- DSH 正在用这个团队:「请完全退出 DSH Desktop(任务栏右下角的托盘图标也要退出),并关掉 DSH Web,这里会自动继续。」每 2 秒自动重查,不用点重试。判断规则和 ds-bot 的 home-lock 一样:同一台机器上 PID 活着**而且**锁在 60 秒内刷新过(#428 的修法),被系统重用的旧 PID 不再算。
-- 有更新版本 DSH 写的对话:更新器现在随应用一起启动,找到能读的版本时:「DeepSeek Bot 0.2.4 能读它们,正在下载(37%)。装好后会重新打开,再复制团队。」位置在这之前不保存,重开后会再问导入。没找到时:「这些对话是更新版本的 DeepSeek Harness 写的,DeepSeek Bot 现在读不了。」主按钮是〔先不带团队开始〕(不再是「退出」),脚注「可以在 设置 → 通用 → 位置 里再复制。」
+ - 可重新生成的文件夹(`node_modules`、`.venv`、`__pycache__`、`.pnpm-store`、`.next` 等)合计 200 MB 以上时,默认勾选「不复制可以重新生成的文件夹」;「先不复制工作文件」默认不勾。卡片上的「工作文件 3.4 GB」和「多占 4.6 GB」按勾选项算:默认已经扣掉可重新生成的文件夹,改勾选时两个数字跟着变。
+- **复制分两段,小的先进去。** 第一段挡着启动:Bot、群聊、记忆、对话、附件、模型设置和 API Key(今天 `importTeam` 里除工作文件以外的全部),复制完就启动团队。第二段在团队打开以后由应用在后台做:旧团队工作文件夹里的文件复制到总工作区,不覆盖已有的文件,跳过勾掉的文件夹。导入后每个 Bot 本来就换到新文件夹的新一段,旧文件夹只当历史读,所以工作文件晚几分钟到不影响干活;Bot 在那之前新建了同名文件,旧文件就跳过,记在导入结果里。工作文件还没到齐时(`bot/work-files.json` 是 `pending`),插件在每个 Bot 的系统提示里加一句:工作文件还在从 `<旧文件夹>` 复制过来,还有 N 个,那里只读,要用旧文件先去那里看;跳过的文件数和第二段没开始的原因也写在「复制好了」卡上,不只在设置里。Bot 和群自己设的文件夹(`workDir`):在 `~/.dsh/bot/workspace` 里面的,改成新总工作区下同样的相对路径(应用的 Bot 不能写 `~/.dsh`);在别处的两边团队会共用,「详细」里列出这些 Bot 和群。
+ - 第二段自己遍历目录树(不用 `fs.cp`),沿用 `copyTree` 的 leave、skip 和 relink(链接最后照旧重建):每个文件先写进总工作区旁边、同一个卷上的暂存文件夹(`.<总工作区名>.copying-*`,带标记,和换位置的暂存一样),写完用 `fs.link` 放到正式位置;同名文件已经存在时 link 以 EEXIST 失败,就把相对路径记进跳过列表,再删掉暂存里的这一份。不支持硬链接的文件系统(FAT、exFAT)退回到「查一次再改名」,那一小段竞态记进已知限制。Bot 永远读不到写了一半的文件。
+ - 记录在 `bot/work-files.json`(`{ from, to, skip, state: 'pending' | 'done', done, total, skipped }`):`importTeam` 在最后改名之前把它写进暂存的 `bot/`,和团队一起落地;`imported.json` 只记导入的结果。进度在 设置 → 通用 → 位置 里:「正在复制工作文件 820 / 1,204 个,不到 1 分钟」〔停止〕;Main Bot 聊天里的「复制好了」卡上也带一行。退出应用时在文件之间停下,下次启动先删掉上次留下的暂存文件夹,再接着复制;停止后设置里显示「工作文件还有 384 个没复制」〔继续复制〕。第二段进行中,〔移到…〕和换总工作区先停下它。`DS_BOT_HOME` 的运行不续复制。
+- **空间只占一份。** 从 DeepSeek Harness 复制时原件必须留下(应用从不写 `~/.dsh`,也不用硬链接连到它的文件:同一个文件两处可见,Bot 在新位置写就改掉了原件),所以多占的空间要在复制前写在卡片上,复制过程中盘上任何时刻最多只多出最后会留下的那一份,复制后设置里能看到原件在哪、占多少:
+ - 卡片一出现先查第一段的空间:卡片上的「对话 1.2 GB」是第一段的全部(对话、记忆和附件),要求剩余不少于「第一段 + 500 MB」。够就开始往暂存复制对话并检查;不够就只预热引擎,答〔复制过来〕时出「空间不够:复制要约 1.7 GB,C 盘只剩 1.5 GB,还差 0.2 GB。」〔选择其他位置…〕〔先不复制〕。
+ - 暂存在数据文件夹里,和目标同一个卷:对话、`bot/` 和附件都从暂存改名进位,不再把附件从暂存复制第二份。
+ - 工作文件的空间在第二段开始前单独查,要求剩余不少于「要复制的工作文件 + 1 GB」,不够就不开始,只在设置里写「工作文件没有复制:D 盘还差 2.2 GB」〔重试〕,不打断启动;复制中剩余不到 500 MB 就停下,设置里写「工作文件没复制完:D 盘只剩 480 MB」〔继续复制〕。暂存加硬链接落位本来就不多占空间。
+ - 复制后,设置 → 通用 → 位置 里有一行「DeepSeek Harness 里的原团队还在 `C:\Users\<用户名>\.dsh`(4.6 GB),DeepSeek Bot 不会改动它。」〔打开文件夹〕;要不要删、什么时候删由用户在 DeepSeek Harness 里决定。
+ - 新用户从不复制任何东西:推荐盘和「其他位置…」只新建空文件夹,重装接着用原处的数据。应用自己的数据搬动时(第 8 节〔移到…〕、恢复页的〔换个位置…〕)旧位置不留副本。
+- 第一段复制时显示分步进度和数字:「检查对话 23/143」→「复制 Bot 和对话 820 MB / 1.2 GB」→「启动团队」,带剩余时间估计和任务栏进度。〔停止复制〕会就地确认,并说明停下后会留下什么:不留下复制了一半的团队,DSH 里的团队不受影响。
+- DSH 正在用这个团队:「请完全退出 DSH Desktop(任务栏右下角的托盘图标也要退出),并关掉 DSH Web,这里会自动继续。」这张卡在答〔复制过来〕时才出现(卡片一出现就查到被占着时只是不暂存),每 2 秒自动重查,不用点重试,锁一放开就开始暂存和复制;卡上有〔先不复制〕,退不掉 DSH 的人有路可走。判断规则和 ds-bot 的 home-lock 一样:同一台机器上 PID 活着**而且**锁在 60 秒内刷新过(#428 的修法),被系统重用的旧 PID 不再算。
+- 有更新版本 DSH 写的对话:更新器现在随应用一起启动,找到能读的版本时:「DeepSeek Bot 0.2.4 能读它们,正在下载(37%)。装好后会重新打开,再复制团队。」卡上有〔先不复制〕,还有「下载太慢?手动下载」;下载失败时〔重试〕〔手动下载〕(和恢复页的更新条一样)。位置在这之前不保存,重开后会再问导入。没找到时:「这些对话是更新版本的 DeepSeek Harness 写的,DeepSeek Bot 现在读不了。」主按钮是〔先不带团队开始〕(不再是「退出」),脚注「可以在 设置 → 通用 → 位置 里再复制。」
- 复制失败:「团队没有复制完:{原因}。DeepSeek Harness 里的团队没有变化。」常见原因翻成人话(文件被别的程序占用 / 没有权限读取 / 磁盘满了),其他放进「详细信息」。〔重试〕〔先不带团队开始〕〔复制详细信息〕。失败或停止时删掉 `.import-<时间>` 暂存文件夹。
- 导入的修正:群聊的接力 Session(`room.id`)也复制(#551,PR #567);目标里已有的 `.credentials.yaml` 存着用户自己的 key 或登录时不覆盖。引擎在新数据位置第一次启动时会写一份只有 `client-connection/` 记录(浏览器会话)的 `.credentials.yaml`,这样的文件照常换成旧的。
-- 复制完成后,窗口打开在导入来的 Main Bot 的聊天里,先显示一张一次性的卡片「复制好了:6 个 Bot、2 个群聊、143 段对话。」,然后是对模型的检查结果。检查通过显示「模型:DeepSeek-V4-Pro · DeepSeek API — Key 可以用,余额 ¥23.50」;没通过就在用户打字前显示对应的修复卡(见第 6 节)。
+- 第一段复制完成后,窗口打开在导入来的 Main Bot 的聊天里,先显示一张一次性的卡片「复制好了:6 个 Bot、2 个群聊、143 段对话。工作文件正在后台复制(1,204 个,3.4 GB,还要大约 2 分钟)。」,然后是对模型的检查结果。检查通过显示「模型:DeepSeek-V4-Pro · DeepSeek API — Key 可以用,余额 ¥23.50」;没通过就在用户打字前显示对应的修复卡(见第 6 节)。
- 导入后,Main Bot 在模型检查通过后马上(空闲时)换到新文件夹的新一段(只提前换 Main Bot 待定),并显示「正在把{名字}搬到新的工作文件夹(要读一遍最近的对话,大约 1 分钟)。现在发消息也可以,会排在后面。」其他 Bot 在各自的第一条消息时换段,换段期间先显示用户的消息和「正在搬到新文件夹…」,不再出现 84 秒什么都没有的情况(#384)。
### 5. 接上模型:Main Bot 的设置卡
@@ -143,7 +152,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- **粘贴 key**:保存前先检查。只对 DeepSeek 官方地址:`GET https://api.deepseek.com/user/balance`,8 秒超时,不记录 key 和返回内容。`DEEPSEEK_BASE_URL` 指向本机地址时(mock 模型),检查发到那个本机地址的 `/user/balance`;其他自定义地址或中转服务不检查余额,交给第一轮的修复卡。key 只会发给 `api.deepseek.com` 或本机地址。
- 401:「DeepSeek 不接受这个 Key(401)。请确认整段复制了,或者新建一个。」key 不保存,输入框保留内容和焦点。
- 格式不对(带引号、带 `NAME=` 等,沿用现有规则):「只粘贴 Key 本身,不要带引号或 NAME=…」
- - 余额为零:key 保存,卡片显示「Key 没问题,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔再查一次余额〕。
+ - 余额为零:key 保存,卡片显示「Key 没问题,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔再查一次余额〕〔换一种方式〕(回到 A/B 两种方式的卡,已经保存的 key 留着)。
- 连不上:「暂时连不上 api.deepseek.com,Key 还没保存。如果在用代理软件,确认它开着。」〔再试一次〕〔仍然保存〕。429 或 5xx:「DeepSeek 服务暂时繁忙({状态码}),Key 还没保存。」同样两个按钮。
- key 来自环境变量 `DEEPSEEK_API_KEY` 而检查没通过:「这个 Key 来自环境变量 DEEPSEEK_API_KEY,这里改不了。」〔换一种方式〕
- **账号余额为零**(登录后):「已登录 DeepSeek 账号,但余额是 ¥0.00。充值后我就能开始;一般一轮对话只要{实测值},以 DeepSeek 价格页为准。」〔去充值 ↗〕〔再查一次余额〕〔换一种方式〕。key 余额为零时用上面「粘贴 key」里的卡片。这两张卡显示期间,窗口回到前台时、以及每 10 秒(最多 10 分钟)自动重查,余额一到就自己往下走。
@@ -198,7 +207,11 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 设置卡由状态决定:没有能用的模型(跳过过、删了 key、退出了登录),Main Bot 的设置卡就回来;账号登录过期时显示「DeepSeek 账号的登录失效了。」〔重新登录〕。
- DS Bot 设置 → 模型在所有形态里都有(在 `team-actions.js` 里接上插件 Host 已有的 `providers`、`provider-key` 等接口,今天只有停用的 `app/ui` 接了),显示每个提供商的 key 状态(「已设置 Key」「需要 API Key」「Key 来自 DS Bot 之外」)和「添加提供商」。原来的「Harness 设置」改叫「高级设置(DeepSeek Harness)」。
- 要打开 DSH 自己的模型页时(「高级设置」里的模型、鲸鱼菜单的「模型和 API Key」在没有 DS Bot 模型页时),直接落在「模型」上,不再落在「通用设置」:插件注册一个自己的 `settings.onboarding` 步骤,自动检查时立刻完成、什么也不画;被 `openOnboarding(id)` 明确打开时调用 DSH 交给步骤的 `openSection('models')` 再完成。这些都是 DSH 有文档的接口。
-- 设置 → 通用 → 位置(桌面应用):总工作区和数据位置各有〔打开〕〔更换…〕;`~/.dsh` 有团队时有「从 DeepSeek Harness 复制团队…」(复制到一个新的数据文件夹,现在的团队原样保留);跳过过工作文件时有「复制 DeepSeek Harness 里的工作文件…」;还有标红、要点两次的「用新的空白团队开始…」(在新文件夹新建,现在的数据原样保留)。这些都在新文件夹里完成,新引擎 `ready` 之后才切换 `locations.json`,失败就继续用原来的,不需要恢复。
+- 设置 → 通用 → 位置(桌面应用):「位置」一行显示数据文件夹和总工作区,各有〔打开〕,一个〔移到…〕把两个一起搬到新的根 `R` 下面的 `data` 和 `workspace`(定根和首次启动同一条规则)。搬是搬,旧位置不留副本。确认写明会搬什么、删什么:「会把数据和工作文件搬到 `D:\DeepSeek Bot`。搬完后 `C:\Users\<用户名>\.ds-bot` 和 `C:\Users\<用户名>\DeepSeek Bot` 会删除。」〔搬过去〕〔取消〕。搬之前先查目标卷的剩余空间(不同的卷要「数据 + 要搬的工作文件 + 1 GB」),不够就在确认里说清差多少,不动手。
+ - 只搬应用自己建的文件夹。数据文件夹看 `.deepseek-bot` 标记;总工作区没有标记,应用建它时(默认的 `~\DeepSeek Bot`、`R\workspace`)在 `locations.json` 里记一笔 `workspaceCreated`。用户自己挑的现成文件夹(老版本允许过的 `D:\`、`D:\Projects`,「高级」里设的)不搬也不删:团队改用 `R\workspace`,旧文件夹原样留下,设置里写「旧的工作文件夹 `D:\Projects` 原样保留」。没有标记的数据文件夹按卸载的清单逐条搬(同一个卷逐条改名,不同的卷逐条复制再删),清单外的东西不动,`R` 不能在清单里的条目里面。
+ - 先在 `%APPDATA%` 写一份「搬到一半」的记录(从哪、到哪、改名还是复制、到了哪一步),再停引擎。同一个卷上,数据文件夹和总工作区各自改名过去,不复制、不多占、立刻完成;改名失败(文件夹被资源管理器或编辑器开着)就退回到复制那一支。不同的卷上,数据经暂存复制到 `R\data`。两种情况都在副本的 `bot/state.json` 里删掉 `workspaceId`(和导入一样)。重开的进程按这份记录在新位置启动,`DS_BOT_WORKSPACE` 指向 `R\workspace`,插件在下一个回合登记它,用总工作区的 Bot 和群照常换段;新引擎 `ready` 之后才写 `locations.json`,然后删掉旧的数据文件夹(复制那一支;有标记整个删,没标记只删清单里的条目),记录转成「总工作区还在搬」。没到 `ready`、或者中途被杀掉:下次启动按记录退回,改名的改回去,复制的删掉应用自己建的 `R\data`,再在原来的位置启动,记录删掉。恢复页的〔换个位置…〕走同一套。
+ - 总工作区里的文件在重开后由应用后台搬到 `R\workspace`(和导入的第二段同一套,记录在 `bot/work-files.json`):每个文件先进同卷暂存、硬链接落位,落位成功、原件的大小和修改时间没变就删掉原件(链接只删链接本身,不跟进去);新位置已经有同名文件的跳过,留在原处;Bot 或群自己设的文件夹在旧总工作区里面时,那棵子树不搬,照旧归它们;扫描之后才写进旧文件夹的文件不在清单里,留着。最后删掉空的文件夹。设置里写「旧文件夹里只剩 3 个没搬过来的文件(新位置已经有同名文件)」〔打开旧文件夹〕。「高级」里才能单独换其中一个,换总工作区照旧不用重启。
+ - `~/.dsh` 有团队时有「从 DeepSeek Harness 复制团队…」:复制到一个新的数据文件夹(现在的旁边,名字加序号,先过第 4 节第一段的空间检查),现在的团队不删:只有一个没说过话的空白 Main Bot 时,`ready` 之后删掉它;有用户的对话就留着,「位置」里多一行「以前的团队还在 `C:\Users\<用户名>\.ds-bot`(0.8 GB)」〔切回〕〔打开文件夹〕〔删除…〕,也记进 `locations.ini`,卸载时选「是」能按同一张清单清掉它。导入过的另显示 DeepSeek Harness 原团队的位置和大小(第 4 节);工作文件还在后台复制时显示进度和〔停止〕,停过或没复制完的显示「工作文件还有 384 个没复制」〔继续复制〕;还有标红、要点两次的「用新的空白团队开始…」(在新文件夹新建,现在的数据同样留着,列在「以前的团队」里)。只有〔移到…〕和恢复页的〔换个位置…〕删旧的;复制团队和空白团队都在新文件夹里完成,新引擎 `ready` 之后才切换 `locations.json`,失败就继续用原来的,不需要恢复。
- 设置 → 关于:下载更新时显示百分比和大小(「正在下载 0.2.4(37%,78/212 MB)」),「下载失败」和「没能检查更新」分开,各带〔重试〕〔手动下载〕;「保存诊断信息…」把诊断表和日志最后 200 行存成一个 .txt(默认放桌面),报问题不需要能上 GitHub。反馈页里形态显示为「DeepSeek Bot 应用」(今天会误报成 DSH Web)。
- **更新**:更新器随应用启动(不再等导入结束),首次启动和导入期间不弹重启提示。中文界面或中国时区先试镜像、再试 GitHub,其他情况反过来,记住上次能用的源。60 秒没有收到数据的下载会取消并换源;两个都失败时显示「没能检查更新:连不上更新服务器。」〔重试〕〔手动下载〕,不阻塞任何东西。
@@ -212,27 +225,35 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
### 用词
-- 一个东西一个名字:DeepSeek Bot(应用)、DS Bot(项目和插件)、DeepSeek Harness(底层;界面里只在讲它本身时出现:导入和复制团队、「预览版说明」的提醒、它的沙盒问题、「高级设置(DeepSeek Harness)」)、本机引擎(启动页上对应用启动的 DSH 的叫法)、主 Bot(Main Bot)、群聊、总管(中文界面里第一个 Main Bot 的默认名字,待定)、模型、API Key、DeepSeek 账号、提供商、数据位置(设置项的名字;说那个文件夹本身时叫「数据文件夹」)、总工作区。
+- 一个东西一个名字:DeepSeek Bot(应用)、DS Bot(项目和插件)、DeepSeek Harness(底层;界面里只在讲它本身时出现:导入和复制团队、「预览版说明」的提醒、它的沙盒问题、「高级设置(DeepSeek Harness)」)、本机引擎(启动页上对应用启动的 DSH 的叫法)、主 Bot(Main Bot)、群聊、总管(中文界面里第一个 Main Bot 的默认名字,待定)、模型、API Key、DeepSeek 账号、提供商、位置(设置项的名字,里面是数据文件夹和总工作区)、数据文件夹、总工作区。
- 本文里「引擎」指桌面应用启动的 DSH 子进程,「引擎的页面」是它提供的网页前端;「Host」只指插件的 `ds-bot/src/host`。
- 第一次介绍产品的地方都写「不是 DeepSeek 官方产品」。
- README.md 和 README.zh.md 各加一行名词解释:DeepSeek Bot / DS Bot / DeepSeek Harness。
-- 中文界面里用户能看到的英文,只允许专有名词(DeepSeek、DS Bot、Bot、API、Key、Harness、DSH、Agent、MCP、Windows、PowerShell、GitHub、SmartScreen、OneDrive、HTTP、SOCKS)、模型名、文件名、路径、网址、环境变量名和单位(KB、MB、GB);「技术详情」和「详细信息」里的原文不算。测试会扫描。
+- 中文界面里用户能看到的英文,只允许专有名词(DeepSeek、DS Bot、Bot、API、Key、Harness、DSH、DSH Desktop、DSH Web、Agent、MCP、Windows、PowerShell、GitHub、SmartScreen、OneDrive、HTTP、SOCKS)、模型名、提供商名(如 OpenRouter)、用户自己起的名字(Bot、群聊)、文件名、路径、网址、环境变量名和单位(KB、MB、GB);「技术详情」和「详细信息」里的原文不算。测试会扫描。
## 改动的已定设计
| 原来的设计 | 现在 |
|---|---|
-| [桌面应用](2026-10-16-desktop-app.md)「首次启动分别选数据位置和总工作区……用的是系统对话框」 | 窗口先出来,显示应用自己的启动页;默认位置直接用,只在需要时出卡片;选择框挂在窗口上,两个位置分开改 |
+| [桌面应用](2026-10-16-desktop-app.md)「首次启动分别选数据位置和总工作区……用的是系统对话框」 | 窗口先出来,显示应用自己的启动页;默认位置直接用,只在需要时出卡片;换位置只选一个文件夹,按第 3 节定根 `R`,数据和总工作区一起放在 `R\data` 和 `R\workspace`;盘不够或默认位置不能用时先推荐一个固定盘,系统选择框只在「其他位置…」之后,只在应用改了所选路径时才确认 |
+| 同上「两个位置不能一个在另一个里面」 | 保留;一个位置的两个子文件夹是兄弟,不互相包含 |
+| 本文首稿 §3「找到以前的 DS Bot 数据……〔接着用(推荐)〕〔用新的空白团队开始…〕」 | 不问,直接接着用;空白团队在设置里 |
+| 本文首稿「不做什么」:不扫描 D: 到 Z: 去推荐数据位置 | 只在盘不够或默认位置不能用时枚举一次固定盘,可移动盘、网络盘和光驱仍然一概不碰 |
+| 本文首稿 §3「OneDrive 里的总工作区只提醒,不拒绝」 | 一个位置之下总工作区和数据是兄弟,位置在 OneDrive 里就整个不能用,首次启动不再有这张提醒卡 |
+| 同上 换数据位置「选一个空文件夹或新文件夹……也不能选整个磁盘」 | 选磁盘根目录或别人的非空文件夹时,应用在里面加一层 `DeepSeek Bot`(第 3 节定根的规则),只在加了这一层时确认 |
| 同上「结构」「窗口」:窗口加载引擎自己的本机地址 | 窗口先加载应用自己的启动页,引擎起来后再加载引擎的本机地址(同一个地址和端口) |
-| 同上「首次启动没走完就退出时什么都不记」 | 保留;`locations.json` 改在引擎第一次 `ready` 之后才写,另写 `locations.ini` 和 `.deepseek-bot` 标记 |
-| 同上「问要不要导入,只在首次启动问一次」 | 首次启动仍然问(带预览和大小),之后在 设置 → 通用 → 位置 里随时可以复制到一个新的数据文件夹 |
+| 同上「首次启动没走完就退出时什么都不记」 | 保留;`locations.json` 和 `locations.ini` 改在引擎第一次 `ready` 之后才写;`.deepseek-bot` 标记在新建数据文件夹时就写,没走完留下的文件夹下次认得出 |
+| 同上「问要不要导入,只在首次启动问一次」 | 首次启动仍然问,但只有一句话和两个按钮(预览、模型设置和勾选项折叠在「详细」里),卡片一出现就开始检查对话和预热引擎;之后在 设置 → 通用 → 位置 里随时可以复制到一个新的数据文件夹 |
| 同上「DSH 正在用这个团队时,请用户先关掉」 | 判断加上锁的刷新时间;自动重查,不用反复点重试 |
-| 同上「旧团队工作文件夹里的文件复制到新的总工作区,不覆盖已有的文件」 | 仍然不覆盖;默认跳过可重新生成的文件夹;工作文件可以以后再复制 |
+| 同上「旧团队工作文件夹里的文件复制到新的总工作区,不覆盖已有的文件」 | 仍然不覆盖;默认跳过可重新生成的文件夹;团队在对话复制完就打开,工作文件在团队打开后由应用后台复制,退出后下次接着,设置里能停和续 |
| 同上「几个 profile 都有时让用户选一份」 | 自动选,按提供商和默认模型显示,可以更换 |
| 同上 有新版本对话时按钮是「退出 / 不带团队开始」 | 能更新就「更新后再复制」;不能就以「先不带团队开始」为主 |
| 同上「模型服务商和 key 在 DSH 自己的设置里配」 | 在 Main Bot 的设置卡和 DS Bot 设置 → 模型里配(仍写进 DSH 的凭据和设置);应用关掉 DSH 的自动凭据引导;DSH 的模型页放在「高级设置(DeepSeek Harness)」 |
| 同上「暂时不做」:DS Bot 自己的界面先停下 | `app/ui` 仍然停着;应用只画启动、导入、失败这几页,不画 Bot 界面 |
-| 同上「改位置」 | 加「从 DeepSeek Harness 复制团队…」「复制 DeepSeek Harness 里的工作文件…」「用新的空白团队开始…」 |
+| 同上「改位置」:总工作区和数据位置各自更换,换总工作区时旧文件夹里的文件不动 | 「位置」一处〔移到…〕:停引擎,同一个卷上改名,不同的卷上数据经暂存复制到新位置、重启后总工作区的文件也后台复制过去(原来不复制),用总工作区的 Bot 和群在下一个回合换段;单独换其中一个在「高级」里;加「从 DeepSeek Harness 复制团队…」、后台复制工作文件的进度、〔停止〕和〔继续复制〕、「用新的空白团队开始…」 |
+| 同上「换数据位置」:「旧数据文件夹原样保留,用户确认没问题后自己删」;「换总工作区」:旧文件夹和里面的文件不动 | 搬是搬,只搬应用自己建的文件夹:新引擎 `ready` 之后删掉旧的数据文件夹(和卸载同一张清单),工作文件逐个落位后删原件,只留跳过的;用户自己挑的现成文件夹原样保留,只是团队改用新的;「搬到一半」的记录让没搬完的退回;确认里写明会删什么。空间不再占两份 |
+| 同上「换数据位置」里的「从 DeepSeek Harness 复制团队」和「用新的空白团队开始」 | 不删现在的团队(只有没说过话的空白 Main Bot 时除外),「位置」里列出「以前的团队」的路径和大小,能切回、打开、删除;记进 `locations.ini` |
+| 同上「首次启动……先在新数据位置启动一次再复制」里的检查副本 `.import-check-<时间>` | 对话只复制一次:卡片一出现就复制进 `.import-<时间>` 暂存并在那里检查,答〔复制过来〕时接着用这份;附件从暂存改名进位 |
| 同上 Windows 安装向导,可以改程序位置 | 一键安装、装完自动打开(待定) |
| 同上「卸载不删数据位置」 | 卸载时问一次,默认不删 |
| 同上 更新检查在首次启动的导入之后开始;启动失败时错误框里提新版本 | 随应用启动;首次启动和导入时不弹重启;镜像优先;失败页里直接给更新 |
@@ -269,15 +290,20 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
| M1 去掉死路 | 应用:「下载」文件夹兜底;`credentialOnboarding: false`;`focusWindow` 在失败时也能聚焦;导入的锁判断、失败清理暂存、`room.id`(合 #567)、不覆盖已有 key。插件:在所有形态接上提供商接口(模型页和 key 卡片活过来);key 卡片加「去创建 Key」链接和余额说明;默认模型只从能用的里选;先打字不再删开场白;`bot.blocked` 和 Bot 聊天的修复卡,「重试」不重发;鲸鱼菜单加「模型和 API Key」「登录」;「高级设置」改名,DSH 设置直接落在「模型」页。文档和发版:README 双语下载区和信任说明、安装问题表单、Release 下载表、`SHA256SUMS` 和固定文件名(README 先链到 `releases/latest` 页面)、最后才标为 Latest | 约 4 人日 |
| M2 Main Bot 聊天里的第一条回复 | 设置卡:浏览器登录的完整状态、回到前台(应用的 `dsBotApp.focus()`)、余额和赠送额度、充值后自动重查;粘贴 key 时的余额检查(mock 模型提供 `sk-test-ok` / `sk-test-bad` / `sk-test-empty`);插件 Host 侧的「能用」检查和自动选模型;「已接上 · 更换」;输入框锁定;试试按钮和工作文件夹行;中文默认名字(如果定下来) | 约 6 人日 |
| M3 国内能下、一键安装、卸载说清楚 | 镜像发布和镜像优先的更新(随应用启动、首次启动和导入时不弹重启、可取消的下载、60 秒无数据换源、百分比);一键安装;卸载时的问题、`locations.ini`、标记文件;CI:一键升级覆盖旧的自定义目录、交互式卸载(UI Automation 答「否」和「是」)、固定链接检查;README 换成固定下载链接,加「卸载和重置」 | 约 5 人日 |
-| M4 窗口先出来:启动页、卡片和恢复页 | 启动页、它的 IPC 和来源检查、中英文案;`main.mjs` 重排;位置检查和重装识别;失败页和 180 秒提示;日志;`dsBotApp.ready()` 和 20 秒界面检查;#559。CI:打包后的首次启动,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户,经 CDP 驱动启动页,并检查日志里没有 key、token 和用户名 | 约 7 人日 |
-| M5 启动页上的导入 | 预览、大小和可跳过的文件夹;并行预热;自动重查占用;新版本对话走「更新后再复制」;空间检查;进度和停止;设置里的再次导入;导入后的检查卡和 Main Bot 提前换段(#384)。CI 用假的 `~/.dsh`(含 junction、新版本对话、PID 被重用的旧锁、群聊、大 `node_modules`) | 约 5 人日 |
-| M6 第一个小时和回头入口 | 系统代理和网络设置;沙盒失败提示(#523);PowerShell 5.1 说明;GitHub 代理提示;关窗提醒(#500);保存诊断信息;「DeepSeek Bot 应用」形态;「用新的空白团队开始」 | 约 4 人日 |
+| M4 窗口先出来:启动页、卡片和恢复页 | 启动页、它的 IPC 和来源检查、中英文案;`main.mjs` 重排;位置检查、推荐盘、一个位置的布局和确认、重装不问;失败页和 180 秒提示;日志;`dsBotApp.ready()` 和 20 秒界面检查;#559。CI:打包后的首次启动,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户,经 CDP 驱动启动页,并检查日志里没有 key、token 和用户名 | 约 7 人日 |
+| M5 启动页上的导入 | 一句话的导入卡和折叠的详情(预览、大小、可跳过的文件夹);卡片一出现就检查对话和预热引擎,「先不复制」不重启引擎;自动重查占用;新版本对话走「更新后再复制」;第一段的空间检查、进度和停止;工作文件在团队打开后后台复制,设置里的进度、停止、续复制;设置里的再次导入;导入后的检查卡和 Main Bot 提前换段(#384)。CI 用假的 `~/.dsh`(含 junction、新版本对话、PID 被重用的旧锁、群聊、大 `node_modules`) | 约 5 人日 |
+| M6 第一个小时和回头入口 | 系统代理和网络设置;沙盒失败提示(#523);PowerShell 5.1 说明;GitHub 代理提示;关窗提醒(#500);保存诊断信息;「DeepSeek Bot 应用」形态;设置里「位置」一处〔移到…〕一起搬、「高级」里分开换;「用新的空白团队开始」 | 约 4 人日 |
| M7 签名 | 签名钩子、`publisherName`;README 的信任说明缩成杀毒软件一条;winget 清单 | 约 2–3 人日,加外部审批 |
## 验收
- 打包后的 Windows CI,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户:进程启动后 2 秒内窗口可见(目标 1 秒,CI 留余量);引擎的页面之前不出现任何卡片;能进到引擎的页面。
- 首次启动期间没有一个 `dialog.show*` 不挂在主窗口上(单元测试扫描调用处),窗口出来之前没有系统对话框。
+- 数据所在的盘不够 5 GB(CI 用替身的空间查询):只有一张卡片、一个主按钮,按 Enter 就过,不出现系统选择框。枚举盘的 PowerShell 只在盘不够或默认位置不能用时运行一次,正常启动和重装的日志里没有它;没有剩余 20 GB 以上的其他固定盘时不出卡片,提示行写剩余空间。〔放到 D 盘〕之后 `D:\DeepSeek Bot\data` 和 `D:\DeepSeek Bot\workspace` 都存在,`locations.json` 指向它们;〔仍然放在 C 盘〕之后 D 盘上没有留下试写建的文件夹。
+- 有 `~/.ds-bot` 团队、没有 `locations.json` 的一次性用户:没有卡片,C 盘不到 5 GB 时也没有,说明里写「接着用上次的数据」,进去就是原来的团队。
+- 导入:点〔复制过来〕后,对话复制完团队就打开,`bot/work-files.json` 记着工作文件没复制完;工作文件在后台到齐后记成已完成;复制一半退出再启动会接着复制,已有的文件一个不覆盖;〔先不复制〕不重启引擎,暂存已删。
+- 空间只占一份(CI 用替身的空间查询和一个 2 GB 的假团队):整个导入过程中数据所在的盘最多少掉「第一段 + 500 MB」,没有 `.import-check-*` 文件夹,`~/.dsh` 的内容和修改时间一个都没变;工作文件复制完后新旧两处各一份,设置里显示原团队的位置和大小;剩余空间降到 500 MB 以下时后台复制停下,设置里有〔继续复制〕。导入卡开着、DSH 还占着团队时数据文件夹里没有 `.import-*`,锁放开后才出现;暂存期间锁刷新过,暂存会重做;导入卡开着时关窗、更新重开,下次启动前暂存已删。
+- 〔移到…〕同一个卷:完成不超过 2 秒,旧路径不存在,数据没有被复制(inode 不变);改名失败时退回到复制;不同的卷:新引擎 `ready` 后旧数据文件夹被删,工作文件逐个落位后原件被删,复制完旧总工作区里只剩跳过的文件,数量和设置里写的一致;用户自己挑的总工作区一个文件都不动;新引擎没 `ready` 或中途被杀掉时,下次启动退回原位置,`R` 下面没有留下应用建的东西,`locations.json` 不变。
- mock 模型粘贴 `sk-test-ok`:第一个 Main Bot 的 Session 里没有失败节点,引擎的页面出来后 30 秒内收到开场白;CI 上从双击安装包到开场白不超过 90 秒。
- `sk-test-bad` 不会被保存(`credentials.describe` 仍是未配置),卡片显示 401 的文字,Session 里没有回合。`sk-test-empty` 会保存,但 `/user/balance` 报出余额之前不跑开场白,卡片显示「去充值」。
- 插件 Host 的单元测试(替身 `deepseekAccount`):未登录和零余额的账号不会产生开场白回合;有余额的会在自动选模型后产生;`getBalance` 失败时照常往下走。
@@ -307,6 +333,8 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
| 中文界面里第一个 Main Bot 叫什么? | 「总管」,角色「团队负责人」;保留「Chief」,角色「团队总管」;「总管家」,角色「团队负责人」 | 「总管」,角色「团队负责人」,按建团队时的界面语言决定;英文不变,配置优先,已有团队不改,测试和 README 同一个 PR 里改 |
| 安装包要不要改成一键安装? | 一键、只装给当前用户、装完打开、没有目录页(`/D=` 自定义);保留向导,但去掉目录页、默认勾选「运行」 | 一键安装。少两次点击(「安装」「完成」),也去掉了最技术化的一页 |
| 插件形态(DSH Desktop、DSH Web)里,第一个 Main Bot 也自动选模型并打招呼吗? | 所有形态都这样(只有一个提供商能用且检查通过时);只在桌面应用这样,插件形态仍然「先选再打招呼」 | 所有形态。开场白本来就是用户选完模型后会触发的一次调用;检查优先用不调用模型的余额查询;「已接上 · 更换」让选择看得见、改得了 |
+| 换位置时两个子文件夹叫什么? | `data` 和 `workspace`;`数据` 和 `工作区`;按界面语言取名 | `data` 和 `workspace`:路径里允许英文,和插件、文档里的词一致,换语言、换机器都一样 |
+| 默认安装也改成一个根文件夹吗? | 不改,仍是 `~\.ds-bot` 加 `~\DeepSeek Bot`;改成 `~\DeepSeek Bot\data` 加 `~\DeepSeek Bot\workspace` | 不改:老用户、插件版和 README 都认今天的默认,隐藏的 `.ds-bot` 也不容易被误删。「一个位置」是一个动作,不要求一个路径 |
| 导入后哪些 Bot 提前换到新文件夹?(每次换段都要写交接说明,花 token) | 只有 Main Bot;Main Bot 加最近 30 天用过的 Bot,一个一个来;都不提前,只在第一条消息时显示换段状态 | 只有 Main Bot:它是用户落地的聊天,成本最低就能去掉看得见的等待 |
| 引擎默认跟随 Windows 系统代理吗? | 默认开,设置里能关,用户自己的环境变量或 `.env` 优先;默认关,能打开 | 默认开。大陆用户开着 Clash、v2rayN 的系统代理,会期待 GitHub 和国外提供商像浏览器里一样能用;代理不对时修复卡会点名代理和开关 |
| Bot 聊天里余额不足时,DSH 的余额提示(Toast,不分 Session)还会和修复卡同时出现,怎么办? | 接受两处同时出现;接管这条提示(会影响所有 Session) | 先接受,记进「已知限制」,并向 DSH 提需求(「需要 DSH 提供的」第 7 条) |
@@ -316,7 +344,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 不在应用里另做一套配置模型的欢迎向导:模型只在 Main Bot 的设置卡和 DS Bot 设置 → 模型里配。
- 不伪装 `dshDesktop`,不用 CSS 或 DOM 去藏、改 DSH 的界面;DSH 的「预览版说明」等它的开关。也不预先写入它的「已读」版本号(`ui-settings-general` 的 `welcomeNoticeVersion`):那等于替用户点了「继续」,版本号也没有公开导出,写在补丁层里还会让用户以后点「继续」时保存失败。
- 不改 DSH,不依赖 DSH 安装里的文件。DSH 的内部接口只用已经在用的 `@deepseek-ai/dsh-app-boot`、`@deepseek-ai/dsh-session-format`、`@deepseek-ai/dsh-session-format-catalog` 和 `settings.models.sign-in` 条目注入的操作(设置卡会多调 `setOnboarding`、`showLogin`、`cancel`、`refreshAccount`,见「已知限制」),不再新增。
-- 不扫描 D: 到 Z: 去推荐数据位置:读卡器、U 盘和网络盘一概不碰,只检查建议的那个位置所在的盘和用户自己选的文件夹。
+- 不在每次启动时扫盘:固定盘只在盘不够或默认位置不能用时枚举一次;读卡器、U 盘、移动硬盘、网络盘和光驱一概不碰,也从不推荐它们。
- 卸载从不删除总工作区、磁盘根目录和家目录。
- 日志、复制出来的详细信息、诊断文件和文档里不出现 key、token 和真实的用户路径;界面上的位置只给用户本人看。截图只用一次性目录。
- 不用其他产品的文字、图标和插图(包括 DSH Desktop 的欢迎页插图和字体);信任说明用自己画的示意图。
@@ -338,8 +366,14 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 跟随系统代理可能让 DeepSeek 的流量走一个用户忘了的、或者已经退出的代理;诊断和修复卡会点名代理,可以关掉。
- `NODE_USE_SYSTEM_CA` 在 `ELECTRON_RUN_AS_NODE` 下是否有效未验证;验证不了就不设,使用 TLS 检查的公司网络仍然连不上,只是提示更明确。
- 导入后 Main Bot 提前换段要读一遍最近的对话写交接说明,冷缓存时会花不少 token(#384 实测 17 万 token)。
+- 推荐的盘按总线类型排除了 USB、SD 和虚拟盘,但报告成固定盘的移动硬盘仍可能被推荐;PowerShell 被策略禁掉的机器上没有推荐盘,只有「其他位置…」。
+- 〔移到…〕之后应用自己建的旧总工作区不在了(改名或逐个搬走),DSH Agent 的 Session 要重新选文件夹;Bot 和群的 Session 换段,不受影响。用户自己挑的总工作区不搬,搬完后它和 `R\workspace` 都在:团队换了文件夹,不是占两份。
+- 从 DeepSeek Harness 复制过来的团队在两边各占一份:应用从不写 `~/.dsh`,所以不能替用户删原件,只能把多占的空间写在卡片和设置里。
+- 后台复制工作文件在不支持硬链接的文件系统(FAT、exFAT)上退回到「查一次再改名」,查和改名之间 Bot 新建的同名文件会被盖掉。
## 变更
- 2026-10-26:定下 Windows 上手流程。依据:`dev` 上的实测(全新用户,中文界面)、代码和 DSH 0.2.1-rc.2 的包、GitHub 上的 Issue 和 Discussions、同类应用的上手做法(只取原则)。
- 2026-10-26:实现 M1 时补正:Edge 的「保留」后还要点「显示更多」;README 先链到 `releases/latest` 页面,固定下载链接随 M3 的检查上;安装问题表单问系统的显示语言,不只是 Windows 的;导入时只有引擎写的 `client-connection/` 记录的 `.credentials.yaml` 不算用户的,照常换成旧的。
+- 2026-10-26:维护者反馈位置选择生硬,简化 §3 和 §4:换位置只选一个文件夹,数据和总工作区一起放进去;盘不够或位置不能用时推荐一个固定盘,系统选择框退到「其他位置…」之后,只在应用改了路径时确认;重装不问;导入卡缩成一句话两个按钮,卡片一出现就检查和预热;复制分两段,团队在对话复制完就打开,工作文件后台复制。卡片的样子在 [启动窗口](2026-10-26-start-window.md) 里。评审后补正:定根的规则写成一条;重装接着用时不出位置卡;后台复制不用 `fs.cp`,经暂存和硬链接落位;导入卡开着时主窗口不加载引擎的页面;〔移到…〕靠删掉 `workspaceId` 和 `DS_BOT_WORKSPACE` 换总工作区,文件在重启后后台复制。
+- 2026-10-27:维护者要求空间不能占两份:§4 加「空间只占一份」(对话只复制一次、附件改名进位、第一段和第二段各有空间下限、卡片写明多占多少、设置里显示原团队的位置和大小);§8 的〔移到…〕改成真正的搬(同一个卷改名,不同的卷复制完删旧的),恢复页的〔换个位置…〕同样。评审后补正:暂存前先查锁,占用卡和「正在下载」卡有〔先不复制〕;标记在建文件夹时就写,每次启动先删上次的暂存;〔移到…〕只搬应用自己建的文件夹、按「搬到一半」记录退回、逐个搬工作文件、搬前查空间;复制团队和空白团队不删现在的团队,设置里列出「以前的团队」;〔重新找到它…〕的规则;被拒绝的位置卡留着来时的按钮;Bot 知道工作文件还没到齐,`workDir` 在 `~/.dsh` 里的改到新总工作区;空间例子改成 1.7 / 1.5 / 0.2 GB;推荐盘的门槛加上导入要多占的数;Key 余额为零的卡加〔换一种方式〕;允许名单补 DSH Desktop、DSH Web、提供商名和用户起的名字。
diff --git a/docs/plans/README.md b/docs/plans/README.md
index bcd39f02..a89374b0 100644
--- a/docs/plans/README.md
+++ b/docs/plans/README.md
@@ -49,4 +49,5 @@
| [Bot 视图](2026-10-20-widget-views.md) | Bot 在回答里画视图:固定组件目录的 JSON 蓝图(含图表、输入和本地公式),目录外的放沙箱 html;提问卡回路的泛化 |
| [Side chat(侧边对话)](2026-10-21-btw.md) | 人顺带问一句:侧栏里的常驻对话,以与会话同构的请求回答、不执行工具、不打断、不进模型可见历史;可追问、可开多条;Bot 之间的 `ask_bot` 另行提案 |
| [消息布局和宽度](2026-10-22-message-layout.md) | 气泡 / 平铺两种布局;平铺时 Bot 的话带头像、名字、时间;气泡宽度和平铺正文宽度各用一个滑块,按正文列的百分比调 |
-| [Windows 上手流程](2026-10-26-windows-onboarding.md) | 从下载到第一条回复:下载区和信任说明、安装、窗口先出来的启动页、启动页上的导入、Main Bot 聊天里的模型设置卡(登录或检查过的 key、自动选模型)、修复卡、第一个小时的 Windows 问题、卸载时问一次 |
+| [Windows 上手流程](2026-10-26-windows-onboarding.md) | 从下载到第一条回复:下载区和信任说明、安装、窗口先出来的启动页、一个位置和推荐盘、启动页上的一键导入、Main Bot 聊天里的模型设置卡(登录或检查过的 key、自动选模型)、修复卡、第一个小时的 Windows 问题、卸载时问一次 |
+| [启动窗口](2026-10-26-start-window.md) | 启动页的样子和动作:单独的小窗口(待定),Main Bot 的鲸鱼沿着水线一站一站游过三个真实阶段,等待越久越慢,卡片和失败页在同一张纸面上变形,就绪时潜下去、团队窗口盖上来 |