Skip to content

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

Merge feat/windows-onboarding-m5-11-four-arc-import into feat/windows-onboarding-m5-12-error-pages

AdamPlatin123a9625d29dfbd
diff --cc app/src/start/text.mjs
index 1620bd2b,52adc9ab..8c5b42a2
--- a/app/src/start/text.mjs
+++ b/app/src/start/text.mjs
@@@ -56,13 -56,10 +56,13 @@@ export const TEXT =
'card.import.optSkipWork': '先不复制工作文件',
'card.importSpace.lead': '空间不够:复制要约 {need},{drive} 盘只剩 {free},还差 {short}。',
'card.inUse.lead': '请完全退出 DSH Desktop(任务栏右下角的托盘图标也要退出),并关掉 DSH Web,这里会自动继续。',
- 'card.newerUpdating.lead': 'DeepSeek Bot {version} 能读它们,正在下载({p}%)。装好后会重新打开,再复制团队。',
- 'card.newer.lead': '这些对话是更新版本的 DeepSeek Harness 写的,DeepSeek Bot 现在读不了。',
+ 'card.newerUpdating.lead': 'DS Bot {version} 能读它们,正在下载({p}%)。装好后会重新打开,再复制团队。',
+ 'card.newer.lead': '这些对话是更新版本的 DeepSeek Harness 写的,DS Bot 现在读不了。',
'card.importFailed.lead': '团队没有复制完:{reason}。DeepSeek Harness 里的团队没有变化。',
+ 'card.importFailed.do': '可以重试,或者先不带团队开始,以后在 设置 → 通用 → 位置 里再复制。',
+ 'card.viewFailed.lead': '引擎已经起来了,但团队界面 20 秒内没有画出来。',
+ 'card.viewFailed.do': '重新载入一次;还不行,就复制详细信息去反馈。',
- 'card.update.available': 'DeepSeek Bot {version} 已经发布,可能修好了这个问题。',
+ 'card.update.available': 'DS Bot {version} 已经发布,可能修好了这个问题。',
'card.update.downloading': '正在下载 {version}({p}%,{a}/{b} MB)',
'card.update.installing': '正在安装,装好后会重新打开。',
'card.update.failed': '下载失败。',
@@@ -82,13 -79,6 +82,13 @@@
'reason.start.files': '程序文件不完整,可能被杀毒软件拦掉了一部分。',
'reason.start.engine': '本机引擎启动到一半停下了。',
'reason.start.other': '出了点意外。',
+ 'reason.start.missing': '找不到放数据的文件夹,可能是移动硬盘没插上。',
+ 'card.failed.do.permission': '给这个文件夹写入权限后重试。',
+ 'card.failed.do.space': '清理出一些空间后重试。',
- 'card.failed.do.files': '重新安装 DeepSeek Bot 后再打开。',
++ 'card.failed.do.files': '重新安装 DS Bot 后再打开。',
+ 'card.failed.do.engine': '先重试一次;还不行,就复制详细信息去反馈。',
+ 'card.failed.do.other': '先重试一次;还不行,就复制详细信息去反馈。',
+ 'card.failed.do.missing': '插上那块硬盘,或者把文件夹放回原处后重试。',
'reason.copy.inUse': '文件被别的程序占用',
'reason.copy.permission': '没有权限读取',
'reason.copy.full': '磁盘满了',
@@@ -238,13 -228,10 +238,13 @@@
'card.import.optSkipWork': 'Don’t copy work files yet',
'card.importSpace.lead': 'Not enough space: the copy needs about {need}, drive {drive} has {free} left, {short} short.',
'card.inUse.lead': 'Quit DSH Desktop completely (its tray icon at the bottom right of the taskbar too) and close DSH Web; this continues by itself.',
- 'card.newerUpdating.lead': 'DeepSeek Bot {version} can read them and is downloading ({p}%). After installing it reopens and copies the team.',
- 'card.newer.lead': 'These chats were written by a newer DeepSeek Harness, which DeepSeek Bot can’t read yet.',
+ 'card.newerUpdating.lead': 'DS Bot {version} can read them and is downloading ({p}%). After installing it reopens and copies the team.',
+ 'card.newer.lead': 'These chats were written by a newer DeepSeek Harness, which DS Bot can’t read yet.',
'card.importFailed.lead': 'The team wasn’t fully copied: {reason}. The team in DeepSeek Harness is unchanged.',
+ 'card.importFailed.do': 'Try again, or start without the team and copy it later in Settings → General → Location.',
+ 'card.viewFailed.lead': 'The engine is up, but the team view didn’t draw within 20 seconds.',
+ 'card.viewFailed.do': 'Reload it; if it still doesn’t show, copy the details and report it.',
- 'card.update.available': 'DeepSeek Bot {version} is out and may fix this.',
+ 'card.update.available': 'DS Bot {version} is out and may fix this.',
'card.update.downloading': 'Downloading {version} ({p}%, {a}/{b} MB)',
'card.update.installing': 'Installing; it reopens when done.',
'card.update.failed': 'The download failed.',
@@@ -264,13 -251,6 +264,13 @@@
'reason.start.files': 'Program files are incomplete; antivirus software may have blocked some of them.',
'reason.start.engine': 'The local engine stopped halfway through starting.',
'reason.start.other': 'Something unexpected happened.',
+ 'reason.start.missing': 'The data folder can’t be found; the external drive may be unplugged.',
+ 'card.failed.do.permission': 'Allow writing to this folder and try again.',
+ 'card.failed.do.space': 'Free up some space and try again.',
- 'card.failed.do.files': 'Reinstall DeepSeek Bot and open it again.',
++ 'card.failed.do.files': 'Reinstall DS Bot and open it again.',
+ 'card.failed.do.engine': 'Try again; if it still fails, copy the details and report it.',
+ 'card.failed.do.other': 'Try again; if it still fails, copy the details and report it.',
+ 'card.failed.do.missing': 'Plug the drive back in, or put the folder back, and try again.',
'reason.copy.inUse': 'a file is in use by another program',
'reason.copy.permission': 'no permission to read',
'reason.copy.full': 'the disk is full',
diff --cc app/test/start-window.test.mjs
index b959f8c7,badea077..8f096a6e
--- a/app/test/start-window.test.mjs
+++ b/app/test/start-window.test.mjs
@@@ -67,15 -67,15 +67,15 @@@ test('a failure gets one of the six rea
})
test('only a missing file of the app\'s own says that the install is incomplete', () => {
- const program = join(tmpdir(), 'DeepSeek Bot')
+ const program = join(tmpdir(), 'DS Bot')
const where = { program: [join(tmpdir(), 'electron'), program] }
const missing = (path, message) => Object.assign(new Error(message), { code: 'ENOENT', path })
- const exe = join(program, 'DeepSeek Bot.exe')
+ const exe = join(program, 'DS Bot.exe')
assert.equal(failureReason(missing(exe, `spawn ${exe} ENOENT`), where), 'files')
assert.equal(failureReason(missing(exe, `spawn ${exe} ENOENT`)), 'other')
- // A saved data folder on a drive that is gone.
+ // A saved data folder on a drive that is gone: its own reason, with what to do about it.
- const data = join(tmpdir(), 'gone', 'DeepSeek Bot', 'data', 'profiles', 'ds-bot')
+ const data = join(tmpdir(), 'gone', 'DS Bot', 'data', 'profiles', 'ds-bot')
- assert.equal(failureReason(missing(data, `ENOENT: no such file or directory, mkdir '${data}'`), where), 'other')
+ assert.equal(failureReason(missing(data, `ENOENT: no such file or directory, mkdir '${data}'`), where), 'missing')
// A Host that stopped: its error output names the missing file.
const bundle = join(program, 'resources', 'app.asar.unpacked', 'node_modules', 'x', 'index.js')
assert.equal(failureReason(new Error(`The DSH Host stopped (exit 1):\nError: ENOENT: no such file or directory, open '${bundle}'`), where), 'files')
diff --cc docs/plans/2026-10-26-start-window.md
index b394bb95,430d6000..3af1f13e
--- a/docs/plans/2026-10-26-start-window.md
+++ b/docs/plans/2026-10-26-start-window.md
@@@ -227,14 -227,13 +227,14 @@@
### 7. 失败、更新和界面没加载出来
- 失败后 1 秒内:
- - 鲸鱼的话立刻换成「DeepSeek Bot 没能启动」,写在圆环和卡片之间(第 2 节),读屏读出这一句。
+ - 鲸鱼的话立刻换成「DS Bot 没能启动」,写在圆环和卡片之间(第 2 节),读屏读出这一句。
- 鲸鱼换成失败的姿势(第 3 节),卡住的那段弧变红,不画叉:失败只靠鲸鱼的姿势、红的那段弧和这一句。
- 提示行淡出。
- - 纸面变成恢复卡:一句发生了什么(原因)、一句该怎么办(小字,按原因写:没有写入权限「给这个文件夹写入权限后重试。」,空间不够「清理出一些空间后重试。」(〔换个位置…〕在恢复卡上还没有接上,这两句先不提换位置),程序文件不完整「重新安装 DeepSeek Bot 后再打开。」,找不到放数据的文件夹(移动硬盘没插上)「插上那块硬盘,或者把文件夹放回原处后重试。」,引擎停下和其他「先重试一次;还不行,就复制详细信息去反馈。」)、五个按钮、「详细信息」。卡片没有鲸鱼的第一行。数据文件夹建不出来、写不进去时红的是第一段,引擎起不来或者 Host 退出时红的是引擎那段。水塘缩小上移,圆环在卡片上面(第 2 节)。
- - 纸面变成恢复卡:一句原因、五个按钮、「详细信息」。卡片没有鲸鱼的第一行。水塘缩小上移,圆环在卡片上面(第 2 节)。
++ - 纸面变成恢复卡:一句发生了什么(原因)、一句该怎么办(小字,按原因写:没有写入权限「给这个文件夹写入权限后重试。」,空间不够「清理出一些空间后重试。」(〔换个位置…〕在恢复卡上还没有接上,这两句先不提换位置),程序文件不完整「重新安装 DS Bot 后再打开。」,找不到放数据的文件夹(移动硬盘没插上)「插上那块硬盘,或者把文件夹放回原处后重试。」,引擎停下和其他「先重试一次;还不行,就复制详细信息去反馈。」)、五个按钮、「详细信息」。卡片没有鲸鱼的第一行。数据文件夹建不出来、写不进去时红的是第一段,引擎起不来或者 Host 退出时红的是引擎那段。水塘缩小上移,圆环在卡片上面(第 2 节)。
- 焦点移到〔重试〕。窗口不隐藏。
+- 主进程里没人接住的错误也走这一页:交接以前和启动失败一样变成恢复卡,不弹 Electron 自己的错误框;交接以后只记进日志,团队照常用。启动窗口从头到尾没有系统的消息框和错误框。
- 〔复制详细信息〕点过后,按钮上的字变成「已复制」,1.6 秒后变回来。复制的是版本、平台、原因和最后 200 行日志。
- - 〔保存日志…〕打开挂在启动窗口上的系统保存框(默认文件名 `DeepSeek-Bot-log.txt`),把同样的开头和最后 5000 行日志写进选的文件;取消就什么都不做。失败页、「团队界面没有加载出来」、180 秒的卡和复制失败的卡上都有这两个按钮,代替原来的〔打开日志文件夹〕。「详细信息」最多展开 168 px,日志在框里滚动。
+ - 〔保存日志…〕打开挂在启动窗口上的系统保存框(默认文件名 `DS-Bot-log.txt`),把同样的开头和最后 5000 行日志写进选的文件;取消就什么都不做。失败页、「团队界面没有加载出来」、180 秒的卡和复制失败的卡上都有这两个按钮,代替原来的〔打开日志文件夹〕。「详细信息」最多展开 168 px,日志在框里滚动。
- 有新版本时:
- 恢复卡在原因和按钮之间展开一条更新条。〔下载并安装〕成为唯一的主按钮,〔重试〕变成普通按钮。
- 下载中显示「正在下载 {版本}(37%,78/212 MB)」、4 px 的进度条和「下载太慢?手动下载」。
diff --cc docs/plans/2026-10-26-windows-onboarding.md
index 640bf307,d31e3e2e..3e888ac2
--- a/docs/plans/2026-10-26-windows-onboarding.md
+++ b/docs/plans/2026-10-26-windows-onboarding.md
@@@ -97,18 -97,18 +97,18 @@@ Windows 是桌面应用的主要平台�
- 鲸鱼的话换句时淡出、淡入各 .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」,要搬去 设置 → 通用 → 位置 →〔移到…〕;写不进去直接是恢复页。启动页上不写上次的团队和路径,进门后就是它。旧团队登记的总工作区启动页不知道:插件启动后经 `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()`):回到启动页,显示「团队界面没有加载出来」〔重新载入〕〔复制详细信息〕〔保存日志…〕。
- 首次启动期间再双击图标:恢复并聚焦已有窗口,失败页上也一样。
- 建窗口不再依赖「下载」文件夹:每次下载时才取它的位置,取不到就用家目录,再不行就不给默认位置,让用户自己选。