foxclaw 0.1.2 → 0.1.4

package/python/frontend/deck/markdown.js

@@ -1,12 +1,8 @@
 import { escapeHtml } from './util.js';
 
-/* ===== 安全 Markdown 渲染(模型输出不可信 → 先整体转义,再只发白名单标签;URL 校验 scheme)=====
-   支持:标题/粗斜体/行内码/代码块/列表/引用/分割线/链接/图片,以及裸图/音/视频 URL 内嵌。
-   代码块占位哨兵用私用区字符 (源码里是 ASCII 转义、运行时是该字符,模型文本不会出现 → 无碰撞)。*/
 function _safeUrl(u){ u=(u||'').trim(); return (/^https?:\/\//i.test(u)||/^mailto:/i.test(u))?u:''; }
 function _safeImgUrl(u){ u=(u||'').trim(); return (/^https?:\/\//i.test(u)||/^data:image\/(png|jpe?g|gif|webp);base64,/i.test(u))?u:''; }
 function _mdInline(s){
-  // s 已在 renderMarkdown 里被 escapeHtml,故 <>&" 均为文本;这里只做 markdown 内联生成白名单标签
   s=s.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g,(m,alt,url)=>{ const u=_safeImgUrl(url); return u?`<img class="cc-img" src="${u}" alt="${alt}" loading="lazy">`:m; });
   s=s.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g,(m,txt,url)=>{ const u=_safeUrl(url); return u?`<a href="${u}" target="_blank" rel="noopener noreferrer">${txt}</a>`:m; });
   s=s.replace(/(^|\s)(https?:\/\/[^\s<]+?\.(?:png|jpe?g|gif|webp))(?=\s|$)/gi,(m,pre,url)=>`${pre}<img class="cc-img" src="${url}" alt="" loading="lazy">`);

package/python/frontend/deck/settings.js

@@ -1,13 +1,11 @@
 import { API } from './state.js';
 
-/* ===== 设置面板 ===== */
 const SETTINGS_TITLE={
   model:'模型路由',runtime:'运行参数',ui:'界面偏好',data:'数据管理',auth:'访问密钥',about:'关于',
   'ag-supervisor':'主管 Agent','ag-finance':'财务 Agent','ag-admin':'行政 Agent',
   'ag-office':'办公 Agent','ag-assistant':'助手 Agent',
   'mem-backend':'记忆后端','mem-layer':'双层记忆','mem-recall':'召回参数','mem-manage':'记忆管理',
 };
-// 界面偏好(纯前端,存内存)
 export const uiPref={ autoChat:true, ballAnim:false, mapStyle:'light' };  // ballAnim 默认 false(球体特效默认关,省 GPU;需要时手动勾)
 let _sysInfo=null;
 async function fetchSysInfo(){ try{ _sysInfo=await(await fetch(`${API}/system/info`)).json(); }catch(e){ _sysInfo=null; } return _sysInfo; }
@@ -15,7 +13,6 @@ async function fetchSysInfo(){ try{ _sysInfo=await(await fetch(`${API}/system/in
 async function renderSettingDetail(key){
   const body=document.getElementById('sdBody');
   body.innerHTML='<div class="sd-ph">加载中…</div>';
-  // ── Foxclaw 主系统 ──
   if(key==='model'){
     const d=await fetchSysInfo(); const m=d?.model||{};
     let h=`<div class="sd-card"><div class="sd-k">当前模型</div>
@@ -91,7 +88,7 @@ async function renderSettingDetail(key){
       <div class="sd-kv"><span>办公 Office</span><b>学习 · 知识图谱</b></div>
       <div class="sd-kv"><span>助手 Assistant</span><b>通用 · Skill 接入</b></div>
       <div class="sd-sec">三大模块</div>
-      <div class="sd-desc">Foxclaw(主系统) · Agents(五智能体) · HMR(记忆系统)</div>
+      <div class="sd-desc">Foxclaw(主系统) · Agents(三智能体) · HMR(记忆系统)</div>
       <div class="sd-note">配置说明见项目 <code>docs/配置指南.md</code></div>`;
   }else if(key && key.startsWith('mem-')){
     const s=await(await fetch(`${API}/memory/stats`)).json().catch(()=>({}));
@@ -138,7 +135,6 @@ async function renderSettingDetail(key){
   }
 }
 
-/* 单个 Agent 设置详情(5 个共用 + 领域特定块)*/
 const AGENT_META={
   supervisor:{cn:'主管',en:'Supervisor',ac:'#ffc24b',role:'分诊调度 · 全局态势编排'},
   finance:{cn:'财务',en:'Finance',ac:'#00ffb2',role:'理财 · 预算 · 风控守门'},
@@ -159,7 +155,6 @@ async function renderAgentDetail(aid, body){
     <div class="sd-big" style="color:${meta.ac}">${meta.cn} <span>${meta.en}</span></div>
     <div class="sd-desc">${meta.role}</div></div>`;
 
-  // Harness 漂移检测
   h+='<div class="sd-sec">Harness 漂移检测<span class="badge ro">只读</span></div>';
   h+=`<div class="sd-kv"><span>运行模式</span><b style="color:${shadow?'var(--amber)':'var(--green)'}">${shadow?'影子校准中':'已激活拦截'}</b></div>`;
   h+=`<div class="sd-kv"><span>校准进度</span><b>${run} / ${rounds} 轮</b></div>`;
@@ -171,7 +166,6 @@ async function renderAgentDetail(aid, body){
     h+=`<div class="sd-kv"><span>三维权重</span><b>语义 ${fmt(w.semantic)} · 工具 ${fmt(w.tool)} · 范围 ${fmt(w.scope)}</b></div>`;
   }
 
-  // 守门人 Policy
   h+='<div class="sd-sec">守门人 Policy<span class="badge ro">只读</span></div>';
   if(pol.version!=null||pol.total_rules!=null){
     h+=`<div class="sd-kv"><span>Policy 版本</span><b>v${pol.version??'—'}</b></div>`;
@@ -181,7 +175,6 @@ async function renderAgentDetail(aid, body){
     h+='<div class="sd-desc">策略随运行自学习更新,当前无自定义规则覆盖。</div>';
   }
 
-  // 领域特定块
   if(aid==='admin'){
     h+='<div class="sd-sec">高德地图(行政专属)<span class="badge ro">只读</span></div>';
     const a=sys?.amap||{};
@@ -207,7 +200,6 @@ async function renderAgentDetail(aid, body){
   h+='<div class="sd-note">Agent 行为参数大多在后端 policy 与代码中定义,此处为只读状态展示。漂移阈值由影子校准期自动学习得出。</div>';
   body.innerHTML=h;
 
-  // 行政地图暗色开关联动
   const md=document.getElementById('pf-mapDark2');
   if(md) md.onchange=e=>{ uiPref.mapStyle=e.target.checked?'dark':'light'; };
 }
@@ -218,17 +210,12 @@ export async function switchProvider(prov){
 }
 function toggleBallAnim(on){
   const c=document.getElementById('coreCanvas'); if(c)c.style.display=on?'block':'none';
-  // 仅 display:none 不够(loop 还在 60fps 跑,吃 GPU)→ 同步设置 localStorage 标志,
-  // 引导用户硬刷一次(自动 reload)。visuals.js 顶部 _lowpower 检查,刷新后即生效。
   try{ localStorage.setItem('foxclaw_lowpower', on ? '0' : '1'); }catch{}
-  // 仅当「关」才 reload(开不影响,因为持久态 = 0 时不阻止)
   if (!on) {
-    // 提示一下,避免用户疑惑
     console.info('[foxclaw] 关掉球动画后需刷新一次才停止 GPU 占用');
   }
 }
 
-/* 二级子项定义 */
 const SETTINGS_SUBS={
   foxclaw:[['model','模型路由'],['runtime','运行参数'],['ui','界面偏好'],['data','数据管理'],['auth','访问密钥'],['about','关于']],
   agents:[['ag-supervisor','主管 Agent'],['ag-finance','财务 Agent'],['ag-admin','行政 Agent'],['ag-office','办公 Agent'],['ag-assistant','助手 Agent']],
@@ -240,13 +227,11 @@ const _sdPop=document.getElementById('sdPop');
 let _setHideTimer=null;
 
 export function openSetMenu(){ clearTimeout(_setHideTimer); _setMenu.classList.add('show'); }
-/* 直接打开「访问密钥」设置详情(供 main.js 的鉴权提示条调用) */
 export function openAuthSetting(){ _setMenu.classList.add('show'); openDetailPop('auth'); }
 function closeSetMenu(){
   clearTimeout(_setHideTimer);
   _setHideTimer=setTimeout(()=>{ _setMenu.classList.remove('show'); _smL2.innerHTML=''; document.querySelectorAll('.sm-l1 .sm-btn').forEach(b=>b.classList.remove('active')); }, 400);
 }
-// 一级悬停 → 展开二级
 function showL2(group, l1btn){
   document.querySelectorAll('.sm-l1 .sm-btn').forEach(b=>b.classList.remove('active'));
   l1btn.classList.add('active');
@@ -279,8 +264,6 @@ document.querySelectorAll('.nav-mini, .feed-item').forEach(it=>{
   it.addEventListener('click',()=>{ it.classList.add('pressed'); setTimeout(()=>it.classList.remove('pressed'),180); });
 });
 
-
-/* ===== 模型选择器 ===== */
 const PROVIDER_LABEL=
 {anthropic:{n:'Claude',c:'#ff9d00'},openai:{n:'GPT',c:'#00ffb2'},
   google:{n:'Gemini',c:'#38bdf8'},qwen:{n:'通义千问',c:'#ffc24b'},

package/python/frontend/deck/state.js

@@ -1,4 +1,3 @@
-/* 跨模块共享:URL 常量 + 内核数据缓存(零构建,显式 live-binding 导出) */
 const _origin=(location.protocol==='http:'||location.protocol==='https:')?location.origin:'http://localhost:8000';
 const API=_origin+'/api';
 const WS=_origin.replace(/^http/,'ws')+'/ws/harness';

package/python/frontend/deck/util.js

@@ -1,5 +1,3 @@
-/* 安全:HTML 转义 —— 模型输出/用户输入/外部数据写入 innerHTML 前必须转义,防 XSS
-   (模型输出不可信,可能被提示注入产出 <img onerror> 等)。*/
 export function escapeHtml(s){
   return String(s==null?'':s).replace(/[&<>"']/g,c=>(
     {'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));

package/python/frontend/deck/visuals.js

@@ -1,28 +1,15 @@
-/* ═══════ 球体特效开关:默认关,需要时手动开 ═══════
-   ─ 手动开(任一即生效):
-     1) URL 加 ?visual=1                            临时(本次会话)
-     2) localStorage.foxclaw_visual = "1"            永久
-     3) 设置 → 界面偏好 → 背景全息球动画 勾选      永久(写 localStorage.foxclaw_lowpower=0,兼容旧 toggle)
-   ─ 系统级默认关(无需操作):
-     4) matchMedia('(prefers-reduced-motion: reduce)').matches
-     5) navigator.connection.saveData === true
-   ─ 默认:true(不启动 4 个 canvas 动画 + 粒子 emit,省 GPU/CPU,启动秒开) */
 const _lowpower = (() => {
   try {
-    // 显式开:URL / localStorage / 旧版 toggleBallAnim
     if (new URLSearchParams(location.search).get('visual') === '1') return false;
     if (localStorage.getItem('foxclaw_visual') === '1') return false;
     if (localStorage.getItem('foxclaw_lowpower') === '0') return false;   // 兼容旧版开关
-    // 显式关:URL ?low=1 仍生效(应急)
     if (new URLSearchParams(location.search).get('low') === '1') return true;
-    // 系统级 → 关
     if (matchMedia('(prefers-reduced-motion: reduce)').matches) return true;
     if (navigator.connection && navigator.connection.saveData) return true;
   } catch {}
   return true;   // ← 默认:不启动(保护 GPU + 启动秒开)
 })();
 window._foxclawLowpower = _lowpower;   // 暴露给其他模块读
-// 暴露切换 API(控制台手动开:  foxclawVisual.on()  /  永久关:  foxclawVisual.off()  /  状态:  foxclawVisual.isOn())
 window.foxclawVisual = {
   isOn: () => !_lowpower,
   on()  { try { localStorage.setItem('foxclaw_visual', '1'); } catch{} location.reload(); },
@@ -36,7 +23,6 @@ function _lpThrottle(fn, fps) {       // 30fps 节流(不关,但降频)— 关
   return function(t) { if (t - last >= gap) { last = t; fn(t); } };
 }
 
-/* ====== 中央全息核心 ====== */
 (function(){
   if (_lowpower) return;        // 省电:不开中央全息核心(520 球面点 + 经纬弧 + 渐变 60fps)
   const c=document.getElementById('coreCanvas'), x=c.getContext('2d');
@@ -50,13 +36,11 @@ function _lpThrottle(fn, fps) {       // 30fps 节流(不关,但降频)— 关
     x.clearRect(0,0,c.width,c.height);
     const cx=c.width/2, cy=c.height/2, R=Math.min(cx,cy)*0.62;
     rot+=0.0024;
-    // 光环底座
     for(let k=0;k<3;k++){
       x.beginPath();
       x.ellipse(cx,cy+R*0.92,R*(1.05+k*0.18),R*(0.26+k*0.05),0,0,Math.PI*2);
       x.strokeStyle=`rgba(0,217,255,${0.18-k*0.04})`; x.lineWidth=2; x.stroke();
     }
-    // 球面点
     for(const pt of pts){
       const t=pt.t, p=pt.p+rot;
       const xx=Math.sin(t)*Math.cos(p), yy=Math.cos(t), zz=Math.sin(t)*Math.sin(p);
@@ -66,7 +50,6 @@ function _lpThrottle(fn, fps) {       // 30fps 节流(不关,但降频)— 关
       const hue=depth>0.5?'0,217,255':'255,194,75';
       x.fillStyle=`rgba(${hue},${depth*0.85+0.1})`; x.fill();
     }
-    // 经纬弧
     x.strokeStyle='rgba(41,243,255,.12)';x.lineWidth=1;
     for(let m=0;m<6;m++){
       x.beginPath();
@@ -75,7 +58,6 @@ function _lpThrottle(fn, fps) {       // 30fps 节流(不关,但降频)— 关
         const sx=cx+xx*R,sy=cy+yy*R; a?x.lineTo(sx,sy):x.moveTo(sx,sy);}
       x.stroke();
     }
-    // 中央辉光
     const g=x.createRadialGradient(cx,cy,0,cx,cy,R*0.5);
     g.addColorStop(0,'rgba(0,217,255,.28)');g.addColorStop(1,'transparent');
     x.fillStyle=g;x.beginPath();x.arc(cx,cy,R*0.5,0,Math.PI*2);x.fill();
@@ -84,7 +66,6 @@ function _lpThrottle(fn, fps) {       // 30fps 节流(不关,但降频)— 关
   loop();
 })();
 
-/* ====== 记忆向量空间 ====== */
 (function(){
   if (_lowpower) return;        // 省电:不开记忆向量空间动画
   const c=document.getElementById('memCanvas'); if(!c) return;   // 右栏改版后无此装饰画布 → 静默跳过
@@ -113,7 +94,6 @@ function _lpThrottle(fn, fps) {       // 30fps 节流(不关,但降频)— 关
   loop();
 })();
 
-/* ====== 中枢数据流:核心球↔Agent 信息流动 ====== */
 (function(){
   if (_lowpower) return;        // 省电:不开中枢数据流 + 2.2s 粒子 emit
   const cv=document.getElementById('streamCanvas'); if(!cv)return;
@@ -139,7 +119,6 @@ function _lpThrottle(fn, fps) {       // 30fps 节流(不关,但降频)— 关
     if(!targets.length)return;
     let t;
     if(targetAgent){
-      // 定向:射向指定 Agent(发任务时用)
       const cards=[...document.querySelectorAll('.acard')];
       const idx=cards.findIndex(c=>c.dataset.agent===targetAgent);
       t=idx>=0?targets[idx]:targets[Math.floor(Math.random()*targets.length)];
@@ -185,7 +164,6 @@ function _lpThrottle(fn, fps) {       // 30fps 节流(不关,但降频)— 关
   setTimeout(emit, 800);
 })();
 
-/* ====== 系统活动波形(已移除,保留空值保护)====== */
 (function(){
   if (_lowpower) return;        // 省电:不开系统活动波形
   const c=document.getElementById('actCanvas'); if(!c)return;