bdip-office-assistant-cli 0.0.0-stage → 1.0.1

package/dist/field-preparation.js

@@ -0,0 +1,237 @@
+import {definitions,detailTables,fingerprint,loadAdapter,buildDraft,verifyDraft,queryBrowser} from './workflow-runtime.js';
+import {createApiFromProfile} from './client.js';
+import {parseFormula,evaluateFormula,formulaDateFunctions} from './formula-runtime.js';
+import {executeCalculations} from './linkage-calculations.js';
+
+const clone=x=>structuredClone(x);
+const cell=x=>x&&typeof x==='object'&&'value'in x?clone(x):{value:x??''};
+const fieldKey=id=>String(id).replace(/^field/,'');
+const equal=(a,b)=>JSON.stringify(a)===JSON.stringify(b);
+export function paragraphText(value,field) {
+    if(Number(field?.htmltype)!==2 || Number(field?.detailtype)!==2 || !/[\r\n]/.test(String(value)) || /<[^>]+>/.test(String(value))) return value;
+    const escape=s=>s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
+    return String(value).replace(/\r\n/g,'\n').split('\n').map(line=>'<p>'+escape(line)+'</p>').join('');
+}
+
+const fail=(state,message)=>{const error=Error(message);error.preparationState=state;throw error;};
+export function stableConfig(value) {
+    if(Array.isArray(value))return value.map(stableConfig);
+    if(value&&typeof value==='object')return Object.fromEntries(Object.keys(value).sort().filter(k=>!['systemdatas','files','linkageUUID','currenttime','signatureSecretKey','signatureAttributesStr','formulakey'].includes(k)).map(k=>[k,stableConfig(value[k])]));
+    return value;
+}
+// 小语法解释器：字段引用、字符串、IF和相等判断；从不执行服务器JavaScript。
+export function formulaValue(text,read) {
+    const tokens=text.match(/\[(?:main|detail_\d+)\.-?\d+\]|'(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*"|==|!=|IF|[(),]|\s+|-?\d+(?:\.\d+)?/g)??[];
+    if(tokens.join('')!==text)fail('unsupported','不支持的公式语法');
+    const ts=tokens.filter(t=>!/^\s+$/.test(t));let i=0;
+    const primary=()=>{
+        const t=ts[i++];
+        if(t==='IF'){if(ts[i++]!=='(')throw Error('IF语法');const cond=expr();if(ts[i++]!==',')throw Error('IF语法');const yes=expr();if(ts[i++]!==',')throw Error('IF语法');const no=expr();if(ts[i++]!==')')throw Error('IF语法');return cond?yes:no;}
+        if(/^\[/.test(t??''))return read(t.slice(1,-1));
+        if(/^['"]/.test(t??''))return t.slice(1,-1);
+        if(/^-?\d/.test(t??''))return t;
+        fail('unsupported','无法解释公式');
+    };
+    const expr=()=>{let a=primary();if(ts[i]==='=='||ts[i]==='!='){const op=ts[i++],b=primary();a=op==='=='?String(a)===String(b):String(a)!==String(b);}return a;};
+    const result=expr();if(i!==ts.length)fail('unsupported','公式存在未处理内容');return result;
+}
+export async function executeLinkages(api,form,tables,input,{maxSteps=100,covered=[]}={}) {
+    const f=clone(form),t=clone(tables),defs=definitions(f),cfg=f.linkageCfg??{};
+    const evidence={state:'preparing',coverage:[],rowChanges:[]};
+    // 未支持的配置必须明确由已验证适配承担，不能吞错继续。
+    const supported=['formulaCfg','dataInputCfg','fieldSqlCfg','mainCalCfg','colCalCfg','rowCalCfg','fieldDateCfg','viewAttrCfg'];
+    const unsupported=Object.entries(cfg).filter(([kind,data])=>!supported.includes(kind)&&JSON.stringify(data)!=='{}'&&JSON.stringify(data)!=='[]'&&!covered.includes(kind)).map(([kind])=>kind);
+    if(unsupported.length)fail('unsupported','联动配置尚未支持：'+unsupported.join('、'));
+    const getCells=(table,row)=>table==='main'?f.maindata:t[table]?.rows[row];
+    const protectedValues=new Map();
+    const write=(table,row,id,value,source)=>{
+        const field=defs.find(x=>x.table===table&&x.id===String(id));if(!field)fail('unsupported','联动目标字段不存在：'+id);
+        const cells=getCells(table,row);if(!cells)fail('unsupported','联动行不存在');
+        const next=cell(value);
+        // 联动可能先产生中间值；只在全部规则稳定后检查是否覆盖用户值。
+        if(String(cells['field'+id]?.value??'')===String(next.value)&&(!next.specialobj||equal(cells['field'+id]?.specialobj,next.specialobj)))return false;
+        cells['field'+id]=next;return true;
+    };
+    const applyUserInput=()=>{
+    for(let [raw,v]of Object.entries(input.values??{})){
+        const id=fieldKey(raw);if(Number(id)<0)continue;
+        const d=defs.find(x=>x.id===id&&x.table==='main');if(!d||![2,3].includes(Number(d.viewattr)))fail('conflict','禁止用户覆盖只读/隐藏字段：'+id);
+        v=paragraphText(v,d);
+        write('main',-1,id,{value:v,specialobj:input.browserNames?.[id]?[{name:input.browserNames[id]}]:undefined});protectedValues.set(`main.${id}:-1`,v);
+    }
+    for(const dt of input.details??[]){const mark='detail_'+(Number(dt.index)+1);if(!t[mark])fail('unsupported','明细不存在');
+        if(input.requestId&&t[mark].rows.length!==dt.rows.length)fail('unsupported','用户增删明细需专门适配');
+        if(!input.requestId)t[mark].rows=dt.rows.map(()=>clone(t[mark].addRowDefValue??{}));
+        dt.rows.forEach((row,i)=>Object.entries(row).forEach(([raw,v])=>{const id=fieldKey(raw),d=defs.find(x=>x.id===id&&x.table===mark);if(!d||![2,3].includes(Number(d.viewattr)))fail('conflict','禁止用户覆盖只读明细：'+id);v=paragraphText(v,d);write(mark,i,id,{value:v,specialobj:input.detailBrowserNames?.[dt.index]?.[i]?.[id]?[{name:input.detailBrowserNames[dt.index][i][id]}]:undefined});protectedValues.set(`${mark}.${id}:${i}`,v);}));
+    }
+    };
+    // 新建表单先完成初始化带值，再应用用户填写；初始化规则不能反复覆盖用户明细。
+    let userApplied=!!input.requestId||!Object.keys(cfg.dataInputCfg??{}).length;
+    if(userApplied)applyUserInput();
+    const seen=new Map();let steps=0;
+    const formulas=cfg.formulaCfg?.formulas??[],dateFunctions=formulaDateFunctions(api);
+    for(let pass=0;pass<maxSteps;pass++){
+        let changed=false;
+        changed=await executeCalculations({api,form:f,tables:t,input,defs,getCells,write,seen,evidence,step:()=>{if(++steps>maxSteps)fail('nonconvergent','联动超限或循环不收敛');}})||changed;
+        for(const rule of formulas){
+            const m=String(rule.formula??'').match(/^\[(main|detail_\d+)\.(-?\d+)\]\s*=\s*(.*)$/);if(!m)fail('unsupported','公式目标语法不支持');
+            const [,table,id,expression]=m;
+            const rows=table==='main'?[-1]:(t[table]?.rows??[]).map((_,i)=>i);
+            for(const row of rows){const read=ref=>{const [tab,fid]=ref.split('.');return getCells(tab,tab==='main'?-1:row)?.['field'+fid]?.value??'';};
+                const sum=expression.trim().match(/^SUM\(\[(detail_\d+)\.(\d+)\]\)$/);
+                let value;
+                if(sum){
+                    const source=t[sum[1]];
+                    if(!source)fail('unsupported','SUM明细表不存在');
+                    value=source.rows.reduce((total,r)=>{
+                        const raw=r['field'+sum[2]]?.value??'';
+                        const n=raw===''?0:Number(raw);
+                        if(!Number.isFinite(n))fail('unsupported','SUM明细包含非数值');
+                        return total+n;
+                    },0);
+                }else value=await evaluateFormula(parseFormula(expression),ref=>{
+                    const raw=read(ref),id=ref.split('.')[1],d=defs.find(x=>x.id===id);
+                    return Number(d?.htmltype)===1&&[2,3,4,5].includes(Number(d.detailtype))?Number(raw||0):raw;
+                },dateFunctions);
+                const sourceRef=expression.trim().match(/^\[(main|detail_\d+)\.(\d+)\]$/);
+                const next=sourceRef?getCells(sourceRef[1],sourceRef[1]==='main'?-1:row)?.['field'+sourceRef[2]]:{value};
+                // 双向互拷贝以非空输入为起点；未设置一端不能清掉另一端。
+                if(sourceRef&&String(next?.value??'')===''&&String(getCells(table,row)?.['field'+id]?.value??'')!=='')continue;
+                changed=write(table,row,id,next??{value},'formula')||changed;
+                evidence.coverage.push({kind:'formula',target:table+'.'+id,row,state:'executed'});
+            }
+        }
+        for(const [trigger,rules]of Object.entries(cfg.fieldSqlCfg??{}))for(const rule of rules){
+            const targetIds=String(rule.assignField??'').split(',').filter(Boolean);
+            const targetDefs=targetIds.map(id=>defs.find(d=>d.id===id));
+            if(!targetDefs.length||targetDefs.some(d=>!d))fail('unsupported','SQL字段查询目标未知');
+            const table=targetDefs[0].table;
+            if(targetDefs.some(d=>d.table!==table))fail('unsupported','SQL字段查询跨表目标需适配');
+            for(const row of table==='main'?[-1]:(t[table]?.rows??[]).map((_,i)=>i)){
+                const params={};
+                for(const id of rule.relateFields??[]){const def=defs.find(d=>d.id===String(id));if(!def)fail('unsupported','SQL依赖字段不存在');params['field'+id+(def.table==='main'?'':'_'+row)]=getCells(def.table,def.table==='main'?-1:row)?.['field'+id]?.value??'';}
+                const key='sql:'+rule.config+':'+row,signature=JSON.stringify(params);if(seen.get(key)===signature)continue;
+                if(++steps>maxSteps)fail('nonconvergent','字段查询超限');seen.set(key,signature);
+                const p=f.params,body={...params,requestid:String(input.requestId??'-1'),workflowid:String(input.workflowId),nodeid:String(p.nodeid),formid:String(p.formid),isbill:String(p.isbill??'1'),triSource:'1',showAI:'1',linkageid:String(rule.config),linkageUUID:f.submitParams.linkageUUID??'',
+                    ['triFieldid_'+rule.config]:trigger==='emptyTriField'?'':trigger,['rowIndexStr_'+rule.config]:String(row),['triTableMark_'+rule.config]:table,f_weaver_belongto_userid:input.accountId,f_weaver_belongto_usertype:String(p.f_weaver_belongto_usertype??'0')};
+                const response=await api.post('/api/workflow/linkage/reqFieldSqlResult',body,{forceCookie:true});const info=response.json?.['assignInfo_'+rule.config];
+                if(!info||info.resultOutOfLimit||response.json?.status===false)fail('failed','字段查询失败：'+rule.config);
+                for(const key of Object.keys(info))if(!['changeValue','linkageSql','resultOutOfLimit'].includes(key))fail('unsupported','字段查询响应未支持：'+key);
+                for(const [raw,value]of Object.entries(info.changeValue??{})){const m=raw.match(/^field(\d+)(?:_(\d+))?$/);if(!m)fail('unsupported','SQL目标格式未知');const d=defs.find(d=>d.id===m[1]);changed=write(d?.table,m[2]?Number(m[2]):d?.table==='main'?-1:row,m[1],value,'server')||changed;}
+                evidence.coverage.push({kind:'fieldSql',config:String(rule.config),row,state:'executed'});
+            }
+        }
+        for(const [raw,configs]of Object.entries(cfg.dataInputCfg??{})){
+            const id=fieldKey(raw),d=defs.find(x=>x.id===id);if(!d||!Array.isArray(configs))fail('unsupported','数据联动配置无效');
+            for(const row of d.table==='main'?[-1]:(t[d.table]?.rows??[]).map((_,i)=>i))for(const rule of configs){
+                const key=`${rule.config}:${d.table}:${row}`;
+                const values={};for(const field of defs){const cells=getCells(field.table,field.table==='main'?-1:row);if(cells?.['field'+field.id])values['field'+field.id]=cells['field'+field.id].value;}
+                const signature=JSON.stringify([id,...(rule.relateFields??[])].map(fid=>[fid,values['field'+fid]??'']));if(seen.get(key)===signature)continue;
+                if(++steps>maxSteps)fail('nonconvergent','联动超限或循环不收敛');seen.set(key,signature);
+                const p=f.params,sp=f.submitParams;
+                const body={...values,requestid:String(input.requestId??'-1'),workflowid:String(input.workflowId),nodeid:String(p.nodeid),formid:String(p.formid),isbill:String(p.isbill??'1'),triSource:'1',showAI:'1',linkageid:String(rule.config),linkageUUID:sp.linkageUUID??'',
+                    [`triFieldid_${rule.config}`]:id,[`rowIndexStr_${rule.config}`]:String(row),[`triTableMark_${rule.config}`]:d.table,f_weaver_belongto_userid:input.accountId,f_weaver_belongto_usertype:String(p.f_weaver_belongto_usertype??'0')};
+                if(row>=0)for(const [k,v]of Object.entries(values))body[k+'_'+row]=v;
+                for(const assigned of rule.otherParams?.assignfields??[]) {
+                    const assignedDef=defs.find(x=>x.id===String(assigned));
+                    const dependencies=assignedDef?.browserattr?.cusDependShip??[];
+                    if(dependencies.length){const depend={};for(const dep of dependencies){const d=defs.find(x=>x.id===String(dep.fieldid));if(!d)fail('unsupported','自定义浏览框依赖不存在');const c=getCells(d.table,d.table==='main'?-1:row);if(!c&&row>=0)fail('unsupported','缺少自定义浏览框同行依赖');depend[dep.key]=c?.['field'+dep.fieldid]?.value??'';}body['customDepend_field'+assigned+(assignedDef.table==='main'?'':'_'+row)]=JSON.stringify(depend);}
+                }
+                const r=await api.post('/api/workflow/linkage/reqDataInputResult',body,{forceCookie:true});
+                const info=r.json?.['assignInfo_'+rule.config];if(!info||info.resultOutOfLimit||info.error||r.json?.status===false)fail('failed','数据联动失败/超限：'+rule.config);
+                for(const k of Object.keys(info))if(!['linkageSql','changeValue','addDetailRow','resultOutOfLimit'].includes(k))fail('unsupported','联动响应操作未支持：'+k);
+                for(const [target,v]of Object.entries(info.changeValue??{})){
+                    const match=target.match(/^field(\d+)(?:_(\d+))?$/);if(!match)fail('unsupported','联动目标格式未知');const dest=defs.find(x=>x.id===match[1]);
+                    changed=write(dest?.table,match[2]?Number(match[2]):dest?.table==='main'?-1:row,match[1],v,'server')||changed;
+                }
+                for(const [mark,rows]of Object.entries(info.addDetailRow??{})){
+                    if(!Array.isArray(rows)||!t[mark])fail('unsupported','联动新增明细格式未知');
+                    const existing=t[mark].rows,used=new Set();
+                    const result=rows.map(r=>{const fields=Object.keys(r);const index=existing.findIndex((e,i)=>!used.has(i)&&fields.every(k=>String(e[k]?.value??'')===String(r[k]?.value??'')));if(index>=0)used.add(index);return {...clone(t[mark].addRowDefValue??{}),...(index>=0?existing[index]:{}),...r};});
+                    if(String(rule.otherParams?.isdel)==='1'){
+                        if(existing.some((e,i)=>e.keyid&&!used.has(i)))fail('unsupported','联动删除/替换已有明细需经验证的行删除适配');
+                        if(!equal(existing,result)){t[mark].rows=result;changed=true;}
+                    }else{
+                        const additions=result.filter(r=>!existing.some(e=>Object.keys(r).filter(k=>k!=='keyid').every(k=>equal(e[k],r[k]))));
+                        if(additions.length){existing.push(...additions);changed=true;}
+                    }
+                    evidence.rowChanges.push({config:String(rule.config),table:mark,rows:t[mark].rows.length,mode:String(rule.otherParams?.isdel)==='1'?'replace':'append'});
+                }
+                evidence.coverage.push({kind:'dataInput',config:String(rule.config),row,state:'executed'});
+            }
+        }
+        if(!changed){
+            if(!userApplied){applyUserInput();userApplied=true;continue;}
+            for(const [key,value]of protectedValues){const [ref,row]=key.split(':');const [table,id]=ref.split('.');if(String(getCells(table,Number(row))?.['field'+id]?.value??'')!==String(value))fail('conflict','联动明细覆盖用户值：'+id);const attr=evidence.viewAttributes?.[table+':'+row+':'+id];if(attr!==undefined&&![2,3].includes(attr))fail('conflict','用户字段在联动后不可编辑：'+id);}
+            for(const [key,attr]of Object.entries(evidence.viewAttributes??{}))if(attr===3){const [table,row,id]=key.split(':');if(String(getCells(table,Number(row))?.['field'+id]?.value??'')==='')fail('conflict','联动后必填字段为空：'+id);}
+            evidence.state='complete';return {form:f,tables:t,evidence};
+        }
+    }
+    fail('nonconvergent','联动循环未收敛');
+}
+export async function validatePersonAssignments(api,cfg,plan,form,tables) {
+    const evidence=[];
+    const defs=definitions(form);
+    const check=async(values,table,rowIndex=-1)=>{
+        for(const [key,value] of Object.entries(values??{})) {
+            const id=fieldKey(key),f=defs.find(d=>d.id===id&&d.table===table);
+            if(Number(f?.htmltype)!==3||![1,17].includes(Number(f.detailtype))||String(value??'')==='')continue;
+            const ids=String(value).split(',').map(x=>x.trim()).filter(Boolean);
+            if(ids.some(x=>!/^\d+$/.test(x)))throw Error('人员字段必须使用已核验的账号ID');
+            const result=await queryBrowser(api,form,id,{main:plan.values,row:values,rowCells:tables[table]?.rows?.[rowIndex],baseUrl:cfg.baseUrl,...plan.personScopes?.[id]});
+            if(ids.some(id=>!result.items.some(c=>c.id===id)))throw Error('人员不在当前分部及表单可选范围内：字段'+id+'；零结果不会扩大范围');
+            evidence.push({fieldId:id,rowIndex,account:result.account,scope:result.scope,ids,verification:result.verification});
+        }
+    };
+    await check(plan.values,'main');
+    for(const dt of plan.details??[])for(let i=0;i<dt.rows.length;i++)await check(dt.rows[i],'detail_'+(Number(dt.index)+1),i);
+    return evidence;
+}
+export async function prepareFields(cfg,plan,{api,form,tables}={}) {
+    api??=await createApiFromProfile(cfg);
+    if(!form){const r=await api.post('/api/workflow/reqform/loadForm',{workflowid:String(plan.workflowId),requestid:String(plan.requestId??'-1'),iscreate:plan.requestId?'0':'1'},{forceCookie:true});form=r.json;}
+    if(form?.params?.verifyRight!==true||String(form.params.currentUserid)!==String(plan.accountId))throw Error('账号或表单权限不符');
+    tables??=await detailTables(api,form,plan.workflowId,plan.requestId);
+    const adapter=await loadAdapter(cfg,plan.workflowId,form);
+    if(adapter?.prepare)await adapter.prepare({plan,form,tables,mapping:adapter.mapping});
+    const personnel=await validatePersonAssignments(api,cfg,plan,form,tables);
+    const linked=await executeLinkages(api,form,tables,plan,{covered:adapter?.supportedLinkageKinds??[]});
+    // 中间联动可能清空再恢复同一ID；最终值已通过冲突检查，可恢复该用户选项的已确认显示名。
+    for(const [id,name]of Object.entries(plan.browserNames??{})){const c=linked.form.maindata?.['field'+id];if(c&&name&&(Object.hasOwn(plan.values??{},id)||Object.hasOwn(plan.values??{},'field'+id)))c.specialobj=[{id:String(c.value),name}];}
+    for(const [index,rows]of Object.entries(plan.detailBrowserNames??{}))for(const [row,names]of Object.entries(rows))for(const [id,name]of Object.entries(names)){const c=linked.tables['detail_'+(Number(index)+1)]?.rows[row]?.['field'+id],values=plan.details?.find(d=>String(d.index)===index)?.rows[row]??{};if(c&&name&&(Object.hasOwn(values,id)||Object.hasOwn(values,'field'+id)))c.specialobj=[{id:String(c.value),name}];}
+    const prepared=buildDraft({...plan,serverResolved:true,values:{},details:[],browserNames:{},detailBrowserNames:{}},linked.form,linked.tables);
+    // buildDraft receives only server/proven state; user permissions were checked before execution.
+    prepared.expected.coverage=linked.evidence;
+    prepared.expected.adapterDigest=adapter?.scriptDigest??null;
+    prepared.expected.originalFingerprint=fingerprint(form);
+    prepared.expected.personnel=personnel;
+    return {...prepared,evidence:linked.evidence,baseline:baseline(form,tables)};
+}
+export async function checkAdapter(cfg,plan,form) {
+    const adapter=await loadAdapter(cfg,plan.workflowId,form);
+    if((adapter?.scriptDigest??null)!==plan.prepared.expected.adapterDigest)throw Error('适配逻辑变化，请重新预览');
+}
+export function baseline(form,tables) {
+    const values=cells=>Object.fromEntries(Object.entries(cells??{}).filter(([k])=>/^field\d+$/.test(k)).map(([k,c])=>[k,{value:c?.value??'',specialobj:Array.isArray(c?.specialobj)?c.specialobj.map(x=>({id:x.id,name:x.name})):undefined}]));
+    return {main:values(form.maindata),details:Object.fromEntries(Object.entries(tables).map(([mark,t])=>[mark,t.rows.map(row=>({keyid:row.keyid,fields:values(row)}))]))};
+}
+export function checkBaseline(prepared,form,tables) {
+    if(!equal(prepared.baseline,baseline(form,tables)))throw Error('服务器默认值或原稿内容变化，请重新预览；不会静默重算');
+}
+export function classifyWrite(response,requestId) {
+    const data=response.json?.data??response.json??{},type=data.type;
+    return {responseType:type,requestId:data.resultInfo?.requestid??data.requestid??requestId,
+        state:type==='FAILD'||type==='FAILED'||data.status===false?'failed':type==='SUCCESS'?'written-unverified':'uncertain',messageInfo:data.messageInfo??response.json?.msg};
+}
+export function actionBody(prepared,form,action='save') {
+    if(!['save','submit'].includes(action)||prepared.expected?.coverage?.state!=='complete')throw Error('字段准备/联动覆盖未完成');
+    if(fingerprint(form)!==prepared.expected.originalFingerprint)throw Error('表单配置变化，请重新预览');
+    const business=Object.fromEntries(Object.entries(prepared.body).filter(([k])=>/^field|^nodesnum|^indexnum|^submitdtlid|^dtl_id_|^deldtlid|FieldUnEmptyCount$/.test(k)||['existChangeRange','requestname','requestid','iscreate'].includes(k)));
+    const body={...prepared.body,...form.submitParams,...business,signatureAttributesStr:String(form.params.signatureAttributesStr??''),signatureSecretKey:String(form.params.signatureSecretKey??''),src:action,isaffirmance:'0',isaffirmanceSrc:''};
+    if(String(form.params.currentUserid)!==prepared.expected.accountId)throw Error('执行账号已变化');
+    return body;
+}
+export function verifyAction(expected,form,tables,action='save') {
+    if(expected.coverage?.state!=='complete')return ['联动覆盖未完成'];
+    return verifyDraft(expected,form,tables,{action});
+}

package/dist/fileutil.js

@@ -0,0 +1,20 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/** 下载文件不覆盖用户已有文件；重名时追加 (1)、(2)… */
+export function nextAvailablePath(outDir, filename) {
+    const parsed = path.parse(filename);
+    let candidate = path.join(outDir, filename);
+    for (let index = 1; fs.existsSync(candidate); index++)
+        candidate = path.join(outDir, `${parsed.name} (${index})${parsed.ext}`);
+    return candidate;
+}
+
+/** 接受 OOXML zip 或传统 OLE Excel；拒绝 HTML 登录页、JSON 错误和空响应。 */
+export function assertExcelLike(buf, label = 'Excel 文件') {
+    const isZip = Buffer.isBuffer(buf) && buf.length >= 64 && buf.readUInt32LE(0) === 0x04034b50;
+    const isOle = Buffer.isBuffer(buf) && buf.length >= 512 && buf.subarray(0, 8).equals(Buffer.from('D0CF11E0A1B11AE1', 'hex'));
+    if (!isZip && !isOle)
+        throw new Error(`${label}响应不是有效的 xls/xlsx，可能是登录页或错误页。`);
+    return { format: isZip ? 'xlsx' : 'xls', size: buf.length };
+}

package/dist/formula-runtime.js

@@ -0,0 +1,55 @@
+// 有限表达式语法；不执行表单JavaScript。日期/工作日查询沿用平台的只读接口。
+export function parseFormula(text) {
+    const tokens=text.match(/\[(?:main|detail_\d+)\.-?\d+\]|'(?:[^'\\]|\\.)*'|"(?:[^"\\]|\\.)*"|\d+(?:\.\d+)?|[A-Za-z]+|==|!=|>=|<=|&&|\|\||[+*/%(),<>!\-]|\s+/g)??[];
+    if(tokens.join('')!==text)throw Error('不支持的公式语法：'+text);
+    const ts=tokens.filter(t=>!/^\s+$/.test(t));let i=0;
+    const precedence={'||':1,'&&':2,'==':3,'!=':3,'>':4,'<':4,'>=':4,'<=':4,'+':5,'-':5,'*':6,'/':6,'%':6};
+    const primary=()=>{
+        const t=ts[i++];
+        if(t==='('){const n=expr(1);if(ts[i++]!==')')throw Error('公式括号不匹配');return n;}
+        if(['-','+','!'].includes(t))return {unary:t,arg:primary()};
+        if(t?.startsWith('['))return {ref:t.slice(1,-1)};
+        if(/^['"]/.test(t??''))return {value:t.slice(1,-1).replace(/\\(['"\\])/g,'$1')};
+        if(/^\d/.test(t??''))return {value:Number(t)};
+        if(['IF','CurrDate','GetDateValue','CompareWorkDate'].includes(t)&&ts[i++]==='('){const args=[];if(ts[i]!==')'){do {args.push(expr(1));}while(ts[i]===','&&++i);}if(ts[i++]!==')')throw Error('函数参数语法错误');return {call:t,args};}
+        throw Error('不支持的公式函数或符号：'+t);
+    };
+    const expr=min=>{let left=primary();while((precedence[ts[i]]??0)>=min){const op=ts[i++],right=expr(precedence[op]+1);left={op,left,right};}return left;};
+    const tree=expr(1);if(i!==ts.length)throw Error('公式存在未处理内容');return tree;
+}
+export async function evaluateFormula(tree,read,functions={}) {
+    const run=async n=>{
+        if('value'in n)return n.value;
+        if(n.ref)return read(n.ref);
+        if(n.unary){const a=await run(n.arg);return n.unary==='!'?!a:n.unary==='-'?-Number(a):Number(a);}
+        if(n.call){
+            if(n.call==='IF'){if(n.args.length!==3)throw Error('IF需要三个参数');return await run(n.args[0])?run(n.args[1]):run(n.args[2]);}
+            if(!functions[n.call])throw Error('未提供日期函数：'+n.call);
+            return functions[n.call](...await Promise.all(n.args.map(run)));
+        }
+        const a=await run(n.left);
+        if(n.op==='&&')return a?run(n.right):a;
+        if(n.op==='||')return a?a:run(n.right);
+        const b=await run(n.right);let result;
+        switch(n.op){
+            case '==':return String(a)===String(b);case '!=':return String(a)!==String(b);
+            case '>':return Number(a)>Number(b);case '<':return Number(a)<Number(b);case '>=':return Number(a)>=Number(b);case '<=':return Number(a)<=Number(b);
+            case '+':result=Number(a)+Number(b);break;case '-':result=Number(a)-Number(b);break;case '*':result=Number(a)*Number(b);break;case '/':result=Number(a)/Number(b);break;case '%':result=Number(a)%Number(b);break;
+        }
+        if(!Number.isFinite(result))throw Error('公式计算无效或除零');return result;
+    };
+    return run(tree);
+}
+export function formulaDateFunctions(api) {
+    const cache=new Map();
+    const once=async(key,fetcher)=>{if(!cache.has(key))cache.set(key,fetcher());return cache.get(key);};
+    const dateParts=(value,part)=>{const m=String(value).match(/^(\d{4})-(\d{2})-(\d{2})$/);if(!m)throw Error('不支持的日期值：'+value);const parts={Y:Number(m[1]),M:Number(m[2]),D:Number(m[3])};if(!(part in parts))throw Error('未支持的日期分量：'+part);return parts[part];};
+    return {
+        GetDateValue:dateParts,
+        CurrDate:async()=>once('today',async()=>{const r=await api.post('/api/workflow/formula/getCurrentDateTime',{type:'CurrDateTime'},{forceCookie:true});const ms=Number(r.json?.time);if(!Number.isFinite(ms)||ms<=0)throw Error('服务器日期查询失败');const d=new Date(ms);return `${d.getFullYear()}-${String(d.getMonth()+1).padStart(2,'0')}-${String(d.getDate()).padStart(2,'0')}`;}),
+        CompareWorkDate:async(beginDate,endDate,userid)=>{
+            dateParts(beginDate,'Y');dateParts(endDate,'Y');if(!/^\d+$/.test(String(userid)))throw Error('工作日计算缺少人员ID');
+            return once(JSON.stringify([beginDate,endDate,userid]),async()=>{const r=await api.post('/api/workflow/formula/compareWorkDate',{beginDate,endDate,userid:String(userid)},{forceCookie:true});const value=r.json?.workDays;if(value==null||value===''||!Number.isFinite(Number(value)))throw Error('平台工作日查询失败');return Number(value);});
+        }
+    };
+}