sintbot 1.0.10 → 1.0.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sintbot",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Drive headless Claude Code (or Codex) from Slack / Feishu / WeCom group chats — one group, one project, swappable model brain. A standalone daemon, not a Claude Code plugin.",
   "bin": {
     "sbot": "bin/sbot.js",

package/src/clilang.js

@@ -0,0 +1,31 @@
+// 命令行输出语言(安装向导、服务安装这些新用户第一眼看到的输出;其余命令仍是中文)。
+// 判据与 install.sh 的 detect_lang 一致:SINTBOT_LANG=zh|en 优先;否则 locale(LC_ALL / LC_MESSAGES / LANG)
+// 或 macOS 系统语言(AppleLanguages 第一项)有一处是中文就用中文,其余英文。
+// 为什么看系统语言:不少人在 ~/.zshenv 里写死 LANG=en_US.UTF-8(工具链兼容),界面却是中文 ——
+// 1.0.11 实装时安装脚本因此出英文、向导是中文,同一屏两种语言。
+const { spawnSync } = require('node:child_process')
+
+let macCache
+function macLanguage({ platform = process.platform, run = spawnSync } = {}) {
+  if (platform !== 'darwin') return ''
+  if (macCache !== undefined) return macCache
+  try {
+    const r = run('defaults', ['read', '-g', 'AppleLanguages'], { encoding: 'utf8', timeout: 2000 })
+    const m = String((r && r.stdout) || '').match(/"?([A-Za-z]{2,3})[-_A-Za-z]*"?/)
+    macCache = m ? m[1].toLowerCase() : ''
+  } catch { macCache = '' }
+  return macCache
+}
+
+function cliLang({ env = process.env, platform = process.platform, run } = {}) {
+  const forced = String(env.SINTBOT_LANG || '').toLowerCase()
+  if (forced === 'zh' || forced === 'en') return forced
+  const locale = env.LC_ALL || env.LC_MESSAGES || env.LANG || ''
+  if (/^zh/i.test(locale)) return 'zh'
+  return macLanguage({ platform, run }) === 'zh' ? 'zh' : 'en'
+}
+
+// tr('中文', 'English') —— 按当前语言取一句
+const tr = (zh, en, lang = cliLang()) => (lang === 'zh' ? zh : en)
+
+module.exports = { cliLang, tr, _resetCache: () => { macCache = undefined } }

package/src/config.js

@@ -11,6 +11,7 @@
 const fs = require('node:fs')
 const path = require('node:path')
 const os = require('node:os')
+const net = require('node:net')
 const { DEFAULT_TZ, normalizeTz } = require('./core/time')
 const { resolveProjectsRoots, expandHome } = require('./projectsroot')
 const { setKnownSecrets } = require('./core/redact')
@@ -210,10 +211,11 @@ function deriveNoProxy(providers) {
   for (const p of Object.values(providers || {})) {
     if (!p || !p.baseUrl) continue
     try {
-      const h = new URL(p.baseUrl).hostname
+      const h = new URL(p.baseUrl).hostname.replace(/^\[|\]$/g, '')
       hosts.add(h)
+      // IP 不取后两段:127.0.0.1 会变出一条 `*.0.1`(1.0.11 实装时 NO_PROXY 里真出现过)
       const parts = h.split('.')
-      if (parts.length > 2) hosts.add('*.' + parts.slice(-2).join('.'))
+      if (!net.isIP(h) && parts.length > 2) hosts.add('*.' + parts.slice(-2).join('.'))
     } catch { /* skip malformed baseUrl */ }
   }
   return [...hosts].join(',')

package/src/core/proxy.js

@@ -417,6 +417,7 @@ function proxyDescribe(env = process.env) {
 }
 
 module.exports = {
+  PROXY_ENV_KEYS: [...PROXY_KEYS, ...NO_PROXY_KEYS],
   proxyFromEnv, noProxyFromEnv, proxyWarning, shouldBypass,
   TunnelAgent, createProxyFetch,
   getProxyFetch, getProxyAgent, resetProxy, proxyDescribe,

package/src/core/verify.js

@@ -85,5 +85,6 @@ function when(at, now = Date.now()) {
 // 试跑一轮用的提示词(向导试跑与控制台「模型 → 测试」共用)。不让模型自报身份:走 Claude Code 的第三方模型
 // 常照系统提示自称 Claude,新用户会以为没切成;型号由调用方按配置显示
 const TRIAL_PROMPT = '用一句话回复,说明你已准备好开始工作。'
+const TRIAL_PROMPT_EN = 'Reply in one sentence that you are ready to start working.' // 英文向导用
 
-module.exports = { fingerprint, providerFp, feishuFp, slackFp, lookup, record, recordTurn, recordPrecheck, when, REFRESH_MS, TRIAL_PROMPT }
+module.exports = { fingerprint, providerFp, feishuFp, slackFp, lookup, record, recordTurn, recordPrecheck, when, REFRESH_MS, TRIAL_PROMPT, TRIAL_PROMPT_EN }

package/src/design.js

@@ -3154,16 +3154,18 @@ function _landingSentence(v, { mobile = false } = {}) {
 //     误报成「描边不合规」,而误报会让整份报告被无视(v0.11.29 间距/阴影不测是同一条理由)。
 // ⚠ `dirs` 从字符串数组改成结构:一个目录是什么形态、什么字重、文件名带什么后缀,**都得显式声明**,
 //   不能再靠对路径做正则(phosphor 的 fill 目录叫 `fill` 不叫 `filled`,正则当场就错)。
+// mb = 装好后实际占的磁盘(2026-10 在 macOS 上 du 实测;几千个小文件按块计,比 npm 报的 unpackedSize 大一倍多)。
+// 向导问「要不要代装」时报合计,版本变了会有出入
 const ICON_LIBS = {
   // lucide 与 tabler 的分发文件属性逐字相同(24 网格 / fill:none / stroke:currentColor / 2 / round),
   // **参数同构才是混用的依据** —— 检查按参数判、不按库名判,兜底也只在同构的两套之间成立。
-  lucide: { pkg: 'lucide-static', label: 'Lucide', license: 'ISC', form: 'stroke', grid: 24, dirs: [{ dir: 'icons', style: 'outlined' }] },
-  tabler: { pkg: '@tabler/icons', label: 'Tabler', license: 'MIT', form: 'stroke', grid: 24, dirs: [{ dir: 'icons/outline', style: 'outlined' }, { dir: 'icons/filled', style: 'filled' }] },
+  lucide: { pkg: 'lucide-static', mb: 66, label: 'Lucide', license: 'ISC', form: 'stroke', grid: 24, dirs: [{ dir: 'icons', style: 'outlined' }] },
+  tabler: { pkg: '@tabler/icons', mb: 49, label: 'Tabler', license: 'MIT', form: 'stroke', grid: 24, dirs: [{ dir: 'icons/outline', style: 'outlined' }, { dir: 'icons/filled', style: 'filled' }] },
   // ⚠ phosphor:**六个字重是六套独立几何**(不是同一套图的粗细参数),且 regular 档文件名无后缀、
   //   其余带 `-{字重}` 后缀(`gear.svg` / `gear-bold.svg`)—— 这是 `suffix` 字段存在的唯一理由。
   //   duotone 用两条 path + opacity 0.2 做副色,副色仍继承 currentColor(不是第二种颜色)。
   phosphor: {
-    pkg: '@phosphor-icons/core', label: 'Phosphor', license: 'MIT', form: 'fill', grid: 256,
+    pkg: '@phosphor-icons/core', mb: 37, label: 'Phosphor', license: 'MIT', form: 'fill', grid: 256,
     dirs: [
       { dir: 'assets/thin', style: 'outlined', weight: 'thin', suffix: '-thin' },
       { dir: 'assets/light', style: 'outlined', weight: 'light', suffix: '-light' },
@@ -3175,7 +3177,7 @@ const ICON_LIBS = {
   },
   // ⚠ pixelart:实心变体是**同目录 `-solid` 后缀**(不是子目录),而且**只覆盖 53/651**(实测)
   //   ⇒ 系统那边**不声明支持实心** —— 声明了就是句假话,八成的名字取不到实心。
-  pixelart: { pkg: 'pixelarticons', label: 'Pixelarticons', license: 'MIT', form: 'fill', grid: 24, dirs: [{ dir: 'svg', style: 'outlined' }] },
+  pixelart: { pkg: 'pixelarticons', mb: 15, label: 'Pixelarticons', license: 'MIT', form: 'fill', grid: 24, dirs: [{ dir: 'svg', style: 'outlined' }] },
 }
 // ── 图标系统(v0.11.53)= 与设计风格**平级**的实体 ────────────────────────────
 // **图标系统 = 图形从哪来 + 叫什么名 + 怎么起名;风格 = 我用哪套 + 怎么画它。**

package/src/health.js

@@ -277,10 +277,10 @@ async function checkHealth(cfg, opts = {}) {
       if (!cfg.feishu.botOpenId) add('warn', 'feishu.botOpenId', (cfg.feishu.onlyWhenMentioned
         ? '没填 — 开着「只在 @ 时回复」却认不出哪个 @ 是机器人,群里一条都不会回'
         : '没填 — 分不清 @机器人 和 @别人,群里 @ 别人的消息也会接') + ';重跑 sintbot setup 选飞书预检可自动填')
-    } else if (!hasId && !hasSecret) { if (!plat.wecom && !plat.slack) add('warn', 'platforms', '没配任何聊天平台 — sintbot start 收不到消息') }
+    } else if (!hasId && !hasSecret) { if (!plat.wecom && !plat.slack) add('warn', 'platforms', '还没接聊天平台 — 在控制台「设置」里接飞书 / Slack / 企业微信') }
     else add('fail', 'feishu', hasId ? '缺 appSecret' : '缺 appId')
   } else if (!plat.wecom && !plat.slack) {
-    add('warn', 'platforms', '没配任何聊天平台 — sintbot start 收不到消息')
+    add('warn', 'platforms', '还没接聊天平台 — 在控制台「设置」里接飞书 / Slack / 企业微信')
   }
   // 写了 wecom 块就要报:env: 引用解析成空串也算缺(真机踩到 —— 非交互 shell 没 source 凭据文件,doctor 一声不吭地把群报成「没配企微」)
   if (cfg.wecom) {

package/src/installdeps.js

@@ -21,8 +21,9 @@ function chooseRegistry(configured, officialReachable) {
   return { registry: MIRROR, reason: 'mirror' }
 }
 
+// pkg 可以是一个包名,也可以是一组(设计图标库四个包一条命令装齐)
 function installArgs(pkg, registry) {
-  return ['install', '-g', pkg, ...(registry ? ['--registry', registry] : [])]
+  return ['install', '-g', ...[].concat(pkg), ...(registry ? ['--registry', registry] : [])]
 }
 
 function runNpm(args, opts = {}) {
@@ -55,6 +56,11 @@ function globalPrefix(run = runNpm) {
 function installGlobal(name, { run = runNpm, log = () => {} } = {}) {
   const pkg = PACKAGES[name]
   if (!pkg) throw new Error(`unknown package: ${name}`)
+  return installPackages(pkg, { run, log })
+}
+
+// 按包名装(一个或一组),选源同上。只给向导装确定的包用(Claude Code / Codex / 设计图标库),不接用户输入的名字
+function installPackages(pkg, { run = runNpm, log = () => {} } = {}) {
   const { registry, reason } = pickRegistry(run)
   if (reason === 'mirror') log(`npm 官方源连不上,改用国内镜像 ${MIRROR}`)
   const args = installArgs(pkg, registry)
@@ -63,4 +69,4 @@ function installGlobal(name, { run = runNpm, log = () => {} } = {}) {
   return { ok: r.status === 0, pkg, registry, code: r.status }
 }
 
-module.exports = { OFFICIAL, MIRROR, PACKAGES, isOfficial, chooseRegistry, installArgs, pickRegistry, globalPrefix, installGlobal }
+module.exports = { OFFICIAL, MIRROR, PACKAGES, isOfficial, chooseRegistry, installArgs, pickRegistry, globalPrefix, installGlobal, installPackages }

package/src/service.js

@@ -78,6 +78,10 @@ function envRefs(obj, out = []) {
   return out
 }
 
+// 服务托管标记:守护进程据此知道「退出了会被 launchd / systemd 拉起」—— 还没接平台时只开控制台,
+// 第一次接上平台就自己退出、重启后连上(bin/sbot.js cmdStart)。前台跑的 sintbot start 没有它
+const SUPERVISED_ENV = 'SBOT_SUPERVISED'
+
 // 服务的全部事实(纯数据):各平台单元文件都从这里生成。env = 额外写进单元文件的环境变量(--pass-env)
 function serviceSpec({ nodeBin, sbotBin, configPath, uiHost, home, pathEnv, env = {} }) {
   const args = [sbotBin, 'start', '--ui', '--no-open']
@@ -103,7 +107,8 @@ ${arr}
   <key>EnvironmentVariables</key>
   <dict>
     <key>PATH</key><string>${xmlEsc(spec.pathEnv)}</string>
-${Object.entries(spec.env || {}).map(([k, v]) => `    <key>${xmlEsc(k)}</key><string>${xmlEsc(v)}</string>\n`).join('')}  </dict>
+${Object.entries(spec.env || {}).map(([k, v]) => `    <key>${xmlEsc(k)}</key><string>${xmlEsc(v)}</string>\n`).join('')}    <key>${SUPERVISED_ENV}</key><string>1</string>
+  </dict>
   <key>RunAtLoad</key><true/>
   <key>KeepAlive</key><true/>
   <key>ThrottleInterval</key><integer>15</integer>
@@ -124,7 +129,8 @@ Wants=network-online.target
 ExecStart=${[spec.nodeBin, ...spec.args].map(sdQuote).join(' ')}
 WorkingDirectory=${sdQuote(spec.workdir)}
 Environment=${sdQuote('PATH=' + spec.pathEnv)}
-${Object.entries(spec.env || {}).map(([k, v]) => `Environment=${sdQuote(k + '=' + v)}\n`).join('')}Restart=always
+${Object.entries(spec.env || {}).map(([k, v]) => `Environment=${sdQuote(k + '=' + v)}\n`).join('')}Environment=${SUPERVISED_ENV}=1
+Restart=always
 RestartSec=15
 KillSignal=SIGTERM
 TimeoutStopSec=30
@@ -238,4 +244,4 @@ function uninstall({ platform = process.platform, home = os.homedir() } = {}) {
   return { file, removed, steps }
 }
 
-module.exports = { LABEL, UNIT, xmlEsc, sdQuote, buildPath, versionedPath, stableNodeBin, envRefs, serviceSpec, launchdPlist, systemdUnit, unitPath, render, windowsHint, status, install, restart, uninstall }
+module.exports = { LABEL, UNIT, SUPERVISED_ENV, xmlEsc, sdQuote, buildPath, versionedPath, stableNodeBin, envRefs, serviceSpec, launchdPlist, systemdUnit, unitPath, render, windowsHint, status, install, restart, uninstall }

package/src/setupmodels.js

@@ -2,19 +2,20 @@
 // 向导本身在 bin/sbot.js(交互、读写配置);这里只放可单测的部分。
 //
 // 推荐顺序(2026-10-19 定):有 Claude 订阅 → 用 Claude;有 ChatGPT(Codex)→ 用 Codex;都没有 → 推荐 DeepSeek。
-// 地区只决定两件事:同一家用中国站还是国际站的端点,以及要不要代理。
+// 1.0.12 起向导不问「在不在中国大陆」(用户 10-28 定:那是隐私)。有国际站的厂商先按时区试一个站,认证失败自动换另一个站再试。
+// 文案带英文(en),中英文由 src/clilang.js 决定。
 
 // 用 API key 的预设(名字与 sbot.config.example.json 的 providers 键一致)。
 // intl:有国际站的厂商,key 在哪个站开的就得连哪个站,填错站点会 401。
 const PROVIDER_INFO = {
-  deepseek: { label: 'DeepSeek', site: 'https://platform.deepseek.com', billing: '按量付费' },
-  glm: { label: '智谱 GLM', site: 'https://open.bigmodel.cn', billing: '按量或包月 GLM Coding Plan', intl: { label: 'Z.ai', site: 'https://z.ai', baseUrl: 'https://api.z.ai/api/anthropic' } },
-  minimax: { label: 'MiniMax', site: 'https://platform.minimaxi.com', billing: '按量或包月 Token Plan', intl: { label: 'MiniMax 国际站', site: 'https://platform.minimax.io', baseUrl: 'https://api.minimax.io/anthropic' } },
-  volcano: { label: '火山方舟', site: 'https://console.volcengine.com/ark', billing: '包月 Coding Plan,只有中国站' },
+  deepseek: { label: 'DeepSeek', site: 'https://platform.deepseek.com', billing: '按量付费', en: { billing: 'pay as you go' } },
+  glm: { label: '智谱 GLM', site: 'https://open.bigmodel.cn', billing: '按量或包月 GLM Coding Plan', en: { label: 'Zhipu GLM', billing: 'pay as you go or the monthly GLM Coding Plan' }, intl: { label: 'Z.ai', site: 'https://z.ai', baseUrl: 'https://api.z.ai/api/anthropic' } },
+  minimax: { label: 'MiniMax', site: 'https://platform.minimaxi.com', billing: '按量或包月 Token Plan', en: { billing: 'pay as you go or the monthly Token Plan' }, intl: { label: 'MiniMax 国际站', site: 'https://platform.minimax.io', baseUrl: 'https://api.minimax.io/anthropic', en: { label: 'MiniMax (international)' } } },
+  volcano: { label: '火山方舟', site: 'https://console.volcengine.com/ark', billing: '包月 Coding Plan,只有中国站', en: { label: 'Volcano Ark', billing: 'monthly Coding Plan, China site only' } },
 }
 const RECOMMENDED = 'deepseek'
 
-// 中国大陆常见时区:只用来给「这台机器在中国大陆吗」一个默认值,答案以用户为准
+// 中国大陆常见时区:只用来决定有国际站的厂商先试哪个站、推荐哪个聊天平台(不问用户,也不写进配置)
 const MAINLAND_TZ = new Set(['Asia/Shanghai', 'Asia/Chongqing', 'Asia/Chungking', 'Asia/Harbin', 'Asia/Urumqi', 'Asia/Kashgar', 'PRC'])
 function looksMainland(tz) {
   if (tz === undefined) { try { tz = Intl.DateTimeFormat().resolvedOptions().timeZone } catch { tz = '' } }
@@ -37,23 +38,27 @@ function keyPresent(apiKey, env = process.env) {
   return true
 }
 
+// 一家厂商的显示名 / 计费说明(英文缺省回落中文原文)
+const infoText = (info, key, lang) => (lang === 'en' && info && info.en && info.en[key]) || (info && info[key]) || ''
+
 // 试跑失败的原文 → 一句人话 + 类别。原文来自 claude 命令行(API Error: 401 …)或 spawn / 网络异常。
-function explainTestFailure(text, { baseUrl } = {}) {
+function explainTestFailure(text, { baseUrl, lang = 'zh' } = {}) {
   const t = String(text || '')
-  const h = baseUrl ? host(baseUrl) : '模型端点'
+  const en = lang === 'en'
+  const h = baseUrl ? host(baseUrl) : (en ? 'the model endpoint' : '模型端点')
   if (/\b401\b|authentication|invalid (api )?key|invalid_authentication|unauthori[sz]ed|令牌|token expired|login fail|api key.*invalid|模型认证失败/i.test(t)) {
-    return { kind: 'auth', text: 'key 不对:检查有没有复制完整;有国际站的厂商,确认 key 和所选站点是同一个站开的' }
+    return { kind: 'auth', text: en ? 'The key was rejected: check it was copied in full; for providers with an international site, the key must come from the same site you connect to' : 'key 不对:检查有没有复制完整;有国际站的厂商,确认 key 和所选站点是同一个站开的' }
   }
   if (/\b402\b|insufficient|balance|余额|欠费|arrear|quota|实名|recharge|billing/i.test(t)) {
-    return { kind: 'balance', text: '账户不能用:多半是余额不足或还没实名,到厂商后台充值 / 实名后再试' }
+    return { kind: 'balance', text: en ? 'The account cannot be used: most likely no balance or identity verification is pending; top up / verify in the provider console and try again' : '账户不能用:多半是余额不足或还没实名,到厂商后台充值 / 实名后再试' }
   }
   if (/ENOTFOUND|EAI_AGAIN|ECONNREFUSED|ECONNRESET|ETIMEDOUT|timed? ?out|fetch failed|socket hang up|network|connection error|aborted/i.test(t)) {
-    return { kind: 'network', text: `连不上 ${h}:检查网络;开着全局代理的话,把 ${h} 设成直连` }
+    return { kind: 'network', text: en ? `Cannot reach ${h}: check the network; if a global proxy is on, let ${h} connect directly` : `连不上 ${h}:检查网络;开着全局代理的话,把 ${h} 设成直连` }
   }
   if (/\b404\b|model.*(not found|not exist|does not exist|invalid|not supported)|模型.*不存在/i.test(t)) {
-    return { kind: 'model', text: '模型名不对或这个 key 没开通该模型:到控制台「模型」页改模型名' }
+    return { kind: 'model', text: en ? 'Wrong model name, or this key has no access to that model: change the model name on the console Models page' : '模型名不对或这个 key 没开通该模型:到控制台「模型」页改模型名' }
   }
-  return { kind: 'other', text: t.split('\n')[0].slice(0, 200) || '没有返回内容' }
+  return { kind: 'other', text: t.split('\n')[0].slice(0, 200) || (en ? 'No output' : '没有返回内容') }
 }
 
-module.exports = { PROVIDER_INFO, RECOMMENDED, looksMainland, host, subscriptionRoute, keyPresent, explainTestFailure }
+module.exports = { PROVIDER_INFO, RECOMMENDED, looksMainland, host, subscriptionRoute, keyPresent, explainTestFailure, infoText }

package/src/ui/console.html

@@ -985,6 +985,24 @@ function healthText(h){return h.fails?`${h.fails} 失败 · ${h.warns} 警告`:h
 /* ── overview ── */
 // Full structure — rendered once on load / after an action (with the entrance
 // animation). Live bits carry ids/data-attrs so ticks patch them in place.
+// 开始使用(1.0.12):安装向导不再问聊天平台和绑群,装完第一次打开控制台时在这里说接下来做什么;平台接上、群绑好就不显示
+function startCardHtml(){
+  const pl=S.platforms||{},anyPlat=!!(pl.feishu||pl.slack||pl.wecom);
+  const anyGroup=(S.groups||[]).length>0;
+  if(anyPlat&&anyGroup)return '';
+  // 模型这一步按健康行「可用模型」判(能用的,不只是配了的:key 在服务环境里拿不到、试跑失败的都不算)
+  const mrow=((S.health&&S.health.rows)||[]).find(r=>r.label==='可用模型');
+  const anyModel=mrow?mrow.status!=='fail':(S.providers||[]).some(p=>p.configured&&!p.hidden);
+  const step=(done,title,hint,tab,btn)=>`<div class="inline" style="gap:10px;margin:10px 0;align-items:flex-start"><span class="dot ${done?'ok':'warn'}" style="margin-top:6px;flex:none"></span><div style="flex:1;min-width:0"><div>${title}</div><div class="hint">${hint}</div></div>${!done&&tab?`<button class="btn" data-gotab="${tab}" style="flex:none">${btn}</button>`:''}</div>`;
+  const sm=S.setupMode;
+  return `<div class="card" id="ovStart" style="margin-bottom:16px"><div class="lbl">开始使用</div>
+    ${step(anyModel,'配好模型',anyModel?'换模型、加模型在「模型 · 库」':'还没有能用的模型:在「模型 · 库」里添加、测试','providers','去「模型 · 库」')}
+    ${step(anyPlat,'接聊天平台','飞书 / Slack / 企业微信,「设置」里每个平台都有分步指南','settings','去「设置」')}
+    ${step(anyGroup,'绑一个群','把群绑到项目目录,一个群一个项目','groups','去「群 · 项目」')}
+    ${step(false,'在群里 @ 机器人说一句话','不接平台也能先在「试跑」里跑一轮',null,'')}
+    ${sm&&!anyPlat?`<div class="hint" style="margin-top:8px">${sm.supervised?'后台服务现在只开着控制台:平台接好、保存后,它会自动重启并连上(约 15 秒)。':'守护进程现在只开着控制台:接好平台后,在终端里按 Ctrl-C 再运行 sintbot start --ui 连上。'}</div>`:''}
+  </div>`;
+}
 function renderOverview(){
   const h=S.health;
   const cap=Math.max((S.agent&&S.agent.maxConcurrent)||0,0); // 0 = 不限(无固定槽位 → 不画 gauge)
@@ -1001,7 +1019,7 @@ function renderOverview(){
       ${liveOn?`<button class="iconbtn sm" data-ostop="${esc(g.chatId)}" title="停止当前任务(保留会话)" style="flex:none">${IC.square}</button>
       <button class="iconbtn sm" data-onew="${esc(g.chatId)}" title="开新会话 — 运行中会先中断当前任务并清空队列(同群内 /new)" style="flex:none">${IC.rotate}</button>`:''}</div>`).join('')
     :'<div class="empty">还没有群项目 · 去「群·项目」配置</div>';
-  $('#overview').innerHTML=`<div id="ovInboxWrap">${inboxHtml()}</div><div class="grid cols2 stagger">
+  $('#overview').innerHTML=`${startCardHtml()}<div id="ovInboxWrap">${inboxHtml()}</div><div class="grid cols2 stagger">
     <div class="card" id="ovHealth"><div class="lbl">健康</div>
       <span class="hpill ${healthClass(h)}" id="ovHealthPill"><span class="led"></span><span id="ovHealthTxt">${healthText(h)}</span></span>
       <div class="hrows" id="ovHrows">${h.rows.map(r=>`<div class="hrow" data-hk="${esc(r.label)}"><span class="dot ${r.status}"></span>
@@ -3206,7 +3224,7 @@ function renderSettings(){
       ${(pri.dropped||[]).map(d=>`<div class="hint" style="color:var(--fail)">${IC.x} 配置里已忽略 ${esc(d.value)}:${esc(d.why)}</div>`).join('')}
       ${(pri.outside||[]).length?`<div class="hint" style="margin-top:6px">${IC.warn} ${pri.outside.length} 个群在根之外:${esc(pri.outside.map(o=>o.name||o.chatId).join('、'))} —— 照常运行,改目录时须搬进根内</div>`:''}
     </div>
-    <div class="hint" style="margin-top:14px;padding-top:12px;border-top:1px solid var(--line);line-height:1.7">这里只读,控制台不提供修改。要改,在服务器上编辑配置文件里的 <code>projectsRoots</code>(一个路径或数组,认 ~),或重新运行安装向导;改后即时生效,不用重启。</div>`;
+    <div class="hint" style="margin-top:14px;padding-top:12px;border-top:1px solid var(--line);line-height:1.7">这里只读,控制台不提供修改。要改,在服务器上编辑配置文件里的 <code>projectsRoots</code>(一个路径或数组,认 ~),或运行 <code>sintbot setup --full</code>;改后即时生效,不用重启。</div>`;
   const urlRow=(label,u)=>`<div class="kv"><span class="kk">${label}</span><span class="vv mono"><a href="${esc(u)}" target="_blank" style="color:var(--ember-soft)">${esc(u)}</a></span></div>`;
   // 「服务器」卡 = 访问地址 + 项目根目录(用户 2026-09-08:两张短卡并成一张,不留空当;本机 127.0.0.1 那行去掉 ——
   // 正在看控制台的人用不着它,而它又是三行里最像「可以点」却最没用的一行)
@@ -3229,6 +3247,19 @@ function renderSettings(){
     ${linkRow('源码与文档','https://github.com/sintlab/sintbot','github.com/sintlab/sintbot')}
     ${linkRow('反馈问题','https://github.com/sintlab/sintbot/issues','github.com/sintlab/sintbot/issues')}
   </div>`;
+  // 机器人名字与网络代理(1.0.12 起安装向导不再问这两样,在这里配):名字是自我介绍 / 升级播报里的自称;
+  // 代理给连 Claude / ChatGPT 用,国内模型端点自动直连(服务端按已配的模型生成直连名单)
+  const envPx=S.envProxy||'';
+  const botCard=`<div class="card" id="botNetCard"><div class="lbl">机器人与网络</div>
+    <div class="field" style="max-width:320px"><label class="f">机器人名字</label><input id="bBrand" placeholder="SintBot" value="${esc(S.brand||'')}"/>
+      <div class="hint" style="margin-top:5px">自我介绍、升级播报里的自称 · 留空 = SintBot</div></div>
+    <div class="field" style="margin:12px 0 0;max-width:360px"><label class="f">网络代理</label><input id="pxHttp" placeholder="http://127.0.0.1:7890" value="${esc((px&&px.http)||'')}"/>
+      <div class="hint" style="margin-top:5px">连不上 Claude / ChatGPT 时填 · 国内模型端点自动直连 · 留空 = 不用代理</div>
+      ${envPx?`<div class="hint" style="margin-top:4px">后台服务的环境里已有代理:<span class="mono">${esc(envPx)}</span></div>`:''}
+      ${px&&px.noProxy?`<div class="hint" style="margin-top:4px">直连:<span class="mono">${esc(px.noProxy)}</span></div>`:''}</div>
+    <button class="btn primary" id="bSave" style="margin-top:14px">保存</button>
+    <div class="hint" style="margin-top:10px">代理第一次填,新的对话轮次就生效;改已有的地址要重启后台服务(sintbot service restart)。</div>
+  </div>`;
   const verhistCard=`<div class="card" style="grid-column:1/-1" id="verhistCard"><div class="lbl">版本历史</div>
     <div id="verhistBox"><div class="empty">加载中…</div></div></div>`;
   $('#settings').innerHTML=`<div class="grid cols2 stagger">
@@ -3248,6 +3279,7 @@ function renderSettings(){
       <button class="btn primary" id="aSave" style="margin-top:14px">保存</button>
       <div class="hint" style="margin-top:10px">执行权限已改<b>按群设</b> —— 见「群·项目」每张卡(缺省 <b>dontAsk 只读 · fail-closed</b>)。</div>
     </div>
+    ${botCard}
     <div class="fx-sub" style="grid-column:1/-1;margin:6px 0 0"><span style="flex:none">聊天平台</span><span class="faint" style="font-weight:400;letter-spacing:0">配了哪个就接哪个,可以同时在线;每个群项目自己选属于哪边。点卡头展开</span></div>
     ${fxFeishuCard(fe)}
     ${fxSlackCard(S.slack||null)}
@@ -3256,6 +3288,11 @@ function renderSettings(){
     ${verhistCard}
   </div>`;
   loadChangelog();
+  $('#bSave').onclick=async()=>{const brand=$('#bBrand').value.trim(),http=$('#pxHttp').value.trim();
+    if(http&&!/^https?:\/\/\S+$/i.test(http)){toast('代理地址要像 http://127.0.0.1:7890','err');return;}
+    try{await api('/api/agent','POST',{brand});S=await api('/api/proxy','POST',{enabled:!!http,http});toast('已保存','ok');renderSettings();}catch(e){toast(e.message,'err');}};
+  // 只开着控制台的守护进程(还没接平台):第一次接上平台时说一句接下来会发生什么(服务托管的会自己重启连上)
+  {const pl=S.platforms||{};if(S.setupMode&&(pl.feishu||pl.slack||pl.wecom)&&!window._sbRestartToast){window._sbRestartToast=1;toast(S.setupMode.supervised?'已接上聊天平台 —— 后台服务几秒后自动重启并连上':'已接上聊天平台 —— 在终端里重启 sintbot start --ui 连上','ok');}}
   bindWecomCard();
   bindFxFolds();
   const lo=$('#logoutBtn');if(lo)lo.onclick=async()=>{try{await api('/api/logout','POST',{});}catch{}dropToken();TOKEN='';location.reload();};
@@ -3609,6 +3646,8 @@ function renderFxCheck(box,checks){
 const splitList=s=>s.split(/[\n,]+/).map(x=>x.trim()).filter(Boolean);
 
 /* ── shell ── */
+// 「开始使用」卡里的「去某页」按钮:委托到 document,重绘不用重新绑
+document.addEventListener('click',(e)=>{const b=e.target.closest&&e.target.closest('[data-gotab]');if(!b)return;const t=document.querySelector('[data-tab="'+b.dataset.gotab+'"]');if(t)t.click();});
 function renderAll(){renderOverview();renderProviders();renderGroups();renderPlayground();renderSettings();updateDaemon();updateTopFxApp();}
 // 顶栏应用胶囊。数据同「设置」那张身份条(同一份落盘缓存),没取过就整块不显示 —— 顶栏不适合
 // 放「未获取」这类待办文案。头像 JS 注入并留 🤖 兜底(远端图,控制台可能开在断外网的机器上)。
@@ -3713,6 +3752,32 @@ updateThemeBtn();
    ⚠ 正则一律 ^…$ 整串、不加 g 标志;更具体的条目必须排在泛化条之前。 */
 const I18N_EN=[
   ["控制台","Console"],
+  ["开始使用","Get started"],
+  ["配好模型","Set up a model"],
+  ["换模型、加模型在「模型 · 库」","Switch or add models under Models"],
+  ["还没有能用的模型:在「模型 · 库」里添加、测试","No usable model yet: add and test one under Models"],
+  ["去「模型 · 库」","Open Models"],
+  ["接聊天平台","Connect a chat platform"],
+  ["飞书 / Slack / 企业微信,「设置」里每个平台都有分步指南","Slack, Feishu or WeCom: each has a step-by-step guide under Settings"],
+  ["去「设置」","Open Settings"],
+  ["绑一个群","Bind a group"],
+  ["把群绑到项目目录,一个群一个项目","Bind a group to a project folder, one project per group"],
+  ["去「群 · 项目」","Open Groups"],
+  ["在群里 @ 机器人说一句话","@mention the bot in the group"],
+  ["不接平台也能先在「试跑」里跑一轮","No platform yet? Try a turn in Playground first"],
+  ["后台服务现在只开着控制台:平台接好、保存后,它会自动重启并连上(约 15 秒)。","The background service is running the console only: once you connect a platform and save, it restarts itself and connects (about 15 seconds)."],
+  ["守护进程现在只开着控制台:接好平台后,在终端里按 Ctrl-C 再运行 sintbot start --ui 连上。","The daemon is running the console only: after connecting a platform, press Ctrl-C in the terminal and run sintbot start --ui again to connect."],
+  ["机器人与网络","Bot & network"],
+  ["机器人名字","Bot name"],
+  ["自我介绍、升级播报里的自称 · 留空 = SintBot","How it refers to itself in introductions and upgrade notices · empty = SintBot"],
+  ["网络代理","Network proxy"],
+  ["连不上 Claude / ChatGPT 时填 · 国内模型端点自动直连 · 留空 = 不用代理","Set this if Claude / ChatGPT can't be reached · China model endpoints connect directly · empty = no proxy"],
+  ["后台服务的环境里已有代理:","The background service already has a proxy in its environment: "],
+  ["直连:","Direct: "],
+  ["代理第一次填,新的对话轮次就生效;改已有的地址要重启后台服务(sintbot service restart)。","A first-time proxy applies to new turns right away; changing an existing address needs a service restart (sintbot service restart)."],
+  ["代理地址要像 http://127.0.0.1:7890","The proxy address should look like http://127.0.0.1:7890"],
+  ["已接上聊天平台 —— 后台服务几秒后自动重启并连上","Chat platform connected — the background service restarts in a few seconds and connects"],
+  ["已接上聊天平台 —— 在终端里重启 sintbot start --ui 连上","Chat platform connected — restart sintbot start --ui in the terminal to connect"],
   ["服务器","Server"],
   ["配置模式","Config mode"],
   ["实时连接(SSE)","Live connection (SSE)"],
@@ -4371,7 +4436,8 @@ const I18N_EN=[
   ["群项目都放这里 · 选目录、保存群绑定、从本机目录提炼风格,只认这些目录之内的路径 · 当前是默认值","All group projects live here · choosing a folder, saving a group binding, and extracting a style from a local folder only accept paths inside these folders · currently the default"],
   ["不存在 —— 在服务器上建好即可","Does not exist — just create it on the server"],
   ["这里只读,控制台不提供修改。要改,在服务器上编辑配置文件里的","Read-only here — the console offers no way to change it. To change it, edit "],
-  ["(一个路径或数组,认 ~),或重新运行安装向导;改后即时生效,不用重启。"," in the config file on the server (one path, or an array; ~ is accepted), or run the setup wizard again. Changes apply immediately, no restart needed."],
+  ["(一个路径或数组,认 ~),或运行"," in the config file on the server (one path, or an array; ~ is accepted), or run"],
+  [";改后即时生效,不用重启。","; changes apply immediately, no restart needed."],
   ["公网","Public"],
   ["局域网","LAN"],
   ["访问地址","Access URLs"],

package/src/ui/server.js

@@ -208,7 +208,7 @@ function bindNoticeText(workdir, platform = 'feishu', cmd = '/help') {
   return `✅ 本群已绑定项目「${path.basename(String(workdir || '')) || '(未命名)'}」\n${platform === 'wecom' ? '@我 派单(只有 @ 我的消息我才收得到)' : '直接发消息或 @我 派单'};${cmd} 查看命令`
 }
 
-function createUiServer({ configPath, getLiveState = null, getConnHealth = null, onConfigChange = null, control = null, host = '127.0.0.1', log = () => {}, issuesPath = null, sessionsPath = null, auditPath = null, ledgerPath = null, inboxDismissPath = null, fetchImpl = null, cdpImpl = null, onTakeoverClaim = null, onTakeoverExpire = null, onTakeoverEnd = null, takeoverNow = null, wecomExec = null, verifyFile = null } = {}) {
+function createUiServer({ configPath, getLiveState = null, getConnHealth = null, onConfigChange = null, control = null, host = '127.0.0.1', log = () => {}, issuesPath = null, sessionsPath = null, auditPath = null, ledgerPath = null, inboxDismissPath = null, fetchImpl = null, cdpImpl = null, onTakeoverClaim = null, onTakeoverExpire = null, onTakeoverEnd = null, takeoverNow = null, wecomExec = null, verifyFile = null, setupMode = null } = {}) {
   // wecomExec:企业微信命令行工具的执行器注入(只为可测;生产走默认 execFile)
   // verifyFile:凭据验证记录的落点注入(只为可测;生产 = ~/.sbot/verify.json)
   const vopts = verifyFile ? { file: verifyFile } : undefined
@@ -576,6 +576,8 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
       },
       proxy: raw.proxy && raw.proxy.http ? { http: raw.proxy.http, noProxy: raw.proxy.noProxy || '' } : null,
       live: getLiveState ? getLiveState() : { running: false },
+      // 守护进程还没接平台、只开着控制台(cmdStart 配置模式):supervised = 由服务托管,接上平台后会自己重启连上
+      setupMode: setupMode ? { supervised: !!setupMode.supervised } : null,
       conn, // 各平台连接健康度字典 { feishu, wecom }(daemon 运行时);未运行为 null
       previews: previewsState(raw),
 
@@ -595,6 +597,9 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
         return { tz, offsetMin: tzOffsetMin(tz), hostTz, hostOffsetMin: -new Date().getTimezoneOffset(), now: Date.now() }
       })(),
       timezone: raw.timezone || '', // 设置页编辑用(空 = 未显式配置,跑默认北京)
+      brand: raw.brand || '', // 机器人自称(设置页编辑;空 = SintBot)
+      // 本进程环境里的代理(装服务时从终端带进来的 https_proxy 等;带认证的只说「带认证」):设置页据此说明「服务里已有代理」
+      envProxy: require('../core/proxy').proxyDescribe(process.env),
       // 本机访问地址(控制台「设置」页展示):本机 URL 恒有;对外绑定时列出局域网 URL。
       net: (() => {
         const addr = server.address()
@@ -1013,6 +1018,7 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
       }
       if (p === '/api/proxy' && req.method === 'POST') {
         const { http: httpUrl, enabled } = await body(req); const raw = readRaw()
+        if (enabled && httpUrl && !/^https?:\/\/\S+$/i.test(String(httpUrl))) return sendJSON(res, 400, { error: '代理地址要像 http://127.0.0.1:7890' })
         if (enabled && httpUrl) raw.proxy = { http: httpUrl, https: httpUrl, noProxy: deriveNoProxy(raw.providers) }
         else delete raw.proxy
         writeRaw(raw); return sendJSON(res, 200, await buildState())
@@ -1020,6 +1026,8 @@ function createUiServer({ configPath, getLiveState = null, getConnHealth = null,
       if (p === '/api/agent' && req.method === 'POST') {
         const patch = await body(req); const raw = readRaw(); raw.agent = raw.agent || {}
         for (const k of ['permissionMode', 'maxConcurrent', 'maxTurnTimeMins']) if (k in patch) raw.agent[k] = patch[k]
+        // 机器人自称(顶层 brand):空或默认名就不落盘,和安装向导 --full 的写法一致
+        if ('brand' in patch) { const b = String(patch.brand || '').trim().slice(0, 40); if (b && b !== 'SintBot') raw.brand = b; else delete raw.brand }
         // 长会话自动压缩阈值:0 = 关,否则限 10万–100万(CLI 旗子的文档区间;区间外它会拒参数,
         // 每轮必死 ⇒ 存前就挡住,别让坏值落盘)。
         if ('autocompactTokens' in patch) {