@customize-agent/server 4.0.94 → 4.0.95

package/.next/static/chunks/pages/system/{logs-cbeeb77dc70086ae.js → logs-c97311a24d1a67e1.js}

@@ -1 +1 @@
-(self.webpackChunk_N_E=self.webpackChunk_N_E||[]).push([[979],{14995:(e,t)=>{"use strict";t.A={icon:{tag:"svg",attrs:{viewBox:"64 64 896 896",focusable:"false"},children:[{tag:"path",attrs:{d:"M909.1 209.3l-56.4 44.1C775.8 155.1 656.2 92 521.9 92 290 92 102.3 279.5 102 511.5 101.7 743.7 289.8 932 521.9 932c181.3 0 335.8-115 394.6-276.1 1.5-4.2-.7-8.9-4.9-10.3l-56.7-19.5a8 8 0 00-10.1 4.8c-1.8 5-3.8 10-5.9 14.9-17.3 41-42.1 77.8-73.7 109.4A344.77 344.77 0 01655.9 829c-42.3 17.9-87.4 27-133.8 27-46.5 0-91.5-9.1-133.8-27A341.5 341.5 0 01279 755.2a342.16 342.16 0 01-73.7-109.4c-17.9-42.4-27-87.4-27-133.9s9.1-91.5 27-133.9c17.3-41 42.1-77.8 73.7-109.4 31.6-31.6 68.4-56.4 109.3-73.8 42.3-17.9 87.4-27 133.8-27 46.5 0 91.5 9.1 133.8 27a341.5 341.5 0 01109.3 73.8c9.9 9.9 19.2 20.4 27.8 31.4l-60.2 47a8 8 0 003 14.1l175.6 43c5 1.2 9.9-2.6 9.9-7.7l.8-180.9c-.1-6.6-7.8-10.3-13-6.2z"}}]},name:"reload",theme:"outlined"}},39214:(e,t,r)=>{(window.__NEXT_P=window.__NEXT_P||[]).push(["/system/logs",function(){return r(91698)}])},91698:(e,t,r)=>{"use strict";r.r(t),r.d(t,{default:()=>k});var a=r(65321),s=r(97109),i=r(35292),n=r(9137),l=r(11702),o=r(88762),c=r(33442),d=r(85114),h=r(26171),p=r(85493),g=r(7576),u=r(21289),x=r(84253),f=r(99811),y=r(58209),m=r(96651),w=r(60470),j=r(79059),v=r(6578);let{Text:A,Paragraph:b}=i.A;function k(){let e=(0,j.Vr)(),[t,r]=(0,s.useState)([]),[i,k]=(0,s.useState)(!0),[S,z]=(0,s.useState)(""),[I,C]=(0,s.useState)(!1),N=async()=>{k(!0);try{r((await (0,v.oH)(500)).logs)}catch(e){n.Ay.error(e instanceof Error?e.message:"加载日志失败")}finally{k(!1)}};(0,s.useEffect)(()=>{N()},[]);let B=(0,s.useMemo)(()=>{let e=S.trim().toLowerCase();return e?t.filter(t=>[t.id,t.level,t.source,t.functionName,t.message,t.stack].filter(Boolean).some(t=>String(t).toLowerCase().includes(e))):t},[S,t]),O=[{title:"序号",key:"index",width:70,render:(e,t,r)=>r+1},{title:"时间",dataIndex:"createdAt",width:170,render:e=>new Date(e).toLocaleString()},{title:"级别",dataIndex:"level",width:80,render:e=>(0,a.jsx)(l.A,{color:"error"===e?"error":"warn"===e?"warning":"blue",style:{margin:0},children:e})},{title:"来源",dataIndex:"source",width:200,render:e=>(0,a.jsx)(A,{code:!0,style:{fontSize:12},children:e})},{title:"函数",dataIndex:"functionName",width:160,render:e=>e?(0,a.jsx)(A,{code:!0,style:{fontSize:12},children:e}):(0,a.jsx)(A,{type:"secondary",children:"-"})},{title:"错误信息",dataIndex:"message",render:e=>(0,a.jsx)(b,{style:{maxWidth:480,overflowWrap:"anywhere",wordBreak:"break-all",marginBottom:0,fontSize:12},ellipsis:{rows:2,expandable:!0,symbol:"展开"},children:e})},{title:"Request ID",dataIndex:"id",width:200,render:e=>(0,a.jsx)(A,{copyable:!0,code:!0,style:{fontSize:12},children:e.slice(0,8)})}];return i&&0===t.length?(0,a.jsxs)("div",{className:"space-y-5 animateFadeIn",children:[(0,a.jsx)(o.A,{active:!0,title:!0,paragraph:{rows:1}}),(0,a.jsx)(o.A,{active:!0,paragraph:{rows:12}})]}):(0,a.jsxs)("div",{className:"space-y-5 animateFadeIn",children:[(0,a.jsxs)("div",{style:{display:"flex",alignItems:"center",justifyContent:"space-between",flexWrap:"wrap",gap:12},children:[(0,a.jsxs)("div",{children:[(0,a.jsx)("h1",{className:"pageTitle",children:e("nav.systemLogs")}),(0,a.jsx)("p",{className:"pageDesc",children:"查看 API 异常、模型健康检查失败、PDF 降级等运行时问题。"})]}),(0,a.jsxs)(c.A,{children:[(0,a.jsx)(d.Ay,{icon:(0,a.jsx)(f.A,{}),loading:i,onClick:()=>void N(),children:"刷新"}),(0,a.jsx)(h.A,{title:"确认清空所有错误日志？",onConfirm:()=>{(async()=>{await (0,v.hH)(),n.Ay.success("已清空"),await N()})()},children:(0,a.jsx)(d.Ay,{danger:!0,icon:(0,a.jsx)(y.A,{}),children:"清空日志"})})]})]}),(0,a.jsx)(p.A,{type:"info",showIcon:!0,message:(0,a.jsxs)("div",{style:{display:"flex",alignItems:"center",justifyContent:"space-between"},children:[(0,a.jsx)("span",{children:"日志保存在本机 ~/.customize-agent/logs/errors.jsonl，最多读取最近 500 条。"}),(0,a.jsx)(d.Ay,{type:"link",size:"small",icon:I?(0,a.jsx)(m.A,{}):(0,a.jsx)(w.A,{}),onClick:()=>C(!I),style:{padding:"0 4px"},children:I?"收起":"展开"})]}),description:I?"系统自动记录未捕获的异常、API 错误、模型健康检查失败等运行时问题。日志文件超过 2MB 会自动轮转。":void 0}),(0,a.jsx)(g.A.Search,{allowClear:!0,placeholder:"搜索 requestId / source / function / message / stack",value:S,onChange:e=>z(e.target.value),style:{maxWidth:480}}),(0,a.jsx)(u.A,{rowKey:"id",loading:i,dataSource:B,columns:O,size:"middle",locale:{emptyText:(0,a.jsx)(x.A,{description:"暂无错误日志"})},pagination:{pageSize:20,showSizeChanger:!0,showTotal:e=>"共 ".concat(e," 条")},expandable:{expandedRowRender:e=>(0,a.jsxs)("div",{style:{display:"flex",flexDirection:"column",gap:8,padding:"8px 0"},children:[e.request&&(0,a.jsxs)("div",{children:[(0,a.jsx)(A,{strong:!0,style:{fontSize:12,marginBottom:4,display:"block"},children:"Request"}),(0,a.jsx)("pre",{style:{whiteSpace:"pre-wrap",wordBreak:"break-all",margin:0,padding:10,background:"var(--colorFillAlter)",borderRadius:8,fontSize:12,lineHeight:1.5},children:JSON.stringify(e.request,null,2)})]}),void 0!==e.meta&&(0,a.jsxs)("div",{children:[(0,a.jsx)(A,{strong:!0,style:{fontSize:12,marginBottom:4,display:"block"},children:"Meta"}),(0,a.jsx)("pre",{style:{whiteSpace:"pre-wrap",wordBreak:"break-all",margin:0,padding:10,background:"var(--colorFillAlter)",borderRadius:8,fontSize:12,lineHeight:1.5},children:JSON.stringify(e.meta,null,2)})]}),e.stack&&(0,a.jsxs)("div",{children:[(0,a.jsx)(A,{strong:!0,style:{fontSize:12,marginBottom:4,display:"block"},children:"Stack"}),(0,a.jsx)("pre",{style:{whiteSpace:"pre-wrap",wordBreak:"break-all",margin:0,padding:10,background:"var(--colorFillAlter)",borderRadius:8,fontSize:12,lineHeight:1.5,maxHeight:300,overflow:"auto"},children:e.stack})]})]})}})]})}},92123:(e,t)=>{"use strict";t.A={icon:{tag:"svg",attrs:{viewBox:"64 64 896 896",focusable:"false"},children:[{tag:"path",attrs:{d:"M890.5 755.3L537.9 269.2c-12.8-17.6-39-17.6-51.7 0L133.5 755.3A8 8 0 00140 768h75c5.1 0 9.9-2.5 12.9-6.6L512 369.8l284.1 391.6c3 4.1 7.8 6.6 12.9 6.6h75c6.5 0 10.3-7.4 6.5-12.7z"}}]},name:"up",theme:"outlined"}},96651:(e,t,r)=>{"use strict";r.d(t,{A:()=>l});var a=r(97109),s=r(92123),i=r(88483);function n(){return(n=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var a in r)Object.prototype.hasOwnProperty.call(r,a)&&(e[a]=r[a])}return e}).apply(this,arguments)}let l=a.forwardRef((e,t)=>a.createElement(i.A,n({},e,{ref:t,icon:s.A})))},99811:(e,t,r)=>{"use strict";r.d(t,{A:()=>l});var a=r(97109),s=r(14995),i=r(88483);function n(){return(n=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var a in r)Object.prototype.hasOwnProperty.call(r,a)&&(e[a]=r[a])}return e}).apply(this,arguments)}let l=a.forwardRef((e,t)=>a.createElement(i.A,n({},e,{ref:t,icon:s.A})))}},e=>{e.O(0,[433,576,195,985,375,102,289,861,636,593,792],()=>e(e.s=39214)),_N_E=e.O()}]);
+(self.webpackChunk_N_E=self.webpackChunk_N_E||[]).push([[979],{14995:(e,t)=>{"use strict";t.A={icon:{tag:"svg",attrs:{viewBox:"64 64 896 896",focusable:"false"},children:[{tag:"path",attrs:{d:"M909.1 209.3l-56.4 44.1C775.8 155.1 656.2 92 521.9 92 290 92 102.3 279.5 102 511.5 101.7 743.7 289.8 932 521.9 932c181.3 0 335.8-115 394.6-276.1 1.5-4.2-.7-8.9-4.9-10.3l-56.7-19.5a8 8 0 00-10.1 4.8c-1.8 5-3.8 10-5.9 14.9-17.3 41-42.1 77.8-73.7 109.4A344.77 344.77 0 01655.9 829c-42.3 17.9-87.4 27-133.8 27-46.5 0-91.5-9.1-133.8-27A341.5 341.5 0 01279 755.2a342.16 342.16 0 01-73.7-109.4c-17.9-42.4-27-87.4-27-133.9s9.1-91.5 27-133.9c17.3-41 42.1-77.8 73.7-109.4 31.6-31.6 68.4-56.4 109.3-73.8 42.3-17.9 87.4-27 133.8-27 46.5 0 91.5 9.1 133.8 27a341.5 341.5 0 01109.3 73.8c9.9 9.9 19.2 20.4 27.8 31.4l-60.2 47a8 8 0 003 14.1l175.6 43c5 1.2 9.9-2.6 9.9-7.7l.8-180.9c-.1-6.6-7.8-10.3-13-6.2z"}}]},name:"reload",theme:"outlined"}},39214:(e,t,r)=>{(window.__NEXT_P=window.__NEXT_P||[]).push(["/system/logs",function(){return r(91698)}])},91698:(e,t,r)=>{"use strict";r.r(t),r.d(t,{default:()=>k});var a=r(65321),s=r(97109),i=r(35292),n=r(9137),l=r(11702),o=r(88762),c=r(33442),d=r(85114),h=r(26171),p=r(85493),g=r(7576),u=r(21289),x=r(84253),f=r(99811),y=r(58209),m=r(96651),w=r(60470),j=r(44494),v=r(6578);let{Text:A,Paragraph:b}=i.A;function k(){let e=(0,j.Vr)(),[t,r]=(0,s.useState)([]),[i,k]=(0,s.useState)(!0),[S,z]=(0,s.useState)(""),[I,C]=(0,s.useState)(!1),N=async()=>{k(!0);try{r((await (0,v.oH)(500)).logs)}catch(e){n.Ay.error(e instanceof Error?e.message:"加载日志失败")}finally{k(!1)}};(0,s.useEffect)(()=>{N()},[]);let B=(0,s.useMemo)(()=>{let e=S.trim().toLowerCase();return e?t.filter(t=>[t.id,t.level,t.source,t.functionName,t.message,t.stack].filter(Boolean).some(t=>String(t).toLowerCase().includes(e))):t},[S,t]),O=[{title:"序号",key:"index",width:70,render:(e,t,r)=>r+1},{title:"时间",dataIndex:"createdAt",width:170,render:e=>new Date(e).toLocaleString()},{title:"级别",dataIndex:"level",width:80,render:e=>(0,a.jsx)(l.A,{color:"error"===e?"error":"warn"===e?"warning":"blue",style:{margin:0},children:e})},{title:"来源",dataIndex:"source",width:200,render:e=>(0,a.jsx)(A,{code:!0,style:{fontSize:12},children:e})},{title:"函数",dataIndex:"functionName",width:160,render:e=>e?(0,a.jsx)(A,{code:!0,style:{fontSize:12},children:e}):(0,a.jsx)(A,{type:"secondary",children:"-"})},{title:"错误信息",dataIndex:"message",render:e=>(0,a.jsx)(b,{style:{maxWidth:480,overflowWrap:"anywhere",wordBreak:"break-all",marginBottom:0,fontSize:12},ellipsis:{rows:2,expandable:!0,symbol:"展开"},children:e})},{title:"Request ID",dataIndex:"id",width:200,render:e=>(0,a.jsx)(A,{copyable:!0,code:!0,style:{fontSize:12},children:e.slice(0,8)})}];return i&&0===t.length?(0,a.jsxs)("div",{className:"space-y-5 animateFadeIn",children:[(0,a.jsx)(o.A,{active:!0,title:!0,paragraph:{rows:1}}),(0,a.jsx)(o.A,{active:!0,paragraph:{rows:12}})]}):(0,a.jsxs)("div",{className:"space-y-5 animateFadeIn",children:[(0,a.jsxs)("div",{style:{display:"flex",alignItems:"center",justifyContent:"space-between",flexWrap:"wrap",gap:12},children:[(0,a.jsxs)("div",{children:[(0,a.jsx)("h1",{className:"pageTitle",children:e("nav.systemLogs")}),(0,a.jsx)("p",{className:"pageDesc",children:"查看 API 异常、模型健康检查失败、PDF 降级等运行时问题。"})]}),(0,a.jsxs)(c.A,{children:[(0,a.jsx)(d.Ay,{icon:(0,a.jsx)(f.A,{}),loading:i,onClick:()=>void N(),children:"刷新"}),(0,a.jsx)(h.A,{title:"确认清空所有错误日志？",onConfirm:()=>{(async()=>{await (0,v.hH)(),n.Ay.success("已清空"),await N()})()},children:(0,a.jsx)(d.Ay,{danger:!0,icon:(0,a.jsx)(y.A,{}),children:"清空日志"})})]})]}),(0,a.jsx)(p.A,{type:"info",showIcon:!0,message:(0,a.jsxs)("div",{style:{display:"flex",alignItems:"center",justifyContent:"space-between"},children:[(0,a.jsx)("span",{children:"日志保存在本机 ~/.customize-agent/logs/errors.jsonl，最多读取最近 500 条。"}),(0,a.jsx)(d.Ay,{type:"link",size:"small",icon:I?(0,a.jsx)(m.A,{}):(0,a.jsx)(w.A,{}),onClick:()=>C(!I),style:{padding:"0 4px"},children:I?"收起":"展开"})]}),description:I?"系统自动记录未捕获的异常、API 错误、模型健康检查失败等运行时问题。日志文件超过 2MB 会自动轮转。":void 0}),(0,a.jsx)(g.A.Search,{allowClear:!0,placeholder:"搜索 requestId / source / function / message / stack",value:S,onChange:e=>z(e.target.value),style:{maxWidth:480}}),(0,a.jsx)(u.A,{rowKey:"id",loading:i,dataSource:B,columns:O,size:"middle",locale:{emptyText:(0,a.jsx)(x.A,{description:"暂无错误日志"})},pagination:{pageSize:20,showSizeChanger:!0,showTotal:e=>"共 ".concat(e," 条")},expandable:{expandedRowRender:e=>(0,a.jsxs)("div",{style:{display:"flex",flexDirection:"column",gap:8,padding:"8px 0"},children:[e.request&&(0,a.jsxs)("div",{children:[(0,a.jsx)(A,{strong:!0,style:{fontSize:12,marginBottom:4,display:"block"},children:"Request"}),(0,a.jsx)("pre",{style:{whiteSpace:"pre-wrap",wordBreak:"break-all",margin:0,padding:10,background:"var(--colorFillAlter)",borderRadius:8,fontSize:12,lineHeight:1.5},children:JSON.stringify(e.request,null,2)})]}),void 0!==e.meta&&(0,a.jsxs)("div",{children:[(0,a.jsx)(A,{strong:!0,style:{fontSize:12,marginBottom:4,display:"block"},children:"Meta"}),(0,a.jsx)("pre",{style:{whiteSpace:"pre-wrap",wordBreak:"break-all",margin:0,padding:10,background:"var(--colorFillAlter)",borderRadius:8,fontSize:12,lineHeight:1.5},children:JSON.stringify(e.meta,null,2)})]}),e.stack&&(0,a.jsxs)("div",{children:[(0,a.jsx)(A,{strong:!0,style:{fontSize:12,marginBottom:4,display:"block"},children:"Stack"}),(0,a.jsx)("pre",{style:{whiteSpace:"pre-wrap",wordBreak:"break-all",margin:0,padding:10,background:"var(--colorFillAlter)",borderRadius:8,fontSize:12,lineHeight:1.5,maxHeight:300,overflow:"auto"},children:e.stack})]})]})}})]})}},92123:(e,t)=>{"use strict";t.A={icon:{tag:"svg",attrs:{viewBox:"64 64 896 896",focusable:"false"},children:[{tag:"path",attrs:{d:"M890.5 755.3L537.9 269.2c-12.8-17.6-39-17.6-51.7 0L133.5 755.3A8 8 0 00140 768h75c5.1 0 9.9-2.5 12.9-6.6L512 369.8l284.1 391.6c3 4.1 7.8 6.6 12.9 6.6h75c6.5 0 10.3-7.4 6.5-12.7z"}}]},name:"up",theme:"outlined"}},96651:(e,t,r)=>{"use strict";r.d(t,{A:()=>l});var a=r(97109),s=r(92123),i=r(88483);function n(){return(n=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var a in r)Object.prototype.hasOwnProperty.call(r,a)&&(e[a]=r[a])}return e}).apply(this,arguments)}let l=a.forwardRef((e,t)=>a.createElement(i.A,n({},e,{ref:t,icon:s.A})))},99811:(e,t,r)=>{"use strict";r.d(t,{A:()=>l});var a=r(97109),s=r(14995),i=r(88483);function n(){return(n=Object.assign?Object.assign.bind():function(e){for(var t=1;t<arguments.length;t++){var r=arguments[t];for(var a in r)Object.prototype.hasOwnProperty.call(r,a)&&(e[a]=r[a])}return e}).apply(this,arguments)}let l=a.forwardRef((e,t)=>a.createElement(i.A,n({},e,{ref:t,icon:s.A})))}},e=>{e.O(0,[433,576,195,985,375,102,289,861,636,593,792],()=>e(e.s=39214)),_N_E=e.O()}]);

package/messages/en-US.json

@@ -16,9 +16,6 @@
     "guide": "Guide",
     "models": "Model Config",
     "settings": "Settings",
-    "contextEngineering": "Context Engineering",
-    "longTermContext": "Long-term Context",
-    "shortTermContext": "Short-term Context",
     "promptManagement": "Prompt Management",
     "systemLogs": "System Logs"
   },
@@ -206,19 +203,6 @@
     "save": "Save",
     "cancel": "Cancel"
   },
-  "context": {
-    "title": "Context Engineering",
-    "longTermDesc": "Persistent context from memory store (cross-session)",
-    "shortTermDesc": "Short-term context from recent session logs",
-    "longTermSource": "Source: ~/.customize-agent/memory.db (Memory Store)",
-    "shortTermSource": "Source: ~/.customize-agent/logs/ (Session Logs)",
-    "importance": "Importance",
-    "content": "Content",
-    "tags": "Tags",
-    "source": "Source",
-    "sourceHint": "Optional additional source/context description",
-    "updatedAt": "Updated"
-  },
   "prompt": {
     "title": "Prompt Management",
     "description": "Manage CUSTOMIZE.md system prompt files per project",

package/messages/zh-CN.json

@@ -16,9 +16,6 @@
     "guide": "指引",
     "models": "模型配置",
     "settings": "设置",
-    "contextEngineering": "上下文工程",
-    "longTermContext": "长期上下文",
-    "shortTermContext": "短期上下文",
     "promptManagement": "提示词管理",
     "systemLogs": "系统日志"
   },
@@ -206,19 +203,6 @@
     "save": "保存",
     "cancel": "取消"
   },
-  "context": {
-    "title": "上下文工程管理",
-    "longTermDesc": "来自记忆库的持久化上下文（跨会话保留）",
-    "shortTermDesc": "来自最近会话日志的短期上下文",
-    "longTermSource": "数据来源: ~/.customize-agent/memory.db（记忆库）",
-    "shortTermSource": "数据来源: ~/.customize-agent/logs/（会话日志）",
-    "importance": "重要性",
-    "content": "内容",
-    "tags": "标签",
-    "source": "来源",
-    "sourceHint": "可选，额外的来源/上下文说明",
-    "updatedAt": "更新时间"
-  },
   "prompt": {
     "title": "提示词管理",
     "description": "管理各项目的 CUSTOMIZE.md 系统提示词文件",

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "@customize-agent/server",
-  "version": "4.0.94",
+  "version": "4.0.95",
   "description": "Customize Agent Web 管理控制台",
   "exports": {
     "./package.json": "./package.json"
   },
+  "bin": {
+    "customize-web": "scripts/start-server.cjs",
+    "customize-dashboard": "scripts/start-server.cjs"
+  },
   "files": [
     ".next/BUILD_ID",
     ".next/app-build-manifest.json",
@@ -50,9 +54,9 @@
     "tesseract.js": "^7.0.0",
     "typescript": "^6.0.3",
     "xlsx": "^0.18.5",
-    "@customize-agent/llm": "^3.0.9",
-    "@customize-agent/runtime": "^3.0.9",
-    "@customize-agent/knowledge": "^4.0.36"
+    "@customize-agent/knowledge": "^4.0.37",
+    "@customize-agent/llm": "^3.0.10",
+    "@customize-agent/runtime": "^3.0.10"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.3.2",

package/scripts/start-server.cjs

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const serverRoot = path.resolve(__dirname, '..');
+const originalCwd = process.cwd();
+
+function readOption(names, fallback) {
+  for (let i = 0; i < process.argv.length; i += 1) {
+    const arg = process.argv[i];
+    const matched = names.find(name => arg === name || arg.startsWith(`${name}=`));
+    if (!matched) continue;
+    if (arg.includes('=')) return arg.slice(arg.indexOf('=') + 1);
+    return process.argv[i + 1] || fallback;
+  }
+  return fallback;
+}
+
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+  console.log(`Usage: customize-web [--port 17321] [--host 127.0.0.1] [--project /path/to/project]
+
+Options:
+  -p, --port       Web server port, default 17321
+  -H, --host       Web server host, default 127.0.0.1
+      --project    Project root managed by the dashboard, default current directory
+
+Environment:
+  CUSTOMIZE_PROJECT_ROOT  Project root managed by the dashboard
+  PORT                    Web server port
+  HOST                    Web server host`);
+  process.exit(0);
+}
+
+const port = readOption(['--port', '-p'], process.env.PORT || process.env.CUSTOMIZE_WEB_PORT || '17321');
+const host = readOption(['--host', '-H'], process.env.HOST || process.env.CUSTOMIZE_WEB_HOST || '127.0.0.1');
+const projectRoot = path.resolve(readOption(['--project'], process.env.CUSTOMIZE_PROJECT_ROOT || originalCwd));
+const buildIdPath = path.join(serverRoot, '.next', 'BUILD_ID');
+
+if (!fs.existsSync(buildIdPath)) {
+  console.error('[customize-web] Missing production build artifacts. Reinstall @customize-agent/server or run its build step before starting.');
+  process.exit(1);
+}
+
+const verify = spawnSync(process.execPath, [path.join(serverRoot, 'scripts', 'verify-next-static.js')], {
+  cwd: serverRoot,
+  stdio: 'inherit',
+  env: process.env,
+});
+if (verify.status !== 0) process.exit(verify.status || 1);
+
+let nextBin;
+try {
+  nextBin = require.resolve('next/dist/bin/next', { paths: [serverRoot] });
+} catch (error) {
+  console.error('[customize-web] Unable to resolve Next.js runtime from @customize-agent/server.');
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+}
+
+console.log(`[customize-web] Project root: ${projectRoot}`);
+console.log(`[customize-web] Starting: http://${host}:${port}/overview`);
+
+const result = spawnSync(process.execPath, [nextBin, 'start', '-p', String(port), '-H', String(host)], {
+  cwd: serverRoot,
+  stdio: 'inherit',
+  env: {
+    ...process.env,
+    NODE_ENV: 'production',
+    CUSTOMIZE_PROJECT_ROOT: projectRoot,
+  },
+});
+
+if (result.error) {
+  console.error('[customize-web] Failed to start dashboard.');
+  console.error(result.error.message);
+  process.exit(1);
+}
+process.exit(result.status ?? 0);

package/scripts/upload-matrix.cjs

@@ -0,0 +1,258 @@
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const packageRoot = path.resolve(process.argv[2] || process.env.PACKAGE_ROOT || '.');
+const installRoot = path.resolve(packageRoot, '..', '..');
+const node = process.execPath;
+const packageJsonPath = path.join(packageRoot, 'package.json');
+const packageJson = fs.existsSync(packageJsonPath) ? JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) : null;
+const serverRoot = packageJson?.name === '@customize-agent/server'
+  ? packageRoot
+  : path.dirname(require.resolve('@customize-agent/server/package.json', { paths: [packageRoot, installRoot] }));
+const nextBin = require.resolve('next/dist/bin/next', { paths: [serverRoot, packageRoot, installRoot] });
+const tempRoot = process.env.RUNNER_TEMP || fs.mkdtempSync(path.join(require('os').tmpdir(), 'customize-upload-'));
+const home = path.join(tempRoot, 'upload-home');
+const projectRoot = path.join(tempRoot, 'upload-project');
+const dashboardLog = path.join(tempRoot, 'upload-dashboard.log');
+const basePort = 18000 + Math.floor(Math.random() * 1000);
+const port = Number(process.env.CUSTOMIZE_UPLOAD_PORT || basePort);
+const base = `http://127.0.0.1:${port}`;
+const marker = `uploadmatrix${Date.now()}`;
+
+fs.rmSync(home, { recursive: true, force: true });
+fs.rmSync(projectRoot, { recursive: true, force: true });
+fs.rmSync(dashboardLog, { force: true });
+fs.mkdirSync(projectRoot, { recursive: true });
+
+function minimalPng() {
+  return Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==', 'base64');
+}
+
+function minimalPdf(text) {
+  const stream = `BT /F1 12 Tf 72 720 Td (${text.replace(/[()\\]/g, ' ')}) Tj ET`;
+  const objs = [
+    '1 0 obj << /Type /Catalog /Pages 2 0 R >> endobj',
+    '2 0 obj << /Type /Pages /Kids [3 0 R] /Count 1 >> endobj',
+    '3 0 obj << /Type /Page /Parent 2 0 R /MediaBox [0 0 612 792] /Resources << /Font << /F1 4 0 R >> >> /Contents 5 0 R >> endobj',
+    '4 0 obj << /Type /Font /Subtype /Type1 /BaseFont /Helvetica >> endobj',
+    `5 0 obj << /Length ${Buffer.byteLength(stream)} >> stream\n${stream}\nendstream endobj`,
+  ];
+  let out = '%PDF-1.4\n';
+  const offsets = [0];
+  for (const obj of objs) { offsets.push(Buffer.byteLength(out)); out += obj + '\n'; }
+  const xref = Buffer.byteLength(out);
+  out += `xref\n0 ${objs.length + 1}\n0000000000 65535 f \n`;
+  for (let i = 1; i < offsets.length; i++) out += String(offsets[i]).padStart(10, '0') + ' 00000 n \n';
+  out += `trailer << /Size ${objs.length + 1} /Root 1 0 R >>\nstartxref\n${xref}\n%%EOF`;
+  return Buffer.from(out);
+}
+
+const text = kind => `${marker} ${kind} searchable content`;
+const samples = [
+  { name: 'doc-plain.txt', kind: 'document/plaintext', content: text('txt') },
+  { name: 'doc-markdown.md', kind: 'document/markdown', content: `# ${text('markdown')}\n` },
+  { name: 'doc-pdf.pdf', kind: 'document/pdf', content: minimalPdf(text('pdf')), searchable: false },
+  { name: 'sheet-csv.csv', kind: 'spreadsheet/csv', content: `name,value\n${marker},csv\n` },
+  { name: 'sheet-tsv.tsv', kind: 'spreadsheet/tsv', content: `name\tvalue\n${marker}\ttsv\n` },
+  { name: 'image-svg.svg', kind: 'image/vector', content: `<svg xmlns="http://www.w3.org/2000/svg"><text>${text('svg')}</text></svg>` },
+  { name: 'image-png.png', kind: 'image/raster', content: minimalPng(), allowZeroChunks: true },
+  { name: 'cad-dxf.dxf', kind: 'cad/autocad', content: `0\nSECTION\n2\nENTITIES\n0\nTEXT\n1\n${text('dxf')}\n0\nENDSEC\n0\nEOF\n` },
+  { name: 'cad-step.step', kind: 'cad/step', content: `ISO-10303-21; HEADER; FILE_DESCRIPTION(('${text('step')}'),'2;1'); ENDSEC; DATA; ENDSEC; END-ISO-10303-21;` },
+  { name: 'code-js.js', kind: 'code/javascript', content: `export const marker = '${text('javascript')}';\n` },
+  { name: 'code-py.py', kind: 'code/python', content: `marker = '${text('python')}'\n` },
+  { name: 'data-json.json', kind: 'data/json', content: JSON.stringify({ marker, type: 'json', text: text('json') }) },
+  { name: 'data-yaml.yaml', kind: 'data/yaml', content: `marker: ${marker}\ntext: ${text('yaml')}\n` },
+  { name: 'web-html.html', kind: 'web/html', content: `<html><body>${text('html')}</body></html>` },
+  { name: 'web-css.css', kind: 'web/stylesheet', content: `/* ${text('css')} */\nbody{color:#111}` },
+  { name: 'diagram-drawio.drawio', kind: 'diagram/drawio', content: `<mxfile><diagram>${text('drawio')}</diagram></mxfile>`, searchable: false },
+  { name: 'diagram-mermaid.mmd', kind: 'diagram/mermaid', content: `graph TD\nA[${text('mermaid')}] --> B` },
+];
+
+async function request(method, url, body, timeoutMs = 30000) {
+  const init = { method, signal: AbortSignal.timeout(timeoutMs) };
+  if (body !== undefined) {
+    init.headers = { 'content-type': 'application/json' };
+    init.body = JSON.stringify(body);
+  }
+  const res = await fetch(url, init);
+  const raw = await res.text();
+  let json;
+  try { json = JSON.parse(raw); } catch { json = raw; }
+  return { status: res.status, json, raw };
+}
+
+async function uploadSample(baseUrl, root, sample, uploadId) {
+  const form = new FormData();
+  form.append('uploadId', uploadId);
+  form.append('projectRoot', root);
+  form.append('relativePaths', sample.name);
+  form.append('batchIndex', '0');
+  form.append('totalBatches', '1');
+  form.append('startIndex', '1');
+  form.append('uploadComplete', '1');
+  form.append('fileOffset', '0');
+  form.append('files', new Blob([sample.content]), sample.name);
+  const res = await fetch(`${baseUrl}/api/kb/upload`, { method: 'POST', body: form, signal: AbortSignal.timeout(30000) });
+  const raw = await res.text();
+  let json;
+  try { json = JSON.parse(raw); } catch { json = raw; }
+  return { status: res.status, json, raw };
+}
+
+async function waitFor(label, fn, timeoutMs = 120000) {
+  const deadline = Date.now() + timeoutMs;
+  let last;
+  while (Date.now() < deadline) {
+    try {
+      const result = await fn();
+      if (result) return result;
+    } catch (error) {
+      last = error;
+    }
+    await new Promise(resolve => setTimeout(resolve, 1000));
+  }
+  throw new Error(`${label} timeout${last ? `: ${last.message || last}` : ''}`);
+}
+
+function assert(ok, message) {
+  if (!ok) throw new Error(message);
+}
+
+function indexedDetail(detail, allowZeroChunks = false) {
+  const file = detail.json?.file;
+  return file && file.status !== 'pending' && Number(file.indexedAt) > 0 && (allowZeroChunks || Number(file.chunkCount) > 0);
+}
+
+function searchHasHit(search, relativePath, expectedText) {
+  return Array.isArray(search.json?.results) && search.json.results.some(result => {
+    const filePath = result.filePath || result.relativePath;
+    return filePath === relativePath && (!expectedText || String(result.content || '').includes(expectedText));
+  });
+}
+
+async function startServer(serverPort, root, logPath) {
+  fs.mkdirSync(path.dirname(logPath), { recursive: true });
+  const out = fs.openSync(logPath, 'a');
+  const child = spawn(node, [nextBin, 'start', '-p', String(serverPort), '-H', '127.0.0.1'], {
+    cwd: serverRoot,
+    stdio: ['ignore', out, out],
+    env: { ...process.env, HOME: home, CUSTOMIZE_AGENT_HOME: home, NODE_ENV: 'production', CUSTOMIZE_PROJECT_ROOT: root, CUSTOMIZE_AGENT_DISABLE_OCR: '1', LOG_LEVEL: 'debug' },
+  });
+  fs.closeSync(out);
+  await waitFor(`dashboard ${serverPort}`, async () => {
+    const health = await request('GET', `http://127.0.0.1:${serverPort}/api/health`);
+    return health.status < 500 ? true : undefined;
+  }, 120000);
+  return child;
+}
+
+function dumpEnv() {
+  console.error('ENV:', {
+    NODE_VERSION: process.version,
+    packageRoot,
+    serverRoot,
+    nextBin,
+  });
+}
+
+const pages = ['/', '/overview', '/knowledge', '/knowledge/files', '/knowledge/manage', '/knowledge/search', '/models', '/prompt', '/settings'];
+const apiChecks = [
+  { method: 'GET', path: '/api/health' },
+  { method: 'GET', path: '/api/config/models' },
+  { method: 'GET', path: '/api/config/providers' },
+  { method: 'GET', path: '/api/kb/features' },
+  { method: 'GET', path: '/api/kb/categories' },
+  { method: 'GET', path: '/api/kb/tags' },
+  { method: 'GET', path: '/api/kb/files', query: root => `projectRoot=${encodeURIComponent(root)}&limit=10` },
+  { method: 'GET', path: '/api/kb/stats', query: root => `projectRoot=${encodeURIComponent(root)}` },
+  { method: 'GET', path: '/api/kb/search', query: root => `projectRoot=${encodeURIComponent(root)}&q=${encodeURIComponent(marker)}&limit=5` },
+  { method: 'GET', path: '/api/kb/duplicates', query: root => `projectRoot=${encodeURIComponent(root)}` },
+  { method: 'GET', path: '/api/kb/operations', query: root => `projectRoot=${encodeURIComponent(root)}` },
+  { method: 'GET', path: '/api/prompt' },
+  { method: 'GET', path: '/api/system/stats' },
+];
+
+async function verifyWebSurface(baseUrl, root, label) {
+  for (const page of pages) {
+    const res = await request('GET', `${baseUrl}${page}`);
+    assert(res.status >= 200 && res.status < 400, `${label} page ${page} failed: ${res.status} ${res.raw.slice(0, 300)}`);
+  }
+  for (const api of apiChecks) {
+    const query = api.query ? `?${api.query(root)}` : '';
+    const res = await request(api.method, `${baseUrl}${api.path}${query}`);
+    assert(res.status >= 200 && res.status < 300, `${label} api ${api.path} failed: ${res.status} ${res.raw.slice(0, 500)}`);
+  }
+}
+
+(async () => {
+  assert(fs.existsSync(path.join(serverRoot, '.next', 'BUILD_ID')), `dashboard build not found: ${serverRoot}`);
+
+  let dashboardPid;
+  try {
+    const dashboard = await startServer(port, projectRoot, dashboardLog);
+    dashboardPid = dashboard.pid;
+    await verifyWebSurface(base, projectRoot, 'direct dashboard');
+
+    for (let i = 0; i < samples.length; i++) {
+      const sample = samples[i];
+      const uploadId = `upload-matrix-${i}-${Date.now()}`;
+      const res = await uploadSample(base, projectRoot, sample, uploadId);
+      assert(res.status === 202 && res.json.success, `${sample.name} upload failed: ${res.status} ${res.raw}`);
+      const relativePath = res.json.relativePath;
+      assert(relativePath, `${sample.name} missing relativePath`);
+      const progress = await request('GET', `${base}/api/kb/upload/progress?id=${encodeURIComponent(uploadId)}`);
+      assert(progress.status === 200, `${sample.name} progress failed: ${progress.status} ${progress.raw}`);
+      const files = await request('GET', `${base}/api/kb/files?projectRoot=${encodeURIComponent(projectRoot)}&limit=500`);
+      assert(files.status === 200, `${sample.name} files failed: ${files.status} ${files.raw}`);
+      assert(files.json.files?.some(f => f.relativePath === relativePath), `${sample.name} not listed`);
+      const reindex = await request('POST', `${base}/api/kb/files/reindex`, { projectRoot, relativePath });
+      assert(reindex.status === 200 || reindex.status === 202, `${sample.name} reindex failed: ${reindex.status} ${reindex.raw}`);
+      const detail = await waitFor(`${sample.name} indexed detail`, async () => {
+        const current = await request('GET', `${base}/api/kb/files/detail?projectRoot=${encodeURIComponent(projectRoot)}&relativePath=${encodeURIComponent(relativePath)}`);
+        if (current.status !== 200) throw new Error(`${sample.name} detail failed: ${current.status} ${current.raw}`);
+        if (current.json.file?.relativePath !== relativePath) throw new Error(`${sample.name} detail mismatch`);
+        return indexedDetail(current, sample.allowZeroChunks) ? current : undefined;
+      }, 120000);
+      if (!sample.allowZeroChunks && sample.searchable !== false) {
+        const search = await waitFor(`${sample.name} searchable marker`, async () => {
+          const current = await request('GET', `${base}/api/kb/search?projectRoot=${encodeURIComponent(projectRoot)}&q=${encodeURIComponent(marker)}&limit=50&vectorWeight=1&rewriteWeight=0&keywordWeight=1`);
+          if (current.status !== 200) throw new Error(`${sample.name} search failed: ${current.status} ${current.raw}`);
+          return searchHasHit(current, relativePath, marker) ? current : undefined;
+        }, 120000);
+        assert(searchHasHit(search, relativePath, marker), `${sample.name} search did not include marker hit`);
+      }
+      console.log('UPLOAD', sample.kind, sample.name, JSON.stringify({ relativePath, chunks: detail.json.file?.chunkCount, vector: res.json.vectorStatus?.status }));
+    }
+
+    const incrementalPath = path.join(projectRoot, 'knowledgeBase', '文档资料', 'incremental-local.txt');
+    fs.mkdirSync(path.dirname(incrementalPath), { recursive: true });
+    fs.writeFileSync(incrementalPath, text('incremental-local'));
+    const reindexAll = await request('POST', `${base}/api/kb/reindex`, { projectRoot });
+    assert((reindexAll.status === 200 || reindexAll.status === 202) && reindexAll.json.success, `incremental reindex failed: ${reindexAll.status} ${reindexAll.raw}`);
+    if (reindexAll.status === 200) assert(Number(reindexAll.json.diff?.newFiles) >= 1, `incremental reindex did not detect new file: ${reindexAll.raw}`);
+    const incrementalDetail = await waitFor('incremental indexed detail', async () => {
+      const current = await request('GET', `${base}/api/kb/files/detail?projectRoot=${encodeURIComponent(projectRoot)}&relativePath=${encodeURIComponent('文档资料/incremental-local.txt')}`);
+      if (current.status !== 200) throw new Error(`incremental detail failed: ${current.status} ${current.raw}`);
+      return indexedDetail(current) ? current : undefined;
+    }, 120000);
+    assert(Number(incrementalDetail.json.file?.chunkCount) > 0, 'incremental file was not parsed/chunked');
+
+    const readyStats = await waitFor('HNSWLib vector index', async () => {
+      const stats = await request('GET', `${base}/api/kb/stats?projectRoot=${encodeURIComponent(projectRoot)}`);
+      if (stats.status !== 200) throw new Error(`stats ${stats.status} ${stats.raw}`);
+      const vector = stats.json.vectorStatus;
+      if (vector?.status === 'ready' && Number(vector.indexedChunks) >= Number(stats.json.chunkCount) && Number(stats.json.chunkCount) > 0) return stats.json;
+      return undefined;
+    }, 180000);
+    console.log('UPLOAD_VECTOR_MATRIX_OK', JSON.stringify({ files: samples.length, marker, projectRoot, chunkCount: readyStats.chunkCount, indexedChunks: readyStats.vectorStatus.indexedChunks }));
+    process.exitCode = 0;
+  } finally {
+    if (dashboardPid) { try { process.kill(dashboardPid); } catch {} }
+  }
+})().catch(error => {
+  process.exitCode = 1;
+  console.error(error.stack || String(error));
+  dumpEnv();
+  if (fs.existsSync(dashboardLog)) console.error(fs.readFileSync(dashboardLog, 'utf8'));
+}).finally(() => process.exit(process.exitCode ?? 0));