A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.
Make the whale's ring the start window's progress
AdamPlatin123024f5c93e844
diff --git a/app/src/start-window.mjs b/app/src/start-window.mjsindex 0abebecd..dde83390 100644--- a/app/src/start-window.mjs+++ b/app/src/start-window.mjs@@ -137,8 +137,8 @@ export function growthSteps(from, to, { duration, step } = GROWTH) {}}-// When the page never sends handoffShow, the main process shows the team window itself. A first-// start and a celebrating hand-off take up to about 1.2 s, plus up to 600 ms of queued swimming.+// When the page never sends handoffShow, the main process shows the team window itself. The page+// sends it about 0.72 s after ready on a celebrating hand-off and 0.22 s otherwise (start-window §8).export const fallbackMs = ({ start, celebrate }) => (start === 'first' || celebrate ? 2500 : 800)// The five reasons of the failure page (windows-onboarding §3), most specific first: a Host@@ -180,10 +180,10 @@ export function mainBotName(state) {return typeof name === 'string' && name.trim() !== '' ? name.trim() : undefined}-// What the hint row can prepare for. previewNotice: DSH shows its preview notice when the-// Session is ready and the main view has no non-empty Session (windows-onboarding §3, the row of-// the third stop), which a data folder without a team always has. A kept or copied team may have-// read it already, and the main process cannot tell before the team view has loaded.+// What the start knows about the team it opens. The ring page no longer shows it (no greeting or+// hint lines since 2026-10-30); the snapshot keeps it for now. previewNotice: DSH shows its+// preview notice when the Session is ready and the main view has no non-empty Session, which a+// data folder without a team always has.export function explainOf({ offered = false, team } = {}) {if (offered) return { mode: 'import', nextStep: false, previewNotice: false }if (team !== undefined) {@@ -399,7 +399,7 @@ export class StartWindow {/*** The start begins again in another folder (§7): the stages go back to the start, the whale- * sinks and surfaces at the first stop, and the clock starts from 0. The first success after+ * sinks and surfaces with its arcs emptied, and the clock starts from 0. The first success after* it celebrates, as after a retry.*/restart() {diff --git a/app/src/start/start.css b/app/src/start/start.cssindex 526e1a79..36f73c46 100644--- a/app/src/start/start.css+++ b/app/src/start/start.css@@ -4,7 +4,7 @@:root{color-scheme:light dark;--bt-main:#fcfcfc;--bt-card:#ffffff;--bt-ink:#141414;--bt-ink-2:rgba(20,20,20,0.6);--bt-line:rgba(20,20,20,0.08);--bt-line-2:rgba(20,20,20,0.15);--bt-hover:rgba(119,119,119,.09);--bt-accent:#4d6bfe;--bt-accent-ink:#ffffff;--bt-ink-deepseek:#4D6BFE;--bt-green:#00c972;--bt-danger:#e02135}@media (prefers-color-scheme:dark){:root{--bt-main:#141414;--bt-card:#1f1f1f;--bt-ink:#f2f2f2;--bt-ink-2:rgba(242,242,242,0.6);--bt-line:rgba(242,242,242,0.08);--bt-line-2:rgba(242,242,242,0.15);--bt-hover:rgba(160,160,160,.12);--bt-accent:#5b7bff;--bt-accent-ink:#141414;--bt-ink-deepseek:#6A84FF}}/* /tokens */-:root{--font:-apple-system,BlinkMacSystemFont,"Segoe UI","Microsoft YaHei UI",system-ui,sans-serif;--mono:ui-monospace,Consolas,monospace;--u:.88px}+:root{--font:-apple-system,BlinkMacSystemFont,"Segoe UI","Microsoft YaHei UI",system-ui,sans-serif;--mono:ui-monospace,Consolas,monospace;--u:1.12px}/* springs *//* Generated from ds-bot/src/client/motion.js by scripts/start-assets.mjs; do not edit. */:root {@@ -35,29 +35,30 @@ code{font-family:var(--mono);font-size:inherit}.band{position:fixed;inset:0 0 auto;height:40px;-webkit-app-region:drag;app-region:drag}html[data-frame=system] .band{display:none}-/* stage: everything that moves with the later-start shift */+/* stage: everything that moves when a card needs the sheet */.stage{position:absolute;left:calc(50% - 360px);top:0;width:720px;height:100%}html[data-frame=system] .stage{top:-24px}-html:is([data-start=later],[data-start=moving]){--u:.64px}-/* Until a card needs the sheet, the whale, its line and the hint sit 80 px lower, at the+/* Until a card needs the sheet, the whale, its ring and its line sit 80 px lower, at thewindow's visual centre (an integer translation, so the text stays on whole pixels). */html:not([data-up]) .stage{translate:0 80px}-/* The whale's line: one centred line under the waterline, the only voice on the page. Every- line of text sits on whole pixels in an untransformed box and never wraps (the copy is- written to fit; the ellipsis is a last resort). */-.voice{position:absolute;left:48px;top:194px;width:624px;height:20px;text-align:center;font-size:15px;line-height:20px;font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;opacity:0;transition:opacity .16s ease-in}+/* The whale's line: one centred line under the ring, the only voice on the page, and only when+ the user is needed. Every line of text rests on whole pixels (integer translations only) and+ never wraps (the copy is written to fit; the ellipsis is a last resort). When a card needs the+ sheet, the line rises with the pond on the same spring (start.js shift()), so it stays under+ the shrunken ring. */+.voice{position:absolute;left:48px;top:334px;width:624px;height:20px;text-align:center;font-size:15px;line-height:20px;font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;opacity:0;transition:opacity .16s ease-in}.voice[data-on]{opacity:1;transition:opacity .16s ease-out}-/* The clock: top right, where the title row ended, outside the stage so it never moves with- the group; in --bt-ink-2, the lightest text the design allows on Mica (note §10). */-.elapsed{position:absolute;right:calc(50% - 312px);top:54px;width:6.5em;height:18px;text-align:right;white-space:nowrap;font-size:13px;line-height:18px;color:var(--bt-ink-2);font-variant-numeric:tabular-nums;opacity:0;transition:opacity .16s}-html[data-elapsed] .elapsed{opacity:1;transition:opacity .22s ease-out}-html[data-frame=system] .elapsed{top:30px}-html:is([data-start=later],[data-start=moving]) :is(.elapsed,.water,.trace){display:none}+html[data-up] .voice{translate:0 -108px}-/* lane: the clipped water above the line at y 180 */-.lane{position:absolute;left:48px;top:76px;width:624px;height:104px;overflow:clip;pointer-events:none}-.whale-x{position:absolute;left:76px;top:28px;width:88px;height:88px}-html:is([data-start=later],[data-start=moving]) .whale-x{left:280px;top:47px;width:64px;height:64px}+/* The pond: the ring, the water, the lane, the whale's hit box and the effects, as one block.+ The whale floats in the middle of a ring of three arcs, one per stage: centre (360, 210),+ radius 106; the waterline is its chord at y 242; the whale is 112 px. When a card needs the+ sheet, the pond shrinks to .62 and rises with the stage (start.js shift()), so the ring ends+ above the card. */+.pond{position:absolute;inset:0;pointer-events:none;transform-origin:360px 210px}+html[data-up] .pond{translate:0 -60px;scale:.62}+.lane{position:absolute;left:48px;top:102px;width:624px;height:140px;overflow:clip;pointer-events:none}+.whale-x{position:absolute;left:256px;top:43px;width:112px;height:112px}.whale-gaze,.whale,.whale-move,.whale-loop{width:100%;height:100%}/* .whale-gaze scales only for the breath at rest (whale.js), around the same pivot. */.whale-gaze,.whale,.whale-move,.whale-loop{transform-origin:49.95% 79%}@@ -66,19 +67,38 @@ html:is([data-start=later],[data-start=moving]) .whale-x{left:280px;top:47px;wid#tail{transform-box:view-box;transform-origin:27.9px 61.1px}.bt-eye,#eye-pair,#gaze{transform-box:fill-box;transform-origin:center}#gaze{transform:translate(calc(var(--gx,0) * 12%),calc(var(--gy,0) * 11%));transition:transform .18s ease-out}-.whale-hit{position:absolute;left:calc(var(--hx,168px) - 58px);top:105px;width:116px;height:86px;border-radius:50%}-html:is([data-start=later],[data-start=moving]) .whale-hit{left:318px;top:124px;width:84px;height:63px}+.whale-hit{position:absolute;left:290px;top:140px;width:140px;height:108px;border-radius:50%;pointer-events:auto}.fx{position:absolute;inset:0;pointer-events:none}-.ripple{position:absolute;left:calc(var(--rx,168px) - 28px);top:174px;width:56px;height:12px;box-sizing:border-box;border:1.5px solid var(--bt-line-2);border-radius:50%;opacity:0}+.ripple{position:absolute;left:326px;top:236px;width:68px;height:12px;box-sizing:border-box;border:1.5px solid var(--bt-line-2);border-radius:50%;opacity:0}+/* The spout: the plume is a template that whale.js clones for each spout, with its drops. */+.spout{position:absolute;left:61%;top:21%;width:0;height:0;pointer-events:none}+.plume{position:absolute;left:-24px;top:-44px;width:48px;height:48px;overflow:visible;transform-origin:50% 100%}+.plume path{fill:none;stroke:color-mix(in srgb,var(--bt-ink-deepseek) 70%,transparent);stroke-width:4;stroke-linecap:round;stroke-dasharray:1 1;stroke-dashoffset:1}+.drop{position:absolute;left:-2.75px;top:-2.75px;width:5.5px;height:5.5px;border-radius:50%;background:color-mix(in srgb,var(--bt-ink-deepseek) 70%,transparent);pointer-events:none}-/* Progress is where the whale is. The waterline is only the surface it rests on (faint, soft at- both ends, nothing drawn on it); a stop the whale has left keeps a resting ring, which never- moves again until the hand-off fades it. */-.water{position:absolute;left:48px;top:180px;width:624px;height:1px;background:linear-gradient(90deg,transparent,var(--bt-line) 12% 88%,transparent)}-.trace{position:absolute;top:174px;width:56px;height:12px;box-sizing:border-box;border:1px solid var(--bt-line-2);border-radius:50%;opacity:0}-.trace:nth-child(1){left:152px}-.trace:nth-child(2){left:344px}-.trace[data-on]{opacity:.5}+/* The ring is the progress: one arc per stage, 120 degrees each from the top, clockwise, 10+ degrees apart. Pending: a faint line. Active (whale.js, after 250 ms pending): tinted, with a+ light running along it, slower while the whale ponders. Done: drawn in the whale's blue,+ clockwise. Failed: red. The waterline is only the surface the whale rests on, soft at both+ ends. */+.ring{position:absolute;left:250px;top:100px;width:220px;height:220px;overflow:visible}+.ring path,.ring circle{fill:none;stroke-width:2;stroke-linecap:round}+.arc-base{stroke:var(--bt-line);stroke-dasharray:100 100;stroke-dashoffset:0}+.arc-fill{stroke:var(--bt-ink-deepseek);stroke-dasharray:100 100;stroke-dashoffset:100;transition:stroke-dashoffset .56s cubic-bezier(.3,.7,.4,1)}+.arc-glow{stroke:color-mix(in srgb,var(--bt-ink-deepseek) 75%,transparent);stroke-width:2.5!important;stroke-dasharray:22 200;stroke-dashoffset:22;opacity:0}+.arc[data-state=active] .arc-base{stroke:color-mix(in srgb,var(--bt-ink-deepseek) 22%,transparent)}+.arc[data-state=active] .arc-glow{opacity:1;animation:bt-arc 1.8s cubic-bezier(.4,0,.2,1) infinite}+.arc[data-state=done] .arc-fill{stroke-dashoffset:0}+.arc[data-state=failed] .arc-base{stroke:color-mix(in srgb,var(--bt-danger) 60%,transparent)}+html[data-whale=pondering] .arc[data-state=active] .arc-glow{animation-duration:2.6s}+@keyframes bt-arc{from{stroke-dashoffset:22}to{stroke-dashoffset:-100}}+/* The hand-off: the gaps close into one circle, which swells once. */+.ring-full{stroke:var(--bt-ink-deepseek);stroke-dasharray:100 100;stroke-dashoffset:100;opacity:0;transition:stroke-dashoffset .3s ease-out,opacity .3s ease-out}+html[data-ring=closed] .ring-full{stroke-dashoffset:0;opacity:1}+html[data-ring=closed] .ring{animation:bt-ring-pulse .5s cubic-bezier(.3,.7,.4,1)}+@keyframes bt-ring-pulse{0%,100%{scale:1}40%{scale:1.035}}+html[data-resume] :is(.arc-fill,.ring-full){transition:none}+.water{position:absolute;left:260px;top:242px;width:200px;height:1px;background:linear-gradient(90deg,transparent,var(--bt-line-2) 18% 82%,transparent)}.track{list-style:none}/* step marks of the copying card */.mark{position:relative;flex:none;width:16px;height:16px;border-radius:50%;box-sizing:border-box;border:1.5px solid var(--bt-line-2);transition:border-color .12s}@@ -94,8 +114,10 @@ html:is([data-start=later],[data-start=moving]) .whale-hit{left:318px;top:124px;html[data-shimmer] .voice[data-on]>span{color:transparent;background:linear-gradient(90deg,var(--bt-ink) 0 40%,var(--bt-ink-2) 50%,var(--bt-ink) 60% 100%) 0 0/300% 100%;-webkit-background-clip:text;background-clip:text;animation:bt-shimmer 2.2s steps(60) infinite}@keyframes bt-shimmer{from{background-position:100% 0}to{background-position:0 0}}-/* The hint row: one grey line that prepares the user for what comes next, or the log button. */-.caption{position:absolute;left:48px;top:220px;width:624px;height:28px;display:flex;align-items:center;justify-content:center;gap:8px;font-size:13px;line-height:18px;color:var(--bt-ink-2)}+/* The hint row: a short drive's grey note, or the log button. It sits where the sheet is, so it+ goes while a card is up; the empty sheet lets clicks through to it. */+.caption{position:absolute;left:48px;top:358px;width:624px;height:28px;display:flex;align-items:center;justify-content:center;gap:8px;font-size:13px;line-height:18px;color:var(--bt-ink-2);transition:opacity .16s}+html[data-up] .caption{opacity:0;pointer-events:none}.caption-text{min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.caption>*{opacity:0;filter:blur(6px);transition:opacity .16s,filter .16s}.caption>[data-on]{opacity:1;filter:none;transition:opacity .22s ease-out,filter .22s ease-out}@@ -104,6 +126,7 @@ html[data-shimmer] .voice[data-on]>span{color:transparent;background:linear-grad/* sheet: one surface that every card morphs in and out of */.sheet{position:absolute;left:48px;top:260px;width:624px;height:calc(100% - 304px)}+html[data-sheet=none] .sheet{pointer-events:none}.sheet-edge,.sheet-fill{position:absolute;inset:0;opacity:0;clip-path:inset(0 0 100% 0 round 12px)}.sheet-edge{background:var(--bt-line)}.sheet-fill{background:var(--bt-card)}@@ -191,12 +214,13 @@ html[data-shimmer] .voice[data-on]>span{color:transparent;background:linear-gradhtml:is([data-start=later],[data-start=moving]) .footrow{display:none}/* A work area under 588 px gets a 500 px window: the stage rises 8 px and the sheet still endsabove the footer. */-@media (max-height:520px){.stage{top:-8px}html[data-frame=system] .stage{top:-32px}.sheet{height:calc(100% - 296px)}.elapsed{top:46px}html[data-frame=system] .elapsed{top:22px}}+@media (max-height:520px){.stage{top:-8px}html[data-frame=system] .stage{top:-32px}.sheet{height:calc(100% - 296px)}}-/* entrance, keyed on data-start (no JS timing) */+/* entrance, keyed on data-start (no JS timing); the ring draws itself in as the whale surfaces */@keyframes bt-veil{from{opacity:0;filter:blur(6px)}}-@keyframes bt-enter-first{from{transform:translateY(64px) rotate(-12deg)}}-@keyframes bt-enter-later{from{transform:translateY(48px)}}+@keyframes bt-enter-first{from{transform:translateY(96px) rotate(-12deg)}}+@keyframes bt-enter-later{from{transform:translateY(84px)}}+@keyframes bt-ring-draw{from{stroke-dashoffset:100}}@keyframes bt-wake{0%{transform:scaleY(.05)}60%{transform:scaleY(1.06)}}@keyframes bt-flick-in{0%,100%{transform:none}35%{transform:rotate(-10deg)}70%{transform:rotate(8deg)}}@keyframes bt-ripple-scale{from{scale:.5}to{scale:1.6}}@@ -206,7 +230,8 @@ html[data-start=first]:not([data-resume],[data-entered]) .bt-eye{animation:bt-wahtml[data-start=first]:not([data-resume],[data-entered],[data-tier=quiet]) #tail{animation:bt-flick-in .4s ease-in-out .3s}html[data-start=first]:not([data-resume],[data-settled],[data-tier=quiet]) .ripple{animation:bt-ripple-scale var(--spring-shape-ms) var(--spring-shape) .12s backwards,bt-ripple-fade .56s linear .12s}html[data-start=first]:not([data-resume],[data-settled]) .voice{animation:bt-veil .22s ease-out .16s backwards}-html[data-start=first]:not([data-resume],[data-settled]) .water{animation:bt-veil .22s ease-out .22s backwards}+html:not([data-resume],[data-settled]) .water{animation:bt-veil .22s ease-out .22s backwards}+html:not([data-resume],[data-settled]) .arc-base{animation:bt-ring-draw .5s cubic-bezier(.3,.7,.4,1) .18s backwards}html[data-start=first]:not([data-resume],[data-settled]) :is(.note,.place){animation:bt-veil .22s ease-out .42s backwards}html:is([data-start=later],[data-start=moving]):not([data-resume],[data-entered]) .whale-move{animation:bt-enter-later var(--spring-tap-ms) var(--spring-tap) backwards}html:is([data-start=later],[data-start=moving]):not([data-resume],[data-settled]) .voice{animation:bt-veil .22s ease-out .06s backwards}@@ -232,7 +257,7 @@ html[data-tail=dash]:not([data-tier=quiet]) #tail{animation:bt-tail-dash .55s ea@keyframes bt-tail-dash{from{transform:rotate(-8deg)}to{transform:rotate(8deg)}}/* hand-off: window-level content fades */-html[data-exit~=caption] :is(.elapsed,.caption),html[data-exit~=all] :is(.voice,.water,.fx .trace,.sheet,.note,.place){opacity:0;transition:opacity .16s}+html[data-exit~=caption] .caption,html[data-exit~=all] :is(.voice,.water,.ring,.spout,.sheet,.note,.place){opacity:0;transition:opacity .16s}html[data-hidden] *{animation-play-state:paused!important}/* reduced motion (ui-standard 9.6, styles.js:106): static whale, fades only */@@ -241,12 +266,13 @@ html[data-hidden] *{animation-play-state:paused!important}:root[data-eyes=happy] .bt-eye{transform:scaleY(0)}:root[data-eyes=happy] .bt-eye-happy{opacity:1}@media (prefers-reduced-motion:reduce){-:root :is(.whale-x,.whale-gaze,.whale,.whale-move,.whale-loop,#tail,#gaze,#eye-pair,.bt-eye,.bt-eye-happy,.ripple,.trace,.stage){animation:none!important;transition:none!important}-:root :is(.voice,.water,.note,.place){animation:none!important}+:root :is(.whale-x,.whale-gaze,.whale,.whale-move,.whale-loop,#tail,#gaze,#eye-pair,.bt-eye,.bt-eye-happy,.ripple,.stage){animation:none!important;transition:none!important}+:root :is(.voice,.water,.note,.place,.arc-base,.arc-glow,.ring){animation:none!important}+:root :is(.arc-fill,.ring-full){transition-duration:.12s!important}:root .voice>span{animation:none!important;background:none!important;color:var(--bt-ink)!important}-:root :is(.voice,.caption>*,.elapsed,.card,.miss,.banner,.log,.confirm,.models,[data-u]){filter:none!important;scale:none!important;transition-property:opacity!important;transition-duration:.12s!important;transition-delay:0s!important}+:root :is(.voice,.caption>*,.card,.miss,.banner,.log,.confirm,.models,[data-u]){filter:none!important;scale:none!important;transition-property:opacity!important;transition-duration:.12s!important;transition-delay:0s!important}:root .btn:active{scale:none}:root[data-exit~=lane] .lane{opacity:0;transition:opacity .12s}}-@media (forced-colors:active){.sheet-edge{background:CanvasText}.sheet-fill{background:Canvas}.btn{border:1px solid ButtonText}.bar-fill{background:Highlight}.water{background:CanvasText}.trace{border-color:CanvasText}}+@media (forced-colors:active){.sheet-edge{background:CanvasText}.sheet-fill{background:Canvas}.btn{border:1px solid ButtonText}.bar-fill{background:Highlight}.water{background:CanvasText}.arc .arc-base{stroke:GrayText!important}.arc-fill,.ring-full,.arc-glow,.plume path{stroke:Highlight}.drop{forced-color-adjust:none;background:Highlight}}diff --git a/app/src/start/start.html b/app/src/start/start.htmlindex e45251fd..753201f2 100644--- a/app/src/start/start.html+++ b/app/src/start/start.html@@ -11,14 +11,16 @@</head><body><div class="band" aria-hidden="true"></div>-<span class="elapsed" aria-hidden="true"></span><main class="stage">+<div class="pond">+<svg class="ring" viewBox="0 0 220 220" aria-hidden="true"><g class="arc" data-state="pending"><path class="arc-base" d="M119.24 4.40A106 106 0 0 1 206.07 154.80" pathLength="100"/><path class="arc-fill" d="M119.24 4.40A106 106 0 0 1 206.07 154.80" pathLength="100"/><path class="arc-glow" d="M119.24 4.40A106 106 0 0 1 206.07 154.80" pathLength="100"/></g><g class="arc" data-state="pending"><path class="arc-base" d="M196.83 170.80A106 106 0 0 1 23.17 170.80" pathLength="100"/><path class="arc-fill" d="M196.83 170.80A106 106 0 0 1 23.17 170.80" pathLength="100"/><path class="arc-glow" d="M196.83 170.80A106 106 0 0 1 23.17 170.80" pathLength="100"/></g><g class="arc" data-state="pending"><path class="arc-base" d="M13.93 154.80A106 106 0 0 1 100.76 4.40" pathLength="100"/><path class="arc-fill" d="M13.93 154.80A106 106 0 0 1 100.76 4.40" pathLength="100"/><path class="arc-glow" d="M13.93 154.80A106 106 0 0 1 100.76 4.40" pathLength="100"/></g><circle class="ring-full" cx="110" cy="110" r="106" pathLength="100" transform="rotate(-90 110 110)"/></svg><div class="water" aria-hidden="true"></div><div class="lane"><div class="whale-x"><div class="whale-gaze"><div class="whale"><div class="whale-move"><div class="whale-loop"><!-- whale --><svg class="whale-svg" viewBox="0 0 100 100" aria-hidden="true" focusable="false"><defs><mask id="st-eyes" maskUnits="userSpaceOnUse" x="-100" y="-100" width="300" height="300"><rect x="-100" y="-100" width="300" height="300" fill="#fff"/><g id="gaze" class="bt-gaze"><g id="eye-pair" class="bt-eyes" fill="#000"><g transform="translate(72.5 48.4) rotate(-15.8)"><rect class="bt-eye" x="-4.65" y="-11.5" width="9.3" height="23" rx="4.65"/></g><g transform="translate(85.6 43.4) rotate(-21.2)"><rect class="bt-eye" x="-3.5" y="-11.45" width="7" height="22.9" rx="3.5"/></g><g transform="translate(72.5 48.4) rotate(-15.8)"><path class="bt-eye-happy" opacity="0" d="M-5.766 3.22Q0 -9.66 5.766 3.22" fill="none" stroke="#000" stroke-width="4.65" stroke-linecap="round"/></g><g transform="translate(85.6 43.4) rotate(-21.2)"><path class="bt-eye-happy" opacity="0" d="M-4.34 3.206Q0 -9.617999999999999 4.34 3.206" fill="none" stroke="#000" stroke-width="3.5" stroke-linecap="round"/></g></g></g></mask><clipPath id="st-tail-cut" clipPathUnits="userSpaceOnUse"><path d="M-100 -100H32.45V52.05L36.02 53.85L27.9 61.1L23.35 70.15L23.35 200H-100Z"/></clipPath><clipPath id="st-torso-cut" clipPathUnits="userSpaceOnUse"><path d="M32.45 -100H200V200H-100V70.15H23.35L32.45 52.05Z"/></clipPath><g id="whale-layers" fill-rule="evenodd"><g id="w-body"><path d="M65.3 20.9l5.1 .1 4.8 .9 4.8 1.7 4.3 2.3 3.8 3.1 3 3.4 2.3 3.8 1.6 4.3 .9 4.3 0 4.8-.8 4.8-1.4 4.3-2.3 4.3-3.2 4.3-3.4 3.3-4.3 3.1-7.2 3.5-7.6 1.7-7.2 .1-9.6-1.6-3.3-1-2.9-1.7-8.8-8.9-6-4.7-3.3-.5-7.7 1.1-4.8-.1-4.7-1.2-1.9-1.2-1-1-.5-1.5 .4-1.4 1.1-1.3 1.9-1.3 4.7-1.5 7.7-.6 1.1-.5 .7-1 0-1.4-2.8-7.2-1.2-5.3-.1-4.3 .4-1.4 .9-1.2 1.9-.2 2 1 2.2 2.3 2.2 3.4 3.2 7.6 1.9 9.7 .5-.1 1.1-7.2 1.8-4.8 3.2-5.2 3.9-4.3 4.9-3.9 5.6-2.9 5.8-1.9z" fill="var(--bt-ink-deepseek)"/></g><g id="w-belly"><path d="M93.3 55.8l1-.3 .1 1.2-2.4 5.3-3.4 4.8-3.8 3.8-4.8 3.4-5.7 2.8-4.8 1.5-4.8 .4 20.1-17.4 5.2-3.7z" fill="#fff" fill-opacity="1"/></g><g id="w-shade"><path d="M88.6 29.5l2.4 2.9 1.9 2.8 2.4 6.3 .5 3.3 .1 5.3-1.5 6.6-1.9 4.3-2 3.3-4.8 5.4-5.7 4.3-7.2 3.3-6.2 1.5-6.7 .1-3.3-.2-9.6-1.8-3.3-1.5-2.4-1.9-8.6-8.9-5.3-3.9-3.3-.1-2.9 .2-3.3 .8-5.8 0-4.3-1-2.9-1.9 .6-.6 3.8-1.3 10.5-2.5 4.3 .9 1.4-.1 2.2-1.7 .5-1.4-.3-1.5-1.2-1.4-2.2-1.4-1.2-1.9-.6-12 .4-3.3 .5-.5 2.9 3.8 2.4 4.8 1.9 5.7 .7 5.8 .7 2.8 2.1 2.4 2.7 5.5 3.8 4.3 2.9 2.2 3.3 1 3.4-.4 6.2-3 7.1-4.5 7.3-5.6 6.6-5.9 5.9-6.5 3.7-5.3 1.7-4.2 .1-2.9z" fill="#000" fill-opacity=".14"/></g><g id="w-light"><path d="M55.6 22.8l1.9-.3 1.5 .3 .6 1 .1 .9-2 4.3-3.8 5.3-5.8 6.2-5.4 4.4-4.8 2.3-1.4 0-1.2-.5-.8-1.9 .5-3.3 2.5-4.8 3.3-4.3 2.4-2.4 5.3-3.9zM19.3 28.1l-1.4 2 .3-1.1zM21.7 49.1l.6 .5-.3 .5-.8 0zM35.8 52l1.2-.4 .9 .7 .7 1.6-.4 .9-1.2 .1-2.6-.5zM7.2 52.9l-2.9 2.9 1.2-1.6z" fill="#fff" fill-opacity=".16"/></g></g></defs><g class="bt-b"><g mask="url(#st-eyes)"><g id="tail"><use href="#whale-layers" clip-path="url(#st-tail-cut)"/></g><g id="torso"><use href="#whale-layers" clip-path="url(#st-torso-cut)"/></g></g></g></svg><!-- /whale -->-</div></div></div></div></div></div>+</div></div></div></div><span class="spout"><svg class="plume" viewBox="-24 -44 48 48" aria-hidden="true" hidden><path class="stem" d="M0 0V-27" pathLength="1"/><path class="curl" d="M0 -27C-3 -37 -13 -40 -18 -31" pathLength="1"/><path class="curl" d="M0 -27C3 -37 13 -40 18 -31" pathLength="1"/></svg></span></div></div><div class="whale-hit" aria-hidden="true"></div>-<div class="fx" aria-hidden="true"><span class="trace"></span><span class="trace"></span><span class="ripple"></span></div>+<div class="fx" aria-hidden="true"><span class="ripple"></span></div>+</div><ol class="track sr" data-t-label="status.track"><li class="station" data-phase="data" data-state="pending"><span data-t="status.phase.data"></span> <span class="sr"></span></li><li class="station" data-phase="engine" data-state="pending"><span data-t="status.phase.engine"></span> <span class="sr"></span></li>diff --git a/app/src/start/start.js b/app/src/start/start.jsindex 29208b1c..ecf3397e 100644--- a/app/src/start/start.js+++ b/app/src/start/start.js@@ -1,8 +1,8 @@// The start page: binds window.dsBotStart and applies each full snapshot to the page (the-// whale's line, the hint row and the clock, the sheet and its cards, focus and the live-// region). The whale, its rings and the hidden stage list belong to the director in whale.js;-// the whale's line follows where the director has the whale, not the snapshot alone. Text is-// set only through textContent (and text nodes), never as markup.+// whale's line and the hint row, which speak only when the user is needed, the sheet and its+// cards, focus and the live region). The whale, the ring of arcs that is the progress and the+// hidden stage list belong to the director in whale.js. Text is set only through textContent+// (and text nodes), never as markup.import { fill as fillIn, t } from './text.mjs'import { createDirector, reduced, play, spring, sleep, clamped } from './whale.js'@@ -18,9 +18,9 @@ const first = START === 'first'root.dataset.sheet = 'none'const $ = selector => document.querySelector(selector)-const sheet = $('.sheet'), edge = $('.sheet-edge'), fill = $('.sheet-fill'), stage = $('.stage'), live = $('.live')+const sheet = $('.sheet'), edge = $('.sheet-edge'), fill = $('.sheet-fill'), stage = $('.stage'), pond = $('.pond'), live = $('.live')const voiceEl = $('.voice'), voiceText = $('.voice>span')-const captionText = $('.caption-text'), logs = $('.caption .btn'), elapsed = $('.elapsed')+const captionText = $('.caption-text'), logs = $('.caption .btn')const placeEl = $('.place'), placeText = $('.place-text')const CODE = new Set(['path', 'dataDir', 'workspace'])let lang = 'zh'@@ -68,7 +68,7 @@ function placeUI(place) {function varsOf(snap) {const card = snap.card ?? {}const update = snap.update ?? {}- const vars = { ...snap.explain, ...card }+ const vars = { ...card }if (snap.view === 'failed' || snap.view === 'viewFailed') vars.reason = snap.failure?.reason ?? 'other'if (card.kind === 'importFailed') vars.reason = say(`reason.copy.${card.reason}`)if (card.kind === 'newerUpdating') vars.p = card.percent ?? 0@@ -78,129 +78,51 @@ function varsOf(snap) {function announce(text) { if (text) live.textContent = text }// ---- the whale's line -----// One short line at a time, under the waterline. It follows the whale: the stop it is at, the-// stage shown active there, the leg it is swimming. A card speaks with its own first line, so-// the whale's line is empty while a card is up (the 180 s question is the exception: its card-// holds only the buttons). Each line stays long enough to read before the next replaces it;-// lines skipped meanwhile are never shown late; the line is empty while the whale sinks to start-// over in a new folder. A failure and the 180 s question come at once;-// 「进去吧」 lets the line before it be read for READ_MS first, and the director starts the-// celebration READY_MS (whale.js) after 「进去吧」 is up.-const HOLDS = { 'voice.hello': 1500, 'voice.found': 700 }-// The line of a later start, a data move and the two failure views.-const VOICES = { later: 'voice.opening', moving: 'voice.moving', failed: 'voice.failed', viewFailed: 'voice.viewFailed' }-const HOLD_MS = 900-const READ_MS = 400+// One short line under the ring, and only when the user is needed: a start that runs past 45 s,+// the 180 s question, a failure. A data move (which the user started, and which takes a while)+// keeps its line. A card speaks with its own first line, so the whale's line is empty while a+// card is up (the 180 s question is the exception: its card holds only the buttons). A new line+// fades in once the old one has faded out.+const VOICES = { failed: 'voice.failed', viewFailed: 'voice.viewFailed', watchdog: 'voice.watchdog' }const FADE_MS = 160-// Lines put up while a reloaded page catches up are not held.-const catchUp = resume ? performance.now() + 1000 : 0-// key/text: the line chosen (on screen, or coming in once the old one has faded out); shown/at:-// the line on screen and when it went up; last: the last line that really went up.-const v = { key: '', text: '', shown: '', at: 0, timer: 0, swap: 0, renaming: false, last: '', cards: false, readyAt: 0, waiters: [] }-const readyLine = () => (v.readyAt ? Promise.resolve(v.readyAt) : new Promise(resolve => v.waiters.push(resolve)))+// key/text: the line chosen (on screen, or coming in once the old one has faded out).+const v = { key: '', text: '', swap: 0 }+// Past 45 s with the engine not up yet: the whale says why it takes so long.+const late = () => ['boot', 'moving'].includes(s.view) && !(s.done ?? []).includes('engine') && bootMs() >= 45000function voiceWant() {- const view = s.view- if (view === 'failed' || view === 'viewFailed') return [VOICES[view], true]- if (view === 'watchdog') return ['voice.watchdog', true]- if (view === 'card') return ['', false]- if (!first) return [VOICES[START], true]- if (view === 'handoff') return ['voice.ready', false]- const st = director.stage()- // The whale is sinking to start over: the line goes with it, without the usual hold.- if (st.sinking) return ['', true]- if (st.ready) return ['voice.ready', false]- if (st.at >= 2 || (st.at === 1 && st.legging)) return ['voice.team', false]- const ms = bootMs()- const engineDone = (s.done ?? []).includes('engine')- if (view === 'boot' && !engineDone && ms >= 45000) return ['voice.slow45', false]- if (view === 'boot' && !engineDone && ms >= 10000) return ['voice.slow10', false]- // Not once the stage is done and the whale only waits for the greeting before it leaves.- if (st.active === 0 && !(s.done ?? []).includes('data')) return ['voice.data', false]- // 「找到了」 comes once after 「先找个地方放东西」, also when the second stage turns active while- // the old line is still fading out: the second stage starts 250 ms after the first is done.- if (v.last === 'voice.data' && (st.at === 1 || st.legging)) return ['voice.found', false]- if (st.active === 1) return ['voice.engine', false]- // Between stages: 「找到了」 answers 「先找个地方放东西」 only if that was said; the greeting- // stays until there is news, unless a card has already spoken.- if (['voice.data', 'voice.found'].includes(v.last) && (st.at === 1 || st.legging)) return ['voice.found', false]- if (!v.cards && (!v.last || v.last === 'voice.hello')) return ['voice.hello', false]- return [st.at === 0 ? 'voice.data' : 'voice.engine', false]-}-// The greeting names the Main Bot the user is about to meet: the team's own on a reinstall, the-// default name for a new team. A team to import has no name yet (the answer decides which Main-// Bot it is), and neither has a reinstall whose name could not be read. It stays one key-// (voice.hello) whichever words it takes: the main process may learn the team after the window-// opens, and the greeting on screen then fades over to the new words as a new line.-function greeting() {- const e = s.explain ?? {}- if (e.mode === 'import' || (e.mode === 'reinstall' && !e.name)) return say('voice.helloBack')- return e.name ? say('voice.helloName', { name: e.name }) : say('voice.hello')+ if (VOICES[s.view]) return VOICES[s.view]+ if (s.view === 'card') return ''+ if (late()) return first ? 'voice.slow45' : 'voice.slowLater'+ return START === 'moving' ? 'voice.moving' : ''}function speak() {- clearTimeout(v.timer)if (!s) return- const [key, urgent] = voiceWant()- if (!urgent && v.key === 'voice.hello' && v.shown === 'voice.hello' && !v.swap && voiceEl.hasAttribute('data-on') && greeting() !== v.text) {- v.text = greeting()- delete voiceEl.dataset.on- // The new greeting has not been read yet: no other line takes its place while it fades in.- v.renaming = true- v.swap = setTimeout(() => { v.renaming = false; put(); speak() }, reduced() ? 120 : FADE_MS)- return- }- const text = key === 'voice.hello' ? greeting() : key ? say(key) : ''+ const key = voiceWant()+ const text = key ? say(key) : ''if (key === v.key) { if (text !== v.text) { v.text = text; if (!v.swap) voiceText.textContent = text } return }- // The old line is already fading out: the new choice simply takes its place.- if (v.swap) { if (!v.renaming) { v.key = key; v.text = text } return }- const hold = urgent ? 0 : key === 'voice.ready' ? READ_MS : HOLDS[v.shown] ?? HOLD_MS- const left = v.shown ? v.at + hold - performance.now() : 0- if (left > 0) { v.timer = setTimeout(speak, left); return }v.key = keyv.text = text- if (!v.shown || !voiceEl.hasAttribute('data-on')) { put(); return }+ // The old line is already fading out: the new choice simply takes its place.+ if (v.swap) return+ if (!voiceEl.hasAttribute('data-on')) { put(); return }delete voiceEl.dataset.onv.swap = setTimeout(put, reduced() ? 120 : FADE_MS)}function put() {v.swap = 0- v.shown = v.keyvoiceText.textContent = v.textvoiceEl.toggleAttribute('data-on', Boolean(v.text))- v.at = performance.now() < catchUp ? -Infinity : performance.now()- if (!v.shown) return- v.last = v.shown- if (v.shown === 'voice.failed' || v.shown === 'voice.viewFailed') announce(v.text)- if (v.shown === 'voice.ready' && !v.readyAt) { v.readyAt = performance.now(); for (const resolve of v.waiters.splice(0)) resolve(v.readyAt) }+ if (v.key === 'voice.failed' || v.key === 'voice.viewFailed') announce(v.text)}-// ---- the hint row and the clock -----// The hint prepares the user for what comes next and is empty otherwise: the model to connect-// at the second stop (the team carried over on a reinstall), DSH's preview notice on the way to-// the last one; a short drive's one-line note for the first 10 s (as before). From 45 s the row-// holds only 〔打开日志文件夹〕, since the whale's line says why. Later starts keep their decided-// lines. Nothing shows while a card, the 180 s question or a failure is up.+// ---- the hint row ----+// Empty unless the user is needed: a short drive's one-line note for the first 10 s, and from+// 45 s 〔打开日志文件夹〕 alone, since the whale's line says why. Nothing shows while a card, the+// 180 s question or a failure is up.function hintWant() {- const view = s.view- const ms = bootMs()- const sec = Math.floor(ms / 1000)- if (!first) {- if (view !== 'boot' && view !== 'moving') return ['', {}, false]- if (ms >= 45000) return ['hint.slowLater', {}, true]- if (ms >= 10000) return ['status.elapsed', { n: sec }, false]- return [s.hint ? 'hint.space' : '', { ...s.hint }, false]- }- if (view !== 'boot' && view !== 'handoff') return ['', {}, false]- const engineDone = (s.done ?? []).includes('engine')- if (view === 'boot' && !engineDone && ms >= 45000) return ['', {}, true]- const st = director.stage()- if (st.sinking) return ['', {}, false]- const e = s.explain ?? {}- const toTeam = view === 'handoff' || st.ready || st.at >= 2 || (st.at === 1 && st.legging)- if (toTeam && e.previewNotice) return ['hint.preview', {}, false]- if (s.hint && ms < 10000) return ['hint.space', { ...s.hint }, false]- if (st.at >= 1 && e.mode === 'reinstall') return ['hint.reinstall', e, false]- if (st.at >= 1 && e.nextStep !== false) return ['hint.model', {}, false]- return ['', {}, false]+ if (s.view !== 'boot' && s.view !== 'moving') return ['', {}, false]+ if (late()) return ['', {}, true]+ return [s.hint && bootMs() < 10000 ? 'hint.space' : '', { ...s.hint }, false]}let shimmerReady = falseif (!first) setTimeout(() => { shimmerReady = true; if (s) shimmer() }, resume ? 0 : 1000)@@ -208,6 +130,7 @@ const shimmer = () => root.toggleAttribute('data-shimmer', shimmerReady && (s.vi// The main process's boot clock: ms at the wall time `at`, paused while a card waits on the user.const bootMs = () => { const c = s?.clock; if (!c) return 0; return c.running ? c.ms + Math.max(0, Date.now() - c.at) : c.ms }let tick = 0+// Runs on every snapshot and on each second of the boot clock: the 10 s and 45 s marks.function timeUI() {clearTimeout(tick)if (!s) return@@ -215,12 +138,6 @@ function timeUI() {const sec = Math.floor(ms / 1000)const booting = s.view === 'boot' || s.view === 'moving'const engineDone = (s.done ?? []).includes('engine')- if (first) {- // The clock stays through 「进去吧」 and fades with the hint row when the celebration starts.- const shown = (booting || s.view === 'handoff') && ms >= 5000- root.toggleAttribute('data-elapsed', shown)- if (shown) elapsed.textContent = say('status.elapsed', { n: sec })- }hint()speak()if (booting) director.slow(first && engineDone ? 0 : ms >= 45000 ? 2 : ms >= 10000 ? 1 : 0)@@ -303,12 +220,21 @@ function enter(el) {el.inert = falseel.hidden = false}+// The whale's line fades and veils in on CSS; shift() cancels only its scripted rise.+const rises = el => el.getAnimations().filter(a => !(a instanceof CSSTransition) && !(a instanceof CSSAnimation))+// The stage rises to make room for the sheet; the pond (the whale and its ring) shrinks and+// rises with it on the same spring, so the ring ends above the card, and the whale's line rises+// with them so that it stays under the ring (start.css html[data-up]).function shift(up, jump) {const from = getComputedStyle(stage).translate- for (const a of stage.getAnimations()) a.cancel()+ const pondFrom = { scale: getComputedStyle(pond).scale, translate: getComputedStyle(pond).translate }+ const voiceFrom = getComputedStyle(voiceEl).translate+ for (const a of [...stage.getAnimations(), ...pond.getAnimations(), ...rises(voiceEl)]) a.cancel()root.toggleAttribute('data-up', up)if (jump || reduced()) returnplay(stage, [{ translate: from }, { translate: up ? '0px 0px' : '0px 80px' }], { ...spring('shape'), fill: 'none' })+ play(pond, [pondFrom, { scale: up ? '.62' : '1', translate: up ? '0px -60px' : '0px 0px' }], { ...spring('shape'), fill: 'none' })+ play(voiceEl, [{ translate: voiceFrom }, { translate: up ? '0px -108px' : '0px 0px' }], { ...spring('shape'), fill: 'none' })}async function showBlock(name, jump) {if (name === shown) return@@ -320,7 +246,6 @@ async function showBlock(name, jump) {const el = blockEl(name)if (name && el) {root.dataset.sheet = 'card'- v.cards = trueif (!root.hasAttribute('data-up')) {shift(true, jump)if (!jump) { await sleep(70); if (mine !== sheetRun) return }@@ -513,10 +438,7 @@ matchMedia('(prefers-reduced-motion: reduce)').addEventListener('change', () =>new MutationObserver(() => director.refresh()).observe(root, { attributes: true, attributeFilter: ['data-motion'] })// ---- snapshots -----// The director reports every change of where the whale is (a stage shown active, a leg begun-// or ended, a reset, 「进去吧」); the line and the hint follow.-const onStage = () => { if (s) { hint(); speak() } }-const director = createDirector({ start: START, resume, act: (name, detail) => bridge?.act(name, detail), label: say, announce, onStage, readyLine })+const director = createDirector({ start: START, resume, act: (name, detail) => bridge?.act(name, detail), label: say, announce })let applied = falsefunction apply(next) {const jump = !applied && resumediff --git a/app/src/start/text.mjs b/app/src/start/text.mjsindex e716cd38..7a06582c 100644--- a/app/src/start/text.mjs+++ b/app/src/start/text.mjs@@ -15,7 +15,7 @@// leaves the card ends in …; no full stop// note card footnotes: one sentence ending in 。 that says where to change it later// foot the footer row: no full stop-// status screen readers and counters only: no full stop+// status screen readers only: no full stop// dialog system dialogs: sentences ending in 。 or ?, picker titles without a full stop//// Placeholders are {name}; paths, sizes, names and versions come from the snapshot or the@@ -23,18 +23,9 @@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.opening': '正在打开你的团队…','voice.moving': '正在搬 DeepSeek Bot 的数据…','voice.failed': 'DeepSeek Bot 没能启动','voice.viewFailed': '团队界面没有加载出来',@@ -50,11 +41,7 @@ export const TEXT = {'say.newer': '这些对话比我新','say.copying': '正在搬过来',// hint- 'hint.model': '待会儿要接一个模型:DeepSeek 账号或 API Key',- 'hint.preview': '里面先有一页说明,点「继续」就行',- 'hint.reinstall': '上次的 {bots} 个 Bot 和 {groups} 个群聊都在','hint.space': '{drive} 盘只剩 {free}',- 'hint.slowLater': '比平时慢,请再等一会儿',// card'card.recommend.ask': '放到 {rec} 盘(剩 {recFree})?','card.missing.lead': '找不到数据文件夹 {path}。可能是移动硬盘没插上,或者文件夹被移走、删除了。旧数据不会被改动。',@@ -154,7 +141,6 @@ export const TEXT = {'status.state.failed': '没有完成','status.sr.active': '{phase}:进行中','status.sr.done': '{phase}:已完成',- 'status.elapsed': '已用 {n} 秒',// dialog'dialog.pickRoot': '选择 DeepSeek Bot 放数据的位置','dialog.pickMove': '选择 DeepSeek Bot 数据的新文件夹',@@ -183,18 +169,9 @@ export const TEXT = {},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.opening': 'Opening your team…','voice.moving': 'Moving DeepSeek Bot’s data…','voice.failed': 'DeepSeek Bot couldn’t start','voice.viewFailed': 'The team view didn’t load',@@ -210,11 +187,7 @@ export const TEXT = {'say.newer': 'These chats are newer than me','say.copying': 'Moving your team in',// hint- 'hint.model': 'Next you’ll connect a model: a DeepSeek account or an API Key',- 'hint.preview': 'A notice page comes first; just click “Continue”',- 'hint.reinstall': 'Your {bots|Bot|Bots} and {groups|group chat|group chats} are still here','hint.space': 'Only {free} left on drive {drive}',- 'hint.slowLater': 'Slower than usual; please wait a little longer',// card'card.recommend.ask': 'Put it on drive {rec} ({recFree} free)?','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.',@@ -314,7 +287,6 @@ export const TEXT = {'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',diff --git a/app/src/start/whale.js b/app/src/start/whale.jsindex 64a453e9..8fdff572 100644--- a/app/src/start/whale.js+++ b/app/src/start/whale.js@@ -1,9 +1,10 @@-// The whale director: turns start snapshots into whale motion. The whale's place is the-// progress: it swims from stop to stop, leaves a resting ring at each stop it leaves, and keeps-// the hidden stage list (.station data-state, aria-current) for the live region and screen-// readers. start.js reads stage() to choose the whale's line.-// Layers (start.html): .whale-x legs > .whale-gaze pointer > .whale scale > .whale-move-// one-shots > .whale-loop CSS state loops > svg (#tail, #eye-pair, #gaze, .bt-eye).+// The whale director: turns start snapshots into whale motion. The whale stays in the middle of+// a ring of three arcs, one per stage, and the ring is the progress: an arc turns active, then+// fills as its stage is done, and the ring closes at the hand-off. The director keeps the arcs+// (.arc data-state) and the hidden stage list (.station data-state, aria-current) for the live+// region and screen readers. A click on the whale makes it spout.+// Layers (start.html): .whale-x the box (gaze, spout) > .whale-gaze pointer > .whale scale >+// .whale-move one-shots > .whale-loop CSS state loops > svg (#tail, #eye-pair, #gaze, .bt-eye).// One-shots run on WAAPI and end with commitStyles() + cancel(); loops are CSS keyed on// html[data-whale] and html[data-tail]. Every await is raced against a timer, because a// hidden document stops ticking animations.@@ -26,13 +27,13 @@ const PHASES = ['data', 'engine', 'team']// An active station and a state loop each hold at least 400 ms; the margin covers the frame// on which the change is painted.const HOLD = 420-// The greeting's fade-in (.16 s, start.css) and hold (1.5 s, start.js): the whale sets off from-// the first stop no earlier.-const GREET_MS = 1660-// 「进去吧」 is on screen at least this long before the celebration starts; the page says when it-// went up (readyLine), and the director waits for that at most READY_CAP.-const READY_MS = 300-const READY_CAP = 600+// The first arc fills this long after the whale has surfaced, so that it is seen to fill: the+// data stage is usually done before the page has painted.+const FIRST_ARC_MS = 260+// The whale is 112 px on every kind of start (start.css --u). Starting over in a new folder, it+// sinks this far: under the waterline.+const u = 1.12+const SINK = 84// Hops land at .55 of their 1.3 s cycle; the lively tier spaces further hops out, never closer.const HOP_MS = 1300const LANDED = 0.55 * HOP_MS@@ -93,20 +94,19 @@ function to(el, props, opts) {const kf = (frames, easing) => frames.map(frame => ({ easing, ...frame }))export const clamped = easing => easing.replace(/\d+\.\d+/gu, value => String(Math.min(1, Number(value))))-export function createDirector({ start, resume, act, label, announce, onCheck, onActive, onStage, readyLine }) {+export function createDirector({ start, resume, act, label, announce, onCheck, onActive }) {const $ = selector => document.querySelector(selector)const x = $('.whale-x'), gazeLayer = $('.whale-gaze'), body = $('.whale'), move = $('.whale-move'), loop = $('.whale-loop')const tail = $('#tail'), pair = $('#eye-pair'), lane = $('.lane'), ripple = $('.ripple'), hit = $('.whale-hit')const eyes = [...document.querySelectorAll('.bt-eye')], happy = [...document.querySelectorAll('.bt-eye-happy')]const stations = [...document.querySelectorAll('.station')]- const traces = [...document.querySelectorAll('.trace')]+ const arcs = [...document.querySelectorAll('.arc')]const first = start === 'first'- const u = (first ? 88 : 64) / 100const t0 = performance.now()const entranceMs = resume ? 0 : first ? 560 : 290- const D = { at: 0, checks: 0, pose: 'enter', loop: '', card: '', slow: 0, bx: 0, by: 0, since: [t0], activeAt: [], loopAt: 0, hop: null, pet: null, poking: false, handed: false, workReady: first, missed: false, sinking: false,+ const D = { at: 0, checks: 0, pose: 'enter', loop: '', card: '', slow: 0, bx: 0, by: 0, since: [t0], activeAt: [], loopAt: 0, hop: null, pet: null, handed: false, workReady: first, missed: false, sinking: false,// Rest on a card: its clock, the lean, the breath, the lively hops; the last glance and press.- clockKind: '', cardAt: 0, ready: false, readyAt: 0, lean: false, leanDue: false, leanOff: false, leanMine: -1, restMine: -1, breath: null, hopsStopped: false, legging: false, glanceAt: -Infinity, press: null, nodAt: 0 }+ clockKind: '', cardAt: 0, lean: false, leanDue: false, leanOff: false, leanMine: -1, restMine: -1, breath: null, hopsStopped: false, legging: false, glanceAt: -Infinity, press: null, nodAt: 0 }const rnd = Math.randomlet want = { station: 0, view: 'boot', phase: 'data', done: [], card: '', missed: false, celebrate: first, update: '' }let token = 0@@ -138,38 +138,22 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oif (resume) instant = trueif (!first) setTimeout(() => { D.workReady = true; if (D.started) kick() }, resume ? 0 : 1000)- // ---- stages: the hidden list, and the rings the whale leaves behind ----- const changed = () => onStage?.()+ // ---- stages: the ring's arcs and the hidden list ----+ // Each arc carries its stage's state: pending (faint), active (tinted, a light running along+ // it), done (drawn in the whale's blue) or failed (red); start.css draws them.function setStation(i, state) {const st = stations[i]if (!st || st.dataset.state === state) returnst.dataset.state = state+ arcs[i].dataset.state = statest.querySelector('.sr').textContent = label(`status.state.${state}`)if (state === 'active') st.setAttribute('aria-current', 'step')else st.removeAttribute('aria-current')}- // A stop the whale leaves keeps a faint ring on the water: it opens like a ripple and settles- // at the resting opacity of .trace[data-on], then never animates again. The quiet tier and- // reduced motion only fade it in.- function leaveTrace(i) {- const ring = traces[i]- if (!ring || ring.hasAttribute('data-on')) return- ring.dataset.on = ''- if (instant) return- const rest = Number(cs(ring).opacity)- const anims = reduced() || !playful()- ? [play(ring, [{ opacity: 0 }, { opacity: rest }], { duration: reduced() ? 120 : 160, fill: 'none' })]- : [play(ring, [{ scale: '.5' }, { scale: '1' }], { ...spring('shape'), fill: 'none' }), play(ring, [{ opacity: 0.9 }, { opacity: rest }], { duration: 420, easing: 'ease-out', fill: 'none' })]- // Dropped once done, so the hand-off's opacity fade of the ring finds no other animation on- // it and stays on the compositor.- for (const a of anims) a.done.then(() => a.cancel())- }function popCheck(i) {if (D.checks > i) returnD.checks = i + 1setStation(i, 'done')- // The last stop gets no ring: the whale dives there.- if (i < 2) leaveTrace(i)announce(label('status.sr.done', { phase: label(`status.phase.${PHASES[i]}`) }))onCheck?.(i)}@@ -177,7 +161,7 @@ export function createDirector({ start, resume, act, label, announce, onCheck, ofunction armActive() {clearTimeout(activeTimer)const i = D.at- if (!first || D.handed || failure() || i > 2 || D.checks > i || stations[i].dataset.state !== 'pending') return+ if (D.handed || failure() || i > 2 || D.checks > i || stations[i].dataset.state !== 'pending') returnif (i < 2 && want.done.includes(PHASES[i])) returnconst now = performance.now()const delay = Math.max(0, (D.since[i] ?? now) + 250 - now, t0 + entranceMs - now)@@ -187,13 +171,8 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oD.activeAt[i] = performance.now()announce(label('status.sr.active', { phase: label(`status.phase.${PHASES[i]}`) }))onActive?.(i)- changed()}, instant ? 0 : delay)}- function place() {- hit.style.setProperty('--hx', `${168 + D.at * 192}px`)- ripple.style.setProperty('--rx', `${180 + D.at * 192}px`)- }// ---- loops ----const capture = () => ({ loop: cs(loop).transform, tail: cs(tail).transform, pair: cs(pair).transform, eyes: eyes.map(eye => cs(eye).transform) })@@ -239,11 +218,11 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oif (D.slow === 1) calm()if (name === 'working') wanderLater()}- // While it works at the second stop, the whale glances left or right now and then (§3, the+ // While it works on the second stage, the whale glances left or right now and then (§3, the// small reactions): every 5 to 9 s, a 600 ms look to one side at random, over the bob. Not in// the quiet tier, with reduced motion or while thinking, and not while the eyes follow the// pointer or a control, or look at the user.- // Only the second stop of a first start: later and moving starts, and the copying cards, use+ // Only the second stage of a first start: later and moving starts, and the copying cards, use// the working loop too.const wandering = () => first && D.at === 1 && !D.card && playful() && D.loop === 'working' && D.slow < 2function wanderLater() {@@ -252,7 +231,7 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oD.wander = setTimeout(() => { wander(); wanderLater() }, 5000 + 4000 * rnd())}function wander() {- if (!wandering() || D.gazeHold || D.pet || D.poking || D.hop || D.handed || document.hidden) return+ if (!wandering() || D.gazeHold || D.pet || D.hop || D.handed || document.hidden) returnif (pointer || (focused && focused === document.activeElement)) returnconst side = `translateX(${rnd() < 0.5 ? -14 : 14}%)`D.wanderAnim = play(pair, kf([{ transform: 'none' }, { transform: side, offset: 0.25 }, { transform: side, offset: 0.7 }, { transform: 'none' }], 'ease-in-out'), { duration: 600, fill: 'none' })@@ -287,13 +266,13 @@ export function createDirector({ start, resume, act, label, announce, onCheck, o// ---- one-shots ----function nod() {- if (!playful() || instant || ['down', 'lift', 'dive'].includes(D.pose) || D.pet || D.poking || D.hop) return+ if (!playful() || instant || ['down', 'lift', 'dive'].includes(D.pose) || D.pet || D.hop) return// One answer nods once, whichever listener asks first.if (performance.now() - D.nodAt < 150) returnD.nodAt = performance.now()const a = play(move, [{ transform: 'none' }, { transform: 'translateY(2px) rotate(3deg)' }], { ...spring('tap'), fill: 'forwards' })setTimeout(() => {- if (D.pet || D.hop || D.poking) return+ if (D.pet || D.hop || D.handed) returnconst from = cs(move).transforma.cancel()const b = play(move, [{ transform: from }, { transform: 'none' }], spring('shape'))@@ -322,7 +301,7 @@ export function createDirector({ start, resume, act, label, announce, onCheck, ohappy.forEach(arc => to(arc, { opacity: on ? '1' : '0' }, { duration: 120, delay: on ? 100 : 0, easing: 'ease-out' }))}function petStart() {- if (!playful() || !['alert', 'rest'].includes(D.pose) || D.pet || D.poking || D.handed) return+ if (!playful() || !['alert', 'rest'].includes(D.pose) || D.pet || D.handed) returnstopHop()D.hopsStopped = trueleanOut()@@ -342,16 +321,84 @@ export function createDirector({ start, resume, act, label, announce, onCheck, ohappyEyes(false)leanIn()}- async function poke() {- if (!first || !playful() || D.poking || D.pet || D.hop || D.handed || ['down', 'lift', 'dive', 'sunk', 'enter'].includes(D.pose)) return- D.poking = true- drop(move)- move.style.transformOrigin = '50% 60%'- const a = play(move, kf([{ transform: 'none' }, { transform: `translateY(${(-9.3 * u).toFixed(2)}px) rotate(360deg)`, offset: 0.55 }, { transform: 'translateY(0) scale(1.08,.92) rotate(360deg)', offset: 0.78 }, { transform: 'rotate(360deg)' }], HOP), { duration: 800, fill: 'none' })- await a.done- a.cancel()- move.style.removeProperty('transform-origin')- D.poking = false+ // ---- the spout: a click on the whale ----+ // A column rises from the blowhole, opens into two curls and lifts off, and drops fall from the+ // curls back into the water, with a ripple where they land. Four clicks within 2.5 s make a+ // bigger one; a whale that is down only puffs. Reduced motion: the ^ ^ eyes only.+ const plume = $('.plume')+ const spoutEl = $('.spout')+ let clicks = []+ let happyTimer = 0+ function fallDrop(dx0, dy0, { dx, fall, delay, size = 5.5 }) {+ const el = document.createElement('span')+ el.className = 'drop'+ el.style.width = el.style.height = `${size.toFixed(1)}px`+ spoutEl.append(el)+ const a = el.animate([+ { translate: `${dx0}px ${dy0}px`, scale: '.8', opacity: 0.95 },+ { translate: `${(dx0 + dx).toFixed(1)}px ${(dy0 + fall).toFixed(1)}px`, scale: '1', opacity: 0.55 },+ ], { duration: 520 + rnd() * 120, delay, easing: 'cubic-bezier(.5,0,.9,.5)', fill: 'backwards' })+ a.finished.then(() => el.remove(), () => el.remove())+ }+ function spout({ big = false, small = false } = {}) {+ if (!plume || reduced() || instant) return+ const k = small ? 0.55 : big ? 1.35 : tier() === 'quiet' ? 0.85 : 1+ const shape = plume.cloneNode(true)+ // An SVG element has no hidden property: the attribute itself goes.+ shape.removeAttribute('hidden')+ shape.style.scale = String(k)+ spoutEl.append(shape)+ const [stem, ...curls] = shape.querySelectorAll('path')+ const rise = 'cubic-bezier(.2,.7,.4,1)'+ stem.animate([{ strokeDashoffset: 1 }, { strokeDashoffset: 0 }], { duration: 170, easing: rise, fill: 'forwards' })+ stem.animate([{ strokeDashoffset: 0 }, { strokeDashoffset: -1 }], { duration: 260, delay: 380, easing: 'ease-in', fill: 'forwards' })+ if (small) {+ for (const curl of curls) curl.remove()+ fallDrop(0, -27 * k, { dx: 3, fall: 46, delay: 300, size: 5 })+ } else {+ for (const curl of curls) {+ curl.animate([{ strokeDashoffset: 1 }, { strokeDashoffset: 0 }], { duration: 200, delay: 120, easing: rise, fill: 'forwards' })+ curl.animate([{ strokeDashoffset: 0, opacity: 1 }, { strokeDashoffset: -0.7, opacity: 0 }], { duration: 240, delay: 420, easing: 'ease-in', fill: 'forwards' })+ }+ const per = big ? 3 : 2+ for (const side of [-1, 1]) for (let i = 0; i < per; i += 1) fallDrop(side * 18 * k, -31 * k, { dx: side * (4 + i * 5 + rnd() * 3), fall: 70 + i * 10 + rnd() * 10, delay: 330 + i * 70, size: 5 + rnd() * 1.5 })+ fallDrop(0, -38 * k, { dx: (rnd() - 0.5) * 6, fall: 80, delay: 400, size: 6 })+ // At the hand-off the dive sends the ripple; this one would land as the window grows.+ if (!D.handed) setTimeout(sendRipple, 760)+ }+ setTimeout(() => shape.remove(), 900)+ }+ function squash(big) {+ drop(body)+ const a = play(body, kf([{ scale: '1' }, { scale: big ? '1.12 .88' : '1.07 .93', offset: 0.3 }, { scale: '.96 1.05', offset: 0.62 }, { scale: '1' }], OUT), { duration: 460, fill: 'none' })+ a.done.then(() => a.cancel())+ const t = play(tail, [{ transform: 'none' }, { transform: 'rotate(12deg)' }, { transform: 'none' }], { duration: 380, easing: 'ease-in-out', fill: 'none' })+ t.done.then(() => t.cancel())+ }+ // No spout once the team is ready: the hand-off spouts by itself.+ function spoutClick() {+ if (D.handed || want.view === 'handoff' || ['dive', 'sunk', 'enter'].includes(D.pose) || D.sinking) return+ const now = performance.now()+ clicks = clicks.filter(at => now - at < 2500)+ clicks.push(now)+ if (['down', 'lift'].includes(D.pose)) { spout({ small: true }); return }+ const big = clicks.length >= 4+ if (big) clicks = []+ if (!reduced()) squash(big)+ if (!D.pet && (!root.dataset.eyes || root.dataset.eyes === 'happy')) {+ clearTimeout(happyTimer)+ const ms = big ? 900 : 480+ // Reduced motion swaps the eyes (ui-standard 9.6) and so leaves no inline transform on+ // them that would hide the heavy eyes of a failure.+ if (reduced()) {+ root.dataset.eyes = 'happy'+ happyTimer = setTimeout(() => { if (root.dataset.eyes === 'happy') delete root.dataset.eyes }, ms)+ } else {+ happyEyes(true)+ happyTimer = setTimeout(() => { if (!D.pet && !D.handed && !['down', 'lift', 'dive'].includes(D.pose)) happyEyes(false) }, ms)+ }+ }+ spout({ big })}function lookAround() {if (!playful()) return@@ -406,7 +453,7 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oa.cancel()if (!reduced() && from !== 'none' && from !== '1') play(gazeLayer, [{ scale: from }, { scale: '1' }], { duration: 240, easing: 'ease-out', fill: 'none' })}- const canBlink = () => stirs() && D.pose === 'rest' && !D.pet && !D.hop && !D.poking && !D.gazeHold && !D.handed && !root.dataset.eyes && !document.hidden && eyes.every(eye => !eye.style.transform && scripted(eye).length === 0)+ const canBlink = () => stirs() && D.pose === 'rest' && !D.pet && !D.hop && !D.gazeHold && !D.handed && !root.dataset.eyes && !document.hidden && eyes.every(eye => !eye.style.transform && scripted(eye).length === 0)function blink() {if (!canBlink()) returnfor (const eye of eyes) {@@ -438,7 +485,7 @@ export function createDirector({ start, resume, act, label, announce, onCheck, ok += 1later(mine, at - performance.now(), () => {if (D.hopsStopped || D.pose !== 'rest' || !stirs()) return- if (D.pet || D.poking || D.hop) { next(); return }+ if (D.pet || D.hop) { next(); return }const a = hop(1)D.hop = aa.done.then(() => { if (D.hop === a) { D.hop = null; a.cancel() } })@@ -449,85 +496,53 @@ export function createDirector({ start, resume, act, label, announce, onCheck, o}// ---- poses ----- async function leg(i, queued, ms) {+ // A stage done: its arc fills while the whale, which stays where it is, gives a tail stroke+ // and a small surge forward. Stages done together follow each other faster.+ async function leg(i, queued) {D.legging = true- changed()- try { await swim(i, queued, ms) } finally { D.legging = false; changed() }- }- async function swim(i, queued, ms) {clearTimeout(activeTimer)petEnd()stopHop()- const x0 = i * 192- const x1 = x0 + 192- const shape = spring('shape')- const glideMs = ms || shape.duration- if (reduced() || instant) {- // Reduced motion: the whale never travels; the lane cross-fades and the ring fades in.- if (!instant) await play(lane, [{ opacity: 1 }, { opacity: 0 }], { duration: 120, fill: 'none' }).done- x.style.translate = `${x1}px 0`- popCheck(i)- D.at = i + 1- place()- if (!instant) await play(lane, [{ opacity: 0 }, { opacity: 1 }], { duration: 120, fill: 'none' }).done- return- }- const pose = capture()- stopLoop()- release(pose, { duration: queued ? 160 : 120, easing: 'ease-out' })- if (!queued) {- to(body, { scale: '1.04 .96' }, { duration: 120, easing: OUT })- to(move, { transform: 'translateX(-3px)' }, { duration: 120, easing: OUT })- await sleep(120)- }- const timing = { duration: glideMs, easing: shape.easing }- drop(x)- // The glide is SPRING_SHAPE clamped at the target: its 2 % overshoot would settle back- // leftwards, and the whale never swims backwards. Tilt and scale keep the full spring.- const glide = play(x, [{ translate: `${x0}px 0` }, { translate: `${x1}px 0` }], { duration: glideMs, easing: clamped(shape.easing) })- to(body, { scale: '1' }, timing)- drop(move)- const tilt = play(move, [{ transform: `${queued ? '' : 'translateX(-3px) '}rotate(-4deg)` }, { transform: 'none' }], timing)- if (playful()) {+ if (playful() && !instant) {const strokes = play(tail, [{ transform: 'none' }, { transform: 'rotate(10deg)' }, { transform: 'rotate(-10deg)' }, { transform: 'none' }], { duration: 200, iterations: 2, easing: 'ease-in-out', fill: 'none' })strokes.done.then(() => strokes.cancel())- const gz = $('#gaze')- const base = cs(gz).transform- const lag = play(gz, [{ transform: `translateX(-1.5px)${base === 'none' ? '' : ` ${base}`}` }, { transform: base }], { duration: shape.duration, delay: 80, easing: shape.easing, fill: 'backwards' })- lag.done.then(() => lag.cancel())+ const surge = play(move, kf([{ transform: 'none' }, { transform: `translateX(${px(4)}px) rotate(-3deg)`, offset: 0.4 }, { transform: 'none' }], OUT), { duration: 420, fill: 'none' })+ surge.done.then(() => surge.cancel())}- setTimeout(() => popCheck(i), 90)- await glide.done- settle(glide, x)- settle(tilt, move)+ popCheck(i)D.at = i + 1- place()+ await hold(performance.now() + (queued ? 200 : 360))+ D.legging = false+ }+ // Waits until `at`. Other states keep the wait, but the hand-off does not: it fills the arcs+ // left at once, and a beat in front of it would push handoffShow past the main process's+ // fallback (start-window.mjs fallbackMs).+ async function hold(at) {+ if (instant) return+ while (performance.now() < at && want.view !== 'handoff') await until(wait(at - performance.now()))}- async function runLegs(flush) {+ async function runLegs() {let ran = 0- while (D.at < want.station) {+ while (D.at < want.station && want.view !== 'handoff') {const i = D.at- if (!ran && !flush) {- // The whale greets before it sets off (§4): on a first start it leaves the first stop- // only once the greeting has been readable, in the next stage's loop meanwhile. The- // data stage is usually done before the page has painted, and the whale would- // otherwise be gone as it surfaced.- const greeted = first && i === 0 && !resume && want.view === 'boot' ? t0 + GREET_MS : 0- if (greeted > performance.now()) await phaseLoop()- const holdTo = Math.max(D.activeAt[i] ? D.activeAt[i] + HOLD : 0, D.loopAt ? D.loopAt + HOLD : 0, greeted)- if (holdTo > performance.now()) await wait(holdTo - performance.now())+ if (!ran) {+ // The first arc waits for the whale to surface (FIRST_ARC_MS). No loop starts for that+ // short wait: a loop's own hold would delay the arc by another 400 ms.+ const seen = i === 0 && !resume && ['boot', 'moving'].includes(want.view) ? t0 + entranceMs + FIRST_ARC_MS : 0+ await hold(Math.max(D.activeAt[i] ? D.activeAt[i] + HOLD : 0, D.loopAt ? D.loopAt + HOLD : 0, seen))+ if (want.view === 'handoff') break}- await leg(i, ran > 0 || flush, flush ? Math.min(420, Math.floor(600 / (want.station - i))) : 0)+ await leg(i, ran > 0)ran += 1}- if (!ran) return+ // The hand-off follows at once and takes the whale down; a nod now would bring it back up.+ if (!ran || want.view === 'handoff') returnD.loopAt = 0armActive()- if (!flush && D.at <= 2 && !(D.at < 2 && want.done.includes(PHASES[D.at]))) nod()+ if (D.at <= 2 && !(D.at < 2 && want.done.includes(PHASES[D.at]))) nod()}- // A failed stage is only marked in the hidden list: the whale's pose says it, nothing is drawn.+ // A failed start turns its stage's arc red; the whale's pose says the rest.function failStation() {- if (!first) returnconst i = want.view === 'viewFailed' ? 2 : Math.min(D.at, Math.max(0, PHASES.indexOf(want.phase)))clearTimeout(activeTimer)if (D.checks > i) return@@ -538,6 +553,8 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oif (['down', 'lift'].includes(D.pose)) returnstopHop()petEnd()+ // A spout's ^ ^ eyes give way to the heavy ones, and their timer cannot undo them.+ clearTimeout(happyTimer)D.pose = 'down'D.card = ''D.clockKind = ''@@ -546,7 +563,10 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oconst pose = capture()stopLoop()setBase(0.2, 0.6)+ // Reduced motion: no inline opacity on the ^ ^ arcs, which would hide them from a later+ // html[data-eyes=happy] (a celebrating hand-off after a retry).if (reduced()) { root.dataset.eyes = 'heavy'; return }+ happy.forEach(arc => to(arc, { opacity: '0' }, { duration: 120, easing: 'ease-out' }))const shape = spring('shape')release(pose, shape)eyes.forEach((eye, k) => slide(eye, pose.eyes[k], 'translateY(1.5px) scaleY(.55)', shape))@@ -571,7 +591,6 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oD.failed = undefinedsetStation(i, 'pending')armActive()- changed()}if (reduced()) { for (const el of [move, ...eyes]) el.style.removeProperty('transform'); return }const shape = spring('shape')@@ -583,24 +602,19 @@ export function createDirector({ start, resume, act, label, announce, onCheck, osettle(s, body)}async function resetRun() {- // A new folder or a blank team: sink, fade the rings, resurface at the first stop. The- // whale's line and the hint go quiet while it is under (stage().sinking).+ // A new folder or a blank team: sink, empty the ring while under, resurface. No spout while+ // the whale is under (D.sinking).D.sinking = true- changed()petEnd()stopHop()const pose = capture()stopLoop()- const fadeOut = el => play(el, [{ opacity: Number(cs(el).opacity) }, { opacity: 0 }], { duration: 160 })if (!reduced()) {release(pose, spring('shape'))- to(move, { transform: 'translateY(64px)' }, spring('shape'))+ to(move, { transform: `translateY(${SINK}px)` }, spring('shape'))play(move, [{ opacity: 1 }, { opacity: 0 }], { duration: 160 })await wait(spring('shape').duration)- } else await fadeOut(lane).done- const rings = traces.filter(ring => ring.hasAttribute('data-on'))- const outs = rings.map(fadeOut)- await Promise.all(outs.map(a => a.done))+ } else await play(lane, [{ opacity: Number(cs(lane).opacity) }, { opacity: 0 }], { duration: 160 }).donefor (let i = 0; i < 3; i += 1) setStation(i, 'pending')D.at = 0D.checks = 0@@ -608,20 +622,17 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oD.since = [performance.now()]D.activeAt = []delete root.dataset.eyes- for (const el of [x, move, body, lane, ...eyes]) { for (const a of scripted(el)) a.cancel(); el.style.removeProperty('transform'); el.style.removeProperty('translate'); el.style.removeProperty('opacity'); el.style.removeProperty('scale') }- for (const ring of rings) { delete ring.dataset.on; for (const a of scripted(ring)) a.cancel(); ring.style.removeProperty('opacity'); ring.style.removeProperty('scale') }- place()+ for (const el of [move, body, lane, ...eyes]) { for (const a of scripted(el)) a.cancel(); el.style.removeProperty('transform'); el.style.removeProperty('opacity'); el.style.removeProperty('scale') }D.sinking = false- changed()D.pose = 'loop'setBase(0, 0)if (!reduced()) {- const up = play(move, [{ transform: 'translateY(64px) rotate(-12deg)' }, { transform: 'none' }], { ...spring('stretch'), fill: 'none' })+ const up = play(move, [{ transform: `translateY(${SINK}px) rotate(-12deg)` }, { transform: 'none' }], { ...spring('stretch'), fill: 'none' })await up.done}armActive()}- // Another state on the same card (a leg, a retry that missed): the rest starts over.+ // Another state on the same card (a stage done, a retry that missed): the rest starts over.function restAgain(mine) {if (D.pose === 'alert' && !D.hop) D.pose = 'rest'if (D.pose !== 'rest' || D.restMine === mine) return@@ -676,80 +687,65 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oif (name) await startLoop(name)else if (D.loop || D.lean) { const pose = capture(); stopLoop(); release(pose, { duration: 240, easing: 'ease-out' }) }}+ // The hand-off, the same for every kind of start: the arcs not yet done fill at once, the ring+ // closes into one circle (html[data-ring=closed]), and the whale goes. Every path shows the+ // team window well inside the main process's fallback (start-window.mjs fallbackMs).async function handoff() {if (D.handed) returnclearTimeout(activeTimer)stopHop()petEnd()- if (first) {- // The whale says 「进去吧」 (start.js reads stage().ready) as soon as the team is ready; a- // leg still to swim and the last stop's hold run while it is on screen, and the- // celebration waits until it has been there READY_MS.- if (!D.ready) { D.ready = true; D.readyAt = performance.now(); changed() }- await runLegs(true)- // An active stage stays at least 400 ms before it is done (no flash of 'in progress').- const shownAt = stations[2].dataset.state === 'active' ? D.activeAt[2] ?? 0 : 0- if (shownAt && performance.now() < shownAt + HOLD) await wait(shownAt + HOLD - performance.now())- if (!instant) {- const said = await Promise.race([readyLine ? readyLine() : Promise.resolve(D.readyAt), sleep(READY_CAP).then(() => performance.now())])- if (said + READY_MS > performance.now()) await sleep(said + READY_MS - performance.now())- }- }+ for (let i = D.checks; i < 3; i += 1) popCheck(i)+ D.at = 2+ root.dataset.ring = 'closed'D.handed = trueD.pose = 'dive'+ clearTimeout(happyTimer)applyGaze()- const celebrate = want.celebrateconst begin = performance.now()const at = ms => sleep(Math.max(0, begin + ms - performance.now()))- if (first) popCheck(2)const pose = capture()stopLoop()- if (reduced()) {- // Reduced: the content fades over .12 s; the celebration is only the ^ ^ eyes.- if (celebrate && tier() !== 'quiet') root.dataset.eyes = 'happy'- await at(first ? 300 : 0)- root.dataset.exit = 'caption all lane'- await at((first ? 300 : 0) + 120)- act('handoffShow')- await at((first ? 300 : 0) + 140)- act('handoffDone')- return- }+ if (reduced()) return stillHandoff(at)release(pose, { duration: 200, easing: 'ease-out' })- if (first) {- const diveAt = celebrate ? 460 : 300- if (celebrate) {- drop(body)- play(body, kf([{ scale: '1' }, { scale: '1.12 .88', offset: 240 / 460 }, { scale: '.93 1.09' }], OUT), { duration: 460 })- if (playful()) { happyEyes(true); play(tail, [{ transform: 'none' }, { transform: 'rotate(12deg)' }, { transform: 'none' }], { duration: 400, easing: 'ease-in-out', fill: 'none' }) }- }- await at(160)- root.dataset.exit = 'caption'- await at(diveAt)- root.dataset.exit = 'caption all'- dive(18, DEEP(), 24, spring('shape'))- await at(diveAt + 100)- sendRipple()- await at(diveAt + 160)- act('handoffShow')- await at(diveAt + 420)- act('handoffDone')- return- }- let lead = 0- if (celebrate) {- lead = 920- drop(body)- play(body, kf([{ scale: '1' }, { scale: '1.12 .88', offset: 240 / 920 }, { scale: '.93 1.09', offset: 460 / 920 }, { scale: '1.04 .97', offset: 680 / 920 }, { scale: '1' }], OUT), { duration: 920 })- if (playful()) happyEyes(true)- root.dataset.exit = 'caption'- await at(lead)- }+ if (want.celebrate) return spoutHandoff(at)+ // A beat for the ring to close, then the dive: handoffShow at 220 ms.+ await at(100)root.dataset.exit = 'caption all'dive(12, DEEP(), 18, spring('tap'))- await at(lead + 120)+ await at(220)+ act('handoffShow')+ await at(390)+ act('handoffDone')+ }+ // A celebrating hand-off (a first start, or the first success after a failure) spouts as the+ // ring closes and dives once the column has opened: handoffShow at 720 ms.+ async function spoutHandoff(at) {+ drop(body)+ play(body, kf([{ scale: '1' }, { scale: '1.12 .88', offset: 240 / 460 }, { scale: '.93 1.09' }], OUT), { duration: 460 })+ if (playful()) { happyEyes(true); play(tail, [{ transform: 'none' }, { transform: 'rotate(12deg)' }, { transform: 'none' }], { duration: 400, easing: 'ease-in-out', fill: 'none' }) }+ spout()+ await at(160)+ root.dataset.exit = 'caption'+ await at(560)+ root.dataset.exit = 'caption all'+ dive(18, DEEP(), 24, spring('shape'))+ await at(660)+ sendRipple()+ await at(720)+ act('handoffShow')+ await at(980)+ act('handoffDone')+ }+ // Reduced motion: the arcs' .12 s fill and the closed ring are seen before the content fades;+ // the celebration is only the ^ ^ eyes.+ async function stillHandoff(at) {+ if (want.celebrate && tier() !== 'quiet') root.dataset.eyes = 'happy'+ await at(300)+ root.dataset.exit = 'caption all lane'+ await at(420)act('handoffShow')- await at(lead + 290)+ await at(440)act('handoffDone')}// 1.25 x the whale's height: fully under the waterline within about 200 ms, so the window@@ -771,7 +767,8 @@ export function createDirector({ start, resume, act, label, announce, onCheck, ox.style.setProperty('--gy', gy.toFixed(3))}// The eyes look at the pointer, or at a control that keyboard focus reached, until the next- // pointer move. The whale's hit box moves with the stations, so it is measured each time.+ // pointer move. The whale's hit box shrinks and rises with the pond when a card comes, so it is+ // measured each time.function applyGaze() {frame = 0if (reduced()) return setGaze(0, 0)@@ -791,7 +788,7 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oroot.addEventListener('pointerleave', () => { pointer = null; applyGaze() })hit.addEventListener('pointerenter', petStart)hit.addEventListener('pointerleave', petEnd)- hit.addEventListener('click', poke)+ hit.addEventListener('click', spoutClick)// Keyboard focus only: the card's own focus move after a pointer answer is not followed.window.addEventListener('keydown', () => { keyboard = true }, true)window.addEventListener('pointerdown', () => { keyboard = false }, true)@@ -843,7 +840,7 @@ export function createDirector({ start, resume, act, label, announce, onCheck, olet hiddenAt = 0function returnGlance(since) {if (!since || performance.now() - since < 5000) return- if (!stirs() || D.legging || D.handed || D.hop || D.pet || D.poking) return+ if (!stirs() || D.legging || D.handed || D.hop || D.pet) returnglance(['loop', 'rest'])}window.addEventListener('blur', () => { blurAt = performance.now() })@@ -858,10 +855,10 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oasync function step() {await enteredif (want.view === 'handoff') return handoff()- if (D.pose === 'enter') { D.pose = 'loop'; place(); armActive() }+ if (D.pose === 'enter') { D.pose = 'loop'; armActive() }if (D.over || want.station < D.checks) { D.over = false; await resetRun() }if (!failure() && ['down', 'lift', 'redo'].includes(D.pose)) await shakeOff()- await runLegs(false)+ await runLegs()if (want.view === 'handoff') return handoff()if (failure()) {if (D.pose === 'redo') D.pose = 'loop'@@ -873,6 +870,9 @@ export function createDirector({ start, resume, act, label, announce, onCheck, oif (want.view === 'card' || want.view === 'watchdog') return cardPose()return phaseLoop()}+ // A resumed page shows the arcs it catches up on without drawing them (start.css+ // html[data-resume]); once that has been painted, later arcs draw again.+ const caughtUp = () => requestAnimationFrame(() => requestAnimationFrame(() => delete root.dataset.resume))let pumping = falselet again = falsefunction kick() {@@ -881,22 +881,19 @@ export function createDirector({ start, resume, act, label, announce, onCheck, opumping = true;(async () => {try {- while (again) { again = false; await step(); instant = false }+ while (again) { again = false; await step(); if (instant) caughtUp(); instant = false }} catch (error) { console.error(error) } finally { pumping = false; instant = false }})()}return {- // Where the whale is, for its line: the stop it is at (0-2), the stage shown active there (or- // -1), whether it is swimming to the next stop, and whether it has said 「进去吧」.- stage: () => ({ at: D.at, active: stations.findIndex(st => st.dataset.state === 'active'), legging: D.legging, ready: D.ready, sinking: D.sinking }),update(s) {const done = s.done ?? []const now = performance.now()if (done.includes('data') && !want.done.includes('data')) D.since[1] = nowif (done.includes('engine') && !want.done.includes('engine')) D.since[2] = nowlet station = 0- if (first && done.includes('data')) station = done.includes('engine') ? 2 : 1+ if (done.includes('data')) station = done.includes('engine') ? 2 : 1const next = { station, view: s.view, phase: s.phase, done, card: s.card?.kind ?? '', missed: Boolean(s.card?.missedRetry), celebrate: Boolean(s.celebrate), update: s.update?.state ?? '' }// Stages taken back mean a start in another folder: the whale starts over even when the// next snapshot, a moment later, has the first stage done again.@@ -922,7 +919,7 @@ export function createDirector({ start, resume, act, label, announce, onCheck, orefresh() {stopBreath()D.press = null- for (const el of [x, body, move, loop, tail, pair, lane, ripple, ...traces, ...eyes, ...happy]) for (const a of scripted(el)) settle(a, el)+ for (const el of [body, move, loop, tail, pair, lane, ripple, ...eyes, ...happy]) for (const a of scripted(el)) settle(a, el)D.hop = nullD.pet = nullD.lean = falsediff --git a/app/test/start-page.test.mjs b/app/test/start-page.test.mjsindex 3c816df8..136f1710 100644--- a/app/test/start-page.test.mjs+++ b/app/test/start-page.test.mjs@@ -67,6 +67,35 @@ test('the page sends only the acts of the start window', () => {for (const name of START_ACTS) assert.ok(sent.has(name), `the main process takes ${name}, which the page never sends`)})+// The progress is a ring of three arcs round the whale, one per stage: radius 106 round the+// centre of a 220 box, 120 degrees each from the top, clockwise, 10 degrees apart, with one+// circle that closes the ring at the hand-off. The rings that the whale left at its stops and+// the elapsed clock are gone.+test('the start page draws the progress as a ring of three arcs and a closing circle', () => {+ const arcs = [...html.matchAll(/<g class="arc" data-state="pending">(.*?)<\/g>/gu)].map(match => match[1])+ assert.equal(arcs.length, 3)+ const point = (deg) => {+ const a = (deg * Math.PI) / 180+ return [110 + 106 * Math.cos(a), 110 + 106 * Math.sin(a)]+ }+ arcs.forEach((arc, k) => {+ const paths = [...arc.matchAll(/<path class="(arc-[a-z]+)" d="([^"]+)" pathLength="100"\/>/gu)]+ assert.deepEqual(paths.map(match => match[1]), ['arc-base', 'arc-fill', 'arc-glow'], `arc ${String(k)}`)+ const d = paths[0][2]+ for (const match of paths) assert.equal(match[2], d, `arc ${String(k)}: its three paths differ`)+ const [x0, y0, rx, ry, , large, sweep, x1, y1] = d.match(/-?\d+(?:\.\d+)?/gu).map(Number)+ assert.deepEqual([rx, ry, large, sweep], [106, 106, 0, 1], `arc ${String(k)}: not a clockwise arc of radius 106`)+ const near = ([px, py], [qx, qy]) => Math.abs(px - qx) < 0.01 && Math.abs(py - qy) < 0.01+ assert.ok(near([x0, y0], point(-90 + k * 120 + 5)), `arc ${String(k)} starts elsewhere`)+ assert.ok(near([x1, y1], point(-90 + (k + 1) * 120 - 5)), `arc ${String(k)} ends elsewhere`)+ })+ assert.equal(html.match(/<circle class="ring-full" cx="110" cy="110" r="106" pathLength="100" transform="rotate\(-90 110 110\)"\/>/gu)?.length, 1)+ // The ring, the water, the whale and its hit box move as one block when a card comes.+ assert.match(html, /<div class="pond">\r?\n<svg class="ring"[\s\S]*?<div class="water"[\s\S]*?<div class="lane">[\s\S]*?<span class="spout"><svg class="plume"[^>]*\shidden>[\s\S]*?<div class="whale-hit"[\s\S]*?<div class="fx" aria-hidden="true"><span class="ripple"><\/span><\/div>\r?\n<\/div>/u)+ assert.doesNotMatch(html, /class="(?:trace|elapsed)"/u)+ assert.doesNotMatch(read('start.css'), /\.(?:trace|elapsed)\b/u)+})+// docs/plans/2026-10-29-start-copy.md §2: the first part of a key says where the line is.const LAYERS = ['voice', 'say', 'hint', 'card', 'reason', 'btn', 'note', 'foot', 'status', 'dialog']const layerOf = key => key.split('.')[0]@@ -83,6 +112,16 @@ test('every text key starts with one of the ten layers', () => {for (const key of Object.keys(TEXT.zh)) assert.ok(LAYERS.includes(layerOf(key)), `${key}: unknown layer`)})+// The whale speaks only when the user is needed (past 45 s, the 180 s question, a failure, a data+// move), and the hint row only for a short drive: no greeting, stage lines or clock.+test('the whale and the hint row have only the lines for when the user is needed', () => {+ const layer = name => Object.keys(TEXT.zh).filter(key => layerOf(key) === name).sort()+ assert.deepEqual(layer('voice'), ['voice.failed', 'voice.moving', 'voice.slow45', 'voice.slowLater', 'voice.viewFailed', 'voice.watchdog'])+ assert.deepEqual(layer('hint'), ['hint.space'])+ assert.equal(TEXT.zh['voice.slowLater'], '比平时慢,请再等一会儿')+ assert.ok(!('status.elapsed' in TEXT.zh), 'the elapsed clock is back')+})+// §2 and §4: a line that stands alone takes no full stop; card, reason, note and dialog text is// whole sentences.test('each layer ends its lines as its rule says', () => {@@ -168,7 +207,7 @@ test('every text key that the page uses exists', () => {for (const [, prefix] of text.matchAll(/`([\w.]+\.)\$\{/gu)) assert.ok(keys.some(key => key.startsWith(prefix)), `${name}: no text key starts with ${prefix}`)}// Keys the page builds from the snapshot's views, the stages and the failure reasons.- for (const key of ['voice.failed', 'voice.viewFailed', 'voice.opening', 'voice.moving', 'status.phase.data', 'status.phase.engine', 'status.phase.team', 'status.state.pending', 'status.state.active', 'status.state.done', 'status.state.failed']) assert.ok(key in TEXT.zh, key)+ for (const key of ['voice.failed', 'voice.viewFailed', 'voice.watchdog', 'voice.moving', 'voice.slow45', 'voice.slowLater', 'status.phase.data', 'status.phase.engine', 'status.phase.team', 'status.state.pending', 'status.state.active', 'status.state.done', 'status.state.failed']) assert.ok(key in TEXT.zh, key)assert.deepEqual(matching('reason.start.{reason}').sort(), ['reason.start.engine', 'reason.start.files', 'reason.start.other', 'reason.start.permission', 'reason.start.space'])assert.deepEqual(matching('reason.place.{reason}').sort(), ['reason.place.dsh', 'reason.place.foreign', 'reason.place.nested', 'reason.place.onedrive', 'reason.place.permission', 'reason.place.program', 'reason.place.space'])assert.deepEqual(matching('reason.copy.{reason}').sort(), ['reason.copy.full', 'reason.copy.inUse', 'reason.copy.permission'])@@ -194,19 +233,19 @@ test('the main process uses only keys of the table and keeps no table of its own})test('t fills placeholders and falls back to zh, then to the key', () => {- assert.equal(t('zh', 'status.elapsed', { n: 12 }), '已用 12 秒')- assert.equal(t('en', 'status.elapsed', { n: 12 }), '12 s so far')- assert.equal(t('en', 'voice.helloName', { name: 'Ada' }), 'Hi, I’m Ada')+ assert.equal(t('zh', 'hint.space', { drive: 'C', free: '1.2 GB' }), 'C 盘只剩 1.2 GB')+ assert.equal(t('en', 'hint.space', { drive: 'C', free: '1.2 GB' }), 'Only 1.2 GB left on drive C')+ assert.equal(t('en', 'btn.useRec', { rec: 'D' }), 'Put it on drive D')assert.equal(t('fr', 'btn.retry'), '重试')assert.equal(t('en', 'hint.space', { drive: 'C' }), 'Only {free} left on drive C')assert.equal(t('zh', 'no.such.key'), 'no.such.key')})test('t picks the English singular or plural by the value', () => {- 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 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?')})test('langOf gives zh for every Chinese locale and en otherwise', () => {diff --git a/docs/plans/2026-10-26-start-window.md b/docs/plans/2026-10-26-start-window.mdindex 4432ea47..2268316f 100644--- a/docs/plans/2026-10-26-start-window.md+++ b/docs/plans/2026-10-26-start-window.md@@ -2,14 +2,14 @@- 日期:2026-10-26- 相关:[Windows 上手流程](2026-10-26-windows-onboarding.md) 第 3、4、5、6、8 节,#559-- 一起改:[Windows 上手流程](2026-10-26-windows-onboarding.md)(第 3 节、第 4 节、第 5 节、第 8 节、用词、「改动的已定设计」、分批上线、验收、待定、已知限制)、[桌面应用](2026-10-16-desktop-app.md)(结构、窗口)、[UI 标准](../design/ui-standard.md)(1、3.1、4.4、8.3、8.4、12、14)+- 一起改:[Windows 上手流程](2026-10-26-windows-onboarding.md)(第 3 节、第 4 节、第 5 节、第 8 节、用词、「改动的已定设计」、分批上线、验收、待定、已知限制)、[启动页文案](2026-10-29-start-copy.md)(第 2、3、4 节、「改动的已定设计」)、[桌面应用](2026-10-16-desktop-app.md)(结构、窗口)、[UI 标准](../design/ui-standard.md)(1、3.1、4.4、8.3、8.4、12、14)- 代码:新的 `app/src/start/`(`start.html`、`start.css`、`start.js`、`whale.js`、`text.mjs`)、`app/src/start-window.mjs`、`app/src/start-frame.mjs`、`app/scripts/start-assets.mjs`;`app/src/main.mjs`、`preload.cjs`、`window-frame.mjs`## 为什么- 引擎第一次启动要 3 到 20 秒,以后要 3 到 12 秒。第 3 节定了这段时间显示什么(真实阶段、卡片、恢复页),没定它怎么动。- 主 Bot 的鲸鱼是 DS Bot 自己生成的形象,用户进团队后第一眼看到的也是它。启动时让它替用户「干活」,用户进门前就认识了它,也先见过它的状态动作。-- 双击以后的这几秒里做不了有用的事。窗口只做四件事:证明应用活着、在动;一眼说清下一步;只问等不了的事(导入、盘不够);把形象带进团队窗口。所以鲸鱼在哪里,进度就在哪里,字都是它说的,一次一句短话:窗口显示用户感受到的东西,不显示实现的结构(维护者 2026-10-27 的反馈)。+- 双击以后的这几秒里做不了有用的事。窗口只做四件事:证明应用活着、在动;一眼看出走到了哪一步;只问等不了的事(导入、盘不够);把形象带进团队窗口。所以窗口里只有鲸鱼和围着它的圆环:三段弧就是三个阶段,顺利时没有字,只在要用户知道或回答时,鲸鱼才说一句。窗口显示用户感受到的东西,不显示实现的结构(维护者 2026-10-27 的反馈),也不吵(维护者 2026-10-30 转来的讨论:「现在这版有点噪了」)。- 等待只取这些原则:- 有事做、有解释的等待显得短(Maister)。- 看得见真实的工作更让人放心,假进度适得其反(Buell 和 Norton;Harrison 等)。@@ -47,128 +47,134 @@| 部分 | 没有卡片时 | 有卡片时 | 内容 ||---|---|---|---|| 标题带 | y 0–40 | 同左 | 空,可以拖动 |-| 已用秒数 | 右对齐 x 672,y 54–72 | 同左位置,隐藏(卡片等回答时暂停,第 4 节) | 「已用 N 秒」,13/18,`--bt-ink-2`,等宽数字,宽度固定 |-| 水道 | x 48–672,y 156–260 | x 48–672,y 76–180 | 88 px 的鲸鱼,停在三站之一;水线以下的部分被裁掉 |-| 水线 | y 260 | y 180 | 1 px `--bt-line`,首尾各 12% 渐隐;上面什么都不画 |-| 圈 | 在水线上,中心 x 180、372 | 同左,跟着水线 | 56 × 12 的细线椭圆,1 px `--bt-line-2`,停住后不透明度 .5;鲸鱼离开第 1 站、第 2 站时各留下一个,第 3 站不留;交接时淡出 |-| 鲸鱼的话 | y 274–294,居中 | y 194–214,居中 | 15/20、600,`--bt-ink`;只有一行,不换行,实在放不下才用省略号 |-| 提示行 | y 300–328,居中 | y 220–248,隐藏 | 13/18,`--bt-ink-2`;最多约 22 个字,或者只有〔打开日志文件夹〕;没有要提前知道的事时空着 |-| 纸面 | 空 | x 48–672,y 260–496 | 只放卡片 |+| 圆环 | 圆心 (360, 290),半径 106 | 圆心 (360, 150),半径约 66 | 三段弧,一段一个阶段(见下面);2 px 的线,圆头 |+| 水道 | x 48–672,y 182–322 | 跟着圆环缩小 | 112 px 的鲸鱼在圆环中间(x 304–416);水线以下的部分被裁掉 |+| 水线 | 圆环的一条弦:y 322,x 260–460 | y 约 170,宽约 124 | 1 px `--bt-line-2`,首尾各 18% 渐隐;涟漪(68 × 12)在它中间 |+| 鲸鱼的话 | y 414–434,居中 | y 226–246,居中,在圆环和卡片之间 | 15/20、600,`--bt-ink`;只有一行,不换行,实在放不下才用省略号;只在第 3 节列的几种时候有字 |+| 提示行 | y 438–466,居中 | 隐藏 | 13/18,`--bt-ink-2`;最多约 22 个字,或者只有〔打开日志文件夹〕;平时空着 |+| 纸面 | 空,点击穿过它 | x 48–672,y 260–496 | 只放卡片 || 底注 | x 48,y 504–522 | 同左 | 「社区开源项目,不是 DeepSeek 官方产品」,13/18 || 位置行 | 右对齐 x 672,y 504–522,和底注同一行,挤不下时位置行的字省略 | 同左 | 「数据放在 C 盘(剩 412 GB)· 换个位置…」,13/18,`--bt-ink-2`;「换个位置…」是链接(第 6 节)。只在新团队和要导入的首次启动有,重装没有;导入一开始复制就收起;失败页和「团队界面没有加载出来」时隐藏,180 秒的问题开着时还能点。剩余空间按资源管理器的算法(1024 进制)。Windows 以外写文件夹(`~/.ds-bot`)代替盘;查不到剩余空间时不写括号 |-- 三站是鲸鱼停的三处:x 168 / 360 / 552,依次对应「准备数据文件夹」「启动本机引擎」「打开团队」三个阶段。站上不画标记、名字和连线:鲸鱼停在哪一站,进度就到了哪里。-- 没有卡片时,水道、水线、圈、鲸鱼的话和提示行整组比有卡片时低 80 px,鲸鱼落在窗口的视觉中心。要出卡片时,整组用 `SPRING_SHAPE` 上移 80 px,卡片出现在下面的纸面里;卡片收回后,整组再回到低处。已用秒数、底注和位置行不动。页面不能滚动(第 11 节)。-- 鲸鱼的话和提示行直接写在 Mica 上。+- 圆环的三段弧从正上方起顺时针排,依次是「准备数据文件夹」「启动本机引擎」「打开团队」,各占 120°,段与段之间空 10°(每段画出 110°):+ - 没开始:`--bt-line` 的淡线。+ - 进行中(等满 250 ms,第 3 节):这段淡线染上 22% 的 `--bt-ink-deepseek`,一小段亮光(弧长的 22%,2.5 px,75% 的 `--bt-ink-deepseek`)沿着它顺时针跑,1.8 s 一趟,45 秒起 2.6 s 一趟。+ - 完成:`--bt-ink-deepseek` 的线顺时针把这一段画满,.56 s。+ - 失败:这段线变成 60% 的 `--bt-danger`(第 7 节)。+ - 交接:段与段之间的空隙接上,合成一整圈(.3 s),整圈鼓起一次(.5 s,最大 1.035 倍,第 8 节)。+- 圆环、水道、水线、鲸鱼的点击区和涟漪是一块,下面叫水塘。没有卡片时,水塘、鲸鱼的话和提示行整组比有卡片时低 80 px,鲸鱼落在窗口的视觉中心。要出卡片时,整组用 `SPRING_SHAPE` 上移 80 px,水塘在同一个弹簧里以圆心为准缩到 .62 倍、再上移 60 px,圆环落在卡片上面,卡片出现在下面的纸面里;卡片收回后,水塘回到原大,整组回到低处。底注和位置行不动。页面不能滚动(第 11 节)。+- 鲸鱼的话和提示行直接写在 Mica 上。没有卡片时它们在纸面的位置上:纸面空着时点击穿过它,〔打开日志文件夹〕点得到。- 卡片是不透明的 `--bt-card`:1 px `--bt-line` 边,圆角 12,内边距 16 × 20。卡片正文比纸面高时,正文在卡片里滚动,按钮行固定在卡片底部。-- 以后的启动:- - 没有水线、圈和底注,右上角也没有已用秒数(10 秒起写在下面的提示行里,第 5 节)。- - 64 px 的鲸鱼在 x 360,下面一行字(15/20、600,居中)。没有卡片时整组同样低 80 px,落在窗口的视觉中心;出卡片时一样上移。+- 以后的启动和首次启动是同一个布局:同样 112 px 的鲸鱼、圆环和水线,没有底注和位置行(第 5 节)。### 3. 鲸鱼的总规则- 只为真实的事动:阶段开始和完成、出卡片、失败、就绪,以及用户的指针、点击、键盘焦点和回到窗口。唯一的例外是卡片等用户回答时的呼吸和眨眼(下面第二张表)。-- 鲸鱼面朝右。主进程报告一个阶段完成时,它向右游到下一站,身后留下一个圈:不会提前,也从不往回游。+- 鲸鱼面朝右,一直在圆环中间,不游走。主进程报告一个阶段完成时,那一段弧画满,鲸鱼在原地划两下尾巴、向前一涌:弧不会提前画,画满了也不退回(只有换个新文件夹重新开始时,三段一起回到没开始,第 7 节)。- 等用户回答时停下:正常档和活泼档只有探身、呼吸和眨眼这几个小动作(活泼档另有越跳越稀的跳)。等得越久动得越慢,从不变快。- 换动作时从当前姿势接着走:读出当前的 `transform`,停掉循环,再用弹簧走到下一个动作的起点。不跳回原位。-- 一个阶段等满 250 ms 才算「进行中」:鲸鱼换成这个阶段的动作,鲸鱼的话换成这一站的那句;更快完成的阶段不显示进行中,鲸鱼直接游走。-- 循环状态出现后至少停 400 ms;失败和交接不等。-- 游动排队:前一段游完才游下一段,排着的那段不再下蹲。排队不会让交接晚超过 600 ms。-- 大动作只放在 SVG 外面的 HTML 包层上,用 `translate`、`rotate`、`scale`、`transform`,交给合成线程。SVG 里只动眼睛和尾巴。+- 一个阶段等满 250 ms 才算「进行中」:它的弧染上淡蓝、跑起光,鲸鱼换成这个阶段的动作;更快完成的阶段不显示进行中,弧直接画满。+- 循环状态和进行中的弧出现后至少停 400 ms;失败和交接不等。+- 阶段一个一个完成:上一段弧开始画满 360 ms 后才画下一段(已经排着的 200 ms)。交接不排队:还没画满的弧一起画满(第 8 节)。+- 大动作只放在 SVG 外面的 HTML 包层上,用 `translate`、`rotate`、`scale`、`transform`,交给合成线程。SVG 里只动眼睛和尾巴。圆环和喷出的水柱是另外的 SVG:弧和水柱用 `stroke-dashoffset` 画,合上的整圈鼓起用 `scale`;水滴是 HTML 圆点,用 `translate`、`scale` 和不透明度。- 循环用 CSS 动画,按 `html` 上的状态属性选。一次性动作用 WAAPI,结束时 `commitStyles()` 再 `cancel()`。- 每段一次性动作带序号,新状态到了就丢掉旧的。等动画结束的地方都配一个计时器兜底,因为最小化的窗口不走动画。- 弹簧只用 `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 节)。+ - 换句时淡出 .16 s,再淡入 .16 s。没有停留时间,也不排队:快照或启动的时钟一变,这一行就跟着换。+ - 卡片在时这一行空着,由卡片自己的第一行说(第 6 节)。180 秒的卡和失败页例外:180 秒的问题由鲸鱼问,卡上只有按钮;失败页上是已定的标题(第 7 节)。+ - 提示行只有两样:盘不够、又没有更好的盘时,前 10 秒的「C 盘只剩 1.2 GB」(第 4、6 节);45 秒起和鲸鱼那句话一起的〔打开日志文件夹〕。| 时刻 | 鲸鱼 | 时长和曲线 ||---|---|---|-| 首次启动入场 | 从水线下浮上来,12° 的倾斜回正;尾巴甩一下;睁眼 | `SPRING_STRETCH` 560 ms;睁眼 160 ms |+| 首次启动入场 | 从水线下 96 px 浮上来,12° 的倾斜回正;尾巴甩一下;睁眼 | `SPRING_STRETCH` 560 ms;睁眼 160 ms |+| 以后的启动入场 | 从水线下 84 px 浮上来,不倾斜,眼睛睁着 | `SPRING_TAP` 290 ms || 准备数据文件夹 | 搜索:前倾探头,眼睛左右扫 | 1 s;眼睛 1.6 s |-| 一个阶段完成 | 下蹲 120 ms,向右滑 192 px,尾巴划两下,眼睛晚 80 ms 跟上;滑出 90 ms 后,身后留下一个圈:从 .5 倍张开到原大,不透明度从 .9 落到 .5,之后不再动(第 3 站不留);到站点一下头 | `SPRING_SHAPE` 420 ms;圈 `SPRING_SHAPE`,不透明度 420 ms |+| 一个阶段完成 | 不挪地方:尾巴划两下,身子向前一涌(约 5 px,抬头 3°),同时这一段弧顺时针画满;这一拍走完(360 ms)点一下头,几段接连画满时只在最后一段之后点 | 尾巴 200 ms × 2;一涌 420 ms;弧 .56 s || 启动本机引擎 | 工作:上下晃、尾巴摆、眨眼 | 1.6 s、1.1 s、2.4 s;52.8 s 内不完全重复 || 10 秒 | 看向用户 600 ms,慢眨一次眼;所有循环放慢到 0.85 倍 | 看 600 ms |-| 45 秒 | 换成思考:歪头慢慢起伏、眯眼;尾巴停下 | 2.2 s;换动作用 `SPRING_SHAPE` |+| 45 秒 | 换成思考:歪头慢慢起伏、眯眼;尾巴停下;弧上的光放慢 | 2.2 s;换动作用 `SPRING_SHAPE`;光 2.6 s 一趟 || 打开团队 | 发消息:向前冲,每冲一次尾巴划两下 | 1.1 s || 应用主动问(卡片、180 秒) | 跳两下,然后停下,看着卡片(停下以后见下一张表) | 1.3 s × 2 || 用户自己引出的卡片 | 不跳,停下 | 无 || 失败 | 从当前姿势下沉 4 px、低头 4°,眼皮变重,然后完全静止 | `SPRING_SHAPE` |-| 就绪(首次启动,包括重试或重新开始后第一次成功) | 「进去吧」出来 300 ms 后:压扁再拉长,「^ ^」眼;拉到最长时潜下去,深到鲸鱼身高的 1.25 倍 | 460 ms 加 `SPRING_SHAPE` |-| 就绪(以后的启动,重试或重新开始后第一次成功) | 字照旧,不说「进去吧」:压扁回弹一次,「^ ^」眼,然后潜下去,同样深到身高的 1.25 倍 | 920 ms 加 `SPRING_TAP` 290 ms |-| 就绪(以后的启动) | 直接潜下去,同样深到身高的 1.25 倍 | `SPRING_TAP` 290 ms |+| 就绪,庆祝(首次启动;重试或重新开始后第一次成功) | 圆环合上的同时压扁再拉长,「^ ^」眼,喷一次水;560 ms 时潜下去,深到身高的 1.25 倍 | 460 ms 加 `SPRING_SHAPE` |+| 就绪(以后的启动) | 圆环合上,100 ms 后直接潜下去,同样深到身高的 1.25 倍 | `SPRING_TAP` 290 ms |鲸鱼还有下面这些小反应,每一个都有原因:卡片在等、用户做了什么,或者交接;第 9 条是唯一一个没有外因的,让工作时的上下晃不那么像循环。它更有反应,不是动得更多。安静档没有 1 到 7 和 9;减少动态效果时 1 到 9 都没有;失败页(启动失败、团队界面没有加载出来、复制失败)上也都没有。| # | 动作 | 什么时候 | 怎么动 ||---|---|---|---|-| 1 | 探身 | 应用主动问的卡片:最后一跳落地时(跳开始后 2.0 s;导入时空间不够的卡 0.7 s)。用户自己引出的卡片:变形开始 70 ms 后。复制中、正在下载和复制失败的卡没有 | 朝卡片前倾 2.5°(`translate(1.5px, -1px) rotate(2.5deg)`,以后的启动按 64/88 缩小),`SPRING_SHAPE`;眼睛仍看着卡片。回答时随点头收回,卡片还在时(比如换了模型设置)1 秒后再探身;抚摸时收回,指针离开后再来 |+| 1 | 探身 | 应用主动问的卡片:最后一跳落地时(跳开始后 2.0 s;导入时空间不够的卡 0.7 s)。用户自己引出的卡片:变形开始 70 ms 后。复制中、正在下载和复制失败的卡没有 | 朝卡片前倾 2.5°(`translate(1.91px, -1.27px) rotate(2.5deg)`,按 112 px 的鲸鱼),`SPRING_SHAPE`;眼睛仍看着卡片。回答时随点头收回,卡片还在时(比如换了模型设置)1 秒后再探身;抚摸时收回,指针离开后再来 || 2 | 呼吸 | 停下 600 ms 后 | 身体轻轻起伏(`scale` 1 → 1.008 1.018 → 1),4.2 s 一次;按这张卡自己的时钟,30 秒后放慢到 .8 倍,90 秒后 .6 倍,不再变快;状态一变,240 ms 回到原样 |-| 3 | 眨眼 | 停下后 1.4–2.2 s 第一次,以后每 3.2–6.8 s 一次(30 秒后间隔乘 1.4,90 秒后乘 2);五次里有一次连眨两下,隔 340 ms | 270 ms:眼睛压到 .03 再回来;抚摸、跳、点击转圈、看用户时不眨,眼皮重、眯眼和「^ ^」眼时也不眨 |-| 4 | 回到窗口时看你 | 窗口失去焦点 5 秒以上后又拿到焦点,或者隐藏 5 秒以上后又看得见 | 和 10 秒那次一样:看向用户 600 ms,慢眨一次眼。和 10 秒那次合算,20 秒内最多一次;只在启动循环里或停在卡片前时有,游动、跳、抚摸、潜下去和失败的姿势时没有 |+| 3 | 眨眼 | 停下后 1.4–2.2 s 第一次,以后每 3.2–6.8 s 一次(30 秒后间隔乘 1.4,90 秒后乘 2);五次里有一次连眨两下,隔 340 ms | 270 ms:眼睛压到 .03 再回来;抚摸、跳、看用户时不眨,眼皮重、眯眼和「^ ^」眼(比如喷水时)也不眨 |+| 4 | 回到窗口时看你 | 窗口失去焦点 5 秒以上后又拿到焦点,或者隐藏 5 秒以上后又看得见 | 和 10 秒那次一样:看向用户 600 ms,慢眨一次眼。和 10 秒那次合算,20 秒内最多一次;只在启动循环里或停在卡片前时有,阶段完成的那一下、跳、抚摸、潜下去和失败的姿势时没有 || 5 | 眼睛跟着键盘焦点 | 键盘把焦点移到纸面或提示行里的按钮、勾选框上 | 眼睛看向那个控件的中心,限幅和跟随指针一样;指针一动就交回指针。卡片出现时焦点自动移到主按钮,那一次不跟,眼睛仍看着卡片 || 6 | 按下预备 | 在回答卡片的按钮上按下指针(展开「详细」「详细信息」、打开模型设置的「更换」、〔复制详细信息〕不算回答) | 身体微蹲:`scale` 1.03 .97,120 ms;点下去时用 `SPRING_TAP` 弹回并点头,移开或取消只弹回;键盘只点头。卡片的动作照旧在点击时才发出 || 7 | 活泼档越跳越稀 | 活泼档,应用主动问、要跳两下的卡片 | 在 0、1.3、3.9、9.1 秒开始跳,以后每 9 秒一次,中间停下来呼吸、眨眼;抚摸或回答后不再跳;导入时空间不够的卡只跳一次 |-| 8 | 潜得更深 | 交接 | 潜到鲸鱼身高的 1.25 倍(首次启动 110 px,以后的启动 80 px),约 200 ms 内整个到水线下,窗口长大之前水道就空了 |-| 9 | 张望 | 第 2 站工作时(「热身中」的循环),每 5 到 9 秒一次,间隔随机 | 眼睛随机向左或向右看 600 ms:`#eye-pair` 平移 14%,150 ms 过去、停 270 ms、180 ms 回来,`ease-in-out`,叠在上下晃上。10 秒放慢后照常,45 秒换成思考后没有;眼睛跟着指针或键盘焦点时、看向用户的那 600 ms 里、抚摸和跳时都不张望,窗口看不见时也不;正张望着要看向用户时,眼睛先用 120 ms 回正。只在首次启动的第 2 站:以后的启动和搬数据的页面、复制中的卡也用工作的循环,但不张望 |+| 8 | 潜得更深 | 交接 | 潜到鲸鱼身高的 1.25 倍(140 px),窗口开始长大时鲸鱼已经在水线下 |+| 9 | 张望 | 首次启动「启动本机引擎」那一段、鲸鱼工作时,每 5 到 9 秒一次,间隔随机 | 眼睛随机向左或向右看 600 ms:`#eye-pair` 平移 14%,150 ms 过去、停 270 ms、180 ms 回来,`ease-in-out`,叠在上下晃上。10 秒放慢后照常,45 秒换成思考后没有;眼睛跟着指针或键盘焦点时、看向用户的那 600 ms 里、抚摸和跳时都不张望,窗口看不见时也不;正张望着要看向用户时,眼睛先用 120 ms 回正。只在首次启动的这一段:以后的启动和搬数据的页面、复制中的卡也用工作的循环,但不张望 |- 动画三档用团队里设的那一档:主窗口的页面报告给应用,应用记在自己的 userData 里,下次启动时用。没有记录时(首次启动)按「正常」。- - 安静:只有第一张表的状态动作。没有眼睛跟随、点击转圈、抚摸、尾巴、点头、看向用户、涟漪和「^ ^」眼,也没有第二张表的 1 到 7 和 9。留下的圈只淡入(160 ms),不张开。- - 正常:加上眼睛跟随指针、尾巴、点头、看向用户、涟漪、「^ ^」眼,以及第二张表的 1 到 6 和 9。首次启动等待时,点鲸鱼它会转一圈;等用户回答时可以抚摸(UI 标准 8.5)。+ - 安静:只有第一张表的状态动作和点鲸鱼时的喷水(小一号,连同它的压扁、甩尾和「^ ^」眼)。除此之外没有眼睛跟随、抚摸、尾巴、点头、看向用户和涟漪,交接时没有「^ ^」眼,也没有第二张表的 1 到 7 和 9;阶段完成时只有弧画满,鲸鱼不划尾巴、不往前涌。+ - 正常:加上眼睛跟随指针、尾巴、点头、看向用户、涟漪、「^ ^」眼、阶段完成时的划尾巴和一涌,以及第二张表的 1 到 6 和 9。等用户回答时可以抚摸(UI 标准 8.5)。- 活泼:再加上第二张表的第 7 条:等用户回答时越跳越稀,代替 UI 标准 8.4 的「一直跳」。-- 涟漪是一个 56 × 12 的细线椭圆,只在首次启动出现两次:浮上来和潜下去的地方。潜下去的那一次 160 ms 就淡完,窗口开始长大时已经没有了。以后的启动没有涟漪。鲸鱼离开一站时留下的圈也是这个椭圆,张开后就停在那里(第 2 节)。-- 鲸鱼和圈对读屏隐藏(`aria-hidden`)。三个阶段留在一个看不见的列表里(「启动进度」,每项带状态词,当前一项 `aria-current="step"`),礼貌朗读区照旧说「{阶段}:进行中」「{阶段}:已完成」。鲸鱼的话是普通文字,不进朗读区;失败的标题例外,会读出来。卡片出现时朗读它的第一行和第一句话(180 秒的卡读鲸鱼的问题)。+- 点鲸鱼它就喷水(点击区 140 × 108,盖住鲸鱼露出水面的部分):+ - 压扁再回弹(460 ms),尾巴甩一下,「^ ^」眼 480 ms。喷水孔冒出一根水柱(170 ms),顶上向两边卷开(120 ms 起,200 ms),380 ms 起整股水向上散掉;两边各两滴、中间一滴落回去(330 到 400 ms 起,各约 .5 到 .6 s),760 ms 时一圈涟漪。水柱和水滴是 70% 的 `--bt-ink-deepseek`。+ - 2.5 秒内点到第 4 下,喷一次大的:1.35 倍,压得更扁,两边各三滴,「^ ^」眼 900 ms;然后重新数。+ - 失败趴着时只冒一小股:.55 倍,不卷开,一滴,不压扁,眼睛不换。+ - 入场、沉下去重新开始、就绪以后和交接时,点了没有反应;抚摸时照样喷,眼睛不换。+ - 每种启动都有。安静档也有:水柱小一号(.85 倍),没有涟漪,压扁、尾巴甩一下和「^ ^」眼照旧;减少动态效果时只换成「^ ^」眼(第 9 节)。+- 涟漪是一个 68 × 12 的细线椭圆,在水线中间,出现在三处:首次启动浮上来时(以后的启动没有);喷出的水落回去时(喷水后 760 ms);庆祝的交接里鲸鱼潜下去时(660 ms,那次喷出的水 760 ms 再来一圈)。喷水和潜下去的那几次 160 ms 淡完(浮上来的那次 .56 s)。安静档和减少动态效果时没有涟漪。+- 鲸鱼和圆环对读屏隐藏(`aria-hidden`)。三个阶段留在一个看不见的列表里(「启动进度」,每项带状态词,当前一项 `aria-current="step"`),礼貌朗读区照旧说「{阶段}:进行中」「{阶段}:已完成」。鲸鱼的话是普通文字,不进朗读区;失败的标题例外,会读出来。卡片出现时朗读它的第一行和第一句话(180 秒的卡读鲸鱼的问题)。### 4. 首次启动,逐拍时间从页面拿到 `?start=first` 的那一帧算起。1. 入场:- - 0 ms,鲸鱼在第 1 站从水线下浮上来。+ - 0 ms,鲸鱼在圆环中间从水线下 96 px 浮上来。- 120 ms,涟漪。- - 160 ms,鲸鱼的话「嗨,我是总管」淡入(重装和导入时的名字见第 3 节)。+ - 180 ms,圆环的三段淡线各自顺时针画出来(.5 s)。- 220 ms,水线淡入。- 360 ms,睁眼。- 420 ms,底注和位置行淡入。- 560 ms,到位。- 入场全是 CSS,不等脚本。入场时来的卡片和就绪,等它到位再处理。问候至少停 1.5 秒,之后有新消息才换;入场时就来的卡片也等它读满(第 6 节)。-2. 到 560 ms「准备数据文件夹」还没完成、并且已经等了 250 ms,第 1 站才进入进行中,鲸鱼搜索;问候停够以后,鲸鱼说「先找个地方放东西」。鲸鱼先打招呼再出发:这一步完成得再早,它也等问候读满(淡入 160 ms 加 1.5 秒,页面画出来后 1.66 秒)才离开第 1 站,等的时候在第 1 站用工作的循环晃着(搜索到一半完成的也换过来),不说「先找个地方放东西」。这 1.66 秒只是鲸鱼在等:主进程建好数据文件夹就接着启动引擎,不等页面画出来,也不等问候;等的这段时间里引擎已经在后台热身。离开第 1 站时,只有真的说过「先找个地方放东西」,才接一句「找到了」(停 0.7 秒)。一般的首次启动里,数据阶段在页面画出来以前就结束了(主进程建文件夹要 0.3 到 1.2 秒,页面要 1 秒上下、冷启动时好几秒才画出来),所以这两句只在这个阶段慢、出过卡片或者换了新文件夹之后才出现。重新开始(第 7 节)不等问候;入场时就来的就绪照第 1 拍。-3. 「启动本机引擎」:鲸鱼在第 2 站工作,说「热身中,等我一下」。它到了第 2 站,提示行写接下来要知道的事:- - 新团队(没有要导入的团队,数据文件夹里也没有团队):「待会儿要接一个模型:DeepSeek 账号或 API Key」。- - 重装:「上次的 6 个 Bot 和 2 个群聊都在」(第 6 节)。- - 要导入:没有提示。- - 盘不够、又没有更好的盘时,前 10 秒(从第 1 站起)提示行先写「C 盘只剩 1.2 GB」,之后才换成上面这一句(第 6 节)。-4. 5 秒起,右上角显示「已用 N 秒」(`--bt-ink-2`,第 2 节),每秒改一次,数字不滚动,一直留到「进去吧」。没有百分比。-5. 10 秒,引擎还没起来:鲸鱼说「第一次会慢一点」,看向用户一次,循环放慢;提示行不变。-6. 45 秒,引擎还没起来:鲸鱼说「有点久,可能是杀毒软件在查新文件」,提示行只剩 28 px 的〔打开日志文件夹〕。鲸鱼改成思考。-7. 180 秒:见第 6 节。-8. 引擎起来:主进程在隐藏的主窗口里加载引擎的页面,开始 20 秒的就绪检查。鲸鱼游到第 3 站,改成发消息,一出发就说「开门去了」。DSH 会挂出「预览版说明」时(上手流程第 3 节的条件),提示行换成「里面先有一页说明,点「继续」就行」;不会挂出时,第 2 站的提示留着。导入卡开着、还没回答时只算第 2 站完成:不加载页面、不游到第 3 站、不开始 20 秒检查,三件事都等回答以后(〔复制过来〕的等第一段复制完)。-9. `dsBotApp.ready()`:鲸鱼说「进去吧」,见第 8 节。--- 卡片等用户回答时,已用秒数暂停并隐藏,回答后接着走。10 秒、45 秒和 180 秒都按这个时钟算:用户自己想了多久,不算在引擎头上。+ 入场全是 CSS,不等脚本。入场时来的卡片和就绪,等它到位再处理。鲸鱼的话空着;提示行只在盘不够时有那一句(第 3 拍)。+2. 「准备数据文件夹」:到 560 ms 还没完成、并且已经等了 250 ms,第一段弧才进入进行中,鲸鱼搜索。完成时第一段弧画满,但不早于入场后 260 ms(页面画出来后 820 ms),好让人看见它画满;这一小段等待里鲸鱼不换循环(入场后的姿势,或者接着搜索),弧画满、这一拍走完(360 ms)才换成工作的循环:为这 260 ms 换循环,循环自己要停满的 400 ms 会把弧再推迟。这 820 ms 只是弧在等:主进程建好数据文件夹就接着启动引擎,不等页面画出来。一般的首次启动里,数据阶段在页面画出来以前就结束了(主进程建文件夹要 0.3 到 1.2 秒,页面要 1 秒上下、冷启动时好几秒才画出来),所以第一段弧不显示进行中,820 ms 时直接画满。重新开始(第 7 节)不等这一拍;入场时就来的就绪照第 1 拍。+3. 「启动本机引擎」:第二段弧进行中,鲸鱼工作,偶尔张望(第 3 节第二张表第 9 条)。鲸鱼的话和提示行空着;盘不够、又没有更好的盘时,前 10 秒(按启动的时钟)提示行写「C 盘只剩 1.2 GB」(第 6 节)。+4. 10 秒,引擎还没起来:鲸鱼看向用户一次,循环放慢;不出字。+5. 45 秒,引擎还没起来:鲸鱼说「有点久,可能是杀毒软件在查新文件」,提示行只有 28 px 的〔打开日志文件夹〕。鲸鱼改成思考,弧上的光放慢。+6. 180 秒:见第 6 节。+7. 引擎起来:主进程在隐藏的主窗口里加载引擎的页面,开始 20 秒的就绪检查。第二段弧画满,第三段「打开团队」进行中,鲸鱼改成发消息;45 秒的那句和〔打开日志文件夹〕收起。导入卡开着、还没回答时,预热好的引擎只算到第二段:不加载页面、第三段不开始、不开始 20 秒检查,三件事都等回答以后(〔复制过来〕的等第一段复制完)。+8. `dsBotApp.ready()`:剩下的弧画满,圆环合上,鲸鱼喷一次水,潜下去,见第 8 节。++- 10 秒、45 秒和 180 秒按启动的时钟算,页面上不显示这个时钟。卡片等用户回答时它停着,回答后接着走:用户自己想了多久,不算在引擎头上。- 位置行(第 2 节)从入场起就在:新团队和要导入时写「数据放在 C 盘(剩 412 GB)· 换个位置…」,什么都不点就按它走,不问。点「换个位置…」才开系统选择框(第 6 节),选择框开着时时钟也停。交接时随整组淡出(第 8 节)。### 5. 以后的启动-- 0 ms:64 px 的鲸鱼在窗口中间浮上来(`SPRING_TAP` 290 ms),不倾斜,眼睛睁着,没有涟漪。60 ms 后,「正在打开你的团队…」淡入。-- 没有水线和圈,也没有首次启动的那些话和提示:鲸鱼下面只有这一行已定的字(换位置时是「正在搬 DeepSeek 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 秒:和首次启动一样。-- 就绪时没有庆祝(重试或重新开始后第一次成功时例外,第 8 节):字淡出 .16 s,鲸鱼从当前姿势潜下去;120 ms 时发 `handoffShow`,启动窗口和首次启动一样长成主窗口的矩形,主窗口在就绪后约 0.6 秒露面(第 8 节)。+- 换位置(第 1 节)时,鲸鱼下面一直是「正在搬 DeepSeek Bot 的数据…」,45 秒起换成「比平时慢,请再等一会儿」和〔打开日志文件夹〕。以后的启动和搬数据时,这一行的字 1 秒后带流光。+- 就绪时没有庆祝(重试或重新开始后第一次成功时例外,第 8 节):剩下的弧画满、圆环合上,100 ms 后鲸鱼潜下去;220 ms 时发 `handoffShow`,启动窗口和首次启动一样长成主窗口的矩形,主窗口在就绪后约 0.7 秒露面(第 8 节)。- `DS_BOT_HOME` 的一次性运行用这一套,只是不出卡片。### 6. 卡片、180 秒和导入- 所有卡片用同一套变形:- - 出现:鲸鱼的话和提示行淡出 .16 s(问候还没读满 1.5 秒时,等它读满再淡出,见下面);整组先上移 80 px(第 2 节,首次启动和以后的启动一样);卡片的底色和边线两层从 0 高长到内容的高度(`clip-path`,走 `SPRING_SHAPE`;底色 .22 s 淡入);内容先按最终尺寸排好,晚 70 ms 淡入;焦点移到主按钮。- - 回答后:内容 .16 s 退场(下沉 6 px、缩到 .975、模糊 3px),卡片收回,整组再回到低处,鲸鱼的话接着跟着鲸鱼走(第 3 节)。-- 卡片在时鲸鱼的话空着、提示行隐藏。入场时就来的卡(导入、推荐盘):问候读满 1.5 秒才淡出,这段时间(约 1 秒)它和卡片的第一行同时在,问候不会只闪一下。卡片自己的第一行是鲸鱼说的一句(15/20、600,一行),写在已定的内容上面,内容本身不变:+ - 出现:鲸鱼的话和提示行淡出 .16 s;整组上移 80 px,水塘在同一个弹簧里缩到 .62 倍、再上移 60 px(第 2 节,首次启动和以后的启动一样);卡片的底色和边线两层从 0 高长到内容的高度(`clip-path`,走 `SPRING_SHAPE`;底色 .22 s 淡入);内容先按最终尺寸排好,晚 70 ms 淡入;焦点移到主按钮。+ - 回答后:内容 .16 s 退场(下沉 6 px、缩到 .975、模糊 3px),卡片收回,水塘回到原大,整组回到低处。+- 卡片在时鲸鱼的话空着、提示行隐藏。卡片自己的第一行是鲸鱼说的一句(15/20、600,一行),写在已定的内容上面,内容本身不变:- 导入卡:「找到你以前的团队了」。- 推荐盘:「C 盘有点挤」(空间不够),「这里不让我放东西」(默认位置不能用)。- 「会放在…」:「我多加了一层文件夹」。@@ -187,17 +193,17 @@- 推荐盘:「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 盘〕照旧留着;选择框被取消就回到来时的卡。「会放在…」和被拒绝的卡也有脚注。- 脚注都是「以后可以在 设置 → 通用 → 位置 里改。」- - 没有更好的盘时不出卡片:前 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 秒,鲸鱼会一直在水下;那个文件夹马上就删,没有要保全的东西),默认位置上这一次建的文件夹删掉(数据文件夹整个删,总工作区只在还是空的时候删),位置这时就记下,鲸鱼在第 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 秒,鲸鱼会一直在水下;那个文件夹马上就删,没有要保全的东西),默认位置上这一次建的文件夹删掉(数据文件夹整个删,总工作区只在还是空的时候删),位置这时就记下,三段弧回到没开始,鲸鱼在原处重新浮上来。导入复制进行中不接这一下,复制完以后这一行收起:搬一个复制好的团队是 设置 → 通用 → 位置 的事。+- 重装(`C:\Users\<用户名>\.ds-bot` 里有团队、没有保存的位置)不出卡片,盘不够也不出;启动页上不写上次的团队和路径,进门后就是它。- 180 秒:鲸鱼立刻问「等太久了,要不要重试?」,卡片里只有〔继续等待〕(主按钮)〔重试〕〔打开日志文件夹〕,读屏读的是这句问话。- 〔继续等待〕:卡片收回,180 秒后再问。- 〔重试〕:重启引擎,时钟从 0 开始,鲸鱼抖一抖,回到工作。- - 卡片还在时引擎起来了:卡片收回,照常游到第 3 站。+ - 卡片还在时引擎起来了:卡片收回,照常画满第二段弧。- 找不到数据文件夹(多见于以后的启动):文字和按钮按第 3 节已定的,主按钮在前。〔重试〕后还是找不到:按钮下面出现「还是找不到这个文件夹。」(`--bt-danger`,4 秒后淡出)。鲸鱼的眼睛左右看一遍,不跳。- 导入(第 4 节)都在纸面里,用同一套变形:- 导入卡一句话:「DeepSeek Harness 里有 6 个 Bot 和 2 个群聊(对话 1.2 GB,工作文件 3.4 GB)。复制过来?」,下面一行小字「复制后会多占 4.6 GB,DeepSeek Harness 里的原件不动。」,〔复制过来〕(主按钮,拿到焦点)〔先不复制〕,脚注「也可以在 设置 → 通用 → 位置 里复制。」「详细」是和失败页一样的折叠区:找到的名字和段数、会复制什么、「模型设置:DeepSeek API · DeepSeek-V4-Pro 更换」、两个勾选框;展开时卡片的边用 `SPRING_SHAPE` 长高,内容晚 70 ms 淡入。- - 卡片一出现,第 2 站就开始预热,没被 DSH 占着时检查对话同时进行,鲸鱼在第 2 站跳两下后停下;预热好了也只算第 2 站完成,不游到第 3 站。答〔先不复制〕时鲸鱼点一下头,预热好的引擎接着当正式引擎用,不重启。+ - 卡片一出现,引擎就开始预热,没被 DSH 占着时检查对话同时进行,鲸鱼跳两下后停下;预热好了也只算到第二段弧,第三段「打开团队」等回答以后才开始。答〔先不复制〕时鲸鱼点一下头,预热好的引擎接着当正式引擎用,不重启。- 空间不够(只查第一段):「空间不够:复制要约 1.7 GB,C 盘只剩 1.5 GB,还差 0.2 GB。」〔选择其他位置…〕(主按钮)〔先不复制〕- 复制中:- 卡片标题「正在搬过来」,三步竖着排,各带一个 16 px 的标记(没开始:一圈细线;进行中:`--bt-ink` 圈加 6 px 实心点;完成:`--bt-green` 圆底对勾,`SPRING_POP` 弹出):「检查对话 23/143」→「复制 Bot 和对话 820 MB / 1.2 GB」→「启动团队」。@@ -213,10 +219,10 @@### 7. 失败、更新和界面没加载出来- 失败后 1 秒内:- - 鲸鱼的话立刻换成「DeepSeek Bot 没能启动」,读屏读出这一句。- - 鲸鱼在它停的那一站换成失败的姿势(第 3 节),站上不画叉:失败只靠鲸鱼的姿势和这一句。- - 已用秒数和提示行淡出。- - 纸面变成恢复卡:一句原因、五个按钮、「详细信息」。卡片没有鲸鱼的第一行。+ - 鲸鱼的话立刻换成「DeepSeek Bot 没能启动」,写在圆环和卡片之间(第 2 节),读屏读出这一句。+ - 鲸鱼换成失败的姿势(第 3 节),卡住的那段弧变红,不画叉:失败只靠鲸鱼的姿势、红的那段弧和这一句。+ - 提示行淡出。+ - 纸面变成恢复卡:一句原因、五个按钮、「详细信息」。卡片没有鲸鱼的第一行。水塘缩小上移,圆环在卡片上面(第 2 节)。- 焦点移到〔重试〕。窗口不隐藏。- 〔复制详细信息〕点过后,按钮上的字变成「已复制」,1.6 秒后变回来。「详细信息」最多展开 168 px,日志在框里滚动。- 有新版本时:@@ -226,38 +232,38 @@- 下载失败显示「下载失败。」〔重试〕〔手动下载〕。- 鲸鱼抬一次头,看向更新条,然后又静止。- 恢复卡上的选择:- - 〔重试〕:已完成的阶段保持完成,留下的圈不动;失败的那个阶段回到进行中,鲸鱼抖一抖,回到工作,鲸鱼的话回到这一站的那句。- - 〔换个位置…〕和〔用新的空白团队开始…〕:先选文件夹(定根和首次启动同一条规则);然后鲸鱼的话和提示行空着,鲸鱼沉到水线下,留下的圈一起淡出(.16 s),三个阶段回到未开始,鲸鱼在第 1 站重新浮上来,说「先找个地方放东西」。位置行的「换个位置…」(第 6 节)走同一条路;阶段被收回时,就算下一个快照里第 1 站马上又完成了,鲸鱼也先沉下去。- - 重试或重新开始后第一次成功时庆祝一次:首次启动照第 8 节的表,先说「进去吧」;以后的启动不说「进去吧」,字照旧,压扁回弹 920 ms 后潜下去(第 8 节)。+ - 〔重试〕:画满的弧保持画满;红的那段回到进行中,鲸鱼抖一抖,回到工作。+ - 〔换个位置…〕和〔用新的空白团队开始…〕:先选文件夹(定根和首次启动同一条规则);然后鲸鱼沉到水线下 84 px,.16 s 淡出,三段弧回到没开始,鲸鱼在原处重新浮上来(12° 的倾斜回正,`SPRING_STRETCH`)。位置行的「换个位置…」(第 6 节)走同一条路;阶段被收回时,就算下一个快照里第一段马上又完成了,鲸鱼也先沉下去。+ - 重试或重新开始后第一次成功时庆祝一次,首次启动和以后的启动一样:圆环合上时压扁、「^ ^」眼、喷水,然后潜下去(第 8 节)。- 团队界面 20 秒没加载出来:- 主窗口始终不显示。- - 鲸鱼在第 3 站换成失败的姿势,它的话换成「团队界面没有加载出来」,不画叉;卡片里是〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕,没有鲸鱼的第一行。- - 〔重新载入〕:在隐藏的主窗口里重新载入,回到第 3 站,20 秒重新算。+ - 鲸鱼换成失败的姿势,第三段弧变红,它的话换成「团队界面没有加载出来」,不画叉;卡片里是〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕,没有鲸鱼的第一行。+ - 〔重新载入〕:在隐藏的主窗口里重新载入,第三段弧回到进行中,20 秒重新算。- `ready()` 晚到了也直接交接,不庆祝。### 8. 交接-首次启动(重试或重新开始后第一次成功也一样)。`t0` 是 `ready()` 到达后、鲸鱼停在第 3 站的那一刻;`c` 是「进去吧」在屏幕上满 300 ms、庆祝开始的那一刻:+每种启动的交接都这样开始。`t0` 是 `ready()` 到达的那一刻(入场还没到位时,从到位算):还没画满的弧一起画满(.56 s),圆环合上:空隙接上(.3 s),整圈鼓起一次(.5 s,第 2 节)。交接不等排着的阶段,也不等页面上的字。++庆祝的交接,就是首次启动的交接,以及重试或重新开始后第一次成功的交接(第 7 节):| 时间 | 启动窗口 | 主进程 ||---|---|---|-| `t0` | 上一句能读满 400 ms 后,鲸鱼的话换成「进去吧」(淡出、淡入各 .16 s) | |-| `c`(「进去吧」出来 300 ms 后) | 「^ ^」眼;开始压扁 | |-| `c` + 160 ms | 已用秒数和提示行淡出 | |-| `c` + 460 ms | 拉到最长时潜下去,深到身高的 1.25 倍;鲸鱼的话、水线、圈、纸面和底注淡出 .16 s | |-| `c` + 560 ms | 涟漪,160 ms 淡完 | |-| `c` + 620 ms(`t0` 后约 1.1 s) | 发 `handoffShow` | 主窗口已经隐藏着放在最后的矩形上(以启动窗口的中心居中,不超出工作区);任务栏上仍是启动窗口的按钮 |-| `handoffShow` + 160 ms | 页面已经空了:字淡完,鲸鱼潜下去,涟漪没了,只剩 Mica | 把启动窗口从 720 × 540 长到主窗口的矩形,300 ms,逐步 `setBounds`,约 14 ms 一步 |-| `c` + 880 ms | 潜完,发 `handoffDone` | |+| `t0` | 圆环合上;鲸鱼压扁再拉长(460 ms),「^ ^」眼,尾巴甩一下,喷一次水(第 3 节) | |+| `t0` + 160 ms | 提示行淡出 | |+| `t0` + 560 ms | 拉到最长时潜下去,深到身高的 1.25 倍;鲸鱼的话、水线、圆环、还在落的水、纸面、底注和位置行淡出 .16 s | |+| `t0` + 660 ms | 涟漪,160 ms 淡完(交接时喷的水不另起一圈) | |+| `t0` + 720 ms | 发 `handoffShow` | 主窗口已经隐藏着放在最后的矩形上(以启动窗口的中心居中,不超出工作区);任务栏上仍是启动窗口的按钮 |+| `handoffShow` + 160 ms | 字、水线、圆环和纸面都已淡完,鲸鱼在水线下,只剩 Mica | 把启动窗口从 720 × 540 长到主窗口的矩形,300 ms,逐步 `setBounds`,约 14 ms 一步 |+| `t0` + 980 ms | 潜完,发 `handoffDone` | || `handoffShow` + 460 ms | | 长到位;主窗口在同一个矩形上、在启动窗口上面露面,用系统自己的打开过渡;启动窗口同时离开任务栏,应用的任务栏按钮一直在 || `handoffShow` + 760 ms | | 主窗口露面 300 ms 后销毁启动窗口 |-- 首次启动时主窗口在就绪后约 1.6 秒露面。+- 庆祝的交接里主窗口在就绪后约 1.2 秒露面。- 长大由主进程做:Electron 44 在 Windows 上不理 `setBounds` 的 `animate` 参数,只能一步一步改大小。每一步页面都重新排版,但只重画其中一部分(探针里 23 步重画了 8 次),所以长大时页面上除了 Mica 什么都不能有。-- 以后的启动:字淡出 .16 s,鲸鱼 290 ms 潜下去;120 ms 时发 `handoffShow`,290 ms 时发 `handoffDone`。长大和露面和首次启动一样从 `handoffShow` 算起,主窗口在就绪后约 0.6 秒露面。-- 以后的启动重试或重新开始后第一次成功(第 7 节):字照旧,不说「进去吧」;压扁回弹 920 ms,「^ ^」眼,然后 290 ms 潜下去;`handoffShow` 约在就绪后 1.04 秒(920 ms 加 120 ms),长大和露面照旧从它算起,主窗口约 1.5 秒露面。-- 页面没发 `handoffShow` 时,主进程自己显示主窗口:首次启动在 2.5 秒后(最坏 1.17 秒,加上最多 600 ms 的排队游动,再留余量);以后的启动在 0.8 秒后,只有庆祝的那次(重试或重新开始后第一次成功,约 1.04 秒才发 `handoffShow`)也是 2.5 秒。-- 减少动态效果:不长大。首次启动「进去吧」照样先停 300 ms,「^ ^」眼再停 300 ms,内容淡出 .12 s 后发 `handoffShow`(就绪后约 0.86 秒),主窗口直接出现在它最后的矩形上(第 9 节)。+- 不庆祝的交接(以后的启动):圆环合上;100 ms 时页面上的字、水线、圆环和纸面淡出 .16 s,鲸鱼 290 ms 潜下去(`SPRING_TAP`),深到身高的 1.25 倍;220 ms 时发 `handoffShow`,390 ms 时发 `handoffDone`。长大和露面和首次启动一样从 `handoffShow` 算起,主窗口在就绪后约 0.7 秒露面。+- 页面没发 `handoffShow` 时,主进程自己显示主窗口:首次启动和庆祝的交接在 2.5 秒后,其余以后的启动在 0.8 秒后。页面发得早得多:庆祝的 0.72 秒,不庆祝的 0.22 秒;入场还没到位时,再晚最多一个入场(560 ms、290 ms)。+- 减少动态效果:不长大。剩下的弧画满、圆环合上都只用 .12 s,庆祝时换成「^ ^」眼(安静档不换);300 ms 时内容淡出 .12 s,420 ms 时发 `handoffShow`,440 ms 时发 `handoffDone`,主窗口直接出现在它最后的矩形上(第 9 节)。- 启动窗口有焦点时,主窗口直接显示并拿到焦点。- 启动窗口没有焦点时,主窗口不抢焦点,放在启动窗口原来的层次上,任务栏按钮闪烁。- 启动窗口最小化着时不长大,主窗口也最小化着出现,任务栏按钮闪烁。@@ -271,11 +277,13 @@### 9. 减少动态效果- 跟随 `prefers-reduced-motion`(Windows 上是 设置 → 辅助功能 → 视觉效果 → 动画效果)。窗口开着时切换,也立刻生效:正在跑的动画直接到终点。-- 鲸鱼一直是静止的画面:没有浮上来、游动、循环、跳、涟漪、尾巴、跟随和抚摸,也没有第 3 节第二张表的八种动作。换站时淡出 .12 s,换到新的一站,再淡入 .12 s。-- 状态只靠眼睛直接切换:平时睁眼,45 秒起眯眼,就绪时显示「^ ^」600 ms,失败时眼皮变重。-- 圈、鲸鱼的话、复制中的对勾、卡片、提示行和更新条只淡入 .12 s、淡出 .16 s,没有模糊、位移和缩放。圈不张开;卡片高度直接到位(内容先是透明的);整组上移、回到低处也直接到位;没有流光。-- 交接时不长大:内容淡出 .12 s,然后发 `handoffShow`,主窗口直接出现在它最后的矩形上(第 8 节)。-- 信息一样不少:已用秒数照常走,鲸鱼的话、提示行、按钮、看不见的阶段列表和朗读都在。+- 鲸鱼一直是静止的画面:没有浮上来、循环、跳、涟漪、尾巴、跟随、抚摸和喷水,也没有第 3 节第二张表的九种动作;阶段完成时鲸鱼不动。点鲸鱼只换成「^ ^」眼。+- 状态只靠眼睛直接切换:平时睁眼,45 秒起眯眼,失败时眼皮变重;点鲸鱼时和庆祝的交接里(就绪到内容淡出)是「^ ^」。+- 圆环不画出来,一开始就在;弧画满、合成一整圈都只用 .12 s,整圈不鼓起;进行中的弧只染淡蓝,没有跑动的光。+- 鲸鱼的话、复制中的对勾、卡片、提示行和更新条只淡入 .12 s、淡出 .16 s,没有模糊、位移和缩放。卡片高度直接到位(内容先是透明的);整组上移、水塘缩小,回到低处和原大,也都直接到位;没有流光。+- 沉下去重新开始时,水道淡出 .16 s,三段弧回到没开始,鲸鱼直接回来。+- 交接时不长大:剩下的弧画满、圆环合上,300 ms 时内容淡出 .12 s,420 ms 时发 `handoffShow`,主窗口直接出现在它最后的矩形上(第 8 节)。+- 信息一样不少:三段弧、鲸鱼的话、提示行、按钮、看不见的阶段列表和朗读都在。### 10. 颜色、Mica 和标题带@@ -287,10 +295,11 @@- Windows 11 22H2 及以后:- 窗口用 `backgroundMaterial: 'mica'`,背景 `#00000000`;页面的 `html`、`body` 透明。- 系统按钮颜色 `#00000000`,符号用 `--bt-ink`,按钮下面也是 Mica。- - Mica 上最浅的字用 `--bt-ink-2`,不用 `--bt-ink-3`:已用秒数和提示行也是。+ - Mica 上最浅的字用 `--bt-ink-2`,不用 `--bt-ink-3`:提示行和位置行也是。- 其他 Windows:窗口背景和系统按钮颜色都用 `--bt-main`。页面照样透明,自己不用分辨是哪种情况。-- 一屏最多两处大面积强调色:鲸鱼和唯一的主按钮。+- 一屏最多两处大面积强调色:鲸鱼和唯一的主按钮(画满的弧是 2 px 的线,水柱和水滴只闪一下,都不算)。- 没有警告色(`--bt-warn` 未定):空间不足、OneDrive 和慢的提示都用中性墨色。+- 强制颜色(Windows 的对比度主题):圆环的淡线用 `GrayText`,失败的那段也是(失败靠鲸鱼的姿势和标题);画满的弧、合上的整圈、弧上的光、水柱和水滴用 `Highlight`。- 字体:`-apple-system, BlinkMacSystemFont, "Segoe UI", "Microsoft YaHei UI", system-ui, sans-serif`;路径和日志用 `ui-monospace, Consolas, monospace`。字号只有 13/18、14/22、15/20(600),数字用等宽数字。- macOS 和 Linux:系统标题栏,没有标题带,其余一样。@@ -313,14 +322,15 @@- `text.mjs`:中英文的唯一一张表,启动页和主进程的系统对话框都用。层、键名、写法规则和测试见 [启动页文案](2026-10-29-start-copy.md):键的第一段是那里定的层(`voice`、`say`、`hint`、`card`、`reason`、`btn`、`note`、`foot`、`status`、`dialog`),说的是这行字在页面的哪里,每层一条写法规则。- 预算:这五个文件合计不超过 45 KB(未压缩,原型定的目标);原型超了,怎么办见「待定」。- 所有状态的 DOM 一开始就在页面里,用 `hidden` 和属性切换,运行时不插入大块节点。-- 三个阶段在页面里是一个看不见的列表(`ol`,「启动进度」),`aria-current` 和状态词照旧更新;看得见的只有鲸鱼、水线和圈。-- 鲸鱼的话不直接跟快照走:`whale.js` 的 `stage()` 报告鲸鱼在哪一站、哪个阶段显示进行中、是不是在游、是不是正沉下去、是不是「进去吧」,`start.js` 照它选这一句,按第 3 节的停留时间排队。「进去吧」上屏的时刻由 `start.js` 告诉 `whale.js`(`readyLine`,最多等 600 ms),庆祝从那以后 300 ms 开始。+- 三个阶段在页面里是一个看不见的列表(`ol`,「启动进度」),`aria-current` 和状态词照旧更新;看得见的只有鲸鱼、水线和圆环:每段弧的 `data-state`(`pending`、`active`、`done`、`failed`)跟着列表里同一个阶段改,合上的整圈是 `html[data-ring=closed]`。+- 水塘(`.pond`)在卡片要纸面时和整组用同一个弹簧缩小上移(`start.js` 的 `shift()`),以圆心为准(整组坐标里的 (360, 210))。+- 鲸鱼的话和提示行由 `start.js` 按快照和启动的时钟选(第 3 节),不问 `whale.js`,也不排队。交接的时间表在 `whale.js` 里(第 8 节),不等页面上的字。快照里的 `explain`(`mode`、`name`、`nextStep`、`previewNotice`)页面不读。- `html` 是 `overflow: hidden`,`body` 是 `overflow: clip`:整组低着时超出的部分被裁掉,焦点、滚动锚点和恢复的滚动位置都移不动页面。- 鲸鱼的 SVG 由 `start-assets.mjs` 从 `characterMarkup('whale', 'deepseek')` 生成后写进 `start.html`,遮罩 id 固定。同一个脚本把 `motion.js` 的弹簧和主题色写进 `start.css`。`npm test` 跑它的 `--check`。- 预载只在页面地址正好是启动页时暴露 `dsBotStart`(`onState`、`act`)。- 主进程每次都发完整的状态,页面重新载入后再发一次。预载记住最后一份,有人订阅时先补发。- 主进程只接受来自启动窗口主框架、地址完全相同的 `act`,而且名字要在白名单里。-- 主进程管:阶段、180 秒和 20 秒两个计时器、交接的兜底计时器、任务栏进度、更新状态。页面按时钟算 5 秒、10 秒和 45 秒。+- 主进程管:阶段、180 秒和 20 秒两个计时器、交接的兜底计时器、任务栏进度、更新状态。页面按时钟算 10 秒和 45 秒。- 交接时的长大也由主进程做:主窗口一建就在最后的矩形上,`handoffShow` 后 160 ms 用逐步的 `setBounds` 把启动窗口长过去,460 ms 显示主窗口、同时让启动窗口离开任务栏,再过 300 ms 销毁启动窗口(第 8 节)。兜底计时器按这次交接是不是首次启动、有没有庆祝选 2.5 秒或 0.8 秒。启动页只发 `handoffShow` 和 `handoffDone` 两个事件,和原来一样;主窗口露面时主进程告诉团队界面,让磁贴上的鲸鱼浮上来(第 8 节,待定)。- `main.log` 记三个阶段各用了多久。- 启动窗口在交接时销毁,它的渲染进程一起退出。@@ -338,8 +348,8 @@| 同上「改动的已定设计」:窗口先加载启动页,再加载引擎的本机地址 | 启动窗口先出来;主窗口隐藏着加载引擎的本机地址(同一个地址和端口),就绪后才显示 || 同上 验收「进程启动后 2 秒内窗口可见」「没有一个 `dialog.show*` 不挂在主窗口上」 | 两条里的窗口都指启动窗口 || [桌面应用](2026-10-16-desktop-app.md)「窗口」 | 加上启动窗口:720 × 540,不能缩放,只有最小化和关闭,Mica;交接时由主进程长成主窗口的矩形(第 8 节) |-| [UI 标准](../design/ui-standard.md) 4.4 头像尺寸 | 加 88(启动窗口,首次启动) |-| 同上 8.3 状态动作 | 加只在启动窗口里有的动作:浮上来、游到下一站、点头、潜下去、尾巴摆 |+| [UI 标准](../design/ui-standard.md) 4.4 头像尺寸 | 加 112(启动窗口) |+| 同上 8.3 状态动作 | 加只在启动窗口里有的动作:浮上来、阶段完成时划尾巴向前一涌、点头、喷水、潜下去、尾巴摆 || 同上 3.1 字族 | 启动窗口加 `"Microsoft YaHei UI"`,记进第 14 节 || 同上 12 可访问性 | 新出现的卡片和恢复页,焦点移到主按钮 || [Windows 上手流程](2026-10-26-windows-onboarding.md) 第 3 节「标题「正在准备你的 Bot 团队…」,下面三个真实阶段,各带进度勾」;本文首稿第 2 节的标题行和三站(16 px 标记的四种样子、阶段名、站间的细线、进行中的流光) | 没有标题行,阶段不画出来:鲸鱼停在哪一站就是进度,离开的站留下一个圈,水线上不画别的;三个阶段只留在看不见的列表「启动进度」里,朗读照旧;已用秒数移到右上角;没有卡片时整组低 80 px(第 2、3 节) |@@ -356,6 +366,15 @@| 本文首稿 第 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 转来一段讨论,说这一版太吵:「现在这版有点噪了」「是不是可以简约一点」;比较三份草稿(水线分三段的进度条、圆环、只有鲸鱼)后选了圆环 |+| 同上 第 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,让合上的圆环先被看见 |## 变更@@ -368,24 +387,24 @@- 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 秒,入场时就在。## 待定| 问题 | 选项 | 建议 ||---|---|---|-| 启动页放在哪里? | 单独的启动窗口(本文);主窗口里叠一层透明的 `WebContentsView`,团队界面在下面加载,就绪后淡出;按原来的设计在同一个窗口里 `loadURL` | 单独的启动窗口:真正的小窗,一直有 Mica,交接没有空白帧,「打开团队」也是真的。覆盖层是第二选择:同样没有空白帧,但启动时就是大窗口,还要管两套焦点;Electron 44 上实测,看不见的 `WebContentsView` 不渲染,覆盖层只能不透明,启动时就没有 Mica。原来的做法会露出 DSH 自己的加载,游到第 3 站、庆祝和长大都只能不做 |+| 启动页放在哪里? | 单独的启动窗口(本文);主窗口里叠一层透明的 `WebContentsView`,团队界面在下面加载,就绪后淡出;按原来的设计在同一个窗口里 `loadURL` | 单独的启动窗口:真正的小窗,一直有 Mica,交接没有空白帧,「打开团队」也是真的。覆盖层是第二选择:同样没有空白帧,但启动时就是大窗口,还要管两套焦点;Electron 44 上实测,看不见的 `WebContentsView` 不渲染,覆盖层只能不透明,启动时就没有 Mica。原来的做法会露出 DSH 自己的加载,圆环合上、庆祝和长大都只能不做 || 鲸鱼的尾巴能单独动吗? | 启动页把生成器的输出按尾柄(`27.9, 61.1`)裁成两层,不加新形状;生成器加一个尾巴单独成层的选项;尾巴不动 | 先用裁切,只在启动窗口里用。以后插件也要用时,再给生成器加选项。去掉也只少了尾巴,其余不变 |-| 1 px 的水线要不要留? | 留:1 px `--bt-line`,首尾渐隐,上面什么都不画;去掉,只留鲸鱼和它留下的圈 | 留:圈和三站要有一个面可以落,鲸鱼被裁掉的那条边也在这里 |+| 水线要不要留? | 留:圆环的一条弦,200 px,1 px `--bt-line-2`,首尾渐隐;去掉,只留鲸鱼和圆环 | 留:鲸鱼被裁掉的那条边在这里,喷出的水和涟漪也落在这里 || 启动页超过 45 KB 的预算(第 11 节)怎么办?(原型实测:五个文件的源码 113 KB,压缩后 79 KB,gzip 约 35 KB;`text.mjs` 带中英两种语言) | 放宽预算;`text.mjs` 按语言拆开,只加载界面语言的那一份;打包时压缩 | 先按语言拆 `text.mjs`、打包时压缩,在 M4 实测启动页的第一帧;第一帧不晚就放宽预算:页面是本地文件,不走网络(同 [上手流程](2026-10-26-windows-onboarding.md) 的「待定」) |-| 启动窗口的问候用哪个名字?(第 3 节) | 按第 3 节:新团队用界面语言的默认名字,重装用团队里 Main Bot 的名字,要导入或读不出时不带名字;一律不带名字(「嗨,我来了」);一律用默认名字 | 按第 3 节。中文的默认名字和 [上手流程](2026-10-26-windows-onboarding.md)「待定」里「中文界面里第一个 Main Bot 叫什么?」一起定;一律用默认名字时,重装和导入的人在启动窗口里听到一个名字,进门后看到另一个 || 磁贴上的鲸鱼怎么知道该浮上来?「预览版说明」盖着侧栏时怎么办?(第 8 节) | 主进程显示主窗口时经 `dsBotApp` 发一个露面事件,带上这是不是首次启动([上手流程](2026-10-26-windows-onboarding.md) 第 3 节的 `dsBotApp` 列表要加一项);页面自己等 `visibilitychange` 第一次变成 `visible`(不加接口,但分不出是哪种启动;Electron 默认照常渲染隐藏的新窗口,这时页面第一次加载的 `document.visibilityState` 可能不对)。说明挂着时:照样在它下面浮上来;等它关掉再浮;不浮,鲸鱼从第一帧起就在 | `dsBotApp` 的露面事件:时刻和启动的种类都准。说明挂着时先照样浮,M4 看它在说明下面看不看得见;看不见就不浮:DSH 的说明关掉时没有事件,插件等不到「继续」 |## 不做什么-- 不画百分比进度条:引擎不报百分比。复制和下载的进度条用真实的字节数。-- 不编造阶段,不为动画推迟引擎和团队界面的加载;交接为了长大多等约 460 ms(首次启动另有「进去吧」的 300 ms),见第 8 节。「进去吧」只在首次启动时有;庆祝只在首次启动和重试、重新开始后第一次成功时有。主窗口在 `ready()` 后约 1.6 秒露面(长大要等页面空了才开始),以后的启动约 0.6 秒,以后的启动庆祝的那次约 1.5 秒。-- 不放轮播的提示和笑话。鲸鱼只说一句和它的状态有关的短话(第 3 节),不冒气泡,不讲笑话,不挡卡片和按钮;鲸鱼的话里只有 180 秒那一句是问题,回答在卡片的按钮上,别的话都不要用户做什么(提示行只提前说接下来会遇到什么)。失败时不哭不闹,失败页上不说俏皮话。-- 鲸鱼没有「?」徽标(UI 标准 8.2:大头像不显示徽标),不侧身跃出水面,不喷水;等待时不乱游,不对每次按键都有反应,没有声音。+- 不画百分比进度条:引擎不报百分比。圆环的一段弧只有没开始、进行中、完成、失败四种样子,不按百分比画一部分。复制和下载的进度条用真实的字节数。+- 不编造阶段,不为动画推迟引擎和团队界面的加载;交接为了长大多等约 460 ms,见第 8 节。庆祝(喷水)只在首次启动和重试、重新开始后第一次成功时有。庆祝的交接里主窗口在 `ready()` 后约 1.2 秒露面(长大要等页面空了才开始),不庆祝的约 0.7 秒。+- 不放轮播的提示和笑话。顺利时鲸鱼不说话,只在第 3 节列的几种时候说一句和它的状态有关的短话,不冒气泡,不讲笑话,不挡卡片和按钮;鲸鱼的话里只有 180 秒那一句是问题,回答在卡片的按钮上。不提前说进门以后的事(接模型、预览版说明、上次的团队)。失败时不哭不闹,失败页上不说俏皮话。+- 鲸鱼没有「?」徽标(UI 标准 8.2:大头像不显示徽标),不侧身跃出水面;只在用户点它和庆祝的交接时喷水;不游来游去,不对每次按键都有反应,没有声音。- 鲸鱼不从启动窗口飞进主窗口:它在小窗口里潜下去,首次启动时在侧栏的磁贴上浮上来(第 8 节)。- 不画 DSH 的鲸鱼标志,不用其他产品的动画、插图、声音和字体。- 不往引擎的页面里注入 CSS 或 DOM 来接画面,不改 DSH。@@ -398,16 +417,14 @@- 从没显示过的 Mica 窗口第一次 `show()` 时,可能先露出一两帧空的 Mica。交接时启动窗口已经长成同样大小的空 Mica,主窗口在它上面露面,这一两帧和下面的一样。M4 用 60 帧录像确认主窗口第一帧之前没有白帧或黑帧;有的话,改成主窗口先在长大后的启动窗口下面露面,画出第一帧再放到上面、销毁启动窗口。- `#00000000` 的系统按钮颜色,只在一台 Windows 11(26200,深色,窗口不在前台)上验证过是透明的。前台、浅色、悬停和按下都没验证。按钮画成不透明的系统,改用不透明的 `--bt-main` 窗口。- 未打包、机器忙时实测:进程启动后 1.35–1.57 秒窗口才建好,页面第一次画出来还要再等 0.9–1.0 秒。启动页的第一帧和空窗口一模一样,这段看不出来,但入场会晚。-- SVG 里的尾巴和眼睛、内容的模糊淡入和流光不走合成线程。杀毒软件在扫描、引擎又在启动时,可能卡顿;那时先去掉尾巴。+- SVG 里的尾巴和眼睛、圆环的弧和弧上的光、喷出的水柱、内容的模糊淡入和流光不走合成线程。杀毒软件在扫描、引擎又在启动时,可能卡顿;那时先去掉尾巴。- 动画档和浅深色要等团队界面报告一次才记得住。在应用外改过主题时,下次启动先用旧的。-- 第 2 站结束是从引擎的 HTTP 起来推断的:DSH 不报命名的阶段(「需要 DSH 提供的」第 11 条)。+- 第二段弧画满,是从引擎的 HTTP 起来推断的:DSH 不报命名的阶段(「需要 DSH 提供的」第 11 条)。- 工作区不到 588 高的显示器上,窗口只有 500 高,长卡片要在纸面里滚动。- 启动时多一个渲染进程(约 40–60 MB),交接后销毁。- 从开始长大到启动窗口销毁的约 600 ms 里两个窗口同时存在,主窗口露面后的 300 ms 里两个都看得见。启动窗口在主窗口露面时才离开任务栏,任务栏按钮不会消失再出现;但那 300 ms 里 Alt+Tab 可能短暂看到两个。-- 鲸鱼的话每句都要停够才换,阶段很快时会落在鲸鱼后面:比如换了新文件夹以后,鲸鱼已经到了第 2 站,「先找个地方放东西」还在淡入,「找到了」接着在第 2 站说。它从不说还没发生的事,只是不完全同步。-- 一般的首次启动里,数据阶段在「嗨,我是总管」读完以前就结束了,「先找个地方放东西」和「找到了」很少出现:用户读到的是「嗨,我是总管」「热身中,等我一下」「开门去了」「进去吧」。-- 首次启动时主窗口在就绪后约 1.6 秒才露面,以后的启动约 0.6 秒(庆祝的那次约 1.5 秒):长大要等页面空了才开始,主窗口长到位才显示。+- 一般的首次启动里,数据阶段在页面画出来以前就结束了,第一段弧很少显示进行中:入场后 260 ms 直接画满。+- 庆祝的交接里主窗口在就绪后约 1.2 秒才露面,不庆祝的约 0.7 秒:长大要等页面空了才开始,主窗口长到位才显示。- 长大靠逐步 `setBounds`:页面每一步都重新排版,但只重画其中一部分,所以长大时纸面必须是空的;机器忙时长大不平滑。-- 圈(不透明度 .5)和已用秒数在真的 Mica 上看不看得清,还没验证:原型的截图用的是不透明的 `--bt-main` 背景。-- 启动页的五个文件超过 45 KB 的预算(第 11 节,见「待定」)。-- 入场时就来的卡(导入、推荐盘)出来后,问候还要再留约 1 秒,和卡片的第一行同时在:这样问候不会只闪 240 ms 就被换掉(第 6 节)。\ No newline at end of file+- 圆环的淡线(`--bt-line`)、进行中的淡蓝和水线(`--bt-line-2`)在真的 Mica 上看不看得清,还没验证:原型的截图用的是不透明的 `--bt-main` 背景。+- 启动页的五个文件超过 45 KB 的预算(第 11 节,见「待定」)。\ No newline at end of filediff --git a/docs/plans/2026-10-26-windows-onboarding.md b/docs/plans/2026-10-26-windows-onboarding.mdindex 10cfd8e1..945ae13b 100644--- a/docs/plans/2026-10-26-windows-onboarding.md+++ b/docs/plans/2026-10-26-windows-onboarding.md@@ -46,10 +46,10 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装### 取舍- **每个阶段只有一个引导面,显示什么由状态决定,不存「已完成」标记。** 引擎起来之前,引导面是应用自己画的启动页;引擎起来以后,是 Main Bot 聊天里的设置卡。跳过的步骤哪里都不记,条件还在,它下次就自己回来。第 6 节的上手也不另存标记:Main Bot 的会话里有那行「上手结束」的灰字、或者有用户自己发的消息,就算结束;「跳过设置,直接开始」写下的那行灰字是它唯一的记录(第 8 节)。-- **模型在聊天卡里接,不在应用里另做欢迎向导。** 设置卡是插件的代码,DSH Desktop 和 DSH Web 里的用户也一起受益;应用里再做一套向导,就要维护两套。启动页只负责让人看见它在动、知道下一步是什么:鲸鱼游到哪一站就是到了哪一步,一次只说一句话,好让等待不是空等。+- **模型在聊天卡里接,不在应用里另做欢迎向导。** 设置卡是插件的代码,DSH Desktop 和 DSH Web 里的用户也一起受益;应用里再做一套向导,就要维护两套。启动页只负责让人看见它在动、走到了哪一步:围着鲸鱼的三段弧就是三个阶段,顺利时不说话,只在要用户知道或回答时才说一句。- **模型从「已接上」之后才开始帮忙。** 顺序倒不过来:Key 由引擎写进它自己的 `DSH_HOME`,DeepSeek 登录的回调也由引擎的 Host 处理,所以引擎必须先在某个数据位置上跑起来;`importTeam` 遇到已有 Bot 的位置直接拒绝,复制时还整个换掉 `bot/` 并重启引擎,先填的 Key 也会压过导入来的 Key 和登录。所以位置、导入、接模型三步保持卡片。模型只在两处比卡片好:把用户的一句话变成有名字、有角色的 Bot,以及自由的第一件事;它也更慢、先花钱、措辞每次不一样,所以每一步都留一张不靠模型也能走通的卡,限制写成代码里的机制,不写成提示词(第 6 节)。- **先补悄悄流失的地方。** 下载页、信任提示、一键安装最便宜,影响面最大。签名和国内镜像要等外部审批和账号,所以最先开始办。-- **不改 DSH。** 只用有文档的开关和插槽。DSH 的「预览版说明」没有文档开关,就向 DSH 提需求,期间在启动页上先提醒一句;不伪装 `dshDesktop`。+- **不改 DSH。** 只用有文档的开关和插槽。DSH 的「预览版说明」没有文档开关,就向 DSH 提需求,期间用户进门后先点一次「继续」;不伪装 `dshDesktop`。## 已定的行为@@ -82,37 +82,31 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装### 3. 首次启动:启动页- 窗口先出来。进程启动约 1 秒内,启动窗口就显示应用自己的本地页(`app/src/start/`):和现在一样无边框,40 px 的标题带可以拖动,系统按钮在右上角,Windows 11 上用 Mica。启动页在单独的启动窗口里,引擎的页面在隐藏的主窗口里加载([启动窗口](2026-10-26-start-window.md) 第 1 节,待定)。整个启动期间,卡片和失败页也算,启动窗口都是 720 × 540(工作区矮时 720 × 500);它只在交接时改一次大小:长成主窗口的矩形,主窗口在同一个矩形上露面(同上第 8 节)。-- **鲸鱼就是进度。** 首次启动没有标题、三站的标记和说明:Main Bot 的鲸鱼(88 px)在水线上从第 1 站游到第 3 站,它停在哪里就是到了哪一步;它离开第 1、2 站时各在原处留下一个细线的圈,第 3 站没有。三个真实阶段照旧是「准备数据文件夹」→「启动本机引擎」→「打开团队」,但只给读屏:一个看不见的列表「启动进度」(`aria-current="step"`),朗读区照旧说「{阶段}:进行中」「{阶段}:已完成」。5 秒起右上方显示「已用 N 秒」,一直留到「进去吧」。布局、圈和鲸鱼的动作在 [启动窗口](2026-10-26-start-window.md) 第 2、3 节。-- **文字都是鲸鱼在说,一次一句短话。** 鲸鱼的话在水线下居中,只占一行,不折行;下面的提示行只说接下来要准备什么(接模型、预览版说明、重装接着用),最多约 22 个字,有卡片时隐藏。首次启动的话和提示:+- **圆环就是进度。** 启动页上只有 Main Bot 的鲸鱼(112 px),浮在一小段水线上,围着它是三段弧的圆环,一段一个真实阶段:「准备数据文件夹」→「启动本机引擎」→「打开团队」。进行中的那段染上淡蓝、有一道光沿着它跑,完成的那段顺时针画满,卡住的那段变红;就绪时三段合成一整圈。没有标题、阶段名和说明:阶段名只给读屏,一个看不见的列表「启动进度」(`aria-current="step"`),朗读区照旧说「{阶段}:进行中」「{阶段}:已完成」。点鲸鱼它会喷水。布局、圆环和鲸鱼的动作在 [启动窗口](2026-10-26-start-window.md) 第 2、3 节。+- **顺利时没有字。** 只在要用户知道或回答时,鲸鱼才说一句(在圆环下面居中,只占一行,不折行);下面的提示行只放两样:盘不够时前 10 秒的那一句,和 45 秒起的〔打开日志文件夹〕。首次启动的字:| 时候 | 鲸鱼的话 | 提示行 ||---|---|---|-| 入场,还没有新消息 | 「嗨,我是{名字}」,停 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 没能启动」「团队界面没有加载出来」 | 无 || 有卡片时 | 空着,由卡片自己的第一句说(15/20、600,在已定的文字上面):推荐盘「C 盘有点挤」(盘不够)或「这里不让我放东西」(没有写入权限),「会放在…」那张「我多加了一层文件夹」,被拒绝的「这里放不了」,找不到数据文件夹「数据不在原来的地方了」;导入的几张见第 4 节;失败的卡没有 | 隐藏 |-- 话跟着鲸鱼走(停在哪一站、正在游哪一段、就绪),从不抢在它前面。每句至少能读 300 ms 才被换掉,一般停 0.9 秒(招呼 1.5 秒,「找到了」0.7 秒);中间跳过的话以后不补说。失败和 180 秒的问题马上说。「进去吧」等上一句能读满 400 ms 才上,上屏 300 ms 后开始庆祝。鲸鱼沉下去、换个新文件夹重新开始时,话和提示都空着。失败时不画叉,鲸鱼失败的姿势和那句话就是失败。一般的首次启动,用户读到的是「嗨,我是总管」→「热身中,等我一下」→「开门去了」→「进去吧」:数据文件夹这一步通常在招呼读完之前就做完了。+- 鲸鱼的话换句时淡出、淡入各 .16 s,不排队。失败时不画叉:鲸鱼失败的姿势、红的那段弧和那句话就是失败。鲸鱼沉下去、换个新文件夹重新开始时,三段弧从头开始。就绪时剩下的弧画满、圆环合上,鲸鱼喷一次水,潜下去。- **一般情况下什么都不问**,用默认位置,但页面上写着放在哪、能换:底注右边一行「数据放在 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 的数据。」,〔重新找到它…〕留着。-- **重装不问。** 没有保存的位置、而 `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 数据的规则只在那个文件夹真的存在时才检查。位置行的「换个位置…」走同一条路,没有来时的卡:取消就回到位置行,已经出的「会放在…」「这里放不了」也收回。选了现在的根或数据文件夹就当没选;选在现在的数据文件夹里面不行,总工作区还空着时可以成为新的根。- 首次启动的位置检查和「移到…」用同一套规则检查定出的根:不能是整个磁盘、不能是别人的非空文件夹,外加一次试写。- `locations.json` 只在引擎第一次成功启动(`ready`)、导入问题也答完之后才写。同时写一份 UTF-16LE 的 `locations.ini` 给卸载程序读。应用自己新建的数据文件夹里放一个不含任何机密的 `.deepseek-bot` 标记,这个标记在建文件夹时就写、不等 `ready`:首次启动没走完就退出时,留下的文件夹下次才认得出是自己建的(定根规则里的「以前的根」),不会被当成别人的非空文件夹。「首次启动没走完就退出时什么都不记」的规则不变:记的只是 `locations.json`。每次启动先删掉上次留下的暂存(路径记在 `%APPDATA%` 里,加上数据文件夹里所有的 `.import-*` 和 `.import-check-*`)。- 然后加载引擎的页面:DSH 的「预览版说明」→「继续」。DSH 自己的「开始使用」和「添加一个 API Key」不再自动出现:应用在自己的 profile 补丁(和 `search-patch.mjs` 一样经 `runProfile` 的 `patchFiles` 传入)里设 `ui-settings-models` 的 `credentialOnboarding: false`,这是 DSH 有文档的配置。补丁会替换这一行的整个 `config`,所以每次升级锁定的 DSH 都对照新版本重写这一行。应用的补丁里只有这一行。-- **启动失败**时,启动页当场变成恢复页(不再等 GitHub、不再隐藏窗口、不再弹英文「Error」框):鲸鱼那一行写「DeepSeek Bot 没能启动」,不说俏皮话,下面一句对应的原因(没有写入权限 / 磁盘空间不够 / 程序文件不完整,可能被杀毒软件拦掉了一部分 / 本机引擎启动到一半停下了 / 出了点意外),每种都给〔重试〕〔换个位置…〕〔用新的空白团队开始…〕〔打开日志文件夹〕〔复制详细信息〕(换位置按第 3 节定根的规则,数据和总工作区一起搬,搬的规则同第 8 节:同一个卷上改名,不同的卷上复制完再删旧的;还没有团队时只是换个空文件夹),再加一个「详细信息」折叠区(日志最后 200 行,已脱敏)。+- **启动失败**时,启动页当场变成恢复页(不再等 GitHub、不再隐藏窗口、不再弹英文「Error」框):鲸鱼那一行写「DeepSeek Bot 没能启动」(卡住的那段弧变红),不说俏皮话,下面一句对应的原因(没有写入权限 / 磁盘空间不够 / 程序文件不完整,可能被杀毒软件拦掉了一部分 / 本机引擎启动到一半停下了 / 出了点意外),每种都给〔重试〕〔换个位置…〕〔用新的空白团队开始…〕〔打开日志文件夹〕〔复制详细信息〕(换位置按第 3 节定根的规则,数据和总工作区一起搬,搬的规则同第 8 节:同一个卷上改名,不同的卷上复制完再删旧的;还没有团队时只是换个空文件夹),再加一个「详细信息」折叠区(日志最后 200 行,已脱敏)。- 启动超过 180 秒:鲸鱼问「等太久了,要不要重试?」,卡片上只有〔继续等待〕〔重试〕〔打开日志文件夹〕,引擎同时继续启动。- 后台更新器发现了新版本时,恢复页上显示「DeepSeek Bot {版本} 已经发布,可能修好了这个问题。」〔下载并安装〕,带下载百分比和「下载太慢?手动下载」(打开镜像页)。- 引擎起来了但 DS Bot 界面 20 秒内没报告就绪(ds-bot 在界面挂载完成后调用 `dsBotApp.ready()`):回到启动页,显示「团队界面没有加载出来」〔重新载入〕〔打开日志文件夹〕〔复制详细信息〕。@@ -126,7 +120,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装条件:`~/.dsh`(或 `DSH_HOME`)里有 Bot 团队,而数据文件夹里还没有。-- 导入卡在启动页上出现。卡片一出现,两件事就在后台开始,不等用户回答:引擎在新数据位置预热(已定的「先在新数据位置启动一次再复制」照旧),先查团队有没有被 DSH 占着(下面的判断规则):没占着才把对话复制进暂存文件夹 `.import-<时间>`(在数据文件夹里,和复制时用的是同一个),锁定版 DSH 以暂存为家读一遍它们;占着就只预热引擎,什么都不复制。复制暂存期间锁出现过或刷新过,这份暂存作废,锁放开后重新复制。这份暂存就是复制时要用的那一份:不再另建 `.import-check-<时间>`,对话只复制一次。暂存的路径记在 `%APPDATA%` 里;导入卡开着时关掉启动窗口、更新重开、被杀掉,下次启动都先删掉它。导入卡开着、第一段还没复制完时,主窗口不加载引擎的页面(插件一收到 `state` 就会建出一个空白团队),第 3 站「打开团队」和 20 秒的界面检查也等用户回答以后才开始。点〔先不复制〕:等检查用的引擎退出后删掉暂存,预热好的引擎接着当正式引擎用,主窗口这时才加载它的页面,一秒都不多等。点〔复制过来〕:预热的引擎拿着团队的锁,先停掉它再接着复制 Bot 和附件,复制完起正式引擎,和今天一样。+- 导入卡在启动页上出现。卡片一出现,两件事就在后台开始,不等用户回答:引擎在新数据位置预热(已定的「先在新数据位置启动一次再复制」照旧),先查团队有没有被 DSH 占着(下面的判断规则):没占着才把对话复制进暂存文件夹 `.import-<时间>`(在数据文件夹里,和复制时用的是同一个),锁定版 DSH 以暂存为家读一遍它们;占着就只预热引擎,什么都不复制。复制暂存期间锁出现过或刷新过,这份暂存作废,锁放开后重新复制。这份暂存就是复制时要用的那一份:不再另建 `.import-check-<时间>`,对话只复制一次。暂存的路径记在 `%APPDATA%` 里;导入卡开着时关掉启动窗口、更新重开、被杀掉,下次启动都先删掉它。导入卡开着、第一段还没复制完时,主窗口不加载引擎的页面(插件一收到 `state` 就会建出一个空白团队),第三段弧「打开团队」和 20 秒的界面检查也等用户回答以后才开始。点〔先不复制〕:等检查用的引擎退出后删掉暂存,预热好的引擎接着当正式引擎用,主窗口这时才加载它的页面,一秒都不多等。点〔复制过来〕:预热的引擎拿着团队的锁,先停掉它再接着复制 Bot 和附件,复制完起正式引擎,和今天一样。- 卡片的第一句是鲸鱼的话「找到你以前的团队了」,下面只有一句话和两个按钮:「DeepSeek Harness 里有 6 个 Bot 和 2 个群聊(对话 1.2 GB,工作文件 3.4 GB)。复制过来?」〔复制过来〕〔先不复制〕,下面一行小字「复制后会多占 4.6 GB,DeepSeek Harness 里的原件不动。」,脚注「也可以在 设置 → 通用 → 位置 里复制。」按 Enter 就是复制。「详细」展开才有:- 「在 `C:\Users\<用户名>\.dsh` 里找到 6 个 Bot(Chief、写手、程序员等)和 2 个群聊,143 段对话。」- 「会复制:Bot、群聊、记忆、对话、附件、模型设置和 API Key。不会复制:MCP、技能和 DSH Agent。DeepSeek Harness 里的内容不会改动,复制以后两边各用各的。」@@ -272,7 +266,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装### 8. 以后的启动和回头入口-- 以后每次启动也显示启动页:64 px 的鲸鱼和「正在打开你的团队…」,没有水线和圈,也没有第 3 节鲸鱼的话和提示;10 秒起显示「已用 N 秒」,45 秒「比平时慢,请再等一会儿」〔打开日志文件夹〕,180 秒和首次启动一样([启动窗口](2026-10-26-start-window.md) 第 5 节)。然后打开上次的 Bot(预计 3 到 12 秒,以后的启动还没实测)。+- 以后每次启动也显示启动页,和首次启动同一个样子:112 px 的鲸鱼和三段弧的圆环,顺利时没有字,也没有底注和位置行;45 秒起鲸鱼说「比平时慢,请再等一会儿」,提示行只有〔打开日志文件夹〕,180 秒和首次启动一样;就绪时不庆祝,圆环合上,鲸鱼直接潜下去([启动窗口](2026-10-26-start-window.md) 第 5 节)。然后打开上次的 Bot(预计 3 到 12 秒,以后的启动还没实测)。- 设置卡由状态决定:没有能用的模型(跳过过、删了 key、退出了登录),Main Bot 的设置卡就回来;账号登录过期时显示「DeepSeek 账号的登录失效了。」〔重新登录〕(桌面应用里同样在登录窗口里登录)。- 目标卡、建议卡和第一件事卡(第 6 节)只在新团队接上模型、上手还没结束时出现。上手结束看 Main Bot 的会话:里面有那行「上手结束」的灰字、或者有用户自己发的消息(第一件事也是),就算结束,从会话里读,不另存标记;结束以后它们不再回来,设置卡回来时也不带它们。上手中途关了应用、或者模型没了:重开或重新接上模型后从目标卡重新开始,开场白不再发,已经建好的 Bot 留着,`restrict` 和 guard 重新挂上(它们只在内存里),「模型请求 n/3」从 0 算起。导入来的团队从来不出。- DS Bot 设置 → 模型在所有形态里都有(在 `team-actions.js` 里接上插件 Host 已有的 `providers`、`provider-key` 等接口,今天只有停用的 `app/ui` 接了),显示每个提供商的 key 状态(「已设置 Key」「需要 API Key」「Key 来自 DS Bot 之外」)和「添加提供商」。原来的「Harness 设置」改叫「高级设置(DeepSeek Harness)」。@@ -295,7 +289,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装### 用词-- 一个东西一个名字:DeepSeek Bot(应用)、DS Bot(项目和插件)、DeepSeek Harness(底层;界面里只在讲它本身时出现:导入和复制团队、设置卡里的现成 Key(那一行和「不能用」的提示)、它的沙盒问题、「高级设置(DeepSeek Harness)」)、本机引擎(启动页上对应用启动的 DSH 的叫法)、鲸鱼的话(启动页上鲸鱼下面那一行字,一次一句)、圈(鲸鱼离开一站后留在水线上的细线椭圆)、登录窗口(桌面应用里登录 DeepSeek 账号的子窗口)、目标卡、建议卡、第一件事卡(第 6 节上手的三张卡)、主 Bot(Main Bot)、群聊、总管(中文界面里第一个 Main Bot 的默认名字,待定)、模型、API Key、DeepSeek 账号、提供商、位置(设置项的名字,里面是数据文件夹和总工作区)、数据文件夹、总工作区。+- 一个东西一个名字:DeepSeek 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 官方产品」。@@ -346,6 +340,10 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装| 本文 第 3 节「团队界面没有加载出来。」、「会放在 `D:DeepSeek Bot`」〔继续〕〔重新选〕;第 4 节 更新版本那张卡的脚注「可以在 设置 → 通用 → 位置 里再复制。」;第 8 节「比平时慢,请再等一会儿。」 | 「团队界面没有加载出来」(鲸鱼那一行不加句号);「会放在 `D:DeepSeek 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 转来一段讨论,说启动窗口太吵(「现在这版有点噪了」「是不是可以简约一点」),比较水线分三段的进度条、圆环和只有鲸鱼三份草稿后选了圆环 |+| 同上「文字都是鲸鱼在说,一次一句短话」和首次启动的话和提示那张表:问候「嗨,我是{名字}」,「先找个地方放东西」「找到了」「热身中,等我一下」「第一次会慢一点」「开门去了」「进去吧」;提示行的「待会儿要接一个模型: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 秒内。没有「进去吧」要读,交接不再等字,也没有排队的游动 |实现各批时,同步改写上面几份文档里对应的规则本身(「已定的行为」写现在的行为,不只是在末尾追加),并在它们的「变更」里写一条;新的 DSH 让步记进 [DSH 让步总账](2026-10-13-dsh-concessions.md),「提供商」记进 [UI 标准](../design/ui-standard.md) 第 11 节的术语表。@@ -377,7 +375,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装| M1 去掉死路 | 应用:「下载」文件夹兜底;`credentialOnboarding: false`;`focusWindow` 在失败时也能聚焦;导入的锁判断、失败清理暂存、`room.id`(合 #567)、不覆盖已有 key。插件:在所有形态接上提供商接口(模型页和 key 卡片活过来);key 卡片加「去创建 Key」链接和余额说明;默认模型只从能用的里选;先打字不再删开场白;`bot.blocked` 和 Bot 聊天的修复卡,「重试」不重发;鲸鱼菜单加「模型和 API Key」「登录」;「高级设置」改名,DSH 设置直接落在「模型」页。文档和发版:README 双语下载区和信任说明、安装问题表单、Release 下载表、`SHA256SUMS` 和固定文件名(README 先链到 `releases/latest` 页面)、最后才标为 Latest | 约 4 人日 || M2 Main Bot 聊天里的第一条回复 | 设置卡:登录窗口(应用:接住 `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 秒的兜底)和侧栏磁贴上的鲸鱼(浮上来一次,设置卡驱动它的状态动作,第 5 节);位置检查、推荐盘、一个位置的布局和确认、重装不问;失败页和 180 秒的问题;日志;`dsBotApp.ready()` 和 20 秒界面检查;#559。CI:打包后的首次启动,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户,经 CDP 驱动启动页,逐个状态检查中英文在 720 × 540 和 720 × 500 下没有折行和截断,量交接的时间和中间尺寸,并检查日志里没有 key、token 和用户名 | 约 10 人日(原来 7:圆环即进度的布局、喷水和读屏约 1,交接时窗口长大和兜底计时约 1,九种动作和磁贴上的鲸鱼约 1) || M5 启动页上的导入 | 一句话的导入卡和折叠的详情(预览、大小、可跳过的文件夹);卡片一出现就检查对话和预热引擎,「先不复制」不重启引擎;自动重查占用;新版本对话走「更新后再复制」;第一段的空间检查、进度和停止;工作文件在团队打开后后台复制,设置里的进度、停止、续复制;设置里的再次导入;导入后的检查卡和 Main Bot 提前换段(#384)。CI 用假的 `~/.dsh`(含 junction、新版本对话、PID 被重用的旧锁、群聊、大 `node_modules`) | 约 5 人日 || M6 第一个小时和回头入口 | 系统代理和网络设置;沙盒失败提示(#523);PowerShell 5.1 说明;GitHub 代理提示;关窗提醒(#500);保存诊断信息;「DeepSeek Bot 应用」形态;设置里「位置」一处〔移到…〕一起搬、「高级」里分开换;「用新的空白团队开始」 | 约 4 人日 || M7 签名 | 签名钩子、`publisherName`;README 的信任说明缩成杀毒软件一条;winget 清单 | 约 2–3 人日,加外部审批 |@@ -385,11 +383,11 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装## 验收- 打包后的 Windows CI,用名为「测试 用户」、没有「下载」文件夹、没有 `~/.dsh` 的一次性用户:进程启动后 2 秒内窗口可见(目标 1 秒,CI 留余量);引擎的页面之前不出现任何卡片;能进到引擎的页面。-- 启动页(同一个 CI,中英文各一遍):首次启动没有标题、三站的标记和说明段落;鲸鱼的话按第 3 节的顺序出现,每句至少能读 300 ms 才被换掉,跳过的不补;提示行只在第 2、3 站有字(例外是盘不够时前 10 秒的「C 盘只剩 1.2 GB」和 45 秒的〔打开日志文件夹〕);「已用 N 秒」5 秒起出现;在 720 × 540 和 720 × 500 下没有一行字折行或被省略号截断,页面不能滚动;读屏的「启动进度」列表和朗读区照旧报阶段。-- 交接:首次启动 `handoffShow` 在鲸鱼停到第 3 站后 1.3 秒内(原型实测 1.09 到 1.17 秒);启动窗口在约 300 ms 里至少经过一个中间尺寸,长到主窗口的矩形;主窗口在鲸鱼停到第 3 站后 2 秒内可见,矩形和启动窗口长成的一样(`ready()` 到达时鲸鱼还在游的,这两个时间最多各晚 600 ms);页面不发 `handoffShow` 时,主进程在 `ready()` 后 2.5 秒自己显示主窗口(以后的启动 0.8 秒,重试或重新开始后庆祝的那次也是 2.5 秒);减少动态效果时窗口不长大,`handoffShow` 时主窗口直接出现。+- 启动页(同一个 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 盘上没有留下试写建的文件夹。-- 有 `~/.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` 不变。@@ -436,14 +434,14 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装| 目标卡合并后最多 5 个 Bot(第 6 节),要不要改成每组最多 2 个、最多 4 个? | 不改:每组轮流取,最多 5 个(有一组是 3 个时,两个目标就占满 5 个);改成每组最多 2 个、最多 4 个 | 改成每组最多 2 个、最多 4 个:两个目标不会一下占满,四个目标也是每个先有一个 Bot || 合并后的第一件事(第 6 节:按 Bot 的顺序取每个 Bot 自己的任务,最多 3 个),要不要改成轮流取? | 不改(每组第一个 Bot 都有两个任务,三个总是来自前两个目标,两个来自第一个,三个以上目标时后面的没有);三个以上目标时任务也轮流取 | 改成三个以上目标时轮流取,每个目标先取一件,前三个目标各有一件 || 只有一个目标时摘要怎么写? | 每个目标一个词:「想先写代码:…」「想先查资料:…」(第 6 节现在的写法);用选项的原文:「想先写代码、改程序:…」 | 一个词:几个目标要用「、」连起来,选项原文里的「、」会让两个目标读起来像三个;单个和几个目标写法一样 |-| 首次启动还要那条 1 px 的水线吗? | 保留;去掉,只留鲸鱼和圈 | 保留:圈和三站的位置要有一个水面才站得住 |+| 启动页还要那条水线吗? | 保留:圆环的一条弦,200 px,首尾渐隐;去掉,只留鲸鱼和圆环 | 保留:鲸鱼被裁掉的那条边在这里,喷出的水和涟漪也落在这里 || 启动页超出原型规格里 45 KB 的预算怎么办?(原型实测:五个文件的源码 113 KB,压缩后 79 KB,gzip 约 35 KB;`text.mjs` 带中英两种语言) | 放宽预算;`text.mjs` 按语言拆开,只加载界面语言的那一份;打包时压缩 | 先按语言拆 `text.mjs`、打包时压缩,在 M4 实测启动页的第一帧;第一帧不晚就放宽预算:页面是本地文件,不走网络(同 [启动窗口](2026-10-26-start-window.md) 的「待定」) |## 不做什么- 不在应用里另做一套配置模型的欢迎向导:模型只在 Main Bot 的设置卡和 DS Bot 设置 → 模型里配。目标卡、建议卡和第一件事卡也是插件在 Main Bot 聊天里画的卡,不是应用的向导。- 上手期间不让模型选下一步,也不让它自己一轮轮地调用工具:步骤表在代码里,由卡片的回答推进,Main Bot 的工具受限到第一件事发出(第 6 节)。只选了目标卡的选项时不调用模型。-- 鲸鱼的话从不是一段话:一次一句,一行放得下;启动页上不放说明段落,也不轮播提示。+- 鲸鱼的话从不是一段话:只在要用户知道或回答时说一句,一行放得下;顺利时启动页上没有字,不放说明段落,也不轮播提示。- 不在设置卡显示期间之外读剪贴板;剪贴板和 DeepSeek Harness 里的 Key 都不自动保存:一定是用户点了按钮,再按「粘贴 key」的规则检查和保存。- 设置卡的现成 Key 只认 Key,不单独搬 DeepSeek Harness 里的账号登录(grant 记录归 DSH 的账号模块,应用不去写):没导入团队、或者答了〔先不复制〕、在 DeepSeek Harness 里用账号登录过的人,在登录窗口里再登录一次。导入团队时 `.credentials.yaml` 整个复制(目标里已有用户自己的 key 或登录时除外),账号登录跟着过来,不用再登录。- 不伪装 `dshDesktop`,不用 CSS 或 DOM 去藏、改 DSH 的界面;DSH 的「预览版说明」等它的开关。也不预先写入它的「已读」版本号(`ui-settings-general` 的 `welcomeNoticeVersion`):那等于替用户点了「继续」,版本号也没有公开导出,写在补丁层里还会让用户以后点「继续」时保存失败。@@ -455,7 +453,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装## 已知限制-- DSH 加开关之前,「预览版说明」仍然是引擎页面的第一屏,用户要多点一次「继续」;每个新的数据文件夹(以后的导入、重新开始)都会再出现一次。启动页只能提前提醒。+- DSH 加开关之前,「预览版说明」仍然是引擎页面的第一屏,用户要多点一次「继续」;每个新的数据文件夹(以后的导入、重新开始)都会再出现一次。启动页上不提前说(第 3 节)。- 设置卡调用的是 `settings.models.sign-in` 条目注入的操作。它们有类型声明,但 DSH 没有写成给插件用的接口,rc 版本之间可能变化。缺了哪个就退回到今天的 `DeepSeekSignIn`;每次升级锁定的 DSH 都要重测(另见「需要 DSH 提供的」第 4 条)。- `credentialOnboarding` 那一行的 id 如果在 DSH 里改了名,补丁只会留下一条警告、悄悄失效;靠验收里对 `__DSH_MODELS_ONBOARDING__` 的检查发现。- `GET /user/balance` 不在聊天 API 里,是否计费没有文档;它证明的是 key 和余额,不是模型能不能用。除了 401 以外的失败都不拦人,第一轮的修复卡兜底。@@ -463,7 +461,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装- 开场白是固定文字,不再花钱,但也说不出任何只有模型才知道的东西。- 上手里模型的那一步比卡片慢:真实的网络往返,最坏 12 秒才出兜底卡(8 秒内来了第一个字、之后停住的);它先花钱(只在用户写了字或要换一组时),才见效果;措辞每次不一样,CI 只能测结构。- 合并后的第一件事偏向前两个目标:三个以上目标时,后面的目标没有第一件事;勾掉前面的 Bot 时,用三个固定任务补满,不用后面 Bot 的任务(怎么分见「待定」)。-- 首次启动主窗口在就绪后约 1.6 秒才露面(原来约 620 ms),以后的启动约 0.6 秒(原来 120 ms):多出来的主要是等纸面空下来再长大的约 460 ms,首次启动还有「进去吧」先停的 300 ms。+- 首次启动主窗口在就绪后约 1.2 秒才露面(原来约 620 ms),以后的启动约 0.7 秒(原来 120 ms):多出来的主要是等页面空下来再长大的约 460 ms。- Bot 聊天里余额不足时,DSH 自己的余额提示(不分 Session)会和修复卡同时出现。- 中文默认名字看的是第一次请求时的界面语言;DSH 存的语言偏好还没加载完时,它可能还是浏览器的语言,所以浏览器是英文、DSH 设成中文时,新团队仍可能叫 Chief。桌面应用里全新的数据位置以系统界面语言为准。- 退回系统浏览器登录时,Windows 的前台规则可能不让窗口在登录后回到前台,这时只能靠任务栏闪烁和卡片自己的「已登录」状态。@@ -495,3 +493,4 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装- 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 加的张望,估计里的布局一项改叫圆环即进度。diff --git a/docs/plans/2026-10-29-start-copy.md b/docs/plans/2026-10-29-start-copy.mdindex 49babbd5..13139512 100644--- a/docs/plans/2026-10-29-start-copy.md+++ b/docs/plans/2026-10-29-start-copy.md@@ -27,31 +27,31 @@| 层 | 在哪里 | 谁在说 | 规则 ||---|---|---|---|-| `voice.*` | 鲸鱼下面那一行 | 鲸鱼,第一人称、口语 | 一行,不折行,最多 16 字;不加句号,可以问号;可以用口语的动词(「搬过来」) |+| `voice.*` | 鲸鱼下面那一行,只在用户要知道或回答时有字:45 秒、180 秒、失败、搬数据 | 鲸鱼,第一人称、口语 | 一行,不折行,最多 16 字;不加句号,可以问号;可以用口语的动词(「搬过来」) || `say.*` | 卡片的第一行(15/20、600) | 鲸鱼 | 最多 12 字;不加句号 |-| `hint.*` | 提示行 | 应用,中性 | 只写接下来要知道的一件事,最多 22 字;不加句号 |+| `hint.*` | 提示行,只有盘不够时前 10 秒的那一句 | 应用,中性 | 只写一件用户现在要知道的事,最多 22 字;不加句号 || `card.*` | 卡片正文 | 应用 | 整句,以 。? 结尾;说出了什么事,怎么办交给按钮;路径放 `code`;`card.<卡>.<部分>`,几张卡共用的放 `card.update.*` || `reason.*` | 卡片正文里复用的原因 | 应用 | 整句的以 。 结尾(`reason.place.*` 位置不能用的七个原因、`reason.start.*` 启动失败的五个);嵌进句子的片段不带标点(`reason.copy.*` 复制失败的三个) || `btn.*` | 按钮 | 用户的动作 | 最多 10 字,动词或动作短语开头;打开系统选择框或离开这张卡的以 … 结尾;不加句号;链接样式的小按钮可以是名词短语(「其他位置…」「详细」) || `note.*` | 卡片脚注 | 应用 | 一句,以 。 结尾,说以后在哪里改 || `foot.*` | 底注行 | 应用 | 不加句号(「社区开源项目,不是 DeepSeek 官方产品」、位置行) |-| `status.*` | 只给读屏和计数 | 应用 | 不加句号:隐藏列表「启动进度」、三个阶段名、四个状态词、朗读句、「已用 N 秒」 |+| `status.*` | 只给读屏 | 应用 | 不加句号:隐藏列表「启动进度」、三个阶段名、四个状态词、朗读句 || `dialog.*` | 系统对话框的正文和标题 | 应用 | 正文整句以 。? 结尾,可以两段(`\n\n`);选择框标题不加句号;按钮用 `btn.*` |- 同一句话只有一个键;两层里都要的同一句,各自一键(提示行的「C 盘只剩 1.2 GB」和卡片里的「C 盘只剩 1.2 GB。」是两层两键)。- 同一个意思只有一种写法:「先不复制」(不复制团队,继续)和「先不带团队开始」(放弃复制、带空白团队启动)是两个意思,各一种写法;对话框里原来的「不复制」「不带团队开始」改成这两句。- 一个东西一个名字(上手流程「用词」):对话(不是聊天记录)、群聊(不是群)、API Key(不是密钥)、附件、总工作区、数据文件夹、位置(设置项,英文 Location,单数)。鲸鱼的话可以口语(「正在搬过来」),按钮和正文用正式名(「复制过来」「停止复制」)。-- 不写过程词:马上、稍后、下个版本(UI 标准第 11 节;测试扫全表)。「待会儿要接一个模型」说的是用户的下一步,不是引擎的承诺,留着。+- 不写过程词:马上、稍后、下个版本(UI 标准第 11 节;测试扫全表)。### 3. 键的对照旧键 → 新键,中文照旧的不写,改了的写出来。-鲸鱼的话 `voice.*`:`voice.hello / helloName / helloBack / data / found / engine / slow10 / slow45 / team / ready / watchdog` 不动;`title.later` → `voice.opening`,`title.moving` → `voice.moving`,`title.failed` → `voice.failed`,`title.viewFailed` → `voice.viewFailed`「团队界面没有加载出来」(去句号)。+鲸鱼的话 `voice.*`:`voice.slow45 / watchdog` 不动;`title.moving` → `voice.moving`,`title.failed` → `voice.failed`,`title.viewFailed` → `voice.viewFailed`「团队界面没有加载出来」(去句号),`slow.45.later` → `voice.slowLater`「比平时慢,请再等一会儿」(去句号;以后的启动和搬数据时 45 秒起由鲸鱼说)。启动窗口顺利时不说话([启动窗口](2026-10-26-start-window.md) 第 3 节),所以表里没有问候、各阶段的话和「进去吧」(`voice.hello / helloName / helloBack / data / found / engine / slow10 / team / ready`),`title.later`「正在打开你的团队…」也没有键。卡片第一行 `say.*`:`say.space / permission / rejected / picked / missing / import / importSpace / inUse / newer` 不动;`copying.title` → `say.copying`「正在搬过来」。-提示行 `hint.*`:`hint.model / preview / reinstall / space` 不动;`slow.45.later` → `hint.slowLater`「比平时慢,请再等一会儿」(去句号)。+提示行 `hint.*`:只有 `hint.space`,不动。接模型、预览版说明和重装的三句(`hint.model / preview / reinstall`)没有键:启动页不提前说进门以后的事。卡片正文 `card.*`:@@ -112,7 +112,7 @@底注 `foot.*`:`footer` → `foot.community`;`place.drive / driveOnly / path / pathOnly` → `foot.place.drive / driveOnly / path / pathOnly`。-状态 `status.*`:`track.label` → `status.track`;`phase.*` → `status.phase.*`;`state.*` → `status.state.*`;`sr.*` → `status.sr.*`;`elapsed` → `status.elapsed`。+状态 `status.*`:`track.label` → `status.track`;`phase.*` → `status.phase.*`;`state.*` → `status.state.*`;`sr.*` → `status.sr.*`。`elapsed`(「已用 N 秒」)没有新键:启动页不显示已用秒数。对话框 `dialog.*`(原来在 `first-run.mjs` 和 `updates.mjs`):@@ -139,7 +139,7 @@- 逐键对照中文的意思,不另写一套:位置行写全「Data on drive {drive}, {free} free」(原来只有「Drive C, 412 GB free」)。- 句首大写;`voice / say / hint / btn / foot / status` 不加句号;`card / reason(整句)/ note / dialog` 以句号或问号结尾;… 和中文同步。- 名词:chats(不用 conversations)、group chats、attachments、API Key、Settings → General → Location(单数)、team workspace、data folder、local engine。-- 单复数用 `{n|one|many}`:`hint.reinstall`「Your {bots|Bot|Bots} and {groups|group chat|group chats} are still here」、`card.import.lead`、`card.import.found`、`dialog.import.found`、`dialog.import.newer`。+- 单复数用 `{n|one|many}`:`card.import.lead`「DeepSeek Harness has {bots|Bot|Bots} and {groups|group chat|group chats} …」、`card.import.found`、`dialog.import.found`、`dialog.import.newer`。- 「先不复制」是 Don't copy yet,「先不带团队开始」是 Start without the team,「先不重启」Not now(重启框)、「先不下载」Not now(下载框)。### 5. 测试@@ -154,6 +154,7 @@- `start.html` 里 `data-act="pick"` 的按钮,键的中文以 … 结尾。- 主进程三个文件里 `tx('…')` 用到的键都在表里;`first-run.mjs` 和 `updates.mjs` 里没有自己的字符串表。- `t()` 的单复数:`{bots|Bot|Bots}` 在 1 和 6 上各填对。+ - `voice` 层只有六个键(`voice.failed / moving / slow45 / slowLater / viewFailed / watchdog`),`hint` 层只有 `hint.space`,没有 `status.elapsed`。## 改动的已定设计@@ -168,6 +169,9 @@| `first-run.mjs`:「DeepSeek Harness 里有一个 Bot 团队:6 个 Bot、2 个群。」「会复制 Bot、群、记忆、对话、文件、密钥和模型设置。」 | 「DeepSeek Harness 里有 6 个 Bot 和 2 个群聊。要复制到 DeepSeek 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.*`「只给读屏和计数」 | 只给读屏 | 启动页不显示已用秒数 |## 不做什么@@ -186,3 +190,4 @@## 变更- 2026-10-29 首稿:十层、一张表、键的对照、测试;对应 `text.mjs` 重排、`first-run.mjs` 和 `updates.mjs` 的表并入、`start.html` 和 `start.js` 改键。依据:2026-10-29 对三张表的审读(30 个对话框键和 11 个更新键都在用,没有死键;页面表和两份设计稿逐句对照只有 `failed.reason.*` 的句号一处不同;风格问题 30 条,全部复核过)。+- 2026-10-30:启动窗口的样子换成圆环([启动窗口](2026-10-26-start-window.md) 同一天的变更):鲸鱼的话只剩用户要知道或回答时的几句,表里去掉 14 个键(`voice.hello / helloName / helloBack / data / found / engine / slow10 / team / ready / opening`、`hint.model / preview / reinstall`、`status.elapsed`),`hint.slowLater` 改名 `voice.slowLater`(同一句,以后的启动和搬数据时 45 秒起由鲸鱼说);第 2 节 `voice`、`hint`、`status` 三层的说明、第 3 节的对照和第 4 节单复数的例子跟着改,第 5 节加一条测试。依据:维护者 2026-10-30 转来的讨论(「现在这版有点噪了」)和维护者选定的圆环原型。diff --git a/docs/plans/README.md b/docs/plans/README.mdindex a5875373..66a10f7d 100644--- a/docs/plans/README.md+++ b/docs/plans/README.md@@ -52,7 +52,7 @@| [Side chat(侧边对话)](2026-10-21-btw.md) | 人顺带问一句:侧栏里的常驻对话,以与会话同构的请求回答、不执行工具、不打断、不进模型可见历史;可追问、可开多条;Bot 之间的 `ask_bot` 另行提案 || [消息布局和宽度](2026-10-22-message-layout.md) | 气泡 / 平铺两种布局;平铺时 Bot 的话带头像、名字、时间;气泡宽度和平铺正文宽度各用一个滑块,按正文列的百分比调 || [Windows 上手流程](2026-10-26-windows-onboarding.md) | 从下载到第一条回复:下载区和信任说明、安装、窗口先出来的启动页、一个位置和推荐盘、启动页上的一键导入、Main Bot 聊天里的模型设置卡(登录或检查过的 key、自动选模型)、修复卡、第一个小时的 Windows 问题、卸载时问一次 |-| [启动窗口](2026-10-26-start-window.md) | 启动页的样子和动作:单独的小窗口(待定),Main Bot 的鲸鱼沿着水线一站一站游过三个真实阶段,等待越久越慢,卡片和失败页在同一张纸面上变形,就绪时潜下去、团队窗口盖上来 |+| [启动窗口](2026-10-26-start-window.md) | 启动页的样子和动作:单独的小窗口(待定),Main Bot 的鲸鱼浮在水线上,围着它三段弧的圆环就是三个真实阶段,顺利时没有字,点它会喷水;等待越久越慢,卡片和失败页在同一张纸面上变形,就绪时圆环合上、鲸鱼潜下去、团队窗口盖上来 || [启动页文案](2026-10-29-start-copy.md) | 启动页和壳里系统对话框的字:按页面位置分层,每层一条写法规则;`text.mjs` 一张表、旧键到新键的对照、扫全表的测试 || [手机 App](2026-10-24-mobile-app.md) | iOS 和 Android 远程操控电脑上的 Bot 团队:手机不跑 Agent;扫码配对、端到端加密、电脑只往外连;完整功能,高权限操作要解锁手机 || [Office 文档](2026-10-27-office-documents.md) | Bot 离线处理 .docx/.pptx/.xlsx:应用带的 payload、`office.js` 命令行、office 路由换成带 `office-tools` 的版本 |