A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
Merge dev into feat/windows-onboarding-m5-01-ring
AdamPlatin1231503c0875462
diff --cc app/src/start/text.mjsindex 7a06582c,6b63ca34..d3d15f2d--- a/app/src/start/text.mjs+++ b/app/src/start/text.mjs@@@ -23,11 -23,20 +23,11 @@@export const TEXT = {zh: {// voice- 'voice.hello': '嗨,我是总管',- 'voice.helloName': '嗨,我是{name}',- 'voice.helloBack': '嗨,我来了',- 'voice.data': '先找个地方放东西',- 'voice.found': '找到了',- 'voice.engine': '热身中,等我一下',- 'voice.slow10': '第一次会慢一点','voice.slow45': '有点久,可能是杀毒软件在查新文件',- 'voice.team': '开门去了',- 'voice.ready': '进去吧',+ 'voice.slowLater': '比平时慢,请再等一会儿','voice.watchdog': '等太久了,要不要重试?',- 'voice.moving': '正在搬 DeepSeek Bot 的数据…',- 'voice.failed': 'DeepSeek Bot 没能启动',- 'voice.opening': '正在打开你的团队…',+ 'voice.moving': '正在搬 DS Bot 的数据…',+ 'voice.failed': 'DS Bot 没能启动','voice.viewFailed': '团队界面没有加载出来',// say'say.space': '{drive} 盘有点挤',@@@ -141,9 -154,10 +141,9 @@@'status.state.failed': '没有完成','status.sr.active': '{phase}:进行中','status.sr.done': '{phase}:已完成',- 'status.elapsed': '已用 {n} 秒',// dialog- 'dialog.pickRoot': '选择 DeepSeek Bot 放数据的位置',- 'dialog.pickMove': '选择 DeepSeek Bot 数据的新文件夹',+ 'dialog.pickRoot': '选择 DS Bot 放数据的位置',+ 'dialog.pickMove': '选择 DS Bot 数据的新文件夹','dialog.move.inDsh': '请选择 DeepSeek Harness 数据({home})以外的文件夹。','dialog.move.inProgram': '请选择程序文件夹以外的位置:卸载时会删掉程序文件夹。','dialog.move.drive': '请选择一个文件夹,不要选整个磁盘。',@@@ -169,11 -183,20 +169,11 @@@},en: {// voice- 'voice.hello': 'Hi, I’m Chief',- 'voice.helloName': 'Hi, I’m {name}',- 'voice.helloBack': 'Hi, I’m here',- 'voice.data': 'First, a place for my things',- 'voice.found': 'Found one',- 'voice.engine': 'Warming up, one moment',- 'voice.slow10': 'The first time takes a bit longer','voice.slow45': 'Taking a while: antivirus may be checking new files',- 'voice.team': 'Off to open the door',- 'voice.ready': 'Come on in',+ 'voice.slowLater': 'Slower than usual; please wait a little longer','voice.watchdog': 'This is taking too long. Try again?',- 'voice.moving': 'Moving DeepSeek Bot’s data…',- 'voice.failed': 'DeepSeek Bot couldn’t start',- 'voice.opening': 'Opening your team…',+ 'voice.moving': 'Moving DS Bot’s data…',+ 'voice.failed': 'DS Bot couldn’t start','voice.viewFailed': 'The team view didn’t load',// say'say.space': 'Drive {drive} is a bit full',@@@ -287,9 -314,10 +287,9 @@@'status.state.failed': 'Not finished','status.sr.active': '{phase}: in progress','status.sr.done': '{phase}: done',- 'status.elapsed': '{n} s so far',// dialog- 'dialog.pickRoot': 'Choose where DeepSeek Bot keeps its data',- 'dialog.pickMove': 'Choose a new folder for DeepSeek Bot’s data',+ 'dialog.pickRoot': 'Choose where DS Bot keeps its data',+ 'dialog.pickMove': 'Choose a new folder for DS Bot’s data','dialog.move.inDsh': 'Choose a folder outside the DeepSeek Harness data ({home}).','dialog.move.inProgram': 'Choose a place outside the program folder: uninstalling removes the program folder.','dialog.move.drive': 'Choose a folder, not a whole drive.',diff --cc app/test/start-page.test.mjsindex 9f2433d3,3c816df8..f8733f86--- a/app/test/start-page.test.mjs+++ b/app/test/start-page.test.mjs@@@ -246,10 -203,10 +246,10 @@@ test('t fills placeholders and falls ba})test('t picks the English singular or plural by the value', () => {- assert.equal(t('en', 'dialog.import.found', { bots: 1, groups: 6 }), 'DeepSeek Harness has 1 Bot and 6 group chats. Copy them into DeepSeek Bot?')- assert.equal(t('en', 'dialog.import.found', { bots: 6, groups: 1 }), 'DeepSeek Harness has 6 Bots and 1 group chat. Copy them into DeepSeek Bot?')- assert.equal(t('zh', 'dialog.import.found', { bots: 6, groups: 1 }), 'DeepSeek Harness 里有 6 个 Bot 和 1 个群聊。要复制到 DeepSeek Bot 吗?')- assert.equal(t('en', 'dialog.import.found', { bots: 1 }), 'DeepSeek Harness has 1 Bot and {groups|group chat|group chats}. Copy them into DeepSeek Bot?')- assert.equal(t('en', 'hint.reinstall', { bots: 1, groups: 6 }), 'Your 1 Bot and 6 group chats are still here')- assert.equal(t('en', 'hint.reinstall', { bots: 6, groups: 1 }), 'Your 6 Bots and 1 group chat are still here')- assert.equal(t('zh', 'hint.reinstall', { bots: 6, groups: 1 }), '上次的 6 个 Bot 和 1 个群聊都在')- assert.equal(t('en', 'hint.reinstall', { bots: 1 }), 'Your 1 Bot and {groups|group chat|group chats} are still here')++ assert.equal(t('en', 'dialog.import.found', { bots: 1, groups: 6 }), 'DeepSeek Harness has 1 Bot and 6 group chats. Copy them into DS Bot?')++ assert.equal(t('en', 'dialog.import.found', { bots: 6, groups: 1 }), 'DeepSeek Harness has 6 Bots and 1 group chat. Copy them into DS Bot?')++ assert.equal(t('zh', 'dialog.import.found', { bots: 6, groups: 1 }), 'DeepSeek Harness 里有 6 个 Bot 和 1 个群聊。要复制到 DS Bot 吗?')++ assert.equal(t('en', 'dialog.import.found', { bots: 1 }), 'DeepSeek Harness has 1 Bot and {groups|group chat|group chats}. Copy them into DS Bot?')})test('langOf gives zh for every Chinese locale and en otherwise', () => {diff --cc app/test/start-window.test.mjsindex 926d511c,6cdc538f..e7ca0168--- a/app/test/start-window.test.mjs+++ b/app/test/start-window.test.mjs@@@ -508,65 -507,6 +508,65 @@@ test('closing the start window before tassert.equal(s.start.owner(), undefined)})+test('the whale lands on the avatar the team view reported, in the start page\'s own coordinates', () => {+ const team = { x: 300, y: 90, width: 1280, height: 860 }+ const avatar = { x: 98, y: 70, width: 60, height: 60, viewportWidth: 1280, viewportHeight: 860 }+ // Both windows frameless: the grown start page shares the team page\'s origin.+ assert.deepEqual(landingOf(avatar, { team, start: { x: 300, y: 90 } }), { x: 98, y: 70, size: 60 })+ // A team page zoomed to 125 %: its CSS px are larger than DIP.+ assert.deepEqual(landingOf({ x: 80, y: 56, width: 48, height: 48, viewportWidth: 1024, viewportHeight: 688 }, { team, start: { x: 300, y: 90 } }), { x: 100, y: 70, size: 60 })+ // A system title bar on the start window only: its content starts 32 px lower.+ assert.deepEqual(landingOf(avatar, { team, start: { x: 300, y: 122 } }), { x: 98, y: 38, size: 60 })+ // Nothing to land on: no box, a tiny one, one outside the page, or not numbers.+ for (const report of [undefined, null, 'avatar', { x: 1 }, { ...avatar, width: 8, height: 8 }, { ...avatar, x: 1250 }, { ...avatar, y: -4 }, { ...avatar, x: Number.NaN }, { ...avatar, viewportWidth: 0 }]) {+ assert.equal(landingOf(report, { team, start: { x: 300, y: 90 } }), undefined, JSON.stringify(report))+ }+})++const AVATAR = { x: 98, y: 70, width: 60, height: 60, viewportWidth: MAIN_SIZE.width, viewportHeight: MAIN_SIZE.height }+test('ready() with the avatar\'s place puts the landing in the hand-off snapshot; without one there is none', (t) => {+ for (const [report, landing] of [[AVATAR, { x: 98, y: 70, size: 60 }], [undefined, undefined], [{ ...AVATAR, x: MAIN_SIZE.width - 10 }, undefined]]) {+ const s = startWindow(t)+ s.start.open('first')+ // As in the app: the team window is made on its rect, and the page measures it there.+ s.start.placeMain()+ s.start.done('data')+ s.start.done('engine')+ s.start.ready(report)+ assert.equal(s.state().view, 'handoff')+ assert.deepEqual(s.state().landing, landing)+ t.mock.timers.reset()+ }+})++test('the landing takes the start window\'s title bar into account, and waits with a held hand-off', (t) => {+ const s = startWindow(t)+ s.start.open('first')+ // macOS and Linux: a system title bar puts the start page 32 px below the window's top.+ const win = s.win()+ win.getContentBounds = () => ({ ...win.bounds, y: win.bounds.y + 32, height: win.bounds.height - 32 })+ s.start.placeMain()+ s.start.done('data')+ s.start.done('engine')- s.start.card({ kind: 'picked', path: 'D:\\DeepSeek Bot' })++ s.start.card({ kind: 'picked', path: 'D:\\DS Bot' })+ s.start.ready(AVATAR)+ assert.equal(s.state().view, 'card')+ s.start.card(undefined)+ assert.equal(s.state().view, 'handoff')+ assert.deepEqual(s.state().landing, { x: 98, y: 38, size: 60 })+})++test('a minimized start window gets no landing', (t) => {+ const s = startWindow(t)+ s.start.open('first')+ s.start.done('data')+ s.start.done('engine')+ s.win().minimized = true+ s.start.ready(AVATAR)+ assert.equal(s.state().view, 'handoff')+ assert.equal(s.state().landing, undefined)+})+test('a failure during the hand-off draws the failure page on a fresh page', (t) => {const s = startWindow(t)s.start.open('first')diff --cc docs/plans/2026-10-26-start-window.mdindex 1ccc59bc,13227b35..632026e6--- a/docs/plans/2026-10-26-start-window.md+++ b/docs/plans/2026-10-26-start-window.md@@@ -81,14 -79,12 +81,14 @@@- 每段一次性动作带序号,新状态到了就丢掉旧的。等动画结束的地方都配一个计时器兜底,因为最小化的窗口不走动画。- 弹簧只用 `motion.js` 的常量。头像动作的关键帧沿用插件的写法(`styles.js` 的 `bt-hop`、`bt-bob` 等),换算成像素。- 鲸鱼说话:- - 鲸鱼一次只说一句短话,写在水线下面那一行(第 2 节),用 Main Bot 自己的口吻。窗口里没有大段的文字:旁边只有已用秒数、一行提示、卡片、底注和位置行(第 2 节)。- - 问候里的名字是 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 节),这一行和提示行也空着。+ - 顺利的时候鲸鱼不说话,页面上除了底注和位置行(盘不够时还有提示行的那一句)没有字。只在要用户知道或回答的时候,圆环下面那一行(第 2 节)才有一句短话,用 Main Bot 自己的口吻:+ - 45 秒,引擎还没起来:首次启动「有点久,可能是杀毒软件在查新文件」;以后的启动和搬数据时「比平时慢,请再等一会儿」(第 4、5 节)。+ - 180 秒:「等太久了,要不要重试?」(第 6 节)。- - 失败:「DeepSeek Bot 没能启动」「团队界面没有加载出来」(第 7 节)。- - 搬数据时,到 45 秒为止:「正在搬 DeepSeek Bot 的数据…」(第 1、5 节)。++ - 失败:「DS Bot 没能启动」「团队界面没有加载出来」(第 7 节)。++ - 搬数据时,到 45 秒为止:「正在搬 DS Bot 的数据…」(第 1、5 节)。+ - 换句时淡出 .16 s,再淡入 .16 s。没有停留时间,也不排队:快照或启动的时钟一变,这一行就跟着换。+ - 卡片在时这一行空着,由卡片自己的第一行说(第 6 节)。180 秒的卡和失败页例外:180 秒的问题由鲸鱼问,卡上只有按钮;失败页上是已定的标题(第 7 节)。+ - 提示行只有两样:盘不够、又没有更好的盘时,前 10 秒的「C 盘只剩 1.2 GB」(第 4、6 节);45 秒起和鲸鱼那句话一起的〔打开日志文件夹〕。| 时刻 | 鲸鱼 | 时长和曲线 ||---|---|---|@@@ -159,14 -154,13 +159,14 @@@### 5. 以后的启动-- 0 ms:64 px 的鲸鱼在窗口中间浮上来(`SPRING_TAP` 290 ms),不倾斜,眼睛睁着,没有涟漪。60 ms 后,「正在打开你的团队…」淡入。-- 没有水线和圈,也没有首次启动的那些话和提示:鲸鱼下面只有这一行已定的字(换位置时是「正在搬 DS Bot 的数据…」)。-- 前 1 秒什么都不再动。1 秒后鲸鱼开始工作(只上下晃和眨眼),那行字带流光。-- 10 秒起,下面显示「已用 N 秒」。-- 45 秒:「比平时慢,请再等一会儿」〔打开日志文件夹〕。+- 和首次启动是同一个页面:112 px 的鲸鱼在圆环中间,一段水线,三段弧跟着阶段走(第 2、3 节);没有底注和位置行,顺利时没有字。+- 0 ms:鲸鱼从水线下 84 px 浮上来(`SPRING_TAP` 290 ms),不倾斜,眼睛睁着,没有涟漪;圆环的淡线 180 ms 起画出来,水线 220 ms 淡入。第一段弧最早在入场后 260 ms(页面画出来后 550 ms)画满。+- 前 1 秒鲸鱼不换循环:第一段弧画满时照样划两下尾巴、向前一涌,再点一下头(第 3 节)。1 秒后开始工作(只上下晃和眨眼,三个阶段都一样)。+- 10 秒:鲸鱼看向用户一次,循环放慢,不出字。+- 45 秒,引擎还没起来:鲸鱼说「比平时慢,请再等一会儿」,提示行只有〔打开日志文件夹〕,鲸鱼改成思考。- 180 秒:和首次启动一样。- - 换位置(第 1 节)时,鲸鱼下面一直是「正在搬 DeepSeek Bot 的数据…」,45 秒起换成「比平时慢,请再等一会儿」和〔打开日志文件夹〕。以后的启动和搬数据时,这一行的字 1 秒后带流光。-- 就绪时没有庆祝(重试或重新开始后第一次成功时例外,第 8 节):字淡出 .16 s,鲸鱼从当前姿势潜下去;120 ms 时发 `handoffShow`,启动窗口和首次启动一样长成主窗口的矩形,主窗口在就绪后约 0.6 秒露面(第 8 节)。++- 换位置(第 1 节)时,鲸鱼下面一直是「正在搬 DS Bot 的数据…」,45 秒起换成「比平时慢,请再等一会儿」和〔打开日志文件夹〕。以后的启动和搬数据时,这一行的字 1 秒后带流光。+- 就绪时没有庆祝(重试或重新开始后第一次成功时例外,第 8 节):剩下的弧画满、圆环合上,100 ms 后鲸鱼跳向 Main Bot 的头像(没有地方落时潜下去);220 ms 时发 `handoffShow`,启动窗口和首次启动一样长成主窗口的矩形,鲸鱼 650 ms 时落在头像上,主窗口在就绪后约 0.7 秒露面(第 8 节)。- `DS_BOT_HOME` 的一次性运行用这一套,只是不出卡片。### 6. 卡片、180 秒和导入@@@ -190,12 -184,12 +190,12 @@@- 用户自己引出的卡片(「其他位置…」选完后的「会放在…」、停止复制的确认),不跳,变形开始 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。放到 D 盘(剩 412 GB)?」〔放到 D 盘〕(主按钮,拿到焦点)〔仍然放在 C 盘〕,按钮行末尾一个小链接「其他位置…」。默认位置不能用时,第一句换成原因(「DS Bot 没有权限在 `C:\Users\<用户名>` 里写文件。」),第二句一样;按钮只有〔放到 D 盘〕(主按钮)和小链接「其他位置…」,没有〔仍然放在 C 盘〕;没有可推荐的盘时只有〔选择其他位置…〕。+ - 「其他位置…」打开系统选择框,卡片留在后面。定出的根就是用户选的文件夹时(上手流程第 3 节的规则),卡片直接收回,照常启动,不确认。应用在里面加了一层 `DS Bot` 时,同一张卡变形成「会放在 `D:\DS Bot`。」〔继续〕(主按钮)〔重新选…〕。选的位置不能用,同一张卡写一句原因(「DS Bot 没有权限在 `D:\Data` 里写文件。」「`C:\Users\<用户名>\OneDrive\文档` 在 OneDrive 里,同步会打断正在写入的对话。」「`D:\Projects\DS Bot` 里已经有别的文件。」),〔重新选…〕(主按钮),来时那张卡的〔放到 D 盘〕〔仍然放在 C 盘〕照旧留着;选择框被取消就回到来时的卡。「会放在…」和被拒绝的卡也有脚注。- 脚注都是「以后可以在 设置 → 通用 → 位置 里改。」- - 没有更好的盘时不出卡片:前 10 秒提示行写「C 盘只剩 1.2 GB」,之后换成这一站的提示(第 4 节)。- - 位置行的「换个位置…」(第 2 节)不等推荐盘的卡:新团队和要导入的首次启动期间随时能点,引擎正在起也可以,走和「其他位置…」同一条路。选完先定根(上手流程第 3 节「一个位置」):根就是选的文件夹时不出卡,直接重新开始;加了一层 `DS Bot` 时出「会放在 `D:\DS Bot`。」〔继续〕(主按钮)〔重新选…〕;不能用时出「这里放不了」加一句原因(上面三句,再加「`D:\Data` 是 DeepSeek Harness 的数据。」「`C:\Program Files\DS Bot\data` 在程序文件夹里,卸载时会删掉。」),〔重新选…〕(主按钮);这两张卡都是用户自己引出的,不跳。选择框被取消就回到位置行:这一路没有来时的卡,「会放在…」和「这里放不了」也一起收回,仍按默认位置走。选了现在的根或数据文件夹就当没选;选在现在的数据文件夹里面、或者定出的根和它重叠,出「这里放不了」加「`C:\Users\<用户名>\.ds-bot\旧` 和现在放数据的位置重叠。」,总工作区里已经有东西时也一样,还空着的(这次启动刚建的)可以成为新的根:默认位置下选用户文件夹,就是「会放在 `C:\Users\<用户名>\DS Bot`。」;读不了的文件夹按没有权限处理;检查都穿过链接和联接看真正的路径,DSH 的家那句写用户选的文件夹。选择框或这两张卡开着时团队就绪了,交接和 20 秒的界面检查都等答完再走:交接会把启动窗口连同挂在它上面的选择框一起收掉。定好以后按第 7 节〔换个位置…〕的路重新开始:鲸鱼立刻沉下去,位置行立刻写新的盘;旧引擎直接结束,不等它起完、也不等它有序退出(两者都要 3 到 10 秒,鲸鱼会一直在水下;那个文件夹马上就删,没有要保全的东西),默认位置上这一次建的文件夹删掉(数据文件夹整个删,总工作区只在还是空的时候删),位置这时就记下,鲸鱼在第 1 站重新浮上来;沉下去时这一行立刻空着,不等上一句停够。导入复制进行中不接这一下,复制完以后这一行收起:搬一个复制好的团队是 设置 → 通用 → 位置 的事。-- 重装(`C:\Users\<用户名>\.ds-bot` 里有团队、没有保存的位置)不出卡片,盘不够也不出:鲸鱼到了第 2 站,提示行写「上次的 6 个 Bot 和 2 个群聊都在」,不写路径,也没有接模型的提示。+ - 没有更好的盘时不出卡片:前 10 秒提示行写「C 盘只剩 1.2 GB」,之后提示行空着(第 4 节)。- - 位置行的「换个位置…」(第 2 节)不等推荐盘的卡:新团队和要导入的首次启动期间随时能点,引擎正在起也可以,走和「其他位置…」同一条路。选完先定根(上手流程第 3 节「一个位置」):根就是选的文件夹时不出卡,直接重新开始;加了一层 `DeepSeek Bot` 时出「会放在 `D:\DeepSeek Bot`。」〔继续〕(主按钮)〔重新选…〕;不能用时出「这里放不了」加一句原因(上面三句,再加「`D:\Data` 是 DeepSeek Harness 的数据。」「`C:\Program Files\DeepSeek Bot\data` 在程序文件夹里,卸载时会删掉。」),〔重新选…〕(主按钮);这两张卡都是用户自己引出的,不跳。选择框被取消就回到位置行:这一路没有来时的卡,「会放在…」和「这里放不了」也一起收回,仍按默认位置走。选了现在的根或数据文件夹就当没选;选在现在的数据文件夹里面、或者定出的根和它重叠,出「这里放不了」加「`C:\Users\<用户名>\.ds-bot\旧` 和现在放数据的位置重叠。」,总工作区里已经有东西时也一样,还空着的(这次启动刚建的)可以成为新的根:默认位置下选用户文件夹,就是「会放在 `C:\Users\<用户名>\DeepSeek Bot`。」;读不了的文件夹按没有权限处理;检查都穿过链接和联接看真正的路径,DSH 的家那句写用户选的文件夹。选择框或这两张卡开着时团队就绪了,交接和 20 秒的界面检查都等答完再走:交接会把启动窗口连同挂在它上面的选择框一起收掉。定好以后按第 7 节〔换个位置…〕的路重新开始:鲸鱼立刻沉下去,位置行立刻写新的盘;旧引擎直接结束,不等它起完、也不等它有序退出(两者都要 3 到 10 秒,鲸鱼会一直在水下;那个文件夹马上就删,没有要保全的东西),默认位置上这一次建的文件夹删掉(数据文件夹整个删,总工作区只在还是空的时候删),位置这时就记下,三段弧回到没开始,鲸鱼在原处重新浮上来。导入复制进行中不接这一下,复制完以后这一行收起:搬一个复制好的团队是 设置 → 通用 → 位置 的事。++ - 位置行的「换个位置…」(第 2 节)不等推荐盘的卡:新团队和要导入的首次启动期间随时能点,引擎正在起也可以,走和「其他位置…」同一条路。选完先定根(上手流程第 3 节「一个位置」):根就是选的文件夹时不出卡,直接重新开始;加了一层 `DS Bot` 时出「会放在 `D:\DS Bot`。」〔继续〕(主按钮)〔重新选…〕;不能用时出「这里放不了」加一句原因(上面三句,再加「`D:\Data` 是 DeepSeek Harness 的数据。」「`C:\Program Files\DS Bot\data` 在程序文件夹里,卸载时会删掉。」),〔重新选…〕(主按钮);这两张卡都是用户自己引出的,不跳。选择框被取消就回到位置行:这一路没有来时的卡,「会放在…」和「这里放不了」也一起收回,仍按默认位置走。选了现在的根或数据文件夹就当没选;选在现在的数据文件夹里面、或者定出的根和它重叠,出「这里放不了」加「`C:\Users\<用户名>\.ds-bot\旧` 和现在放数据的位置重叠。」,总工作区里已经有东西时也一样,还空着的(这次启动刚建的)可以成为新的根:默认位置下选用户文件夹,就是「会放在 `C:\Users\<用户名>\DS Bot`。」;读不了的文件夹按没有权限处理;检查都穿过链接和联接看真正的路径,DSH 的家那句写用户选的文件夹。选择框或这两张卡开着时团队就绪了,交接和 20 秒的界面检查都等答完再走:交接会把启动窗口连同挂在它上面的选择框一起收掉。定好以后按第 7 节〔换个位置…〕的路重新开始:鲸鱼立刻沉下去,位置行立刻写新的盘;旧引擎直接结束,不等它起完、也不等它有序退出(两者都要 3 到 10 秒,鲸鱼会一直在水下;那个文件夹马上就删,没有要保全的东西),默认位置上这一次建的文件夹删掉(数据文件夹整个删,总工作区只在还是空的时候删),位置这时就记下,三段弧回到没开始,鲸鱼在原处重新浮上来。导入复制进行中不接这一下,复制完以后这一行收起:搬一个复制好的团队是 设置 → 通用 → 位置 的事。+- 重装(`C:\Users\<用户名>\.ds-bot` 里有团队、没有保存的位置)不出卡片,盘不够也不出;启动页上不写上次的团队和路径,进门后就是它。- 180 秒:鲸鱼立刻问「等太久了,要不要重试?」,卡片里只有〔继续等待〕(主按钮)〔重试〕〔打开日志文件夹〕,读屏读的是这句问话。- 〔继续等待〕:卡片收回,180 秒后再问。- 〔重试〕:重启引擎,时钟从 0 开始,鲸鱼抖一抖,回到工作。@@@ -219,10 -213,10 +219,10 @@@### 7. 失败、更新和界面没加载出来- 失败后 1 秒内:- - 鲸鱼的话立刻换成「DeepSeek Bot 没能启动」,写在圆环和卡片之间(第 2 节),读屏读出这一句。- - 鲸鱼的话立刻换成「DS Bot 没能启动」,读屏读出这一句。- - 鲸鱼在它停的那一站换成失败的姿势(第 3 节),站上不画叉:失败只靠鲸鱼的姿势和这一句。- - 已用秒数和提示行淡出。- - 纸面变成恢复卡:一句原因、五个按钮、「详细信息」。卡片没有鲸鱼的第一行。++ - 鲸鱼的话立刻换成「DS Bot 没能启动」,写在圆环和卡片之间(第 2 节),读屏读出这一句。+ - 鲸鱼换成失败的姿势(第 3 节),卡住的那段弧变红,不画叉:失败只靠鲸鱼的姿势、红的那段弧和这一句。+ - 提示行淡出。+ - 纸面变成恢复卡:一句原因、五个按钮、「详细信息」。卡片没有鲸鱼的第一行。水塘缩小上移,圆环在卡片上面(第 2 节)。- 焦点移到〔重试〕。窗口不隐藏。- 〔复制详细信息〕点过后,按钮上的字变成「已复制」,1.6 秒后变回来。「详细信息」最多展开 168 px,日志在框里滚动。- 有新版本时:@@@ -369,19 -355,7 +369,19 @@@| [UI 标准](../design/ui-standard.md) 第 1 节第 4 条和 8.4「持续的环境动画只出现在「活泼」档」;8.4 活泼档「等你回答时一直跳」;8.3 状态动作 | 只在启动窗口里、卡片等用户回答时,正常档和活泼档也呼吸和眨眼;活泼档改成越跳越稀;另加探身、按下预备、眼睛跟着键盘焦点、回到窗口时看你一眼(第 3 节第二张表)。安静档和减少动态效果时都没有;插件里的头像不变 || 本文首稿 第 3 节「只为真实的事动:……以及用户的指针和点击」「等用户回答时静止」;第 3 节的表和第 6 节「跳两下,然后静止,看着卡片」「不跳,静止」 | 等用户回答时停下:探身、呼吸和眨眼(第 3 节第二张表),另为键盘焦点和回到窗口而动;安静档、减少动态效果和失败页上停下就不再动 || 本文 2026-10-28 第 4 节第 2 拍「已经完成的话,直接游到第 2 站」 | 等问候读满(页面画出来后 1.66 秒)才离开第 1 站,等的时候晃着(第 4 节)。维护者 2026-10-29 试用时「小鲸鱼看到的时候就在第二个位置」:主进程在页面画出来以前就建好了数据文件夹,鲸鱼一浮上来就游走,第 1 站像没有过 |- | 本文第 5、6、7 节:45 秒「比平时慢,请再等一会儿。」;「会放在 `D:\DeepSeek Bot`」〔继续〕〔重新选〕;「…同步会打断正在写入的聊天记录。」;鲸鱼的话「团队界面没有加载出来。」 | 「比平时慢,请再等一会儿」;「会放在 `D:\DeepSeek Bot`。」〔继续〕〔重新选…〕(被拒绝的卡上的〔重新选…〕一样);「…正在写入的对话。」;「团队界面没有加载出来」。按 [启动页文案](2026-10-29-start-copy.md) 每一层的写法规则 |- | 本文 2026-10-28 第 2、3、9 节:鲸鱼停在三站之一(x 168 / 360 / 552),一个阶段完成时向右游到下一站,离开的站留下一个圈;624 px 的水线;首次启动的鲸鱼 88 px,以后的启动 64 px、没有水线;减少动态效果时换站淡出淡入 | 鲸鱼一直在中间,围着它的三段弧就是进度:进行中淡蓝加一道跑动的光,完成时顺时针画满,失败时变红;水线是圆环的弦(200 px);每种启动都是 112 px 的鲸鱼、圆环和水线;出卡片时水塘缩到 .62 倍、上移 60 px,圆环落在卡片上面(第 2、3、9 节)。维护者 2026-10-30 转来一段讨论,说这一版太吵:「现在这版有点噪了」「是不是可以简约一点」;比较三份草稿(水线分三段的进度条、圆环、只有鲸鱼)后选了圆环 |+ | 本文第 5、6、7 节:45 秒「比平时慢,请再等一会儿。」;「会放在 `D:\DS Bot`」〔继续〕〔重新选〕;「…同步会打断正在写入的聊天记录。」;鲸鱼的话「团队界面没有加载出来。」 | 「比平时慢,请再等一会儿」;「会放在 `D:\DS Bot`。」〔继续〕〔重新选…〕(被拒绝的卡上的〔重新选…〕一样);「…正在写入的对话。」;「团队界面没有加载出来」。按 [启动页文案](2026-10-29-start-copy.md) 每一层的写法规则 |++| 本文 2026-10-28 第 2、3、9 节:鲸鱼停在三站之一(x 168 / 360 / 552),一个阶段完成时向右游到下一站,离开的站留下一个圈;624 px 的水线;首次启动的鲸鱼 88 px,以后的启动 64 px、没有水线;减少动态效果时换站淡出淡入 | 鲸鱼一直在中间,围着它的三段弧就是进度:进行中淡蓝加一道跑动的光,完成时顺时针画满,失败时变红;水线是圆环的弦(200 px);每种启动都是 112 px 的鲸鱼、圆环和水线;出卡片时水塘缩到 .62 倍、上移 60 px,圆环落在卡片上面(第 2、3、9 节)。维护者 2026-10-30 转来一段讨论,说这一版太吵:「现在这版有点噪了」「是不是可以简约一点」;比较三份方案(水线分三段的进度条、圆环、只有鲸鱼)后选了圆环 |+| 同上 第 3、4 节:鲸鱼一次说一句短话,跟着鲸鱼走、按停留时间排队:入场「嗨,我是总管」(重装用团队里 Main Bot 的名字,导入「嗨,我来了」)、「先找个地方放东西」「找到了」「热身中,等我一下」、10 秒「第一次会慢一点」、「开门去了」;入场时就来的卡等问候读满 1.5 秒;「待定」里问候用哪个名字 | 顺利时不说话;只在 45 秒、180 秒、失败和搬数据时说一句,换句时淡出淡入,不排队(第 3 节)。讨论里:「其实我觉得可能就放一个鲸鱼就够,然后可以做交互动画,文字什么的不太需要」。顺利的启动只有几秒,进度已经由圆环说了;问候用哪个名字也就不用定了 |+| 同上 第 4 节第 3、8 拍和第 6 节:提示行写接下来要知道的事:新团队「待会儿要接一个模型:DeepSeek 账号或 API Key」,重装「上次的 6 个 Bot 和 2 个群聊都在」,DSH 会挂出预览版说明时「里面先有一页说明,点「继续」就行」 | 提示行只有盘不够时前 10 秒的「C 盘只剩 1.2 GB」和 45 秒起的〔打开日志文件夹〕(第 3、4 节)。这三句说的都是进门以后的事:接模型由 Main Bot 的设置卡说,预览版说明自己有〔继续〕,重装进门就是原来的团队;等的时候提前说,只是多一行字 |+| 同上 第 2、4 节:5 秒起右上角「已用 N 秒」,卡片等回答时隐藏,一直留到「进去吧」;以后的启动 10 秒起写在提示行里 | 不显示;10 秒、45 秒和 180 秒仍按同一个启动时钟算,卡片等回答时它照样停(第 4 节)。每秒跳一次的数字是顺利时页面上唯一一直在变的字;慢的时候,45 秒那句和〔打开日志文件夹〕给出路 |+| 同上 第 3 节 正常档「首次启动等待时,点鲸鱼它会转一圈」;安静档「没有眼睛跟随、点击转圈、抚摸、尾巴……和「^ ^」眼」;「不做什么」「不喷水」 | 点鲸鱼它就喷水,每种启动都有:2.5 秒内第 4 下喷大的,失败趴着时冒一小股,入场、沉下去、就绪以后不喷;安静档也喷,水柱小一号,压扁、甩尾和「^ ^」眼照旧;减少动态效果只换「^ ^」眼(第 3 节)。维护者提议的就是一只浮在水上、点一下会喷水的鲸鱼:没有字以后,互动是鲸鱼对用户唯一的回应,喷水又是鲸鱼自己的动作。安静档也有:它只在用户点了以后出现一次,不是一直在动的环境动画 |+| 同上 第 8 节:首次启动先说「进去吧」(上一句能读满 400 ms 才上,`readyLine` 最多等 600 ms),上屏 300 ms 后压扁、「^ ^」眼、潜下去;排队的游动最多让交接晚 600 ms;以后的启动重试或重新开始后第一次成功时不说「进去吧」,压扁回弹 920 ms 后潜下去 | 还没画满的弧一起画满,圆环合上、鼓起一次;庆祝的交接(首次启动,重试或重新开始后第一次成功)同时压扁、「^ ^」眼、喷水,560 ms 潜下去;首次启动和以后的启动庆祝的那次是同一张表(第 8 节)。没有字以后,圆环合上就是「好了」;喷水是用户点鲸鱼时见过的那个动作 |+| 本文 2026-10-29 第 4 节第 2 拍:鲸鱼等问候读满(页面画出来后 1.66 秒)才离开第 1 站 | 第一段弧最早在入场后 260 ms(页面画出来后 820 ms)画满(第 4 节)。没有问候要等;鲸鱼也不再离开,那 1.66 秒要防的「浮上来就游走了」不会发生,只留一拍让人看见第一段画满 |+| 本文 2026-10-28 第 5 节:以后的启动 64 px 的鲸鱼下面写「正在打开你的团队…」,1 秒后带流光,没有水线和圈;前 1 秒什么都不再动 | 和首次启动同一个页面,顺利时没有字;45 秒起鲸鱼说「比平时慢,请再等一会儿」,提示行只有〔打开日志文件夹〕;前 1 秒只有第一段弧画满时那一下(划尾巴、一涌、点头)(第 5 节)。圆环已经说了在打开;以后的启动只要 3 到 12 秒,一行一直在的字就是噪音。阶段完成是真实的事(第 3 节),以后的启动也让人看见圆环在走 |+| 同上 第 8 节:首次启动 `handoffShow` 在就绪后约 1.1 秒,主窗口约 1.6 秒露面;以后的启动 120 ms、约 0.6 秒;以后的启动庆祝的那次约 1.04 秒、约 1.5 秒;减少动态效果约 0.86 秒 | 庆祝的交接 `handoffShow` 在 0.72 秒,主窗口约 1.2 秒露面;不庆祝的 0.22 秒、约 0.7 秒;减少动态效果 0.42 秒;主进程的兜底不变(2.5 秒、0.8 秒,第 8 节)。没有「进去吧」要读,交接不再等字;不庆祝的多出 100 ms,让合上的圆环先被看见 |+| 本文第 2、6 节:没有卡片时,水塘、鲸鱼的话和提示行整组比有卡片时低 80 px,鲸鱼落在窗口的视觉中心(圆环的圆心 (360, 290),水线 y 322,鲸鱼的话 y 414–434,提示行 y 438–466);出卡片时整组上移 80 px | 低 45 px,鲸鱼在窗口的视觉中心稍上一点:圆心 (360, 255),水道 y 147–287,水线 y 287,鲸鱼的话 y 379–399,提示行 y 403–431;出卡片时整组上移 45 px,有卡片时的位置不变(第 2、6 节)。维护者 2026-10-30:「位置上调一些」 |+| 本文第 3、4、5、7、8 节:就绪时鲸鱼潜下去,深到身高的 1.25 倍;首次启动时 Main Bot 的鲸鱼在团队界面侧栏的磁贴上浮上来一次,由插件做,主进程显示主窗口时经 `dsBotApp` 发露面事件(待定),Main Bot 聊天里的第一张卡等它浮上来;「待定」里磁贴上的鲸鱼怎么知道该浮上来、「预览版说明」盖着侧栏时怎么办;「不做什么」「鲸鱼不从启动窗口飞进主窗口」 | 鲸鱼跳出水面,在长大的启动窗口里飞到 Main Bot 的头像会在的位置,缩到头像的大小落下;主窗口在同一个矩形上露面,头像正好在它下面。头像的位置由侧栏随 `dsBotApp.ready()` 带来,主进程换成启动页的坐标(`landing`);没有露面事件,团队界面里的头像不另做动画,第一张卡也不等;「预览版说明」挂着时照样落在头像的位置上。没有地方落时(别的样子或照片、团队列收起、经典 Agent 模式)照旧潜下去,减少动态效果时照旧淡出(第 3、8 节)。维护者 2026-10-30:「启动之后流畅变形为主页面,Chief跳到主页左侧的Chief位置」 |+| 本文第 8 节「长大时页面上除了 Mica 什么都不能有」 | 长大时页面上只有飞着的鲸鱼:字、水线、圆环和纸面照旧在长大之前淡完;鲸鱼的动画走合成线程,但页面只在其中几步重画,这 300 ms 里鲸鱼可能一顿一顿地动(第 8 节、「已知限制」)。鲸鱼要一直看得见,才能落到头像上:为了「Chief跳到主页左侧的Chief位置」,接受这一点 |## 变更@@@ -394,8 -368,6 +394,8 @@@- 2026-10-28 张望:第 3 节第二张表加第 9 条,第 2 站工作时每 5 到 9 秒随机向一边看 600 ms,安静档和减少动态效果没有;维护者问「小鱼的摇晃改为摇晃-张望随机是否可行」,可行,叠在上下晃上。依据:原型 `alive.cjs` 的 wander 用例(正常档 30 秒内三次、间隔 7.8 到 8.5 秒,安静档和指针在页面上时零次)。- 2026-10-29 先打招呼再出发:第 4 节第 2 拍,数据阶段已完成时鲸鱼也等问候读满才离开第 1 站,等的时候晃着。维护者试用落地的启动窗口时「小鲸鱼看到的时候就在第二个位置」:那次首次启动里主进程 2.9 秒就建好了数据文件夹,页面 8.6 秒才画出来(冷启动;之后两次启动 2 秒),鲸鱼浮上来 560 ms 就游到了第 2 站。依据:原型 `alive.cjs` 的 greet 用例(数据阶段在入场结束前完成时,鲸鱼入场后 1.66 秒离开第 1 站、再 0.6 秒说「热身中,等我一下」;搜索到一半完成的也一样,且不说「先找个地方放东西」)、试用副本上的实测(窗口 1.1 秒出现、数据 1.9 秒完成、页面 2.1 秒画出来;鲸鱼入场后 1.68 秒离开第 1 站;`main.mjs` 标记数据完成后紧接着就启动引擎,日志里「engine took」从那一刻起算,和问候无关)。- 2026-10-29 文案分层:启动页的字按页面位置分层、一张表,见 [启动页文案](2026-10-29-start-copy.md);第 11 节 `text.mjs` 一条改成指向它;按各层规则改四处:45 秒的提示和「团队界面没有加载出来」去句号,「会放在 …」加句号、〔重新选〕加 …,OneDrive 的原因里「聊天记录」改成「对话」(第 5、6、7 节)。- - 2026-10-30 圆环:维护者转来一段讨论,说启动窗口太吵(「现在这版有点噪了」「是不是可以简约一点」「其实我觉得可能就放一个鲸鱼就够,然后可以做交互动画,文字什么的不太需要」),提议只留一只浮在水上、点一下会喷水的鲸鱼,进度做成横条或圆环;比较三份草稿(水线分三段的进度条、圆环、只有鲸鱼)后选了圆环。「为什么」、第 2 到 11 节按圆环改写:三站和留下的圈换成围着鲸鱼的三段弧,每种启动都是 112 px 的鲸鱼、圆环和水线,出卡片时水塘缩到 .62 倍、上移 60 px;顺利时不说话(去掉问候、各阶段的话、「进去吧」、接模型、预览版说明和重装的提示、已用秒数,以后的启动去掉「正在打开你的团队…」),只留盘不够的提示、45 秒、180 秒、失败、卡片和搬数据;以后的启动和搬数据时 45 秒那句由鲸鱼说;点鲸鱼喷水代替转一圈;交接时剩下的弧画满、圆环合上,庆祝的那次喷水、560 ms 潜下去、0.72 秒发 `handoffShow`,不庆祝的 0.22 秒。「待定」去掉问候用哪个名字,水线那一行按圆环改写;「不做什么」和「已知限制」跟着改。依据:原型的圆环布局(82 个状态的截图都过了布局探针,探针也查圆环不碰鲸鱼的话、提示行和卡片:没有问题);`ring-live.cjs`:首次启动 `handoffShow` 在就绪后 0.72 秒(原来的布局 1.09 到 1.17 秒),以后的启动 0.23 到 0.33 秒,都在原型兜底的 1.5 秒和 0.8 秒以内,45 秒的〔打开日志文件夹〕用指针点得到,搬数据那一行在,喷水的「^ ^」眼给失败的姿势让路,〔重试〕清掉红的那段弧;一次独立评审的 10 条意见都已改正(空纸面让点击穿过、卡片在时提示行隐藏、112 px 鲸鱼入场的深度 96 / 84 px、沉下去 84 px、喷水的「^ ^」眼不盖过失败的姿势、就绪以后不喷、强制颜色覆盖弧、光、水柱和水滴、弧 0.5 s 画出来等)。桌面应用里的检查(离屏 Electron、替身桥,15 项都过):首次启动 `handoffShow` 在就绪后 0.73 秒,以后的启动 0.24 秒(引擎在就绪前 0.5 秒才起来);数据阶段在页面画出来以前完成时,第一段弧 820 ms 画满,700 ms 时完成的,565 ms 进行中、999 ms 画满。真机上的首次启动(这条分支的一次性副本,装着锁定的 DSH 0.2.1-rc.4):窗口 1.5 秒出现、页面 2.9 秒画出来,第一段弧在页面时间 2.6 秒画满;引擎 17.1 秒后第二段画满,团队 4.4 秒后就绪;`handoffShow` 在就绪后 738 ms,窗口 173 ms 后开始长大,团队窗口在就绪后 1.31 秒露面,页面上没有留下的圈和已用秒数。和原型有意不同的两处:第一段弧等的时候鲸鱼不换循环(原型先换成工作的循环,循环自己要停满的 400 ms 把弧再推迟);就绪时正在走的那一拍不再走完,剩下的弧一起画满(原型让它走完;照原型写的桌面应用里,引擎在就绪前 0.5 秒起来的以后的启动 0.46 秒才发 `handoffShow`)。评审后补正:第一段弧等的时候鲸鱼不换循环(第 4 节);以后的启动前 1 秒有第一段弧画满的那一下(第 5 节);一拍走完点一下头(第 3 节);安静档点鲸鱼时照样压扁、甩尾和「^ ^」眼;浮上来的那圈涟漪 .56 s 淡完;盘不够的那句按启动的时钟算前 10 秒,入场时就在。++- 2026-10-30 圆环:维护者转来一段讨论,说启动窗口太吵(「现在这版有点噪了」「是不是可以简约一点」「其实我觉得可能就放一个鲸鱼就够,然后可以做交互动画,文字什么的不太需要」),提议只留一只浮在水上、点一下会喷水的鲸鱼,进度做成横条或圆环;比较三份方案(水线分三段的进度条、圆环、只有鲸鱼)后选了圆环。「为什么」、第 2 到 11 节按圆环改写:三站和留下的圈换成围着鲸鱼的三段弧,每种启动都是 112 px 的鲸鱼、圆环和水线,出卡片时水塘缩到 .62 倍、上移 60 px;顺利时不说话(去掉问候、各阶段的话、「进去吧」、接模型、预览版说明和重装的提示、已用秒数,以后的启动去掉「正在打开你的团队…」),只留盘不够的提示、45 秒、180 秒、失败、卡片和搬数据;以后的启动和搬数据时 45 秒那句由鲸鱼说;点鲸鱼喷水代替转一圈;交接时剩下的弧画满、圆环合上,庆祝的那次喷水、560 ms 潜下去、0.72 秒发 `handoffShow`,不庆祝的 0.22 秒。「待定」去掉问候用哪个名字,水线那一行按圆环改写;「不做什么」和「已知限制」跟着改。依据:原型的圆环布局(82 个状态的截图都过了布局探针,探针也查圆环不碰鲸鱼的话、提示行和卡片:没有问题);`ring-live.cjs`:首次启动 `handoffShow` 在就绪后 0.72 秒(原来的布局 1.09 到 1.17 秒),以后的启动 0.23 到 0.33 秒,都在原型兜底的 1.5 秒和 0.8 秒以内,45 秒的〔打开日志文件夹〕用指针点得到,搬数据那一行在,喷水的「^ ^」眼给失败的姿势让路,〔重试〕清掉红的那段弧;一次独立评审的 10 条意见都已改正(空纸面让点击穿过、卡片在时提示行隐藏、112 px 鲸鱼入场的深度 96 / 84 px、沉下去 84 px、喷水的「^ ^」眼不盖过失败的姿势、就绪以后不喷、强制颜色覆盖弧、光、水柱和水滴、弧 0.5 s 画出来等)。桌面应用里的检查(离屏 Electron、替身桥,15 项都过):首次启动 `handoffShow` 在就绪后 0.73 秒,以后的启动 0.24 秒(引擎在就绪前 0.5 秒才起来);数据阶段在页面画出来以前完成时,第一段弧 820 ms 画满,700 ms 时完成的,565 ms 进行中、999 ms 画满。真机上的首次启动(这条分支的一次性副本,装着锁定的 DSH 0.2.1-rc.4):窗口 1.5 秒出现、页面 2.9 秒画出来,第一段弧在页面时间 2.6 秒画满;引擎 17.1 秒后第二段画满,团队 4.4 秒后就绪;`handoffShow` 在就绪后 738 ms,窗口 173 ms 后开始长大,团队窗口在就绪后 1.31 秒露面,页面上没有留下的圈和已用秒数。和原型有意不同的两处:第一段弧等的时候鲸鱼不换循环(原型先换成工作的循环,循环自己要停满的 400 ms 把弧再推迟);就绪时正在走的那一拍不再走完,剩下的弧一起画满(原型让它走完;照原型写的桌面应用里,引擎在就绪前 0.5 秒起来的以后的启动 0.46 秒才发 `handoffShow`)。评审后补正:第一段弧等的时候鲸鱼不换循环(第 4 节);以后的启动前 1 秒有第一段弧画满的那一下(第 5 节);一拍走完点一下头(第 3 节);安静档点鲸鱼时照样压扁、甩尾和「^ ^」眼;浮上来的那圈涟漪 .56 s 淡完;盘不够的那句按启动的时钟算前 10 秒,入场时就在。+- 2026-10-30 跳到 Chief:维护者问「要不要加个正在做的事情的简单描述,位置上调一些,启动之后流畅变形为主页面,Chief跳到主页左侧的Chief位置」,然后「三点都做」,紧接着又说「文案保持取消状态」:所以没有加描述正在做什么的字,顺利时页面上仍然没有字(第 3 节),只做了另外两点。一是位置上调:没有卡片时整组低 45 px(原来 80 px),圆环上移 35 px,出卡片时整组上移 45 px,有卡片时不变(第 2、6 节)。二是交接时鲸鱼不再潜下去,而是跳出水面,在长大的启动窗口里飞到 Main Bot 的头像会在的位置,缩到头像的大小落下,主窗口在同一个矩形上露面(第 3、4、5、7、8、9、11 节):插件的侧栏在 `dsBotApp.ready()` 里带上 Main Bot 头像的位置(只在默认的鲸鱼、头像在团队列里看得见时),主进程用 `landingOf` 换成启动页的坐标放进交接的快照,启动页的 `leap` 飞 590 ms(不庆祝的 550 ms),比主窗口露面早 30 ms 落下,`handoffDone` 改在落下时发(庆祝的 1150 ms,不庆祝的 650 ms);没有地方落时照旧潜下去。磁贴上的鲸鱼浮上来和 `dsBotApp` 的露面事件都不做了,「待定」里那一行随之去掉:团队界面里的头像不用自己动,鲸鱼落下的地方就是它;「预览版说明」盖着侧栏时鲸鱼照样落在头像的位置上,头像在遮罩下面(第 8 节)。「长大时页面上除了 Mica 什么都不能有」改成只留飞着的鲸鱼;长大时鲸鱼可能一顿一顿地动、落点在 `ready()` 之后团队列还在动时会差几个像素,记进「已知限制」;「不做什么」跟着改。依据:应用的测试(`start-window.test.mjs`:`landingOf` 在两个窗口边框相同、团队页面缩放到 125 %、只有启动窗口有系统标题栏时都算对,不像样的报告都不落;`ready()` 带着位置时交接的快照里有 `landing`,不带时没有;`start-page.test.mjs` 查 `.flight` 层),插件的侧栏测试(`app-ready.test.js`:默认的鲸鱼报告它的位置,别的样子或照片不报)。真机上的首次启动(一次性副本,装着锁定的 DSH 0.2.1-rc.4,团队页面缩放 125%):主进程记下「the whale lands at 105, 116 (60 px)」,团队窗口露面后侧栏里 Main Bot 的头像在 (104, 116)、60 px,差 1 px;`handoffShow` 在就绪后 738 ms,窗口在它之后 171 ms 开始长大,`handoffDone` 在它之后 442 ms,团队窗口在就绪后 1.32 秒露面:这台机器上长大比 300 ms 慢,鲸鱼先落下,再跟着窗口一起长到位(两次运行,落点都一样);首次启动时「预览版说明」的遮罩盖着侧栏,头像在遮罩下面## 待定diff --cc docs/plans/2026-10-26-windows-onboarding.mdindex 68b9f1dc,be0927d5..f48cd10a--- a/docs/plans/2026-10-26-windows-onboarding.md+++ b/docs/plans/2026-10-26-windows-onboarding.md@@@ -87,33 -87,39 +87,33 @@@ Windows 是桌面应用的主要平台�| 时候 | 鲸鱼的话 | 提示行 ||---|---|---|-| 入场,还没有新消息 | 「嗨,我是{名字}」,停 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」 |+| 顺利的时候:入场、三个阶段、就绪 | 无 | 无 |+| 盘不够、又没有更好的盘 | 无 | 前 10 秒「C 盘只剩 1.2 GB」 |+| 45 秒,引擎还没起来 | 「有点久,可能是杀毒软件在查新文件」 | 只有〔打开日志文件夹〕 || 180 秒 | 「等太久了,要不要重试?」 | 无;卡片上只有〔继续等待〕〔重试〕〔打开日志文件夹〕 |- | 启动失败、团队界面没加载出来 | 「DeepSeek Bot 没能启动」「团队界面没有加载出来」 | 无 |+ | 启动失败、团队界面没加载出来 | 「DS Bot 没能启动」「团队界面没有加载出来」 | 无 || 有卡片时 | 空着,由卡片自己的第一句说(15/20、600,在已定的文字上面):推荐盘「C 盘有点挤」(盘不够)或「这里不让我放东西」(没有写入权限),「会放在…」那张「我多加了一层文件夹」,被拒绝的「这里放不了」,找不到数据文件夹「数据不在原来的地方了」;导入的几张见第 4 节;失败的卡没有 | 隐藏 |-- 话跟着鲸鱼走(停在哪一站、正在游哪一段、就绪),从不抢在它前面。每句至少能读 300 ms 才被换掉,一般停 0.9 秒(招呼 1.5 秒,「找到了」0.7 秒);中间跳过的话以后不补说。失败和 180 秒的问题马上说。「进去吧」等上一句能读满 400 ms 才上,上屏 300 ms 后开始庆祝。鲸鱼沉下去、换个新文件夹重新开始时,话和提示都空着。失败时不画叉,鲸鱼失败的姿势和那句话就是失败。一般的首次启动,用户读到的是「嗨,我是总管」→「热身中,等我一下」→「开门去了」→「进去吧」:数据文件夹这一步通常在招呼读完之前就做完了。+- 鲸鱼的话换句时淡出、淡入各 .16 s,不排队。失败时不画叉:鲸鱼失败的姿势、红的那段弧和那句话就是失败。鲸鱼沉下去、换个新文件夹重新开始时,三段弧从头开始。就绪时剩下的弧画满、圆环合上,鲸鱼喷一次水,跳出水面,落到侧栏里 Main Bot 的头像上,没有地方落时潜下去(启动窗口第 8 节)。- **一般情况下什么都不问**,用默认位置,但页面上写着放在哪、能换:底注右边一行「数据放在 C 盘(剩 412 GB)· 换个位置…」([启动窗口](2026-10-26-start-window.md) 第 2、4、6 节),什么都不点就按它走;点「换个位置…」才开系统选择框,定根和下面「一个位置」一样,定好后引擎在新文件夹重新起、鲸鱼沉下去重新开始(启动窗口第 7 节),默认位置上这一次建的文件夹删掉。重装没有这一行,导入复制完以后收起。先看是不是重装(下一条),再看要不要出位置卡片。选位置的卡片只有推荐盘这一张,它上面的按钮都已经试写通过,不会点了再被拒绝;每张卡都说明以后在哪里改:- 数据所在的盘不到 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 的数据。」,〔重新找到它…〕留着。+ - 默认位置不能用(没有写入权限):第一句换成原因「DS Bot 没有权限在 `C:\Users\<用户名>` 里写文件。」,第二句一样;按钮只有〔放到 D 盘〕和小链接「其他位置…」,没有〔仍然放在 C 盘〕。没有可推荐的盘时只有〔选择其他位置…〕。+ - 保存过的数据文件夹找不到了(多见于以后的启动):「找不到数据文件夹 `D:\DS Bot\data`。可能是移动硬盘没插上,或者文件夹被移走、删除了。旧数据不会被改动。」〔重试〕〔重新找到它…〕〔用新的空白团队开始…〕。〔重新找到它…〕不走定根的规则:选中的文件夹本身或它下面的 `data` 里有 `.ds-bot` 标记和 `bot/state.json`(所以 `~/.dsh` 永远不算),又通过位置规则(不在 DSH 的家里、不在程序目录里),就把它写成数据文件夹;旁边有 `workspace` 时总工作区一起改过去,没有就不动。否则卡上写「这里没有 DS Bot 的数据。」,〔重新找到它…〕留着。-- **重装不问。** 没有保存的位置、而 `C:\Users\<用户名>\.ds-bot` 里有团队时(重装过,或者 `%APPDATA%` 被清过),直接接着用:不出推荐盘的卡片,盘不够只在提示行写一句「C 盘只剩 1.2 GB」,要搬去 设置 → 通用 → 位置 →〔移到…〕;写不进去直接是恢复页。第 2 站的提示行写「上次的 6 个 Bot 和 2 个群聊都在」,不写路径,接模型的那句提示也不显示。旧团队登记的总工作区启动页不知道:插件启动后经 `teamWorkspaceChanged` 报告一次,应用据此写 `locations.json` 的 `workspace`。想要空白团队的人去 设置 → 通用 → 位置 →「用新的空白团队开始…」。只认默认位置:放在别处、又没有保存位置的旧数据找不到,和今天一样。+- **重装不问。** 没有保存的位置、而 `C:\Users\<用户名>\.ds-bot` 里有团队时(重装过,或者 `%APPDATA%` 被清过),直接接着用:不出推荐盘的卡片,盘不够只在提示行写一句「C 盘只剩 1.2 GB」,要搬去 设置 → 通用 → 位置 →〔移到…〕;写不进去直接是恢复页。启动页上不写上次的团队和路径,进门后就是它。旧团队登记的总工作区启动页不知道:插件启动后经 `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` 是别人的非空文件夹、在 DSH 的家里、在程序文件夹里),卡片写一句原因,〔重新选…〕作主按钮,来时那张卡的〔放到 D 盘〕〔仍然放在 C 盘〕照旧留着;选择框被取消就回到来时的卡。DSH 数据的规则只在那个文件夹真的存在时才检查。位置行的「换个位置…」走同一条路,没有来时的卡:取消就回到位置行,已经出的「会放在…」「这里放不了」也收回。选了现在的根或数据文件夹就当没选;选在现在的数据文件夹里面不行,总工作区还空着时可以成为新的根。+ - **推荐的盘**怎么来:只在数据所在的盘不到门槛(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:\DS Bot`。取剩余空间最大、而且不少于 20 GB 的一个。`X:\DS Bot` 已经存在时按下面定根的规则判断,不能用就不推荐这个盘。试写只建缺的那几层,写完删掉自己建的。PowerShell 失败、超时或被策略禁掉,都当作没有更好的盘。macOS 和 Linux 不推荐盘,空间不够只在提示行写一句。+ - **一个位置。** 用户换位置时只选一个文件夹,由它定出根 `R`:选的是磁盘根目录,`R` 是它下面的 `DS Bot`;选的文件夹不存在或是空的,`R` 就是它;选的文件夹是 DS Bot 以前的根(`data` 里有 `.ds-bot` 标记,没有团队或者只有一个没说过话的空白团队),`R` 也是它;其余非空的文件夹,`R` 是它下面的 `DS Bot`。`R` 已经存在、非空、又不是以前的根时,不能用。数据放在 `R\data`,Bot 的文件放在 `R\workspace`(子文件夹的名字待定);两者是兄弟,互不包含,和默认的 `~\.ds-bot`、`~\DS Bot` 一样是同一个父文件夹下的兄弟,所有规则不变。〔放到 D 盘〕就是 `D:\DS Bot\data` 加 `D:\DS Bot\workspace`。默认安装的路径不改(待定)。设置里也是一处:「位置」一行显示两个路径,一个〔移到…〕一起搬(第 8 节);要分开放的在「高级」里。+ - 只有点了「其他位置…」才打开系统选择框,挂在窗口上,从推荐的盘开始,没有推荐的盘就从现在的数据文件夹的上一级开始。选完先定根,`R\data` 和 `R\workspace` 都对照现在的数据文件夹和总工作区过一遍位置规则,再试写。都通过了:`R` 就是用户选的文件夹时直接用,不再确认;应用加了一层 `DS Bot` 时,同一张卡片变成「会放在 `D:\DS Bot`。」〔继续〕〔重新选…〕,只在应用改了用户选的路径时才确认。没通过(没有写入权限、在 OneDrive 里、`R` 是别人的非空文件夹、在 DSH 的家里、在程序文件夹里),卡片写一句原因,〔重新选…〕作主按钮,来时那张卡的〔放到 D 盘〕〔仍然放在 C 盘〕照旧留着;选择框被取消就回到来时的卡。DSH 数据的规则只在那个文件夹真的存在时才检查。位置行的「换个位置…」走同一条路,没有来时的卡:取消就回到位置行,已经出的「会放在…」「这里放不了」也收回。选了现在的根或数据文件夹就当没选;选在现在的数据文件夹里面不行,总工作区还空着时可以成为新的根。- 首次启动的位置检查和「移到…」用同一套规则检查定出的根:不能是整个磁盘、不能是别人的非空文件夹,外加一次试写。- - `locations.json` 只在引擎第一次成功启动(`ready`)、导入问题也答完之后才写。同时写一份 UTF-16LE 的 `locations.ini` 给卸载程序读。应用自己新建的数据文件夹里放一个不含任何机密的 `.deepseek-bot` 标记,这个标记在建文件夹时就写、不等 `ready`:首次启动没走完就退出时,留下的文件夹下次才认得出是自己建的(定根规则里的「以前的根」),不会被当成别人的非空文件夹。「首次启动没走完就退出时什么都不记」的规则不变:记的只是 `locations.json`。每次启动先删掉上次留下的暂存(路径记在 `%APPDATA%` 里,加上数据文件夹里所有的 `.import-*` 和 `.import-check-*`)。+ - `locations.json` 只在引擎第一次成功启动(`ready`)、导入问题也答完之后才写。同时写一份 UTF-16LE 的 `locations.ini` 给卸载程序读。应用自己新建的数据文件夹里放一个不含任何机密的 `.ds-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 行,已脱敏)。-- **启动失败**时,启动页当场变成恢复页(不再等 GitHub、不再隐藏窗口、不再弹英文「Error」框):鲸鱼那一行写「DS Bot 没能启动」,不说俏皮话,下面一句对应的原因(没有写入权限 / 磁盘空间不够 / 程序文件不完整,可能被杀毒软件拦掉了一部分 / 本机引擎启动到一半停下了 / 出了点意外),每种都给〔重试〕〔换个位置…〕〔用新的空白团队开始…〕〔打开日志文件夹〕〔复制详细信息〕(换位置按第 3 节定根的规则,数据和总工作区一起搬,搬的规则同第 8 节:同一个卷上改名,不同的卷上复制完再删旧的;还没有团队时只是换个空文件夹),再加一个「详细信息」折叠区(日志最后 200 行,已脱敏)。++- **启动失败**时,启动页当场变成恢复页(不再等 GitHub、不再隐藏窗口、不再弹英文「Error」框):鲸鱼那一行写「DS Bot 没能启动」(卡住的那段弧变红),不说俏皮话,下面一句对应的原因(没有写入权限 / 磁盘空间不够 / 程序文件不完整,可能被杀毒软件拦掉了一部分 / 本机引擎启动到一半停下了 / 出了点意外),每种都给〔重试〕〔换个位置…〕〔用新的空白团队开始…〕〔打开日志文件夹〕〔复制详细信息〕(换位置按第 3 节定根的规则,数据和总工作区一起搬,搬的规则同第 8 节:同一个卷上改名,不同的卷上复制完再删旧的;还没有团队时只是换个空文件夹),再加一个「详细信息」折叠区(日志最后 200 行,已脱敏)。- 启动超过 180 秒:鲸鱼问「等太久了,要不要重试?」,卡片上只有〔继续等待〕〔重试〕〔打开日志文件夹〕,引擎同时继续启动。- - 后台更新器发现了新版本时,恢复页上显示「DeepSeek Bot {版本} 已经发布,可能修好了这个问题。」〔下载并安装〕,带下载百分比和「下载太慢?手动下载」(打开镜像页)。+ - 后台更新器发现了新版本时,恢复页上显示「DS Bot {版本} 已经发布,可能修好了这个问题。」〔下载并安装〕,带下载百分比和「下载太慢?手动下载」(打开镜像页)。- 引擎起来了但 DS Bot 界面 20 秒内没报告就绪(ds-bot 在界面挂载完成后调用 `dsBotApp.ready()`):回到启动页,显示「团队界面没有加载出来」〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕。- 首次启动期间再双击图标:恢复并聚焦已有窗口,失败页上也一样。- 建窗口不再依赖「下载」文件夹:每次下载时才取它的位置,取不到就用家目录,再不行就不给默认位置,让用户自己选。- - 日志:`%APPDATA%\DeepSeek Bot\logs\main.log`,2 MB × 3 份轮换,收主进程和引擎的输出;写之前去掉 `token=…`、`sk-…` 和 `/oauth/callback?…` 的查询部分,把用户文件夹的完整路径(如 `C:\Users\<用户名>`)换成 `%USERPROFILE%`。+ - 日志:`%APPDATA%\DS 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 节,待定),其余不变;新增的这些只在引擎的页面上、只对主窗口的主框架暴露。主进程对两者分别做精确的来源检查。+- 启动页是纯 DOM,CSP `default-src 'self'`;颜色取 [UI 标准](../design/ui-standard.md) 2.1 节 DeepSeek 主题的值,字号用标准里的 13 / 14 / 15 px。它只拿到 `dsBotStart`(`onState`、`act`),只在页面地址正好是启动页文件时才暴露。引擎页面上的 `dsBotApp` 只新增 `ready()`(上面的 20 秒检查;它同时带上 Main Bot 的头像在页面上画在哪里,给启动窗口的鲸鱼落脚,[启动窗口](2026-10-26-start-window.md) 第 8 节)、`focus()`(第 5 节退回系统浏览器登录时回到前台)、`signIn`(第 5 节的登录窗口:`onClosed(原因, 代理)`、`close()`、`openOutside`)和 `foundKeys()` / `takeKey()`(第 5 节现成的 Key),其余不变;新增的这些只在引擎的页面上、只对主窗口的主框架暴露。主进程对两者分别做精确的来源检查。- `DS_BOT_HOME` 的一次性运行照旧:不问、不导入,但也显示启动页和失败页。### 4. 已有 DSH 团队:导入卡@@@ -289,7 -295,7 +289,7 @@@### 用词- - 一个东西一个名字:DeepSeek Bot(应用)、DS Bot(项目和插件)、DeepSeek Harness(底层;界面里只在讲它本身时出现:导入和复制团队、设置卡里的现成 Key(那一行和「不能用」的提示)、它的沙盒问题、「高级设置(DeepSeek Harness)」)、本机引擎(启动页上对应用启动的 DSH 的叫法)、鲸鱼的话(启动页上鲸鱼下面那一行字,只在 45 秒、180 秒、失败和搬数据时有,一次一句)、圆环(启动页上围着鲸鱼的那一圈,由三段弧组成,一段一个阶段,就绪时合成一整圈)、弧(圆环的一段)、登录窗口(桌面应用里登录 DeepSeek 账号的子窗口)、目标卡、建议卡、第一件事卡(第 6 节上手的三张卡)、主 Bot(Main Bot)、群聊、总管(中文界面里第一个 Main Bot 的默认名字,待定)、模型、API Key、DeepSeek 账号、提供商、位置(设置项的名字,里面是数据文件夹和总工作区)、数据文件夹、总工作区。-- 一个东西一个名字:DS Bot(应用)、DS Bot(项目和插件)、DeepSeek Harness(底层;界面里只在讲它本身时出现:导入和复制团队、设置卡里的现成 Key(那一行和「不能用」的提示)、它的沙盒问题、「高级设置(DeepSeek Harness)」)、本机引擎(启动页上对应用启动的 DSH 的叫法)、鲸鱼的话(启动页上鲸鱼下面那一行字,一次一句)、圈(鲸鱼离开一站后留在水线上的细线椭圆)、登录窗口(桌面应用里登录 DeepSeek 账号的子窗口)、目标卡、建议卡、第一件事卡(第 6 节上手的三张卡)、主 Bot(Main Bot)、群聊、总管(中文界面里第一个 Main Bot 的默认名字,待定)、模型、API Key、DeepSeek 账号、提供商、位置(设置项的名字,里面是数据文件夹和总工作区)、数据文件夹、总工作区。++- 一个东西一个名字:DS Bot(应用)、DS Bot(项目和插件)、DeepSeek Harness(底层;界面里只在讲它本身时出现:导入和复制团队、设置卡里的现成 Key(那一行和「不能用」的提示)、它的沙盒问题、「高级设置(DeepSeek Harness)」)、本机引擎(启动页上对应用启动的 DSH 的叫法)、鲸鱼的话(启动页上鲸鱼下面那一行字,只在 45 秒、180 秒、失败和搬数据时有,一次一句)、圆环(启动页上围着鲸鱼的那一圈,由三段弧组成,一段一个阶段,就绪时合成一整圈)、弧(圆环的一段)、登录窗口(桌面应用里登录 DeepSeek 账号的子窗口)、目标卡、建议卡、第一件事卡(第 6 节上手的三张卡)、主 Bot(Main Bot)、群聊、总管(中文界面里第一个 Main Bot 的默认名字,待定)、模型、API Key、DeepSeek 账号、提供商、位置(设置项的名字,里面是数据文件夹和总工作区)、数据文件夹、总工作区。- 「输入稿」是输入框里还没发出的文字(DSH 叫 draft,`setDraft`)。- 本文里「引擎」指桌面应用启动的 DSH 子进程,「引擎的页面」是它提供的网页前端;「Host」只指插件的 `ds-bot/src/host`。- 第一次介绍产品的地方都写「不是 DeepSeek 官方产品」。@@@ -337,14 -343,9 +337,14 @@@| 同上 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 节鲸鱼的话 |- | 本文 第 3 节「团队界面没有加载出来。」、「会放在 `D:DeepSeek Bot`」〔继续〕〔重新选〕;第 4 节 更新版本那张卡的脚注「可以在 设置 → 通用 → 位置 里再复制。」;第 8 节「比平时慢,请再等一会儿。」 | 「团队界面没有加载出来」(鲸鱼那一行不加句号);「会放在 `D:DeepSeek Bot`。」〔继续〕〔重新选…〕(正文带句号,打开选择框的按钮带 …);「以后可以在 设置 → 通用 → 位置 里复制。」;「比平时慢,请再等一会儿」(提示行不加句号)。按 [启动页文案](2026-10-29-start-copy.md) 的层规则 |+ | 本文 第 3 节「团队界面没有加载出来。」、「会放在 `D:DS Bot`」〔继续〕〔重新选〕;第 4 节 更新版本那张卡的脚注「可以在 设置 → 通用 → 位置 里再复制。」;第 8 节「比平时慢,请再等一会儿。」 | 「团队界面没有加载出来」(鲸鱼那一行不加句号);「会放在 `D:DS Bot`。」〔继续〕〔重新选…〕(正文带句号,打开选择框的按钮带 …);「以后可以在 设置 → 通用 → 位置 里复制。」;「比平时慢,请再等一会儿」(提示行不加句号)。按 [启动页文案](2026-10-29-start-copy.md) 的层规则 || 本文首稿 §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 的工具受限,步骤由卡片的回答推进 |- | 本文 2026-10-28 §3「鲸鱼就是进度」:88 px 的鲸鱼在水线上从第 1 站游到第 3 站,离开的站留一个圈;「已用 N 秒」5 秒起在右上方,一直留到「进去吧」 | 112 px 的鲸鱼一直在中间,围着它的三段弧就是进度,就绪时合成一整圈;不显示已用秒数([启动窗口](2026-10-26-start-window.md) 第 2、3 节,那里记过这一行)。维护者 2026-10-30 转来一段讨论,说启动窗口太吵(「现在这版有点噪了」「是不是可以简约一点」),比较水线分三段的进度条、圆环和只有鲸鱼三份草稿后选了圆环 |++| 本文 2026-10-28 §3「鲸鱼就是进度」:88 px 的鲸鱼在水线上从第 1 站游到第 3 站,离开的站留一个圈;「已用 N 秒」5 秒起在右上方,一直留到「进去吧」 | 112 px 的鲸鱼一直在中间,围着它的三段弧就是进度,就绪时合成一整圈;不显示已用秒数([启动窗口](2026-10-26-start-window.md) 第 2、3 节,那里记过这一行)。维护者 2026-10-30 转来一段讨论,说启动窗口太吵(「现在这版有点噪了」「是不是可以简约一点」),比较水线分三段的进度条、圆环和只有鲸鱼三份方案后选了圆环 |+| 同上「文字都是鲸鱼在说,一次一句短话」和首次启动的话和提示那张表:问候「嗨,我是{名字}」,「先找个地方放东西」「找到了」「热身中,等我一下」「第一次会慢一点」「开门去了」「进去吧」;提示行的「待会儿要接一个模型:DeepSeek 账号或 API Key」「里面先有一页说明,点「继续」就行」「上次的 6 个 Bot 和 2 个群聊都在」;「取舍」的「期间在启动页上先提醒一句」;验收里话的顺序、300 ms 的停留和第 2 站的提示 | 顺利时没有字:鲸鱼只在 45 秒、180 秒和失败时说话,提示行只有盘不够时前 10 秒的那句和 45 秒起的〔打开日志文件夹〕;就绪时圆环合上,鲸鱼喷水、潜下去;验收跟着改。讨论里:「其实我觉得可能就放一个鲸鱼就够,然后可以做交互动画,文字什么的不太需要」。接模型由进门后的设置卡说,预览版说明自己有〔继续〕,重装进门就是原来的团队:这几句都不是等不了的事 |+| 本文 2026-10-28 §8 以后的启动「64 px 的鲸鱼和『正在打开你的团队…』」,10 秒起「已用 N 秒」,45 秒「比平时慢,请再等一会儿」在提示行 | 和首次启动同一个样子(112 px 的鲸鱼、圆环、水线),顺利时没有字;45 秒起鲸鱼说「比平时慢,请再等一会儿」,提示行只有〔打开日志文件夹〕;就绪时不庆祝,圆环合上、鲸鱼潜下去([启动窗口](2026-10-26-start-window.md) 第 5 节)。圆环已经说了在打开,以后的启动只要 3 到 12 秒 |+| 本文 2026-10-28:首次启动 `handoffShow` 约 1.1 秒、主窗口约 1.6 秒可见,以后的启动约 0.6 秒;验收从鲸鱼停到第 3 站算,`handoffShow` 1.3 秒内、主窗口 2 秒内(鲸鱼还在游的最多各晚 600 ms) | 庆祝的交接(首次启动,重试或重新开始后第一次成功)`handoffShow` 在就绪后 0.72 秒、主窗口约 1.2 秒可见;其余以后的启动 0.22 秒、约 0.7 秒;兜底不变(2.5 秒、0.8 秒)。验收从 `ready()` 算(入场还没到位时从到位算):庆祝的交接 `handoffShow` 1 秒内、主窗口 1.5 秒内,其余 0.5 秒内、1 秒内。没有「进去吧」要读,交接不再等字,也没有排队的游动 |+| 本文 2026-10-28 §5「桌面应用首次启动交接后,Main Bot 的鲸鱼在侧栏的磁贴上浮上来一次」,§3 `dsBotApp` 列表里「主窗口露面时发给页面的一个事件」(待定);§3、§8 就绪时鲸鱼潜下去 | 交接时启动窗口的鲸鱼跳出水面,落到侧栏里 Main Bot 的头像上,主窗口露面时头像正好在它下面,每种启动都这样;头像的位置随 `ready()` 带来,没有露面事件,磁贴上的鲸鱼不另做动画;没有地方落时照旧潜下去([启动窗口](2026-10-26-start-window.md) 第 8 节,那里记过这一行)。维护者 2026-10-30:「启动之后流畅变形为主页面,Chief跳到主页左侧的Chief位置」 |实现各批时,同步改写上面几份文档里对应的规则本身(「已定的行为」写现在的行为,不只是在末尾追加),并在它们的「变更」里写一条;新的 DSH 让步记进 [DSH 让步总账](2026-10-13-dsh-concessions.md),「提供商」记进 [UI 标准](../design/ui-standard.md) 第 11 节的术语表。@@@ -376,19 -377,19 +376,19 @@@| 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 聊天里的第一条回复 | 设置卡:登录窗口(应用:接住 `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 窗口先出来:启动页、卡片和恢复页 | 启动页(鲸鱼即进度:三站的位置和圈、一次一句鲸鱼的话和它的节奏、提示行、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) |+| M4 窗口先出来:启动页、卡片和恢复页 | 启动页(圆环即进度:三段弧和合上的整圈、只在要用户知道时说的话、提示行、点鲸鱼喷水、读屏的「启动进度」列表、卡片的第一句)、鲸鱼更有反应的九种动作(探身、呼吸、眨眼、回到窗口时看你、眼睛跟着键盘焦点、按下预备、活泼档越跳越稀、潜得更深、张望)、它的 IPC 和来源检查、中英文案;`main.mjs` 重排;交接时启动窗口长成主窗口(主窗口先隐藏着建在最终的矩形上,主进程约 300 ms 里逐步 `setBounds`,主窗口在同一个矩形上露面,首次启动 2.5 秒的兜底)、鲸鱼跳到侧栏 Main Bot 的头像上(侧栏在 `ready()` 里报头像的位置,[启动窗口](2026-10-26-start-window.md) 第 8 节)和磁贴上的鲸鱼(设置卡驱动它的状态动作,第 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 人日 |+ | M6 第一个小时和回头入口 | 系统代理和网络设置;沙盒失败提示(#523);PowerShell 5.1 说明;GitHub 代理提示;关窗提醒(#500);保存诊断信息;「DS Bot 应用」形态;设置里「位置」一处〔移到…〕一起搬、「高级」里分开换;「用新的空白团队开始」 | 约 4 人日 || M7 签名 | 签名钩子、`publisherName`;README 的信任说明缩成杀毒软件一条;winget 清单 | 约 2–3 人日,加外部审批 |## 验收- 打包后的 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` 时主窗口直接出现。+- 启动页(同一个 CI,中英文各一遍):首次启动没有标题、阶段名和说明段落;顺利的启动里鲸鱼的话和提示行一直空着(例外是盘不够时前 10 秒的「C 盘只剩 1.2 GB」),三段弧依次画满;45 秒时只有鲸鱼那一句和〔打开日志文件夹〕,按钮用指针点得到;在 720 × 540 和 720 × 500 下没有一行字折行或被省略号截断,圆环不碰鲸鱼的话、提示行和卡片,页面不能滚动;读屏的「启动进度」列表和朗读区照旧报阶段。+- 交接:从 `ready()` 到达算(入场还没到位时从到位算),庆祝的交接(首次启动,重试或重新开始后第一次成功)`handoffShow` 在 1 秒内(原型实测 0.72 秒),其余以后的启动在 0.5 秒内(0.23 到 0.33 秒);启动窗口在约 300 ms 里至少经过一个中间尺寸,长到主窗口的矩形;主窗口在庆祝的交接里 1.5 秒内可见、其余 1 秒内,矩形和启动窗口长成的一样;页面不发 `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 盘上没有留下试写建的文件夹。+ - 数据所在的盘不够 5 GB(CI 用替身的空间查询):只有一张卡片、一个主按钮,按 Enter 就过,不出现系统选择框。枚举盘的 PowerShell 只在盘不够或默认位置不能用时运行一次,正常启动和重装的日志里没有它;没有剩余 20 GB 以上的其他固定盘时不出卡片,提示行写剩余空间。〔放到 D 盘〕之后 `D:\DS Bot\data` 和 `D:\DS Bot\workspace` 都存在,`locations.json` 指向它们;〔仍然放在 C 盘〕之后 D 盘上没有留下试写建的文件夹。-- 有 `~/.ds-bot` 团队、没有 `locations.json` 的一次性用户:没有卡片,C 盘不到 5 GB 时也没有,第 2 站的提示行写「上次的 N 个 Bot 和 N 个群聊都在」(数字是那个团队的),进去就是原来的团队。+- 有 `~/.ds-bot` 团队、没有 `locations.json` 的一次性用户:没有卡片,C 盘不到 5 GB 时也没有,启动页上不写团队的数字,进去就是原来的团队。- 导入:点〔复制过来〕后,对话复制完团队就打开,`bot/work-files.json` 记着工作文件没复制完;工作文件在后台到齐后记成已完成;复制一半退出再启动会接着复制,已有的文件一个不覆盖;〔先不复制〕不重启引擎,暂存已删。- 空间只占一份(CI 用替身的空间查询和一个 2 GB 的假团队):整个导入过程中数据所在的盘最多少掉「第一段 + 500 MB」,没有 `.import-check-*` 文件夹,`~/.dsh` 的内容和修改时间一个都没变;工作文件复制完后新旧两处各一份,设置里显示原团队的位置和大小;剩余空间降到 500 MB 以下时后台复制停下,设置里有〔继续复制〕。导入卡开着、DSH 还占着团队时数据文件夹里没有 `.import-*`,锁放开后才出现;暂存期间锁刷新过,暂存会重做;导入卡开着时关窗、更新重开,下次启动前暂存已删。- 〔移到…〕同一个卷:完成不超过 2 秒,旧路径不存在,数据没有被复制(inode 不变);改名失败时退回到复制;不同的卷:新引擎 `ready` 后旧数据文件夹被删,工作文件逐个落位后原件被删,复制完旧总工作区里只剩跳过的文件,数量和设置里写的一致;用户自己挑的总工作区一个文件都不动;新引擎没 `ready` 或中途被杀掉时,下次启动退回原位置,`R` 下面没有留下应用建的东西,`locations.json` 不变。@@@ -492,7 -493,5 +492,7 @@@- 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 留余量。- - 2026-10-28(第二次):落地 M4 第一批时维护者看到首次启动仍弹「欢迎使用 DeepSeek Bot」的系统对话框(「我主要不喜欢这个」),要求「给出建议,同时提供自行选择的接口,避免小弹窗」:§3 的「什么都不问」补上启动页底注右边的位置行「数据放在 C 盘(剩 412 GB)· 换个位置…」,点了才开系统选择框,定根和「一个位置」一样,被拒绝的原因加上 DSH 的家和程序文件夹,定好后引擎在新文件夹重新起(启动窗口稿第 2、4、6、7 节);验收加一条。导入问题在 M5 的导入卡落地前仍是挂在启动窗口上的对话框。- - 2026-10-29:启动页的文案分层,写进 [启动页文案](2026-10-29-start-copy.md);按各层的写法规则改了本文引用的四处:§3「团队界面没有加载出来」、§8 45 秒的「比平时慢,请再等一会儿」去句号,§3「会放在 `D:\DeepSeek Bot`。」加句号、〔重新选…〕加 …(被拒绝的卡也一样),§4 更新版本那张卡的脚注改成「以后可以在 设置 → 通用 → 位置 里复制。」,和「以后可以在 … 里改。」同一个句式;「用词」加一条指向它。- - 2026-10-30:维护者转来一段讨论,说启动窗口太吵(「现在这版有点噪了」「是不是可以简约一点」「其实我觉得可能就放一个鲸鱼就够,然后可以做交互动画,文字什么的不太需要」),提议只留一只浮在水上、点一下会喷水的鲸鱼,进度做成横条或圆环;比较三份草稿(水线分三段的进度条、圆环、只有鲸鱼)后选了圆环。§3 的启动页改成「圆环就是进度」和「顺利时没有字」,话和提示的表只剩盘不够、45 秒、180 秒、失败和卡片;重装、接模型和预览版说明不在启动页上提前说(「取舍」和已知限制跟着改);§8 以后的启动和首次启动同一个样子,没有字;「用词」的圈换成圆环和弧,鲸鱼的话只在这几种时候有;验收(启动页、交接、重装)、M4、「待定」的水线和已知限制里的露面时间跟着改。细节在 [启动窗口](2026-10-26-start-window.md) 同一天的变更里。依据:原型的圆环布局(82 个状态的截图都过了布局探针,没有问题)和 `ring-live.cjs`(首次启动 `handoffShow` 在就绪后 0.72 秒,原来 1.09 到 1.17 秒;以后的启动 0.23 到 0.33 秒)。评审后补正:M4 写九种动作,补上 2026-10-28 加的张望,估计里的布局一项改叫圆环即进度。+ - 2026-10-28(第二次):落地 M4 第一批时维护者看到首次启动仍弹「欢迎使用 DS Bot」的系统对话框(「我主要不喜欢这个」),要求「给出建议,同时提供自行选择的接口,避免小弹窗」:§3 的「什么都不问」补上启动页底注右边的位置行「数据放在 C 盘(剩 412 GB)· 换个位置…」,点了才开系统选择框,定根和「一个位置」一样,被拒绝的原因加上 DSH 的家和程序文件夹,定好后引擎在新文件夹重新起(启动窗口稿第 2、4、6、7 节);验收加一条。导入问题在 M5 的导入卡落地前仍是挂在启动窗口上的对话框。+ - 2026-10-29:启动页的文案分层,写进 [启动页文案](2026-10-29-start-copy.md);按各层的写法规则改了本文引用的四处:§3「团队界面没有加载出来」、§8 45 秒的「比平时慢,请再等一会儿」去句号,§3「会放在 `D:\DS Bot`。」加句号、〔重新选…〕加 …(被拒绝的卡也一样),§4 更新版本那张卡的脚注改成「以后可以在 设置 → 通用 → 位置 里复制。」,和「以后可以在 … 里改。」同一个句式;「用词」加一条指向它。++- 2026-10-30:维护者转来一段讨论,说启动窗口太吵(「现在这版有点噪了」「是不是可以简约一点」「其实我觉得可能就放一个鲸鱼就够,然后可以做交互动画,文字什么的不太需要」),提议只留一只浮在水上、点一下会喷水的鲸鱼,进度做成横条或圆环;比较三份方案(水线分三段的进度条、圆环、只有鲸鱼)后选了圆环。§3 的启动页改成「圆环就是进度」和「顺利时没有字」,话和提示的表只剩盘不够、45 秒、180 秒、失败和卡片;重装、接模型和预览版说明不在启动页上提前说(「取舍」和已知限制跟着改);§8 以后的启动和首次启动同一个样子,没有字;「用词」的圈换成圆环和弧,鲸鱼的话只在这几种时候有;验收(启动页、交接、重装)、M4、「待定」的水线和已知限制里的露面时间跟着改。细节在 [启动窗口](2026-10-26-start-window.md) 同一天的变更里。依据:原型的圆环布局(82 个状态的截图都过了布局探针,没有问题)和 `ring-live.cjs`(首次启动 `handoffShow` 在就绪后 0.72 秒,原来 1.09 到 1.17 秒;以后的启动 0.23 到 0.33 秒)。评审后补正:M4 写九种动作,补上 2026-10-28 加的张望,估计里的布局一项改叫圆环即进度。+- 2026-10-30 跳到 Chief:维护者要「启动之后流畅变形为主页面,Chief跳到主页左侧的Chief位置」。交接时启动窗口的鲸鱼不再潜下去,而是跳出水面,落到侧栏里 Main Bot 的头像上,主窗口在同一个矩形上露面(§3、§5、§8、M4);`ready()` 同时带上 Main Bot 头像的位置,主窗口露面的事件不做了(§3 的 `dsBotApp` 列表),磁贴上的鲸鱼也不另浮上来(§5),「改动的已定设计」加一行,§3 那一行记录补一句;文件头的「一起改」和已知限制里露面时间那一条的说法跟着改。同一次提的「正在做的事情的简单描述」随后被维护者收回(「文案保持取消状态」),启动页顺利时仍然没有字。细节和依据在 [启动窗口](2026-10-26-start-window.md) 同一天「跳到 Chief」那条变更里。diff --cc docs/plans/2026-10-29-start-copy.mdindex 13139512,7299b3f3..6b0c5a26--- a/docs/plans/2026-10-29-start-copy.md+++ b/docs/plans/2026-10-29-start-copy.md@@@ -166,12 -165,9 +166,12 @@@| 启动窗口稿第 6 节:「…在 OneDrive 里,同步会打断正在写入的聊天记录。」 | 「…正在写入的对话。」 | 一个东西一个名字 || 上手流程第 4 节:更新版本那张卡的脚注「可以在 设置 → 通用 → 位置 里再复制。」 | 「以后可以在 设置 → 通用 → 位置 里复制。」 | 和「以后可以在 … 里改。」同一个句式 || `first-run.mjs`:导入对话框〔复制〕〔不复制〕〔不带团队开始〕 | 〔复制过来〕〔先不复制〕〔先不带团队开始〕 | 和导入卡同一种写法;对话框只到导入卡落地(M5)为止 |- | `first-run.mjs`:「DeepSeek Harness 里有一个 Bot 团队:6 个 Bot、2 个群。」「会复制 Bot、群、记忆、对话、文件、密钥和模型设置。」 | 「DeepSeek Harness 里有 6 个 Bot 和 2 个群聊。要复制到 DeepSeek Bot 吗?」「会复制 Bot、群聊、记忆、对话、附件、模型设置和 API Key。…」 | 群聊、附件、API Key 是定下的名字 |+ | `first-run.mjs`:「DeepSeek Harness 里有一个 Bot 团队:6 个 Bot、2 个群。」「会复制 Bot、群、记忆、对话、文件、密钥和模型设置。」 | 「DeepSeek Harness 里有 6 个 Bot 和 2 个群聊。要复制到 DS Bot 吗?」「会复制 Bot、群聊、记忆、对话、附件、模型设置和 API Key。…」 | 群聊、附件、API Key 是定下的名字 || 桌面应用稿 安装和更新、`updates.mjs`:更新框的〔稍后〕 | 〔先不重启〕〔先不下载〕 | 稍后是过程词,UI 标准第 11 节 || `main.mjs`:搬数据被拒绝的框只有英文的〔OK〕 | 〔确定〕/〔OK〕按语言 | 表以外不再有用户看得到的字 |+| 本文第 3 节:`voice.hello / helloName / helloBack / data / found / engine / slow10 / team / ready` 不动,`title.later` → `voice.opening`;`hint.model / preview / reinstall` 不动;`elapsed` → `status.elapsed`;第 2 节「「待会儿要接一个模型」……留着」 | 这 14 个键都没有了(`voice` 十个、`hint` 三个、`status` 一个),那句说明也去掉 | 启动窗口的样子换成圆环([启动窗口](2026-10-26-start-window.md)「改动的已定设计」里 2026-10-30 的几行):顺利时不说话,不显示已用秒数,不提前说进门以后的事。维护者 2026-10-30 转来的讨论:「现在这版有点噪了」「其实我觉得可能就放一个鲸鱼就够,然后可以做交互动画,文字什么的不太需要」 |+| 本文第 3 节:`slow.45.later` → `hint.slowLater`「比平时慢,请再等一会儿」,在提示行 | `voice.slowLater`,同一句 | 以后的启动和搬数据时,45 秒起这一句由鲸鱼说,和首次启动的 `voice.slow45` 在同一行;提示行只留〔打开日志文件夹〕 |+| 本文第 2 节 `status.*`「只给读屏和计数」 | 只给读屏 | 启动页不显示已用秒数 |## 不做什么diff --cc ds-bot/client.jsindex 1b9115a9,cd6415bd..7fba6fdd--- a/ds-bot/client.js+++ b/ds-bot/client.js@@@ -9603,11 -10387,11 +10387,11 @@@ function TeamSidebar(props)const main = roster.byId[roster.mainBotId];useListGlide(listRef, wideContent, order.map((entry) => entry.item.id).join(","));useLandOnMainBot(roster, useSessions, actions);- useReportReady(roster.ready);+ useReportReady(roster.ready, roster);const openWidth = drag?.width ?? frameSnap.sidebarWidth;- const ourWidth = mode === "rail" ? RAIL_WIDTH : openWidth;+ const ourWidth = shown === "rail" ? RAIL_WIDTH : openWidth;const pushed = mode === "open" ? openWidth : mode === "hidden" ? 0 : RAIL_WIDTH;- (0, import_react18.useLayoutEffect)(() => {+ (0, import_react21.useLayoutEffect)(() => {if (typeof document === "undefined") return;chatRoom.setLeft(Math.max(0, pushed - (frameSnap.collapsedWidth ?? 0)));}, [pushed, frameSnap.collapsedWidth]);@@@ -10139,35 -10974,13 +10974,35 @@@ function AccountLauncher({ seat = true);}var readyReported = false;-function useReportReady(drawn) {+function useReportReady(drawn, roster) {- (0, import_react18.useEffect)(() => {+ (0, import_react21.useEffect)(() => {if (!drawn || readyReported) return;readyReported = true;- void Promise.resolve().then(() => globalThis.dsBotApp?.ready?.()).catch(quietly("app ready"));+ void Promise.resolve().then(() => {+ const ready = globalThis.dsBotApp?.ready;+ if (typeof ready !== "function") return void 0;+ let place;+ try {+ place = mainAvatarPlace(roster);+ } catch {+ place = void 0;+ }+ return place === void 0 ? ready() : ready(place);+ }).catch(quietly("app ready"));}, [drawn]);}+function mainAvatarPlace(roster) {+ const main = roster?.byId?.[roster.mainBotId];+ if (main === void 0 || main.avatar?.image || typeof document === "undefined") return void 0;+ const look = lookOf(main);+ if (look.shape !== MAIN_LOOK.shape || look.color !== MAIN_LOOK.color) return void 0;+ const id = typeof CSS !== "undefined" && CSS.escape ? CSS.escape(main.id) : main.id;+ const mark = document.querySelector(`.bt-side [data-bot-id="${id}"] .bt-mark`);+ if (!mark || mark.checkVisibility?.({ visibilityProperty: true }) === false) return void 0;+ const box = mark.getBoundingClientRect();+ const view = document.documentElement;+ return { x: box.left, y: box.top, width: box.width, height: box.height, viewportWidth: globalThis.innerWidth ?? view.clientWidth, viewportHeight: globalThis.innerHeight ?? view.clientHeight };+}function useLandOnMainBot(roster, useSessions, actions) {const mainView = useSessions((list) => {const row = Object.values(list.byId).find((session) => (session?.retainedBy?.mainView ?? 0) > 0);