foxclaw 0.1.2 → 0.1.3

package/python/frontend_src/src/lib/i18n.js

@@ -0,0 +1,53 @@
+import { reactive } from 'vue'
+import zh from './locales/zh.js'
+import en from './locales/en.js'
+
+const DICTS = { zh, en }
+const STORE_KEY = 'foxclawLang'
+
+export const LOCALES = [
+  { id: 'zh', label: '中文', tag: 'Chinese', htmlLang: 'zh-CN', locale: 'zh-CN' },
+  { id: 'en', label: 'English', tag: 'English', htmlLang: 'en', locale: 'en-US' },
+]
+
+const stored = (() => {
+  try {
+    return localStorage.getItem(STORE_KEY)
+  } catch {
+    return null
+  }
+})()
+
+export const i18n = reactive({ locale: DICTS[stored] ? stored : 'zh' })
+
+export const currentLocale = () => LOCALES.find((l) => l.id === i18n.locale) || LOCALES[0]
+
+/** 数字/日期格式化用的 BCP-47 标签,跟随界面语言 */
+export const numberLocale = () => currentLocale().locale
+
+export function applyLangTag() {
+  document.documentElement.lang = currentLocale().htmlLang
+}
+
+export function setLocale(id) {
+  if (!DICTS[id] || id === i18n.locale) return
+  i18n.locale = id
+  try {
+    localStorage.setItem(STORE_KEY, id)
+  } catch {
+    /* 隐私模式下写不进去,不影响本次会话 */
+  }
+  applyLangTag()
+}
+
+/** 取文案。读 i18n.locale 使其在模板中被 Vue 追踪,切换语言即时生效。 */
+export function t(key, vars) {
+  const dict = DICTS[i18n.locale] || DICTS.zh
+  let s = dict[key]
+  if (s === undefined) s = DICTS.zh[key]
+  if (s === undefined) return key
+  if (vars) {
+    for (const k of Object.keys(vars)) s = s.split(`{${k}}`).join(String(vars[k]))
+  }
+  return s
+}

package/python/frontend_src/src/lib/locales/en.js

@@ -0,0 +1,173 @@
+export default {
+  'nav.overview': 'Overview',
+  'nav.activity': 'Activity',
+  'nav.tasks': 'Scheduled',
+  'nav.agents': 'Agents',
+  'nav.tools': 'Skills · Connectors',
+  'nav.usage': 'Usage',
+  'nav.knowledge': 'Library',
+  'nav.review': 'Review',
+  'nav.memory': 'Memory',
+  'nav.settings': 'Settings',
+
+  'group.workspace': 'Workspace',
+  'group.capability': 'Capability',
+  'group.knowledge': 'Knowledge',
+  'group.system': 'System',
+
+  'common.refresh': 'Refresh',
+  'common.loading': 'Loading…',
+  'common.offline': 'Backend offline',
+  'common.offlinePanel': 'Backend offline — this panel cannot load data right now',
+  'common.online': 'Online',
+  'common.offlineShort': 'Offline',
+  'common.save': 'Save',
+  'common.notSet': 'Not set',
+  'common.count': '{n}',
+
+  'rail.newSession': 'Start a new session',
+  'rail.newSessionBtn': '+ New session',
+  'rail.more': 'More',
+  'menu.title': 'More features',
+  'menu.close': 'Close (Esc)',
+  'rail.otherFeatures': 'Other features',
+  'rail.history': 'Sessions',
+  'rail.empty': 'No sessions yet · send a message to start',
+  'rail.untitled': 'New session',
+  'rail.rename': 'Rename session',
+  'rail.delete': 'Delete session',
+  'rail.sessionTitle': 'Session title',
+  'rail.open': 'Open {label}',
+  'rail.deleteConfirm': 'Delete session "{name}"?\nIts conversation history will be removed permanently.',
+
+  'app.expandInspector': 'Expand inspector',
+  'app.inspector': 'Inspect',
+
+  'topbar.systemStatus': 'Status',
+  'topbar.newVersion': 'Version {latest} available (current {current}) — open settings',
+  'topbar.planet': 'Open HKC Knowledge Planet',
+  'topbar.planetBtn': '🌐 Planet',
+  'topbar.settings': 'Settings (Ctrl+,)',
+
+  'settings.title': 'Settings',
+  'settings.tag': 'Settings',
+  'settings.groupModel': 'Model',
+  'settings.modelProvider': 'Model & provider',
+  'settings.modelProviderSub': 'Takes effect server-side immediately, no restart',
+  'settings.current': 'Active',
+  'settings.unconfigured': 'No key',
+  'settings.providerNote': '“No key” means the backend has no credential for that vendor. Custom model keys and base URLs go in the model capsule left of the composer.',
+  'settings.usage': 'Usage',
+  'settings.usageSub': 'Tokens, calls, balance',
+  'settings.groupChat': 'Chat',
+  'settings.mode': 'Mode',
+  'settings.modeSub': 'Token-by-token streaming / plan first, then execute',
+  'settings.stream': 'Stream',
+  'settings.orchestrate': 'Orchestrate',
+  'settings.nickname': 'Nickname',
+  'settings.nicknameSub': 'How the model addresses you',
+  'settings.nicknamePh': 'e.g. snow',
+  'settings.nicknameNote': 'Stored as a preference and attached to every turn; save empty to clear.',
+  'settings.shortcuts': 'Shortcuts',
+  'settings.shortcutsSub': 'Keys inside the composer',
+  'settings.groupSystem': 'System',
+  'settings.backend': 'Backend',
+  'settings.probing': 'probing…',
+  'settings.ok': 'OK',
+  'settings.retry': 'Retry',
+  'settings.updates': 'Updates',
+  'settings.groupUi': 'Interface',
+  'settings.language': 'Language',
+  'settings.languageSub': 'Switches interface copy instantly',
+  'settings.languageNote': 'Interface only — it does not change the language the model replies in.',
+
+  'settings.updNotEnabled': 'Off',
+  'settings.updAvailable': '{v} available',
+  'settings.updLatest': 'Up to date',
+  'settings.updFailed': 'Check failed',
+  'settings.updPending': 'Pending',
+  'settings.updHintOff': 'Off by default · set FOXCLAW_UPDATE_CHECK=1 to enable',
+  'settings.updHintError': 'Check failed (usage unaffected): {msg}',
+  'settings.updHintNew': 'Current v{cur} · latest v{latest}',
+  'settings.updHintOk': 'Current v{cur} · checked every 24h',
+  'settings.buildLocal': 'local build',
+  'settings.buildToday': 'today',
+  'settings.buildDays': '{n} days ago',
+
+  'settings.errSaveNick': 'Save failed: {msg}',
+  'settings.errSwitch': 'Switch failed: {msg}',
+  'settings.saidNick': 'I will call you {name} from now on',
+  'settings.saidNickCleared': 'Nickname cleared',
+  'settings.saidSwitched': 'Model switched to {label}',
+  'settings.saidStream': 'Streaming: token by token',
+  'settings.saidOrchestrate': 'Orchestrate: plan first, then execute step by step',
+  'settings.saidLang': 'Interface language set to {name}',
+
+  'chat.cmd.new': 'Start a new session',
+  'chat.cmd.stream': 'Switch to streaming chat',
+  'chat.cmd.orchestrate': 'Switch to plan-and-execute',
+  'chat.cmd.search': 'Search memory / knowledge / web: /search <query>',
+  'chat.cmd.ingest': 'Pick files to ingest into the library',
+  'chat.cmd.settings': 'Open settings',
+  'chat.cmd.stop': 'Stop the current generation',
+  'chat.cmd.clear': 'Clear this view only, backend untouched',
+  'chat.cmd.help': 'List all commands',
+  'chat.saidStream': 'Switched to streaming chat',
+  'chat.saidOrchestrate': 'Switched to plan-and-execute',
+  'chat.hintSlash': 'Commands',
+  'chat.hintAt': 'Mention a skill',
+  'chat.tagArg': 'takes an argument',
+  'chat.tagSkill': 'skill',
+  'chat.tagTool': 'tool',
+  'chat.unknownCmd': 'Unknown command: {head}',
+  'chat.ingestFailed': 'failed',
+  'chat.placeholder': 'Tell me what you need…  / commands · @ skills · Enter to send',
+  'chat.send': 'Send',
+  'chat.stopGen': 'Stop generating',
+
+  'hero.title': 'Ask me anything',
+  'hero.cap': 'The supervisor agent dispatches sub-agents on demand; ask directly if you want it to read your library',
+  'hero.askName': 'What should I call you?',
+  'hero.namePh': 'e.g. snow',
+  'hero.confirm': 'Call me that',
+  'hero.skip': 'Skip',
+  'hero.skipTip': 'You can change this later in settings',
+  'hero.close': 'Close',
+  'hero.resume': 'Resume',
+  'hero.untitled': 'Untitled session',
+  'hero.msgs': '{n} messages',
+  'hero.recentKnowledge': 'Recent knowledge',
+  'hero.saidNick': 'Got it, I will call you {name}',
+  'hero.errSave': 'Save failed: {msg}',
+  'hero.q1': 'What skills are available right now?',
+  'hero.q2': 'Help me prioritise what I need to do today',
+  'hero.q3': 'Describe in one sentence what you can do for me',
+
+  'msg.supervisor': 'Supervisor',
+  'msg.generating': 'generating',
+  'msg.reasoning': 'Reasoning',
+  'msg.chars': '{n} chars',
+  'msg.plan': 'Plan',
+  'msg.steps': '{n} steps',
+  'msg.confidence': 'Confidence {n}%',
+  'msg.iterations': '{n} iterations',
+  'msg.evidence': 'Evidence',
+  'msg.items': '{n} items',
+  'msg.tool': 'tool',
+  'msg.copied': 'Copied',
+  'msg.copy': 'Copy',
+  'msg.retry': 'Retry',
+  'msg.srcMemory': 'memory',
+  'msg.srcKnowledge': 'knowledge',
+  'msg.srcWeb': 'web',
+  'msg.srcAgent': 'agent',
+  'msg.srcEvidence': 'evidence',
+
+  'key.enter': 'Send',
+  'key.shiftEnter': 'New line',
+  'key.slash': 'Command completion (e.g. /search)',
+  'key.at': 'Skill completion',
+  'key.arrows': 'Pick from the completion list',
+  'key.esc': 'Close completion / overlay',
+  'key.ctrlComma': 'Open settings',
+}

package/python/frontend_src/src/lib/locales/zh.js

@@ -0,0 +1,174 @@
+export default {
+  'nav.overview': '概览',
+  'nav.activity': '活动',
+  'nav.tasks': '定时任务',
+  'nav.agents': '代理',
+  'nav.tools': '技能·连接器',
+  'nav.usage': '使用情况',
+  'nav.knowledge': '学习库',
+  'nav.review': '复习',
+  'nav.memory': '记忆中心',
+  'nav.settings': '设置',
+
+  'group.workspace': '工作台',
+  'group.capability': '能力',
+  'group.knowledge': '知识',
+  'group.system': '系统',
+
+  'common.refresh': '刷新',
+  'common.loading': '加载中…',
+  'common.offline': '后端未连接',
+  'common.offlinePanel': '后端未连接,这个面板暂时拉不到数据',
+  'common.online': '在线',
+  'common.offlineShort': '离线',
+  'common.save': '保存',
+  'common.notSet': '未设置',
+  'common.count': '{n} 条',
+
+  'rail.newSession': '开一个新会话',
+  'rail.newSessionBtn': '＋ 新会话',
+  'rail.more': '更多',
+  'menu.title': '更多功能',
+  'menu.close': '关闭 (Esc)',
+  'rail.otherFeatures': '其它功能',
+  'rail.history': '会话历史',
+  'rail.empty': '还没有会话 · 发一条消息即开始',
+  'rail.untitled': '新会话',
+  'rail.rename': '重命名会话',
+  'rail.delete': '删除会话',
+  'rail.sessionTitle': '会话标题',
+  'rail.open': '打开{label}',
+  'rail.deleteConfirm': '删除会话「{name}」?\n对话历史会一起删掉,不可恢复。',
+
+  'app.expandInspector': '展开检视栏',
+  'app.inspector': '检视',
+
+  'topbar.systemStatus': '系统状态',
+  'topbar.newVersion': '有新版本 {latest}(当前 {current}),点这里看设置',
+  'topbar.planet': '打开 HKC 知识星球',
+  'topbar.planetBtn': '🌐 知识星球',
+  'topbar.settings': '设置 (Ctrl+,)',
+
+  'settings.title': '设置',
+  'settings.tag': 'Settings',
+  'settings.groupModel': '模型',
+  'settings.modelProvider': '模型与供应商',
+  'settings.modelProviderSub': '切换后服务端立即生效,不用重启',
+  'settings.current': '当前',
+  'settings.unconfigured': '未配置',
+  'settings.providerNote': '「未配置」= 后端缺该厂商的 Key。自定义模型的 Key / Base URL 在输入框左侧的模型胶囊里加。',
+  'settings.usage': '使用情况',
+  'settings.usageSub': 'token、调用次数、余额',
+  'settings.groupChat': '对话',
+  'settings.mode': '模式',
+  'settings.modeSub': '逐字流式 / 先出计划再逐步执行',
+  'settings.stream': '流式',
+  'settings.orchestrate': '编排',
+  'settings.nickname': '称呼',
+  'settings.nicknameSub': '模型会这么叫你',
+  'settings.nicknamePh': '例如:snow',
+  'settings.nicknameNote': '存成一条偏好,每轮对话都会带上;留空保存 = 清除。',
+  'settings.shortcuts': '快捷键',
+  'settings.shortcutsSub': '输入框里的键位',
+  'settings.groupSystem': '系统',
+  'settings.backend': '后端连接',
+  'settings.probing': '探测中…',
+  'settings.ok': '正常',
+  'settings.retry': '重试',
+  'settings.reprobe': '再探一次',
+  'settings.updates': '新版本',
+  'settings.groupUi': '界面',
+  'settings.language': '语言',
+  'settings.languageSub': '切换界面文案,立即生效',
+  'settings.languageNote': '只影响界面文字,不影响模型回复的语言。',
+
+  'settings.updNotEnabled': '未开启',
+  'settings.updAvailable': '新版本 {v}',
+  'settings.updLatest': '已是最新',
+  'settings.updFailed': '检查失败',
+  'settings.updPending': '待检查',
+  'settings.updHintOff': '默认关闭 · 设 FOXCLAW_UPDATE_CHECK=1 开启',
+  'settings.updHintError': '检查失败(不影响使用):{msg}',
+  'settings.updHintNew': '当前 v{cur} · 最新 v{latest}',
+  'settings.updHintOk': '当前 v{cur} · 24 小时查一次',
+  'settings.buildLocal': '本地构建',
+  'settings.buildToday': '今天',
+  'settings.buildDays': '{n} 天前',
+
+  'settings.errSaveNick': '保存失败:{msg}',
+  'settings.errSwitch': '切换失败:{msg}',
+  'settings.saidNick': '以后称呼你为 {name}',
+  'settings.saidNickCleared': '已清除称呼',
+  'settings.saidSwitched': '模型已切到 {label}',
+  'settings.saidStream': '流式:逐字输出',
+  'settings.saidOrchestrate': '编排:先出计划再逐步执行',
+  'settings.saidLang': '界面语言已切换为{name}',
+
+  'chat.cmd.new': '开一个新会话',
+  'chat.cmd.stream': '切到流式对话',
+  'chat.cmd.orchestrate': '切到编排任务',
+  'chat.cmd.search': '检索记忆/知识/联网:/搜索 关键词',
+  'chat.cmd.ingest': '选文件摄入知识库',
+  'chat.cmd.settings': '打开设置面板',
+  'chat.cmd.stop': '停止当前生成',
+  'chat.cmd.clear': '只清空当前显示,不动后端',
+  'chat.cmd.help': '列出全部命令',
+  'chat.saidStream': '已切到流式对话',
+  'chat.saidOrchestrate': '已切到编排任务',
+  'chat.hintSlash': '命令',
+  'chat.hintAt': '提及技能',
+  'chat.tagArg': '带参数',
+  'chat.tagSkill': '技能',
+  'chat.tagTool': '工具',
+  'chat.unknownCmd': '未知命令:{head}',
+  'chat.ingestFailed': '失败',
+  'chat.placeholder': '告诉我你想做什么…  / 命令 · @ 技能 · Enter 发送',
+  'chat.send': '发送',
+  'chat.stopGen': '停止生成',
+
+  'hero.title': '问我任何事',
+  'hero.cap': '主管 Agent 会按需调度子 Agent;想让它读你的知识库,直接问就行',
+  'hero.askName': '我该怎么称呼你?',
+  'hero.namePh': '例如:snow',
+  'hero.confirm': '就这么叫',
+  'hero.skip': '跳过',
+  'hero.skipTip': '以后在设置里也能填',
+  'hero.close': '关闭',
+  'hero.resume': '继续上次',
+  'hero.untitled': '未命名会话',
+  'hero.msgs': '{n} 条消息',
+  'hero.recentKnowledge': '最近知识',
+  'hero.saidNick': '记住了,以后称呼你为 {name}',
+  'hero.errSave': '保存失败:{msg}',
+  'hero.q1': '现在系统里有哪些技能可以用?',
+  'hero.q2': '帮我把今天要做的事排个优先级',
+  'hero.q3': '用一句话说清你能帮我做什么',
+
+  'msg.supervisor': '主管 Agent',
+  'msg.generating': '生成中',
+  'msg.reasoning': '推理过程',
+  'msg.chars': '{n} 字',
+  'msg.plan': '执行计划',
+  'msg.steps': '{n} 步',
+  'msg.confidence': '置信度 {n}%',
+  'msg.iterations': '{n} 轮迭代',
+  'msg.evidence': '执行证据',
+  'msg.items': '{n} 项',
+  'msg.tool': '工具',
+  'msg.copied': '已复制',
+  'msg.copy': '复制',
+  'msg.retry': '重试',
+  'msg.srcMemory': '记忆',
+  'msg.srcKnowledge': '知识',
+  'msg.srcWeb': '联网',
+  'msg.srcAgent': '态势',
+  'msg.srcEvidence': '证据',
+
+  'key.enter': '发送',
+  'key.shiftEnter': '换行',
+  'key.slash': '命令补全(如 /搜索)',
+  'key.at': '技能补全',
+  'key.arrows': '在补全列表里选',
+  'key.esc': '关闭补全 / 浮层',
+  'key.ctrlComma': '打开设置',
+}

package/python/frontend_src/src/lib/md.js

@@ -1,12 +1,3 @@
-/* 极简 Markdown → HTML。对话气泡与文档阅读共用这一份渲染器。
- *
- * 之前是两套:DocViewer 自带 readHTML/inl(支持标题、列表、行内代码、粗体、链接,
- * 但**不支持 ``` 代码块**),而 MessageStream 直接 {{ m.content }} 原样输出 ——
- * 于是模型的 `## 标题`、`**粗体**`、`- 列表`、反引号代码块在对话里全是原文。
- *
- * 安全边界:先全量转义 & < > ",之后只把识别到的标记换成标签;
- * 所有标签都由本文件产出,链接只放行 http(s)。
- */
 
 const esc = (s) =>
   String(s ?? '')
@@ -71,8 +62,6 @@ function renderTable(rows) {
   return `<table><thead><tr>${th}</tr></thead>${body.length ? `<tbody>${trs}</tbody>` : ''}</table>`
 }
 
-/* src 为空 → 空串。流式时最后一段代码块可能还没闭合,
- * 这里把它当"开着"的代码块渲染,而不是把三个反引号当正文甩出来。 */
 export function mdToHTML(src) {
   const text = String(src ?? '').replace(/\r\n?/g, '\n').replace(/\n$/, '')
   if (!text.trim()) return ''
@@ -114,7 +103,6 @@ export function mdToHTML(src) {
       continue
     }
 
-    /* 围栏代码块 —— 对话里最常出现,优先级最高 */
     const fence = RE_FENCE.exec(line)
     if (fence) {
       flush()
@@ -137,7 +125,6 @@ export function mdToHTML(src) {
       continue
     }
 
-    /* 表格:当前行是 | ... | 且下一行是分隔行 */
     if (RE_TABLE_ROW.test(line) && i + 1 < lines.length && RE_TABLE_SEP.test(lines[i + 1]) && lines[i + 1].includes('-')) {
       flush()
       const rows = [splitRow(line)]
@@ -154,7 +141,6 @@ export function mdToHTML(src) {
     const h = RE_HEADING.exec(line)
     if (h) {
       flush()
-      /* # → h2, #### 及以下 → h5,不再往下掉(对话里 h6 太小) */
       const lv = Math.min(h[1].length + 1, 5)
       out.push(`<h${lv}>${inline(h[2])}</h${lv}>`)
       i += 1

package/python/frontend_src/src/main.js

@@ -3,5 +3,7 @@ import App from './App.vue'
 import './styles/tokens.css'
 import './styles/base.css'
 import './styles/panel.css'
+import { applyLangTag } from './lib/i18n.js'
 
+applyLangTag()
 createApp(App).mount('#app')

package/python/frontend_src/src/stores/app.js

@@ -1,52 +1,44 @@
 import { reactive } from 'vue'
 import { getJSON } from '../api.js'
+import { t } from '../lib/i18n.js'
 
-/* 单一状态源:所有栏只读这一份,不再有 _syncNav 那类「三个入口各改一遍」的补丁。 */
 export const state = reactive({
-  /* 左栏 */
   sessions: [],
   sessionsState: 'idle', // idle | loading | error
   sessionId: null,
 
-  /* 中间舞台 */
   module: 'overview',
   doc: null, // { id, title, kind:'text'|'code', lang, path, content, meta }
 
-  /* 右栏 Inspector:双内容态,同一栏 */
   railOpen: true,
   railMode: 'progress', // 'progress' | 'context'
 
-  /* 办公进度(OfficeAgent 的态势与进程);学习账本在 panels.review 里 */
   officeStats: { waypoints: 0, conflicts: 0, alerts: 0, active: 0, total: 0 },
 })
 
 export const MODULES = [
-  { id: 'overview', label: '概览', tag: 'Overview', group: '' },
-  { id: 'activity', label: '活动', tag: 'Activity', group: '工作台' },
-  { id: 'tasks', label: '定时任务', tag: 'Tasks', group: '工作台', icon: 'clock' },
-  { id: 'agents', label: '代理', tag: 'Agents', group: '工作台', icon: 'bot', beta: true },
-  { id: 'tools', label: '技能·连接器', tag: 'Tools', group: '能力', icon: 'plug' },
-  { id: 'usage', label: '使用情况', tag: 'Usage', group: '能力' },
-  /* 学习库 = 办公/学习的汇总表:知识库里有什么、哪些到期该复习、记了什么,一份数据的三个视图。
-     所以它只有一个入口,hover 出「复习 / 记忆」两个快捷 —— 平级摆三行会让同一份数据看着像三份。 */
-  { id: 'knowledge', label: '学习库', tag: 'Knowledge', group: '知识', icon: 'book', quick: ['review', 'memory'] },
-  { id: 'review', label: '复习', tag: 'Review', group: '知识', icon: 'review' },
-  { id: 'memory', label: '记忆中心', tag: 'Memory', group: '知识', icon: 'memory' },
-  /* 设置不是"干活的地方",所以不进常驻栏;顶栏 ⚙ 与「更多」都能到,
-     顶栏那个 ⚙ 之前是死按钮(title 写着 P3 接入)。 */
-  /* 设置落在「更多」里,那里不画图标;之前挂的 icon:'gear' 在 LeftRail 的 ICONS 里
-     并不存在(只有 book/clock/plug/bot/more/review/memory/dot),是个死字段。 */
-  { id: 'settings', label: '设置', tag: 'Settings', group: '系统' },
+  { id: 'overview', label: '概览', tag: 'Overview', group: '', groupKey: '' },
+  { id: 'activity', label: '活动', tag: 'Activity', group: '工作台', groupKey: 'group.workspace' },
+  { id: 'tasks', label: '定时任务', tag: 'Tasks', group: '工作台', groupKey: 'group.workspace', icon: 'clock' },
+  { id: 'agents', label: '代理', tag: 'Agents', group: '工作台', groupKey: 'group.workspace', icon: 'bot', beta: true },
+  { id: 'tools', label: '技能·连接器', tag: 'Tools', group: '能力', groupKey: 'group.capability', icon: 'plug' },
+  { id: 'usage', label: '使用情况', tag: 'Usage', group: '能力', groupKey: 'group.capability' },
+  { id: 'knowledge', label: '学习库', tag: 'Knowledge', group: '知识', groupKey: 'group.knowledge', icon: 'book', quick: ['review', 'memory'] },
+  { id: 'review', label: '复习', tag: 'Review', group: '知识', groupKey: 'group.knowledge', icon: 'review' },
+  { id: 'memory', label: '记忆中心', tag: 'Memory', group: '知识', groupKey: 'group.knowledge', icon: 'memory' },
+  { id: 'settings', label: '设置', tag: 'Settings', group: '系统', groupKey: 'group.system', icon: 'gear' },
 ]
 
-/* 左栏常驻的功能入口(顺序即渲染顺序)。不进这个数组的模块全部落进底部「更多」浮层。
-   常驻项恒可见 = 不用先点开菜单才知道有什么功能;代价是列高固定,所以只放四个。 */
 export const RAIL = ['knowledge', 'tasks', 'tools', 'agents']
 
+// 设置是侧栏底部的固定入口,不参与主导航与「更多」弹层
+export const PINNED = ['settings']
+
 export const railItems = () => RAIL.map((id) => MODULES.find((m) => m.id === id)).filter(Boolean)
-export const moreItems = () => MODULES.filter((m) => !RAIL.includes(m.id))
+export const moreItems = () => MODULES.filter((m) => !RAIL.includes(m.id) && !PINNED.includes(m.id))
 
-export const moduleLabel = (id) => MODULES.find((m) => m.id === id)?.label ?? id
+export const moduleLabel = (id) => (MODULES.some((m) => m.id === id) ? t(`nav.${id}`) : id)
+export const groupLabel = (key) => (key ? t(key) : '')
 export const moduleIcon = (id) => MODULES.find((m) => m.id === id)?.icon ?? 'dot'
 
 export async function loadSessions() {
@@ -68,13 +60,7 @@ export function openSession(s) {
 }
 
 export async function loadProgress() {
-  /* 学习账本已改由 panels.review(/api/review/*)提供 —— SM-2 状态写在 KU.extra 里,
-     和知识库是同一份数据;/learning/analysis 只统计 learning_note 一类条目,
-     两套口径并存会让右栏数字和复习面板对不上。 */
 
-  /* 办公 = OfficeAgent(行政职责已并入它)的全局态势 + 进程。
-     「已摄入资料」已挪到右栏的「最近知识」(读 /api/knowledge/recent),
-     书籍级列表留在知识库面板,这里不再重复拉 /knowledge/sources。 */
   const [sit, proc] = await Promise.all([
     getJSON('/orchestration/situation').catch(() => null),
     getJSON('/processes?limit=5').catch(() => null),
@@ -93,7 +79,6 @@ export function setModule(id) {
   state.doc = null
 }
 
-/* 打开一份文件 → 正文进中间舞台(宽度够读代码),右栏同步切到检视态并自动展开 */
 export function openDoc(doc) {
   state.doc = doc
   state.railMode = 'context'