dsh-form-fill-agent 0.2.26 → 0.2.28

package/README.md

@@ -1,6 +1,6 @@
 # AI填表智能体
 
-> 0.2.26：新增独立 XLSX 任务结果报告与页内预览；侧栏仍为可选依赖。
+> 0.2.28：会话隔离的只读历史、维度搜索与真实查询进度；侧栏仍为可选依赖。
 
 > 统一侧栏适配需要 Better Sidebar `>=0.17.1 <0.19.0`。五个流程入口打开同一 Session Tab；侧栏展开、收起和关闭由宿主管理。缺少依赖时会显示安装升级提示。
 
@@ -11,7 +11,7 @@ AI填表智能体：支持自动填表、表格填充、表格补全、Excel填
 ### 基础安装（不需要侧栏）
 
 ```sh
-dsh plugin --profile web add dsh-form-fill-agent@0.2.26
+dsh plugin --profile web add dsh-form-fill-agent@0.2.28
 ```
 
 只需 Node.js >=22、完整 DSH 与主包自动安装的内核/Provider。Better Sidebar 和 dsh-context 都是可选项，不会由基础安装强装。
@@ -102,7 +102,7 @@ dsh plugin --profile web add dsh-form-fill-agent@latest
 
 ## 使用边界与数据保存
 
-补充要求为模型可读文本；字段或工作表范围请通过向导/工作台修改，不能仅改文字后假定执行范围已同步。任务 schema 5 可读取 schema 1–5；回退旧版本请使用升级前目录副本或独立任务目录。主包为 0.2.26，共享内核为 0.2.10，Provider 为 0.2.2，共享字段契约为 0.1.0。
+补充要求为模型可读文本；字段或工作表范围请通过向导/工作台修改，不能仅改文字后假定执行范围已同步。任务 schema 5 可读取 schema 1–5；回退旧版本请使用升级前目录副本或独立任务目录。主包为 0.2.28，共享内核为 0.2.10，Provider 为 0.2.2，共享字段契约为 0.1.0。
 
 支持企业完整登记名称或 18 位信用代码；简称、主体不一致或多候选不会自动猜选。仅有信用代码的表格也可作为查询锚点。连接候选检索工具时可检索简称，仍需人工确认；缺少工具时降级人工输入。字段映射采用确定性规则及人工确认，不让模型编造事实。支持普通内部公式、固定区域下拉、基础条件格式和普通表格对象；复杂 Excel 结构和 Word 暂不支持，保真边界见下方安全说明。
 
@@ -125,3 +125,5 @@ dsh plugin --profile web add dsh-form-fill-agent@latest
 MIT License.
 
 任务结果报告与客户副本分开下载，采用中文状态和已记录的来源。新查询保留实际 MCP server/工具；旧记录缺少 server 时明确提示，不补造。原 JSON 制品接口继续兼容，页面默认提供 XLSX。
+
+任务报告在确认后的摘要旁以次要文字链接下载；主结果区只展示已填副本的预览和下载，避免混淆。

package/lib/brand.css

@@ -74,3 +74,5 @@
 
 /* Spreadsheet previews: compact rows, stationary location column. */
 .ff-ui .scroll td{max-width:420px;overflow:hidden;text-overflow:ellipsis;padding:8px 12px}.ff-ui .scroll th:first-child,.ff-ui .scroll td:first-child{position:sticky;left:0;background:var(--head);z-index:2}.ff-ui .scroll th:first-child{z-index:3}.ff-ui #downloads{display:block}.ff-ui #downloads>.toolbar{justify-content:flex-start;margin:12px 0}
+
+.ff-ui .ff-download-summary{display:flex;flex-wrap:wrap;align-items:center;gap:8px 16px;min-width:0}.ff-ui .ff-download-summary p{margin:8px 0}.ff-ui .ff-report-link{color:var(--muted);font-size:13px;text-decoration:underline;padding:8px 0;overflow-wrap:anywhere}.ff-ui .ff-report-link:hover{color:var(--action)}

package/lib/client.js

@@ -134,7 +134,7 @@ window.__ModuleLoader__.load({
    function WorkbenchTab({scope,store,tab,visible}){
     const id=scope.sessionId,frame=React.useRef(null),ready=React.useRef(false);
     const [view,setView]=React.useState(()=>views.get(id)||{id,step:'import'});
-    const [src]=React.useState(()=>'/form-fill/?session='+encodeURIComponent(id)+(sessionTasks.has(id)?'#task='+sessionTasks.get(id):''));
+    const [src]=React.useState(()=>'/form-fill/?workspace='+encodeURIComponent(ctx.workspaces?.list?.getSnapshot?.().items?.find(w=>w.sessionIds?.includes(id))?.workspaceId||'')+'&session='+encodeURIComponent(id)+(sessionTasks.has(id)?'#task='+sessionTasks.get(id):''));
     React.useEffect(()=>{
      const update=()=>{const next=views.get(id);if(next)setView(next)};viewListeners.add(update);
      const detach=sidebar?.attach(scope,store,tab);return()=>{viewListeners.delete(update);detach?.()};
@@ -148,6 +148,7 @@ window.__ModuleLoader__.load({
     React.useEffect(()=>{
      const receive=async event=>{
       if(event.origin!==location.origin||event.source!==frame.current?.contentWindow)return;
+      if(event.data?.type==='ff-open-origin'){const target=event.data.sessionId;const known=ctx.workspaces?.list?.getSnapshot?.().items?.some(w=>w.sessionIds?.includes(target));try{if(current()!==id||!owned(target)||!known||typeof ctx.sessions.open!=='function')throw Error('来源会话不可用');await ctx.sessions.open(target)}catch{frame.current?.contentWindow?.postMessage({type:'ff-origin-unavailable'},location.origin)}return}
       if(event.data?.type==='ff-capabilities'){frame.current.contentWindow.postMessage({type:'ff-capabilities-result',mappingDraft:2},location.origin);return}
       if(event.data?.type==='ff-view'&&ready.current&&['import','rules','identity','preview','download','history'].includes(event.data.step)){views.set(view.id,{id:view.id,step:event.data.step});return}
       if(event.data?.type==='ff-wizard-state'){if(!event.data.open&&event.data.focusComposer)setTimeout(()=>{if(current()===view.id)document.querySelector('[data-composer-card] textarea, [data-composer-card] [contenteditable=true]')?.focus()},0);return}

package/lib/http.js

@@ -1,3 +1,4 @@
+import { providerOutcome } from './provider-outcome.js';
 import { randomUUID, createHash } from 'node:crypto';
 import { readFile } from 'node:fs/promises';
 import { applyChangeSet, parseWorkbook } from 'form-fill-core';
@@ -19,7 +20,8 @@ export function createFormFillHandler({ basePath = '', getPort, now = Date.now,
   const controllers=new Map();
   const validOwner = value => typeof value === 'string' && /^[a-f0-9]{64}$/.test(value);
   const visible = (task, owner) => task && (!task.owner || task.owner === owner);
-  const metadata = (id, task) => ({ id, presentation:taskPresentation(task), filename: task.filename ?? '未命名表格.xlsx', revision: task.revision ?? 1, state: task.state ?? (task.result ? 'completed' : 'preview_ready'), created: task.created, updatedAt: task.updatedAt ?? task.created, expiresAt: task.created + ttlMs, sessionId: task.sessionId, confirmed: !!task.result });
+  const inSession=(task,session)=>task && (task.originSessionId||task.sessionId||'')===(session||'');
+  const metadata = (id, task) => ({ id, presentation:taskPresentation(task,now()), filename: task.filename ?? '未命名表格.xlsx', revision: task.revision ?? 1, state: task.state ?? (task.result ? 'completed' : 'preview_ready'), created: task.created, updatedAt: task.updatedAt ?? task.created, expiresAt: task.created + ttlMs, sessionId: task.sessionId, originSessionId:task.originSessionId||task.sessionId||null, originWorkspaceId:task.originWorkspaceId||null, confirmed: !!task.result });
   const settings = task => ({
     mappingProtocol: 2,
     diagnostics: diagnostics(task.preview),
@@ -56,20 +58,23 @@ export function createFormFillHandler({ basePath = '', getPort, now = Date.now,
       const url = new URL(request.url, origin);
       if (url.pathname !== basePath && !url.pathname.startsWith(basePath + '/')) return send(404, { message: '路径不存在' });
       const path = url.pathname.slice(basePath.length) || '/';
+      const session=request.headers['x-form-fill-session']||url.searchParams.get('session')||'';
+      const accessible=task=>visible(task,owner)&&inSession(task,session);
       if (request.method === 'GET' && path === '/') return send(200, await readFile(new URL('./ui.html', import.meta.url)), 'text/html; charset=utf-8');
       if (request.method === 'GET' && path === '/brand.css') return send(200, await readFile(new URL('./brand.css', import.meta.url)), 'text/css; charset=utf-8');
       if (request.method === 'GET' && path === '/health') return send(200, { plugin: 'form-fill-agent', product: 'AI填表', version: '0.1.0-alpha.7', provider: 'mock-only', qccAvailable: !!getQccStatus(), companionRequired: false, taskStorage: taskDirectory ? 'disk' : 'memory' });
-      if (request.method === 'GET' && path === '/tasks') {
+      if (request.method === 'GET' && ['/tasks','/history'].includes(path)) {
         if (!validOwner(owner)) return send(403, { message: '需要本地任务访问凭据' });
-        return send(200, [...tasks].filter(([, t]) => t.owner === owner).map(([id,t]) => metadata(id,t)).sort((a,b) => b.updatedAt-a.updatedAt));
+        const list=[...tasks].filter(([,t])=>t.owner===owner&&(path==='/history'||inSession(t,session))).map(([id,t])=>{const m=metadata(id,t);return path==='/history'?{id:m.id,filename:m.filename,title:m.presentation.title,status:m.presentation.status,created:m.created,updatedAt:m.updatedAt,expiresAt:m.expiresAt,originSessionId:m.originSessionId,originWorkspaceId:m.originWorkspaceId,confirmed:m.confirmed,readOnly:true}:m}).sort((a,b)=>b.updatedAt-a.updatedAt);
+        return send(200,list);
       }
       if (request.method === 'GET' && path.startsWith('/task/')) {
         const id = path.slice(6), task = tasks.get(id);
-        if (!visible(task, owner)) return send(404, { message: '任务不存在或已过期' });
+        if (!accessible(task)) return send(404, { message: '任务不存在或已过期' });
         return send(200, { ...task.preview, ...metadata(id,task), ...settings(task) });
       }
       if(request.method==='GET'&&path.startsWith('/grid/')){
-        const task=tasks.get(path.slice(6));if(!visible(task,owner))return send(404,{message:'任务不存在或已过期'});
+        const task=tasks.get(path.slice(6));if(!accessible(task))return send(404,{message:'任务不存在或已过期'});
         return send(200,gridPage(task,url.searchParams));
       }
       if (request.method === 'GET' && path.startsWith('/fixture/')) {
@@ -79,7 +84,7 @@ export function createFormFillHandler({ basePath = '', getPort, now = Date.now,
       }
       if (request.method === 'GET' && path.startsWith('/download/')) {
         const parts = path.split('/'), [, , id, kind] = parts, task = tasks.get(id);
-        if (parts.length !== 4 || !visible(task, owner) || !task?.result) return send(404, { message: '请先确认写回，或预览已过期' });
+        if (parts.length !== 4 || !accessible(task) || !task?.result) return send(404, { message: '请先确认写回，或预览已过期' });
         if(kind==='report')return send(200,reportWorkbook(task),XLSX_TYPE);
         if(kind==='report-preview')return send(200,{rows:reportRows(task)});
         if (kind === 'xlsx') return send(200, task.result.bytes, XLSX_TYPE);
@@ -109,12 +114,13 @@ export function createFormFillHandler({ basePath = '', getPort, now = Date.now,
         if (disposed) return send(503, { message: '插件已卸载' });
         const filename = typeof body.filename === 'string' ? body.filename.replace(/[\\/\x00-\x1f]/g,'').slice(0,180) : '未命名表格.xlsx';
         if (owner && !validOwner(owner)) return send(400, { message: '任务访问凭据无效' });
-        const task = { bytes, preview, analyzeOnly: !!body.analyzeOnly, created: now(), updatedAt: now(), revision: 1, state: 'preview_ready', owner, filename, sessionId: typeof body.sessionId === 'string' ? body.sessionId.slice(0,160) : undefined };
+        if((body.sessionId||'')!==session)return send(403,{message:'来源会话与当前请求不一致'});
+        const task = { originSessionId:session||undefined,originWorkspaceId:typeof body.originWorkspaceId==='string'?body.originWorkspaceId.slice(0,160):undefined, bytes, preview, analyzeOnly: !!body.analyzeOnly, created: now(), updatedAt: now(), revision: 1, state: 'preview_ready', owner, filename, sessionId: typeof body.sessionId === 'string' ? body.sessionId.slice(0,160) : undefined };
         tasks.set(id, task);
         return send(200, { ...preview, ...metadata(id,task), ...settings(task) });
       }
       const task = tasks.get(body.id);
-      if (!visible(task, owner)) return send(404, { message: '预览已过期，请重新上传' });
+      if (!accessible(task)) return send(404, { message: '预览已过期，请重新上传' });
       if ((task.owner || body.expectedRevision !== undefined) && body.expectedRevision !== (task.revision ?? 1)) return send(409, { code: 'REVISION_CONFLICT', message: '任务已更新，请刷新后重试' });
       if(path==='/cancel'){
         const controller=controllers.get(body.id);if(!controller)return send(409,{message:'任务当前未运行'});
@@ -163,29 +169,34 @@ export function createFormFillHandler({ basePath = '', getPort, now = Date.now,
   };
   return {
     handler,
-    async enrich(id, provider, expectedRevision, {retryOnly=false}={}) {
+    async enrich(id, provider, expectedRevision, {retryOnly=false,sessionId}={}) {
       sweep();
       const task = tasks.get(id);
       if (disposed || !task || task.result || running.has(id)) throw Error('任务不存在、已确认或正在执行');
+      if((task.originSessionId||task.sessionId)&&!inSession(task,sessionId))throw Error('来源会话不匹配，不能跨会话执行');
       if ((task.owner || expectedRevision !== undefined) && expectedRevision !== (task.revision ?? 1)) throw Error('REVISION_CONFLICT：任务已更新');
       running.add(id);
       const controller=new AbortController();controllers.set(id,controller);
-      let active = { ...task, state: 'enriching', progress:{completed:0,total:0}, updatedAt: now(), revision: (task.revision ?? 1) + 1 };
+      let active = { ...task, state: 'enriching', progress:{completed:0,total:0,startedAt:now(),currentAction:'准备填写计划',outcomes:{},elapsedMs:0}, updatedAt: now(), revision: (task.revision ?? 1) + 1 };
       const excluded=new Set(allCandidates(task).changes.filter(c=>!task.preview.changeSet.changes.some(s=>s.id===c.id)).map(c=>c.id));
       const update=(preview,state,progress)=>{
         if(disposed||tasks.get(id)!==active)throw Error('任务已过期或被替换');
         const baseChangeSet=preview.changeSet;
         const selected=selectCandidates(baseChangeSet,baseChangeSet.changes.filter(c=>!excluded.has(c.id)).map(c=>c.id));
-        active={...active,baseChangeSet,preview:{...preview,changeSet:selected},state,progress,updatedAt:now(),revision:active.revision+1};tasks.set(id,active);
+        active={...active,baseChangeSet,preview:{...preview,changeSet:selected},state,progress:{...active.progress,...progress,elapsedMs:Math.max(0,now()-active.progress.startedAt),...(state==='enriching'?{}:{currentAction:'处理结束',endedAt:now()})},updatedAt:now(),revision:active.revision+1};tasks.set(id,active);
       };
       try {
         tasks.set(id, active);
-        const preview = await previewBytes(task.bytes, { provider, confirmPaidCalls: true, configuration: task.configuration, selectedFields: task.selectedFields,signal:controller.signal,retryOnly,previousChangeSet:retryOnly?allCandidates(task):undefined,onProgress:async({analysis,plan,changeSet,completed,total})=>update({analysis,plan,changeSet},'enriching',{completed,total}) });
+        const observed={...provider,lookup:async(request,options)=>{
+          active={...active,progress:{...active.progress,currentAction:'查询企业数据',recentItem:String(request.anchor?.company_name||request.anchor?.credit_no||'').slice(0,180)},updatedAt:now(),revision:active.revision+1};tasks.set(id,active);
+          let result;try{result=await provider.lookup(request,options)}catch(error){result={status:'error'};throw error}finally{if(!disposed&&tasks.get(id)===active&&active.state==='enriching'){const outcome=providerOutcome(result);active={...active,progress:{...active.progress,outcomes:{...active.progress.outcomes,[outcome]:(active.progress.outcomes[outcome]||0)+1}}};tasks.set(id,active)}}return result;
+        }};
+        const preview = await previewBytes(task.bytes, { provider:observed, confirmPaidCalls: true, configuration: task.configuration, selectedFields: task.selectedFields,signal:controller.signal,retryOnly,previousChangeSet:retryOnly?allCandidates(task):undefined,onProgress:async({analysis,plan,changeSet,completed,total})=>update({analysis,plan,changeSet},'enriching',{completed,total}) });
         if (disposed || tasks.get(id) !== active) throw Error('任务已过期或被替换');
         update(preview,controller.signal.aborted?'cancelled':preview.changeSet.incomplete.some(i => i.reason === 'provider-error') ? 'partial' : 'preview_ready',active.progress);
         return { taskId: id, filled: active.preview.changeSet.changes.length, incomplete: active.preview.changeSet.incomplete.length, diagnostics:diagnostics(active.preview), previewPath: basePath + '/#task=' + id };
       } catch (error) {
-        if (!disposed && tasks.get(id) === active) tasks.set(id, { ...active, state: 'failed', updatedAt: now(), revision: active.revision + 1 });
+        if (!disposed && tasks.get(id) === active) tasks.set(id, { ...active, state: 'failed', progress:{...active.progress,currentAction:'执行失败',endedAt:now(),elapsedMs:Math.max(0,now()-active.progress.startedAt)},updatedAt: now(), revision: active.revision + 1 });
         throw error;
       } finally { running.delete(id);controllers.delete(id); }
     },

package/lib/index.js

@@ -1,7 +1,8 @@
+import { providerOutcome } from './provider-outcome.js';
 import { createFormFillHandler } from './http.js';
 import { createCatalogProvider, CATALOG_TOOL_DOMAINS, runtimeToolNames, REGISTRATION_TOOL, ENTITY_TOOL } from 'qcc-form-fill-provider';
 import { randomUUID } from 'node:crypto';
-import { join } from 'node:path';
+import { profileTaskDirectory } from './profile-storage.js';
 import { renderEnrichmentResult } from './diagnostics.js';
 export { previewBytes, previewFile, writeCopy } from './workflow.js';
 export const name = 'form-fill-agent';
@@ -9,7 +10,7 @@ export const inject = [];
 export function apply(ctx, config = {}) {
   ctx.inject(['webServer'], scope => {
     let toolService;
-    const taskDirectory = config.taskDirectory ?? (process.env.DSH_HOME ? join(process.env.DSH_HOME, 'form-fill-tasks') : undefined);
+    const taskDirectory = config.taskDirectory ?? profileTaskDirectory(import.meta.url);
     const service = createFormFillHandler({ basePath: '/form-fill', getPort: () => scope.webServer.port, taskDirectory, ttlMs: 86400000, getQccStatus: () => ['mcp__qcc-company__','mcp__company__','mcp__qcc_company__'].some(p => toolService?.get?.(p + REGISTRATION_TOOL)) });
     scope.inject?.(['tools'], toolScope => {
       const tools = toolScope.tools;
@@ -24,7 +25,7 @@ export function apply(ctx, config = {}) {
         },
         async execute(args, execution) {
           if (!execution?.agent || !execution?.token) throw Error('需要 Agent-owned 工具执行上下文');
-          const runtimeSources=new Map();
+          const runtimeSources=new Map();let transportOutcome;
           const provider = createCatalogProvider({ availableTools:Object.keys(CATALOG_TOOL_DOMAINS).filter(name=>runtimeToolNames(name).some(n=>tools.get(n))), enableEntitySearch: ['mcp__qcc-company__','mcp__company__','mcp__qcc_company__'].some(p=>tools.get(p+ENTITY_TOOL)), callTool: async (name, arguments_, { signal }) => {
             if (!Object.hasOwn(CATALOG_TOOL_DOMAINS,name)) throw Error('不支持的 QCC 工具');
             const names = runtimeToolNames(name);
@@ -32,10 +33,10 @@ export function apply(ctx, config = {}) {
             if (!selected) throw Error('请先连接企查查企业数据 MCP');
             runtimeSources.set(name,selected);
             const result = await tools.execute({ name: selected, arguments: arguments_, signal, callId: randomUUID(), rootCallId: execution.rootCallId, parent: execution.token, agent: execution.agent });
-            return result?.isError ? { isError: true } : result?.value;
+            const raw=result?.value;const observed=providerOutcome(raw);if(observed==='no-permission')transportOutcome=observed;return result?.isError ? { isError: true } : raw;
           } });
-          const lookup=provider.lookup.bind(provider);provider.lookup=async(...input)=>{const result=await lookup(...input);for(const value of Object.values(result.values||{})){const match=/^qcc:\/\/([^/]+)\//.exec(value.source||'');if(match&&runtimeSources.has(match[1]))value.source=value.source.replace('qcc://'+match[1]+'/', 'qcc://'+runtimeSources.get(match[1])+'/')}return result};
-          return service.enrich(args.taskId, provider, args.expectedRevision,{retryOnly:args.mode==='retry'});
+          const lookup=provider.lookup.bind(provider);provider.lookup=async(...input)=>{transportOutcome=undefined;const result=await lookup(...input);if(transportOutcome)result.outcome=transportOutcome;for(const value of Object.values(result.values||{})){const match=/^qcc:\/\/([^/]+)\//.exec(value.source||'');if(match&&runtimeSources.has(match[1]))value.source=value.source.replace('qcc://'+match[1]+'/', 'qcc://'+runtimeSources.get(match[1])+'/')}return result};
+          return service.enrich(args.taskId, provider, args.expectedRevision,{retryOnly:args.mode==='retry',sessionId:execution.agent.session?.id});
         },
       });
       toolScope.effect?.(() => () => disposeTool?.());

package/lib/profile-storage.js

@@ -0,0 +1,20 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// Resolve the installed profile manifest, never a home-wide shared task store.
+// Linked development packages outside a profile use memory unless explicitly configured.
+export function profileTaskDirectory(moduleUrl) {
+  let directory = dirname(fileURLToPath(moduleUrl));
+  while (true) {
+    try {
+      const manifest = JSON.parse(readFileSync(join(directory, 'package.json'), 'utf8'));
+      if (manifest.private === true && Array.isArray(manifest.dsh?.profile?.bundles)) {
+        return join(directory, 'form-fill-tasks');
+      }
+    } catch { /* Not a profile manifest. */ }
+    const parent = dirname(directory);
+    if (parent === directory) return undefined;
+    directory = parent;
+  }
+}

package/lib/provider-outcome.js

@@ -0,0 +1,14 @@
+// Observation only: never turns a failed response into usable business values.
+export function providerOutcome(result) {
+ const code=String(result?.code??result?.error?.code??'').toLowerCase();
+ if(['403','401','forbidden','unauthorized','permission-denied','no-permission'].includes(code))return 'no-permission';
+ if(result?.outcome==='no-permission')return 'no-permission';
+ if(result?.status==='not-required')return 'not-required';
+ if(result?.status==='not-found')return 'zero-records';
+ if(result?.status==='exact')return Object.keys(result.values||{}).length?'data':'zero-records';
+ if(result?.status==='ambiguous')return 'review';
+ if(result?.code==='qcc-response-invalid')return 'unknown';
+ if(result?.isError||result?.status==='error'||result?.status==='cancelled')return 'failed';
+ return 'unknown';
+}
+export const OUTCOME_LABELS=Object.freeze({data:'成功有数据','zero-records':'成功零记录','not-required':'无需执行','no-permission':'无权限',failed:'失败',unknown:'未知',review:'需核验'});

package/lib/task-presentation.js

@@ -1,7 +1,7 @@
 import { parseWorkbook } from 'form-fill-core';
 
 const retained = new Set(['no-data','user-excluded','formula-preserved','hidden-or-merged','hidden-row','hidden-sheet','sheet-excluded','protected-source-range','placeholder-needs-confirmation']);
-export function taskPresentation(task) {
+export function taskPresentation(task,now=Date.now()) {
   const items=task.preview.changeSet.incomplete;
   const failures=Math.max(task.state==='failed'?1:0,items.filter(i=>i.reason==='provider-error').length);
   const review=items.filter(i=>i.reason!=='provider-error'&&!retained.has(i.reason)).length;
@@ -26,6 +26,7 @@ export function taskPresentation(task) {
     }
   }
   const date=new Intl.DateTimeFormat('zh-CN',{timeZone:'Asia/Shanghai',month:'2-digit',day:'2-digit',hour:'2-digit',minute:'2-digit',hour12:false}).format(new Date(task.created)).replace('/', '-');
-  return {title:(task.filename||'未命名表格').replace(/\.xlsx$/i,'')+'｜'+subjects.size+' 家企业｜'+date,status,running,ended,percent,completed,total,failures,review,noData};
+  const elapsedMs=task.progress?.startedAt!==undefined?Math.max(0,(running?now:task.progress.endedAt||task.updatedAt)-task.progress.startedAt):0;
+  return {currentAction:task.progress?.currentAction||'尚未执行',recentItem:task.progress?.recentItem||'',elapsedMs,outcomes:task.progress?.outcomes||{},filled:task.preview.changeSet.changes.length,title:(task.filename||'未命名表格').replace(/\.xlsx$/i,'')+'｜'+subjects.size+' 家企业｜'+date,status,running,ended,percent,completed,total,failures,review,noData};
 }
 export const isResultExplanation = item => retained.has(item.reason);

package/lib/task-store.js

@@ -38,7 +38,7 @@ export function createTaskStore({ directory, maxTasks = 10, now = Date.now, ttlM
           if(saved.baseChangeSet){assertChangeSet(saved.baseChangeSet);if(saved.baseChangeSet.planId!==saved.preview.plan.planId)throw Error('Candidate plan mismatch');}
           if (saved.preview.plan.documentHash !== doc.documentHash || saved.preview.changeSet.planId !== saved.preview.plan.planId) throw Error('Persisted document mismatch');
         }
-        const task = { bytes, preview: saved.preview, baseChangeSet:saved.baseChangeSet, progress:saved.progress, configuration: saved.configuration, selectedFields:saved.selectedFields, analyzeOnly: saved.analyzeOnly, created: saved.created, revision: saved.revision ?? 1, owner: saved.owner, filename: saved.filename ?? '未命名表格.xlsx', updatedAt: saved.updatedAt ?? saved.created, state: saved.state === 'enriching' ? 'interrupted' : saved.state ?? (saved.confirmed ? 'completed' : 'preview_ready'), sessionId: saved.sessionId };
+        const task = { bytes, preview: saved.preview, baseChangeSet:saved.baseChangeSet, progress:saved.progress, configuration: saved.configuration, selectedFields:saved.selectedFields, analyzeOnly: saved.analyzeOnly, created: saved.created, revision: saved.revision ?? 1, owner: saved.owner, filename: saved.filename ?? '未命名表格.xlsx', updatedAt: saved.updatedAt ?? saved.created, state: saved.state === 'enriching' ? 'interrupted' : saved.state ?? (saved.confirmed ? 'completed' : 'preview_ready'), originWorkspaceId:saved.originWorkspaceId,originSessionId:saved.originSessionId||saved.sessionId,sessionId: saved.sessionId };
         if (saved.confirmed && task.preview) task.result = applyChangeSet(bytes,task.preview.plan,task.preview.changeSet,{confirmChangeSetId:task.preview.changeSet.changeSetId});
         tasks.set(id,task);
       }
@@ -50,9 +50,11 @@ export function createTaskStore({ directory, maxTasks = 10, now = Date.now, ttlM
     get: id => tasks.get(id),
     set(id, task) {
       if (!idPattern.test(id)) throw Error('Invalid task ID');
+      const prior=tasks.get(id);if(prior&&prior.originWorkspaceId!==task.originWorkspaceId)throw Error('任务来源工作区不可重绑定');if(prior?.result&&!task.result)throw Error('已确认终态不可回退');
+      if(prior&&(prior.originSessionId||prior.sessionId)!==(task.originSessionId||task.sessionId))throw Error('任务来源会话不可重绑定');
       if (!tasks.has(id) && tasks.size >= maxTasks) throw Error('Task capacity exceeded');
       if (root) {
-        const json = JSON.stringify({ schema:5,id,base64:task.bytes.toString('base64'),preview:task.preview,baseChangeSet:task.baseChangeSet,progress:task.progress,configuration:task.configuration,selectedFields:task.selectedFields,analyzeOnly:task.analyzeOnly,created:task.created,revision:task.revision ?? 1,confirmed:!!task.result,owner:task.owner,filename:task.filename,updatedAt:task.updatedAt,state:task.state,sessionId:task.sessionId });
+        const json = JSON.stringify({ schema:5,id,base64:task.bytes.toString('base64'),preview:task.preview,baseChangeSet:task.baseChangeSet,progress:task.progress,configuration:task.configuration,selectedFields:task.selectedFields,analyzeOnly:task.analyzeOnly,created:task.created,revision:task.revision ?? 1,confirmed:!!task.result,owner:task.owner,filename:task.filename,updatedAt:task.updatedAt,state:task.state,originWorkspaceId:task.originWorkspaceId,originSessionId:task.originSessionId||task.sessionId,sessionId:task.sessionId });
         if (Buffer.byteLength(json) > 48*1024*1024) throw Error('Task too large');
         const temp = join(root,'.'+randomUUID()+'.tmp');
         try { writeFileSync(temp,json,{mode:0o600,flag:'wx'});renameSync(temp,join(root,id+'.json')); }

package/lib/ui.html

@@ -5,12 +5,12 @@
 <body class="ff-ui ff-workbench">
 <header class="ff-workbench-head"><div class="ff-brand"><span class="ff-mark" data-icon="table"></span><h1>AI填表工作台</h1></div><p class="muted">识别空位，核验来源，确认后生成新副本。</p></header><nav class="task-tabs" aria-label="任务视图"><button id="current-tab" aria-pressed="true">当前任务</button><button id="history-tab" aria-pressed="false">任务历史</button></nav>
 <p id="status" role="status" aria-live="polite"></p>
-<section id="history" hidden><h2>本浏览器的任务</h2><p class="muted">只显示持有相同访问凭据的本地任务。过期任务自动清理。</p><div id="history-list"></div></section>
+<section id="history" hidden><h2>任务历史（只读）</h2><p class="muted">只显示当前存储实例内持有相同访问凭据的任务元数据。过期任务自动清理。</p><div id="history-list"></div></section>
 <main id="current">
 <nav class="ff-stages" aria-label="工作流程"><button data-step="import"><span class="ff-stage-icon" data-icon="upload"></span><span class="ff-stage-label">导入表格</span></button><button data-step="rules"><span class="ff-stage-icon" data-icon="settings"></span><span class="ff-stage-label">字段设置</span></button><button data-step="identity"><span class="ff-stage-icon" data-icon="identity"></span><span class="ff-stage-label">主体核验</span></button><button data-step="preview"><span class="ff-stage-icon" data-icon="table"></span><span class="ff-stage-label">填写预览</span></button><button data-step="download"><span class="ff-stage-icon" data-icon="download"></span><span class="ff-stage-label">确认下载</span></button></nav>
 <p id="task-meta" class="badge"></p>
 <details><summary>任务详情</summary><p id="task-details"></p></details>
-<div id="progress-panel" hidden><progress id="task-progress" max="100" aria-label="处理进度"></progress><p id="progress-label" role="status"></p><span id="review-count" class="ff-review-count"></span> <span id="failure-count" class="ff-failure-count"></span><p class="muted">100% 只代表处理结束，填写内容需在预览中核验并确认生成副本。</p></div>
+<div id="progress-panel" hidden><progress id="task-progress" max="100" aria-label="处理进度"></progress><p id="progress-label" role="status"></p><p id="progress-detail"></p><span id="review-count" class="ff-review-count"></span> <span id="failure-count" class="ff-failure-count"></span><p class="muted">100% 只代表处理结束，填写内容需在预览中核验并确认生成副本。</p></div>
 <div class="toolbar ff-execution-toolbar"><span id="execution-progress" role="status"></span><button id="cancel-run" disabled>取消查询</button><button id="retry-run" disabled>仅重试失败 / 未完成查询</button></div>
 <details id="grid" hidden><summary>查看完整原表 / 结果表格</summary><p class="muted">全量行列按页查看，隐藏行列只读标注。结果视图展示当前已选填写；下载不受分页或搜索影响。</p><div class="toolbar"><label>工作表 <select id="grid-sheet"></select></label><label>视图 <select id="grid-view"><option value="original">原表</option><option value="result">结果预览</option></select></label><label>搜索全部行 <input id="grid-query" type="search" maxlength="200"></label><button id="grid-search">搜索</button></div><p id="grid-status" role="status"></p><div class="scroll"><table><thead id="grid-head"></thead><tbody id="grid-body"></tbody></table></div><div class="toolbar"><button id="grid-prev">上一页</button><button id="grid-next">下一页</button><button id="grid-left">前 16 列</button><button id="grid-right">后 16 列</button></div></details>
 <div class="card" data-pane="import"><h2>导入表格</h2><p class="muted">支持 XLSX，最大 8 MiB。支持普通内部公式、固定文本或区域下拉、基础条件格式及普通表格对象；宏、图片、图表及复杂扩展结构暂不支持。上传仅做本地分析，不查询企查查。</p>
@@ -23,7 +23,7 @@
 <div class="toolbar"><label>筛选单元格 <input id="result-search" type="search" placeholder="位置、字段或值"></label><span id="result-count" class="muted"></span></div>
 <div class="scroll"><table><thead><tr><th>位置</th><th>字段</th><th>原值</th><th>准备填写</th><th>依据与来源</th><th>填写</th></tr></thead><tbody id="changes"></tbody></table></div><button id="selection">应用选择</button></div>
 <div class="card" data-pane="preview"><h2>待核验与失败项</h2><p id="reason-summary"></p><div class="scroll"><table><thead><tr><th>位置</th><th>字段</th><th>原因</th></tr></thead><tbody id="incomplete"></tbody></table></div></div>
-<div class="card" data-pane="download"><h2>确认并下载</h2><p>原文件不会被覆盖。下载包含全部已确认填写及完整清单，不受当前筛选影响。</p><button id="confirm" class="primary">确认这些填写，生成新副本</button><div id="downloads"></div><section id="report-preview" hidden><h3>任务结果报告</h3><div class="scroll"><table><thead><tr><th>工作表</th><th>位置</th><th>原表字段</th><th>结果状态</th><th>原值</th><th>填写值</th><th>数据来源</th><th>获取时间</th><th>结果说明</th></tr></thead><tbody id="report-body"></tbody></table></div></section></div>
+<div class="card" data-pane="download"><h2>确认并下载</h2><p>原文件不会被覆盖。下载包含全部已确认填写及完整清单，不受当前筛选影响。</p><button id="confirm" class="primary">确认这些填写，生成新副本</button><div class="ff-download-summary"><p id="download-summary"></p><a id="report-download" class="ff-report-link" hidden>下载任务结果报告</a></div><div id="downloads"></div></div>
 <details class="ff-task-more"><summary>更多任务操作</summary><div class="controls"><button id="refresh" class="secondary">刷新任务</button><button id="discard" class="secondary">删除任务</button></div></details><div class="ff-next-action" data-pane="preview" hidden><span>核验填充值后继续，下一步生成副本。</span><button id="preview-continue" class="primary">下一步：确认下载</button></div>
 </section></main>
 <dialog id="wizard" aria-labelledby="wizard-title"><header class="dialog-head"><div><h2 id="wizard-title">生成 AI填表任务</h2><p class="muted">上传原表、确认填写范围，使用企查查 MCP 核验企业信息并填写空白单元格。</p></div><button id="wizard-close" aria-label="关闭提示词向导">×</button></header>
@@ -47,6 +47,8 @@ if(!/^[a-f0-9]{64}$/.test(owner||'')){owner=[...crypto.getRandomValues(new Uint8
 document.cookie='ff_owner='+owner+'; SameSite=Strict; Path='+(basePath||'/');
 let current,filename='已填表格',busy=false,step='import',pendingNavigation,wizardStep=0,wizardFields=new Set(),wizardTask,wizardStructure,expectedDraft,retryIntent=false;
 const sessionId=new URLSearchParams(location.search).get('session')||undefined;
+const originWorkspaceId=new URLSearchParams(location.search).get('workspace')||undefined;
+const downloadUrl=(id,kind)=>basePath+'/download/'+id+'/'+kind+'?'+new URLSearchParams({session:sessionId||''});
 let gridPageNumber=1,gridColumn=1,gridRequest=0,gridTask;
 async function loadGrid(){
  if(!current||!$('grid').open)return;const request=++gridRequest,id=current.id;
@@ -68,7 +70,7 @@ function controls(value){busy=value;document.querySelectorAll('button').forEach(
 function row(target,values,labels){const tr=document.createElement('tr');values.forEach((v,i)=>{const td=document.createElement('td');td.textContent=v;td.title=String(v??'');td.dataset.label=labels[i];tr.append(td)});$(target).append(tr);return tr}
 function syncActions(){
  const running=current?.state==='enriching';
- const p=current?.presentation;$('progress-panel').hidden=!p||(!p.running&&!p.ended);if(p){$('task-progress').value=p.percent;$('task-progress').dataset.ended=String(p.ended);$('progress-label').textContent=(p.running?'处理中':p.ended?'处理结束':'待处理')+' · '+p.percent+'% · '+p.completed+' / '+p.total+' 查询计划项';$('progress-label').dataset.ended=String(p.ended);$('review-count').textContent='待核验 '+p.review+' 项';$('failure-count').textContent='失败 '+p.failures+' 项';}
+ const p=current?.presentation;$('progress-panel').hidden=!p||(!p.running&&!p.ended);if(p){$('task-progress').value=p.percent;$('task-progress').dataset.ended=String(p.ended);$('progress-label').textContent=(p.running?'处理中':p.ended?'处理结束':'待处理')+' · '+p.percent+'% · '+p.completed+' / '+p.total+' 查询计划项';$('progress-label').dataset.ended=String(p.ended);$('review-count').textContent='待核验 '+p.review+' 项';$('failure-count').textContent='失败 '+p.failures+' 项';$('progress-detail').textContent=p.currentAction+' · 已处理 '+p.completed+' 项 · 可填 '+p.filled+' 格 · 无数据 '+p.noData+' 格 · 用时 '+Math.floor(p.elapsedMs/1000)+' 秒'+(p.recentItem?' · 最近：'+p.recentItem:'')+'；查询结果：'+Object.entries(p.outcomes||{}).map(([k,v])=>({'data':'有数据','zero-records':'零记录','not-required':'无需执行','no-permission':'无权限',failed:'失败',unknown:'未知',review:'需核验'}[k]||'未知')+' '+v).join(' / ');}
  $('cancel-run').hidden=!running;$('cancel-run').disabled=busy||!running;
  $('retry-run').hidden=!current||current.confirmed||!current.changeSet.incomplete.some(i=>['provider-error','cancelled','not-started'].includes(i.reason));
  $('retry-run').disabled=busy||!current||current.confirmed||running||!current.changeSet.incomplete.some(i=>['provider-error','cancelled','not-started'].includes(i.reason));
@@ -77,9 +79,13 @@ function syncActions(){
 }
 $('cancel-run').onclick=async()=>{try{await api('/cancel',{id:current.id});$('status').textContent='已请求取消。已发出的请求可能已在远端执行，本地不再继续后续查询。';await restore()}catch(e){$('status').textContent=e.message}};
 $('retry-run').onclick=()=>{openWizard(true);wizardStep=3;renderWizard()};
-async function api(path,body){if(current&&body?.id===current.id)body={...body,expectedRevision:current.revision};const response=await fetch(basePath+path,{...(body===undefined?{}:{method:'POST',body:JSON.stringify(body)}),headers:{'Content-Type':'application/json','X-Form-Fill-Owner':owner}});const data=await response.json();if(!response.ok)throw Error(data.message);return data}
+async function api(path,body){if(current&&body?.id===current.id)body={...body,expectedRevision:current.revision};const response=await fetch(basePath+path,{...(body===undefined?{}:{method:'POST',body:JSON.stringify(body)}),headers:{'Content-Type':'application/json','X-Form-Fill-Owner':owner,'X-Form-Fill-Session':sessionId||''}});const data=await response.json();if(!response.ok)throw Error(data.message);return data}
 function navigate(target){if(target==='wizard'){openWizard();return}if(target!=='import'&&!current){$('status').textContent='请先导入表格。';return}step=target;if(parent!==window)parent.postMessage({type:'ff-view',step:target},location.origin);$('history').hidden=true;$('current').hidden=false;$('current-tab').setAttribute('aria-pressed','true');$('history-tab').setAttribute('aria-pressed','false');document.querySelectorAll('[data-pane]').forEach(p=>p.hidden=p.dataset.pane!==target);document.querySelectorAll('[data-step]').forEach(b=>b.setAttribute('aria-current',String(b.dataset.step===target)))}
-function downloads(){ $('report-preview').hidden=true;$('downloads').replaceChildren();for(const [kind,label,suffix] of [['xlsx','下载已填副本 XLSX','-已填副本.xlsx'],['report','下载任务结果报告 XLSX','-任务结果报告.xlsx']]){const group=document.createElement('div');group.className='toolbar';const preview=document.createElement('button');preview.textContent=kind==='xlsx'?'预览已填副本':'预览任务结果报告';preview.onclick=async()=>{if(kind==='xlsx'){navigate('preview');$('grid').open=true;$('grid-view').value='result';await loadGrid();$('grid').scrollIntoView({block:'start'})}else{try{const data=await api('/download/'+current.id+'/report-preview');$('report-body').replaceChildren();for(const values of data.rows)row('report-body',values,[]);$('report-preview').hidden=false;$('report-preview').scrollIntoView({block:'start'})}catch(e){$('status').textContent=e.message}}};const a=document.createElement('a');Object.assign(a,{className:'download',href:basePath+'/download/'+current.id+'/'+kind,download:filename+suffix,textContent:label});group.append(preview,a);$('downloads').append(group)}}
+function downloads(){
+ $('downloads').replaceChildren();$('download-summary').textContent='已确认填写 '+current.changeSet.changes.length+' 格 · '+(current.presentation?.status||'副本已生成');
+ Object.assign($('report-download'),{hidden:false,href:downloadUrl(current.id,'report'),download:filename+'-任务结果报告.xlsx'});
+ const group=document.createElement('div');group.className='toolbar';const preview=document.createElement('button');preview.textContent='预览已填副本';preview.onclick=async()=>{navigate('preview');$('grid').open=true;$('grid-view').value='result';await loadGrid();$('grid').scrollIntoView({block:'start'})};const a=document.createElement('a');Object.assign(a,{className:'download',href:downloadUrl(current.id,'xlsx'),download:filename+'-已填副本.xlsx',textContent:'下载已填副本 XLSX'});group.append(preview,a);$('downloads').append(group)
+}
 function businessSummary(){return current?(retryIntent?'仅重试失败、取消或未执行的部分，保留成功结果。':'')+'填写文件“'+current.filename+'”中的空白字段。共 '+current.analysis.tables.length+' 个工作表，'+wizardFields.size+' 个填写字段，'+current.analysis.opportunities.filter(p=>wizardFields.has(p.field)).length+' 个待补空位置。字段范围以本次保存的映射为准。保留已有值、公式与未确认位置，核验预览后生成新副本。':'请先上传 XLSX 文件。'}
 function command(){return current?businessSummary()+'\n'+$('requirements').value+'\n执行关联：调用 form_fill_enrich：taskId='+current.id+'，expectedRevision='+current.revision+(retryIntent?'，mode=retry':'')+'。字段范围以工作台确认设置为准。':''}
 function mappingVersion(){return JSON.stringify({tables:current?.analysis.tables.map(t=>({sheet:t.sheet,headerRow:t.headerRow,anchors:t.anchors,mappings:t.mappings.map(m=>[m.column,m.field,m.role,m.evidence])})),scope:current?.selectedFields??null})}
@@ -221,7 +227,7 @@ function renderSettings(data){
     role.onchange=()=>{manual=true;label.updateMappingStatus();highlightMappingConflicts()};
     const options=()=>{
      const group=data.catalogGroups?.find(g=>g.id===dimension.value);
-     const found=(data.catalog||[]).filter(f=>matches(f,search.value)&&(!dimension.value||(dimension.value==='other'?!data.catalogGroups?.some(g=>g.fields.includes(f.key)):group?.fields.includes(f.key))));
+     const found=(data.catalog||[]).filter(f=>(matches(f,search.value)||(data.catalogGroups||[]).some(g=>g.fields.includes(f.key)&&matches({label:g.label,key:g.id},search.value)))&&(!dimension.value||(dimension.value==='other'?!data.catalogGroups?.some(g=>g.fields.includes(f.key)):group?.fields.includes(f.key))));
      select.replaceChildren();
      const list=[{key:'',label:'不填写'},...found];
      if(chosen&&!found.some(f=>f.key===chosen)){const field=data.catalog.find(f=>f.key===chosen);if(field)list.splice(1,0,{...field,label:field.label+'（当前选择，筛选外）'})}
@@ -235,7 +241,7 @@ function renderSettings(data){
     select.onchange=choose;
     select.ondblclick=finish;
     select.onkeydown=event=>{if(event.key==='Enter'){event.preventDefault();finish()}};
-    search.oninput=options;dimension.onchange=options;
+    search.oninput=e=>{if(!e.isComposing)options()};search.oncompositionend=options;dimension.onchange=options;
     if(!chosen&&!manual){
      // Strip only a trailing date-format annotation for recommendations. Keep
      // the original header and require confirmation; semantic qualifiers remain.
@@ -274,7 +280,7 @@ function render(data){
 current=data;directScope();$('direct-command').hidden=true;filename=(data.filename||'已填表格.xlsx').replace(/\.xlsx$/i,'');location.hash='task='+data.id;
 if(gridTask!==data.id){gridTask=data.id;gridPageNumber=1;gridColumn=1;$('grid-sheet').replaceChildren();$('grid-query').value=''}$('grid').hidden=false;loadGrid();
 if(parent!==window)parent.postMessage({type:'ff-task',taskId:data.id},location.origin);
-$('incomplete').closest('.card').style.display=(data.exceptions||data.changeSet.incomplete).length?'':'none';$('changes').replaceChildren();$('incomplete').replaceChildren();$('report-preview').hidden=true;$('downloads').replaceChildren();
+$('incomplete').closest('.card').style.display=(data.exceptions||data.changeSet.incomplete).length?'':'none';$('changes').replaceChildren();$('incomplete').replaceChildren();$('report-download').hidden=true;$('report-download').removeAttribute('href');$('download-summary').textContent='';$('downloads').replaceChildren();
 $('task-meta').dataset.state=data.state;
 $('task-meta').textContent=(data.presentation?.title||data.filename)+' · '+(data.presentation?.status||data.state);$('task-details').textContent='任务 ID：'+data.id+' · 有效期至 '+new Date(data.expiresAt).toLocaleString();
 $('summary').textContent='可填写 '+data.changeSet.changes.length+' 格 · '+(data.plan.paidCalls?'企查查来源':'本地分析 / 合成示例 · 费用 0')+' · 未完成 '+data.changeSet.incomplete.length+' 项';
@@ -291,8 +297,8 @@ initWizard();filterResults();syncActions();if($('wizard').open)renderWizard();
  const missing=data.analysis.incomplete.filter(i=>i.reason==='missing-anchor');
  $('anchor-alert').textContent=missing.length?'有 '+missing.length+' 行缺少可用主体标识。请把实际包含名称的列映射为“企业名称”，或提供非空信用代码；当前不会查询这些行。':'';
 }
-async function restore(silent=false){if(busy||!current&& !location.hash)return;const id=new URLSearchParams(location.hash.slice(1)).get('task');if(!id)return;try{const data=await api('/task/'+encodeURIComponent(id));if(!silent||data.id!==current?.id||data.revision!==current?.revision){const wasRunning=current?.state==='enriching';render(data);if(silent&&data.state==='enriching'){navigate('identity');$('status').textContent=$('execution-progress').textContent}else if(silent&&wasRunning){navigate('preview');$('status').textContent='查询已结束，请检查填写预览。'}if(!silent){const target=pendingNavigation||(data.confirmed?'download':'preview');pendingNavigation=undefined;if(target==='history')$('history-tab').click();else navigate(target)}}}catch(e){if(!silent)$('status').textContent=e.message}}
-async function preview(buffer,name,demo=false){controls(true);try{const bytes=new Uint8Array(buffer);if(bytes.length>8388608)throw Error('文件超过 8 MiB');let binary='';for(let i=0;i<bytes.length;i+=32768)binary+=String.fromCharCode(...bytes.subarray(i,i+32768));$('grid').open=true;render(await api('/preview',{base64:btoa(binary),filename:name,sessionId,analyzeOnly:!demo}));navigate(demo?'preview':'rules');$('status').textContent='预览已准备好，请检查后确认。'}catch(e){$('status').textContent=e.message;$('wizard-message').textContent=e.message}finally{controls(false)}}
+async function restore(silent=false){if(busy||!current&& !location.hash)return;const id=new URLSearchParams(location.hash.slice(1)).get('task');if(!id)return;try{const data=await api('/task/'+encodeURIComponent(id));if(silent&&data.id===current?.id&&data.revision===current?.revision){current.presentation=data.presentation;syncActions()}if(!silent||data.id!==current?.id||data.revision!==current?.revision){const wasRunning=current?.state==='enriching';render(data);if(silent&&data.state==='enriching'){navigate('identity');$('status').textContent=$('execution-progress').textContent}else if(silent&&wasRunning){navigate('preview');$('status').textContent='查询已结束，请检查填写预览。'}if(!silent){const target=pendingNavigation||(data.confirmed?'download':'preview');pendingNavigation=undefined;if(target==='history')$('history-tab').click();else navigate(target)}}}catch(e){if(!silent)$('status').textContent=e.message}}
+async function preview(buffer,name,demo=false){controls(true);try{const bytes=new Uint8Array(buffer);if(bytes.length>8388608)throw Error('文件超过 8 MiB');let binary='';for(let i=0;i<bytes.length;i+=32768)binary+=String.fromCharCode(...bytes.subarray(i,i+32768));$('grid').open=true;render(await api('/preview',{base64:btoa(binary),filename:name,sessionId,originWorkspaceId,analyzeOnly:!demo}));navigate(demo?'preview':'rules');$('status').textContent='预览已准备好，请检查后确认。'}catch(e){$('status').textContent=e.message;$('wizard-message').textContent=e.message}finally{controls(false)}}
 document.querySelectorAll('[data-step]').forEach(b=>b.onclick=()=>navigate(b.dataset.step));
 $('file').onchange=async()=>{const input=$('file'),f=input.files[0];if(!f||busy)return;input.disabled=true;controls(true);$('status').textContent='正在自动解析表格…';try{await preview(await f.arrayBuffer(),f.name)}catch(e){$('status').textContent=e.message}finally{input.disabled=false;input.value='';controls(false)}};
 function readMapping(){const configuration={sheets:[],headers:[],mappings:[]};for(const section of $('mapping').querySelectorAll('fieldset')){if(!section.querySelector('.sheet-enabled').checked)continue;const sheet=section.dataset.sheet;configuration.sheets.push(sheet);configuration.headers.push({sheet,row:Number(section.querySelector('.header-row').value)});for(const field of section.querySelectorAll('[data-column]'))if(field.value||field.dataset.manual==='true')configuration.mappings.push({sheet,column:Number(field.dataset.column),field:field.value||null,...(field.dataset.primary==='true'?{role:field.closest('.ff-mapping-row').querySelector('.ff-mapping-role').value}:{})})}return configuration}
@@ -305,7 +311,7 @@ $('confirm').onclick=async()=>{if(!current||busy)return;controls(true);try{await
 $('selection').onclick=async()=>{if(!current||busy)return;controls(true);try{render(await api('/select',{id:current.id,selectedIds:[...$('changes').querySelectorAll('input:checked')].map(x=>x.value)}));$('status').textContent='选择已应用，请核对新的预览。'}catch(e){$('status').textContent=e.message}finally{controls(false)}};
 $('refresh').onclick=()=>restore();
 $('discard').onclick=async()=>{if(!current||busy)return;controls(true);try{await api('/discard',{id:current.id});current=null;history.replaceState(null,'',location.pathname+location.search);$('preview').hidden=true;$('grid').hidden=true;gridTask=null;navigate('import');$('status').textContent='任务及保存的表格已删除。'}catch(e){$('status').textContent=e.message}finally{controls(false)}};
-$('history-tab').onclick=async()=>{try{const list=await api('/tasks');$('history-list').replaceChildren();for(const item of list){const div=document.createElement('div');div.className='history-item';const button=document.createElement('button');button.textContent=(item.presentation?.title||item.filename)+' · '+(item.presentation?.status||item.state);button.onclick=()=>{location.hash='task='+item.id;restore()};const details=document.createElement('details'),summary=document.createElement('summary');summary.textContent='任务详情';details.append(summary,document.createTextNode('任务 ID：'+item.id));div.append(button,details);$('history-list').append(div)}if(parent!==window)parent.postMessage({type:'ff-view',step:'history'},location.origin);$('history').hidden=false;$('current').hidden=true;$('current-tab').setAttribute('aria-pressed','false');$('history-tab').setAttribute('aria-pressed','true');if(!list.length)$('history-list').textContent='暂无可恢复的任务。'}catch(e){$('status').textContent=e.message}};
+$('history-tab').onclick=async()=>{try{const list=await api('/history');$('history-list').replaceChildren();for(const item of list){const div=document.createElement('div');div.className='history-item';const title=document.createElement('strong');title.textContent=(item.title||item.filename)+' · '+item.status;const details=document.createElement('details'),summary=document.createElement('summary');summary.textContent='查看历史元数据（只读）';const text=document.createElement('p');text.textContent='来源工作区：'+(item.originWorkspaceId||'旧任务未记录')+'；来源会话：'+(item.originSessionId||'独立页面 / 旧任务未记录')+'；任务 ID：'+item.id+'；有效期至 '+new Date(item.expiresAt).toLocaleString();details.append(summary,text);const hint=document.createElement('p');hint.className='muted';hint.textContent='仅展示当前存储实例内同访问凭据的历史元数据，不加载原表，也不绑定到当前任务。';div.append(title,details,hint);if(parent!==window&&item.originSessionId){const open=document.createElement('button');open.textContent='打开来源会话';open.onclick=()=>parent.postMessage({type:'ff-open-origin',sessionId:item.originSessionId},location.origin);div.append(open)}else{const fallback=document.createElement('p');fallback.textContent='请从宿主历史进入来源会话；独立页面不支持切换宿主会话。';div.append(fallback)}$('history-list').append(div)}if(parent!==window)parent.postMessage({type:'ff-view',step:'history'},location.origin);$('history').hidden=false;$('current').hidden=true;$('current-tab').setAttribute('aria-pressed','false');$('history-tab').setAttribute('aria-pressed','true');if(!list.length)$('history-list').textContent='当前存储实例内无此访问凭据可见的有效历史。'}catch(e){$('status').textContent=e.message}};
 $('current-tab').onclick=()=>navigate(step);
 $('wizard-open').onclick=()=>directDraft();$('wizard-close').onclick=()=>closeWizard();$('wizard').addEventListener('cancel',e=>{e.preventDefault();closeWizard()});
 document.querySelectorAll('[data-wizard-step]').forEach(b=>b.onclick=()=>{const next=Number(b.dataset.wizardStep);wizardStep=next>1&&wizardMappingApplied!==JSON.stringify([current?.id,readMapping()])?1:next;saveWizard();renderWizard()});
@@ -319,8 +325,9 @@ $('copy-command').onclick=async()=>{try{await applyScope();saveWizard();await na
 $('draft').onclick=()=>sendDraft();
 $('draft-cancel').onclick=()=>$('draft-conflict').close();
 for(const mode of ['append','replace'])$('draft-'+mode).onclick=()=>{$('draft-conflict').close();sendDraft(mode)};
-$('mapping-search').oninput=()=>{const query=$('mapping-search').value.trim().toLowerCase();$('mapping').querySelectorAll('.ff-mapping-row').forEach(row=>row.hidden=!row.dataset.sourceLabel.toLowerCase().includes(query))};
-$('result-search').oninput=filterResults;$('changes').onchange=filterResults;
+$('mapping-search').oninput=e=>{if(e?.isComposing)return;const query=$('mapping-search').value.trim().toLowerCase();$('mapping').querySelectorAll('.ff-mapping-row').forEach(row=>row.hidden=!row.dataset.sourceLabel.toLowerCase().includes(query))};
+$('mapping-search').oncompositionend=()=> $('mapping-search').oninput();
+$('result-search').oninput=e=>{if(!e.isComposing)filterResults()};$('result-search').oncompositionend=filterResults;$('changes').onchange=filterResults;
 window.addEventListener('message',e=>{if(e.origin!==location.origin||e.source!==parent)return;if(e.data?.type==='ff-theme'&&['light','dark'].includes(e.data.theme))document.body.dataset.ffTheme=e.data.theme;if(e.data?.type==='ff-draft-conflict'){expectedDraft=e.data.draft;if(!$('draft-conflict').open)$('draft-conflict').showModal()}if(e.data?.type==='ff-draft-result'){$('status').textContent=e.data.ok?'已回填，请在对话框修改或发送。':'回填失败，任务已保留。';if(e.data.ok){closeWizard(true);navigate('identity');$('status').textContent='指令已回填，发送后将在此显示查询进度。'}}if(e.data?.type==='ff-navigate'){if(!current&&location.hash){pendingNavigation=e.data.step;return}if(e.data.step==='history')$('history-tab').click();else navigate(e.data.step)}});
 api('/health').then(s=>{$('connection').textContent=s.qccAvailable?'已发现企查查工商工具，可在对话中执行。':'尚未发现企查查工商工具；请先连接 MCP。合成模板仍可体验。'}).catch(()=>{});
 $('preview-continue').onclick=async()=>{if(busy||!current)return;controls(true);try{const ids=[...$('changes').querySelectorAll('input:checked')].map(x=>x.value);if(!current.confirmed&&JSON.stringify([...ids].sort())!==JSON.stringify([...(current.selectedIds||[])].sort()))render(await api('/select',{id:current.id,selectedIds:ids}));navigate('download');$('confirm').scrollIntoView({block:'center'});$('confirm').focus();$('status').textContent=current.confirmed?'副本已生成，请点击下载。':'请确认填写结果，点击蓝色按钮生成新副本。'}catch(e){$('status').textContent=e.message}finally{controls(false)}};
@@ -329,6 +336,7 @@ function saveMappingDraft(){if(!current)return;sessionStorage.setItem('ff-ui-map
 window.addEventListener('pagehide',saveMappingDraft);
 for(const event of ['change','click'])$('mapping').addEventListener(event,saveMappingDraft);
 $('mapping').addEventListener('change',()=>{wizardMappingApplied=false;$('mapping-next').hidden=true;highlightMappingConflicts()});
+window.addEventListener('message',e=>{if(e.origin===location.origin&&e.source===parent&&e.data?.type==='ff-origin-unavailable')$('status').textContent='宿主无法打开来源会话，请从宿主历史手动进入；当前任务未改变。'});
 window.addEventListener('hashchange',()=>{if(new URLSearchParams(location.hash.slice(1)).get('task')!==current?.id)restore()});
 async function restoreSessionTask(){if(location.hash||!sessionId){restore();return}try{const list=await api('/tasks');if(current||location.hash)return;const task=list.filter(item=>item.sessionId===sessionId).sort((a,b)=>(b.updatedAt||b.created)-(a.updatedAt||a.created))[0];if(task){location.hash='task='+task.id;await restore()}}catch(e){$('status').textContent='恢复任务失败，可在任务历史中重试：'+e.message}}
 navigate('import');restoreSessionTask();setInterval(()=>{if(!document.hidden&&current&&!busy&&!$('wizard').open)restore(true)},2000);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-form-fill-agent",
-  "version": "0.2.26",
+  "version": "0.2.28",
   "private": false,
   "description": "AI form filling and spreadsheet autofill for XLSX in DeepSeek Harness, using authorized Qichacha MCP facts with cell previews, user confirmation and export to a new copy.",
   "repository": {