foxclaw 0.1.2 → 0.1.3

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 是因为复习到一半点开文档再回来,不能让进度归零。 */
   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,7 +120,6 @@ const LOADERS = {
     return !!(st || q)
   },
 
-  /* 记忆中心 = HMR 统计 + 最近记忆 + 用户偏好 */
   async memory(p) {
     const [st, rc, pf] = await Promise.all([
       safe(getJSON('/memory/stats')),
@@ -154,7 +136,6 @@ const LOADERS = {
 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 +145,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 +171,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 +181,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 +195,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 +210,11 @@ 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 走排版正文 */
 export async function openMdSkill(id) {
   const d = await getJSON(`/ahs/md-skills/${encodeURIComponent(id)}`)
   openDoc({
@@ -264,8 +228,6 @@ export async function openMdSkill(id) {
   })
 }
 
-/* extra 里的业务字段逐类型不同(Fact 有 statement、Evidence 有 source、Entity 有 aliases),
-   按类型硬编码会漏;这里统一按「有值就列出来」处理,任何 KU 打开都有内容可读。 */
 const KU_FIELDS = [
   ['statement', '陈述'],
   ['definition', '定义'],
@@ -289,8 +251,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 +258,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 },
     },
   },

package/python/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "foxclaw"
-version = "0.1.2"
+version = "0.1.3"
 description = "Foxclaw - a personal agent with memory, built on the HMR memory runtime"
 requires-python = ">=3.11"
 
@@ -134,12 +134,12 @@ python_version = "3.11"
 ignore_missing_imports = true
 check_untyped_defs = true
 # 渐进式:mypy 存量错误用棘轮门管理(tools/mypy_ratchet.py + tools/mypy_baseline.txt)。
-# 2026-11 实测 673 errors in 90 files,已冻结:CI 中错误数一旦增加即失败,
+# 2026-11 实测 152 errors in 45 files,已冻结:CI 中错误数一旦增加即失败,
 # 下降后用 `python tools/mypy_ratchet.py --update` 调低基线。只降不升。
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-# S2 迁移完成:全部 76 个测试文件均已迁移为 pytest(无顶层 import 副作用,可安全收集)。
+# S2 迁移完成:全部测试文件均已迁移为 pytest(无顶层 import 副作用,可安全收集)。
 # 注意:网关/内置MCP/流式限流等少数测试依赖模块级单例(FOXCLAW_GATEWAY、FOXCLAW_MCP_SERVER、
 # _STREAM_LIMITER 均在 import 时按 env 固化),单进程 `pytest tests/` 会让这些单例被首个
 # import 定死、相互污染。故全量执行统一走 tests/run_all.py(每个文件独立子进程
@@ -214,6 +214,7 @@ python_files = [
     "test_plan_visible.py",
     "test_planner.py",
     "test_policy_gate.py",
+    "test_profile.py",
     "test_reasoner.py",
     "test_release_check.py",
     "test_resume_checkpoint.py",
@@ -229,6 +230,7 @@ python_files = [
     "test_secrets.py",
     "test_skill_taint_gate.py",
     "test_skills.py",
+    "test_skills_fetch.py",
     "test_stats_and_events.py",
     "test_streaming.py",
     "test_supervisor_pipeline.py",
@@ -246,6 +248,7 @@ python_files = [
     "test_tracing.py",
     "test_truth_crystallizer.py",
     "test_truth_flow.py",
+    "test_update_check.py",
     "test_url_policy.py",
     "test_version_sync.py",
     "test_web_trigger.py",