Skip to content

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

Design the whale-as-progress start window, the multi-select goal card and the AI-native onboarding

AdamPlatin1234ad63b6616a9
diff --git a/docs/plans/2026-10-26-start-window.md b/docs/plans/2026-10-26-start-window.md
index 5dd705e3..bb55400e 100644
--- a/docs/plans/2026-10-26-start-window.md
+++ b/docs/plans/2026-10-26-start-window.md
@@ -1,14 +1,15 @@
# 启动窗口:领航鲸
- 日期: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)
+- 相关:[Windows 上手流程](2026-10-26-windows-onboarding.md) 第 3、4、5、6、8 节,#559
+- 一起改:[Windows 上手流程](2026-10-26-windows-onboarding.md)(第 3 节、第 4 节、第 5 节、第 8 节、用词、「改动的已定设计」、分批上线、验收、待定、已知限制)、[桌面应用](2026-10-16-desktop-app.md)(结构、窗口)、[UI 标准](../design/ui-standard.md)(1、3.1、4.4、8.3、8.4、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 节定了这段时间显示什么(真实阶段、说明、卡片、恢复页),没定它怎么动。
+- 引擎第一次启动要 3 到 20 秒,以后要 3 到 12 秒。第 3 节定了这段时间显示什么(真实阶段、卡片、恢复页),没定它怎么动。
- 主 Bot 的鲸鱼是 DS Bot 自己生成的形象,用户进团队后第一眼看到的也是它。启动时让它替用户「干活」,用户进门前就认识了它,也先见过它的状态动作。
+- 双击以后的这几秒里做不了有用的事。窗口只做四件事:证明应用活着、在动;一眼说清下一步;只问等不了的事(导入、盘不够);把形象带进团队窗口。所以鲸鱼在哪里,进度就在哪里,字都是它说的,一次一句短话:窗口显示用户感受到的东西,不显示实现的结构(维护者 2026-10-27 的反馈)。
- 等待只取这些原则:
- 有事做、有解释的等待显得短(Maister)。
- 看得见真实的工作更让人放心,假进度适得其反(Buell 和 Norton;Harrison 等)。
@@ -16,7 +17,7 @@
- 入场不超过 1 秒,不为动画推迟启动(Android 启动画面)。
- 天天看的画面动得越少越好(Kowalski)。
- 启动页是本地文件,引擎的页面在 `http://127.0.0.1`,两者跨源。同一个窗口里 `loadURL` 时,Chromium 不保留旧画面,也做不了跨文档过渡;不改 DSH 就接不上。窗口会先空一下,再露出 DSH 自己的加载过程,「打开团队」这一步用户其实看不到。
-- 所以启动页放进单独的小窗口,团队界面在隐藏的主窗口里加载,挂载好了才露面。小窗口一直有 Mica,交接时没有空白帧。
+- 所以启动页放进单独的小窗口,团队界面在隐藏的主窗口里加载,挂载好了才露面。小窗口一直有 Mica,交接时没有空白帧。交接时小窗口先长成主窗口的矩形,主窗口再在同一个矩形上露面,不再从小窗口一下跳成大窗口。
## 已定的行为
@@ -28,78 +29,97 @@
- 无边框,40 px 的标题带可以拖动,里面什么都不放。
- Windows 11 22H2 及以后用 Mica。
- 在光标所在的显示器上居中。
-- 启动窗口从不改大小。首次启动、以后的启动、卡片、失败页都在这一个尺寸里。
+- 启动窗口在交接之前不改大小:首次启动、以后的启动、卡片、失败页都在这一个尺寸里。只在交接时改一次:主进程把它长成主窗口的矩形(第 8 节)。
- **主窗口**照旧 1320 × 860:
- - 启动窗口第一次画好以后,主窗口隐藏着建好。
+ - 启动窗口第一次画好以后,主窗口隐藏着建好,就建在它最后的矩形上:以启动窗口的中心居中,不超出工作区;启动窗口被拖动过时,交接前按它那时的位置重新放好。露面时不再改位置和大小。
- 引擎起来后,在里面加载引擎的本机地址(同一个地址和端口)。例外:导入卡开着、用户还没回答时不加载(插件一收到 `state` 就会建出空白团队),等回答以后、〔复制过来〕的第一段复制完以后才加载。
- - `dsBotApp.ready()` 之后才显示,启动窗口随后关掉。
+ - `dsBotApp.ready()` 之后才显示:启动窗口先长到同一个矩形,主窗口在它上面露面,启动窗口随后销毁(第 8 节)。
- 交接前关掉启动窗口(× 或 Alt+F4)就退出应用,走现在的退出流程:停引擎,正在复制的就停下。
- 交接前再双击图标,恢复并聚焦启动窗口;交接后聚焦主窗口。
- 首次启动的选择框和提示都挂在启动窗口上。选择框从不自己弹出,只在用户点了选文件夹的按钮或链接之后出现。
+- 登录窗口([上手流程](2026-10-26-windows-onboarding.md) 第 5 节)是主窗口的子窗口,只在交接之后、用户点了某个登录入口(设置卡的〔登录 DeepSeek 账号〕、〔重新登录〕、修复卡、鲸鱼菜单)时出现;启动窗口阶段没有登录,也没有它。
- 换位置时(〔移到…〕,今天的 `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 上。
+| 部分 | 没有卡片时 | 有卡片时 | 内容 |
+|---|---|---|---|
+| 标题带 | y 0–40 | 同左 | 空,可以拖动 |
+| 已用秒数 | 右对齐 x 672,y 54–72 | 同左位置,隐藏(卡片等回答时暂停,第 4 节) | 「已用 N 秒」,13/18,`--bt-ink-2`,等宽数字,宽度固定 |
+| 水道 | x 48–672,y 156–260 | x 48–672,y 76–180 | 88 px 的鲸鱼,停在三站之一;水线以下的部分被裁掉 |
+| 水线 | y 260 | y 180 | 1 px `--bt-line`,首尾各 12% 渐隐;上面什么都不画 |
+| 圈 | 在水线上,中心 x 180、372 | 同左,跟着水线 | 56 × 12 的细线椭圆,1 px `--bt-line-2`,停住后不透明度 .5;鲸鱼离开第 1 站、第 2 站时各留下一个,第 3 站不留;交接时淡出 |
+| 鲸鱼的话 | y 274–294,居中 | y 194–214,居中 | 15/20、600,`--bt-ink`;只有一行,不换行,实在放不下才用省略号 |
+| 提示行 | y 300–328,居中 | y 220–248,隐藏 | 13/18,`--bt-ink-2`;最多约 22 个字,或者只有〔打开日志文件夹〕;没有要提前知道的事时空着 |
+| 纸面 | 空 | x 48–672,y 260–496 | 只放卡片 |
+| 底注 | x 48,y 504–522 | 同左 | 「社区开源项目,不是 DeepSeek 官方产品」,13/18 |
+
+- 三站是鲸鱼停的三处:x 168 / 360 / 552,依次对应「准备数据文件夹」「启动本机引擎」「打开团队」三个阶段。站上不画标记、名字和连线:鲸鱼停在哪一站,进度就到了哪里。
+- 没有卡片时,水道、水线、圈、鲸鱼的话和提示行整组比有卡片时低 80 px,鲸鱼落在窗口的视觉中心。要出卡片时,整组用 `SPRING_SHAPE` 上移 80 px,卡片出现在下面的纸面里;卡片收回后,整组再回到低处。已用秒数和底注不动。页面不能滚动(第 11 节)。
+- 鲸鱼的话和提示行直接写在 Mica 上。
- 卡片是不透明的 `--bt-card`:1 px `--bt-line` 边,圆角 12,内边距 16 × 20。卡片正文比纸面高时,正文在卡片里滚动,按钮行固定在卡片底部。
- 以后的启动:
- - 没有标题行、三站、说明和底注。
- - 64 px 的鲸鱼在 x 360,下面一行字(15/20、600,居中)。整组下移 80 px,落在窗口的视觉中心。
- - 要出卡片时,整组用 `SPRING_SHAPE` 上移回原位,卡片出现在下面的纸面里。
+ - 没有水线、圈和底注,右上角也没有已用秒数(10 秒起写在下面的提示行里,第 5 节)。
+ - 64 px 的鲸鱼在 x 360,下面一行字(15/20、600,居中)。没有卡片时整组同样低 80 px,落在窗口的视觉中心;出卡片时一样上移。
### 3. 鲸鱼的总规则
-- 只为真实的事动:阶段开始和完成、出卡片、失败、就绪,以及用户的指针和点击。
-- 鲸鱼面朝右。主进程报告一个阶段完成时,它向右游到下一站:不会提前,也从不往回游。
-- 等用户回答时静止。等得越久动得越慢,从不变快。
+- 只为真实的事动:阶段开始和完成、出卡片、失败、就绪,以及用户的指针、点击、键盘焦点和回到窗口。唯一的例外是卡片等用户回答时的呼吸和眨眼(下面第二张表)。
+- 鲸鱼面朝右。主进程报告一个阶段完成时,它向右游到下一站,身后留下一个圈:不会提前,也从不往回游。
+- 等用户回答时停下:正常档和活泼档只有探身、呼吸和眨眼这几个小动作(活泼档另有越跳越稀的跳)。等得越久动得越慢,从不变快。
- 换动作时从当前姿势接着走:读出当前的 `transform`,停掉循环,再用弹簧走到下一个动作的起点。不跳回原位。
-- 一个阶段等满 250 ms 才显示「进行中」;更快完成的阶段直接打勾。
+- 一个阶段等满 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` 等),换算成像素。
+- 鲸鱼说话:
+ - 鲸鱼一次只说一句短话,写在水线下面那一行(第 2 节),用 Main Bot 自己的口吻。窗口里没有大段的文字:旁边只有已用秒数、一行提示、卡片和底注。
+ - 问候里的名字是 Main Bot 的名字(待定):新团队用界面语言的默认名字(中文「总管」,英文 Chief,见 [上手流程](2026-10-26-windows-onboarding.md)「待定」);重装时用团队里 Main Bot 自己的名字,主进程和第 2 站提示里的 Bot、群聊数一起读出来;要导入、或者读不出名字时不带名字:「嗨,我来了」。导入卡答完之前,进门后的 Main Bot 是哪一个还没定:答〔先不复制〕就是新的空白团队。
+ - 那一行跟着鲸鱼走:它停在哪一站、那一站的阶段是不是进行中、它是不是正在游、是不是已经就绪。只看主进程的快照不够,所以话从不跑到鲸鱼前面。
+ - 每句话停够了才换:一般 0.9 秒,问候 1.5 秒,「找到了」0.7 秒;除了失败和 180 秒的问题,一句话至少能读满 300 ms 才被换掉。这期间被跳过的话不补说。失败和 180 秒的问题不等,立刻换上。「进去吧」等上一句能读满 400 ms 就出来。
+ - 换句时淡出 .16 s,再淡入 .16 s。首次启动的这一行没有流光。
+ - 卡片在时这一行空着,由卡片自己的第一行说(第 6 节);入场时就来的卡要等问候读满 1.5 秒才空(第 6 节)。180 秒的卡和失败页例外:180 秒的问题由鲸鱼问,卡上只有按钮;失败页上是已定的标题(第 7 节)。鲸鱼沉下去重新开始时(第 7 节),这一行和提示行也空着。
| 时刻 | 鲸鱼 | 时长和曲线 |
|---|---|---|
| 首次启动入场 | 从水线下浮上来,12° 的倾斜回正;尾巴甩一下;睁眼 | `SPRING_STRETCH` 560 ms;睁眼 160 ms |
| 准备数据文件夹 | 搜索:前倾探头,眼睛左右扫 | 1 s;眼睛 1.6 s |
-| 一个阶段完成 | 下蹲 120 ms,向右滑 192 px,尾巴划两下,眼睛晚 80 ms 跟上;身后的标记弹出对勾;到站点一下头 | `SPRING_SHAPE` 420 ms;对勾 `SPRING_POP` |
+| 一个阶段完成 | 下蹲 120 ms,向右滑 192 px,尾巴划两下,眼睛晚 80 ms 跟上;滑出 90 ms 后,身后留下一个圈:从 .5 倍张开到原大,不透明度从 .9 落到 .5,之后不再动(第 3 站不留);到站点一下头 | `SPRING_SHAPE` 420 ms;圈 `SPRING_SHAPE`,不透明度 420 ms |
| 启动本机引擎 | 工作:上下晃、尾巴摆、眨眼 | 1.6 s、1.1 s、2.4 s;52.8 s 内不完全重复 |
-| 10 秒 | 看向用户 600 ms,慢眨一次眼;所有循环放慢到 0.85 倍 | — |
+| 10 秒 | 看向用户 600 ms,慢眨一次眼;所有循环放慢到 0.85 倍 | 看 600 ms |
| 45 秒 | 换成思考:歪头慢慢起伏、眯眼;尾巴停下 | 2.2 s;换动作用 `SPRING_SHAPE` |
| 打开团队 | 发消息:向前冲,每冲一次尾巴划两下 | 1.1 s |
-| 应用主动问(卡片、180 秒) | 跳两下,然后静止,看着卡片 | 1.3 s × 2 |
-| 用户自己引出的卡片 | 不跳,静止 | — |
+| 应用主动问(卡片、180 秒) | 跳两下,然后停下,看着卡片(停下以后见下一张表) | 1.3 s × 2 |
+| 用户自己引出的卡片 | 不跳,停下 | 无 |
| 失败 | 从当前姿势下沉 4 px、低头 4°,眼皮变重,然后完全静止 | `SPRING_SHAPE` |
-| 就绪(首次启动,或重试后第一次成功) | 压扁再拉长,「^ ^」眼;拉到最长时潜下水线 | 460 ms 加 `SPRING_SHAPE` |
-| 就绪(以后的启动) | 直接潜下去 | `SPRING_TAP` 290 ms |
+| 就绪(首次启动,包括重试或重新开始后第一次成功) | 「进去吧」出来 300 ms 后:压扁再拉长,「^ ^」眼;拉到最长时潜下去,深到鲸鱼身高的 1.25 倍 | 460 ms 加 `SPRING_SHAPE` |
+| 就绪(以后的启动,重试或重新开始后第一次成功) | 字照旧,不说「进去吧」:压扁回弹一次,「^ ^」眼,然后潜下去,同样深到身高的 1.25 倍 | 920 ms 加 `SPRING_TAP` 290 ms |
+| 就绪(以后的启动) | 直接潜下去,同样深到身高的 1.25 倍 | `SPRING_TAP` 290 ms |
+
+鲸鱼还有下面这些小反应,每一个都有原因:卡片在等、用户做了什么,或者交接。它更有反应,不是动得更多。安静档没有 1 到 7;减少动态效果时 1 到 8 都没有;失败页(启动失败、团队界面没有加载出来、复制失败)上也都没有。
+
+| # | 动作 | 什么时候 | 怎么动 |
+|---|---|---|---|
+| 1 | 探身 | 应用主动问的卡片:最后一跳落地时(跳开始后 2.0 s;导入时空间不够的卡 0.7 s)。用户自己引出的卡片:变形开始 70 ms 后。复制中、正在下载和复制失败的卡没有 | 朝卡片前倾 2.5°(`translate(1.5px, -1px) rotate(2.5deg)`,以后的启动按 64/88 缩小),`SPRING_SHAPE`;眼睛仍看着卡片。回答时随点头收回,卡片还在时(比如换了模型设置)1 秒后再探身;抚摸时收回,指针离开后再来 |
+| 2 | 呼吸 | 停下 600 ms 后 | 身体轻轻起伏(`scale` 1 → 1.008 1.018 → 1),4.2 s 一次;按这张卡自己的时钟,30 秒后放慢到 .8 倍,90 秒后 .6 倍,不再变快;状态一变,240 ms 回到原样 |
+| 3 | 眨眼 | 停下后 1.4–2.2 s 第一次,以后每 3.2–6.8 s 一次(30 秒后间隔乘 1.4,90 秒后乘 2);五次里有一次连眨两下,隔 340 ms | 270 ms:眼睛压到 .03 再回来;抚摸、跳、点击转圈、看用户时不眨,眼皮重、眯眼和「^ ^」眼时也不眨 |
+| 4 | 回到窗口时看你 | 窗口失去焦点 5 秒以上后又拿到焦点,或者隐藏 5 秒以上后又看得见 | 和 10 秒那次一样:看向用户 600 ms,慢眨一次眼。和 10 秒那次合算,20 秒内最多一次;只在启动循环里或停在卡片前时有,游动、跳、抚摸、潜下去和失败的姿势时没有 |
+| 5 | 眼睛跟着键盘焦点 | 键盘把焦点移到纸面或提示行里的按钮、勾选框上 | 眼睛看向那个控件的中心,限幅和跟随指针一样;指针一动就交回指针。卡片出现时焦点自动移到主按钮,那一次不跟,眼睛仍看着卡片 |
+| 6 | 按下预备 | 在回答卡片的按钮上按下指针(展开「详细」「详细信息」、打开模型设置的「更换」、〔复制详细信息〕不算回答) | 身体微蹲:`scale` 1.03 .97,120 ms;点下去时用 `SPRING_TAP` 弹回并点头,移开或取消只弹回;键盘只点头。卡片的动作照旧在点击时才发出 |
+| 7 | 活泼档越跳越稀 | 活泼档,应用主动问、要跳两下的卡片 | 在 0、1.3、3.9、9.1 秒开始跳,以后每 9 秒一次,中间停下来呼吸、眨眼;抚摸或回答后不再跳;导入时空间不够的卡只跳一次 |
+| 8 | 潜得更深 | 交接 | 潜到鲸鱼身高的 1.25 倍(首次启动 110 px,以后的启动 80 px),约 200 ms 内整个到水线下,窗口长大之前水道就空了 |
- 动画三档用团队里设的那一档:主窗口的页面报告给应用,应用记在自己的 userData 里,下次启动时用。没有记录时(首次启动)按「正常」。
- - 安静:只有上表的状态动作。没有眼睛跟随、点击转圈、抚摸、尾巴、点头、看向用户、涟漪和「^ ^」眼。
- - 正常:加上眼睛跟随指针、尾巴、点头、看向用户、涟漪、「^ ^」眼。首次启动等待时,点鲸鱼它会转一圈;等用户回答时可以抚摸(UI 标准 8.5)。
- - 活泼:再加上等用户回答时一直跳(8.4)。
-- 涟漪是一个 56 × 12 的细线椭圆,只在首次启动出现两次:浮上来和潜下去的地方。以后的启动没有涟漪。
-- 鲸鱼对读屏隐藏(`aria-hidden`)。进度由三站的文字、`aria-current="step"` 和礼貌朗读区说出来:「{阶段}:进行中」「{阶段}:已完成」。
+ - 安静:只有第一张表的状态动作。没有眼睛跟随、点击转圈、抚摸、尾巴、点头、看向用户、涟漪和「^ ^」眼,也没有第二张表的 1 到 7。留下的圈只淡入(160 ms),不张开。
+ - 正常:加上眼睛跟随指针、尾巴、点头、看向用户、涟漪、「^ ^」眼,以及第二张表的 1 到 6。首次启动等待时,点鲸鱼它会转一圈;等用户回答时可以抚摸(UI 标准 8.5)。
+ - 活泼:再加上第二张表的第 7 条:等用户回答时越跳越稀,代替 UI 标准 8.4 的「一直跳」。
+- 涟漪是一个 56 × 12 的细线椭圆,只在首次启动出现两次:浮上来和潜下去的地方。潜下去的那一次 160 ms 就淡完,窗口开始长大时已经没有了。以后的启动没有涟漪。鲸鱼离开一站时留下的圈也是这个椭圆,张开后就停在那里(第 2 节)。
+- 鲸鱼和圈对读屏隐藏(`aria-hidden`)。三个阶段留在一个看不见的列表里(「启动进度」,每项带状态词,当前一项 `aria-current="step"`),礼貌朗读区照旧说「{阶段}:进行中」「{阶段}:已完成」。鲸鱼的话是普通文字,不进朗读区;失败的标题例外,会读出来。卡片出现时朗读它的第一行和第一句话(180 秒的卡读鲸鱼的问题)。
### 4. 首次启动,逐拍
@@ -108,86 +128,91 @@
1. 入场:
- 0 ms,鲸鱼在第 1 站从水线下浮上来。
- 120 ms,涟漪。
- - 160 ms,标题淡入。
- - 220 / 270 / 320 ms,三站从左到右淡入。
+ - 160 ms,鲸鱼的话「嗨,我是总管」淡入(重装和导入时的名字见第 3 节)。
+ - 220 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 的〔打开日志文件夹〕。鲸鱼改成思考。
+ 入场全是 CSS,不等脚本。入场时来的卡片和就绪,等它到位再处理。问候至少停 1.5 秒,之后有新消息才换;入场时就来的卡片也等它读满(第 6 节)。
+2. 到 560 ms「准备数据文件夹」还没完成、并且已经等了 250 ms,第 1 站才进入进行中,鲸鱼搜索;问候停够以后,鲸鱼说「先找个地方放东西」。已经完成的话,直接游到第 2 站。离开第 1 站时,只有真的说过「先找个地方放东西」,才接一句「找到了」(停 0.7 秒)。一般的首次启动里,数据阶段在问候读完以前就结束了,所以这两句只在这个阶段慢、出过卡片或者换了新文件夹之后才出现。
+3. 「启动本机引擎」:鲸鱼在第 2 站工作,说「热身中,等我一下」。它到了第 2 站,提示行写接下来要知道的事:
+ - 新团队(没有要导入的团队,数据文件夹里也没有团队):「待会儿要接一个模型:DeepSeek 账号或 API Key」。
+ - 重装:「上次的 6 个 Bot 和 2 个群聊都在」(第 6 节)。
+ - 要导入:没有提示。
+ - 盘不够、又没有更好的盘时,前 10 秒(从第 1 站起)提示行先写「C 盘只剩 1.2 GB」,之后才换成上面这一句(第 6 节)。
+4. 5 秒起,右上角显示「已用 N 秒」(`--bt-ink-2`,第 2 节),每秒改一次,数字不滚动,一直留到「进去吧」。没有百分比。
+5. 10 秒,引擎还没起来:鲸鱼说「第一次会慢一点」,看向用户一次,循环放慢;提示行不变。
+6. 45 秒,引擎还没起来:鲸鱼说「有点久,可能是杀毒软件在查新文件」,提示行只剩 28 px 的〔打开日志文件夹〕。鲸鱼改成思考。
7. 180 秒:见第 6 节。
-8. 引擎起来:主进程在隐藏的主窗口里加载引擎的页面,开始 20 秒的就绪检查。鲸鱼游到第 3 站,改成发消息。导入卡开着、还没回答时只给第 2 站打勾:不加载页面、不游到第 3 站、不开始 20 秒检查,三件事都等回答以后(〔复制过来〕的等第一段复制完)。
-9. `dsBotApp.ready()`:见第 8 节。
+8. 引擎起来:主进程在隐藏的主窗口里加载引擎的页面,开始 20 秒的就绪检查。鲸鱼游到第 3 站,改成发消息,一出发就说「开门去了」。DSH 会挂出「预览版说明」时(上手流程第 3 节的条件),提示行换成「里面先有一页说明,点「继续」就行」;不会挂出时,第 2 站的提示留着。导入卡开着、还没回答时只算第 2 站完成:不加载页面、不游到第 3 站、不开始 20 秒检查,三件事都等回答以后(〔复制过来〕的等第一段复制完)。
+9. `dsBotApp.ready()`:鲸鱼说「进去吧」,见第 8 节。
- 卡片等用户回答时,已用秒数暂停并隐藏,回答后接着走。10 秒、45 秒和 180 秒都按这个时钟算:用户自己想了多久,不算在引擎头上。
### 5. 以后的启动
- 0 ms:64 px 的鲸鱼在窗口中间浮上来(`SPRING_TAP` 290 ms),不倾斜,眼睛睁着,没有涟漪。60 ms 后,「正在打开你的团队…」淡入。
+- 没有水线和圈,也没有首次启动的那些话和提示:鲸鱼下面只有这一行已定的字(换位置时是「正在搬 DeepSeek Bot 的数据…」)。
- 前 1 秒什么都不再动。1 秒后鲸鱼开始工作(只上下晃和眨眼),那行字带流光。
- 10 秒起,下面显示「已用 N 秒」。
- 45 秒:「比平时慢,请再等一会儿。」〔打开日志文件夹〕。
- 180 秒:和首次启动一样。
-- 就绪时没有庆祝:字淡出 .16 s,鲸鱼从当前姿势潜下去;120 ms 后主窗口显示。
+- 就绪时没有庆祝(重试或重新开始后第一次成功时例外,第 8 节):字淡出 .16 s,鲸鱼从当前姿势潜下去;120 ms 时发 `handoffShow`,启动窗口和首次启动一样长成主窗口的矩形,主窗口在就绪后约 0.6 秒露面(第 8 节)。
- `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`。
+ - 出现:鲸鱼的话和提示行淡出 .16 s(问候还没读满 1.5 秒时,等它读满再淡出,见下面);整组先上移 80 px(第 2 节,首次启动和以后的启动一样);卡片的底色和边线两层从 0 高长到内容的高度(`clip-path`,走 `SPRING_SHAPE`;底色 .22 s 淡入);内容先按最终尺寸排好,晚 70 ms 淡入;焦点移到主按钮。
+ - 回答后:内容 .16 s 退场(下沉 6 px、缩到 .975、模糊 3px),卡片收回,整组再回到低处,鲸鱼的话接着跟着鲸鱼走(第 3 节)。
+- 卡片在时鲸鱼的话空着、提示行隐藏。入场时就来的卡(导入、推荐盘):问候读满 1.5 秒才淡出,这段时间(约 1 秒)它和卡片的第一行同时在,问候不会只闪一下。卡片自己的第一行是鲸鱼说的一句(15/20、600,一行),写在已定的内容上面,内容本身不变:
+ - 导入卡:「找到你以前的团队了」。
+ - 推荐盘:「C 盘有点挤」(空间不够),「这里不让我放东西」(默认位置不能用)。
+ - 「会放在…」:「我多加了一层文件夹」。
+ - 被拒绝的卡:「这里放不了」。
+ - 找不到数据文件夹:「数据不在原来的地方了」。
+ - 导入时空间不够:「地方不够放」。
+ - DSH 正在用这个团队:「DeepSeek Harness 还在用这个团队」。
+ - 更新版本的对话,和它的「正在下载」:「这些对话比我新」。
+ - 复制中:标题就是「正在搬过来」。
+ - 恢复卡、团队界面没有加载出来和复制失败的卡没有这一行,也不说俏皮话(第 7 节)。180 秒的卡也没有,问题由鲸鱼问。
- 鲸鱼跳不跳:
- - 应用主动问的卡片(推荐盘、找不到数据文件夹、导入、180 秒),跳两下再静止,看着卡片。
- - 用户自己引出的卡片(「其他位置…」选完后的「会放在…」、停止复制的确认),不跳。
+ - 应用主动问的卡片(推荐盘、找不到数据文件夹、导入、180 秒),跳两下,最后一跳落地时探身看着卡片,然后停下(第 3 节第二张表)。
+ - 用户自己引出的卡片(「其他位置…」选完后的「会放在…」、停止复制的确认),不跳,变形开始 70 ms 后探身。
- 同一件事又出了新问题(复制时空间不够),跳一下。
- 选位置的卡片只有推荐盘这一种,只在首次启动出现,〔放到 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 秒:「启动比平常慢很多。可以再等一会儿,或者重试。」〔继续等待〕(主按钮)〔重试〕〔打开日志文件夹〕
+ - 没有更好的盘时不出卡片:前 10 秒提示行写「C 盘只剩 1.2 GB」,之后换成这一站的提示(第 4 节)。
+- 重装(`C:\Users\<用户名>\.ds-bot` 里有团队、没有保存的位置)不出卡片,盘不够也不出:鲸鱼到了第 2 站,提示行写「上次的 6 个 Bot 和 2 个群聊都在」,不写路径,也没有接模型的提示。
+- 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 站。答〔先不复制〕时鲸鱼点一下头,预热好的引擎接着当正式引擎用,不重启。
+ - 卡片一出现,第 2 站就开始预热,没被 DSH 占着时检查对话同时进行,鲸鱼在第 2 站跳两下后停下;预热好了也只算第 2 站完成,不游到第 3 站。答〔先不复制〕时鲸鱼点一下头,预热好的引擎接着当正式引擎用,不重启。
- 空间不够(只查第一段):「空间不够:复制要约 1.7 GB,C 盘只剩 1.5 GB,还差 0.2 GB。」〔选择其他位置…〕(主按钮)〔先不复制〕
- 复制中:
- - 卡片标题「正在复制 Bot 团队…」,三步用和三站一样的标记和对勾,竖着排:「检查对话 23/143」→「复制 Bot 和对话 820 MB / 1.2 GB」→「启动团队」。
+ - 卡片标题「正在搬过来」,三步竖着排,各带一个 16 px 的标记(没开始:一圈细线;进行中:`--bt-ink` 圈加 6 px 实心点;完成:`--bt-green` 圆底对勾,`SPRING_POP` 弹出):「检查对话 23/143」→「复制 Bot 和对话 820 MB / 1.2 GB」→「启动团队」。
- 当前一步下面是 4 px 的真实进度条(`scaleX`,`SPRING_LIST`),不往回走。
- 剩余时间按整分钟写:「还要大约 2 分钟」「不到 1 分钟」。变动满一分钟才改,不倒数到 0。
- 任务栏进度显示在启动窗口上。
- 鲸鱼工作,每完成一步点一下头。
- - 停止复制:确认在卡片里就地展开:「停下后不会留下复制了一半的团队,DeepSeek Harness 里的团队不受影响。」〔继续复制〕(主按钮)〔停止复制〕(危险色文字)。鲸鱼静止。
- - DSH 正在用这个团队(答〔复制过来〕后):鲸鱼静止,不晃。每 2 秒重查一次,不显示任何东西;锁一放开,卡片直接变成复制中。卡上一个〔先不复制〕(主按钮)。「正在下载」的卡也有〔先不复制〕(主按钮),加「下载太慢?手动下载」;下载失败时〔重试〕〔手动下载〕。
+ - 停止复制:确认在卡片里就地展开:「停下后不会留下复制了一半的团队,DeepSeek Harness 里的团队不受影响。」〔继续复制〕(主按钮)〔停止复制〕(危险色文字)。鲸鱼停下。
+ - DSH 正在用这个团队(答〔复制过来〕后):鲸鱼停下,不晃。每 2 秒重查一次,不显示任何东西;锁一放开,卡片直接变成复制中。卡上一个〔先不复制〕(主按钮)。「正在下载」的卡也有〔先不复制〕(主按钮),加「下载太慢?手动下载」;下载失败时〔重试〕〔手动下载〕。
- 复制失败:鲸鱼用失败的姿势。
- 工作文件不经过启动窗口:团队打开后由应用在后台复制,进度在 设置 → 通用 → 位置 和 Main Bot 聊天里的「复制好了」卡上。
### 7. 失败、更新和界面没加载出来
- 失败后 1 秒内:
- - 标题换成「DeepSeek Bot 没能启动」。
- - 失败的那一站换成危险色的叉,停掉流光。
+ - 鲸鱼的话立刻换成「DeepSeek Bot 没能启动」,读屏读出这一句。
+ - 鲸鱼在它停的那一站换成失败的姿势(第 3 节),站上不画叉:失败只靠鲸鱼的姿势和这一句。
- 已用秒数和提示行淡出。
- - 纸面变成恢复卡:一句原因、五个按钮、「详细信息」。
+ - 纸面变成恢复卡:一句原因、五个按钮、「详细信息」。卡片没有鲸鱼的第一行。
- 焦点移到〔重试〕。窗口不隐藏。
- 〔复制详细信息〕点过后,按钮上的字变成「已复制」,1.6 秒后变回来。「详细信息」最多展开 168 px,日志在框里滚动。
- 有新版本时:
@@ -197,44 +222,56 @@
- 下载失败显示「下载失败。」〔重试〕〔手动下载〕。
- 鲸鱼抬一次头,看向更新条,然后又静止。
- 恢复卡上的选择:
- - 〔重试〕:已完成的站保持完成,失败的那一站回到进行中,鲸鱼抖一抖,回到工作。
- - 〔换个位置…〕和〔用新的空白团队开始…〕:先选文件夹(定根和首次启动同一条规则);然后鲸鱼沉到水线下,三站一起淡回未开始,鲸鱼在第 1 站重新浮上来。
- - 重新开始的这一轮成功时,照首次启动庆祝一次;以后的启动也一样。
+ - 〔重试〕:已完成的阶段保持完成,留下的圈不动;失败的那个阶段回到进行中,鲸鱼抖一抖,回到工作,鲸鱼的话回到这一站的那句。
+ - 〔换个位置…〕和〔用新的空白团队开始…〕:先选文件夹(定根和首次启动同一条规则);然后鲸鱼的话和提示行空着,鲸鱼沉到水线下,留下的圈一起淡出(.16 s),三个阶段回到未开始,鲸鱼在第 1 站重新浮上来,说「先找个地方放东西」。
+ - 重试或重新开始后第一次成功时庆祝一次:首次启动照第 8 节的表,先说「进去吧」;以后的启动不说「进去吧」,字照旧,压扁回弹 920 ms 后潜下去(第 8 节)。
- 团队界面 20 秒没加载出来:
- 主窗口始终不显示。
- - 第 3 站换成危险色的叉,标题换成「团队界面没有加载出来。」,卡片里是〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕。
+ - 鲸鱼在第 3 站换成失败的姿势,它的话换成「团队界面没有加载出来。」,不画叉;卡片里是〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕,没有鲸鱼的第一行。
- 〔重新载入〕:在隐藏的主窗口里重新载入,回到第 3 站,20 秒重新算。
- `ready()` 晚到了也直接交接,不庆祝。
### 8. 交接
-首次启动,以及重试后第一次成功。`t0` 是 `ready()` 到达后、鲸鱼停在第 3 站的那一刻:
+首次启动(重试或重新开始后第一次成功也一样)。`t0` 是 `ready()` 到达后、鲸鱼停在第 3 站的那一刻;`c` 是「进去吧」在屏幕上满 300 ms、庆祝开始的那一刻:
| 时间 | 启动窗口 | 主进程 |
|---|---|---|
-| 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 秒后。
+| `t0` | 上一句能读满 400 ms 后,鲸鱼的话换成「进去吧」(淡出、淡入各 .16 s) | |
+| `c`(「进去吧」出来 300 ms 后) | 「^ ^」眼;开始压扁 | |
+| `c` + 160 ms | 已用秒数和提示行淡出 | |
+| `c` + 460 ms | 拉到最长时潜下去,深到身高的 1.25 倍;鲸鱼的话、水线、圈、纸面和底注淡出 .16 s | |
+| `c` + 560 ms | 涟漪,160 ms 淡完 | |
+| `c` + 620 ms(`t0` 后约 1.1 s) | 发 `handoffShow` | 主窗口已经隐藏着放在最后的矩形上(以启动窗口的中心居中,不超出工作区);任务栏上仍是启动窗口的按钮 |
+| `handoffShow` + 160 ms | 页面已经空了:字淡完,鲸鱼潜下去,涟漪没了,只剩 Mica | 把启动窗口从 720 × 540 长到主窗口的矩形,300 ms,逐步 `setBounds`,约 14 ms 一步 |
+| `c` + 880 ms | 潜完,发 `handoffDone` | |
+| `handoffShow` + 460 ms | | 长到位;主窗口在同一个矩形上、在启动窗口上面露面,用系统自己的打开过渡;启动窗口同时离开任务栏,应用的任务栏按钮一直在 |
+| `handoffShow` + 760 ms | | 主窗口露面 300 ms 后销毁启动窗口 |
+
+- 首次启动时主窗口在就绪后约 1.6 秒露面。
+- 长大由主进程做:Electron 44 在 Windows 上不理 `setBounds` 的 `animate` 参数,只能一步一步改大小。每一步页面都重新排版,但只重画其中一部分(探针里 23 步重画了 8 次),所以长大时页面上除了 Mica 什么都不能有。
+- 以后的启动:字淡出 .16 s,鲸鱼 290 ms 潜下去;120 ms 时发 `handoffShow`,290 ms 时发 `handoffDone`。长大和露面和首次启动一样从 `handoffShow` 算起,主窗口在就绪后约 0.6 秒露面。
+- 以后的启动重试或重新开始后第一次成功(第 7 节):字照旧,不说「进去吧」;压扁回弹 920 ms,「^ ^」眼,然后 290 ms 潜下去;`handoffShow` 约在就绪后 1.04 秒(920 ms 加 120 ms),长大和露面照旧从它算起,主窗口约 1.5 秒露面。
+- 页面没发 `handoffShow` 时,主进程自己显示主窗口:首次启动在 2.5 秒后(最坏 1.17 秒,加上最多 600 ms 的排队游动,再留余量);以后的启动在 0.8 秒后,只有庆祝的那次(重试或重新开始后第一次成功,约 1.04 秒才发 `handoffShow`)也是 2.5 秒。
+- 减少动态效果:不长大。首次启动「进去吧」照样先停 300 ms,「^ ^」眼再停 300 ms,内容淡出 .12 s 后发 `handoffShow`(就绪后约 0.86 秒),主窗口直接出现在它最后的矩形上(第 9 节)。
- 启动窗口有焦点时,主窗口直接显示并拿到焦点。
- 启动窗口没有焦点时,主窗口不抢焦点,放在启动窗口原来的层次上,任务栏按钮闪烁。
-- 启动窗口最小化着时,主窗口也最小化着出现,任务栏按钮闪烁。
+- 启动窗口最小化着时不长大,主窗口也最小化着出现,任务栏按钮闪烁。
+- 鲸鱼不跨窗口:两个窗口、两个渲染进程、两个来源,画不了一条跨窗口的路。它在启动窗口里潜下去,首次启动时在团队界面侧栏 Main Bot 的磁贴上浮上来一次(待定):
+ - 主窗口露面时,磁贴上的鲸鱼从 `translate(0, 18%) rotate(-8deg)` 用 `SPRING_STRETCH` 560 ms 浮到原位,不透明度 .16 s 淡入;眼睛先闭着,300 ms 时睁开(160 ms);400 ms 时主 Bot 星标淡入(.22 s)。Main Bot 聊天里的第一张卡(新团队的设置卡,导入来的团队的「复制好了」卡,[上手流程](2026-10-26-windows-onboarding.md) 第 4、5 节)等它浮上来,640 ms 起才出现。
+ - 浮上来由插件做。在这之前磁贴上的鲸鱼和星标不画;页面从主进程经 `dsBotApp` 发的露面事件知道主窗口露面了、这是不是首次启动(主进程每次显示主窗口都发,兜底显示时也发;这个事件待定,见「待定」)。没有 `dsBotApp`(DSH Desktop、DSH Web)、不是首次启动、或者减少动态效果时不浮:鲸鱼、星标和第一张卡从第一帧起就在。安静档照样浮上来:它是状态动作,和启动窗口的入场一样。
+ - 「预览版说明」盖着侧栏时怎么办,见「待定」。
- 主窗口第一次露面时,DSH 的加载、第一次挂载侧栏(#559)都已经做完,「预览版说明」已经显示出来。
- 两个窗口各用各的颜色:启动窗口是 DeepSeek 主题的浅色或深色,主窗口是用户自己的主题。
### 9. 减少动态效果
- 跟随 `prefers-reduced-motion`(Windows 上是 设置 → 辅助功能 → 视觉效果 → 动画效果)。窗口开着时切换,也立刻生效:正在跑的动画直接到终点。
-- 鲸鱼一直是静止的画面:没有浮上来、游动、循环、跳、涟漪、尾巴、跟随和抚摸。换站时淡出 .12 s,换到新的一站,再淡入 .12 s。
+- 鲸鱼一直是静止的画面:没有浮上来、游动、循环、跳、涟漪、尾巴、跟随和抚摸,也没有第 3 节第二张表的八种动作。换站时淡出 .12 s,换到新的一站,再淡入 .12 s。
- 状态只靠眼睛直接切换:平时睁眼,45 秒起眯眼,就绪时显示「^ ^」600 ms,失败时眼皮变重。
-- 对勾、卡片、提示行和更新条只淡入 .12 s、淡出 .16 s,没有模糊、位移和缩放。卡片高度直接到位(内容先是透明的);以后的启动整组上移也直接到位;没有流光。
-- 交接只淡出 .12 s,然后显示主窗口。
-- 信息一样不少:已用秒数照常走,三站的文字、提示行、按钮和朗读都在。
+- 圈、鲸鱼的话、复制中的对勾、卡片、提示行和更新条只淡入 .12 s、淡出 .16 s,没有模糊、位移和缩放。圈不张开;卡片高度直接到位(内容先是透明的);整组上移、回到低处也直接到位;没有流光。
+- 交接时不长大:内容淡出 .12 s,然后发 `handoffShow`,主窗口直接出现在它最后的矩形上(第 8 节)。
+- 信息一样不少:已用秒数照常走,鲸鱼的话、提示行、按钮、看不见的阶段列表和朗读都在。
### 10. 颜色、Mica 和标题带
@@ -246,7 +283,7 @@
- Windows 11 22H2 及以后:
- 窗口用 `backgroundMaterial: 'mica'`,背景 `#00000000`;页面的 `html`、`body` 透明。
- 系统按钮颜色 `#00000000`,符号用 `--bt-ink`,按钮下面也是 Mica。
- - Mica 上最浅的字用 `--bt-ink-2`,不用 `--bt-ink-3`。
+ - Mica 上最浅的字用 `--bt-ink-2`,不用 `--bt-ink-3`:已用秒数和提示行也是。
- 其他 Windows:窗口背景和系统按钮颜色都用 `--bt-main`。页面照样透明,自己不用分辨是哪种情况。
- 一屏最多两处大面积强调色:鲸鱼和唯一的主按钮。
- 没有警告色(`--bt-warn` 未定):空间不足、OneDrive 和慢的提示都用中性墨色。
@@ -263,19 +300,24 @@
5. 动态导入其余模块。
6. 位置检查(结果变成卡片)。
7. 启动引擎。
- 启动窗口画好后,再建隐藏的主窗口。
+ 启动窗口画好后,再在最后的矩形上建隐藏的主窗口。
- 启动页的文件:
- `start.html`:CSP `default-src 'self'; base-uri 'none'; object-src 'none'`,没有内联样式和脚本。
- `start.css`。
- `start.js`:桥和界面。
- `whale.js`:鲸鱼的状态机。
- - `text.mjs`:中英文,主进程也用。
+ - `text.mjs`:中英文,主进程也用。鲸鱼的话是 `voice.*`,卡片的第一行是 `say.*`,提示行是 `hint.*`;原来的 `title.first`、`explain.*`、`slow.10`、`slow.45.first` 和 180 秒那句 `watchdog` 都去掉了,`copying.title` 改成「正在搬过来」。
+ - 预算:这五个文件合计不超过 45 KB(未压缩,原型定的目标);原型超了,怎么办见「待定」。
- 所有状态的 DOM 一开始就在页面里,用 `hidden` 和属性切换,运行时不插入大块节点。
+- 三个阶段在页面里是一个看不见的列表(`ol`,「启动进度」),`aria-current` 和状态词照旧更新;看得见的只有鲸鱼、水线和圈。
+- 鲸鱼的话不直接跟快照走:`whale.js` 的 `stage()` 报告鲸鱼在哪一站、哪个阶段显示进行中、是不是在游、是不是正沉下去、是不是「进去吧」,`start.js` 照它选这一句,按第 3 节的停留时间排队。「进去吧」上屏的时刻由 `start.js` 告诉 `whale.js`(`readyLine`,最多等 600 ms),庆祝从那以后 300 ms 开始。
+- `html` 是 `overflow: hidden`,`body` 是 `overflow: clip`:整组低着时超出的部分被裁掉,焦点、滚动锚点和恢复的滚动位置都移不动页面。
- 鲸鱼的 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 秒。
+- 交接时的长大也由主进程做:主窗口一建就在最后的矩形上,`handoffShow` 后 160 ms 用逐步的 `setBounds` 把启动窗口长过去,460 ms 显示主窗口、同时让启动窗口离开任务栏,再过 300 ms 销毁启动窗口(第 8 节)。兜底计时器按这次交接是不是首次启动、有没有庆祝选 2.5 秒或 0.8 秒。启动页只发 `handoffShow` 和 `handoffDone` 两个事件,和原来一样;主窗口露面时主进程告诉团队界面,让磁贴上的鲸鱼浮上来(第 8 节,待定)。
- `main.log` 记三个阶段各用了多久。
- 启动窗口在交接时销毁,它的渲染进程一起退出。
@@ -285,37 +327,55 @@
|---|---|
| [Windows 上手流程](2026-10-26-windows-onboarding.md) 第 3 节「启动页和引擎的页面共用这个窗口」 | 启动页在单独的启动窗口里;引擎的页面在隐藏的主窗口里加载,`dsBotApp.ready()` 之后主窗口才显示(待定) |
| 同上「选择框挂在窗口上」 | 挂在启动窗口上,从不自己弹出 |
-| 同上 首次启动说明的第三条「聊天和设置保存在这台电脑上……· 社区开源项目,不是 DeepSeek 官方产品」 | 拆成两处:前半句在说明里;「社区开源项目,不是 DeepSeek 官方产品」是首次启动每一屏的底注,卡片不盖住它 |
+| 同上 首次启动说明的第三条「聊天和设置保存在这台电脑上……· 社区开源项目,不是 DeepSeek 官方产品」 | 「社区开源项目,不是 DeepSeek 官方产品」是首次启动每一屏的底注,卡片不盖住它;前半句随说明一起去掉(见下面「首次启动的说明」那一行) |
| 同上 20 秒没就绪时「回到启动页」 | 启动窗口一直在,主窗口不显示 |
| 同上「首次启动期间再双击图标:恢复并聚焦已有窗口」 | 聚焦正在显示的那个窗口 |
| 同上 第 8 节 以后的启动「只写『正在打开你的团队…』」 | 另外 10 秒起显示已用秒数;45 秒显示「比平时慢,请再等一会儿。」;180 秒同首次启动 |
| 同上「改动的已定设计」:窗口先加载启动页,再加载引擎的本机地址 | 启动窗口先出来;主窗口隐藏着加载引擎的本机地址(同一个地址和端口),就绪后才显示 |
| 同上 验收「进程启动后 2 秒内窗口可见」「没有一个 `dialog.show*` 不挂在主窗口上」 | 两条里的窗口都指启动窗口 |
-| [桌面应用](2026-10-16-desktop-app.md)「窗口」 | 加上启动窗口:720 × 540,不能缩放,只有最小化和关闭,Mica |
+| [桌面应用](2026-10-16-desktop-app.md)「窗口」 | 加上启动窗口:720 × 540,不能缩放,只有最小化和关闭,Mica;交接时由主进程长成主窗口的矩形(第 8 节) |
| [UI 标准](../design/ui-standard.md) 4.4 头像尺寸 | 加 88(启动窗口,首次启动) |
| 同上 8.3 状态动作 | 加只在启动窗口里有的动作:浮上来、游到下一站、点头、潜下去、尾巴摆 |
| 同上 3.1 字族 | 启动窗口加 `"Microsoft YaHei UI"`,记进第 14 节 |
| 同上 12 可访问性 | 新出现的卡片和恢复页,焦点移到主按钮 |
+| [Windows 上手流程](2026-10-26-windows-onboarding.md) 第 3 节「标题「正在准备你的 Bot 团队…」,下面三个真实阶段,各带进度勾」;本文首稿第 2 节的标题行和三站(16 px 标记的四种样子、阶段名、站间的细线、进行中的流光) | 没有标题行,阶段不画出来:鲸鱼停在哪一站就是进度,离开的站留下一个圈,水线上不画别的;三个阶段只留在看不见的列表「启动进度」里,朗读照旧;已用秒数移到右上角;没有卡片时整组低 80 px(第 2、3 节) |
+| 同上 首次启动的说明(产品介绍、「下一步:接上一个模型…」、「聊天和设置保存在这台电脑上…」、写位置的小字、「接下来会先显示 DeepSeek Harness 的「预览版说明」…」);本文首稿第 4 节第 3 拍逐段出现的说明 | 不再有说明。鲸鱼一次说一句短话(第 3、4 节);提示行只写接下来要知道的一件事:「待会儿要接一个模型:DeepSeek 账号或 API Key」「里面先有一页说明,点「继续」就行」;首次启动不写路径,位置只在卡片和 设置 → 通用 → 位置 里出现 |
+| 同上 超过 10 秒、45 秒的提示「第一次启动会慢一些,Windows 可能在检查刚装好的文件。」「比平时慢,可能是杀毒软件在检查新文件,请再等一会儿。」 | 首次启动由鲸鱼说「第一次会慢一点」「有点久,可能是杀毒软件在查新文件」,45 秒时提示行只有〔打开日志文件夹〕;以后的启动不变 |
+| 同上 启动超过 180 秒:「启动比平常慢很多。可以再等一会儿,或者重试。」 | 鲸鱼问「等太久了,要不要重试?」,卡片里只有〔继续等待〕〔重试〕〔打开日志文件夹〕 |
+| 同上 重装时说明的小字「接着用上次的数据:6 个 Bot、2 个群聊(`C:\Users\<用户名>\.ds-bot`)。可以在 设置 → 通用 → 位置 里改。」(本文第 6 节照写) | 提示行写「上次的 6 个 Bot 和 2 个群聊都在」,不写路径 |
+| 本文首稿 第 6 节 复制中的标题「正在复制 Bot 团队…」,三步「用和三站一样的标记」 | 标题「正在搬过来」;三步的标记照旧,写在第 6 节(三站已经没有标记) |
+| 同上「不做什么」:「鲸鱼不说话、不冒气泡、不挡卡片和按钮,也不要用户做什么」;第 3 节「一个阶段完成……身后的标记弹出对勾」;第 7 节失败的那一站换成危险色的叉 | 鲸鱼说一句和它的状态有关的短话,卡片的第一行也是它说的(失败的卡除外);只有 180 秒那一句是问题,回答在卡片的按钮上;仍然不放轮播的提示和笑话,不冒气泡;完成时留下一个圈;失败只靠鲸鱼的姿势和已定的标题,不画叉 |
+| 同上 第 1 节「启动窗口从不改大小」 | 交接之前不改;交接时由主进程把它长成主窗口的矩形,主窗口一建就在这个矩形上(第 1、8 节) |
+| 同上 第 8 节 交接:`t0` 后 620 ms 发 `handoffShow`,这时启动窗口离开任务栏、主窗口显示,主窗口显示满 250 ms(最晚 400 ms)关掉启动窗口;以后的启动 120 ms 时显示主窗口;页面没发 `handoffShow` 时首次启动 1.5 秒兜底;「不做什么」「不为动画推迟启动」「庆祝只在首次启动和重试后第一次成功时有」 | 首次启动先说「进去吧」,300 ms 后庆祝;`handoffShow` 在就绪后约 1.1 秒;160 ms 后启动窗口用 300 ms 长到主窗口的矩形,主窗口在 460 ms 露面,启动窗口这时才离开任务栏,再过 300 ms 销毁;主窗口在就绪后约 1.6 秒露面(以后的启动约 0.6 秒,以后的启动庆祝的那次约 1.5 秒);兜底改成首次启动和庆祝的交接 2.5 秒,其余以后的启动仍是 0.8 秒;减少动态效果时不长大;不为动画推迟引擎和团队界面的加载,交接为了长大多等约 460 ms;以后的启动庆祝时不说「进去吧」 |
+| [UI 标准](../design/ui-standard.md) 第 1 节第 4 条和 8.4「持续的环境动画只出现在「活泼」档」;8.4 活泼档「等你回答时一直跳」;8.3 状态动作 | 只在启动窗口里、卡片等用户回答时,正常档和活泼档也呼吸和眨眼;活泼档改成越跳越稀;另加探身、按下预备、眼睛跟着键盘焦点、回到窗口时看你一眼(第 3 节第二张表)。安静档和减少动态效果时都没有;插件里的头像不变 |
+| 本文首稿 第 3 节「只为真实的事动:……以及用户的指针和点击」「等用户回答时静止」;第 3 节的表和第 6 节「跳两下,然后静止,看着卡片」「不跳,静止」 | 等用户回答时停下:探身、呼吸和眨眼(第 3 节第二张表),另为键盘焦点和回到窗口而动;安静档、减少动态效果和失败页上停下就不再动 |
## 变更
- 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。
+- 2026-10-27:第 1 节加登录窗口(上手流程第 5 节):主窗口的子窗口,只在交接之后、用户点了某个登录入口时出现,启动窗口阶段没有它。
+- 2026-10-28:按维护者 2026-10-27 的反馈改写:小窗口显示的是实现的结构(一条带三个点和阶段名的线、几段说明),不是用户感受到的东西,最后一步跳进团队窗口也太突然。三部分一起定:(1)「鲸鱼即进度」的启动窗口:鲸鱼停在哪一站就是进度,离开的站留下一个圈,窗口里的字都是鲸鱼一次一句的短话,卡片的第一行也是它说的;去掉标题行、三站的标记和阶段名、说明和写位置的小字,180 秒的卡只留按钮,重装只写一句提示,复制中的标题改成「正在搬过来」;鲸鱼更有反应(探身、呼吸、眨眼、回到窗口时看你、眼睛跟着键盘焦点、按下预备、活泼档越跳越稀、潜得更深),呼吸和眨眼只在卡片等用户时有;交接时启动窗口长成主窗口的矩形,主窗口在同一个矩形上露面(就绪后约 1.6 秒,兜底 2.5 秒),鲸鱼在侧栏的磁贴上浮上来。(2)交接后的目标卡改成多选加〔确定〕。(3)AI-native 的后半段:开场白不调模型,目标卡、建议卡和第一件事由插件画,上手期间最多 3 次模型请求,模型关着也走得通。后两部分写在上手流程第 5、6 节,本文只写到交接为止。依据:原型和它的检查(82 个状态、22 个场景、交接和团队窗口的联合检查)、Electron 44 上长大窗口的探针。评审后补正:磁贴上的鲸鱼怎么浮上来写进第 8 节(数值照原型,由主进程经 `dsBotApp` 的露面事件开始,待定),不再指向上手流程第 5 节;问候里的名字跟着团队(重装用团队里的名字,导入和读不出时「嗨,我来了」);入场时就来的卡等问候读满 1.5 秒;300 ms 的最短停留和「卡片在时这一行空着」写明失败和 180 秒的例外;以后的启动重试或重新开始后第一次成功不说「进去吧」,压扁回弹 920 ms 后潜下去,兜底和首次启动一样 2.5 秒;启动窗口在主窗口露面时才离开任务栏;减少动态效果时「^ ^」眼再停 300 ms;卡片在时已用秒数隐藏;45 KB 的预算写进第 11 节,建议和上手流程一致;「淡圈」统一叫「圈」,和上手流程的用词一样;空 Mica 帧的退路、「不做什么」里的推迟和「不要用户做什么」按新的交接和会说话的鲸鱼改写;首稿里「等用户回答时静止」等规则记进「改动的已定设计」;文件头的「一起改」补全。
## 待定
| 问题 | 选项 | 建议 |
|---|---|---|
-| 启动页放在哪里? | 单独的启动窗口(本文);主窗口里叠一层透明的 `WebContentsView`,团队界面在下面加载,就绪后淡出;按原来的设计在同一个窗口里 `loadURL` | 单独的启动窗口:真正的小窗,一直有 Mica,交接没有空白帧,「打开团队」也是真的。覆盖层是第二选择:同样没有空白帧,但启动时就是大窗口,还要管两套焦点。原来的做法会露出 DSH 自己的加载,第 3 站的对勾和庆祝只能不做 |
+| 启动页放在哪里? | 单独的启动窗口(本文);主窗口里叠一层透明的 `WebContentsView`,团队界面在下面加载,就绪后淡出;按原来的设计在同一个窗口里 `loadURL` | 单独的启动窗口:真正的小窗,一直有 Mica,交接没有空白帧,「打开团队」也是真的。覆盖层是第二选择:同样没有空白帧,但启动时就是大窗口,还要管两套焦点;Electron 44 上实测,看不见的 `WebContentsView` 不渲染,覆盖层只能不透明,启动时就没有 Mica。原来的做法会露出 DSH 自己的加载,游到第 3 站、庆祝和长大都只能不做 |
| 鲸鱼的尾巴能单独动吗? | 启动页把生成器的输出按尾柄(`27.9, 61.1`)裁成两层,不加新形状;生成器加一个尾巴单独成层的选项;尾巴不动 | 先用裁切,只在启动窗口里用。以后插件也要用时,再给生成器加选项。去掉也只少了尾巴,其余不变 |
+| 1 px 的水线要不要留? | 留:1 px `--bt-line`,首尾渐隐,上面什么都不画;去掉,只留鲸鱼和它留下的圈 | 留:圈和三站要有一个面可以落,鲸鱼被裁掉的那条边也在这里 |
+| 启动页超过 45 KB 的预算(第 11 节)怎么办?(原型实测:五个文件的源码 113 KB,压缩后 79 KB,gzip 约 35 KB;`text.mjs` 带中英两种语言) | 放宽预算;`text.mjs` 按语言拆开,只加载界面语言的那一份;打包时压缩 | 先按语言拆 `text.mjs`、打包时压缩,在 M4 实测启动页的第一帧;第一帧不晚就放宽预算:页面是本地文件,不走网络(同 [上手流程](2026-10-26-windows-onboarding.md) 的「待定」) |
+| 启动窗口的问候用哪个名字?(第 3 节) | 按第 3 节:新团队用界面语言的默认名字,重装用团队里 Main Bot 的名字,要导入或读不出时不带名字;一律不带名字(「嗨,我来了」);一律用默认名字 | 按第 3 节。中文的默认名字和 [上手流程](2026-10-26-windows-onboarding.md)「待定」里「中文界面里第一个 Main Bot 叫什么?」一起定;一律用默认名字时,重装和导入的人在启动窗口里听到一个名字,进门后看到另一个 |
+| 磁贴上的鲸鱼怎么知道该浮上来?「预览版说明」盖着侧栏时怎么办?(第 8 节) | 主进程显示主窗口时经 `dsBotApp` 发一个露面事件,带上这是不是首次启动([上手流程](2026-10-26-windows-onboarding.md) 第 3 节的 `dsBotApp` 列表要加一项);页面自己等 `visibilitychange` 第一次变成 `visible`(不加接口,但分不出是哪种启动;Electron 默认照常渲染隐藏的新窗口,这时页面第一次加载的 `document.visibilityState` 可能不对)。说明挂着时:照样在它下面浮上来;等它关掉再浮;不浮,鲸鱼从第一帧起就在 | `dsBotApp` 的露面事件:时刻和启动的种类都准。说明挂着时先照样浮,M4 看它在说明下面看不看得见;看不见就不浮:DSH 的说明关掉时没有事件,插件等不到「继续」 |
## 不做什么
- 不画百分比进度条:引擎不报百分比。复制和下载的进度条用真实的字节数。
-- 不编造阶段,不为动画推迟启动。庆祝只在首次启动和重试后第一次成功时有,主窗口在 `ready()` 后约 620 ms 露面。
-- 不放轮播的提示和笑话。鲸鱼不说话、不冒气泡、不挡卡片和按钮,也不要用户做什么。失败时不哭不闹。
-- 鲸鱼没有「?」徽标(UI 标准 8.2:大头像不显示徽标),不侧身跃出水面,不喷水。
+- 不编造阶段,不为动画推迟引擎和团队界面的加载;交接为了长大多等约 460 ms(首次启动另有「进去吧」的 300 ms),见第 8 节。「进去吧」只在首次启动时有;庆祝只在首次启动和重试、重新开始后第一次成功时有。主窗口在 `ready()` 后约 1.6 秒露面(长大要等页面空了才开始),以后的启动约 0.6 秒,以后的启动庆祝的那次约 1.5 秒。
+- 不放轮播的提示和笑话。鲸鱼只说一句和它的状态有关的短话(第 3 节),不冒气泡,不讲笑话,不挡卡片和按钮;鲸鱼的话里只有 180 秒那一句是问题,回答在卡片的按钮上,别的话都不要用户做什么(提示行只提前说接下来会遇到什么)。失败时不哭不闹,失败页上不说俏皮话。
+- 鲸鱼没有「?」徽标(UI 标准 8.2:大头像不显示徽标),不侧身跃出水面,不喷水;等待时不乱游,不对每次按键都有反应,没有声音。
+- 鲸鱼不从启动窗口飞进主窗口:它在小窗口里潜下去,首次启动时在侧栏的磁贴上浮上来(第 8 节)。
- 不画 DSH 的鲸鱼标志,不用其他产品的动画、插图、声音和字体。
- 不往引擎的页面里注入 CSS 或 DOM 来接画面,不改 DSH。
- 不用 Rive、Lottie 和网络字体:CSP `default-src 'self'` 不允许 WASM,也不另加运行时。
@@ -324,12 +384,19 @@
## 已知限制
- 主窗口在隐藏时启动 DSH 和 ds-bot。`dsBotApp.ready()`、#559 的重新挂载检查和系统按钮颜色的测量,都在看不见的窗口里跑,要在 M4 验证。
-- 从没显示过的 Mica 窗口第一次 `show()` 时,可能先露出一两帧空的 Mica。M4 用 60 帧录像检查;有的话,改成先把主窗口放在启动窗口下面,启动窗口潜完再关。
+- 从没显示过的 Mica 窗口第一次 `show()` 时,可能先露出一两帧空的 Mica。交接时启动窗口已经长成同样大小的空 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 高,说明和长卡片要在纸面里滚动。
+- 工作区不到 588 高的显示器上,窗口只有 500 高,长卡片要在纸面里滚动。
- 启动时多一个渲染进程(约 40–60 MB),交接后销毁。
-- 交接的 250–400 ms 里两个窗口同时存在。启动窗口已经不在任务栏,但 Alt+Tab 里可能短暂看到两个。
\ No newline at end of file
+- 从开始长大到启动窗口销毁的约 600 ms 里两个窗口同时存在,主窗口露面后的 300 ms 里两个都看得见。启动窗口在主窗口露面时才离开任务栏,任务栏按钮不会消失再出现;但那 300 ms 里 Alt+Tab 可能短暂看到两个。
+- 鲸鱼的话每句都要停够才换,阶段很快时会落在鲸鱼后面:比如换了新文件夹以后,鲸鱼已经到了第 2 站,「先找个地方放东西」还在淡入,「找到了」接着在第 2 站说。它从不说还没发生的事,只是不完全同步。
+- 一般的首次启动里,数据阶段在「嗨,我是总管」读完以前就结束了,「先找个地方放东西」和「找到了」很少出现:用户读到的是「嗨,我是总管」「热身中,等我一下」「开门去了」「进去吧」。
+- 首次启动时主窗口在就绪后约 1.6 秒才露面,以后的启动约 0.6 秒(庆祝的那次约 1.5 秒):长大要等页面空了才开始,主窗口长到位才显示。
+- 长大靠逐步 `setBounds`:页面每一步都重新排版,但只重画其中一部分,所以长大时纸面必须是空的;机器忙时长大不平滑。
+- 圈(不透明度 .5)和已用秒数在真的 Mica 上看不看得清,还没验证:原型的截图用的是不透明的 `--bt-main` 背景。
+- 启动页的五个文件超过 45 KB 的预算(第 11 节,见「待定」)。
+- 入场时就来的卡(导入、推荐盘)出来后,问候还要再留约 1 秒,和卡片的第一行同时在:这样问候不会只闪 240 ms 就被换掉(第 6 节)。
\ 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 de29a858..34562df2 100644
--- a/docs/plans/2026-10-26-windows-onboarding.md
+++ b/docs/plans/2026-10-26-windows-onboarding.md
@@ -2,8 +2,8 @@
- 日期: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-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`
+- 一起改:[桌面应用](2026-10-16-desktop-app.md)(结构、窗口、模型、首次启动和导入、改位置、安装和更新、暂时不做、已知限制)、[Bot 运行配置](2026-10-10-bot-runtime.md)(新 Bot 的模型来源、第一个 Main 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),交接时启动窗口长成主窗口、鲸鱼在侧栏 Main Bot 的磁贴上浮上来在它的第 8 节,它和本文第 5、6 节一起改
+- 代码:`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`、`tools.js`;`.github/workflows/release.yml`、`.github/ISSUE_TEMPLATE/`;`README.md`、`README.zh.md`
## 为什么
@@ -45,8 +45,9 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
### 取舍
-- **每个阶段只有一个引导面,显示什么由状态决定,不存「已完成」标记。** 引擎起来之前,引导面是应用自己画的启动页;引擎起来以后,是 Main Bot 聊天里的设置卡。跳过的步骤哪里都不记,条件还在,它下次就自己回来。
-- **模型在聊天卡里接,不在应用里另做欢迎向导。** 设置卡是插件的代码,DSH Desktop 和 DSH Web 里的用户也一起受益;应用里再做一套向导,就要维护两套。启动页只负责说清「这是什么、下一步是什么」,好让等待不是空等。
+- **每个阶段只有一个引导面,显示什么由状态决定,不存「已完成」标记。** 引擎起来之前,引导面是应用自己画的启动页;引擎起来以后,是 Main Bot 聊天里的设置卡。跳过的步骤哪里都不记,条件还在,它下次就自己回来。第 6 节的上手也不另存标记:Main Bot 的会话里有那行「上手结束」的灰字、或者有用户自己发的消息,就算结束;「跳过设置,直接开始」写下的那行灰字是它唯一的记录(第 8 节)。
+- **模型在聊天卡里接,不在应用里另做欢迎向导。** 设置卡是插件的代码,DSH Desktop 和 DSH Web 里的用户也一起受益;应用里再做一套向导,就要维护两套。启动页只负责让人看见它在动、知道下一步是什么:鲸鱼游到哪一站就是到了哪一步,一次只说一句话,好让等待不是空等。
+- **模型从「已接上」之后才开始帮忙。** 顺序倒不过来:Key 由引擎写进它自己的 `DSH_HOME`,DeepSeek 登录的回调也由引擎的 Host 处理,所以引擎必须先在某个数据位置上跑起来;`importTeam` 遇到已有 Bot 的位置直接拒绝,复制时还整个换掉 `bot/` 并重启引擎,先填的 Key 也会压过导入来的 Key 和登录。所以位置、导入、接模型三步保持卡片。模型只在两处比卡片好:把用户的一句话变成有名字、有角色的 Bot,以及自由的第一件事;它也更慢、先花钱、措辞每次不一样,所以每一步都留一张不靠模型也能走通的卡,限制写成代码里的机制,不写成提示词(第 6 节)。
- **先补悄悄流失的地方。** 下载页、信任提示、一键安装最便宜,影响面最大。签名和国内镜像要等外部审批和账号,所以最先开始办。
- **不改 DSH。** 只用有文档的开关和插槽。DSH 的「预览版说明」没有文档开关,就向 DSH 提需求,期间在启动页上先提醒一句;不伪装 `dshDesktop`。
@@ -57,7 +58,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
### 1. 下载
- `README.md` 和 `README.zh.md` 开头都是同一块中英双语的下载区(GitHub 默认显示英文 README):Windows 10/11(64 位)、约 212 MB,「国内镜像下载(推荐)」和「GitHub」两个直接下载链接。镜像没验证通过之前只放 GitHub 链接,不放死链。
-- 下载区紧接着写清:双击就会安装,装好自动打开;不用管理员权限,不用另装 Node 或 DSH;需要一个 DeepSeek 账号(可以当场用手机号注册)或 DeepSeek API Key;DeepSeek 按用量收费,一轮对话大约多少钱(实测三次开场白得出,附 DeepSeek 价格页链接);DS Bot 是社区开源项目,不是 DeepSeek 官方产品。
+- 下载区紧接着写清:双击就会安装,装好自动打开;不用管理员权限,不用另装 Node 或 DSH;需要一个 DeepSeek 账号(可以当场用手机号注册)或 DeepSeek API Key;DeepSeek 按用量收费,一轮对话大约多少钱(实测默认模型上三次第一件事的回合得出,附 DeepSeek 价格页链接);DS Bot 是社区开源项目,不是 DeepSeek 官方产品。
- 签名之前,下载区带一段信任说明(文字加自己画的示意图,不贴 Windows 或其他产品的截图):
- Edge 提示「不常下载」:「···」→「保留」→「显示更多」→「仍然保留」。
- 「Windows 已保护你的电脑」:「更多信息」→「仍要运行」。
@@ -80,34 +81,45 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
### 3. 首次启动:启动页
-- 窗口先出来。进程启动约 1 秒内,窗口就显示应用自己的本地页(`app/src/start/`):和现在一样无边框,40 px 的标题带可以拖动,系统按钮在右上角,Windows 11 上用 Mica。启动页和引擎的页面共用这个窗口。
-- 标题「正在准备你的 Bot 团队…」,下面三个真实阶段,各带进度勾:「准备数据文件夹」→「启动本机引擎」→「打开团队」。超过 5 秒显示已用秒数。
-- **只在第一次启动时**,等待期间显示一段说明:
- - 「DeepSeek Bot 是一支替你干活的 Bot 团队:你告诉主 Bot 要做什么,它安排其他 Bot 一起完成。」
- - 没有要导入的团队时:「下一步:接上一个模型。推荐用 DeepSeek 账号登录(没有账号可以用手机号注册),也可以粘贴 DeepSeek API Key。DeepSeek 按用量收费。」
- - 「聊天和设置保存在这台电脑上(对话内容会发给你选的模型服务)· 社区开源项目,不是 DeepSeek 官方产品」
- - 小字写明位置:「数据保存在 `C:\Users\<用户名>\.ds-bot`,Bot 默认在 `C:\Users\<用户名>\DeepSeek Bot` 里工作。都可以在 设置 → 通用 → 位置 里改。」
- - 最后一个阶段,DSH 会挂出「预览版说明」时(会话准备好、主视图里没有非空会话):「接下来会先显示 DeepSeek Harness 的「预览版说明」。DeepSeek Bot 建在 DeepSeek Harness 上,点「继续」就行。」
- - 超过 10 秒:「第一次启动会慢一些,Windows 可能在检查刚装好的文件。」超过 45 秒:「比平时慢,可能是杀毒软件在检查新文件,请再等一会儿。」加「打开日志文件夹」。
+- 窗口先出来。进程启动约 1 秒内,启动窗口就显示应用自己的本地页(`app/src/start/`):和现在一样无边框,40 px 的标题带可以拖动,系统按钮在右上角,Windows 11 上用 Mica。启动页在单独的启动窗口里,引擎的页面在隐藏的主窗口里加载([启动窗口](2026-10-26-start-window.md) 第 1 节,待定)。整个启动期间,卡片和失败页也算,启动窗口都是 720 × 540(工作区矮时 720 × 500);它只在交接时改一次大小:长成主窗口的矩形,主窗口在同一个矩形上露面(同上第 8 节)。
+- **鲸鱼就是进度。** 首次启动没有标题、三站的标记和说明:Main Bot 的鲸鱼(88 px)在水线上从第 1 站游到第 3 站,它停在哪里就是到了哪一步;它离开第 1、2 站时各在原处留下一个细线的圈,第 3 站没有。三个真实阶段照旧是「准备数据文件夹」→「启动本机引擎」→「打开团队」,但只给读屏:一个看不见的列表「启动进度」(`aria-current="step"`),朗读区照旧说「{阶段}:进行中」「{阶段}:已完成」。5 秒起右上方显示「已用 N 秒」,一直留到「进去吧」。布局、圈和鲸鱼的动作在 [启动窗口](2026-10-26-start-window.md) 第 2、3 节。
+- **文字都是鲸鱼在说,一次一句短话。** 鲸鱼的话在水线下居中,只占一行,不折行;下面的提示行只说接下来要准备什么(接模型、预览版说明、重装接着用),最多约 22 个字,有卡片时隐藏。首次启动的话和提示:
+
+| 时候 | 鲸鱼的话 | 提示行 |
+|---|---|---|
+| 入场,还没有新消息 | 「嗨,我是{名字}」,停 1.5 秒:新团队用界面语言的默认名字(中文「总管」),重装用团队里 Main Bot 的名字,要导入或读不出名字时不带名字「嗨,我来了」([启动窗口](2026-10-26-start-window.md) 第 3 节,待定) | 无 |
+| 第 1 站:只在数据文件夹这一步比招呼久、出过卡片或换了新文件夹时 | 「先找个地方放东西」 | 无 |
+| 离开第 1 站:只在上一句真的说过时 | 「找到了」,停 0.7 秒 | 无 |
+| 第 2 站 | 「热身中,等我一下」 | 新团队:「待会儿要接一个模型:DeepSeek 账号或 API Key」;重装:「上次的 6 个 Bot 和 2 个群聊都在」;要导入时没有 |
+| 10 秒(第 1、2 站) | 「第一次会慢一点」 | 同上 |
+| 45 秒(第 1、2 站) | 「有点久,可能是杀毒软件在查新文件」 | 只有〔打开日志文件夹〕 |
+| 游向第 3 站和在第 3 站 | 「开门去了」 | DSH 会挂出「预览版说明」时(会话准备好、主视图里没有非空会话):「里面先有一页说明,点「继续」就行」;否则留着第 2 站的提示 |
+| 就绪 | 「进去吧」,300 ms 后庆祝、潜下去 | 同上,到庆祝开始 |
+| 盘不够、又没有更好的盘 | 照那一站说 | 前 10 秒「C 盘只剩 1.2 GB」 |
+| 180 秒 | 「等太久了,要不要重试?」 | 无;卡片上只有〔继续等待〕〔重试〕〔打开日志文件夹〕 |
+| 启动失败、团队界面没加载出来 | 「DeepSeek Bot 没能启动」「团队界面没有加载出来。」 | 无 |
+| 有卡片时 | 空着,由卡片自己的第一句说(15/20、600,在已定的文字上面):推荐盘「C 盘有点挤」(盘不够)或「这里不让我放东西」(没有写入权限),「会放在…」那张「我多加了一层文件夹」,被拒绝的「这里放不了」,找不到数据文件夹「数据不在原来的地方了」;导入的几张见第 4 节;失败的卡没有 | 隐藏 |
+
+- 话跟着鲸鱼走(停在哪一站、正在游哪一段、就绪),从不抢在它前面。每句至少能读 300 ms 才被换掉,一般停 0.9 秒(招呼 1.5 秒,「找到了」0.7 秒);中间跳过的话以后不补说。失败和 180 秒的问题马上说。「进去吧」等上一句能读满 400 ms 才上,上屏 300 ms 后开始庆祝。鲸鱼沉下去、换个新文件夹重新开始时,话和提示都空着。失败时不画叉,鲸鱼失败的姿势和那句话就是失败。一般的首次启动,用户读到的是「嗨,我是总管」→「热身中,等我一下」→「开门去了」→「进去吧」:数据文件夹这一步通常在招呼读完之前就做完了。
- **一般情况下什么都不问**,用默认位置。先看是不是重装(下一条),再看要不要出位置卡片。选位置的卡片只有推荐盘这一张,它上面的按钮都已经试写通过,不会点了再被拒绝;每张卡都说明以后在哪里改:
- 数据所在的盘不到 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`。「下一步:接上一个模型…」那一段也不显示。想要空白团队的人去 设置 → 通用 → 位置 →「用新的空白团队开始…」。只认默认位置:放在别处、又没有保存位置的旧数据找不到,和今天一样。
+- **重装不问。** 没有保存的位置、而 `C:\Users\<用户名>\.ds-bot` 里有团队时(重装过,或者 `%APPDATA%` 被清过),直接接着用:不出推荐盘的卡片,盘不够只在提示行写一句「C 盘只剩 1.2 GB」,要搬去 设置 → 通用 → 位置 →〔移到…〕;写不进去直接是恢复页。第 2 站的提示行写「上次的 6 个 Bot 和 2 个群聊都在」,不写路径,接模型的那句提示也不显示。旧团队登记的总工作区启动页不知道:插件启动后经 `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 没能启动」,一句对应的原因(没有写入权限 / 磁盘空间不够 / 程序文件不完整,可能被杀毒软件拦掉了一部分 / 本机引擎启动到一半停下了 / 出了点意外),每种都给〔重试〕〔换个位置…〕〔用新的空白团队开始…〕〔打开日志文件夹〕〔复制详细信息〕(换位置按第 3 节定根的规则,数据和总工作区一起搬,搬的规则同第 8 节:同一个卷上改名,不同的卷上复制完再删旧的;还没有团队时只是换个空文件夹),再加一个「详细信息」折叠区(日志最后 200 行,已脱敏)。
-- 启动超过 180 秒:「启动比平常慢很多。可以再等一会儿,或者重试。」〔继续等待〕〔重试〕〔打开日志文件夹〕,引擎同时继续启动。
+- **启动失败**时,启动页当场变成恢复页(不再等 GitHub、不再隐藏窗口、不再弹英文「Error」框):鲸鱼那一行写「DeepSeek Bot 没能启动」,不说俏皮话,下面一句对应的原因(没有写入权限 / 磁盘空间不够 / 程序文件不完整,可能被杀毒软件拦掉了一部分 / 本机引擎启动到一半停下了 / 出了点意外),每种都给〔重试〕〔换个位置…〕〔用新的空白团队开始…〕〔打开日志文件夹〕〔复制详细信息〕(换位置按第 3 节定根的规则,数据和总工作区一起搬,搬的规则同第 8 节:同一个卷上改名,不同的卷上复制完再删旧的;还没有团队时只是换个空文件夹),再加一个「详细信息」折叠区(日志最后 200 行,已脱敏)。
+- 启动超过 180 秒:鲸鱼问「等太久了,要不要重试?」,卡片上只有〔继续等待〕〔重试〕〔打开日志文件夹〕,引擎同时继续启动。
- 后台更新器发现了新版本时,恢复页上显示「DeepSeek Bot {版本} 已经发布,可能修好了这个问题。」〔下载并安装〕,带下载百分比和「下载太慢?手动下载」(打开镜像页)。
- 引擎起来了但 DS Bot 界面 20 秒内没报告就绪(ds-bot 在界面挂载完成后调用 `dsBotApp.ready()`):回到启动页,显示「团队界面没有加载出来。」〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕。
- 首次启动期间再双击图标:恢复并聚焦已有窗口,失败页上也一样。
- 建窗口不再依赖「下载」文件夹:每次下载时才取它的位置,取不到就用家目录,再不行就不给默认位置,让用户自己选。
-- 日志:`%APPDATA%\DeepSeek Bot\logs\main.log`,2 MB × 3 份轮换,收主进程和引擎的输出;写之前去掉 `token=…`、`sk-…`,把用户文件夹的完整路径(如 `C:\Users\<用户名>`)换成 `%USERPROFILE%`。
-- 启动页是纯 DOM,CSP `default-src 'self'`;颜色取 [UI 标准](../design/ui-standard.md) 2.1 节 DeepSeek 主题的值,字号用标准里的 13 / 14 / 15 px。它只拿到 `dsBotStart`(`onState`、`act`),只在页面地址正好是启动页文件时才暴露。引擎页面上的 `dsBotApp` 只新增 `ready()`(上面的 20 秒检查)和 `focus()`(第 5 节登录后回到前台),其余不变。主进程对两者分别做精确的来源检查。
+- 日志:`%APPDATA%\DeepSeek Bot\logs\main.log`,2 MB × 3 份轮换,收主进程和引擎的输出;写之前去掉 `token=…`、`sk-…` 和 `/oauth/callback?…` 的查询部分,把用户文件夹的完整路径(如 `C:\Users\<用户名>`)换成 `%USERPROFILE%`。
+- 启动页是纯 DOM,CSP `default-src 'self'`;颜色取 [UI 标准](../design/ui-standard.md) 2.1 节 DeepSeek 主题的值,字号用标准里的 13 / 14 / 15 px。它只拿到 `dsBotStart`(`onState`、`act`),只在页面地址正好是启动页文件时才暴露。引擎页面上的 `dsBotApp` 只新增 `ready()`(上面的 20 秒检查)、`focus()`(第 5 节退回系统浏览器登录时回到前台)、`signIn`(第 5 节的登录窗口:`onClosed(原因, 代理)`、`close()`、`openOutside`)和 `foundKeys()` / `takeKey()`(第 5 节现成的 Key),以及主窗口露面时发给页面的一个事件(侧栏磁贴上的鲸鱼靠它浮上来,[启动窗口](2026-10-26-start-window.md) 第 8 节,待定),其余不变;新增的这些只在引擎的页面上、只对主窗口的主框架暴露。主进程对两者分别做精确的来源检查。
- `DS_BOT_HOME` 的一次性运行照旧:不问、不导入,但也显示启动页和失败页。
### 4. 已有 DSH 团队:导入卡
@@ -115,7 +127,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
条件:`~/.dsh`(或 `DSH_HOME`)里有 Bot 团队,而数据文件夹里还没有。
- 导入卡在启动页上出现。卡片一出现,两件事就在后台开始,不等用户回答:引擎在新数据位置预热(已定的「先在新数据位置启动一次再复制」照旧),先查团队有没有被 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 就是复制。「详细」展开才有:
+- 卡片的第一句是鲸鱼的话「找到你以前的团队了」,下面只有一句话和两个按钮:「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、行数最多的顺序。显示提供商和默认模型,旁边有「更换」,可以按同样的格式换另一份。
@@ -124,29 +136,42 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 第二段自己遍历目录树(不用 `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。」〔选择其他位置…〕〔先不复制〕。
+ - 卡片一出现先查第一段的空间:卡片上的「对话 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-<时间>` 暂存文件夹。
+- 第一段复制时卡片标题是「正在搬过来」,下面是分步进度和数字:「检查对话 23/143」→「复制 Bot 和对话 820 MB / 1.2 GB」→「启动团队」,带剩余时间估计和任务栏进度。〔停止复制〕会就地确认,并说明停下后会留下什么:不留下复制了一半的团队,DSH 里的团队不受影响。
+- DSH 正在用这个团队:第一句「DeepSeek Harness 还在用这个团队」,下面「请完全退出 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 段对话。工作文件正在后台复制(1,204 个,3.4 GB,还要大约 2 分钟)。」,然后是对模型的检查结果。检查通过显示「模型: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 的设置卡
-这是插件的功能,桌面应用、DSH Desktop 和 DSH Web 里都一样。
+设置卡是插件的功能,桌面应用、DSH Desktop 和 DSH Web 里都有,下面没注明的地方各形态一样;登录窗口和现成的 Key 一键用要靠应用(`dsBotApp`),只在桌面应用里。
+- 桌面应用首次启动交接后,Main Bot 的鲸鱼在侧栏的磁贴上浮上来一次([启动窗口](2026-10-26-start-window.md) 第 8 节),随后是下面的气泡和设置卡。设置卡的检查、通过和失败驱动磁贴上鲸鱼已有的状态动作(检查时是搜索,通过时是完成);指针在侧栏里时它的眼睛跟着指针(安静档没有);减少动态效果时它不动,只有徽标。
- Main Bot 还没有能用的模型时,它的聊天里不再是三个按钮,而是一张卡片(按 UI 标准里提问卡的样式):
- 气泡:「你好,我是{名字},负责管理你的 Bot 团队。开始之前,我需要先接上一个模型。选一种方式:」
- - A「用 DeepSeek 账号登录」,标「推荐」:「不用管理 API Key。没有账号的话,在登录页用手机号就能注册。费用从账号余额里扣;新账号如果有赠送额度,登录后会显示在这里。」主按钮〔在浏览器中登录〕。profile 里没有 DeepSeek 账号功能时不显示 A。
+ - A「用 DeepSeek 账号登录」,标「推荐」:「不用管理 API Key。没有账号的话,在登录页用手机号就能注册。费用从账号余额里扣;新账号如果有赠送额度,登录后会显示在这里。」主按钮在桌面应用里是〔登录 DeepSeek 账号〕,在 DSH Desktop 和 DSH Web 里是〔在浏览器中登录〕。profile 里没有 DeepSeek 账号功能时不显示 A。
- B「粘贴 DeepSeek API Key」:掩码输入框(占位「sk-…」)、〔检查并保存〕、「去 DeepSeek 开放平台创建 Key ↗」(`https://platform.deepseek.com/api_keys`)和一句「API 按用量计费,账户里要先有余额。」
- 底部「用其他模型服务…」打开 DS Bot 设置 → 模型的添加表单。
-- **登录**:点按钮就在系统浏览器打开 DeepSeek 登录页,卡片变成「已在浏览器打开 DeepSeek 登录页。登录完会自动回到这里;登录完成前请不要关闭这个窗口。」,带有效期、「浏览器没打开?复制登录链接」和〔取消〕。登录完成后窗口自动回到前台(桌面应用新增的 `dsBotApp.focus()`);Windows 不允许抢前台时,任务栏按钮闪烁。
+- **登录**:桌面应用里点〔登录 DeepSeek 账号〕,登录页在应用自己的**登录窗口**里打开,全程不离开应用:
+ - 卡片变成「正在登录 DeepSeek 账号…」,带有效期、〔取消〕和一行小字「登录窗口没出来?在浏览器里打开 · 复制登录链接」。登录完成后登录窗口自己关掉,焦点回到主窗口,卡片接着走余额检查。
+ - 登录窗口怎么来:DSH 的网页前端在点击时先 `window.open` 一个 `about:blank`(再把它的 `opener` 设成 null),拿到授权链接后用 `location.replace` 把它导过去(今天应用把这一步交给系统浏览器)。这个空白窗口不能当登录窗口:`window.open` 开出来的窗口由 Chromium 建在打开它的页面的 session 里(主窗口默认的、存在磁盘上的那个),`about:blank` 的 webPreferences 也照抄主窗口,`overrideBrowserWindowOptions` 改不了 partition。所以应用照今天的 `setWindowOpenHandler` 允许它、一直隐藏,只当作 DSH 手里的句柄;它第一次要导航时(主框架的 `will-navigate` 或 `will-redirect`),应用拦下这次导航:路径是 `/dsh/authorize` 的,用这个地址新建应用自己的登录窗口;不是的,照今天交给系统浏览器并销毁空白窗口。DSH 只会把它导到自己 `platformOrigin` 上这条固定路径的链接,所以授权页的来源从这次导航取,不读 DSH 的配置,CI 的 loopback 假平台也不用另配。
+ - 登录窗口是主窗口的子窗口(`parent` 是主窗口):系统边框,标题固定为「登录 DeepSeek 账号」,不跟着登录页的标题变(拦下 `page-title-updated`);内容区 480 × 680,主窗口所在显示器的工作区不到 760 高时,高度改为工作区减 80,登录页在窗口里滚动;居中在主窗口上、整个落在工作区里;不能单独最小化和最大化,随主窗口最小化。`sandbox`、`contextIsolation`,没有 preload、Node 和 webview;用一个不持久的独立 partition(`deepseek-login`)。这种 partition 要到应用退出才没,所以每次关窗都清掉它的存储和缓存(`clearStorageData`、`clearCache`):应用不保存 DeepSeek 平台的登录状态,下一次登录不会带着上一次的账号,登录的 token 只在引擎的凭据里。新的登录窗口等上一个窗口的清理做完再开:每次登录用的是同一个 partition,清理还没做完就开的窗口,刚拿到的 cookie 会被一起清掉。这个 partition 照 Bot 浏览器的分区(`bot-browser.mjs` 的 `#configure`)拒绝权限请求、权限检查、设备权限和屏幕共享,取消下载;但不照抄它的 `onBeforeRequest`:那条拦下发往引擎本机地址的所有请求,回调就到不了。登录窗口的 session 用自己的 `onBeforeRequest`:发往引擎本机地址(任何本机名加引擎的端口)的请求只放行主框架的 `GET /oauth/callback`,子框架、脚本和其他路径一律拦下,登录页和里面的验证码、扫码框架都碰不到引擎。窗口先隐藏,授权页第一次画出来(`ready-to-show`)再显示。全是 Electron 有文档的接口,不碰 DSH。
+ - 允许的地址(只管主框架的导航和重定向,看 `isMainFrame`;登录页里的子框架,比如验证码和扫码,照常加载和跳转):授权页的来源;主机名是 `deepseek.com` 或以 `.deepseek.com` 结尾的 https 页面;引擎本机地址加 `/oauth/callback` 这一个路径(DSH 的回调)。窗口里的 `window.open`(包括登录页上用户协议、隐私政策这类在新窗口打开的链接)不开新窗口,一律交给系统浏览器,登录窗口留在原来的页面上:登录窗口没有后退,在里面打开就回不到登录页。主框架要去名单外的地址时(比如第三方登录),这次登录换到系统浏览器:应用关掉登录窗口(不算取消),把这次登录的授权链接(不是那个地址)交给系统浏览器从授权页重新开始,并经 `onClosed('browser')` 告诉页面。设置卡和点了〔在浏览器里打开〕时一样,换成「已在浏览器打开 DeepSeek 登录页。登录完会自动回到这里;登录完成前请不要关闭这个窗口。」,有效期、〔取消〕和「复制登录链接」照旧,登录完成后调 `dsBotApp.focus()` 回到前台。同一次登录只在一处进行。
+ - 回调一有回应,应用就关掉窗口,不加载回应的那一页(在登录窗口的 session 上用 `webRequest` 看 `/oauth/callback` 这次请求的回应,不论状态码)。有回应不等于登录成功:应用的页面没有 `dshDesktop`,DSH 按网页版回应:成功时回 302 到完成页,这时引擎已经把登录记下来;换取失败时回一页会自己关掉的说明(200);取消时回 204;作废或重复的回调回 410。登录成没成只看 DSH 的登录状态,卡片照它走。看到回应时,应用先记下这个窗口的回调已经有了回应,再关窗;这次关窗算应用自己关,不发 `onClosed`。之后这个窗口再来的 `did-fail-load`(比如拦下回应造成的 `ERR_BLOCKED_BY_CLIENT`,或 400、410 没有内容的错误页)不算登录页加载失败。
+ - 两个窗口同生同灭:失败、过期、取消时 DSH 的前端关掉它手里的空白窗口,应用跟着关掉登录窗口;登录窗口不管因为什么关掉(回调有了回应、用户自己关、加载失败、交给了浏览器、页面调 `close()`),应用都销毁空白窗口:登录成功时 DSH 不关它已经导过的空白窗口,只丢掉引用,在别处登录完成时只有这一条能收掉它。DSH 再开始一次登录时(比如经典 Agent 模式里 DSH 账号菜单的「登录」,它直接调 `start()`),它先关掉旧的空白窗口再开一个新的,Host 回的还是同一次登录:旧登录窗口关掉,新的空白窗口一导航就开出新的登录窗口,这不算取消。登录窗口开着时点鲸鱼菜单的「登录 DeepSeek 账号」或修复卡的登录按钮,只打开 DSH 自己的登录框,显示等待中,它的〔登录〕是灰的,登录窗口不换;在那个登录框里点〔取消〕或 ×,DSH 取消这次登录,登录窗口跟着关掉,设置卡回到两种方式。不管登录在哪里完成,插件在账号变成已登录、或这次登录结束时调 `dsBotApp.signIn.close()` 关掉还开着的登录窗口。
+ - 谁关的窗口,应用分得清。只有三种关窗,应用经 `dsBotApp.signIn.onClosed(原因, 代理)` 告诉页面(代理只在 `failed` 时有,见下一条):`user`(用户按 × 或 Alt+F4,回调请求还没从这个窗口发出)、`failed`(登录页加载失败)、`browser`(主框架去了名单外的地址,交给了系统浏览器)。跟着空白窗口关的、回调有了回应关的、页面调 `close()` 或 `openOutside` 时关的,以及回调请求发出之后用户再关的,都不发。用户关的、而且回调请求还没从这个窗口发出,等于取消:卡片在这次登录还在等浏览器(`waiting-browser`)时调用 DSH 的 `cancel`,回到两种方式的卡;回调请求发出之后再关(用户已经在登录页里登录完,DSH 正在换取和保存),不算取消,不发 `onClosed`,卡片等 DSH 的结果。`failed` 和 `browser` 都不取消。修复卡和鲸鱼菜单走的是 DSH 自己的登录框,没有这张卡:插件从 `settings.models.sign-in` 条目的账号状态取当前这次登录,按同样的规则调 `cancel`,不等它过期。
+ - 登录页加载失败(比如断网、代理不对;看主框架的 `did-fail-load`,`isMainFrame` 为真,子框架打不开不算,回调有了回应之后的也不算):窗口关掉,`onClosed('failed', 代理)`,这次登录不取消;卡片显示「打不开 DeepSeek 登录页。」〔重试〕〔在浏览器里打开〕〔取消〕,有效期照旧;〔取消〕调用 DSH 的 `cancel`,回到两种方式的卡。代理由应用在主进程里取:用登录窗口的 session 对授权链接 `resolveProxy`,取结果第一项的地址(如 127.0.0.1:7890),第一项是 `DIRECT` 时为空;页面自己读不到系统代理。代理不为空时,加一句「登录页走的是系统代理 127.0.0.1:7890:如果代理软件没开,打开它。」,不提第 7 节的「跟随系统代理」开关:登录窗口走应用自己的 Chromium 网络,本来就跟随 Windows 系统代理,那个开关只管引擎。〔重试〕再开始一次登录:Host 回的还是这一次,DSH 开一个新的空白窗口,应用开一个新的登录窗口。
+ - 〔在浏览器里打开〕和登录卡小字里的「在浏览器里打开」都走系统浏览器(`dsBotApp.signIn.openOutside`,用这一次的授权链接;登录窗口还开着就由应用关掉,不算取消),卡片换成「已在浏览器打开 DeepSeek 登录页。登录完会自动回到这里;登录完成前请不要关闭这个窗口。」,有效期、〔取消〕和「复制登录链接」照旧;登录完成后窗口回到前台(`dsBotApp.focus()`);Windows 不允许抢前台时,任务栏按钮闪烁。
+ - 登录窗口的地址一律不写进日志,和 DSH 自己的诊断一样不记授权链接:`did-fail-load` 只记错误码和主机名,交给系统浏览器的地址也不记。
+ - 登录窗口只在用户点了某个登录入口之后出现,从不自己弹出;它是主窗口的子窗口,启动窗口阶段没有它([启动窗口](2026-10-26-start-window.md) 第 1 节)。应用接的是 DSH 网页前端的每一次登录,所以桌面应用里不只设置卡:第 8 节的〔重新登录〕、第 6 节修复卡的〔用 DeepSeek 账号登录〕〔改用账号登录〕〔重新登录〕、第 7 节鲸鱼菜单的「登录 DeepSeek 账号」,以及 DSH 自己登录框里的登录,也都在登录窗口里登录。
+ - DSH Desktop 和 DSH Web 里不变:按钮仍叫〔在浏览器中登录〕,DSH Web 开新标签页、DSH Desktop 开系统浏览器,卡片写「已在浏览器打开 DeepSeek 登录页。登录完会自动回到这里;登录完成前请不要关闭这个窗口。」。
- 卡片用的是 `settings.models.sign-in` 条目注入的操作,取法和今天一样(`ctx.slots.entries('settings.models.sign-in')` 的第一个,即现有的 `actions.signInEntry()`)。这些操作有类型声明,但 DSH 没有写成给插件用的接口:每个要调的操作都先确认存在,缺了就退回今天的 `DeepSeekSignIn`。
- 和 DSH 自己的做法一样:开始登录时 `setOnboarding(true)`;成功、取消、过期、失败,以及卡片卸载时,都调 `setOnboarding(false)` 和 `showLogin(false)`。否则切到经典 Agent 模式时,DSH 的账号菜单会再弹出一个登录框。`start()` 本身失败时按「登录没有完成」处理。
- **粘贴 key**:保存前先检查。只对 DeepSeek 官方地址:`GET https://api.deepseek.com/user/balance`,8 秒超时,不记录 key 和返回内容。`DEEPSEEK_BASE_URL` 指向本机地址时(mock 模型),检查发到那个本机地址的 `/user/balance`;其他自定义地址或中转服务不检查余额,交给第一轮的修复卡。key 只会发给 `api.deepseek.com` 或本机地址。
@@ -154,20 +179,64 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 格式不对(带引号、带 `NAME=` 等,沿用现有规则):「只粘贴 Key 本身,不要带引号或 NAME=…」
- 余额为零:key 保存,卡片显示「Key 没问题,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔再查一次余额〕〔换一种方式〕(回到 A/B 两种方式的卡,已经保存的 key 留着)。
- 连不上:「暂时连不上 api.deepseek.com,Key 还没保存。如果在用代理软件,确认它开着。」〔再试一次〕〔仍然保存〕。429 或 5xx:「DeepSeek 服务暂时繁忙({状态码}),Key 还没保存。」同样两个按钮。
- - key 来自环境变量 `DEEPSEEK_API_KEY` 而检查没通过:「这个 Key 来自环境变量 DEEPSEEK_API_KEY,这里改不了。」〔换一种方式〕
+ - key 来自环境变量 `DEEPSEEK_API_KEY` 而检查没通过(按 `describe` 的 `source` 认,不按 `writable`):「环境变量 DEEPSEEK_API_KEY 里的 Key 检查没通过。换一种方式接上就行,在这里保存的 Key 优先于环境变量。」〔换一种方式〕
+- **现成的 Key 一键用**(只在桌面应用;看不看剪贴板待定):卡片出现时应用看两处,找到了就在 A、B 之上多一行「{来源}里有一个 Key:sk-1a2b3…」和〔用这个 Key〕,照样先检查再保存;Key 本身不显示、不进日志。这一行最多一行;它在的时候〔用这个 Key〕是卡上唯一的主按钮,A 的〔登录 DeepSeek 账号〕改成次按钮,「推荐」照旧标在 A 上(UI 标准 10.1:每个界面最多一个主按钮):
+ - DeepSeek Harness 自己的凭据:和导入看同一个家(`DSH_HOME`,没设就是 `~\.dsh`)。先看 `.credentials.yaml` 里 `refs` 下的 `DEEPSEEK_API_KEY`,没有就看那里 `.env` 的同名行;只认 Key,不读 `records` 里的登录记录。那个家给 DeepSeek 设了别的地址时(`.env` 里的 `DEEPSEEK_BASE_URL`,或任何一个 `profiles/*/cordis.patch.yml` 里 `llm-deepseek` 的 `baseURL`,和导入读模型设置的是同一批文件)不出这一行:这把 Key 是给那个地址的,检查会把它发到 `api.deepseek.com`。这一行写「DeepSeek Harness 里有一个 Key:sk-1a2b3…」。装过 DSH、配过 Key、但没有团队可导入(或者答了〔先不复制〕)的人就是这种情况。导入过团队的人,Key 一般已经随 `.credentials.yaml` 或 `.env` 复制过来,设置卡不出现;导入来的 Key 检查没通过时设置卡会回来,这时找到的 Key 和数据位置里已经存的一样,就不出这一行。只读不写,和导入一样。
+ - 剪贴板里正好是一个 DeepSeek 的 Key(整段去掉首尾空白后是 `sk-` 加 32 位十六进制,和下面聊天卡认 DeepSeek 格式的规则一样,以实测为准):这一行写「剪贴板里有一个 Key:sk-1a2b3…」。别家格式的 Key 不出这一行,不把别家的 Key 发去 `api.deepseek.com` 检查。只在设置卡显示期间读:卡片出现时读一次,之后窗口每次回到前台再读一次;只比对格式,不记录;整段值留在应用里,页面只拿到来源和前八位;之后再读到剪贴板变了(窗口回到前台、点〔用这个 Key〕时),这一行按新读到的结果换掉或消失。
+ - 两处都有时仍然只有一行:应用在主进程里比对整段值,相同就只算 DeepSeek Harness 那把;不同就显示剪贴板那把,下面一行小字「改用 DeepSeek Harness 里的 Key(sk-1a2b3…)」。
+ - 前八位和 DSH 掩码保留的位数一样。点按钮时应用才把值交给页面:`dsBotApp.foundKeys()` 只回来源和前八位,`dsBotApp.takeKey(来源)` 再读一次,读到的仍是一个 Key、前八位也和这一行上的一样时才回整个值,否则不回值、这一行按新读到的结果换掉或消失;页面走和粘贴 Key 完全一样的检查和保存(Host 的 `provider-key`)。401 或余额为零按上面处理,提示写明来源:「DeepSeek Harness 里的 Key 不能用(401)。」,这一行消失。检查没通过(401)的 Key,插件在页面内存里记下它的来源和前八位(应用不知道检查的结果,也不另加接口):这个页面里之后再读到同一来源、同样前八位的 Key(窗口回到前台、切到别的 Bot 再回来、卡片重新出现),都不出这一行;两处都有时改出另一处那把。重新加载页面后才会再出现。
+ - 环境变量里的 `DEEPSEEK_API_KEY` 不用按钮:引擎继承应用的环境(`process.env`),数据位置的 `.credentials.yaml` 里没有这把 Key 时,DSH 的凭据层退回到它,`describe` 报已配置、`source` 是 `env`(`writable` 仍是 `true`),设置卡不出现;只有它检查没通过时才有上面「来自环境变量」那张卡。在这里保存的 Key 写进凭据文件,优先于环境变量,所以〔换一种方式〕之后粘贴或登录都能接上,不用改环境变量。
+- **在聊天里粘了 Key 也认**(所有形态):真实用户会把 Key 直接发到 Bot 的聊天框里,发出去就进了对话记录、还会发给模型。没有能用的模型时 Bot 聊天的输入框本来就锁着(见下面「输入框不可用」那条),粘不进去;所以这张卡管的是接上模型以后的 Bot 聊天和群聊(比如修复卡报 AUTH 时用户把新 Key 发进来;新团队的 Main Bot 要等上手结束,上手期间粘进目标卡输入框的 Key 见第 6 节),以及模型列表还没出来的那一刻。插件观察每个 Bot 和群聊会话的草稿(DSH 有文档的 `ctx.conversation.input`,每个会话的 `state`),整段去掉首尾空白后正好是一个 `sk-` 开头的 Key(`sk-` 后面 20 个以上的字母、数字、`_` 或 `-`,其中至少一个数字,和 DSH 掩码认 `sk-` Key 的规则一致;别家的 `sk-` Key 也算;DSH 掩码认的其他格式,如 `ghp_`、`AKIA`,不是模型服务的 Key,不拦;带 `NAME=` 或引号的也不拦,和句子里夹着 Key 一样),就给这个会话挂一个 `ComposerBlock`(DSH 有文档的 `ctx.conversation.blocks`:输入框变灰,不能编辑也不能发,草稿留在里面),并在输入框上方的卡片槽(`conversation.input.dock`,和今天 Bot 要秘密的卡同一处)显示一张卡,按状态选文案:
+ - DeepSeek API 还没有 Key:「这看起来是一个 API Key,还没有发出去。要保存成 DeepSeek API 的 Key 吗?」〔检查并保存〕〔当普通消息发送〕〔清掉〕,小字「改一下 · 保存到其他提供商…」。
+ - DeepSeek API 已经有 Key:「这看起来是一个 API Key,还没有发出去。要把 DeepSeek API 的 Key 换成它吗?」〔检查并换上〕〔当普通消息发送〕〔清掉〕,小字同上。
+ - 不是 DeepSeek 的格式(DeepSeek 的 Key 是 `sk-` 加 32 位十六进制,以实测为准):「这看起来是一个 API Key,还没有发出去,但不像 DeepSeek 的 Key。要保存到哪个提供商?」〔保存到提供商…〕〔当普通消息发送〕〔清掉〕,小字「改一下」。〔保存到提供商…〕打开 DS Bot 设置 → 模型的添加表单,Key 已经填好(只在页面里传);保存后 `setDraft('')`、撤掉 block;没保存就关掉表单时,草稿和 block 留着。
+ - 这个 Bot 正有一张要填值的 `request_secret` 卡在等时:「这看起来是{名字}正在要的 Key,还没有发出去。」〔填进那张卡〕〔当普通消息发送〕〔清掉〕,小字「改一下 · 保存成 DeepSeek API 的 Key」。〔填进那张卡〕把草稿移进那张卡的输入框(卡在对话里时滚到它),`setDraft('')`、撤掉 block。
+ - 〔检查并保存〕/〔检查并换上〕:从草稿取值,走和设置卡完全一样的检查和保存;通过后 `setDraft('')` 清掉草稿、撤掉 block。没通过时草稿和 block 都留着,卡上换成检查的结果,〔当普通消息发送〕〔清掉〕和小字「改一下」照旧:401 写「DeepSeek 不接受这个 Key(401)。请确认整段复制了,或者新建一个。」,主按钮换成〔清掉〕,不再有〔检查并保存〕;连不上、429 或 5xx 写设置卡「粘贴 key」里的同一句(「Key 还没保存」),主按钮〔再试一次〕,旁边〔仍然保存〕(已经有 Key 时是〔仍然换上〕),保存后同样 `setDraft('')`、撤掉 block。余额为零时 Key 保存,同样清掉草稿、撤掉 block,卡片留着,写「Key 已保存,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔知道了〕,点〔知道了〕才收起;这里没有两种方式,不带〔再查一次余额〕〔换一种方式〕。设置卡由状态决定(第 8 节),不在这里写它。
+ - 〔当普通消息发送〕:先把这段草稿记成「放过」,撤掉 block,再调这个会话输入框自己的发送(`ctx.conversation.input.for(会话).submit()`,和点发送按钮同一条路):草稿由 DSH 清掉,附件一起发出,发送失败时由 DSH 还原草稿。DSH 发送时把草稿清空不算改:草稿空着、或者又变回这一段时「放过」仍在,所以还原回来的草稿不再挂 block;草稿变成别的非空内容时「放过」作废,按新的草稿重新判断。这条路不带 DSH 的插话设置,回合进行中时一律排进队列。
+ - 〔清掉〕:`setDraft('')`,撤掉 block;Key 不保存,也不发出。401 之后也靠它离开。
+ - 「改一下」:撤掉 block,草稿原样留着,焦点回到输入框(`focus()`);这段草稿记成「放过」,不再拦;这样记下的「放过」草稿一改就作废(和〔当普通消息发送〕记下的不同),按新的草稿重新判断。
+ - 一个会话只有一个 block(`ctx.conversation.blocks.set` 是替换,传 `undefined` 清掉的是整个 block),下面「没有能用的模型」的锁和第 6 节上手的锁也用它。所以插件只在一处算这个会话的 block:模型锁 > 上手锁 > Key 的 block,三样都没有才清空。上面说的「撤掉 block」,是去掉 Key 这一层再按这条重新算。
+ - 挂着 block 时输入框是只读的(DSH 的 block 让编辑器不能编辑,占位里的原因也只在草稿为空时显示),用户自己改不了草稿,出口全在卡片上;草稿被别处改成别的内容时(比如别的插件调了 `setDraft`),block 和卡片自己消失;切到别的会话再回来、或者重新加载时,按当时的草稿和「放过」重新判断。「放过」按会话记在页面的内存里,记的是草稿全文;切到别的会话再回来还在,重新加载就没了。只拦整段是 Key 的草稿:句子里夹着 Key 不拦,DSH 的掩码只改显示,模型仍会收到。
+ - 拦着的时候 Key 只在这个页面里:点了〔检查并保存〕才交给 Host 的 `provider-key`;点了〔当普通消息发送〕,它就和别的消息一样进对话记录、发给模型。但 DSH 本来就把每个会话的草稿存在浏览器的 localStorage 里(`dsh.conversation.<会话>`;桌面应用里在 `%APPDATA%\DeepSeek Bot` 下,DSH Web 里在用户的浏览器配置里),挂着 block 的这段时间 Key 也在那里,重开后还在,直到草稿被清掉。
- **账号余额为零**(登录后):「已登录 DeepSeek 账号,但余额是 ¥0.00。充值后我就能开始;一般一轮对话只要{实测值},以 DeepSeek 价格页为准。」〔去充值 ↗〕〔再查一次余额〕〔换一种方式〕。key 余额为零时用上面「粘贴 key」里的卡片。这两张卡显示期间,窗口回到前台时、以及每 10 秒(最多 10 分钟)自动重查,余额一到就自己往下走。
-- **自动选模型**(插件形态里是否也这样待定):只有一个提供商能用时,不再让用户选,直接用 DSH 默认模型(能用的话),否则用这个提供商的第一个模型。选之前先确认能用:有不调用模型的检查就用它(账号余额、`/user/balance`;后者是否计费没有文档),没有就发一次 8 token 的试连。通过后卡片收成一行「已接上 DeepSeek-V4.1-Flash · DeepSeek 账号 更换」,Main Bot 的开场白随即开始。两个以上提供商能用时,仍按提供商分组让用户选,DSH 默认模型标「推荐」。
+- **自动选模型**(插件形态里是否也这样待定):只有一个提供商能用时,不再让用户选,直接用 DSH 默认模型(能用的话),否则用这个提供商的第一个模型。选之前先确认能用:有不调用模型的检查就用它(账号余额、`/user/balance`;后者是否计费没有文档),没有就发一次 8 token 的试连。通过后卡片收成一行「已接上 DeepSeek-V4.1-Flash · DeepSeek 账号 更换」,随即是 Main Bot 固定的开场白,不调用模型(第 6 节)。这次检查照旧要做:开场白不再用到模型,但检查也挡着 Main Bot 的第一个正常回合。两个以上提供商能用时,仍按提供商分组让用户选,DSH 默认模型标「推荐」。
- 登录 DeepSeek 账号后,DSH 的账号前端会尽力把账号模型存成默认,但这一步不保证完成、也不保证先于我们,所以只剩账号这一个提供商时,DS Bot 自己选账号的第一个模型,不等 DSH。
- 开场白只在确认能用之后才发。聊天记录不会以一行红字开头。
- 没有能用的模型、且模型列表已知时,Bot 聊天的输入框不可用,占位写「先在上面接上模型,我就能回复你」(DSH 有文档的 `ComposerBlocks`)。
-- 万一消息在接上模型前就发出去了(比如别的入口),开场白不再被删掉:Main Bot 接上模型后先回答这条消息,再用一句话说明自己是管团队的。
+- 万一消息在接上模型前就发出去了(比如别的入口),开场白不再被删掉:Main Bot 接上模型后先回答这条消息,再用一句话说明自己是管团队的(模型写的,和今天一样)。这是它的第一个正常回合,用原来的工具,不算在第 6 节上手的 3 次请求里;会话里已经有用户自己发的消息,上手算结束(第 8 节),不再出固定的开场白和目标卡。
- 判断「能用」:catalog 里标了 `needsKey` 的模型不算能用。Host 的默认模型(`pickDefault`、`defaultModel`、`cachedDefault`)、建 Bot、`create_bot` 不指定模型时的回退、模型不再被服务时 `desiredModel` 和 `memory.js` 里的回退、模型菜单(`ModelRows`)和选模型卡片,都只从能用的模型里挑。需要 key 的模型在列表里显示「需要 API Key」,点它打开 key 卡片。
- `needsKey` 只覆盖「profile 写了 `apiKeyEnv`、而凭据未配置」的提供商;DeepSeek 账号这类登录式的提供商永远不会标 `needsKey`,没登录时也在列表里。所以「能用」最终以上面的检查为准,`needsKey` 只是第一道过滤。
- 提供商的显示名:`deepseek-account` 显示「DeepSeek 账号」,`deepseek-official` 显示「DeepSeek API」。中文统一用「提供商」(替换 `i18n.js` 里的「服务商」)。
### 6. 第一条有用的回复
-- 开场白用界面语言(沿用现有的 kickoff),两句,以一个问题结尾。下面在用户发第一条消息前显示:「已接上 DeepSeek-V4.1-Flash · DeepSeek 账号 更换」、「工作文件夹:`C:\Users\<用户名>\DeepSeek Bot` 更换」,以及「试试:」三个固定按钮:「你能帮我做什么?」「帮我建一个写周报的 Bot」「搜一下今天的科技新闻,挑 5 条讲给我」。这三件事不需要读文件、跑命令或日历权限,第一步不依赖模型自己出题。点按钮等于用户自己发这句话。
+新团队(不是导入来的)接上模型以后,Main Bot 的聊天里先走两步引导,再做第一件事。每一步都是插件画的卡,答完留在聊天里:控件变灰,选过的保持高亮。每张卡都有「跳过设置,直接开始」,点了就结束上手。输入框锁着(`ComposerBlock`,占位「先在上面的卡片里回答」),到上手结束、或者点了第一件事卡的「自己说…」才打开。导入来的团队不走这些,它们是第 4 节的「复制好了」卡和模型检查。
+
+- **开场白**:设置卡收成「已接上 DeepSeek-V4.1-Flash · DeepSeek 账号 更换」那一行后,Main Bot 发一段界面语言的固定文字「你好,我是{名字},负责你的 Bot 团队。想先让我做点什么?在下面选,或者用自己的话说。」,不调用模型:开场白照旧作为一个回合送进 Main Bot 的会话,插件在它的 `llm/stream` 监听里直接回这段文字,和今天换段时回 `HANDOFF_ACK` 一样。下面照旧一行「工作文件夹:`C:\Users\<用户名>\DeepSeek Bot` 更换」。设置卡收成一行后约 420 ms 是开场白,约 900 ms 是目标卡。
+- **目标卡**:标题「最想让团队先帮你做什么?」,同一行一个灰色的「可以多选」。
+ - 四个选项〔写东西:文章、周报、文案〕〔写代码、改程序〕〔查资料、做调研〕〔日常杂事:日程、邮件、整理〕是开关按钮(`aria-pressed`,在标签为「想先做什么,可以多选」的一组里):点一下选中,再点取消,几个都可以选中;选中的带对勾,不只靠颜色。
+ - 一个输入框「用自己的话说…」。
+ - 〔确定〕是卡上唯一的主按钮,选中至少一个选项、或者输入框里有字时才能点;在输入框里按 Enter 就是〔确定〕,输入法正在组字时不算。
+ - 〔跳过〕:不建 Bot,直接出第一件事卡,上面是原来「试试:」的三个固定任务「你能帮我做什么?」「帮我建一个写周报的 Bot」「搜一下今天的科技新闻,挑 5 条讲给我」。这三件事不需要读文件、跑命令或日历权限,不依赖模型自己出题。
+ - 答完后选中的选项保持高亮,所有控件变灰,输入框里的字留着;点的是〔跳过〕或「跳过设置,直接开始」时,没有一个选项算选中。
+ - 只选了选项:不调用模型,马上出现成的建议(每个目标一组,写在代码里)。
+ - 输入框里有字(选没选选项都一样):调用一次模型。这是一次不带工具的 JSON 调用,和上下文管家的 `askSteward` 同一种形态(固定的提示词,没有 `tools`,经 `ctx.llm.stream`,只回 JSON);这次调用自己的上限是 `maxTokens` 700、12 秒超时,回答按闭合的 schema 校验,不合就当没有回应。schema 里是 `goal`(`write`、`code`、`research`、`daily`、`general` 之一:四个选项各一个,再加通用的那一组)、一句不超过 18 个字的摘要、最多 3 个 Bot 草案(名字、角色、理由)和最多 3 个第一件事(各带它的草案序号)。
+ - 输入框里整段是一个 Key 时(规则同第 5 节「在聊天里粘了 Key 也认」),〔确定〕不调用模型,目标卡下面出第 5 节那张卡(按状态选文案和按钮,没有〔当普通消息发送〕和「改一下」);保存或〔清掉〕之后输入框清空,目标卡等用户重新回答。输入框照样能改,只要整段还是一个 Key,〔确定〕就不调用模型。
+- **合并**:选中的目标按卡上的顺序排,不按点的先后。有文字时,文字的那一组是模型的草案,它属于哪个目标看模型返回的 `goal`(模型没有回应时,文字按关键词对上一组现成的,见下面「模型不可用时」):`goal` 是所选目标之一时,那一组换成模型的草案,位置不变;是所选以外的目标时加在后面;是通用的、又选了选项时不加(只有文字时就用文字的那一组,通用的也算)。只有一个目标时就是它那一组。几个目标时 Bot 轮流取:先取每组的第一个,再取每组的第二个,以此类推,同名的只留一个,最多 5 个;第一件事是留下的每个 Bot 自己的任务(模型给的任务按它带的草案序号归到 Bot),按 Bot 的顺序,最多 3 个。摘要里每个目标是一个词(写东西 / 写代码 / 查资料 / 处理日常杂事,词里不带「、」),几个目标用「、」连起来;引号里是用户自己的话,超过 18 个字时换成模型给的那句摘要:
+ - 只有选项:「想先写东西、查资料:建议建这 N 个 Bot,名字可以直接改。」
+ - 选项加文字:「想先写东西,还说了「查一下竞品」:建议建这 N 个 Bot,名字可以直接改。」
+ - 只有文字:「按你说的「…」,建议建这 N 个 Bot,名字可以直接改。」
+- **建议卡**:摘要下面每个 Bot 一行:勾选框、它的鲸鱼(各用一种颜色)、可以改的名字(最多 12 个字)、角色标签(最多四个字)、一句理由。
+ - 〔建这 N 个 Bot〕是主按钮,N 跟着勾选变,一个都没勾时不能点;〔只要{第一个名字}〕的名字跟着第一行的名字变。
+ - 〔换一组建议〕:再调用一次模型(同样的调用和 schema),提示词里带上所选目标、用户的话和已经给过的草案,要一组不重复的,换掉卡上的几行,摘要写「换一组:建议建这 N 个 Bot,名字可以直接改。」。目标卡和建议卡合计最多 3 次请求,到了这个按钮就变灰,旁边写「已到上限」;两张卡底部都写着「模型请求 n/3」。
+ - 「跳过设置,直接开始」。
+- **建 Bot 和第一件事**:点〔建…〕才真的建,这些 Bot 用改过的名字一个个出现在侧栏里 Main Bot 的下面。它们不发模型写的招呼:每个 Bot 的聊天里先是一段固定文字,它的名字加建议卡上那一行的理由(如「你好,我是笔杆。起草文章、周报和文案,照你的口吻改稿。」),和 Main Bot 的开场白一样在 `llm/stream` 监听里回,所以〔建…〕不花一次请求。然后是第一件事卡「第一件事做什么?」:建议里的三个任务,写着用户起的名字(勾掉了 Bot、任务不够三个时,用上面三个固定任务补满),外加「自己说…」(打开输入框,焦点放进去)。点任务等于用户自己发这句话。第一件事(点的任务,或者「自己说…」之后发出的第一条消息)一发出,插件就调用 `restrict` 返回的解除函数、撤掉 guard:它是 Main Bot 的第一个正常回合,用原来的工具,不算在 3 次请求里,也不受下面每一步的 token 和时限。它回复以后,聊天里出现一行灰字「上手结束:{名字}的工具不再受限」,输入框打开。「跳过设置,直接开始」直接解除限制、出这行灰字、打开输入框。
+- **模型不可用时**:选项照样给现成的建议。输入框里有字时,建议卡上面写「模型暂时没有回应。先用现成的建议,或者直接开始。」,下面是现成的建议(文字按关键词对上一组现成的,再照上面的规则合并),摘要只写「建议建这 N 个 Bot,名字可以直接改。」;〔换一组建议〕没有回应时显示同一句,原来的几行不变,这次请求照样计数。第一件事的回复失败时,就是下面的修复卡。
+- **深度限制是机制,不是提示词**:
+ - 步骤表写在代码里,Host 按卡片的回答往下走,模型从不选下一步。
+ - 上手期间(开场白到第一件事发出之前),第一个 Main Bot 的会话用 `agent.ctx.tools.restrict({ allow })` 只留 `ask_user` 和草稿模式的 `create_bot`(只出草案,用户点了才建),`tools.guard` 限制每一步的调用次数,超了就拒绝、要它直接回答。第一件事一发出就解除(上面)。
+ - 每一步(每次按〔确定〕或〔换一组建议〕)最多一次请求,输出 400 到 700 token(`maxTokens` 700):8 秒内没有第一个字、或者 12 秒还没回完,就出这一步的兜底卡。上手期间 Main Bot 的会话里万一跑起一个回合(输入框锁着,只能来自别的入口),它也只有一次请求,8 秒内要有第一个字,整轮 20 秒内完成,否则同样出兜底卡。整个上手最多 3 次请求,就是卡上的「模型请求 n/3」;第一件事不算在里面,它发出时限制已经解除。
+ - 每一步都有一张模型关着也能走通的卡。CI 用 mock 模型跑这几种情况:正常、断网、来回循环、答非所问、编造模型名、401、余额为零、把 Key 粘进目标卡的输入框。
- Bot 聊天里任何一轮失败,都由插件画一个修复卡,替换 DSH 的「本轮运行失败」那一行(DSH Agent 的普通会话不变)。原文、代码、HTTP 状态码和 request id 放在「技术详情」里,可以复制;AUTH 的原文照旧不显示。
| 代码 | 卡片 | 按钮 |
@@ -185,7 +254,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 卡片按失败代码选,不看原文(DSH 也是按代码分流的,原文和 `failureMessage` 都是它的内部细节)。提供商名字和状态码取自这次失败的路由和 HTTP 状态,不写死「402」或「DeepSeek」:QUOTA 也可能来自别的状态码和别的提供商。`noteTurnFailure` 今天只把状态码和 request id 写进诊断日志,要新增到 Bot 的状态里(`bot.blocked`),经 `api/bot` 给卡片读。
- 「重试」让 Bot 接着做,不会把用户的话再发一遍。充值回来后自动重查余额,并接着做。
-- 开场白因为凭据或余额失败时,重新留着,下一次检查通过时再发。
+- Bot 的招呼(第一个 Main Bot 的固定开场白和建议卡建的 Bot 的固定招呼除外,它们不调用模型)因为凭据或余额失败时,重新留着,下一次检查通过时再发。
### 7. 第一个小时
@@ -203,8 +272,9 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
### 8. 以后的启动和回头入口
-- 以后每次启动也显示启动页,只写「正在打开你的团队…」,然后打开上次的 Bot(预计 3 到 12 秒,以后的启动还没实测)。
-- 设置卡由状态决定:没有能用的模型(跳过过、删了 key、退出了登录),Main Bot 的设置卡就回来;账号登录过期时显示「DeepSeek 账号的登录失效了。」〔重新登录〕。
+- 以后每次启动也显示启动页:64 px 的鲸鱼和「正在打开你的团队…」,没有水线和圈,也没有第 3 节鲸鱼的话和提示;10 秒起显示「已用 N 秒」,45 秒「比平时慢,请再等一会儿。」〔打开日志文件夹〕,180 秒和首次启动一样([启动窗口](2026-10-26-start-window.md) 第 5 节)。然后打开上次的 Bot(预计 3 到 12 秒,以后的启动还没实测)。
+- 设置卡由状态决定:没有能用的模型(跳过过、删了 key、退出了登录),Main Bot 的设置卡就回来;账号登录过期时显示「DeepSeek 账号的登录失效了。」〔重新登录〕(桌面应用里同样在登录窗口里登录)。
+- 目标卡、建议卡和第一件事卡(第 6 节)只在新团队接上模型、上手还没结束时出现。上手结束看 Main Bot 的会话:里面有那行「上手结束」的灰字、或者有用户自己发的消息(第一件事也是),就算结束,从会话里读,不另存标记;结束以后它们不再回来,设置卡回来时也不带它们。上手中途关了应用、或者模型没了:重开或重新接上模型后从目标卡重新开始,开场白不再发,已经建好的 Bot 留着,`restrict` 和 guard 重新挂上(它们只在内存里),「模型请求 n/3」从 0 算起。导入来的团队从来不出。
- 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 有文档的接口。
- 设置 → 通用 → 位置(桌面应用):「位置」一行显示数据文件夹和总工作区,各有〔打开〕,一个〔移到…〕把两个一起搬到新的根 `R` 下面的 `data` 和 `workspace`(定根和首次启动同一条规则)。搬是搬,旧位置不留副本。确认写明会搬什么、删什么:「会把数据和工作文件搬到 `D:\DeepSeek Bot`。搬完后 `C:\Users\<用户名>\.ds-bot` 和 `C:\Users\<用户名>\DeepSeek Bot` 会删除。」〔搬过去〕〔取消〕。搬之前先查目标卷的剩余空间(不同的卷要「数据 + 要搬的工作文件 + 1 GB」),不够就在确认里说清差多少,不动手。
@@ -225,11 +295,11 @@ 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(底层;界面里只在讲它本身时出现:导入和复制团队、设置卡里的现成 Key(那一行和「不能用」的提示)、它的沙盒问题、「高级设置(DeepSeek Harness)」)、本机引擎(启动页上对应用启动的 DSH 的叫法)、鲸鱼的话(启动页上鲸鱼下面那一行字,一次一句)、圈(鲸鱼离开一站后留在水线上的细线椭圆)、登录窗口(桌面应用里登录 DeepSeek 账号的子窗口)、目标卡、建议卡、第一件事卡(第 6 节上手的三张卡)、主 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、DSH Desktop、DSH Web、Agent、MCP、Windows、PowerShell、GitHub、SmartScreen、OneDrive、HTTP、SOCKS)、模型名、提供商名(如 OpenRouter)、用户自己起的名字(Bot、群聊)、文件名、路径、网址、环境变量名和单位(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、群聊)、文件名、路径、网址、环境变量名、Key 的格式和前八位(占位的「sk-…」、卡上的「sk-1a2b3…」)和单位(KB、MB、GB);「技术详情」和「详细信息」里的原文不算。测试会扫描。
## 改动的已定设计
@@ -249,6 +319,9 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
| 同上「几个 profile 都有时让用户选一份」 | 自动选,按提供商和默认模型显示,可以更换 |
| 同上 有新版本对话时按钮是「退出 / 不带团队开始」 | 能更新就「更新后再复制」;不能就以「先不带团队开始」为主 |
| 同上「模型服务商和 key 在 DSH 自己的设置里配」 | 在 Main Bot 的设置卡和 DS Bot 设置 → 模型里配(仍写进 DSH 的凭据和设置);应用关掉 DSH 的自动凭据引导;DSH 的模型页放在「高级设置(DeepSeek Harness)」 |
+| 同上 变更 2026-10-20「DSH 打开的登录窗口交给系统浏览器」 | 桌面应用里登录页在应用自己建的登录窗口里打开(主窗口的子窗口,独立的不持久 partition,关窗就清掉,只允许 DeepSeek 的页面和引擎的回调);DSH 开的空白弹窗照旧允许、一直隐藏,只当它手里的句柄,两个窗口同生同灭;回调一回应就关掉;打不开或主框架要离开 DeepSeek 时才退回系统浏览器。DSH Desktop 和 DSH Web 不变 |
+| 本文首稿 §5「点按钮就在系统浏览器打开 DeepSeek 登录页……登录完成后窗口自动回到前台」 | 同上;`dsBotApp.focus()` 只在退回系统浏览器时用 |
+| 本文首稿 §3「`dsBotApp` 只新增 `ready()`……和 `focus()`……」 | 再加 `signIn`(`onClosed(原因, 代理)`、`close()`、`openOutside`)和 `foundKeys()` / `takeKey()`,以及主窗口露面的事件(待定),都只在引擎的页面上、只对主窗口的主框架暴露 |
| 同上「暂时不做」:DS Bot 自己的界面先停下 | `app/ui` 仍然停着;应用只画启动、导入、失败这几页,不画 Bot 界面 |
| 同上「改位置」:总工作区和数据位置各自更换,换总工作区时旧文件夹里的文件不动 | 「位置」一处〔移到…〕:停引擎,同一个卷上改名,不同的卷上数据经暂存复制到新位置、重启后总工作区的文件也后台复制过去(原来不复制),用总工作区的 Bot 和群在下一个回合换段;单独换其中一个在「高级」里;加「从 DeepSeek Harness 复制团队…」、后台复制工作文件的进度、〔停止〕和〔继续复制〕、「用新的空白团队开始…」 |
| 同上「换数据位置」:「旧数据文件夹原样保留,用户确认没问题后自己删」;「换总工作区」:旧文件夹和里面的文件不动 | 搬是搬,只搬应用自己建的文件夹:新引擎 `ready` 之后删掉旧的数据文件夹(和卸载同一张清单),工作文件逐个落位后删原件,只留跳过的;用户自己挑的现成文件夹原样保留,只是团队改用新的;「搬到一半」的记录让没搬完的退回;确认里写明会删什么。空间不再占两份 |
@@ -258,9 +331,17 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
| 同上「卸载不删数据位置」 | 卸载时问一次,默认不删 |
| 同上 更新检查在首次启动的导入之后开始;启动失败时错误框里提新版本 | 随应用启动;首次启动和导入时不弹重启;镜像优先;失败页里直接给更新 |
| 同上 不签名,SmartScreen 是已知限制 | 走签名(路线待定);签名前在下载页说明 |
-| [Bot 运行配置](2026-10-10-bot-runtime.md)「团队的第一个 Main Bot 没有模型,等用户在它的聊天里选好再打招呼」 | 只有一个提供商能用时自动选,并在确认能用后再打招呼;两个以上仍然让用户选 |
+| [Bot 运行配置](2026-10-10-bot-runtime.md)「团队的第一个 Main Bot 没有模型,等用户在它的聊天里选好再打招呼」 | 只有一个提供商能用时自动选,并在确认能用后再打招呼(招呼现在是固定文字,见下面开场白那一行);两个以上仍然让用户选 |
| 同上 已知限制「新 Bot 可能落到没配好密钥的模型上」(「怎么根治待维护者定」) | 按那里写的方向解决:默认只从能用的模型里选(`needsKey` 先过滤,再用检查确认),凭据失败回到设置卡或修复卡。那条限制里「DSH 不告诉插件哪个提供方已经配好了凭据」已经部分过时:DS Bot 现在能标出 `needsKey`,但「有 key」仍不等于「key 能用」 |
| `ds-bot/index.js` 默认 Main Bot「Chief / Chief of Staff」 | 中文界面下建团队时用「总管 / 团队负责人」(待定):看配置里有没有指定名字(`rt.config`,不看已经合并了英文默认值的 `rt.defaults`),没有时按第一次 `state` 请求带来的界面语言的主标签是不是 `zh` 决定;英文不变,已有团队不改 |
+| 本文首稿 §3「标题「正在准备你的 Bot 团队…」,下面三个真实阶段,各带进度勾」 | 没有标题和三站的标记:鲸鱼停在哪一站就是到了哪一步,离开的站留一个圈;阶段名只给读屏(看不见的「启动进度」列表和朗读区);「已用 N 秒」5 秒起在右上方,一直留到「进去吧」 |
+| 同上「只在第一次启动时,等待期间显示一段说明」(五段:产品是什么、下一步接模型、聊天和设置保存在这台电脑上、数据位置的小字、预览版说明的提醒),以及 10 秒「第一次启动会慢一些……」、45 秒「比平时慢……」两句 | 一次一句鲸鱼的话,提示行只说接下来要准备什么:接模型缩成「待会儿要接一个模型:DeepSeek 账号或 API Key」,预览版说明缩成「里面先有一页说明,点「继续」就行」;产品介绍、「聊天和设置保存在这台电脑上」和数据位置的小字去掉(位置在 设置 → 通用 → 位置 里看和改,「社区开源项目,不是 DeepSeek 官方产品」仍是每一屏的底注);10 秒「第一次会慢一点」,45 秒「有点久,可能是杀毒软件在查新文件」加〔打开日志文件夹〕 |
+| 同上 重装时说明的小字「接着用上次的数据:6 个 Bot、2 个群聊(`C:\Users\<用户名>\.ds-bot`)。可以在 设置 → 通用 → 位置 里改。」 | 第 2 站的提示「上次的 6 个 Bot 和 2 个群聊都在」,不写路径 |
+| 同上 180 秒「启动比平常慢很多。可以再等一会儿,或者重试。」 | 鲸鱼问「等太久了,要不要重试?」,卡片上只有〔继续等待〕〔重试〕〔打开日志文件夹〕,不再重复这句话 |
+| 同上「窗口先出来……启动页和引擎的页面共用这个窗口」 | 启动页在单独的启动窗口里([启动窗口](2026-10-26-start-window.md) 第 1 节,待定,那里记过这一行);启动窗口整个启动期间都是 720 × 540,只在交接时改一次大小,长成主窗口的矩形,主窗口在同一个矩形上露面(同上第 8 节):首次启动在就绪后约 1.6 秒可见(原来约 620 ms),以后的启动约 0.6 秒(原来 120 ms) |
+| 本文首稿 §8「以后每次启动也显示启动页,只写「正在打开你的团队…」」 | 另外 10 秒起显示已用秒数,45 秒「比平时慢,请再等一会儿。」〔打开日志文件夹〕,180 秒和首次启动一样([启动窗口](2026-10-26-start-window.md) 第 5 节,那里记过这一行);没有水线、圈和第 3 节鲸鱼的话 |
+| 本文首稿 §5「通过后卡片收成一行……Main Bot 的开场白随即开始」;§6「开场白用界面语言(沿用现有的 kickoff),两句,以一个问题结尾」;[Bot 运行配置](2026-10-10-bot-runtime.md)「等用户在它的聊天里选好再打招呼」,招呼是一次模型调用 | 新团队第一个 Main Bot 的开场白是固定文字,不调用模型(插件在 `llm/stream` 监听里直接回,和 `HANDOFF_ACK` 一样),设置卡收成一行后约 900 ms 是目标卡;之前的余额检查或 8 token 试连照旧,它也挡着第一个正常回合;上手里从建议卡建的 Bot 的招呼也是固定文字,别的 Bot 的招呼照旧由模型写,修复卡里「开场白失败时重新留着」只管这些模型写的招呼 |
+| 本文首稿 §6「试试:」三个固定按钮 | 新团队先是目标卡(四个可以多选的选项、自由输入、〔确定〕)和建议卡,再是第一件事卡;三个固定任务留作〔跳过〕之后的第一件事卡,以及勾掉 Bot 后补满第一件事卡。只选选项不调用模型,写了字才调用一次,整个上手最多 3 次请求;第一件事发出之前 Main Bot 的工具受限,步骤由卡片的回答推进 |
实现各批时,同步改写上面几份文档里对应的规则本身(「已定的行为」写现在的行为,不只是在末尾追加),并在它们的「变更」里写一条;新的 DSH 让步记进 [DSH 让步总账](2026-10-13-dsh-concessions.md),「提供商」记进 [UI 标准](../design/ui-standard.md) 第 11 节的术语表。
@@ -280,6 +361,8 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
10. `settings.launcher` 插槽能直接打开设置的某一节(比如「模型」)。今天可以借一个自己的 `settings.onboarding` 步骤绕一步做到(见第 8 节),有了这个接口就更简单。
11. `runProfile` 报告命名的启动阶段,供壳显示真实进度。
12. pwsh 工具的说明里写明实际是 Windows PowerShell 5.1 还是 PowerShell 7。
+13. 发送前的一个有文档的钩子(或者让 `ComposerBlocks` 能带一张卡片),让插件能在一段只有 Key 的消息进对话记录之前拦下它;今天只能靠观察草稿再挂 block,粘贴和 Enter 同一瞬间时拦不住。
+14. 网页前端(或 Desktop 桥)提供「把授权页交给宿主自己的窗口打开」的方式;今天桌面应用只能接住网页前端 `window.open` 的 `about:blank`,再看它导去哪里。
## 分批上线
@@ -288,9 +371,9 @@ 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 人日 |
+| M2 Main Bot 聊天里的第一条回复 | 设置卡:登录窗口(应用:接住 `about:blank` 并一直隐藏、拦下它的第一次导航、自己建的子窗口和不持久的 partition、关窗清掉 partition、只管主框架的允许名单、权限和下载一律拒绝、回调关窗(不看状态码)、两个窗口同生同灭、`onClosed` 带原因和代理(加载失败时由主进程 `resolveProxy` 取)、主框架加载失败时关窗并报 `failed`、窗口里的 `window.open` 分流、固定的标题和尺寸、交给浏览器时关窗、`openOutside`、日志不记地址;插件:按形态的按钮和文案、打不开时的卡(〔重试〕〔在浏览器里打开〕〔取消〕和系统代理的提示)、交给浏览器之后的卡、`onClosed('user')` 且还在等浏览器时 `cancel`、登录结束时 `close()`、修复卡和鲸鱼菜单那条路也一样)、退回时的回到前台(`dsBotApp.focus()`)、余额和赠送额度、充值后自动重查;现成的 Key 一键用(应用:`foundKeys()` / `takeKey()`,读 DeepSeek Harness 的家(`DSH_HOME` 或 `~\.dsh`)里的 `.credentials.yaml` 和 `.env`,那里设了别的 DeepSeek 地址时不出、设置卡期间读剪贴板(如果定下来)、主进程里比对两处的值;插件:一行一个主按钮、A 改次按钮、来源提示);粘贴 key 时的余额检查(mock 模型提供 `sk-test-ok` / `sk-test-bad` / `sk-test-empty`,另认三把 DeepSeek 格式的 Key:`sk-` 加 32 位十六进制,末四位 `0001` 的能用、`0401` 的报 401、`0000` 的余额为零;`sk-test-*` 不合掩码认 Key 的规则,剪贴板和聊天里粘贴的用例用这三把);聊天里粘贴的 Key(观察草稿、和模型锁合算的一个 block、按状态选文案的卡、〔保存到提供商…〕打开填好 Key 的添加表单、〔填进那张卡〕、〔清掉〕和「改一下」、走输入框自己的 `submit()`);插件 Host 侧的「能用」检查和自动选模型;「已接上 · 更换」;输入框锁定;工作文件夹行;中文默认名字(如果定下来)。上手的后半段:固定的开场白(`llm/stream` 监听里直接回);目标卡(多选、〔确定〕、自由输入、〔跳过〕给三个固定任务)和合并;一次不带工具的 JSON 调用(固定提示词、带 `goal` 的闭合 schema、`maxTokens` 700、12 秒超时);目标卡输入框里的 Key;建议卡(勾选、改名、〔只要…〕、〔换一组建议〕和 3 次的上限、「模型请求 n/3」)、建 Bot(固定的招呼)、第一件事卡和上手结束的灰字;深度限制(Host 里的步骤表、`tools.restrict({ allow })` 只留 `ask_user` 和草稿模式的 `create_bot`、第一件事发出时解除、`tools.guard` 限次数、每一步的 token 和时限、兜底卡);上手结束从会话里读、中途重开从目标卡重新开始。CI:loopback 上的假 DeepSeek 平台(DSH 的 `platformOrigin` 和 `allowLoopbackHttp`)驱动登录窗口,一次性用户的假 DSH 家和剪贴板替身;mock 模型跑上手的八种情况(正常、断网、来回循环、答非所问、编造模型名、401、余额为零、把 Key 粘进目标卡的输入框) | 约 13 人日(原来 8:目标卡、合并和 JSON 调用约 2,建议卡、建 Bot 和第一件事卡约 1.5,深度限制和兜底卡约 1,mock 模型的八种情况约 0.5) |
| M3 国内能下、一键安装、卸载说清楚 | 镜像发布和镜像优先的更新(随应用启动、首次启动和导入时不弹重启、可取消的下载、60 秒无数据换源、百分比);一键安装;卸载时的问题、`locations.ini`、标记文件;CI:一键升级覆盖旧的自定义目录、交互式卸载(UI Automation 答「否」和「是」)、固定链接检查;README 换成固定下载链接,加「卸载和重置」 | 约 5 人日 |
-| M4 窗口先出来:启动页、卡片和恢复页 | 启动页、它的 IPC 和来源检查、中英文案;`main.mjs` 重排;位置检查、推荐盘、一个位置的布局和确认、重装不问;失败页和 180 秒提示;日志;`dsBotApp.ready()` 和 20 秒界面检查;#559。CI:打包后的首次启动,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户,经 CDP 驱动启动页,并检查日志里没有 key、token 和用户名 | 约 7 人日 |
+| M4 窗口先出来:启动页、卡片和恢复页 | 启动页(鲸鱼即进度:三站的位置和圈、一次一句鲸鱼的话和它的节奏、提示行、5 秒起的已用秒数、读屏的「启动进度」列表、卡片的第一句)、鲸鱼更有反应的八种动作(探身、呼吸、眨眼、回到窗口时看你、眼睛跟着键盘焦点、按下预备、活泼档越跳越稀、潜得更深)、它的 IPC 和来源检查、中英文案;`main.mjs` 重排;交接时启动窗口长成主窗口(主窗口先隐藏着建在最终的矩形上,主进程约 300 ms 里逐步 `setBounds`,主窗口在同一个矩形上露面,首次启动 2.5 秒的兜底)和侧栏磁贴上的鲸鱼(浮上来一次,设置卡驱动它的状态动作,第 5 节);位置检查、推荐盘、一个位置的布局和确认、重装不问;失败页和 180 秒的问题;日志;`dsBotApp.ready()` 和 20 秒界面检查;#559。CI:打包后的首次启动,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户,经 CDP 驱动启动页,逐个状态检查中英文在 720 × 540 和 720 × 500 下没有折行和截断,量交接的时间和中间尺寸,并检查日志里没有 key、token 和用户名 | 约 10 人日(原来 7:鲸鱼即进度的布局、话的节奏和读屏约 1,交接时窗口长大和兜底计时约 1,八种动作和磁贴上的鲸鱼约 1) |
| 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 人日,加外部审批 |
@@ -298,30 +381,36 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
## 验收
- 打包后的 Windows CI,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户:进程启动后 2 秒内窗口可见(目标 1 秒,CI 留余量);引擎的页面之前不出现任何卡片;能进到引擎的页面。
+- 启动页(同一个 CI,中英文各一遍):首次启动没有标题、三站的标记和说明段落;鲸鱼的话按第 3 节的顺序出现,每句至少能读 300 ms 才被换掉,跳过的不补;提示行只在第 2、3 站有字(例外是盘不够时前 10 秒的「C 盘只剩 1.2 GB」和 45 秒的〔打开日志文件夹〕);「已用 N 秒」5 秒起出现;在 720 × 540 和 720 × 500 下没有一行字折行或被省略号截断,页面不能滚动;读屏的「启动进度」列表和朗读区照旧报阶段。
+- 交接:首次启动 `handoffShow` 在鲸鱼停到第 3 站后 1.3 秒内(原型实测 1.09 到 1.17 秒);启动窗口在约 300 ms 里至少经过一个中间尺寸,长到主窗口的矩形;主窗口在鲸鱼停到第 3 站后 2 秒内可见,矩形和启动窗口长成的一样(`ready()` 到达时鲸鱼还在游的,这两个时间最多各晚 600 ms);页面不发 `handoffShow` 时,主进程在 `ready()` 后 2.5 秒自己显示主窗口(以后的启动 0.8 秒,重试或重新开始后庆祝的那次也是 2.5 秒);减少动态效果时窗口不长大,`handoffShow` 时主窗口直接出现。
- 首次启动期间没有一个 `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 时也没有,说明里写「接着用上次的数据」,进去就是原来的团队。
+- 有 `~/.ds-bot` 团队、没有 `locations.json` 的一次性用户:没有卡片,C 盘不到 5 GB 时也没有,第 2 站的提示行写「上次的 N 个 Bot 和 N 个群聊都在」(数字是那个团队的),进去就是原来的团队。
- 导入:点〔复制过来〕后,对话复制完团队就打开,`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 秒。
+- mock 模型粘贴 `sk-test-ok`:第一个 Main Bot 的 Session 里没有失败节点,引擎的页面出来后 30 秒内收到开场白,mock 模型没有收到开场白的请求(只有余额检查),随后出现目标卡;CI 上从双击安装包到目标卡不超过 90 秒。
+- 上手(mock 模型):只选选项按〔确定〕时 mock 没有收到请求,卡上是「模型请求 0/3」;输入框里有字时正好一次;合并后的建议按第 6 节的规则排(卡上的顺序、轮流取、同名只留一个、最多 5 个 Bot、最多 3 个第一件事),和点选项的先后无关;〔换一组建议〕到 3/3 后变灰,写「已到上限」;〔跳过〕给出三个固定任务;〔建…〕后侧栏里正好多出勾选的那几个 Bot,用的是改过的名字,每个的聊天里是固定的招呼,mock 收到的请求数不变;第一件事发出之前,Main Bot 会话的工具只有 `ask_user` 和草稿模式的 `create_bot`,第一件事那一回合已经是原来的工具;目标卡输入框里整段是末四位 `0001` 的那把 DeepSeek 格式 Key 时按〔确定〕,mock 没有收到请求,卡下面是 Key 的卡;Main Bot 的会话里有那行灰字或用户的消息时重开应用,不再出目标卡,都没有时从目标卡重新开始;第 6 节列的八种情况都走到一张能用的卡,每张卡都有「跳过设置,直接开始」。
- `sk-test-bad` 不会被保存(`credentials.describe` 仍是未配置),卡片显示 401 的文字,Session 里没有回合。`sk-test-empty` 会保存,但 `/user/balance` 报出余额之前不跑开场白,卡片显示「去充值」。
+- 登录窗口(CI 用 loopback 上的假 DeepSeek 平台:DSH 的 `platformOrigin` 指向它,`allowLoopbackHttp`):点〔登录 DeepSeek 账号〕后 1 秒内出现主窗口的子窗口,地址是假平台的授权页,标题是「登录 DeepSeek 账号」;它的 partition 不是主窗口的、不持久,关窗后 `deepseek-login` 里没有 Cookie,主窗口的 session 里也没有假平台的 Cookie;假平台跳回 `/oauth/callback` 后窗口 1 秒内关掉、主窗口有焦点、卡片收成「已接上」;回调请求发出、回应还没回来时用 × 关掉窗口,引擎里这次登录仍是 succeeded,卡片收成「已接上」;回调之前用 × 关掉窗口,卡片回到两种方式、引擎里这次登录是 cancelled;授权过期或在卡片上点〔取消〕时,窗口 1 秒内跟着关掉;窗口开着时点鲸鱼菜单的「登录 DeepSeek 账号」,出现 DSH 的登录框(等待中),登录窗口还是原来那个,这次登录仍在等待;在那个登录框里点〔取消〕,窗口 1 秒内关掉,这次登录是 cancelled,卡片回到两种方式;在窗口里点一个别的域名的新窗口链接,链接交给系统浏览器(替身记录)、窗口还在;主框架被导到别的域名时,窗口关掉、授权链接交给系统浏览器、这次登录仍在等待,设置卡写「已在浏览器打开 DeepSeek 登录页。…」,在替身浏览器里走完回调后卡片收成「已接上」、主窗口回到前台;点「在浏览器里打开」后登录窗口关掉、这次登录不是 cancelled;授权页加载失败时窗口关掉、这次登录没有被取消、卡片有〔在浏览器里打开〕和〔取消〕,点〔取消〕后引擎里这次登录是 cancelled、卡片回到两种方式;授权页里的一个 iframe 打不开时窗口还在;假平台让换取失败时窗口关掉,卡片显示登录没有完成,不回到两种方式;登录窗口里的页面请求麦克风、通知或下载文件时,都被拒绝或取消,系统不弹任何框;从修复卡的〔重新登录〕或鲸鱼菜单的「登录 DeepSeek 账号」开始、回调之前用 × 关掉窗口,引擎里这次登录是 cancelled,不等它过期;替身让 `resolveProxy` 对授权链接给出 `PROXY 127.0.0.1:7890`、授权页又打不开时,卡上多一句「登录页走的是系统代理 127.0.0.1:7890:如果代理软件没开,打开它。」,不提「跟随系统代理」;`main.log` 里没有授权链接,也没有回调地址里 `code` 和 `state` 的值。
+- 现成的 Key:一次性用户的 DSH 家(`~\.dsh`)的 `.credentials.yaml` 里放 `sk-test-ok`、没有团队:设置卡最上面是「DeepSeek Harness 里有一个 Key:sk-test-…」〔用这个 Key〕,〔登录 DeepSeek 账号〕是次按钮;点了之后 `credentials.describe` 是已配置、`~\.dsh` 里的文件没变、日志和页面的 DOM 里没有整段 Key;放 `sk-test-bad` 时这一行在,点了显示 401、不保存,这一行消失,切到别的 Bot 再回来也不再出现;那个家的 `.env` 里有 `DEEPSEEK_BASE_URL` 时没有这一行。剪贴板替身放末四位 `0001` 的那把 DeepSeek 格式 Key 再把窗口切回前台:出现「剪贴板里有一个 Key:sk-…」,后面是它的前八位;放 `sk-test-ok`(不合格式)或别家格式的 `sk-` Key 时不出现;清掉再切回:这一行消失;两处放不同的 Key 时只有一行,是剪贴板的,小字里是 DeepSeek Harness 的;放相同的 Key 时只有一行,是 DeepSeek Harness 的;点〔用这个 Key〕之前把替身换成别的内容,不检查、不保存;设置卡不在时(已接上)替身的读取计数是 0。
+- 聊天里粘贴的 Key(mock 模型):接上模型、上手结束后(或点了「跳过设置,直接开始」),在 Main Bot 的聊天框粘贴末四位 `0001` 的那把 DeepSeek 格式 Key:没有新的回合,输入框是 block 状态、不能编辑,卡片出现,主按钮是〔检查并换上〕(已经有 Key);点了之后草稿为空、Key 已配置、Session 记录里没有这段文字;换成〔当普通消息发送〕后 Session 里正好一条用户消息,带着的附件一起发出;换成〔清掉〕后草稿为空、Key 没变、Session 里没有新消息;点「改一下」后输入框可以编辑、草稿还在、不再出现卡片,改过草稿再粘回同一把 Key,卡片重新出现;粘贴末四位 `0401` 的那把,点主按钮后卡上是 401、主按钮是〔清掉〕;粘贴 `sk-` 加 30 个字母数字(含数字、不是十六进制)时主按钮是〔保存到提供商…〕;「我的 key 是」后面跟同一把 Key 这样夹在句子里的不拦,单独粘贴 `sk-test-ok`(不合格式)也不拦;撤掉 Key 的 block 时还没有能用的模型,输入框回到「先在上面接上模型,我就能回复你」的锁,不是可用。粘贴末四位 `0000` 的那把,点〔检查并换上〕后 Key 换成了这一把、草稿为空、Key 的 block 撤掉,卡片留着,写「Key 已保存,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔知道了〕,没有〔再查一次余额〕〔换一种方式〕;先发「要密钥」让 Bot 出一张 `request_secret` 卡,再粘贴末四位 `0001` 的那把,主按钮是〔填进那张卡〕,点了之后草稿为空、Key 在那张卡的输入框里,`credentials.describe` 没变。
- 插件 Host 的单元测试(替身 `deepseekAccount`):未登录和零余额的账号不会产生开场白回合;有余额的会在自动选模型后产生;`getBalance` 失败时照常往下走。
-- 中文界面下,把启动页、设置卡、修复卡的每种状态和卸载提示都渲染一遍,除允许名单外找不到英文单词。
-- 没有能用的模型且模型列表已知时,Bot 聊天的输入框不可用;绕过输入框发出的消息在接上模型后会得到回答,开场白不丢。
+- 中文界面下,把启动页、设置卡、目标卡、建议卡、第一件事卡、聊天里粘贴 Key 的卡、修复卡的每种状态和卸载提示都渲染一遍,除允许名单外找不到英文单词。
+- 没有能用的模型且模型列表已知时,Bot 聊天的输入框不可用;绕过输入框发出的消息在接上模型后会得到回答,开场白不丢,之后不出目标卡。
- 「重试」不会在 Session 记录里多出一份用户的话。
- Bot 聊天里每种失败代码都显示插件的修复卡,至少一个按钮;原文只在「技术详情」里,AUTH 的原文从不显示。
- 从卡片发起登录后,无论成功、取消、过期还是失败,切到经典 Agent 模式都不会冒出 DSH 的登录框。
- 全新的应用 profile 上,DSH 的「开始使用」凭据框不会自动出现,页面里 `__DSH_MODELS_ONBOARDING__.credentialOnboarding` 是 `false`。
- 「高级设置」里的模型入口打开的是 DSH 设置的「模型」页;DS Bot 自己注册的那个 `settings.onboarding` 步骤在自动检查时立刻完成,不挡住 DSH 自己的步骤。
- 引擎失败后 1 秒内出现失败页,每种都有五个按钮,窗口不隐藏。禁用 ds-bot 的测试 profile 在 25 秒内显示「团队界面没有加载出来」。
-- `main.log` 和复制出来的详细信息里没有 `sk-test-*`、`token=` 的值和用户文件夹的路径。
+- `main.log` 和复制出来的详细信息里没有 `sk-test-*`、mock 的三把 DeepSeek 格式 Key、`token=` 的值和用户文件夹的路径。
- 导入:PID 活着但锁超过 60 秒没刷新,不算占用;失败或停止后没有 `.import-*` 文件夹;`room.id` 的 Session 被复制;存着用户 key 的 `.credentials.yaml` 不被覆盖,只有引擎写的 `client-connection/` 记录的会换成旧的;导入写模型设置时,数据位置里 `profiles/ds-bot/cordis.patch.yml` 的其他行(如 `ui-settings-general`)保留,应用自己的补丁里没有这一行。
- 卸载:`/S` 和更新时什么都不删;交互卸载显示问题,「否」全部保留,「是」删掉带标记的文件夹和 `%APPDATA%\DeepSeek Bot`,没标记的只删自己的条目,从不删磁盘根目录,总工作区永远保留。
- 更新:镜像挂了一次检查内就换到 GitHub;60 秒没有收到数据的下载会取消并换源;关于页显示百分比。
- 发版:「标为 Latest」是最后一步,依赖 GitHub 上传、镜像和下载表;链接检查访问两个固定地址(200 或 302)。
- README.md 和 README.zh.md 前 10 行有 Windows 下载链接(有镜像后镜像在前)和「不是官方产品」,两份同步。
-- README 和卡片里「一轮多少钱」来自 PR 里记录的实测(默认模型上三次开场白)。
+- README 和卡片里「一轮多少钱」来自 PR 里记录的实测(默认模型上三次第一件事的回合)。
- `npm test`、`node scripts/build-client.mjs --check`、`npm run lint` 和冒烟测试通过;`dev/smoke.mjs`、`app/scripts/check-packed.mjs` 和它们覆盖的行为在同一个 PR 里改。
## 待定
@@ -332,16 +421,27 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
| 国内镜像放在哪里? | CNB(cnb.cool)镜像仓库的 Release(免费,腾讯运营;限制未验证);腾讯云 COS 默认域名(下载不需要备案;约 ¥0.5/GB,按现在的量每月约 ¥100–450;要实名账号);npmmirror 的 binary-mirror-config(免费,晚几小时同步,要对方维护者同意);Gitee Release(附件大小限制,约 212 MB 的安装包很可能放不下) | 先从大陆网络试测 CNB(固定的 latest 地址、300 MB 以上文件、不用登录、支持断点续传)。通过就用 CNB,否则用 COS。GitHub 永远是第二个链接和第二个更新源 |
| 中文界面里第一个 Main Bot 叫什么? | 「总管」,角色「团队负责人」;保留「Chief」,角色「团队总管」;「总管家」,角色「团队负责人」 | 「总管」,角色「团队负责人」,按建团队时的界面语言决定;英文不变,配置优先,已有团队不改,测试和 README 同一个 PR 里改 |
| 安装包要不要改成一键安装? | 一键、只装给当前用户、装完打开、没有目录页(`/D=` 自定义);保留向导,但去掉目录页、默认勾选「运行」 | 一键安装。少两次点击(「安装」「完成」),也去掉了最技术化的一页 |
-| 插件形态(DSH Desktop、DSH Web)里,第一个 Main Bot 也自动选模型并打招呼吗? | 所有形态都这样(只有一个提供商能用且检查通过时);只在桌面应用这样,插件形态仍然「先选再打招呼」 | 所有形态。开场白本来就是用户选完模型后会触发的一次调用;检查优先用不调用模型的余额查询;「已接上 · 更换」让选择看得见、改得了 |
+| 插件形态(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 条) |
+| 设置卡要不要看剪贴板? | 看,只在设置卡显示期间、只比对格式;不看,只认 DeepSeek Harness 里的 Key | 看:从开放平台复制了 Key 回来的人少一次粘贴。读的时机和范围写死,值不记录,用户点〔用这个 Key〕之前不交给页面,卡上只有前八位 |
+| 桌面应用里〔去充值 ↗〕在哪里打开? | 系统浏览器,没在浏览器里登录过开放平台的要再登录一次;应用的子窗口,和登录窗口共用 `deepseek-login` partition,到设置卡收起或应用退出才清掉(`dsBotApp.signIn` 要多一个方法;付款页走出 DeepSeek 域名时仍会被送去系统浏览器) | 先用系统浏览器:付款页不放进应用的窗口,平台的登录状态也不多留;多出的一次登录记进「已知限制」 |
+| 目标卡合并后最多 5 个 Bot(第 6 节),要不要改成每组最多 2 个、最多 4 个? | 不改:每组轮流取,最多 5 个(有一组是 3 个时,两个目标就占满 5 个);改成每组最多 2 个、最多 4 个 | 改成每组最多 2 个、最多 4 个:两个目标不会一下占满,四个目标也是每个先有一个 Bot |
+| 合并后的第一件事(第 6 节:按 Bot 的顺序取每个 Bot 自己的任务,最多 3 个),要不要改成轮流取? | 不改(每组第一个 Bot 都有两个任务,三个总是来自前两个目标,两个来自第一个,三个以上目标时后面的没有);三个以上目标时任务也轮流取 | 改成三个以上目标时轮流取,每个目标先取一件,前三个目标各有一件 |
+| 只有一个目标时摘要怎么写? | 每个目标一个词:「想先写代码:…」「想先查资料:…」(第 6 节现在的写法);用选项的原文:「想先写代码、改程序:…」 | 一个词:几个目标要用「、」连起来,选项原文里的「、」会让两个目标读起来像三个;单个和几个目标写法一样 |
+| 首次启动还要那条 1 px 的水线吗? | 保留;去掉,只留鲸鱼和圈 | 保留:圈和三站的位置要有一个水面才站得住 |
+| 启动页超出原型规格里 45 KB 的预算怎么办?(原型实测:五个文件的源码 113 KB,压缩后 79 KB,gzip 约 35 KB;`text.mjs` 带中英两种语言) | 放宽预算;`text.mjs` 按语言拆开,只加载界面语言的那一份;打包时压缩 | 先按语言拆 `text.mjs`、打包时压缩,在 M4 实测启动页的第一帧;第一帧不晚就放宽预算:页面是本地文件,不走网络(同 [启动窗口](2026-10-26-start-window.md) 的「待定」) |
## 不做什么
-- 不在应用里另做一套配置模型的欢迎向导:模型只在 Main Bot 的设置卡和 DS Bot 设置 → 模型里配。
+- 不在应用里另做一套配置模型的欢迎向导:模型只在 Main Bot 的设置卡和 DS Bot 设置 → 模型里配。目标卡、建议卡和第一件事卡也是插件在 Main Bot 聊天里画的卡,不是应用的向导。
+- 上手期间不让模型选下一步,也不让它自己一轮轮地调用工具:步骤表在代码里,由卡片的回答推进,Main Bot 的工具受限到第一件事发出(第 6 节)。只选了目标卡的选项时不调用模型。
+- 鲸鱼的话从不是一段话:一次一句,一行放得下;启动页上不放说明段落,也不轮播提示。
+- 不在设置卡显示期间之外读剪贴板;剪贴板和 DeepSeek Harness 里的 Key 都不自动保存:一定是用户点了按钮,再按「粘贴 key」的规则检查和保存。
+- 设置卡的现成 Key 只认 Key,不单独搬 DeepSeek Harness 里的账号登录(grant 记录归 DSH 的账号模块,应用不去写):没导入团队、或者答了〔先不复制〕、在 DeepSeek Harness 里用账号登录过的人,在登录窗口里再登录一次。导入团队时 `.credentials.yaml` 整个复制(目标里已有用户自己的 key 或登录时除外),账号登录跟着过来,不用再登录。
- 不伪装 `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`,见「已知限制」),不再新增。
- 不在每次启动时扫盘:固定盘只在盘不够或默认位置不能用时枚举一次;读卡器、U 盘、移动硬盘、网络盘和光驱一概不碰,也从不推荐它们。
@@ -355,10 +455,20 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 设置卡调用的是 `settings.models.sign-in` 条目注入的操作。它们有类型声明,但 DSH 没有写成给插件用的接口,rc 版本之间可能变化。缺了哪个就退回到今天的 `DeepSeekSignIn`;每次升级锁定的 DSH 都要重测(另见「需要 DSH 提供的」第 4 条)。
- `credentialOnboarding` 那一行的 id 如果在 DSH 里改了名,补丁只会留下一条警告、悄悄失效;靠验收里对 `__DSH_MODELS_ONBOARDING__` 的检查发现。
- `GET /user/balance` 不在聊天 API 里,是否计费没有文档;它证明的是 key 和余额,不是模型能不能用。除了 401 以外的失败都不拦人,第一轮的修复卡兜底。
-- 自动选模型会在用户没有明确点选的情况下发出开场白(几 token 的付费调用);没有不调用模型的检查的提供商还要多一次 8 token 的试连。
+- 自动选模型时,没有不调用模型的检查的提供商要多一次 8 token 的试连。
+- 开场白是固定文字,不再花钱,但也说不出任何只有模型才知道的东西。
+- 上手里模型的那一步比卡片慢:真实的网络往返,最坏 12 秒才出兜底卡(8 秒内来了第一个字、之后停住的);它先花钱(只在用户写了字或要换一组时),才见效果;措辞每次不一样,CI 只能测结构。
+- 合并后的第一件事偏向前两个目标:三个以上目标时,后面的目标没有第一件事;勾掉前面的 Bot 时,用三个固定任务补满,不用后面 Bot 的任务(怎么分见「待定」)。
+- 首次启动主窗口在就绪后约 1.6 秒才露面(原来约 620 ms),以后的启动约 0.6 秒(原来 120 ms):多出来的主要是等纸面空下来再长大的约 460 ms,首次启动还有「进去吧」先停的 300 ms。
- Bot 聊天里余额不足时,DSH 自己的余额提示(不分 Session)会和修复卡同时出现。
- 中文默认名字看的是第一次请求时的界面语言;DSH 存的语言偏好还没加载完时,它可能还是浏览器的语言,所以浏览器是英文、DSH 设成中文时,新团队仍可能叫 Chief。桌面应用里全新的数据位置以系统界面语言为准。
-- Windows 的前台规则可能不让窗口在登录后回到前台,这时只能靠任务栏闪烁和卡片自己的「已登录」状态。
+- 退回系统浏览器登录时,Windows 的前台规则可能不让窗口在登录后回到前台,这时只能靠任务栏闪烁和卡片自己的「已登录」状态。
+- 登录窗口靠的是 DSH 网页前端「先开 `about:blank` 再导到授权页」的做法,不是接口;DSH 改了做法就退回系统浏览器(另见「需要 DSH 提供的」第 14 条)。登录页里主框架走出 DeepSeek 域名的流程(比如第三方登录)会换到系统浏览器从授权页重新开始,登录窗口里填到一半的东西不带过去。
+- 登录窗口不留 DeepSeek 平台的登录状态,〔去充值 ↗〕(余额为零的卡、ACCOUNT_QUOTA 的修复卡)仍在系统浏览器里打开开放平台:没在浏览器里登录过开放平台的人(比如刚在登录窗口里用手机号注册的新账号)要在那里再登录一次。以前在浏览器里登录时没有这一步(要不要改见「待定」)。
+- 修复卡和鲸鱼菜单走 DSH 自己的登录框,登录窗口开着时它仍写着在浏览器里继续:这是 DSH 的文案,不改它的界面。在那个登录框里点〔取消〕或 ×,会取消这次登录,登录窗口也跟着关掉。
+- 剪贴板只在设置卡显示期间读,但读的时候没有提示;卡上那一行的前八位就是读过的证据。
+- 聊天里只有 Key 的草稿靠观察草稿再挂 block,粘贴和 Enter 同一瞬间(脚本、自动化)可能抢在 block 之前发出去;句子里夹着的 Key 不拦,DSH 的掩码只改显示。
+- 聊天里只有 Key 的草稿在清掉之前一直存在浏览器的 localStorage 里,这是 DSH 存草稿的做法;401 或用户不理卡片时,Key 会跟着草稿留到下次启动。插件只在保存、〔填进那张卡〕或〔清掉〕时用 `setDraft('')` 清掉它;〔当普通消息发送〕时由 DSH 发出后清掉;插件不替用户删草稿。
- 签名之前,开着智能应用控制的 Windows 11 装不了未签名的安装包,只能先走 DSH Desktop 插件这条路。签名主体如果是 SignPath Foundation,发布者会显示它的名字。
- 一键安装去掉了选程序目录(估计约 600–700 MB 在 C 盘,实测后写进 README),只剩 `/D=`。
- electron-builder 自带的几条 NSIS 报错(卸载旧版失败、解压失败)只有英文。
@@ -377,3 +487,5 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 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、提供商名和用户起的名字。
+- 2026-10-27:接模型的三条改进写进 §5 和 M2:桌面应用里登录页在应用自己的登录窗口里打开,不离开应用,打不开时才退回系统浏览器;现成的 Key(DeepSeek Harness 的凭据、设置卡期间的剪贴板)一键用,照样先检查再保存;聊天里整段是 Key 的草稿拦下来,问保存还是发送。`dsBotApp` 加 `signIn` 和 `foundKeys()` / `takeKey()`;「需要 DSH 提供的」加第 13、14 条;剪贴板是否保留、〔去充值 ↗〕在哪里打开列入待定。评审后补正:DSH 开的空白弹窗改不了 partition,登录窗口由应用另建、两者同生同灭;允许名单只管主框架,授权页来源从第一次导航取;回调不看状态码,`onClosed` 带原因,回调发出后关窗不算取消;代理提示不提引擎的开关;环境变量的 Key 是「来源 env」不是「不可写」;mock 加三把 DeepSeek 格式的 Key;现成 Key 一行一个主按钮、两处合并、`takeKey` 核对前八位;聊天卡按状态选文案,加〔清掉〕和「改一下」,和模型锁合算一个 block,发送走输入框自己的 `submit()`;草稿存在 localStorage、充值页要再登录记进已知限制。第二轮补正:登录窗口的 session 只放行主框架的回调,不照抄 Bot 浏览器拦引擎的规则;新窗口等旧 partition 清完再开;`onClosed` 带代理,打不开的卡有〔取消〕;登录中点鲸鱼菜单或修复卡只打开 DSH 的登录框;窗口里新开的链接一律去系统浏览器;被拒的现成 Key 不再推荐;聊天卡写明检查没通过时的按钮、余额为零的〔知道了〕和 `request_secret` 卡的按钮;「放过」在 DSH 清空草稿时仍在。
+- 2026-10-28:维护者 2026-10-27 的反馈写进 §3 到 §6、§8 和 M2、M4,分三部分。一是「鲸鱼即进度」的启动页:小窗口显示的是实现的结构(一条带三个点的线和几段说明),不是用户感受到的东西;现在鲸鱼停在哪一站就是到了哪一步,一次一句鲸鱼的话,提示行只说接下来要准备什么,5 秒起显示已用秒数,卡片的第一句也由鲸鱼说,重装的小字改成提示,180 秒改成鲸鱼的问题,交接时启动窗口长成主窗口。二是目标卡可以多选,按〔确定〕提交,几个目标按卡上的顺序合并成一份建议。三是上手后半段的 AI-native 方案:开场白改成固定文字、不调用模型,然后是目标卡、建议卡和第一件事卡,只在用户写了字或要换一组时调用模型,整个上手最多 3 次请求,深度限制写成机制(步骤表在代码里、工具受限、每一步一次请求和时限、模型关着也能走通的卡、mock 模型的 CI);「试试:」的三个固定任务留作〔跳过〕的路和补位。依据:启动窗口和团队窗口的原型及其检查(`handoffShow` 在就绪后 1.09 到 1.17 秒,窗口 300 ms 长大,目标卡和合并的用例)和 2026-10-27 给维护者的 AI-native 评估。合并的上限、第一件事的分法、单个目标的摘要、水线和启动页的大小列入「待定」。评审后补正:第一件事一发出就解除工具限制,它是不受上手限制的正常回合,灰字仍在它回复以后;建议卡建的 Bot 的招呼也是固定文字,整个上手确实最多 3 次请求;JSON 调用只有一组时限(8 秒第一个字、12 秒回完),整轮 20 秒只管上手期间 Main Bot 会话里的回合,兜底最坏 12 秒;schema 带 `goal` 和任务的草案序号,合并按 `goal` 走,模型的摘要只在用户的话太长时用;〔换一组建议〕由模型换一组不重复的;目标卡输入框里整段是 Key 时不发给模型;上手结束从会话里读(灰字或用户自己的消息),中途重开从目标卡重新开始,「取舍」写明这一点;一个会话的 block 按模型锁、上手锁、Key 排,上手锁有自己的占位,开场白不再说「直接说就行」;接上模型前发出的消息算 Main Bot 的第一个正常回合,不再出目标卡;修复卡的「重新留着」只管模型写的招呼;合并的上限和分法按已定的写,「待定」改成要不要改;「一轮多少钱」改用第一件事的回合实测;第 5 节写明侧栏磁贴上的鲸鱼,开场白和目标卡的时间从设置卡收起时算;以后的启动照 [启动窗口](2026-10-26-start-window.md) 第 5 节写,记进「改动的已定设计」;交接的验收从鲸鱼停到第 3 站算;`askSteward` 只是形态相同,上限是这次调用自己的;「水圈」统一叫「圈」,「三站」改成「三站的标记」;导入的检查行去掉破折号;45 KB 那条待定照启动窗口稿写;M4 加八种动作和磁贴上的鲸鱼,估计改成 10 人日。复核后补正:问候里的名字、`dsBotApp` 的露面事件(待定)和以后的启动庆祝那次的 2.5 秒兜底与启动窗口稿对齐;交接验收的 1.2 秒放宽到 1.3 秒,给 CI 留余量。