dsh-model 0.18.0 → 0.19.0

package/dist/integrations/dshplugin.js

@@ -5,7 +5,7 @@
 // 用户自己从市场 / GitHub 装的（依赖写法不是我们的）就不动它。卸载时只移除 dsh-model 装的那份。
 import { lstat, realpath, unlink } from 'node:fs/promises';
 import { join } from 'node:path';
-import { dshPlugin, profileHasDependency } from '../dsh/cli.js';
+import { dshPlugin, dshPluginTee, profileHasDependency } from '../dsh/cli.js';
 import { resolveProfile } from '../dsh/locate.js';
 import { DshModelError } from '../errors.js';
 import { L } from '../i18n.js';
@@ -65,10 +65,15 @@ export async function installDshPlugin(ctx, all, opts = {}) {
     catch {
         // 不存在
     }
-    const code = await dshPlugin(ctx, profile, ['add', want.install, '--config.strict-dep-builds=false'], all.config.proxy);
+    const { code, output } = await dshPluginTee(ctx, profile, ['add', want.install, '--config.strict-dep-builds=false'], all.config.proxy);
     const installed = await profileHasDependency(ctx, profile, PLUGIN_NAME);
     if (code !== 0 || !installed) {
-        throw new DshModelError('plugin_install_failed', L(`把 dsh-model 装进 dsh 失败（退出码 ${code}）`, `Failed to install dsh-model into dsh (exit code ${code})`), L('可以在 dsh 的插件市场搜索 dsh-model 安装', 'You can install it from the dsh plugin marketplace (search dsh-model)'));
+        const blocked = releaseAgeBlocked(output);
+        if (blocked.length) {
+            // dsh 的 pnpm 不装"发布不满一天"的版本，而且整份插件清单一起查：别的插件刚更新也会把这次拦下
+            throw new DshModelError('plugin_release_age', L(`dsh 的插件安全规则（新发布的版本要等一天）拦下了这次安装：${blocked.join('、')}`, `dsh's plugin safety rule (new versions wait a day) blocked this install: ${blocked.join(', ')}`), L('这条规则检查 dsh 里的全部插件，不只是 dsh-model。等上面列出的版本发布满一天后，再执行一次 dsh-model setup 即可', 'It checks every plugin in dsh, not just dsh-model. Run dsh-model setup again once the versions above are a day old'));
+        }
+        throw new DshModelError('plugin_install_failed', L(`把 dsh-model 装进 dsh 失败（退出码 ${code}）`, `Failed to install dsh-model into dsh (exit code ${code})`), L('可以在 dsh 的「添加插件」里填 dsh-model@<版本> 安装', 'You can add it in dsh with "Add plugin": dsh-model@<version>'));
     }
     all.state.plugins = [...(all.state.plugins ?? []).filter((p) => p.name !== PLUGIN_NAME), { name: PLUGIN_NAME, version: installed, installedByUs: true, installedAt: new Date().toISOString() }];
     ok(L(`dsh 插件已安装（${installed}）：重启一次 dsh，在「设置 → dsh-model」里管理来源、用量和 key`, `dsh plugin installed (${installed}): restart dsh once, then manage sources, usage and keys in Settings → dsh-model`));
@@ -87,3 +92,9 @@ export async function removeDshPlugin(ctx, all, opts = {}) {
     all.state.plugins = (all.state.plugins ?? []).filter((p) => p.name !== PLUGIN_NAME);
     return true;
 }
+/** pnpm 的 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION：哪些包、什么时候发布的。导出给测试 */
+export function releaseAgeBlocked(output) {
+    if (!/MINIMUM_RELEASE_AGE_VIOLATION/.test(output))
+        return [];
+    return [...output.matchAll(/^\s*(\S+@\S+) was published at (\S+?),/gm)].map((m) => `${m[1]}（${m[2].replace('T', ' ').slice(0, 16)} 发布）`);
+}

package/dist/ops.js

@@ -1,4 +1,5 @@
 // ops.ts — 各命令共用的流程：读全部状态、应用引擎配置、同步模型到 dsh
+import { COMPAT_PREFIXES } from './sources.js';
 import { connectDshGroups } from './dsh/connect.js';
 import { listModels, waitHealthy, waitModelsChange } from './engine/client.js';
 import { compatModelIndex, loadCompatUpstreams } from './engine/compat.js';
@@ -140,7 +141,7 @@ export async function dshCandidates(ctx, all, ids) {
 /** 引擎里带前缀（opencode/ workbuddy/ workbuddy-ai/）的模型是否正好等于期望：不能缺，也不能多（关掉的来源要消失） */
 function aliasesMatch(models, expected) {
     const want = new Set(expected);
-    const prefixes = ['opencode/', 'workbuddy/', 'workbuddy-ai/', 'ollama/', 'lmstudio/'];
+    const prefixes = COMPAT_PREFIXES;
     const have = models.map((m) => m.id).filter((id) => prefixes.some((p) => id.startsWith(p)));
     return have.length === want.size && have.every((id) => want.has(id));
 }

package/dist/service/admin.js

@@ -2,7 +2,7 @@
 //
 // 守护进程以 dsh 用户运行，而更新（npm 全局目录、系统服务）和卸载（Caddy、防火墙、系统服务）要 root。
 // 所以 setup（root）装一个 systemd path 单元：守护进程在 <home>/admin/request 写一张请求单，
-// systemd 以 root 运行 `dsh-model admin-run`，它只认两件固定的事：更新到 npm 最新版、卸载。别的一律拒绝。
+// systemd 以 root 运行 `dsh-model admin-run`，它只认三件固定的事：更新到 npm 最新版、卸载、重启 dsh（插件更新后要重启才生效）。别的一律拒绝。
 import { chown, mkdir, readFile, rm } from 'node:fs/promises';
 import { join } from 'node:path';
 import { run } from '../util/exec.js';
@@ -76,7 +76,7 @@ export async function takeAdminRequest(ctx) {
     await rm(file, { force: true });
     try {
         const r = JSON.parse(raw);
-        if (r.action !== 'update' && r.action !== 'uninstall')
+        if (r.action !== 'update' && r.action !== 'uninstall' && r.action !== 'restart-dsh')
             return null;
         return { action: r.action, keepAuth: r.keepAuth === true, lang: r.lang === 'en' ? 'en' : 'zh' };
     }

package/dist/sources.js

@@ -15,6 +15,13 @@ export const SOURCES = [
     { id: 'devin', label: 'Devin', kind: 'engine', login: 'paste', engineProvider: 'devin', filePrefix: 'devin-', subscribeUrl: 'https://devin.ai/pricing', probeModel: 'devin/swe-1-7-lightning', pricing: { tier: 'paid', zh: '需要 Devin Pro（$20 / 月）；免费档实测调用被拒（insufficient_quota）', en: 'Needs Devin Pro ($20/mo); the free tier is refused in testing (insufficient_quota)' } },
     { id: 'ollama', label: 'Ollama（本地）', kind: 'local', login: 'none', subscribeUrl: 'https://ollama.com/download', pricing: { tier: 'free', zh: '本机运行，免费；装好并启动 Ollama、拉一个模型后自动出现', en: 'Runs on this machine, free; appears once Ollama is installed, running and has a model' } },
     { id: 'lmstudio', label: 'LM Studio（本地）', kind: 'local', login: 'none', subscribeUrl: 'https://lmstudio.ai', pricing: { tier: 'free', zh: '本机运行，免费；在 LM Studio 里打开本地服务（Developer → Start Server）后自动出现', en: 'Runs on this machine, free; appears once the LM Studio local server is started (Developer → Start Server)' } },
+    // 自带 API key 的来源（2026-10 核实，见设计 §14.11）：免费的都有每日 / 每分钟上限
+    { id: 'gemini', label: 'Gemini（Google AI Studio）', kind: 'apikey', login: 'key', subscribeUrl: 'https://aistudio.google.com/apikey', pricing: { tier: 'limited', zh: '免费 key，每天有次数上限；免费档的对话可能被用来训练模型', en: 'Free key with daily limits; free-tier prompts may be used for training' } },
+    { id: 'groq', label: 'Groq', kind: 'apikey', login: 'key', subscribeUrl: 'https://console.groq.com/keys', pricing: { tier: 'limited', zh: '免费 key，每个模型每分钟 / 每天有上限', en: 'Free key with per-model per-minute / per-day limits' } },
+    { id: 'openrouter', label: 'OpenRouter', kind: 'apikey', login: 'key', subscribeUrl: 'https://openrouter.ai/keys', pricing: { tier: 'limited', zh: '名字带 :free 的模型免费（每天约 50 次，充值 10 美元后约 1000 次）；其余按量付费', en: ':free models are free (about 50/day, about 1,000/day after a $10 top-up); others pay as you go' } },
+    { id: 'siliconflow', label: '硅基流动 SiliconFlow', kind: 'apikey', login: 'key', subscribeUrl: 'https://cloud.siliconflow.cn/account/ak', pricing: { tier: 'limited', zh: '实名认证后部分小模型免费（限速）；其余按量付费', en: 'Some small models are free after identity verification (rate limited); others pay as you go' } },
+    { id: 'deepseek', label: 'DeepSeek 官方', kind: 'apikey', login: 'key', subscribeUrl: 'https://platform.deepseek.com/api_keys', pricing: { tier: 'paid', zh: '按量付费（价格低）', en: 'Pay as you go (low prices)' } },
+    { id: 'custom', label: '其他 OpenAI 兼容服务', kind: 'apikey', login: 'key', pricing: { tier: 'paid', zh: '填地址和 key，接入任意 OpenAI 兼容服务', en: 'Enter a URL and a key for any OpenAI-compatible service' } },
     { id: 'opencode', label: 'OpenCode Zen', kind: 'opencode', login: 'key', subscribeUrl: 'https://opencode.ai/zen', pricing: { tier: 'paid', zh: '要先充值拿 key 按量计费；它的免费模型只能在 OpenCode 软件里用', en: 'Top up for a pay-as-you-go key; its free models only work inside the OpenCode app' } },
 ];
 const ALIASES = { grok: 'xai', muse: 'meta', chatgpt: 'codex', openai: 'codex', 'workbuddy-cn': 'workbuddy', wb: 'workbuddy', 'wb-ai': 'workbuddy-ai' };
@@ -36,3 +43,5 @@ export function paymentRequired(cred) {
     const cooldowns = cred.cooldowns;
     return Array.isArray(cooldowns) && cooldowns.some((c) => c?.reason === 'payment_required');
 }
+/** 引擎里作为 openai-compatibility 上游的来源：模型名前缀就是来源 id（同步时据此核对引擎是否已热重载） */
+export const COMPAT_PREFIXES = [...SOURCES.filter((s) => s.kind !== 'engine').map((s) => `${s.variant ?? s.id}/`), 'auto/'];

package/dist/util/exec.js

@@ -51,6 +51,17 @@ export function runInherit(cmd, args, options = {}) {
         child.on('close', (code) => resolve(code ?? 1));
     });
 }
+/** 像 runInherit 一样把输出原样给用户看，同时留一份（要从输出里认出具体错误时用） */
+export function runTee(cmd, args, options = {}) {
+    return new Promise((resolve) => {
+        let output = '';
+        const child = spawn(...spawnArgs(cmd, args, { cwd: options.cwd, env: options.env ?? process.env, stdio: ['inherit', 'pipe', 'pipe'] }));
+        child.stdout?.on('data', (d) => { process.stdout.write(d); output = (output + d.toString()).slice(-20000); });
+        child.stderr?.on('data', (d) => { process.stderr.write(d); output = (output + d.toString()).slice(-20000); });
+        child.on('error', () => resolve({ code: 127, output }));
+        child.on('close', (code) => resolve({ code: code ?? 1, output }));
+    });
+}
 /** 在 PATH 里找命令 */
 export async function which(cmd) {
     if (WIN) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-model",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Many model sources behind one authenticated OpenAI-compatible endpoint for DeepSeek Harness (dsh) and your tools: WorkBuddy, OpenCode Zen and your CLI subscriptions (Codex, Kimi…), with a management page inside dsh. 多家模型汇成一个 OpenAI 兼容地址，dsh 和其他软件都能直接用。",
   "keywords": [
     "dsh-plugin",
@@ -56,6 +56,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.19.43",
+    "jsdom": "^25.0.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "typescript": "^5.9.3",
     "vitest": "^3.2.7"
   },

package/plugin/client.js

@@ -289,20 +289,40 @@ window.__ModuleLoader__.load({
           s.status === 'pending' ? (msg || L('等待授权中…', 'Waiting for approval…')) : s.status === 'ok' ? L('已登录', 'Signed in') : `${L('登录没有完成', 'Login did not complete')}：${s.error || s.status}`))
     }
 
-    function KeyDialog({ onDone, onClose }) {
+    /** 填 API key：OpenCode Zen，以及 Gemini / Groq / OpenRouter / 硅基流动 / DeepSeek / 其他 OpenAI 兼容服务 */
+    function KeyDialog({ source, onDone, onClose }) {
+      const opencode = !source || source.kind === 'opencode'
+      const custom = source && source.id === 'custom'
       const [key, setKey] = useState('')
+      const [base, setBase] = useState('')
       const [busy, setBusy] = useState(false)
       const [msg, setMsg] = useState('')
       const submit = async () => {
         setBusy(true)
-        setMsg(L('正在用一个免费模型实测这把 key…', 'Testing the key against a free model…'))
-        try { await api('POST', '/opencode/key', { key: key.trim() }); onDone() } catch (e) { setMsg(e.message); setBusy(false) }
+        setMsg(opencode ? L('正在用一个免费模型实测这把 key…', 'Testing the key against a free model…') : L('正在用这把 key 读取模型列表…', 'Reading the model list with this key…'))
+        try {
+          if (opencode) await api('POST', '/opencode/key', { key: key.trim() })
+          else await api('POST', `/apikey/${source.id}`, { key: key.trim(), ...(custom ? { baseUrl: base.trim() } : {}) })
+          onDone()
+        } catch (e) {
+          setMsg(e.hint ? `${e.message}（${e.hint}）` : e.message)
+          setBusy(false)
+        }
       }
-      return h(Modal, { title: 'OpenCode Zen', onClose },
-        h('p', { style: S.note }, L('需要你的 OpenCode Zen API key（在 opencode.ai 免费注册）。写入前会先用一个免费模型实测。', 'Needs your OpenCode Zen API key (free sign-up at opencode.ai). It is tested against a free model first.')),
+      const label = opencode ? 'OpenCode Zen' : source.label
+      const link = opencode ? 'https://opencode.ai/auth' : source.subscribeUrl
+      return h(Modal, { title: label, onClose },
+        h('p', { style: S.note },
+          opencode
+            ? L('需要你的 OpenCode Zen API key（要先充值）。写入前会先用一个免费模型实测。', 'Needs your OpenCode Zen API key (top-up required). It is tested against a free model first.')
+            : custom
+              ? L('填服务的地址（以 /v1 结尾）和 API key。保存前会用它读取一次模型列表，读得到才保存。', 'Enter the service URL (ending in /v1) and the API key. It reads the model list once before saving.')
+              : L(`填 ${label} 的 API key。保存前会用它读取一次模型列表（不花额度），读得到才保存。${source.pricing ? source.pricing.zh + '。' : ''}`, `Enter your ${label} API key. It reads the model list once before saving (no quota used).${source.pricing ? ' ' + source.pricing.en + '.' : ''}`),
+          link ? h('a', { href: link, target: '_blank', rel: 'noopener noreferrer', style: { color: C.accent, marginLeft: 6 } }, L('去创建 key ↗', 'Create a key ↗')) : null),
+        custom ? h('div', { style: { ...S.line, marginBottom: 8 } }, h('input', { style: { ...S.input, ...S.grow }, placeholder: 'https://api.example.com/v1', value: base, onChange: (e) => setBase(e.target.value) })) : null,
         h('div', { style: S.line },
           h('input', { type: 'password', style: { ...S.input, ...S.grow }, placeholder: 'API key', value: key, onChange: (e) => setKey(e.target.value) }),
-          h('button', { type: 'button', style: S.btnPrimary, disabled: busy || !key.trim(), onClick: submit }, L('保存', 'Save'))),
+          h('button', { type: 'button', style: S.btnPrimary, disabled: busy || !key.trim() || (custom && !base.trim()), onClick: submit }, L('保存', 'Save'))),
         msg ? h('div', { style: { ...S.meta, marginTop: 8 } }, msg) : null)
     }
 
@@ -318,6 +338,16 @@ window.__ModuleLoader__.load({
       const [q, setQ] = useState('')
       const [msg, setMsg] = useState('')
       const [saving, setSaving] = useState(false)
+      const [tests, setTests] = useState({})
+      const test = async (id) => {
+        setTests((t) => ({ ...t, [id]: { running: true } }))
+        try {
+          const r = await api('POST', '/models/test', { model: id })
+          setTests((t) => ({ ...t, [id]: r }))
+        } catch (e) {
+          setTests((t) => ({ ...t, [id]: { ok: false, advice: e.message } }))
+        }
+      }
       useEffect(() => {
         let alive = true
         api('GET', `/sources/${source.id}/models`).then((r) => {
@@ -327,8 +357,6 @@ window.__ModuleLoader__.load({
         }, (e) => alive && setMsg(e.message))
         return () => { alive = false }
       }, [source.id])
-      if (selfJob) return h(SelfProgress, { job: selfJob, onDone: () => { setSelfJob(null); void load(true) } })
-      if (errCode === 'daemon_not_configured' || errCode === 'daemon_unreachable') return h(Onboarding, { code: errCode, onDone: () => void load(true) })
       if (!data) return h('div', { style: { ...S.meta, paddingLeft: 46, marginTop: 8 } }, msg || L('加载中…', 'Loading…'))
       const flip = (id) => setSel((x) => { const n = new Set(x); n.has(id) ? n.delete(id) : n.add(id); return n })
       const save = async (models) => {
@@ -351,7 +379,10 @@ window.__ModuleLoader__.load({
         h('div', { style: { maxHeight: 300, overflowY: 'auto' } }, shown.map((m) => h('label', { key: m.id, style: { ...S.line, minHeight: 26, fontSize: 13, cursor: 'pointer' } },
           h('input', { type: 'checkbox', checked: sel.has(m.id), onChange: () => flip(m.id) }),
           h('span', { style: S.grow }, m.name),
-          m.recommended ? h('span', { style: { fontSize: 11, color: C.accent } }, L('推荐', 'Suggested')) : null))),
+          m.recommended ? h('span', { style: { fontSize: 11, color: C.accent } }, L('推荐', 'Suggested')) : null,
+          tests[m.id] ? h('span', { style: { fontSize: 11, color: tests[m.id].running ? C.sub : tests[m.id].ok ? C.ok : C.err, maxWidth: 260, overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }, title: tests[m.id].message || tests[m.id].reply || '' },
+            tests[m.id].running ? L('测试中…', 'Testing…') : tests[m.id].ok ? L(`可用 · ${(tests[m.id].ms / 1000).toFixed(1)} 秒${tests[m.id].reply ? ` · ${tests[m.id].reply}` : ''}`, `OK · ${(tests[m.id].ms / 1000).toFixed(1)}s${tests[m.id].reply ? ` · ${tests[m.id].reply}` : ''}`) : (tests[m.id].advice || L('不可用', 'Not working'))) : null,
+          h('button', { type: 'button', style: { ...S.btn, padding: '2px 8px' }, disabled: tests[m.id]?.running, onClick: (e) => { e.preventDefault(); void test(m.id) } }, L('测一下', 'Test'))))),
         msg ? h('div', { style: { fontSize: 12, color: C.err, marginTop: 6 } }, msg) : null,
         h('div', { style: { ...S.line, marginTop: 8, flexWrap: 'wrap' } },
           h('button', { type: 'button', style: S.btnPrimary, disabled: saving, onClick: () => save([...sel]) }, saving ? L('保存中…', 'Saving…') : L('保存', 'Save')),
@@ -379,7 +410,7 @@ window.__ModuleLoader__.load({
         setBusy((b) => ({ ...b, [s.id]: true }))
         try {
           if (!on) await api('POST', `/sources/${s.id}/disable`)
-          else if (s.kind === 'opencode' && !s.loggedIn) onKey()
+          else if ((s.kind === 'opencode' || s.kind === 'apikey') && !s.loggedIn) onKey(s)
           else {
             let r = await api('POST', `/sources/${s.id}/enable`, {})
             if (r.riskNotice) {
@@ -396,7 +427,7 @@ window.__ModuleLoader__.load({
         }
       }
       const logout = async (s) => {
-        if (!window.confirm(L(`退出 ${s.label} 的登录？（它的模型会从 dsh 里消失）`, `Sign out of ${s.label}? (its models disappear from dsh)`))) return
+        if (!window.confirm(s.kind === 'apikey' ? L(`删除 ${s.label} 的 key？（它的模型会从 dsh 里消失）`, `Remove the ${s.label} key? (its models disappear from dsh)`) : L(`退出 ${s.label} 的登录？（它的模型会从 dsh 里消失）`, `Sign out of ${s.label}? (its models disappear from dsh)`))) return
         try { await api('POST', `/sources/${s.id}/logout`); await reload() } catch (e) { setErr(e.message) }
       }
       return h('div', { style: S.section },
@@ -417,10 +448,11 @@ window.__ModuleLoader__.load({
               s.risky ? h('span', { style: { fontSize: 11, color: C.err, marginLeft: 6, border: `1px solid ${C.err}`, borderRadius: 4, padding: '0 4px' } }, L('高风险', 'High risk')) : null,
               h('span', { style: { ...S.meta, marginLeft: 8 } },
                 s.loggedIn ? (s.account || '') : s.kind === 'local' ? L('未运行', 'Not running') : L('未登录', 'Signed out'),
-                s.models ? ` · ${L(`${s.models} 个模型`, `${s.models} models`)}` : '')),
+                s.models ? ` · ${L(`${s.models} 个模型`, `${s.models} models`)}` : '',
+                s.loggedIn && s.kind === 'apikey' && s.detail ? ` · ${s.detail}` : '')),
             s.loggedIn && s.enabled && s.models && !s.usage?.noAccess ? h('button', { type: 'button', style: S.btn, onClick: () => setPicking(picking === s.id ? '' : s.id) }, L('选模型', 'Models')) : null,
-            s.loggedIn && s.kind !== 'opencode' && s.kind !== 'local' ? h('button', { type: 'button', style: S.btn, onClick: () => logout(s) }, L('退出登录', 'Sign out')) : null,
-            s.kind === 'opencode' && s.loggedIn ? h('button', { type: 'button', style: S.btn, onClick: onKey }, L('换 key', 'Change key')) : null),
+            s.loggedIn && s.kind !== 'opencode' && s.kind !== 'local' ? h('button', { type: 'button', style: S.btn, onClick: () => logout(s) }, s.kind === 'apikey' ? L('删除 key', 'Remove key') : L('退出登录', 'Sign out')) : null,
+            (s.kind === 'opencode' || s.kind === 'apikey') && s.loggedIn ? h('button', { type: 'button', style: S.btn, onClick: () => onKey(s) }, L('换 key', 'Change key')) : null),
           picking === s.id ? h(ModelPicker, { source: s, onClose: (saved) => { setPicking(''); if (saved) void reload() } }) : null,
           s.enabled ? h(Usage, { usage: s.usage, subscribeUrl: s.subscribeUrl }) : null,
           !s.loggedIn && s.pricing ? h('div', { style: { ...S.meta, paddingLeft: 46, marginTop: 4 } },
@@ -485,6 +517,25 @@ window.__ModuleLoader__.load({
           h('button', { type: 'button', style: S.btnPrimary, disabled: !name.trim(), onClick: add }, L('新增 key', 'Add key'))))
     }
 
+    /** 最近 24 小时失败的请求：哪个模型、为什么、该怎么办（只有出过错才显示） */
+    function FailuresCard({ failures }) {
+      const [all, setAll] = useState(false)
+      if (!failures || !failures.length) return null
+      const color = (k) => (k === 'rate' || k === 'upstream' ? C.warn : C.err)
+      const shown = all ? failures : failures.slice(0, 5)
+      return h('div', { style: S.section },
+        h('div', { style: S.h }, L(`最近失败（24 小时内 ${failures.length} 次）`, `Recent failures (${failures.length} in 24 hours)`)),
+        h('p', { style: S.note }, L('经统一端点失败的请求。只记录模型和报错，不记录对话内容。', 'Requests that failed through the endpoint. Only the model and the error are kept, never the conversation.')),
+        h('div', { style: S.card }, shown.map((f, i) => h('div', { key: `${f.at}-${i}`, style: i ? S.row : S.rowFirst },
+          h('div', { style: S.line },
+            h('span', { style: { ...S.label, ...S.mono, ...S.grow, fontSize: 13 } }, f.model || L('（未知模型）', '(unknown model)')),
+            h('span', { style: { fontSize: 12, color: color(f.kind) } }, `HTTP ${f.status}`),
+            h('span', { style: S.meta }, ago(f.at))),
+          h('div', { style: { fontSize: 13, color: color(f.kind), marginTop: 2 } }, f.advice),
+          f.message ? h('div', { style: { ...S.meta, ...S.mono, marginTop: 2, wordBreak: 'break-all' } }, f.message) : null))),
+        failures.length > 5 ? h('button', { type: 'button', style: { ...S.btn, marginTop: 8 }, onClick: () => setAll(!all) }, all ? L('收起', 'Show less') : L(`全部 ${failures.length} 条`, `All ${failures.length}`)) : null)
+    }
+
     function ModelsCard({ stats }) {
       const rows = Object.entries(stats?.byModel || {}).sort((a, b) => b[1].d1.requests - a[1].d1.requests).slice(0, 30)
       if (!rows.length) return null
@@ -508,18 +559,29 @@ window.__ModuleLoader__.load({
       const [res, setRes] = useState(null)
       const notInstalled = code === 'daemon_not_configured'
       const action = notInstalled ? 'setup' : 'repair'
+      const setupCall = async (body, retried) => {
+        const r = await fetch('/api-dsh-model/setup', {
+          method: 'POST',
+          credentials: 'same-origin',
+          headers: { 'content-type': 'application/json', 'x-dsh-model-token': token },
+          body: JSON.stringify(body),
+        })
+        const j = await r.json().catch(() => ({}))
+        if (r.status === 403 && !retried && j?.error?.code === 'refused') { await refreshToken(); return setupCall(body, true) }
+        return j
+      }
       const run = async () => {
         setBusy(true)
         setRes(null)
         try {
-          const r = await fetch('/api-dsh-model/setup', {
-            method: 'POST',
-            credentials: 'same-origin',
-            headers: { 'content-type': 'application/json', 'x-dsh-model-token': token },
-            body: JSON.stringify({ action, lang: isZh() ? 'zh' : 'en' }),
-          })
-          const j = await r.json().catch(() => ({}))
-          if (r.status === 403 && j?.error?.code === 'refused') { await refreshToken(); setBusy(false); return run() }
+          let j = await setupCall({ action, lang: isZh() ? 'zh' : 'en' })
+          if (j.vps) { setRes(j); return }
+          // 每秒取一次新输出，一行一行显示出来
+          while (j.running) {
+            setRes({ ...j, code: null })
+            await new Promise((r) => setTimeout(r, 1000))
+            j = await setupCall({ poll: true })
+          }
           setRes(j)
           if (j.code === 0) setTimeout(onDone, 1500)
         } catch (e) {
@@ -547,7 +609,7 @@ window.__ModuleLoader__.load({
             h('p', { style: { ...S.note, marginTop: 10 } }, L('也可以在终端里执行：', 'Or run in a terminal:')),
             cmdBlock(cmds)),
           res && !res.vps ? h('div', { style: { marginTop: 12 } },
-            h('div', { style: { fontSize: 12, color: res.code === 0 ? C.ok : C.err, marginBottom: 6 } }, res.code === 0 ? L('完成，正在加载…', 'Done, loading…') : L(`没有完成（退出码 ${res.code}），输出如下：`, `Did not finish (exit code ${res.code}); output:`)),
+            h('div', { style: { fontSize: 12, color: res.code === null ? C.sub : res.code === 0 ? C.ok : C.err, marginBottom: 6 } }, res.code === null ? L('进行中…', 'Working…') : res.code === 0 ? L('完成，正在加载…', 'Done, loading…') : L(`没有完成（退出码 ${res.code}），输出如下：`, `Did not finish (exit code ${res.code}); output:`)),
             h('pre', { style: { ...S.mono, ...S.card, padding: 10, maxHeight: 260, overflow: 'auto', whiteSpace: 'pre-wrap', margin: 0 } }, res.output || '')) : null))
     }
 
@@ -654,19 +716,161 @@ window.__ModuleLoader__.load({
           state.phase === 'done' && upd ? h('button', { type: 'button', style: { ...S.btn, marginTop: 10 }, onClick: onDone }, L('返回', 'Back')) : null))
     }
 
+    /** 调宿主自己的接口（不经守护进程）：/api-dsh-model/host */
+    async function hostCall(body, retried) {
+      const r = await fetch('/api-dsh-model/host', {
+        method: 'POST',
+        credentials: 'same-origin',
+        headers: { 'content-type': 'application/json', 'x-dsh-model-token': token },
+        body: JSON.stringify(body),
+      })
+      const j = await r.json().catch(() => ({}))
+      if (r.status === 403 && !retried && j?.error?.code === 'refused') {
+        await refreshToken()
+        return hostCall(body, true)
+      }
+      if (!r.ok) throw new Error(j?.error?.message || `HTTP ${r.status}`)
+      return j
+    }
+
+    /** 插件已更新、但 dsh 还在跑旧代码：顶部提示，VPS 上可一键重启 */
+    function RestartBanner({ host }) {
+      const [state, setState] = useState('')
+      if (!host || !host.installed || !host.running || host.installed === host.running) return null
+      const restart = async () => {
+        if (!window.confirm(L('重启 dsh？正在进行的对话会中断，大约十几秒后自动恢复。', 'Restart dsh? Ongoing conversations are interrupted; it comes back in about ten seconds.'))) return
+        setState('restarting')
+        try {
+          await hostCall({ action: 'restart' })
+        } catch (e) {
+          setState(e.message)
+          return
+        }
+        // 等它停下再起来：先连不上，再连得上，就刷新页面
+        let wasDown = false
+        for (let i = 0; i < 120; i++) {
+          await new Promise((r) => setTimeout(r, 1000))
+          const up = await fetch('/', { credentials: 'same-origin', cache: 'no-store' }).then((r) => r.ok || r.status === 401 || r.status === 302, () => false)
+          if (!up) wasDown = true
+          else if (wasDown) { window.location.reload(); return }
+        }
+        window.location.reload()
+      }
+      return h('div', { style: { ...S.card, padding: '10px 14px', marginBottom: 16, borderColor: C.warn } },
+        h('div', { style: S.line },
+          h('span', { style: { ...S.grow, fontSize: 13, color: C.text } },
+            L(`dsh-model 已更新到 ${host.installed}，但 dsh 还在运行 ${host.running} 的代码，重启 dsh 后生效。`, `dsh-model was updated to ${host.installed}, but dsh is still running ${host.running}; restart dsh to apply it.`),
+            host.restart === 'desktop' ? h('span', { style: { color: C.sub } }, L('请完全退出 dsh（Windows 上连同右下角托盘的图标）再打开。', ' Quit dsh completely (on Windows, the tray icon too) and open it again.')) : null,
+            host.restart === 'manual' ? h('span', { style: { color: C.sub } }, L('请重启 dsh。', ' Please restart dsh.')) : null),
+          host.restart === 'vps' ? h('button', { type: 'button', style: S.btnPrimary, disabled: state === 'restarting', onClick: () => void restart() }, state === 'restarting' ? L('正在重启…', 'Restarting…') : L('重启 dsh', 'Restart dsh')) : null),
+        state && state !== 'restarting' ? h('div', { style: { fontSize: 12, color: C.err, marginTop: 6 } }, state) : null)
+    }
+
+    // —— 额度提醒（dsh 任何页面的右下角）——
+    /** 额度快用完的来源：积分剩 10% 以下，或某个窗口用了 90% 以上 */
+    function lowQuota(list) {
+      const out = []
+      for (const u of list || []) {
+        if (u.error || u.noAccess) continue
+        const label = u.label || u.source
+        const c = u.credits
+        if (c && !c.unlimited && c.total > 0 && c.remaining / c.total <= 0.1) {
+          const pct = Math.max(0, Math.round((c.remaining / c.total) * 100))
+          out.push({ key: `${u.source}:credits:${pct <= 0 ? 0 : 10}`, text: L(`${label} 积分只剩 ${pct}%（${c.remaining.toLocaleString()} / ${c.total.toLocaleString()}）`, `${label} credits are down to ${pct}% (${c.remaining.toLocaleString()} / ${c.total.toLocaleString()})`) })
+        }
+        for (const w of u.windows || []) {
+          if (w.usedPercent != null && w.usedPercent >= 90) {
+            out.push({ key: `${u.source}:${w.id}:${w.usedPercent >= 100 ? 100 : 90}`, text: L(`${label} 的 ${w.label} 额度已用 ${Math.round(w.usedPercent)}%${w.resetAt ? `，${until(w.resetAt)}` : ''}`, `${label} ${w.label} quota is ${Math.round(w.usedPercent)}% used${w.resetAt ? `, ${until(w.resetAt)}` : ''}`) })
+          }
+        }
+      }
+      return out
+    }
+    const DISMISS_KEY = 'dsh-model.quotaDismissed'
+    const readDismissed = () => {
+      try { return JSON.parse(window.localStorage.getItem(DISMISS_KEY) || '{}') } catch { return {} }
+    }
+    function QuotaNotice() {
+      const [alerts, setAlerts] = useState([])
+      const [dismissed, setDismissed] = useState(readDismissed)
+      useEffect(() => {
+        let stop = false
+        const tick = () => api('GET', '/usage').then((u) => { if (!stop) setAlerts(lowQuota(u)) }, () => {})
+        void tick()
+        const t = setInterval(tick, 5 * 60 * 1000)
+        return () => { stop = true; clearInterval(t) }
+      }, [])
+      const now = Date.now()
+      const shown = alerts.filter((a) => !(dismissed[a.key] && now - dismissed[a.key] < 24 * 60 * 60 * 1000))
+      if (!shown.length) return null
+      const dismiss = () => {
+        const next = { ...dismissed }
+        for (const a of shown) next[a.key] = Date.now()
+        setDismissed(next)
+        try { window.localStorage.setItem(DISMISS_KEY, JSON.stringify(next)) } catch { /* 无痕模式：只在本次生效 */ }
+      }
+      return h('div', { role: 'status', style: { position: 'fixed', right: 16, bottom: 16, zIndex: 900, maxWidth: 360, background: C.base, color: C.text, border: `1px solid ${C.warn}`, borderRadius: 10, padding: '10px 12px', boxShadow: 'var(--dsw-elevation-soft, 0 8px 30px rgba(0,0,0,.2))', fontSize: 13 } },
+        h('div', { style: { fontWeight: 600, marginBottom: 4, color: C.warn } }, L('dsh-model：额度快用完了', 'dsh-model: quota running low')),
+        shown.map((a) => h('div', { key: a.key, style: { lineHeight: 1.6 } }, a.text)),
+        h('div', { style: { ...S.line, marginTop: 6, justifyContent: 'flex-end' } }, h('button', { type: 'button', style: S.btn, onClick: dismiss }, L('知道了', 'Got it'))))
+    }
+
+    // —— 首次使用向导 ——
+    const GUIDE_KEY = 'dsh-model.guideDone'
+    const readGuideDone = () => {
+      try { return window.localStorage.getItem(GUIDE_KEY) === '1' } catch { return false }
+    }
+    /** 刚装好、接入的来源少于两个时显示：先接一个免费来源 → 模型已经挑好 → 去 dsh 里用 */
+    function Guide({ sources, onConnect }) {
+      const [done, setDone] = useState(readGuideDone)
+      const connected = sources.filter((s) => s.loggedIn && s.enabled)
+      if (done || connected.length >= 2) return null
+      const free = sources.filter((s) => !s.risky && !(s.loggedIn && s.enabled) && s.pricing && s.pricing.tier !== 'paid')
+      const hide = () => {
+        setDone(true)
+        try { window.localStorage.setItem(GUIDE_KEY, '1') } catch { /* 无痕模式：只在本次生效 */ }
+      }
+      const step = (n, title, body) => h('div', { style: { display: 'flex', gap: 10, marginTop: n > 1 ? 12 : 0 } },
+        h('div', { style: { width: 22, height: 22, borderRadius: 11, background: C.accent, color: C.accentFg, fontSize: 12, display: 'flex', alignItems: 'center', justifyContent: 'center', flex: 'none' } }, String(n)),
+        h('div', { style: S.grow }, h('div', { style: { ...S.label, marginBottom: 2 } }, title), body))
+      return h('div', { style: { ...S.section } },
+        h('div', { style: { ...S.card, padding: 14, borderColor: C.accent } },
+          h('div', { style: { ...S.line, marginBottom: 10 } },
+            h('div', { style: { ...S.h, ...S.grow, margin: 0 } }, L('开始使用', 'Getting started')),
+            h('button', { type: 'button', style: S.btn, onClick: hide }, L('我知道了，不再显示', 'Got it, hide this'))),
+          step(1, L('接入一个免费来源', 'Connect a free source'),
+            h('div', null,
+              h('div', { style: S.meta }, L('先接一个就能用。标「免费·额度少」的要先去对方网站拿一把免费 key。', 'One is enough to start. "Free · limited" ones need a free key from their website first.')),
+              h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 6, marginTop: 6 } },
+                free.slice(0, 8).map((s) => h('button', { key: s.id, type: 'button', style: S.btn, onClick: () => onConnect(s) }, `${s.label}${s.pricing.tier === 'free' ? L(' · 免费', ' · free') : ''}`))))),
+          step(2, L('模型已经替你挑好', 'Models are picked for you'),
+            h('div', { style: S.meta }, L('每个来源默认挑 5 个放进 dsh（免费的优先）。想换就在下面「来源」里点「选模型」。', 'Each source puts 5 suggested models into dsh (free ones first). Change them with "Models" under Sources below.'))),
+          step(3, L('去用', 'Use it'),
+            h('div', { style: S.meta }, L('在 dsh 的模型列表里，选来源分组下的任意模型就能开始对话。其他软件用下面的「访问地址」和 API key。', 'In dsh\'s model list, pick any model under a source group. Other tools use the endpoint and an API key below.')))))
+    }
+
     // —— 整页 ——
     function SettingsSection() {
       const [data, setData] = useState(null)
       const [err, setErr] = useState('')
       const [errCode, setErrCode] = useState('')
       const [selfJob, setSelfJob] = useState(null)
+      const [host, setHost] = useState(null)
+      useEffect(() => {
+        let stop = false
+        const check = () => hostCall({}).then((r) => { if (!stop) setHost(r) }, () => {})
+        void check()
+        const t = setInterval(check, 60_000)
+        return () => { stop = true; clearInterval(t) }
+      }, [])
+      const banner = h(RestartBanner, { host })
       const [login, setLogin] = useState(null)
       const [keyDialog, setKeyDialog] = useState(false)
       const alive = useRef(true)
       const load = useCallback(async (refresh) => {
         try {
-          const [sources, keys, stats, endpoints] = await Promise.all([api('GET', refresh ? '/sources?refresh=1' : '/sources'), api('GET', '/keys'), api('GET', '/stats'), api('GET', '/endpoints').catch(() => null)])
-          if (alive.current) { setData({ sources, keys, stats, endpoints }); setErr(''); setErrCode('') }
+          const [sources, keys, stats, endpoints, failures] = await Promise.all([api('GET', refresh ? '/sources?refresh=1' : '/sources'), api('GET', '/keys'), api('GET', '/stats'), api('GET', '/endpoints').catch(() => null), api('GET', '/failures').catch(() => null)])
+          if (alive.current) { setData({ sources, keys, stats, endpoints, failures }); setErr(''); setErrCode('') }
         } catch (e) {
           if (alive.current) { setErr(e.hint ? `${e.message}（${e.hint}）` : e.message); setErrCode(e.code || '') }
         }
@@ -677,16 +881,37 @@ window.__ModuleLoader__.load({
         const t = setInterval(() => void load(false), 15000)
         return () => { alive.current = false; clearInterval(t) }
       }, [load])
+      // 更新 / 卸载进行中、服务没装或没在运行：整页换成对应的卡片（不能只显示一行错误）
+      if (selfJob) return h(SelfProgress, { job: selfJob, onDone: () => { setSelfJob(null); void load(true) } })
+      if (errCode === 'daemon_not_configured' || errCode === 'daemon_unreachable') return h('div', null, banner, h(Onboarding, { code: errCode, onDone: () => void load(true) }))
       if (!data) return h('div', { style: { fontSize: 13, color: err ? C.err : C.sub, padding: '8px 0' } }, err || L('加载中…', 'Loading…'))
+      // 向导里的「接入」：和来源开关打开时一样（要 key 的弹 key，要登录的弹登录）
+      const connect = async (s) => {
+        if ((s.kind === 'opencode' || s.kind === 'apikey') && !s.loggedIn) { setKeyDialog(s); return }
+        try {
+          let r = await api('POST', `/sources/${s.id}/enable`, {})
+          if (r.riskNotice) {
+            if (!window.confirm(r.riskNotice)) return
+            r = await api('POST', `/sources/${s.id}/enable`, { acceptRisk: true })
+          }
+          if (r.login) setLogin({ source: s, session: r.login })
+          await load(false)
+        } catch (e) {
+          setErr(`${s.label}：${e.message}${e.hint ? `（${e.hint}）` : ''}`)
+        }
+      }
       return h('div', { style: { color: C.text, maxWidth: 820 } },
+        banner,
+        h(Guide, { sources: data.sources, onConnect: (s) => void connect(s) }),
         err ? h('div', { style: { fontSize: 12, color: C.err, marginBottom: 12 } }, err) : null,
         h(EndpointCard, { endpoints: data.endpoints }),
-        h(SourcesCard, { sources: data.sources, reload: () => load(false), onLogin: (s, session) => setLogin({ source: s, session }), onKey: () => setKeyDialog(true) }),
+        h(SourcesCard, { sources: data.sources, reload: () => load(false), onLogin: (s, session) => setLogin({ source: s, session }), onKey: (s) => setKeyDialog(s || true) }),
+        h(FailuresCard, { failures: data.failures }),
         h(KeysCard, { keys: data.keys, reload: () => load(false) }),
         h(ModelsCard, { stats: data.stats }),
         h(AboutCard, { onJob: setSelfJob }),
         login ? h(LoginDialog, { source: login.source, session: login.session, onDone: () => { setLogin(null); void load(true) }, onClose: () => { setLogin(null); void load(false) } }) : null,
-        keyDialog ? h(KeyDialog, { onDone: () => { setKeyDialog(false); void load(true) }, onClose: () => setKeyDialog(false) }) : null)
+        keyDialog ? h(KeyDialog, { source: keyDialog === true ? null : keyDialog, onDone: () => { setKeyDialog(false); void load(true) }, onClose: () => setKeyDialog(false) }) : null)
     }
 
     const name = 'dsh-model'
@@ -699,9 +924,15 @@ window.__ModuleLoader__.load({
       } catch (error) {
         console.warn('[dsh-model] 设置页注册失败', error)
       }
+      // 额度提醒挂在整个窗口的浮层上（不只设置页）；注册失败不影响别的
+      try {
+        ctx.slots.inject('shell.overlay', () => ctx.slots.register({ name: 'shell.overlay', id: 'dsh-model-quota' }, QuotaNotice))
+      } catch (error) {
+        console.warn('[dsh-model] 额度提醒注册失败', error)
+      }
     }
 
-    module.exports = { name, inject, apply, __test: { until, pct, ms } }
+    module.exports = { name, inject, apply, __test: { until, pct, ms, lowQuota } }
     return module.exports
   },
 })