foxclaw 0.1.2 → 0.1.4

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'

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

@@ -1,4 +1,3 @@
-/* 对话与输入区状态:模式 / 附件 / 图片 / 摄入任务 / 消息流 / SSE */
 import { reactive } from 'vue'
 import { API, delJSON, getJSON, getRaw, postForm, postFormRaw, postJSON } from '../api.js'
 import { loadSessions, state as app } from './app.js'
@@ -14,12 +13,9 @@ export const chat = reactive({
   ingest: null, // {name,pct,status,ku,msg}
   toast: '',
 
-  /* 对话 */
   messages: [], // [{role,content,thinking,evidence,error,ts,streaming,stage,plan}]
   sessionId: null,
   streamState: 'idle', // idle | streaming | done | error
-  /* 错误落在具体那条消息的 m.error 上(界面上能看到 + 能点重试),
-     这里不再留一个没人读的 lastError */
 })
 
 let toastTimer = 0
@@ -35,7 +31,6 @@ export function setMode(m) {
   localStorage.setItem(MODE_KEY, m)
 }
 
-/* ── 附件:POST /api/upload → {id,name,size,mime,url,text} ── */
 export async function attachFile(file) {
   if (!file) return
   if (file.size > MAX_MB * 1048576) return say(`${file.name} 超过 ${MAX_MB}MB`)
@@ -50,7 +45,6 @@ export async function attachFile(file) {
   }
 }
 
-/* ── 图片:本地转 dataURL,不落盘 ── */
 export function attachImage(file) {
   if (!file) return
   if (!file.type.startsWith('image/')) return say('不是图片文件')
@@ -67,8 +61,6 @@ export function dropImage(i) {
   chat.images.splice(i, 1)
 }
 
-/* ── 摄入知识库:POST /knowledge/ingest/file/async → 轮询 /knowledge/ingest/jobs/{id}
-      注意路径无 /api 前缀:vendor/hkc 的 knowledge router 是根路径挂载的。 ── */
 export async function ingestFile(file, collection = '') {
   if (!file) return
   if (chat.ingest) return say('等当前文件摄入完成再传下一个')
@@ -90,7 +82,6 @@ export async function ingestFolder(files) {
   const list = [...files].filter(Boolean)
   for (const f of list) {
     await ingestFile(f)
-    /* ingestFile 内部已串行守卫:等当前 job 结束再投下一个 */
     while (chat.ingest && chat.ingest.status !== 'error') {
       if (chat.ingest.status === 'done') break
       await new Promise((r) => setTimeout(r, 600))
@@ -123,8 +114,6 @@ async function pollIngest(jobId) {
   say('摄入超时,后台可能仍在跑')
 }
 
-/* ══════════ 会话 ══════════ */
-
 const STAGE_CN = {
   perceive: '感知', recall: '召回', meta_check: '自检', schedule: '排程',
   route: '路由', plan: '规划', dispatch: '分发', act: '执行',
@@ -150,7 +139,6 @@ function adoptSession(id) {
   localStorage.setItem(SID_KEY, id)
 }
 
-/* 启动时恢复上次会话(后端 sessions 落盘,thinking/evidence 不落盘) */
 export async function bootChat() {
   const saved = localStorage.getItem(SID_KEY)
   if (saved) await loadSession(saved, { quiet: true })
@@ -173,14 +161,11 @@ export async function loadSession(id, { quiet = false } = {}) {
   }
 }
 
-/* 组件间的一次性信号:斜杠命令要调 ToolMenu 里的文件选择,又不能硬耦合。
-   (/设置 不再走这里 —— 它现在直接切到设置面板,见 ChatDock 的命令表) */
 export const ui = reactive({ ingestTick: 0 })
 export function requestIngest() {
   ui.ingestTick += 1
 }
 
-/* 纯本地消息(/帮助 之类),不经过后端 */
 export function pushLocal(content) {
   chat.messages.push({
     role: 'assistant', content, ts: Date.now(),
@@ -188,7 +173,6 @@ export function pushLocal(content) {
   })
 }
 
-/* 认知搜索(HSR):POST /api/search/query,结果作为一张证据卡挂在消息流里 */
 export async function runSearch(rawQuery) {
   const query = String(rawQuery || '').trim()
   if (!query) return say('用法:/搜索 关键词')
@@ -205,7 +189,6 @@ export async function runSearch(rawQuery) {
   const msg = chat.messages[chat.messages.length - 1]
 
   try {
-    /* internal_only=true:只查 HMR 记忆 + HKC 知识 + Agent 态势,不联网 —— 联网分支实测返回空图 */
     const d = await postJSON('/search/query', { query, agent_id: 'supervisor', internal_only: true })
     const nodes = (d.graph && d.graph.nodes) || []
     msg.search = {
@@ -242,7 +225,6 @@ export async function newSession() {
   }
 }
 
-/* 改标题:后端 rename 会把空串兜回「新会话」,这里先挡掉空提交,避免误清标题 */
 export async function renameSession(id, title) {
   const t = String(title || '').trim().slice(0, 60)
   if (!id || !t) return
@@ -255,8 +237,6 @@ export async function renameSession(id, title) {
   }
 }
 
-/* 删会话。删的是当前会话时落回列表里的下一条;一条不剩就新开一个 ——
-   否则界面会停在一个已经不存在的 sessionId 上,下一条消息直接 404。 */
 export async function deleteSession(id) {
   if (!id) return
   try {
@@ -271,7 +251,6 @@ export async function deleteSession(id) {
   else await newSession()
 }
 
-/* 重发:把这条回复对应的提问找回来,截断到它之前再投一次(附件/图片一起还原) */
 export async function retry(msg) {
   if (chat.streamState === 'streaming') return say('正在生成,先点停止')
   const i = chat.messages.indexOf(msg)
@@ -301,28 +280,20 @@ async function ensureSession() {
       adoptSession(saved)
       return saved
     } catch {
-      /* 后端已无此会话 → 落到下面新建 */
     }
   }
   return newSession()
 }
 
-/* ══════════ 发送 / 流式 ══════════ */
-
 let ctrl = null
-/* 每次 send 领一个代号。切会话 / 新建会话时把代号推进,在跑的那一路回来发现
-   代号变了就不再碰全局状态 —— 否则它会把新会话的 streamState 覆盖掉、还把 ctrl
-   清空,导致新流停不下来,两路 token 同时往不同消息里写。 */
 let gen = 0
 
-/* 掐断在跑的流:切会话、新建会话、重试前都先调一次 */
 function cutStream() {
   gen += 1
   if (ctrl) {
     try {
       ctrl.abort()
     } catch {
-      /* 已经收尾了 */
     }
     ctrl = null
   }
@@ -351,7 +322,6 @@ export async function send(rawText) {
   const attachments = chat.attachments.map((a) => ({
     name: a.name, size: a.size, mime: a.mime, url: a.url, text: a.text || '',
   }))
-  /* 后端只用最近 12 条拼上下文,与旧前端保持一致 */
   const history = chat.messages
     .filter((m) => m.content && m.role && !m.error)
     .slice(-12)
@@ -359,15 +329,12 @@ export async function send(rawText) {
 
   chat.messages.push({
     role: 'user', content: text, ts: Date.now(), attachments, streaming: false, thinking: '',
-    /* 存一份图片快照:重试时 send() 从 chat.images 取图,不带上就丢图了 */
     images: chat.images.map((im) => ({ ...im })),
   })
   chat.messages.push({
     role: 'assistant', content: '', thinking: '', evidence: [], error: '', notice: '',
     ts: Date.now(), streaming: true, stage: '', plan: null,
   })
-  /* 必须拿回数组里的响应式代理:直接改 push 进去的原始对象不会触发重渲染,
-     表现就是气泡永远停在「···」而内容其实早到了 */
   const reply = chat.messages[chat.messages.length - 1]
   chat.attachments = []
   chat.images = []
@@ -412,7 +379,6 @@ export async function send(rawText) {
 }
 
 function applyEvent(msg, name, ev) {
-  /* 命名事件与 JSON 键双判据:后端明确要求两者都认 */
   if (name === 'thinking' || ev.thinking) {
     msg.thinking += ev.thinking || ''
     return

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

@@ -1,4 +1,3 @@
-/* 模型选择:全部走 /api/llm/*(llm_admin.py),切换后服务端立即生效,无需重启。 */
 import { reactive } from 'vue'
 import { delJSON, getJSON, postJSON, putJSON } from '../api.js'
 
@@ -28,7 +27,6 @@ export async function loadModels(force = false) {
   }
 }
 
-/* 当前 pill 上显示的名字与色点 */
 export function currentLabel() {
   const c = model.current
   if (!c) return { name: 'Auto', color: '#7e93b8', sub: '跟随 .env 默认' }
@@ -49,9 +47,6 @@ export async function selectModel({ source, provider = null, name = null }) {
   return r
 }
 
-/* 设置面板里的模型清单:auto / 预设 / 自定义摊平成同一形状。
-   active 的判定必须和上面的 currentLabel 一致 —— 两处各写一套,切换后 pill 和
-   列表就会各说各的(这类"同一状态两套判定"是回归温床)。 */
 export function modelOptions() {
   const c = model.current
   const out = [{
@@ -81,13 +76,10 @@ export async function addCustom(payload) {
   await loadModels(true)
 }
 
-/* 连通性测试:后端发一个 "hi" 走真实客户端,失败时 **不抛** 而是返回 {ok:false,error}
-   —— 那正是要显示给用户看的东西,别当异常吞掉。 */
 export async function testModel(payload) {
   return postJSON('/llm/test', payload)
 }
 
-/* 单个自定义模型详情:api_key 永不出网,只回 has_key(编辑表单里留空即保留原值) */
 export async function getCustom(name) {
   return getJSON(`/llm/custom/${encodeURIComponent(name)}`)
 }

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

@@ -1,6 +1,3 @@
-/* 左栏菜单 8 项的数据层。
-   一项一个 loader,内部每个端点单独 .catch —— 某个子系统挂了只让对应区块空着,
-   不让整个面板变「后端未连接」。组件只负责渲染,不各自写 fetch。 */
 import { reactive } from 'vue'
 import { getJSON, getRaw, delJSON, patchJSON, postJSON } from '../api.js'
 import { openDoc } from './app.js'
@@ -15,15 +12,10 @@ export const panels = reactive({
   usage: { state: 'idle', tokens: null, gateway: {}, metrics: null, slow: [] },
   knowledge: {
     state: 'idle', stats: {}, index: {}, sources: [], abilities: [],
-    /* 最近录入的知识单元:右栏只读前 10 条,面板看全量 */
     recent: [], recentTotal: 0,
-    /* 录入是同步 LLM 抽取,可能几十秒 —— 状态提到 store 里,
-       切到别的面板再回来时不会以为「没提交过」 */
     ingest: 'idle', ingestMsg: '', ingestErr: '',
   },
-  memory: { state: 'idle', stats: {}, recent: [], prefs: [] },
-  /* SM-2 复习:stats 是全局账本,queue 是「今天这一轮要过的卡」。
-     session 放 store 是因为复习到一半点开文档再回来,不能让进度归零。 */
+  memory: { state: 'idle', stats: {}, recent: [], prefs: [], pending: [] },
   review: {
     state: 'idle',
     stats: { cards: 0, learned: 0, fresh: 0, due: 0, avg_mastery: 0, load7: {}, risk: [] },
@@ -36,7 +28,6 @@ export const panels = reactive({
 })
 
 const LOADERS = {
-  /* 活动 = 事件总线(系统发生了什么) + 请求链路(哪次调用慢) + 思考链健康度 */
   async activity(p) {
     const [bus, traces, thought] = await Promise.all([
       safe(getJSON('/bus/history?limit=40')),
@@ -49,7 +40,6 @@ const LOADERS = {
     return !!(bus || traces || thought)
   },
 
-  /* 任务 = 调度器记账 + 进程生命周期(后端把每个任务建模成进程) */
   async tasks(p) {
     const [sched, proc] = await Promise.all([
       safe(getJSON('/scheduler/stats')),
@@ -61,7 +51,6 @@ const LOADERS = {
     return !!(sched || proc)
   },
 
-  /* 代理 = /api/status(全部 Agent 的 harness + 思考链) + 系统信息 */
   async agents(p) {
     const [all, info] = await Promise.all([
       safe(getJSON('/status')),
@@ -72,7 +61,6 @@ const LOADERS = {
     return !!(all || info)
   },
 
-  /* 技能 = 内置/HTTP/MCP 技能表 + 指令技能(SKILL.md) + 熔断器 */
   async tools(p) {
     const [sk, md, br] = await Promise.all([
       safe(getJSON('/ahs/skills')),
@@ -85,7 +73,6 @@ const LOADERS = {
     return !!(sk || md || br)
   },
 
-  /* 使用情况 = token 计量 + 网关配额 + 端点延迟(p95 最慢的几条) */
   async usage(p) {
     const [tk, gw, mt] = await Promise.all([
       safe(getJSON('/tokens')),
@@ -102,8 +89,6 @@ const LOADERS = {
     return !!(tk || gw || mt)
   },
 
-  /* 知识库 = HKC 根路径 /stats 与 /knowledge/sources,加 Foxclaw 侧能力清单
-     与最近录入的 KU(右栏和面板共用这一份) */
   async knowledge(p) {
     const [st, src, ab, rc] = await Promise.all([
       safe(getRaw('/stats')),
@@ -120,8 +105,6 @@ const LOADERS = {
     return !!(st || src || ab || rc)
   },
 
-  /* 复习 = SM-2 账本 + 今日队列。会话进行中只更新账本,不动队列 ——
-     否则右栏刷新一次就把当前卡片换掉了。 */
   async review(p) {
     const [st, q] = await Promise.all([
       safe(getJSON('/review/stats')),
@@ -137,24 +120,24 @@ const LOADERS = {
     return !!(st || q)
   },
 
-  /* 记忆中心 = HMR 统计 + 最近记忆 + 用户偏好 */
   async memory(p) {
-    const [st, rc, pf] = await Promise.all([
+    const [st, rc, pf, pd] = await Promise.all([
       safe(getJSON('/memory/stats')),
       safe(getJSON('/memory/recent?limit=12')),
       safe(getJSON('/preferences')),
+      safe(getJSON('/memory/pending')),
     ])
     p.stats = st || {}
     p.recent = rc?.memories || []
     p.prefs = pf?.preferences || []
-    return !!(st || rc || pf)
+    p.pending = pd?.pending || []
+    return !!(st || rc || pf || pd)
   },
 }
 
 export async function loadPanel(id, force = false) {
   const p = panels[id]
   if (!p || !LOADERS[id]) return
-  /* 已有数据就不重拉:切换菜单来回点不重复打后端;要新数据显式刷新 */
   if (!force && p.state !== 'idle' && p.state !== 'error') return
   p.state = 'loading'
   let ok = false
@@ -164,18 +147,11 @@ export async function loadPanel(id, force = false) {
 
 export const refreshPanel = (id) => loadPanel(id, true)
 
-/* ── 面板内的写操作(都是真实端点,不是本地假删除) ── */
-
-/* 指令技能启停:PATCH /ahs/md-skills/{id} → 全量重拉一次保证和服务端一致 */
 export async function toggleMdSkill(id, enabled) {
   await patchJSON(`/ahs/md-skills/${encodeURIComponent(id)}`, { enabled })
   await refreshPanel('tools')
 }
 
-/* 录入一段短知识:POST /knowledge/ingest → KDE 抽取成 KU → KEE 演化。
-   同步 LLM 抽取,可能几十秒,所以状态挂在 store 上而不是组件里。
-   成功后**静默重拉**:走 refreshPanel 会把 state 置回 loading,整面板闪骨架,
-   而这里只想要新数据。 */
 export async function ingestKnowledge({ text, title = '', domain = '' }) {
   const p = panels.knowledge
   const body = (text || '').trim()
@@ -197,8 +173,6 @@ export async function ingestKnowledge({ text, title = '', domain = '' }) {
     const n = d?.ku_count ?? 0
     p.ingestMsg = n
       ? `已抽取 ${n} 条知识单元${counts ? ` · ${counts}` : ''}`
-      /* 走到这里说明 LLM 调用是成功的(全失败会 502 进 catch),只是这段文字里
-         没抽出 Concept/Fact/Claim/Entity。别提示"没配模型"误导用户去改 key。 */
       : '模型没从这段文字里抽出知识条目 —— 试试写得更具体(谁 / 是什么 / 为什么)'
     try { await LOADERS.knowledge(p); p.state = 'ok' } catch {}
     return d
@@ -209,9 +183,6 @@ export async function ingestKnowledge({ text, title = '', domain = '' }) {
   }
 }
 
-/* ── SM-2 复习会话 ── */
-
-/* 开一轮:队列空了就先拉一次。会话状态在 store 里,点开文档再回来不丢进度。 */
 export async function startReview() {
   const p = panels.review
   if (!p.queue.length) await loadPanel('review', true)
@@ -226,9 +197,6 @@ export function revealCard() {
   panels.review.revealed = true
 }
 
-/* 评分 → 服务端按 SM-2 算下一次间隔 → 翻到下一张。
-   四档对应 SM-2 的 0/3/4/5:0 完全忘记(重置)、3 勉强、4 记住、5 轻松。
-   只更新账本不动队列 —— 队列是这一轮的现场。 */
 export async function gradeCard(grade) {
   const p = panels.review
   const card = p.queue[p.index]
@@ -244,13 +212,22 @@ export async function gradeCard(grade) {
   return d
 }
 
-/* 删除一条误存的偏好:DELETE /preferences/{id} */
 export async function dropPreference(id) {
   await delJSON(`/preferences/${encodeURIComponent(id)}`)
   await refreshPanel('memory')
 }
 
-/* 技能 / KU 正文 → 中间舞台。kind 决定皮肤:code 走 CLI 黑底,text 走排版正文 */
+// 高敏感内容被闸门拦下后停在这里,用户点头才落库(见 foxclaw/core/sensitive_write.py)
+export async function approveSensitiveWrite(id) {
+  await postJSON(`/memory/pending/${encodeURIComponent(id)}/approve`, {})
+  await refreshPanel('memory')
+}
+
+export async function rejectSensitiveWrite(id) {
+  await postJSON(`/memory/pending/${encodeURIComponent(id)}/reject`, {})
+  await refreshPanel('memory')
+}
+
 export async function openMdSkill(id) {
   const d = await getJSON(`/ahs/md-skills/${encodeURIComponent(id)}`)
   openDoc({
@@ -264,8 +241,6 @@ export async function openMdSkill(id) {
   })
 }
 
-/* extra 里的业务字段逐类型不同(Fact 有 statement、Evidence 有 source、Entity 有 aliases),
-   按类型硬编码会漏;这里统一按「有值就列出来」处理,任何 KU 打开都有内容可读。 */
 const KU_FIELDS = [
   ['statement', '陈述'],
   ['definition', '定义'],
@@ -289,8 +264,6 @@ const kuVal = (v) => {
   return v === 0 || v === '' || v == null ? '' : String(v)
 }
 
-/* 单个 KU 的正文 → 中间舞台。走 HKC 根路径 /knowledge/ku/{id}
-   (那条路径带 source_text,列表/图谱的响应为了瘦身把它剔掉了) */
 export async function openKu(id) {
   const d = await getRaw(`/knowledge/ku/${encodeURIComponent(id)}`)
   const extra = d.extra || {}
@@ -298,7 +271,6 @@ export async function openKu(id) {
   const rows = KU_FIELDS
     .map(([k, label]) => [label, kuVal(extra[k])])
     .filter(([, v]) => v)
-  /* statement 已经在标题下一行重复过一次,正文里不再复读 */
   const body = rows.filter(([, v]) => v !== d.summary && v !== d.name)
 
   const parts = []

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

@@ -0,0 +1,31 @@
+import { reactive } from 'vue'
+import { getJSON, putJSON } from '../api.js'
+
+export const profile = reactive({
+  nickname: '',
+  loaded: false,
+  saving: false,
+})
+
+export async function loadProfile(force = false) {
+  if (profile.loaded && !force) return profile
+  try {
+    const d = await getJSON('/profile')
+    profile.nickname = d.nickname || ''
+    profile.loaded = true
+  } catch {
+  }
+  return profile
+}
+
+export async function saveNickname(nick) {
+  profile.saving = true
+  try {
+    const d = await putJSON('/profile', { nickname: nick || '' })
+    profile.nickname = d.nickname || ''
+    profile.loaded = true
+    return profile.nickname
+  } finally {
+    profile.saving = false
+  }
+}

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

@@ -0,0 +1,25 @@
+import { reactive } from 'vue'
+import { getJSON } from '../api.js'
+
+export const system = reactive({
+  version: '',
+  update: null,   // { enabled, current, latest, update_available, checked_at, error }
+  loaded: false,
+})
+
+let inflight = null
+
+export function loadSystemInfo(force = false) {
+  if (system.loaded && !force) return Promise.resolve(system)
+  if (inflight) return inflight
+  inflight = getJSON('/system/info')
+    .then((d) => {
+      system.version = d.version || ''
+      system.update = d.update || null
+      system.loaded = true
+      return system
+    })
+    .catch(() => system)      // 拿不到就维持旧值:顶栏不显示版本,不显示更新
+    .finally(() => { inflight = null })
+  return inflight
+}

package/python/frontend_src/vite.config.js

@@ -3,8 +3,6 @@ import { defineConfig } from 'vite'
 import vue from '@vitejs/plugin-vue'
 import { fileURLToPath, URL } from 'node:url'
 
-/* 设置面板底部的版本行照 OpenClaw 写成 git@<sha> · <N 天前>。
-   构建时抓一次 git 信息;没有 git(打包机 / 压缩包)就退回 dev,不让构建失败。 */
 function gitInfo() {
   try {
     const sha = execSync('git rev-parse --short HEAD', { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim()
@@ -15,9 +13,6 @@ function gitInfo() {
   }
 }
 
-/* 产物直接写进 frontend/v3/,后端 (StaticFiles(directory=frontend, html=True)) 零改动:
-   /v3/ -> frontend/v3/index.html
-   base 必须是 '/v3/',否则 assets 会打到站点根。 */
 export default defineConfig({
   base: '/v3/',
   plugins: [vue()],
@@ -34,12 +29,10 @@ export default defineConfig({
   },
   server: {
     port: 5173,
-    /* dev 时把 API 与 WS 透到本地后端,前端代码里一律用相对路径 /api */
     proxy: {
       '/api': { target: 'http://127.0.0.1:8000', changeOrigin: true },
       '/ws': { target: 'ws://127.0.0.1:8000', ws: true },
       '/planet': { target: 'http://127.0.0.1:8000', changeOrigin: true },
-      /* /knowledge/* 无 /api 前缀:HKC 自带 router 由后端根路径挂载 */
       '/knowledge': { target: 'http://127.0.0.1:8000', changeOrigin: true },
     },
   },