A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
Merge feat/windows-onboarding-m5-02-ring-dot into feat/windows-onboarding-m5-03-place-line
AdamPlatin123297e835ac2fa
diff --cc app/src/main.mjsindex 37cc37ac,bc4b9c0b..523fde02--- a/app/src/main.mjs+++ b/app/src/main.mjs@@@ -13,9 -13,10 +13,10 @@@ import { basename, dirname, isAbsoluteimport { setTimeout as sleep } from 'node:timers/promises'import { fileURLToPath } from 'node:url'import { canonicalExecPath } from './canonical-path.mjs'+ import { configureIdentity } from './legacy.mjs'import { hostPort } from './host-port.mjs'import { captureStdio, LogFile } from './logs.mjs'-import { currentRootOf, driveOf, formatBytes, freeSpace, isEmptyTree, pickFrom, placeOf, rootOf } from './place.mjs'+import { currentRootOf, driveOf, formatBytes, freeSpace, isEmptyTree, pickFrom, placeOf, rootOf, runningLow } from './place.mjs'import { createShell, SHELL_TEXT } from './shell.mjs'import { readStartFrame, writeStartFrame } from './start-frame.mjs'import { explainOf, StartWindow } from './start-window.mjs'@@@ -43,8 -44,7 +44,9 @@@ const IPC =// A cookie export larger than this is not a cookie export.const IMPORT_FILE_MAX = 32 * 1024 * 1024const MOVE_PROBLEMS = { drive: 'dialog.move.drive', nested: 'dialog.move.nested', workspace: 'dialog.move.workspace', program: 'dialog.move.inProgram', notEmpty: 'dialog.move.notEmpty' }+// The same problems as the start page's 「这里放不了」 reasons (reason.place.*).+const MOVE_REASONS = { drive: 'drive', nested: 'nested', workspace: 'workspace', dsh: 'dsh', program: 'program', notEmpty: 'foreign' }+ const CHOOSING_QUIT_WAIT_MS = 1_000const UPDATE_CHECK_WAIT_MS = 15_000const UPDATE_DOWNLOAD_WAIT_MS = 15 * 60_000// Under this, the start page notes the drive's free space for the first 10 s (onboarding §3).@@@ -65,7 -66,7 +68,7 @@@ const frameFile = join(app.getPath('use// Loaded once the start window is up (loadModules).let BotBrowserGuests, partitionOf, BotViews, isBotId, importFromBrowser, listSources, applyCookies, CookieImports, parseCookieFilelet downloadSaver, chooseLocations, defaultPlaces, pickRoot, programFolder, saveLocations, teamIn, teamsAt, tx, HostProcess- let copySessions, findTeam, importTeam, teamInUse, userDshHome, copyData, copyReason, moveProblem, CHECK_PROFILE, PROFILE-let copySessions, findTeam, importTeam, restoreSessions, teamInUse, userDshHome, copyData, moveProblem, CHECK_PROFILE, PROFILE++let copySessions, findTeam, importTeam, restoreSessions, teamInUse, userDshHome, copyData, copyReason, moveProblem, CHECK_PROFILE, PROFILElet watchReleases, watchUpdates, getDshRuntimeVersion, electronUpdaterlet mainWindow@@@ -266,8 -263,8 +273,8 @@@ async function loadModules();({ downloadSaver } = downloads);({ chooseLocations, defaultPlaces, pickRoot, programFolder, saveLocations, teamIn, teamsAt, tx } = firstRun);({ HostProcess } = hostProcess)- ;({ copySessions, findTeam, importTeam, teamInUse, userDshHome } = imports)+ ;({ copySessions, findTeam, importTeam, restoreSessions, teamInUse, userDshHome } = imports)- ;({ copyData, moveProblem } = moves)+ ;({ copyData, copyReason, moveProblem } = moves);({ CHECK_PROFILE, PROFILE } = profile);({ watchReleases, watchUpdates } = updatesModule);({ getDshRuntimeVersion } = boot)@@@ -805,114 -760,23 +819,114 @@@ async function checkTeam(where, signal// folder; after a failed copy it starts again on the old one. The old folder stays.async function moveData(workspace) {if (copying !== undefined || stopping || mainWindow === undefined) return false+ const to = await askMove(workspace)+ if (to === undefined) return false+ await runMove(to, workspace)+ return true+}++// 〔换个位置…〕 on a later start's place line (start-window §5): the same move, asked on the start+// page's cards instead of message boxes. Only the folder picker is a system window; while it or+// a card is open, the clock stands still and the hand-off waits.+async function moveFromStart() {+ if (startWindow.kind !== 'later' || places === undefined || copying !== undefined || picking || restarting || stopping || failed) return+ picking = true+ try {+ await startWindow.asking(pickMove())+ } finally {+ picking = false+ }+}++// 「这里放不了」 with the reason, or 「搬到这个文件夹?」. A cancelled picker is no change: the card+// that led here goes, and the start goes on.+async function pickMove() {+ const { canceled, filePaths } = await dialog.showOpenDialog(owner(), { title: tx('dialog.pickMove'), defaultPath: dirname(places.dataDir), properties: ['openDirectory', 'createDirectory', 'promptToCreate'] })+ if (stopping || startWindow.owner() === undefined) return+ moveTo = undefined+ if (canceled || filePaths[0] === undefined) {+ startWindow.card(undefined)+ return+ }+ moveCard(resolve(filePaths[0]))+}++function moveCard(to) {+ const reason = moveReason(to)+ if (reason !== undefined) {- console.log(`DeepSeek Bot: the data cannot move to ${to} (${reason})`)++ console.log(`DS Bot: the data cannot move to ${to} (${reason})`)+ startWindow.card({ kind: 'rejected', reason, path: to })+ return+ }+ moveTo = to+ startWindow.card({ kind: 'move', path: to, dataDir: places.dataDir })+}++// A folder the checks cannot read counts as one without permission, as on a first start.+function moveReason(to, workspace = places.workspace) {+ try {+ const problem = moveProblemOf(to, workspace)+ return problem === undefined ? undefined : MOVE_REASONS[problem]+ } catch (error) {+ console.error(error)+ return 'permission'+ }+}++// 〔移动并重启〕 checks the folder again (the team workspace can move while the card is open);+// then the start window becomes the move's before a hand-off that waited can go, and the boot it+// showed gives way. 〔取消〕 goes back to the start.+async function moveAnswer(value) {+ if (startWindow.kind !== 'later' || moveTo === undefined || picking || copying !== undefined || stopping || failed) return+ const to = moveTo+ moveTo = undefined+ if (value !== 'move') {+ startWindow.card(undefined)+ return+ }+ if (moveReason(to) !== undefined) {+ moveCard(to)+ return+ }+ attempt += 1+ forgetHost()+ startWindow.moving()+ await runMove(to, places.workspace)+}++// The folder picker, the checks and the question of a move from Settings: the folder, or none.+async function askMove(workspace) {const { canceled, filePaths } = await dialog.showOpenDialog(owner(), { title: tx('dialog.pickMove'), defaultPath: dirname(places.dataDir), properties: ['openDirectory', 'createDirectory', 'promptToCreate'] })- if (canceled || filePaths[0] === undefined) return false+ if (canceled || filePaths[0] === undefined) return undefinedconst to = resolve(filePaths[0])+ if (await moveRefused(to, workspace)) return undefined- const { response } = await dialog.showMessageBox(owner(), { type: 'question', title: 'DeepSeek Bot', noLink: true, message: tx('dialog.move.confirm', { to }), detail: tx('dialog.move.detail', { from: places.dataDir }), buttons: [tx('btn.move'), tx('btn.cancel')], defaultId: 0, cancelId: 1 })++ const { response } = await dialog.showMessageBox(owner(), { type: 'question', title: 'DS Bot', noLink: true, message: tx('dialog.move.confirm', { to }), detail: tx('dialog.move.detail', { from: places.dataDir }), buttons: [tx('btn.move'), tx('btn.cancel')], defaultId: 0, cancelId: 1 })+ if (response !== 0 || stopping || await moveRefused(to, workspace)) return undefined+ return to+}++// The team workspace can move while a dialog is open; the window tells the latest one.+function moveProblemOf(to, workspace) {const dshHome = userDshHome()- // The team workspace can move while a dialog is open; the window tells the latest one.- const refused = async () => {- for (const current of new Set([workspace, places.workspace])) {- const problem = moveProblem({ from: places.dataDir, to, workspace: current, dshHome, program: app.isPackaged ? programFolder() : undefined })- if (problem === undefined) continue- await dialog.showMessageBox(owner(), { type: 'warning', title: 'DS Bot', message: problem === 'dsh' ? tx('dialog.move.inDsh', { home: dshHome }) : tx(MOVE_PROBLEMS[problem]), buttons: [tx('btn.ok')] })- return true- }- return false+ for (const current of new Set([workspace, places.workspace])) {+ const problem = moveProblem({ from: places.dataDir, to, workspace: current, dshHome, program: app.isPackaged ? programFolder() : undefined })+ if (problem !== undefined) return problem}- if (await refused()) return false- const { response } = await dialog.showMessageBox(owner(), { type: 'question', title: 'DS Bot', noLink: true, message: tx('dialog.move.confirm', { to }), detail: tx('dialog.move.detail', { from: places.dataDir }), buttons: [tx('btn.move'), tx('btn.cancel')], defaultId: 0, cancelId: 1 })- if (response !== 0 || stopping || await refused()) return false+ return undefined+}++async function moveRefused(to, workspace) {+ const problem = moveProblemOf(to, workspace)+ if (problem === undefined) return false- await dialog.showMessageBox(owner(), { type: 'warning', title: 'DeepSeek Bot', message: problem === 'dsh' ? tx('dialog.move.inDsh', { home: userDshHome() }) : tx(MOVE_PROBLEMS[problem]), buttons: [tx('btn.ok')] })++ await dialog.showMessageBox(owner(), { type: 'warning', title: 'DS Bot', message: problem === 'dsh' ? tx('dialog.move.inDsh', { home: userDshHome() }) : tx(MOVE_PROBLEMS[problem]), buttons: [tx('btn.ok')] })+ return true+}++// The move itself, on the start window's moving page. What keeps it from going through is said on+// a card there, 「没有搬成」, and the app starts again on the old folder: a folder that cannot be+// used after all, another DSH on the data (the move goes on by itself once it is closed), a copy+// that failed (〔重试〕 copies again). Quitting meanwhile stops it without a new start.+async function runMove(to, workspace) {const signal = copyAbort.signalcopying = (async () => {// The settings go away first, so that nothing moves the team workspace from here on; the@@@ -1250,11 -1098,9 +1264,11 @@@ async function fail(error)failed = trueconst mine = attemptstartWindow.fail(error, startKind())+ // The failure page takes the place of a card that waited.+ answering?.(undefined)const found = await Promise.race([updates?.latest() ?? null, sleep(UPDATE_CHECK_WAIT_MS).then(() => null)])if (!found || mine !== attempt) return- await dialog.showMessageBox(owner(), { type: 'info', title: 'DeepSeek Bot', message: tx(found.page ? 'dialog.update.onFailurePage' : 'dialog.update.onFailure', { version: found.version }) })+ await dialog.showMessageBox(owner(), { type: 'info', title: 'DS Bot', message: tx(found.page ? 'dialog.update.onFailurePage' : 'dialog.update.onFailure', { version: found.version }) })if (found.page) {if (!process.env.DS_BOT_HOME) await electronShell.openExternal(found.page)returndiff --cc app/src/start/text.mjsindex e8bcca1c,d3d15f2d..59488944--- a/app/src/start/text.mjs+++ b/app/src/start/text.mjs@@@ -204,10 -193,6 +204,10 @@@ export const TEXT ='card.missing.lead': 'Can’t find the data folder {path}. The external drive may be unplugged, or the folder was moved or deleted. The old data won’t be changed.','card.missing.retryMissed': 'Still can’t find this folder.','card.picked.lead': 'It will go in {path}.',- 'card.move.lead': 'DeepSeek Bot copies its data to {path} and starts again. {dataDir} stays as it is; once all is well you can delete it yourself.',++ 'card.move.lead': 'DS Bot copies its data to {path} and starts again. {dataDir} stays as it is; once all is well you can delete it yourself.',+ 'card.moveFailed.inUse': 'Another DeepSeek Harness is using this data. Once it is closed, the move goes on by itself.',+ 'card.moveFailed.copy': 'The data wasn’t fully copied: {reason}.',+ 'card.moveFailed.stay': '{dataDir} is unchanged.','card.import.lead': 'DeepSeek Harness has {bots|Bot|Bots} and {groups|group chat|group chats} (chats {chats}, work files {work}). Copy them over?','card.import.extra': 'The copy takes another {total}; the originals in DeepSeek Harness stay untouched.','card.import.found': 'Found {bots|Bot|Bots} ({names} and others), {groups|group chat|group chats} and {sessions|chat|chats} in {path}.',diff --cc app/test/helpers/app-harness.mjsindex 87dd4749,c54341b3..1fba076e--- a/app/test/helpers/app-harness.mjs+++ b/app/test/helpers/app-harness.mjs@@@ -20,15 -20,15 +20,16 @@@ export const waitFor = async (check, wh/*** Start the app on throwaway folders: the places are chosen already and the one-time notice* is answered, so that the app asks nothing. The Host answers when the test lets it.- * @param {{ packaged?: boolean, saved?: object }} options whether the app is a packaged one, with- * an updater; what else locations.json keeps beside the places- * @param {{ packaged?: boolean, firstRun?: boolean }} options whether the app is a packaged- * one, with an updater; a first run keeps its places unchosen, so that it asks++ * @param {{ packaged?: boolean, saved?: object, firstRun?: boolean }} options whether the app is a packaged++ * one, with an updater; what else locations.json keeps beside the places; a first run keeps++ * its places unchosen, so that it asks*/- export const startApp = async ({ packaged = true, saved = {} } = {}) => {-export const startApp = async ({ packaged = true, firstRun = false } = {}) => {++export const startApp = async ({ packaged = true, saved = {}, firstRun = false } = {}) => {const home = mkdtempSync(join(tmpdir(), 'ds-bot-main-home-'))const workspace = join(home, 'workspace')mkdirSync(workspace, { recursive: true })mkdirSync(paths.userData, { recursive: true })- writeFileSync(join(paths.userData, 'locations.json'), JSON.stringify({ dataDir: home, workspace, ...saved }))- if (!firstRun) writeFileSync(join(paths.userData, 'locations.json'), JSON.stringify({ dataDir: home, workspace }))++ if (!firstRun) writeFileSync(join(paths.userData, 'locations.json'), JSON.stringify({ dataDir: home, workspace, ...saved }))writeFileSync(join(paths.userData, 'tray-close-acknowledged'), '')hold()await import('../../src/main.mjs')diff --cc app/test/helpers/fake-electron.mjsindex 3211b125,36d15095..46790565--- a/app/test/helpers/fake-electron.mjs+++ b/app/test/helpers/fake-electron.mjs@@@ -112,9 -112,8 +112,9 @@@ class FakeWebContents extends EventEmitthis.mainFrame = {}this.isDestroyed = () => this.win.destroyedthis.getURL = () => this.win.url- this.getTitle = () => 'DeepSeek Bot'+ this.getTitle = () => 'DS Bot'- this.send = () => {}+ this.sent = []+ this.send = (...args) => { this.sent.push(args) }this.setWindowOpenHandler = () => {}this.insertCSS = async () => {}this.toggleDevTools = () => {}diff --cc app/test/place.test.mjsindex 6b09b420,1f6d6906..dd0b599a--- a/app/test/place.test.mjs+++ b/app/test/place.test.mjs@@@ -55,19 -55,9 +55,19 @@@ test('the place line names the drive an}})+test('a drive runs low at a fifth of the free space it had when the data went there', () => {+ assert.equal(LOW_SHARE, 0.2)+ // 412 GB at the start: the line comes back at 82.4 GB.+ assert.equal(runningLow(82 * 2 ** 30, 412 * 2 ** 30), true)+ assert.equal(runningLow(83 * 2 ** 30, 412 * 2 ** 30), false)+ assert.equal(runningLow(20, 100), true)+ assert.equal(runningLow(21, 100), false)+ for (const [free, freeAtStart] of [[undefined, 100], [10, undefined], [10, 0], [Number.NaN, 100], [10, Number.POSITIVE_INFINITY]]) assert.equal(runningLow(free, freeAtStart), false)+})+test('the picker opens in the data folder\'s parent', (t) => {const dir = temp(t)- assert.equal(pickFrom(join(dir, 'DeepSeek Bot', 'data')), join(dir, 'DeepSeek Bot'))+ assert.equal(pickFrom(join(dir, 'DS Bot', 'data')), join(dir, 'DS Bot'))})test('the current root is the parent of a data and a workspace folder that are siblings', (t) => {diff --cc docs/plans/2026-10-26-start-window.mdindex 83d698c7,632026e6..1f53bab6--- a/docs/plans/2026-10-26-start-window.md+++ b/docs/plans/2026-10-26-start-window.md@@@ -80,11 -81,11 +80,11 @@@- 每段一次性动作带序号,新状态到了就丢掉旧的。等动画结束的地方都配一个计时器兜底,因为最小化的窗口不走动画。- 弹簧只用 `motion.js` 的常量。头像动作的关键帧沿用插件的写法(`styles.js` 的 `bt-hop`、`bt-bob` 等),换算成像素。- 鲸鱼说话:- - 顺利的时候鲸鱼不说话,页面上除了底注和位置行(盘不够时还有提示行的那一句)没有字。只在要用户知道或回答的时候,圆环下面那一行(第 2 节)才有一句短话,用 Main Bot 自己的口吻:+ - 顺利的时候鲸鱼不说话,页面上除了位置行(盘不够时还有提示行的那一句)没有字。只在要用户知道或回答的时候,圆环下面那一行(第 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 秒起和鲸鱼那句话一起的〔打开日志文件夹〕。@@@ -164,8 -165,7 +164,8 @@@- 10 秒:鲸鱼看向用户一次,循环放慢,不出字。- 45 秒,引擎还没起来:鲸鱼说「比平时慢,请再等一会儿」,提示行只有〔打开日志文件夹〕,鲸鱼改成思考。- 180 秒:和首次启动一样。- - 盘快满了:数据放到一个文件夹时(首次启动定下位置、导入复制完、换位置或搬数据以后),`locations.json` 记下那块盘当时的剩余空间(`freeAtStart`);以后启动时剩余空间到了它的 20% 以下(开始时剩 412 GB 的,到 82 GB 以下),数据阶段读出位置时出现位置行「数据放在 C 盘(剩 30 GB)」和〔换个位置…〕,淡入 .22 s。点〔换个位置…〕走 设置 → 通用 → 位置 的搬数据,但除了系统选择框不弹系统对话框,都在纸面的卡片上问(第 6 节):选了不能用的文件夹出「这里放不了」加一句原因,〔重新选…〕;能用就出「搬到这个文件夹?」「会把数据复制到 `D:\Data`,然后重新启动。原来的 `C:\Users\<用户名>\.ds-bot` 原样留着,确认没问题后可以自己删掉。」〔移动并重启〕(主按钮)〔重新选…〕〔取消〕。选择框和卡片开着时时钟停、交接等着;选择框被取消或点〔取消〕就回到启动,照常进团队。点〔移动并重启〕时再查一次(总工作区可能刚好换了),然后启动窗口当场变成搬数据的样子(页面重新载入,「正在搬 DeepSeek Bot 的数据…」),这次启动的引擎停下,走 设置 → 通用 → 位置 的〔移到…〕同一条路:复制完在新文件夹重新启动(今天旧文件夹留着,卡片上也这样写;上手流程第 8 节「搬是搬」落地时这里一起改);复制时另一个 DSH 正在用这份数据、或者复制失败,仍和设置里一样弹系统对话框,然后在原来的文件夹重新启动(「已知限制」)。以前存下、没有记这个数的位置,这次启动补记,下一次起才按它算;`DS_BOT_HOME` 的一次性运行不记也不显示。- - 换位置(第 1 节)时,鲸鱼下面一直是「正在搬 DeepSeek Bot 的数据…」,45 秒起换成「比平时慢,请再等一会儿」和〔打开日志文件夹〕。以后的启动和搬数据时,这一行的字 1 秒后带流光。++- 盘快满了:数据放到一个文件夹时(首次启动定下位置、导入复制完、换位置或搬数据以后),`locations.json` 记下那块盘当时的剩余空间(`freeAtStart`);以后启动时剩余空间到了它的 20% 以下(开始时剩 412 GB 的,到 82 GB 以下),数据阶段读出位置时出现位置行「数据放在 C 盘(剩 30 GB)」和〔换个位置…〕,淡入 .22 s。点〔换个位置…〕走 设置 → 通用 → 位置 的搬数据,但除了系统选择框不弹系统对话框,都在纸面的卡片上问(第 6 节):选了不能用的文件夹出「这里放不了」加一句原因,〔重新选…〕;能用就出「搬到这个文件夹?」「会把数据复制到 `D:\Data`,然后重新启动。原来的 `C:\Users\<用户名>\.ds-bot` 原样留着,确认没问题后可以自己删掉。」〔移动并重启〕(主按钮)〔重新选…〕〔取消〕。选择框和卡片开着时时钟停、交接等着;选择框被取消或点〔取消〕就回到启动,照常进团队。点〔移动并重启〕时再查一次(总工作区可能刚好换了),然后启动窗口当场变成搬数据的样子(页面重新载入,「正在搬 DS Bot 的数据…」),这次启动的引擎停下,走 设置 → 通用 → 位置 的〔移到…〕同一条路:复制完在新文件夹重新启动(今天旧文件夹留着,卡片上也这样写;上手流程第 8 节「搬是搬」落地时这里一起改);复制时另一个 DSH 正在用这份数据、或者复制失败,仍和设置里一样弹系统对话框,然后在原来的文件夹重新启动(「已知限制」)。以前存下、没有记这个数的位置,这次启动补记,下一次起才按它算;`DS_BOT_HOME` 的一次性运行不记也不显示。+ - 换位置(第 1 节)时,鲸鱼下面一直是「正在搬 DS Bot 的数据…」,45 秒起换成「比平时慢,请再等一会儿」和〔打开日志文件夹〕。以后的启动和搬数据时,这一行的字 1 秒后带流光。- 就绪时没有庆祝(重试或重新开始后第一次成功时例外,第 8 节):剩下的弧画满、圆环合上,100 ms 后鲸鱼跳向 Main Bot 的头像(没有地方落时潜下去);220 ms 时发 `handoffShow`,启动窗口和首次启动一样长成主窗口的矩形,鲸鱼 650 ms 时落在头像上,主窗口在就绪后约 0.7 秒露面(第 8 节)。- `DS_BOT_HOME` 的一次性运行用这一套,只是不出卡片。@@@ -188,15 -187,14 +188,15 @@@- 恢复卡、团队界面没有加载出来和复制失败的卡没有这一行,也不说俏皮话(第 7 节)。180 秒的卡也没有,问题由鲸鱼问。- 鲸鱼跳不跳:- 应用主动问的卡片(推荐盘、找不到数据文件夹、导入、180 秒),跳两下,最后一跳落地时探身看着卡片,然后停下(第 3 节第二张表)。- - 用户自己引出的卡片(「其他位置…」选完后的「会放在…」、停止复制的确认),不跳,变形开始 70 ms 后探身。+ - 用户自己引出的卡片(「其他位置…」选完后的「会放在…」、以后的启动搬数据时的「这里放不了」和「搬到这个文件夹?」、停止复制的确认),不跳,变形开始 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 节「一个位置」):根就是选的文件夹时不出卡,直接重新开始;加了一层 `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 秒,鲸鱼会一直在水下;那个文件夹马上就删,没有要保全的东西),默认位置上这一次建的文件夹删掉(数据文件夹整个删,总工作区只在还是空的时候删),位置这时就记下,三段弧回到没开始,鲸鱼在原处重新浮上来。导入复制进行中不接这一下,复制完以后这一行收起:搬一个复制好的团队是 设置 → 通用 → 位置 的事。++ - 位置行的〔换个位置…〕(第 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 秒,鲸鱼会一直在水下;那个文件夹马上就删,没有要保全的东西),默认位置上这一次建的文件夹删掉(数据文件夹整个删,总工作区只在还是空的时候删),位置这时就记下,三段弧回到没开始,鲸鱼在原处重新浮上来。导入复制进行中不接这一下,复制完以后这一行收起:搬一个复制好的团队是 设置 → 通用 → 位置 的事。+- 以后的启动在盘快满时点位置行的〔换个位置…〕(第 5 节):选完先查能不能搬过去(和设置里搬数据的检查一样),不能用的出「这里放不了」加一句原因,用的是上面被拒绝的卡的原因,多两句:「`D:\` 是整块磁盘,要选它里面的一个文件夹。」「`D:\Work` 和总工作区互相包含。」,已经有东西的文件夹是「`D:\Data` 里已经有别的文件。」,〔重新选…〕(主按钮);能用的出「搬到这个文件夹?」〔移动并重启〕(主按钮)〔重新选…〕〔取消〕,脚注和正文见第 5 节。这两张卡都没有〔放到 D 盘〕〔仍然放在 C 盘〕。- 重装(`C:\Users\<用户名>\.ds-bot` 里有团队、没有保存的位置)不出卡片,盘不够也不出;启动页上不写上次的团队和路径,进门后就是它。- 180 秒:鲸鱼立刻问「等太久了,要不要重试?」,卡片里只有〔继续等待〕(主按钮)〔重试〕〔打开日志文件夹〕,读屏读的是这句问话。- 〔继续等待〕:卡片收回,180 秒后再问。@@@ -397,9 -394,8 +397,9 @@@- 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 慢,鲸鱼先落下,再跟着窗口一起长到位(两次运行,落点都一样);首次启动时「预览版说明」的遮罩盖着侧栏,头像在遮罩下面+- 2026-10-31 位置行:维护者「替换之前的3点式,移除左下角的社区非官方声明,右下角的换个位置」。追问以后:「3点式」就是原来的三站,圆环已经代替了它,这次不改;维护者问「要不要显示圆环显示对应3个正在启动的阶段?」:三段弧本来就各是一个阶段(第 2 节),不加字(2026-10-30「文案保持取消状态」)。底注去掉;位置行挪到底部正中,〔换个位置…〕改成灰色的小按钮(28 px,`small`),整行在纸面下面 4 px(第 2 节);首次启动照旧有,以后的启动只在数据所在的盘剩下的不到开始时的 20% 时有:开始时的剩余空间在数据放进一个文件夹时记进 `locations.json`(`freeAtStart`;盘满时记不到,下一次再记),以前存下的位置下一次启动补记;以后的启动点〔换个位置…〕当场搬数据(第 5 节)。试的时候搬数据被拒绝弹了系统对话框,维护者:「让我们尽可能避免系统中出现任何这样的默认弹窗」。所以以后的启动搬数据时,除了系统选择框都在卡片上问:「这里放不了」用第 6 节被拒绝的那张卡(原因多「整块磁盘」和「和总工作区互相包含」两句,读不了的文件夹按没有权限),确认是新的一张「搬到这个文件夹?」〔移动并重启〕〔重新选…〕〔取消〕;确认以后启动窗口当场变成搬数据的页面,这次启动让位,等着的交接作废。还剩下的系统对话框记进「已知限制」。第 2、3、4、6、8 节和「改动的已定设计」跟着改。依据:应用的测试(`place.test.mjs`:20% 的界线;`start-window.test.mjs`:变成搬数据的页面并丢掉等着的交接;`main-low-space.test.mjs`:盘快满时以后的启动有位置行,选进数据文件夹里出「这里放不了」,读不了的 `C:\System Volume Information` 按没有权限,取消以后引擎照常起来、团队界面照常加载,〔移动并重启〕以后页面载入 `?start=moving`、引擎在复制之前停下、数据复制到新文件夹、`locations.json` 换成新文件夹和它自己的剩余空间、应用重新启动,一路没有系统对话框;`main-room-left.test.mjs`:剩余空间还多时没有位置行,换总工作区不动记下的剩余空间,设置里搬数据照旧;`main.test.mjs`:没有记过的位置这次补记;`start-page.test.mjs`:页脚只有位置行和灰色按钮、搬数据的卡);故意改坏 20% 的判断、复制前停引擎、取消时丢掉启动这三处,测试都会失败。离屏渲染的检查 17 项都过(位置行居中、指针点得到、离底边 12 px、有卡片时在纸面下面 4 px、以后的启动和失败页、英文长路径省略、深色、两张卡)。一次独立评审(四个方面,每条意见一个复核)确认 7 条,都已改正:读不了的文件夹不再把正常的启动变成失败页,盘满时记下的 0 不算数,start-copy 第 3 节、本节第 5 节、「改动的已定设计」和上手流程的说法。真机上的以后的启动(这条分支的一次性副本,G 盘剩 4.0 GB,记下的开始空间 10^15 字节):位置行「数据放在 G 盘(剩 4.0 GB)」,指针点得到;先取消选择框,启动照常走;再点、选了文件夹,团队界面在卡片开着时就绪,交接等着;卡片「搬到这个文件夹?」写着真实的路径,没有系统对话框;点〔移动并重启〕后启动窗口变成搬数据的页面,等着的交接作废(等了 13 秒),6 秒后应用在新文件夹上重新启动并交接,`locations.json` 是新文件夹和 3.99 GB。## 待定diff --cc docs/plans/2026-10-26-windows-onboarding.mdindex 5ed7a22c,f48cd10a..acd8fe9d--- a/docs/plans/2026-10-26-windows-onboarding.md+++ b/docs/plans/2026-10-26-windows-onboarding.md@@@ -95,20 -95,20 +95,20 @@@ Windows 是桌面应用的主要平台�| 有卡片时 | 空着,由卡片自己的第一句说(15/20、600,在已定的文字上面):推荐盘「C 盘有点挤」(盘不够)或「这里不让我放东西」(没有写入权限),「会放在…」那张「我多加了一层文件夹」,被拒绝的「这里放不了」,找不到数据文件夹「数据不在原来的地方了」;导入的几张见第 4 节;失败的卡没有 | 隐藏 |- 鲸鱼的话换句时淡出、淡入各 .16 s,不排队。失败时不画叉:鲸鱼失败的姿势、红的那段弧和那句话就是失败。鲸鱼沉下去、换个新文件夹重新开始时,三段弧从头开始。就绪时剩下的弧画满、圆环合上,鲸鱼喷一次水,跳出水面,落到侧栏里 Main Bot 的头像上,没有地方落时潜下去(启动窗口第 8 节)。-- **一般情况下什么都不问**,用默认位置,但页面上写着放在哪、能换:底注右边一行「数据放在 C 盘(剩 412 GB)· 换个位置…」([启动窗口](2026-10-26-start-window.md) 第 2、4、6 节),什么都不点就按它走;点「换个位置…」才开系统选择框,定根和下面「一个位置」一样,定好后引擎在新文件夹重新起、鲸鱼沉下去重新开始(启动窗口第 7 节),默认位置上这一次建的文件夹删掉。重装没有这一行,导入复制完以后收起。先看是不是重装(下一条),再看要不要出位置卡片。选位置的卡片只有推荐盘这一张,它上面的按钮都已经试写通过,不会点了再被拒绝;每张卡都说明以后在哪里改:+- **一般情况下什么都不问**,用默认位置,但页面上写着放在哪、能换:底部正中一行「数据放在 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 行,已脱敏)。- 启动超过 180 秒:鲸鱼问「等太久了,要不要重试?」,卡片上只有〔继续等待〕〔重试〕〔打开日志文件夹〕,引擎同时继续启动。- - 后台更新器发现了新版本时,恢复页上显示「DeepSeek Bot {版本} 已经发布,可能修好了这个问题。」〔下载并安装〕,带下载百分比和「下载太慢?手动下载」(打开镜像页)。+ - 后台更新器发现了新版本时,恢复页上显示「DS Bot {版本} 已经发布,可能修好了这个问题。」〔下载并安装〕,带下载百分比和「下载太慢?手动下载」(打开镜像页)。- 引擎起来了但 DS Bot 界面 20 秒内没报告就绪(ds-bot 在界面挂载完成后调用 `dsBotApp.ready()`):回到启动页,显示「团队界面没有加载出来」〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕。- 首次启动期间再双击图标:恢复并聚焦已有窗口,失败页上也一样。- 建窗口不再依赖「下载」文件夹:每次下载时才取它的位置,取不到就用家目录,再不行就不给默认位置,让用户自己选。@@@ -133,11 -133,11 +133,11 @@@- 卡片一出现先查第一段的空间:卡片上的「对话 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 里决定。+ - 复制后,设置 → 通用 → 位置 里有一行「DeepSeek Harness 里的原团队还在 `C:\Users\<用户名>\.dsh`(4.6 GB),DS Bot 不会改动它。」〔打开文件夹〕;要不要删、什么时候删由用户在 DeepSeek Harness 里决定。- - 新用户从不复制任何东西:推荐盘和「其他位置…」只新建空文件夹,重装接着用原处的数据。应用自己的数据搬动时(第 8 节〔移到…〕、恢复页的〔换个位置…〕)旧位置不留副本。+ - 新用户从不复制任何东西:推荐盘和「其他位置…」只新建空文件夹,重装接着用原处的数据。应用自己的数据搬动时(第 8 节〔移到…〕、恢复页的〔换个位置…〕、以后的启动盘快满时位置行的〔换个位置…〕)旧位置不留副本。- 第一段复制时卡片标题是「正在搬过来」,下面是分步进度和数字:「检查对话 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 现在读不了。」主按钮是〔先不带团队开始〕(不再是「退出」),脚注「以后可以在 设置 → 通用 → 位置 里复制。」+ - 有更新版本 DSH 写的对话(下面两张卡的第一句都是「这些对话比我新」):更新器现在随应用一起启动,找到能读的版本时:「DS Bot 0.2.4 能读它们,正在下载(37%)。装好后会重新打开,再复制团队。」卡上有〔先不复制〕,还有「下载太慢?手动下载」;下载失败时〔重试〕〔手动下载〕(和恢复页的更新条一样)。位置在这之前不保存,重开后会再问导入。没找到时:「这些对话是更新版本的 DeepSeek Harness 写的,DS 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 节)。@@@ -304,12 -304,12 +304,12 @@@| [桌面应用](2026-10-16-desktop-app.md)「首次启动分别选数据位置和总工作区……用的是系统对话框」 | 窗口先出来,显示应用自己的启动页;默认位置直接用,只在需要时出卡片;换位置只选一个文件夹,按第 3 节定根 `R`,数据和总工作区一起放在 `R\data` 和 `R\workspace`;盘不够或默认位置不能用时先推荐一个固定盘,系统选择框只在「其他位置…」之后,只在应用改了所选路径时才确认 || 同上「两个位置不能一个在另一个里面」 | 保留;一个位置的两个子文件夹是兄弟,不互相包含 || 本文首稿 §3「找到以前的 DS Bot 数据……〔接着用(推荐)〕〔用新的空白团队开始…〕」 | 不问,直接接着用;空白团队在设置里 |-| 本文 2026-10-28 首稿 §3:首次启动不写路径,自己选位置只在推荐盘的卡上有「其他位置…」 | 启动页底注右边写「数据放在 C 盘(剩 412 GB)· 换个位置…」,随时能换;维护者 2026-10-28:「给出建议,同时提供自行选择的接口,避免小弹窗」 |+| 本文 2026-10-28 首稿 §3:首次启动不写路径,自己选位置只在推荐盘的卡上有「其他位置…」 | 启动页写「数据放在 C 盘(剩 412 GB)」和〔换个位置…〕,随时能换(2026-10-31 起在底部正中、是灰色的按钮,见下面那一行);维护者 2026-10-28:「给出建议,同时提供自行选择的接口,避免小弹窗」 || 本文首稿「不做什么」:不扫描 D: 到 Z: 去推荐数据位置 | 只在盘不够或默认位置不能用时枚举一次固定盘,可移动盘、网络盘和光驱仍然一概不碰 || 本文首稿 §3「OneDrive 里的总工作区只提醒,不拒绝」 | 一个位置之下总工作区和数据是兄弟,位置在 OneDrive 里就整个不能用,首次启动不再有这张提醒卡 |- | 同上 换数据位置「选一个空文件夹或新文件夹……也不能选整个磁盘」 | 选磁盘根目录或别人的非空文件夹时,应用在里面加一层 `DeepSeek Bot`(第 3 节定根的规则),只在加了这一层时确认 |+ | 同上 换数据位置「选一个空文件夹或新文件夹……也不能选整个磁盘」 | 选磁盘根目录或别人的非空文件夹时,应用在里面加一层 `DS Bot`(第 3 节定根的规则),只在加了这一层时确认 || 同上「结构」「窗口」:窗口加载引擎自己的本机地址 | 窗口先加载应用自己的启动页,引擎起来后再加载引擎的本机地址(同一个地址和端口) |- | 同上「首次启动没走完就退出时什么都不记」 | 保留;`locations.json` 和 `locations.ini` 改在引擎第一次 `ready` 之后才写;`.deepseek-bot` 标记在新建数据文件夹时就写,没走完留下的文件夹下次认得出 |+ | 同上「首次启动没走完就退出时什么都不记」 | 保留;`locations.json` 和 `locations.ini` 改在引擎第一次 `ready` 之后才写;`.ds-bot` 标记在新建数据文件夹时就写,没走完留下的文件夹下次认得出 || 同上「问要不要导入,只在首次启动问一次」 | 首次启动仍然问,但只有一句话和两个按钮(预览、模型设置和勾选项折叠在「详细」里),卡片一出现就开始检查对话和预热引擎;之后在 设置 → 通用 → 位置 里随时可以复制到一个新的数据文件夹 || 同上「DSH 正在用这个团队时,请用户先关掉」 | 判断加上锁的刷新时间;自动重查,不用反复点重试 || 同上「旧团队工作文件夹里的文件复制到新的总工作区,不覆盖已有的文件」 | 仍然不覆盖;默认跳过可重新生成的文件夹;团队在对话复制完就打开,工作文件在团队打开后由应用后台复制,退出后下次接着,设置里能停和续 |@@@ -387,8 -386,8 +387,8 @@@- 打包后的 Windows CI,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户:进程启动后 2 秒内窗口可见(目标 1 秒,CI 留余量);引擎的页面之前不出现任何卡片;能进到引擎的页面。- 启动页(同一个 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*` 不挂在主窗口上(单元测试扫描调用处),窗口出来之前没有系统对话框;位置和总工作区不问(没有「欢迎」对话框),系统选择框只在点了位置行的「换个位置…」以后出现,取消它什么都不变。+- 首次启动期间没有一个 `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 时也没有,启动页上不写团队的数字,进去就是原来的团队。- 导入:点〔复制过来〕后,对话复制完团队就打开,`bot/work-files.json` 记着工作文件没复制完;工作文件在后台到齐后记成已完成;复制一半退出再启动会接着复制,已有的文件一个不覆盖;〔先不复制〕不重启引擎,暂存已删。- 空间只占一份(CI 用替身的空间查询和一个 2 GB 的假团队):整个导入过程中数据所在的盘最多少掉「第一段 + 500 MB」,没有 `.import-check-*` 文件夹,`~/.dsh` 的内容和修改时间一个都没变;工作文件复制完后新旧两处各一份,设置里显示原团队的位置和大小;剩余空间降到 500 MB 以下时后台复制停下,设置里有〔继续复制〕。导入卡开着、DSH 还占着团队时数据文件夹里没有 `.import-*`,锁放开后才出现;暂存期间锁刷新过,暂存会重做;导入卡开着时关窗、更新重开,下次启动前暂存已删。@@@ -493,8 -492,7 +493,8 @@@- 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」那条变更里。+- 2026-10-31 位置行:维护者要去掉启动页左下角的「社区开源项目,不是 DeepSeek 官方产品」,右下角的位置行首次启动照旧显示、此外只在空间不足时显示,并换个位置。§3 的位置行改到底部正中,〔换个位置…〕改成灰色的小按钮;§8 以后的启动在数据所在的盘只剩开始时的 20% 时也有位置行,按钮当场搬数据,确认和「这里放不了」在卡片上问(维护者看到搬数据被拒绝的系统对话框后:「让我们尽可能避免系统中出现任何这样的默认弹窗」);§4「旧位置不留副本」的列表加上这个入口;「改动的已定设计」加一行,底注那一行和 2026-10-28 那一行跟着改;验收里的〔换个位置…〕改成按钮的写法。「第一次介绍产品的地方都写「不是 DeepSeek 官方产品」」不变:README 和下载区照旧写。细节和依据在 [启动窗口](2026-10-26-start-window.md) 同一天「位置行」那条变更里。diff --cc docs/plans/2026-10-29-start-copy.mdindex 75c9f8d4,6b0c5a26..17a7478f--- a/docs/plans/2026-10-29-start-copy.md+++ b/docs/plans/2026-10-29-start-copy.md@@@ -80,10 -80,9 +80,10 @@@| 新 | 中文 | 来自 ||---|---|---|| `reason.place.space` | {drive} 盘只剩 {free}。 | `card.reason.space` |- | `reason.place.permission` | DeepSeek Bot 没有权限在 {path} 里写文件。 | `card.reason.permission` 和 `card.rejected.permission` 合一 |+ | `reason.place.permission` | DS Bot 没有权限在 {path} 里写文件。 | `card.reason.permission` 和 `card.rejected.permission` 合一 || `reason.place.onedrive` | {path} 在 OneDrive 里,同步会打断正在写入的对话。 | `card.rejected.onedrive`(聊天记录 → 对话) || `reason.place.foreign / dsh / program / nested` | 照旧 | `card.rejected.*` |+| `reason.place.drive / workspace` | {path} 是整块磁盘,要选它里面的一个文件夹。/{path} 和总工作区互相包含。 | 新(2026-10-31):以后的启动搬数据时的「这里放不了」,意思同 `dialog.move.drive / workspace` || `reason.start.permission / space / files / engine / other` | 照旧,带句号 | `failed.reason.*` || `reason.copy.inUse / permission / full` | 照旧,片段 | `importFailed.*` |