Skip to content

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

Fix the CI checks that the merge with dev turned up

AdamPlatin123d238fef56e60
diff --git a/app/scripts/check-update.mjs b/app/scripts/check-update.mjs
index 3b6d83c8..61e52af3 100644
--- a/app/scripts/check-update.mjs
+++ b/app/scripts/check-update.mjs
@@ -59,10 +59,11 @@ const feed = `http://127.0.0.1:${String(server.address().port)}/`
// The tray's Quit ends the app. The check cannot click the tray icon, so it asks the browser
// target of the debugging port to close. Tray menu dispatch is covered by the main-process tests.
async function quitApp(port, waitForReady = false) {
- // Until the Host is ready the window shows a note of its own.
+ // Until the Host is ready only the start window is there (a file: page); the team window
+ // loads the Host's address once the engine is up.
const find = async () => {
const targets = await (await fetch(`http://127.0.0.1:${String(port)}/json/list`)).json()
- const pages = targets.filter(target => target.type === 'page' && (/^http:\/\/127\.0\.0\.1:\d+\//u.test(target.url) || target.url.startsWith('data:text/html')))
+ const pages = targets.filter(target => target.type === 'page' && (/^http:\/\/127\.0\.0\.1:\d+\//u.test(target.url) || /\/src\/start\/start\.html\?start=/u.test(target.url)))
return pages.find(target => target.url.startsWith('http:')) ?? (waitForReady ? undefined : pages[0])
}
let page = await find()
diff --git a/app/test/helpers/app-harness.mjs b/app/test/helpers/app-harness.mjs
index c1207915..38068884 100644
--- a/app/test/helpers/app-harness.mjs
+++ b/app/test/helpers/app-harness.mjs
@@ -34,6 +34,10 @@ export const startApp = async ({ packaged = true } = {}) => {
// The app is a packaged one, so that it has an updater. The flag comes after the start,
// because a packaged app starts on the canonical path of its own.
state.packaged = packaged
+ // A Linux build updates itself only from inside an AppImage; outside one the app asks about
+ // the newest GitHub release, which a test must never fetch. The faked electron-updater
+ // answers for the AppImage, as it does on Windows.
+ if (process.platform === 'linux') process.env.APPIMAGE ??= '/tmp/deepseek-bot.AppImage'
return { home, workspace }
}
diff --git a/app/test/logs.test.mjs b/app/test/logs.test.mjs
index 363313ba..3134aaae 100644
--- a/app/test/logs.test.mjs
+++ b/app/test/logs.test.mjs
@@ -33,9 +33,9 @@ test('the home folder becomes %USERPROFILE% in every spelling', () => {
assert.equal(windows('cwd C:\\Users\\测试 用户'), 'cwd %USERPROFILE%')
// Another user whose name starts the same way is not this one.
assert.equal(windows('C:\\Users\\测试 用户2\\x'), 'C:\\Users\\测试 用户2\\x')
- const posix = redactor({ home: '/home/calx', platform: 'linux' })
- assert.equal(posix('/home/calx/.ds-bot and file:///home/calx'), '~/.ds-bot and file://~')
- assert.equal(posix('/home/calxy/x /HOME/calx'), '/home/calxy/x /HOME/calx')
+ const posix = redactor({ home: '/home/Alice', platform: 'linux' })
+ assert.equal(posix('/home/Alice/.ds-bot and file:///home/Alice'), '~/.ds-bot and file://~')
+ assert.equal(posix('/home/Alicey/x /HOME/Alice'), '/home/Alicey/x /HOME/Alice')
assert.equal(redactor({ home: '/', platform: 'linux' })('/usr/bin'), '/usr/bin')
})
diff --git a/app/test/place.test.mjs b/app/test/place.test.mjs
index dbe310fc..5112d9d1 100644
--- a/app/test/place.test.mjs
+++ b/app/test/place.test.mjs
@@ -35,12 +35,12 @@ test('the drive letter is read from a Windows path only', () => {
assert.equal(driveOf('C:\\Users\\me\\.ds-bot'), 'C')
assert.equal(driveOf('d:/DeepSeek Bot'), 'D')
} else {
- assert.equal(driveOf('/home/me/.ds-bot'), undefined)
+ assert.equal(driveOf('/home/user/.ds-bot'), undefined)
}
})
test('a path under the home folder is written with ~', () => {
- const home = resolve('/home/me')
+ const home = resolve('/home/user')
assert.equal(shortPath(join(home, '.ds-bot'), home), `~${sep}.ds-bot`)
assert.equal(shortPath(home, home), '~')
assert.equal(shortPath(resolve('/srv/data'), home), resolve('/srv/data'))
@@ -51,7 +51,7 @@ test('the place line names the drive and its free space, or the folder', () => {
assert.deepEqual(placeOf('C:\\Users\\me\\.ds-bot', { free: 412 * 2 ** 30 }), { drive: 'C', free: '412 GB' })
assert.deepEqual(placeOf('C:\\Users\\me\\.ds-bot', { free: undefined }), { drive: 'C' })
} else {
- assert.deepEqual(placeOf('/home/me/.ds-bot', { home: '/home/me', free: 1.5 * 2 ** 30 }), { path: `~${sep}.ds-bot`, free: '1.5 GB' })
+ assert.deepEqual(placeOf('/home/user/.ds-bot', { home: '/home/user', free: 1.5 * 2 ** 30 }), { path: `~${sep}.ds-bot`, free: '1.5 GB' })
}
})
diff --git a/app/test/start-window.test.mjs b/app/test/start-window.test.mjs
index 788657cc..08150943 100644
--- a/app/test/start-window.test.mjs
+++ b/app/test/start-window.test.mjs
@@ -149,9 +149,11 @@ test('the main process takes only its own acts, each in its own views', () => {
})
test('acts come only from the start page that was loaded', () => {
- const page = 'C:\\Program Files\\DeepSeek Bot\\resources\\app.asar\\src\\start\\start.html'
+ // A Windows path is a file URL only on Windows.
+ const win32 = process.platform === 'win32'
+ const page = win32 ? 'C:\\Program Files\\DeepSeek Bot\\resources\\app.asar\\src\\start\\start.html' : '/opt/DeepSeek Bot/resources/app.asar/src/start/start.html'
const loaded = startUrl(page, 'first')
- assert.equal(loaded, 'file:///C:/Program%20Files/DeepSeek%20Bot/resources/app.asar/src/start/start.html?start=first')
+ assert.equal(loaded, win32 ? 'file:///C:/Program%20Files/DeepSeek%20Bot/resources/app.asar/src/start/start.html?start=first' : 'file:///opt/DeepSeek%20Bot/resources/app.asar/src/start/start.html?start=first')
assert.equal(isStartPage(loaded, loaded), true)
assert.equal(isStartPage(`${loaded}#x`, loaded), false)
assert.equal(isStartPage(loaded.replace('first', 'later'), loaded), false)
diff --git a/docs/plans/2026-10-26-windows-onboarding.md b/docs/plans/2026-10-26-windows-onboarding.md
index c718bee5..10cfd8e1 100644
--- a/docs/plans/2026-10-26-windows-onboarding.md
+++ b/docs/plans/2026-10-26-windows-onboarding.md
@@ -186,18 +186,18 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 两处都有时仍然只有一行:应用在主进程里比对整段值,相同就只算 DeepSeek Harness 那把;不同就显示剪贴板那把,下面一行小字「改用 DeepSeek Harness 里的 Key(sk-1a2b3…)」。
- 前八位和 DSH 掩码保留的位数一样。点按钮时应用才把值交给页面:`dsBotApp.foundKeys()` 只回来源和前八位,`dsBotApp.takeKey(来源)` 再读一次,读到的仍是一个 Key、前八位也和这一行上的一样时才回整个值,否则不回值、这一行按新读到的结果换掉或消失;页面走和粘贴 Key 完全一样的检查和保存(Host 的 `provider-key`)。401 或余额为零按上面处理,提示写明来源:「DeepSeek Harness 里的 Key 不能用(401)。」,这一行消失。检查没通过(401)的 Key,插件在页面内存里记下它的来源和前八位(应用不知道检查的结果,也不另加接口):这个页面里之后再读到同一来源、同样前八位的 Key(窗口回到前台、切到别的 Bot 再回来、卡片重新出现),都不出这一行;两处都有时改出另一处那把。重新加载页面后才会再出现。
- 环境变量里的 `DEEPSEEK_API_KEY` 不用按钮:引擎继承应用的环境(`process.env`),数据位置的 `.credentials.yaml` 里没有这把 Key 时,DSH 的凭据层退回到它,`describe` 报已配置、`source` 是 `env`(`writable` 仍是 `true`),设置卡不出现;只有它检查没通过时才有上面「来自环境变量」那张卡。在这里保存的 Key 写进凭据文件,优先于环境变量,所以〔换一种方式〕之后粘贴或登录都能接上,不用改环境变量。
-- **在聊天里粘了 Key 也认**(所有形态):真实用户会把 Key 直接发到 Bot 的聊天框里,发出去就进了对话记录、还会发给模型。没有能用的模型时 Bot 聊天的输入框本来就锁着(见下面「输入框不可用」那条),粘不进去;所以这张卡管的是接上模型以后的 Bot 聊天和群聊(比如修复卡报 AUTH 时用户把新 Key 发进来;新团队的 Main Bot 要等上手结束,上手期间粘进目标卡输入框的 Key 见第 6 节),以及模型列表还没出来的那一刻。插件观察每个 Bot 和群聊会话的草稿(DSH 有文档的 `ctx.conversation.input`,每个会话的 `state`),整段去掉首尾空白后正好是一个 `sk-` 开头的 Key(`sk-` 后面 20 个以上的字母、数字、`_` 或 `-`,其中至少一个数字,和 DSH 掩码认 `sk-` Key 的规则一致;别家的 `sk-` Key 也算;DSH 掩码认的其他格式,如 `ghp_`、`AKIA`,不是模型服务的 Key,不拦;带 `NAME=` 或引号的也不拦,和句子里夹着 Key 一样),就给这个会话挂一个 `ComposerBlock`(DSH 有文档的 `ctx.conversation.blocks`:输入框变灰,不能编辑也不能发,草稿留在里面),并在输入框上方的卡片槽(`conversation.input.dock`,和今天 Bot 要秘密的卡同一处)显示一张卡,按状态选文案:
+- **在聊天里粘了 Key 也认**(所有形态):真实用户会把 Key 直接发到 Bot 的聊天框里,发出去就进了对话记录、还会发给模型。没有能用的模型时 Bot 聊天的输入框本来就锁着(见下面「输入框不可用」那条),粘不进去;所以这张卡管的是接上模型以后的 Bot 聊天和群聊(比如修复卡报 AUTH 时用户把新 Key 发进来;新团队的 Main Bot 要等上手结束,上手期间粘进目标卡输入框的 Key 见第 6 节),以及模型列表还没出来的那一刻。插件观察每个 Bot 和群聊会话的输入稿(DSH 有文档的 `ctx.conversation.input`,每个会话的 `state`),整段去掉首尾空白后正好是一个 `sk-` 开头的 Key(`sk-` 后面 20 个以上的字母、数字、`_` 或 `-`,其中至少一个数字,和 DSH 掩码认 `sk-` Key 的规则一致;别家的 `sk-` Key 也算;DSH 掩码认的其他格式,如 `ghp_`、`AKIA`,不是模型服务的 Key,不拦;带 `NAME=` 或引号的也不拦,和句子里夹着 Key 一样),就给这个会话挂一个 `ComposerBlock`(DSH 有文档的 `ctx.conversation.blocks`:输入框变灰,不能编辑也不能发,输入稿留在里面),并在输入框上方的卡片槽(`conversation.input.dock`,和今天 Bot 要秘密的卡同一处)显示一张卡,按状态选文案:
- DeepSeek API 还没有 Key:「这看起来是一个 API Key,还没有发出去。要保存成 DeepSeek API 的 Key 吗?」〔检查并保存〕〔当普通消息发送〕〔清掉〕,小字「改一下 · 保存到其他提供商…」。
- DeepSeek API 已经有 Key:「这看起来是一个 API Key,还没有发出去。要把 DeepSeek API 的 Key 换成它吗?」〔检查并换上〕〔当普通消息发送〕〔清掉〕,小字同上。
- - 不是 DeepSeek 的格式(DeepSeek 的 Key 是 `sk-` 加 32 位十六进制,以实测为准):「这看起来是一个 API Key,还没有发出去,但不像 DeepSeek 的 Key。要保存到哪个提供商?」〔保存到提供商…〕〔当普通消息发送〕〔清掉〕,小字「改一下」。〔保存到提供商…〕打开 DS Bot 设置 → 模型的添加表单,Key 已经填好(只在页面里传);保存后 `setDraft('')`、撤掉 block;没保存就关掉表单时,草稿和 block 留着。
- - 这个 Bot 正有一张要填值的 `request_secret` 卡在等时:「这看起来是{名字}正在要的 Key,还没有发出去。」〔填进那张卡〕〔当普通消息发送〕〔清掉〕,小字「改一下 · 保存成 DeepSeek API 的 Key」。〔填进那张卡〕把草稿移进那张卡的输入框(卡在对话里时滚到它),`setDraft('')`、撤掉 block。
- - 〔检查并保存〕/〔检查并换上〕:从草稿取值,走和设置卡完全一样的检查和保存;通过后 `setDraft('')` 清掉草稿、撤掉 block。没通过时草稿和 block 都留着,卡上换成检查的结果,〔当普通消息发送〕〔清掉〕和小字「改一下」照旧:401 写「DeepSeek 不接受这个 Key(401)。请确认整段复制了,或者新建一个。」,主按钮换成〔清掉〕,不再有〔检查并保存〕;连不上、429 或 5xx 写设置卡「粘贴 key」里的同一句(「Key 还没保存」),主按钮〔再试一次〕,旁边〔仍然保存〕(已经有 Key 时是〔仍然换上〕),保存后同样 `setDraft('')`、撤掉 block。余额为零时 Key 保存,同样清掉草稿、撤掉 block,卡片留着,写「Key 已保存,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔知道了〕,点〔知道了〕才收起;这里没有两种方式,不带〔再查一次余额〕〔换一种方式〕。设置卡由状态决定(第 8 节),不在这里写它。
- - 〔当普通消息发送〕:先把这段草稿记成「放过」,撤掉 block,再调这个会话输入框自己的发送(`ctx.conversation.input.for(会话).submit()`,和点发送按钮同一条路):草稿由 DSH 清掉,附件一起发出,发送失败时由 DSH 还原草稿。DSH 发送时把草稿清空不算改:草稿空着、或者又变回这一段时「放过」仍在,所以还原回来的草稿不再挂 block;草稿变成别的非空内容时「放过」作废,按新的草稿重新判断。这条路不带 DSH 的插话设置,回合进行中时一律排进队列。
+ - 不是 DeepSeek 的格式(DeepSeek 的 Key 是 `sk-` 加 32 位十六进制,以实测为准):「这看起来是一个 API Key,还没有发出去,但不像 DeepSeek 的 Key。要保存到哪个提供商?」〔保存到提供商…〕〔当普通消息发送〕〔清掉〕,小字「改一下」。〔保存到提供商…〕打开 DS Bot 设置 → 模型的添加表单,Key 已经填好(只在页面里传);保存后 `setDraft('')`、撤掉 block;没保存就关掉表单时,输入稿和 block 留着。
+ - 这个 Bot 正有一张要填值的 `request_secret` 卡在等时:「这看起来是{名字}正在要的 Key,还没有发出去。」〔填进那张卡〕〔当普通消息发送〕〔清掉〕,小字「改一下 · 保存成 DeepSeek API 的 Key」。〔填进那张卡〕把输入稿移进那张卡的输入框(卡在对话里时滚到它),`setDraft('')`、撤掉 block。
+ - 〔检查并保存〕/〔检查并换上〕:从输入稿取值,走和设置卡完全一样的检查和保存;通过后 `setDraft('')` 清掉输入稿、撤掉 block。没通过时输入稿和 block 都留着,卡上换成检查的结果,〔当普通消息发送〕〔清掉〕和小字「改一下」照旧:401 写「DeepSeek 不接受这个 Key(401)。请确认整段复制了,或者新建一个。」,主按钮换成〔清掉〕,不再有〔检查并保存〕;连不上、429 或 5xx 写设置卡「粘贴 key」里的同一句(「Key 还没保存」),主按钮〔再试一次〕,旁边〔仍然保存〕(已经有 Key 时是〔仍然换上〕),保存后同样 `setDraft('')`、撤掉 block。余额为零时 Key 保存,同样清掉输入稿、撤掉 block,卡片留着,写「Key 已保存,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔知道了〕,点〔知道了〕才收起;这里没有两种方式,不带〔再查一次余额〕〔换一种方式〕。设置卡由状态决定(第 8 节),不在这里写它。
+ - 〔当普通消息发送〕:先把这段输入稿记成「放过」,撤掉 block,再调这个会话输入框自己的发送(`ctx.conversation.input.for(会话).submit()`,和点发送按钮同一条路):输入稿由 DSH 清掉,附件一起发出,发送失败时由 DSH 还原输入稿。DSH 发送时把输入稿清空不算改:输入稿空着、或者又变回这一段时「放过」仍在,所以还原回来的输入稿不再挂 block;输入稿变成别的非空内容时「放过」作废,按新的输入稿重新判断。这条路不带 DSH 的插话设置,回合进行中时一律排进队列。
- 〔清掉〕:`setDraft('')`,撤掉 block;Key 不保存,也不发出。401 之后也靠它离开。
- - 「改一下」:撤掉 block,草稿原样留着,焦点回到输入框(`focus()`);这段草稿记成「放过」,不再拦;这样记下的「放过」草稿一改就作废(和〔当普通消息发送〕记下的不同),按新的草稿重新判断。
+ - 「改一下」:撤掉 block,输入稿原样留着,焦点回到输入框(`focus()`);这段输入稿记成「放过」,不再拦;这样记下的「放过」输入稿一改就作废(和〔当普通消息发送〕记下的不同),按新的输入稿重新判断。
- 一个会话只有一个 block(`ctx.conversation.blocks.set` 是替换,传 `undefined` 清掉的是整个 block),下面「没有能用的模型」的锁和第 6 节上手的锁也用它。所以插件只在一处算这个会话的 block:模型锁 > 上手锁 > Key 的 block,三样都没有才清空。上面说的「撤掉 block」,是去掉 Key 这一层再按这条重新算。
- - 挂着 block 时输入框是只读的(DSH 的 block 让编辑器不能编辑,占位里的原因也只在草稿为空时显示),用户自己改不了草稿,出口全在卡片上;草稿被别处改成别的内容时(比如别的插件调了 `setDraft`),block 和卡片自己消失;切到别的会话再回来、或者重新加载时,按当时的草稿和「放过」重新判断。「放过」按会话记在页面的内存里,记的是草稿全文;切到别的会话再回来还在,重新加载就没了。只拦整段是 Key 的草稿:句子里夹着 Key 不拦,DSH 的掩码只改显示,模型仍会收到。
- - 拦着的时候 Key 只在这个页面里:点了〔检查并保存〕才交给 Host 的 `provider-key`;点了〔当普通消息发送〕,它就和别的消息一样进对话记录、发给模型。但 DSH 本来就把每个会话的草稿存在浏览器的 localStorage 里(`dsh.conversation.<会话>`;桌面应用里在 `%APPDATA%\DeepSeek Bot` 下,DSH Web 里在用户的浏览器配置里),挂着 block 的这段时间 Key 也在那里,重开后还在,直到草稿被清掉。
+ - 挂着 block 时输入框是只读的(DSH 的 block 让编辑器不能编辑,占位里的原因也只在输入稿为空时显示),用户自己改不了输入稿,出口全在卡片上;输入稿被别处改成别的内容时(比如别的插件调了 `setDraft`),block 和卡片自己消失;切到别的会话再回来、或者重新加载时,按当时的输入稿和「放过」重新判断。「放过」按会话记在页面的内存里,记的是输入稿全文;切到别的会话再回来还在,重新加载就没了。只拦整段是 Key 的输入稿:句子里夹着 Key 不拦,DSH 的掩码只改显示,模型仍会收到。
+ - 拦着的时候 Key 只在这个页面里:点了〔检查并保存〕才交给 Host 的 `provider-key`;点了〔当普通消息发送〕,它就和别的消息一样进对话记录、发给模型。但 DSH 本来就把每个会话的输入稿存在浏览器的 localStorage 里(`dsh.conversation.<会话>`;桌面应用里在 `%APPDATA%\DeepSeek Bot` 下,DSH Web 里在用户的浏览器配置里),挂着 block 的这段时间 Key 也在那里,重开后还在,直到输入稿被清掉。
- **账号余额为零**(登录后):「已登录 DeepSeek 账号,但余额是 ¥0.00。充值后我就能开始;一般一轮对话只要{实测值},以 DeepSeek 价格页为准。」〔去充值 ↗〕〔再查一次余额〕〔换一种方式〕。key 余额为零时用上面「粘贴 key」里的卡片。这两张卡显示期间,窗口回到前台时、以及每 10 秒(最多 10 分钟)自动重查,余额一到就自己往下走。
- **自动选模型**(插件形态里是否也这样待定):只有一个提供商能用时,不再让用户选,直接用 DSH 默认模型(能用的话),否则用这个提供商的第一个模型。选之前先确认能用:有不调用模型的检查就用它(账号余额、`/user/balance`;后者是否计费没有文档),没有就发一次 8 token 的试连。通过后卡片收成一行「已接上 DeepSeek-V4.1-Flash · DeepSeek 账号 更换」,随即是 Main Bot 固定的开场白,不调用模型(第 6 节)。这次检查照旧要做:开场白不再用到模型,但检查也挡着 Main Bot 的第一个正常回合。两个以上提供商能用时,仍按提供商分组让用户选,DSH 默认模型标「推荐」。
- 登录 DeepSeek 账号后,DSH 的账号前端会尽力把账号模型存成默认,但这一步不保证完成、也不保证先于我们,所以只剩账号这一个提供商时,DS Bot 自己选账号的第一个模型,不等 DSH。
@@ -234,7 +234,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- **模型不可用时**:选项照样给现成的建议。输入框里有字时,建议卡上面写「模型暂时没有回应。先用现成的建议,或者直接开始。」,下面是现成的建议(文字按关键词对上一组现成的,再照上面的规则合并),摘要只写「建议建这 N 个 Bot,名字可以直接改。」;〔换一组建议〕没有回应时显示同一句,原来的几行不变,这次请求照样计数。第一件事的回复失败时,就是下面的修复卡。
- **深度限制是机制,不是提示词**:
- 步骤表写在代码里,Host 按卡片的回答往下走,模型从不选下一步。
- - 上手期间(开场白到第一件事发出之前),第一个 Main Bot 的会话用 `agent.ctx.tools.restrict({ allow })` 只留 `ask_user` 和草稿模式的 `create_bot`(只出草案,用户点了才建),`tools.guard` 限制每一步的调用次数,超了就拒绝、要它直接回答。第一件事一发出就解除(上面)。
+ - 上手期间(开场白到第一件事发出之前),第一个 Main Bot 的会话用 `agent.ctx.tools.restrict({ allow })` 只留 `ask_user` 和输入稿模式的 `create_bot`(只出草案,用户点了才建),`tools.guard` 限制每一步的调用次数,超了就拒绝、要它直接回答。第一件事一发出就解除(上面)。
- 每一步(每次按〔确定〕或〔换一组建议〕)最多一次请求,输出 400 到 700 token(`maxTokens` 700):8 秒内没有第一个字、或者 12 秒还没回完,就出这一步的兜底卡。上手期间 Main Bot 的会话里万一跑起一个回合(输入框锁着,只能来自别的入口),它也只有一次请求,8 秒内要有第一个字,整轮 20 秒内完成,否则同样出兜底卡。整个上手最多 3 次请求,就是卡上的「模型请求 n/3」;第一件事不算在里面,它发出时限制已经解除。
- 每一步都有一张模型关着也能走通的卡。CI 用 mock 模型跑这几种情况:正常、断网、来回循环、答非所问、编造模型名、401、余额为零、把 Key 粘进目标卡的输入框。
- Bot 聊天里任何一轮失败,都由插件画一个修复卡,替换 DSH 的「本轮运行失败」那一行(DSH Agent 的普通会话不变)。原文、代码、HTTP 状态码和 request id 放在「技术详情」里,可以复制;AUTH 的原文照旧不显示。
@@ -296,6 +296,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 账号、提供商、位置(设置项的名字,里面是数据文件夹和总工作区)、数据文件夹、总工作区。
+- 「输入稿」是输入框里还没发出的文字(DSH 叫 draft,`setDraft`)。
- 本文里「引擎」指桌面应用启动的 DSH 子进程,「引擎的页面」是它提供的网页前端;「Host」只指插件的 `ds-bot/src/host`。
- 第一次介绍产品的地方都写「不是 DeepSeek 官方产品」。
- README.md 和 README.zh.md 各加一行名词解释:DeepSeek Bot / DS Bot / DeepSeek Harness。
@@ -364,7 +365,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
10. `settings.launcher` 插槽能直接打开设置的某一节(比如「模型」)。今天可以借一个自己的 `settings.onboarding` 步骤绕一步做到(见第 8 节),有了这个接口就更简单。
11. `runProfile` 报告命名的启动阶段,供壳显示真实进度。
12. pwsh 工具的说明里写明实际是 Windows PowerShell 5.1 还是 PowerShell 7。
-13. 发送前的一个有文档的钩子(或者让 `ComposerBlocks` 能带一张卡片),让插件能在一段只有 Key 的消息进对话记录之前拦下它;今天只能靠观察草稿再挂 block,粘贴和 Enter 同一瞬间时拦不住。
+13. 发送前的一个有文档的钩子(或者让 `ComposerBlocks` 能带一张卡片),让插件能在一段只有 Key 的消息进对话记录之前拦下它;今天只能靠观察输入稿再挂 block,粘贴和 Enter 同一瞬间时拦不住。
14. 网页前端(或 Desktop 桥)提供「把授权页交给宿主自己的窗口打开」的方式;今天桌面应用只能接住网页前端 `window.open` 的 `about:blank`,再看它导去哪里。
## 分批上线
@@ -374,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) |
+| 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) |
| M5 启动页上的导入 | 一句话的导入卡和折叠的详情(预览、大小、可跳过的文件夹);卡片一出现就检查对话和预热引擎,「先不复制」不重启引擎;自动重查占用;新版本对话走「更新后再复制」;第一段的空间检查、进度和停止;工作文件在团队打开后后台复制,设置里的进度、停止、续复制;设置里的再次导入;导入后的检查卡和 Main Bot 提前换段(#384)。CI 用假的 `~/.dsh`(含 junction、新版本对话、PID 被重用的旧锁、群聊、大 `node_modules`) | 约 5 人日 |
@@ -393,11 +394,11 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 空间只占一份(CI 用替身的空间查询和一个 2 GB 的假团队):整个导入过程中数据所在的盘最多少掉「第一段 + 500 MB」,没有 `.import-check-*` 文件夹,`~/.dsh` 的内容和修改时间一个都没变;工作文件复制完后新旧两处各一份,设置里显示原团队的位置和大小;剩余空间降到 500 MB 以下时后台复制停下,设置里有〔继续复制〕。导入卡开着、DSH 还占着团队时数据文件夹里没有 `.import-*`,锁放开后才出现;暂存期间锁刷新过,暂存会重做;导入卡开着时关窗、更新重开,下次启动前暂存已删。
- 〔移到…〕同一个卷:完成不超过 2 秒,旧路径不存在,数据没有被复制(inode 不变);改名失败时退回到复制;不同的卷:新引擎 `ready` 后旧数据文件夹被删,工作文件逐个落位后原件被删,复制完旧总工作区里只剩跳过的文件,数量和设置里写的一致;用户自己挑的总工作区一个文件都不动;新引擎没 `ready` 或中途被杀掉时,下次启动退回原位置,`R` 下面没有留下应用建的东西,`locations.json` 不变。
- mock 模型粘贴 `sk-test-ok`:第一个 Main Bot 的 Session 里没有失败节点,引擎的页面出来后 30 秒内收到开场白,mock 模型没有收到开场白的请求(只有余额检查),随后出现目标卡;CI 上从双击安装包到目标卡不超过 90 秒。
-- 上手(mock 模型):只选选项按〔确定〕时 mock 没有收到请求,卡上是「模型请求 0/3」;输入框里有字时正好一次;合并后的建议按第 6 节的规则排(卡上的顺序、轮流取、同名只留一个、最多 5 个 Bot、最多 3 个第一件事),和点选项的先后无关;〔换一组建议〕到 3/3 后变灰,写「已到上限」;〔跳过〕给出三个固定任务;〔建…〕后侧栏里正好多出勾选的那几个 Bot,用的是改过的名字,每个的聊天里是固定的招呼,mock 收到的请求数不变;第一件事发出之前,Main Bot 会话的工具只有 `ask_user` 和草稿模式的 `create_bot`,第一件事那一回合已经是原来的工具;目标卡输入框里整段是末四位 `0001` 的那把 DeepSeek 格式 Key 时按〔确定〕,mock 没有收到请求,卡下面是 Key 的卡;Main Bot 的会话里有那行灰字或用户的消息时重开应用,不再出目标卡,都没有时从目标卡重新开始;第 6 节列的八种情况都走到一张能用的卡,每张卡都有「跳过设置,直接开始」。
+- 上手(mock 模型):只选选项按〔确定〕时 mock 没有收到请求,卡上是「模型请求 0/3」;输入框里有字时正好一次;合并后的建议按第 6 节的规则排(卡上的顺序、轮流取、同名只留一个、最多 5 个 Bot、最多 3 个第一件事),和点选项的先后无关;〔换一组建议〕到 3/3 后变灰,写「已到上限」;〔跳过〕给出三个固定任务;〔建…〕后侧栏里正好多出勾选的那几个 Bot,用的是改过的名字,每个的聊天里是固定的招呼,mock 收到的请求数不变;第一件事发出之前,Main Bot 会话的工具只有 `ask_user` 和输入稿模式的 `create_bot`,第一件事那一回合已经是原来的工具;目标卡输入框里整段是末四位 `0001` 的那把 DeepSeek 格式 Key 时按〔确定〕,mock 没有收到请求,卡下面是 Key 的卡;Main Bot 的会话里有那行灰字或用户的消息时重开应用,不再出目标卡,都没有时从目标卡重新开始;第 6 节列的八种情况都走到一张能用的卡,每张卡都有「跳过设置,直接开始」。
- `sk-test-bad` 不会被保存(`credentials.describe` 仍是未配置),卡片显示 401 的文字,Session 里没有回合。`sk-test-empty` 会保存,但 `/user/balance` 报出余额之前不跑开场白,卡片显示「去充值」。
- 登录窗口(CI 用 loopback 上的假 DeepSeek 平台:DSH 的 `platformOrigin` 指向它,`allowLoopbackHttp`):点〔登录 DeepSeek 账号〕后 1 秒内出现主窗口的子窗口,地址是假平台的授权页,标题是「登录 DeepSeek 账号」;它的 partition 不是主窗口的、不持久,关窗后 `deepseek-login` 里没有 Cookie,主窗口的 session 里也没有假平台的 Cookie;假平台跳回 `/oauth/callback` 后窗口 1 秒内关掉、主窗口有焦点、卡片收成「已接上」;回调请求发出、回应还没回来时用 × 关掉窗口,引擎里这次登录仍是 succeeded,卡片收成「已接上」;回调之前用 × 关掉窗口,卡片回到两种方式、引擎里这次登录是 cancelled;授权过期或在卡片上点〔取消〕时,窗口 1 秒内跟着关掉;窗口开着时点鲸鱼菜单的「登录 DeepSeek 账号」,出现 DSH 的登录框(等待中),登录窗口还是原来那个,这次登录仍在等待;在那个登录框里点〔取消〕,窗口 1 秒内关掉,这次登录是 cancelled,卡片回到两种方式;在窗口里点一个别的域名的新窗口链接,链接交给系统浏览器(替身记录)、窗口还在;主框架被导到别的域名时,窗口关掉、授权链接交给系统浏览器、这次登录仍在等待,设置卡写「已在浏览器打开 DeepSeek 登录页。…」,在替身浏览器里走完回调后卡片收成「已接上」、主窗口回到前台;点「在浏览器里打开」后登录窗口关掉、这次登录不是 cancelled;授权页加载失败时窗口关掉、这次登录没有被取消、卡片有〔在浏览器里打开〕和〔取消〕,点〔取消〕后引擎里这次登录是 cancelled、卡片回到两种方式;授权页里的一个 iframe 打不开时窗口还在;假平台让换取失败时窗口关掉,卡片显示登录没有完成,不回到两种方式;登录窗口里的页面请求麦克风、通知或下载文件时,都被拒绝或取消,系统不弹任何框;从修复卡的〔重新登录〕或鲸鱼菜单的「登录 DeepSeek 账号」开始、回调之前用 × 关掉窗口,引擎里这次登录是 cancelled,不等它过期;替身让 `resolveProxy` 对授权链接给出 `PROXY 127.0.0.1:7890`、授权页又打不开时,卡上多一句「登录页走的是系统代理 127.0.0.1:7890:如果代理软件没开,打开它。」,不提「跟随系统代理」;`main.log` 里没有授权链接,也没有回调地址里 `code` 和 `state` 的值。
- 现成的 Key:一次性用户的 DSH 家(`~\.dsh`)的 `.credentials.yaml` 里放 `sk-test-ok`、没有团队:设置卡最上面是「DeepSeek Harness 里有一个 Key:sk-test-…」〔用这个 Key〕,〔登录 DeepSeek 账号〕是次按钮;点了之后 `credentials.describe` 是已配置、`~\.dsh` 里的文件没变、日志和页面的 DOM 里没有整段 Key;放 `sk-test-bad` 时这一行在,点了显示 401、不保存,这一行消失,切到别的 Bot 再回来也不再出现;那个家的 `.env` 里有 `DEEPSEEK_BASE_URL` 时没有这一行。剪贴板替身放末四位 `0001` 的那把 DeepSeek 格式 Key 再把窗口切回前台:出现「剪贴板里有一个 Key:sk-…」,后面是它的前八位;放 `sk-test-ok`(不合格式)或别家格式的 `sk-` Key 时不出现;清掉再切回:这一行消失;两处放不同的 Key 时只有一行,是剪贴板的,小字里是 DeepSeek Harness 的;放相同的 Key 时只有一行,是 DeepSeek Harness 的;点〔用这个 Key〕之前把替身换成别的内容,不检查、不保存;设置卡不在时(已接上)替身的读取计数是 0。
-- 聊天里粘贴的 Key(mock 模型):接上模型、上手结束后(或点了「跳过设置,直接开始」),在 Main Bot 的聊天框粘贴末四位 `0001` 的那把 DeepSeek 格式 Key:没有新的回合,输入框是 block 状态、不能编辑,卡片出现,主按钮是〔检查并换上〕(已经有 Key);点了之后草稿为空、Key 已配置、Session 记录里没有这段文字;换成〔当普通消息发送〕后 Session 里正好一条用户消息,带着的附件一起发出;换成〔清掉〕后草稿为空、Key 没变、Session 里没有新消息;点「改一下」后输入框可以编辑、草稿还在、不再出现卡片,改过草稿再粘回同一把 Key,卡片重新出现;粘贴末四位 `0401` 的那把,点主按钮后卡上是 401、主按钮是〔清掉〕;粘贴 `sk-` 加 30 个字母数字(含数字、不是十六进制)时主按钮是〔保存到提供商…〕;「我的 key 是」后面跟同一把 Key 这样夹在句子里的不拦,单独粘贴 `sk-test-ok`(不合格式)也不拦;撤掉 Key 的 block 时还没有能用的模型,输入框回到「先在上面接上模型,我就能回复你」的锁,不是可用。粘贴末四位 `0000` 的那把,点〔检查并换上〕后 Key 换成了这一把、草稿为空、Key 的 block 撤掉,卡片留着,写「Key 已保存,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔知道了〕,没有〔再查一次余额〕〔换一种方式〕;先发「要密钥」让 Bot 出一张 `request_secret` 卡,再粘贴末四位 `0001` 的那把,主按钮是〔填进那张卡〕,点了之后草稿为空、Key 在那张卡的输入框里,`credentials.describe` 没变。
+- 聊天里粘贴的 Key(mock 模型):接上模型、上手结束后(或点了「跳过设置,直接开始」),在 Main Bot 的聊天框粘贴末四位 `0001` 的那把 DeepSeek 格式 Key:没有新的回合,输入框是 block 状态、不能编辑,卡片出现,主按钮是〔检查并换上〕(已经有 Key);点了之后输入稿为空、Key 已配置、Session 记录里没有这段文字;换成〔当普通消息发送〕后 Session 里正好一条用户消息,带着的附件一起发出;换成〔清掉〕后输入稿为空、Key 没变、Session 里没有新消息;点「改一下」后输入框可以编辑、输入稿还在、不再出现卡片,改过输入稿再粘回同一把 Key,卡片重新出现;粘贴末四位 `0401` 的那把,点主按钮后卡上是 401、主按钮是〔清掉〕;粘贴 `sk-` 加 30 个字母数字(含数字、不是十六进制)时主按钮是〔保存到提供商…〕;「我的 key 是」后面跟同一把 Key 这样夹在句子里的不拦,单独粘贴 `sk-test-ok`(不合格式)也不拦;撤掉 Key 的 block 时还没有能用的模型,输入框回到「先在上面接上模型,我就能回复你」的锁,不是可用。粘贴末四位 `0000` 的那把,点〔检查并换上〕后 Key 换成了这一把、输入稿为空、Key 的 block 撤掉,卡片留着,写「Key 已保存,但账户余额是 ¥0.00,充值后才能用。」〔去充值 ↗〕〔知道了〕,没有〔再查一次余额〕〔换一种方式〕;先发「要密钥」让 Bot 出一张 `request_secret` 卡,再粘贴末四位 `0001` 的那把,主按钮是〔填进那张卡〕,点了之后输入稿为空、Key 在那张卡的输入框里,`credentials.describe` 没变。
- 插件 Host 的单元测试(替身 `deepseekAccount`):未登录和零余额的账号不会产生开场白回合;有余额的会在自动选模型后产生;`getBalance` 失败时照常往下走。
- 中文界面下,把启动页、设置卡、目标卡、建议卡、第一件事卡、聊天里粘贴 Key 的卡、修复卡的每种状态和卸载提示都渲染一遍,除允许名单外找不到英文单词。
- 没有能用的模型且模型列表已知时,Bot 聊天的输入框不可用;绕过输入框发出的消息在接上模型后会得到回答,开场白不丢,之后不出目标卡。
@@ -470,8 +471,8 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 登录窗口不留 DeepSeek 平台的登录状态,〔去充值 ↗〕(余额为零的卡、ACCOUNT_QUOTA 的修复卡)仍在系统浏览器里打开开放平台:没在浏览器里登录过开放平台的人(比如刚在登录窗口里用手机号注册的新账号)要在那里再登录一次。以前在浏览器里登录时没有这一步(要不要改见「待定」)。
- 修复卡和鲸鱼菜单走 DSH 自己的登录框,登录窗口开着时它仍写着在浏览器里继续:这是 DSH 的文案,不改它的界面。在那个登录框里点〔取消〕或 ×,会取消这次登录,登录窗口也跟着关掉。
- 剪贴板只在设置卡显示期间读,但读的时候没有提示;卡上那一行的前八位就是读过的证据。
-- 聊天里只有 Key 的草稿靠观察草稿再挂 block,粘贴和 Enter 同一瞬间(脚本、自动化)可能抢在 block 之前发出去;句子里夹着的 Key 不拦,DSH 的掩码只改显示。
-- 聊天里只有 Key 的草稿在清掉之前一直存在浏览器的 localStorage 里,这是 DSH 存草稿的做法;401 或用户不理卡片时,Key 会跟着草稿留到下次启动。插件只在保存、〔填进那张卡〕或〔清掉〕时用 `setDraft('')` 清掉它;〔当普通消息发送〕时由 DSH 发出后清掉;插件不替用户删草稿。
+- 聊天里只有 Key 的输入稿靠观察输入稿再挂 block,粘贴和 Enter 同一瞬间(脚本、自动化)可能抢在 block 之前发出去;句子里夹着的 Key 不拦,DSH 的掩码只改显示。
+- 聊天里只有 Key 的输入稿在清掉之前一直存在浏览器的 localStorage 里,这是 DSH 存输入稿的做法;401 或用户不理卡片时,Key 会跟着输入稿留到下次启动。插件只在保存、〔填进那张卡〕或〔清掉〕时用 `setDraft('')` 清掉它;〔当普通消息发送〕时由 DSH 发出后清掉;插件不替用户删输入稿。
- 签名之前,开着智能应用控制的 Windows 11 装不了未签名的安装包,只能先走 DSH Desktop 插件这条路。签名主体如果是 SignPath Foundation,发布者会显示它的名字。
- 一键安装去掉了选程序目录(估计约 600–700 MB 在 C 盘,实测后写进 README),只剩 `/D=`。
- electron-builder 自带的几条 NSIS 报错(卸载旧版失败、解压失败)只有英文。
@@ -490,7 +491,7 @@ Windows 是桌面应用的主要平台:0.2.0 到 0.2.2 三个版本的安装
- 2026-10-26:实现 M1 时补正:Edge 的「保留」后还要点「显示更多」;README 先链到 `releases/latest` 页面,固定下载链接随 M3 的检查上;安装问题表单问系统的显示语言,不只是 Windows 的;导入时只有引擎写的 `client-connection/` 记录的 `.credentials.yaml` 不算用户的,照常换成旧的。
- 2026-10-26:维护者反馈位置选择生硬,简化 §3 和 §4:换位置只选一个文件夹,数据和总工作区一起放进去;盘不够或位置不能用时推荐一个固定盘,系统选择框退到「其他位置…」之后,只在应用改了路径时确认;重装不问;导入卡缩成一句话两个按钮,卡片一出现就检查和预热;复制分两段,团队在对话复制完就打开,工作文件后台复制。卡片的样子在 [启动窗口](2026-10-26-start-window.md) 里。评审后补正:定根的规则写成一条;重装接着用时不出位置卡;后台复制不用 `fs.cp`,经暂存和硬链接落位;导入卡开着时主窗口不加载引擎的页面;〔移到…〕靠删掉 `workspaceId` 和 `DS_BOT_WORKSPACE` 换总工作区,文件在重启后后台复制。
- 2026-10-27:维护者要求空间不能占两份:§4 加「空间只占一份」(对话只复制一次、附件改名进位、第一段和第二段各有空间下限、卡片写明多占多少、设置里显示原团队的位置和大小);§8 的〔移到…〕改成真正的搬(同一个卷改名,不同的卷复制完删旧的),恢复页的〔换个位置…〕同样。评审后补正:暂存前先查锁,占用卡和「正在下载」卡有〔先不复制〕;标记在建文件夹时就写,每次启动先删上次的暂存;〔移到…〕只搬应用自己建的文件夹、按「搬到一半」记录退回、逐个搬工作文件、搬前查空间;复制团队和空白团队不删现在的团队,设置里列出「以前的团队」;〔重新找到它…〕的规则;被拒绝的位置卡留着来时的按钮;Bot 知道工作文件还没到齐,`workDir` 在 `~/.dsh` 里的改到新总工作区;空间例子改成 1.7 / 1.5 / 0.2 GB;推荐盘的门槛加上导入要多占的数;Key 余额为零的卡加〔换一种方式〕;允许名单补 DSH Desktop、DSH Web、提供商名和用户起的名字。
-- 2026-10-27:接模型的三条改进写进 §5 和 M2:桌面应用里登录页在应用自己的登录窗口里打开,不离开应用,打不开时才退回系统浏览器;现成的 Key(DeepSeek Harness 的凭据、设置卡期间的剪贴板)一键用,照样先检查再保存;聊天里整段是 Key 的草稿拦下来,问保存还是发送。`dsBotApp` 加 `signIn` 和 `foundKeys()` / `takeKey()`;「需要 DSH 提供的」加第 13、14 条;剪贴板是否保留、〔去充值 ↗〕在哪里打开列入待定。评审后补正:DSH 开的空白弹窗改不了 partition,登录窗口由应用另建、两者同生同灭;允许名单只管主框架,授权页来源从第一次导航取;回调不看状态码,`onClosed` 带原因,回调发出后关窗不算取消;代理提示不提引擎的开关;环境变量的 Key 是「来源 env」不是「不可写」;mock 加三把 DeepSeek 格式的 Key;现成 Key 一行一个主按钮、两处合并、`takeKey` 核对前八位;聊天卡按状态选文案,加〔清掉〕和「改一下」,和模型锁合算一个 block,发送走输入框自己的 `submit()`;草稿存在 localStorage、充值页要再登录记进已知限制。第二轮补正:登录窗口的 session 只放行主框架的回调,不照抄 Bot 浏览器拦引擎的规则;新窗口等旧 partition 清完再开;`onClosed` 带代理,打不开的卡有〔取消〕;登录中点鲸鱼菜单或修复卡只打开 DSH 的登录框;窗口里新开的链接一律去系统浏览器;被拒的现成 Key 不再推荐;聊天卡写明检查没通过时的按钮、余额为零的〔知道了〕和 `request_secret` 卡的按钮;「放过」在 DSH 清空草稿时仍在。
+- 2026-10-27:接模型的三条改进写进 §5 和 M2:桌面应用里登录页在应用自己的登录窗口里打开,不离开应用,打不开时才退回系统浏览器;现成的 Key(DeepSeek Harness 的凭据、设置卡期间的剪贴板)一键用,照样先检查再保存;聊天里整段是 Key 的输入稿拦下来,问保存还是发送。`dsBotApp` 加 `signIn` 和 `foundKeys()` / `takeKey()`;「需要 DSH 提供的」加第 13、14 条;剪贴板是否保留、〔去充值 ↗〕在哪里打开列入待定。评审后补正:DSH 开的空白弹窗改不了 partition,登录窗口由应用另建、两者同生同灭;允许名单只管主框架,授权页来源从第一次导航取;回调不看状态码,`onClosed` 带原因,回调发出后关窗不算取消;代理提示不提引擎的开关;环境变量的 Key 是「来源 env」不是「不可写」;mock 加三把 DeepSeek 格式的 Key;现成 Key 一行一个主按钮、两处合并、`takeKey` 核对前八位;聊天卡按状态选文案,加〔清掉〕和「改一下」,和模型锁合算一个 block,发送走输入框自己的 `submit()`;输入稿存在 localStorage、充值页要再登录记进已知限制。第二轮补正:登录窗口的 session 只放行主框架的回调,不照抄 Bot 浏览器拦引擎的规则;新窗口等旧 partition 清完再开;`onClosed` 带代理,打不开的卡有〔取消〕;登录中点鲸鱼菜单或修复卡只打开 DSH 的登录框;窗口里新开的链接一律去系统浏览器;被拒的现成 Key 不再推荐;聊天卡写明检查没通过时的按钮、余额为零的〔知道了〕和 `request_secret` 卡的按钮;「放过」在 DSH 清空输入稿时仍在。
- 2026-10-28:维护者 2026-10-27 的反馈写进 §3 到 §6、§8 和 M2、M4,分三部分。一是「鲸鱼即进度」的启动页:小窗口显示的是实现的结构(一条带三个点的线和几段说明),不是用户感受到的东西;现在鲸鱼停在哪一站就是到了哪一步,一次一句鲸鱼的话,提示行只说接下来要准备什么,5 秒起显示已用秒数,卡片的第一句也由鲸鱼说,重装的小字改成提示,180 秒改成鲸鱼的问题,交接时启动窗口长成主窗口。二是目标卡可以多选,按〔确定〕提交,几个目标按卡上的顺序合并成一份建议。三是上手后半段的 AI-native 方案:开场白改成固定文字、不调用模型,然后是目标卡、建议卡和第一件事卡,只在用户写了字或要换一组时调用模型,整个上手最多 3 次请求,深度限制写成机制(步骤表在代码里、工具受限、每一步一次请求和时限、模型关着也能走通的卡、mock 模型的 CI);「试试:」的三个固定任务留作〔跳过〕的路和补位。依据:启动窗口和团队窗口的原型及其检查(`handoffShow` 在就绪后 1.09 到 1.17 秒,窗口 300 ms 长大,目标卡和合并的用例)和 2026-10-27 给维护者的 AI-native 评估。合并的上限、第一件事的分法、单个目标的摘要、水线和启动页的大小列入「待定」。评审后补正:第一件事一发出就解除工具限制,它是不受上手限制的正常回合,灰字仍在它回复以后;建议卡建的 Bot 的招呼也是固定文字,整个上手确实最多 3 次请求;JSON 调用只有一组时限(8 秒第一个字、12 秒回完),整轮 20 秒只管上手期间 Main Bot 会话里的回合,兜底最坏 12 秒;schema 带 `goal` 和任务的草案序号,合并按 `goal` 走,模型的摘要只在用户的话太长时用;〔换一组建议〕由模型换一组不重复的;目标卡输入框里整段是 Key 时不发给模型;上手结束从会话里读(灰字或用户自己的消息),中途重开从目标卡重新开始,「取舍」写明这一点;一个会话的 block 按模型锁、上手锁、Key 排,上手锁有自己的占位,开场白不再说「直接说就行」;接上模型前发出的消息算 Main Bot 的第一个正常回合,不再出目标卡;修复卡的「重新留着」只管模型写的招呼;合并的上限和分法按已定的写,「待定」改成要不要改;「一轮多少钱」改用第一件事的回合实测;第 5 节写明侧栏磁贴上的鲸鱼,开场白和目标卡的时间从设置卡收起时算;以后的启动照 [启动窗口](2026-10-26-start-window.md) 第 5 节写,记进「改动的已定设计」;交接的验收从鲸鱼停到第 3 站算;`askSteward` 只是形态相同,上限是这次调用自己的;「水圈」统一叫「圈」,「三站」改成「三站的标记」;导入的检查行去掉破折号;45 KB 那条待定照启动窗口稿写;M4 加八种动作和磁贴上的鲸鱼,估计改成 10 人日。复核后补正:问候里的名字、`dsBotApp` 的露面事件(待定)和以后的启动庆祝那次的 2.5 秒兜底与启动窗口稿对齐;交接验收的 1.2 秒放宽到 1.3 秒,给 CI 留余量。
- 2026-10-28(第二次):落地 M4 第一批时维护者看到首次启动仍弹「欢迎使用 DeepSeek Bot」的系统对话框(「我主要不喜欢这个」),要求「给出建议,同时提供自行选择的接口,避免小弹窗」:§3 的「什么都不问」补上启动页底注右边的位置行「数据放在 C 盘(剩 412 GB)· 换个位置…」,点了才开系统选择框,定根和「一个位置」一样,被拒绝的原因加上 DSH 的家和程序文件夹,定好后引擎在新文件夹重新起(启动窗口稿第 2、4、6、7 节);验收加一条。导入问题在 M5 的导入卡落地前仍是挂在启动窗口上的对话框。
- 2026-10-29:启动页的文案分层,写进 [启动页文案](2026-10-29-start-copy.md);按各层的写法规则改了本文引用的四处:§3「团队界面没有加载出来」、§8 45 秒的「比平时慢,请再等一会儿」去句号,§3「会放在 `D:\DeepSeek Bot`。」加句号、〔重新选…〕加 …(被拒绝的卡也一样),§4 更新版本那张卡的脚注改成「以后可以在 设置 → 通用 → 位置 里复制。」,和「以后可以在 … 里改。」同一个句式;「用词」加一条指向它。