bdip-office-assistant-cli 1.0.0 → 1.0.1

package/dist/field-preparation.js

@@ -1,5 +1,7 @@
-import {definitions,detailTables,fingerprint,loadAdapter,buildDraft,verifyDraft} from './workflow-runtime.js';
+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??''};
@@ -37,17 +39,20 @@ export async function executeLinkages(api,form,tables,input,{maxSteps=100,covere
     const f=clone(form),t=clone(tables),defs=definitions(f),cfg=f.linkageCfg??{};
     const evidence={state:'preparing',coverage:[],rowChanges:[]};
     // 未支持的配置必须明确由已验证适配承担，不能吞错继续。
-    for(const [kind,data]of Object.entries(cfg))if(!['formulaCfg','dataInputCfg','fieldSqlCfg'].includes(kind)&&JSON.stringify(data)!=='{}'&&JSON.stringify(data)!=='[]'&&!covered.includes(kind))fail('unsupported','联动配置尚未支持：'+kind);
+    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),key=`${table}.${id}:${row}`;
-        if(protectedValues.has(key)&&String(next.value)!==String(protectedValues.get(key)))fail('conflict','用户值与联动冲突：'+id);
+        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);
@@ -59,16 +64,35 @@ export async function executeLinkages(api,form,tables,input,{maxSteps=100,covere
         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??[];
+    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 value=formulaValue(expression,read);
+                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};
                 // 双向互拷贝以非空输入为起点；未设置一端不能清掉另一端。
@@ -102,7 +126,7 @@ export async function executeLinkages(api,form,tables,input,{maxSteps=100,covere
             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(values);if(seen.get(key)===signature)continue;
+                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??'',
@@ -111,7 +135,7 @@ export async function executeLinkages(api,form,tables,input,{maxSteps=100,covere
                 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)fail('unsupported','缺少自定义浏览框同行依赖');depend[dep.key]=c['field'+dep.fieldid]?.value??'';}body['customDepend_field'+assigned+(assignedDef.table==='main'?'':'_'+row)]=JSON.stringify(depend);}
+                    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);
@@ -136,10 +160,33 @@ export async function executeLinkages(api,form,tables,input,{maxSteps=100,covere
                 evidence.coverage.push({kind:'dataInput',config:String(rule.config),row,state:'executed'});
             }
         }
-        if(!changed){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);}evidence.state='complete';return {form:f,tables:t,evidence};}
+        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;}
@@ -147,12 +194,17 @@ export async function prepareFields(cfg,plan,{api,form,tables}={}) {
     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) {

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);});
+        }
+    };
+}

package/dist/linkage-calculations.js

@@ -0,0 +1,68 @@
+import {parseFormula,evaluateFormula} from './formula-runtime.js';
+
+export async function executeCalculations({api,form,tables,input,defs,getCells,write,seen,evidence,step}) {
+    const cfg=form.linkageCfg??{};let changed=false;
+    const read=(ref,row)=>{const [table,id]=ref.split('.');const v=getCells(table,table==='main'?-1:row)?.['field'+id]?.value??'';return v;};
+    for(const [trigger,rules]of Object.entries(cfg.rowCalCfg??{})) {
+        if(trigger==='rowCalAssignInfo')continue;
+        if(!Array.isArray(rules))throw Error('行规则格式未知');
+        for(const rule of rules){const d=defs.find(x=>x.id===String(rule.assignField));if(!d||d.table==='main')throw Error('行规则目标不是明细字段');
+            const expression=String(rule.config).replace(/detailfield_(\d+)/g,(_,id)=>`[${d.table}.${id}]`),tree=parseFormula(expression);
+            for(let row=0;row<(tables[d.table]?.rows.length??0);row++){
+                const value=await evaluateFormula(tree,ref=>read(ref,row));
+                changed=write(d.table,row,d.id,{value},'rowCal')||changed;
+                evidence.coverage.push({kind:'rowCal',config:d.id,row,state:'executed'});
+            }
+        }
+    }
+    for(const id of new Set([...Object.keys(cfg.mainCalCfg??{}),...Object.keys(cfg.colCalCfg??{})])) {
+        const d=defs.find(x=>x.id===id);if(!d||d.table==='main'||!tables[d.table])throw Error('列合计字段未知');
+        const rows=tables[d.table].rows;
+        const sum=rows.reduce((total,row)=>{const n=Number(row['field'+id]?.value??0);if(!Number.isFinite(n))throw Error('列合计包含非数字');return total+n;},0);
+        if(cfg.colCalCfg?.[id]){if(cfg.colCalCfg[id]!=='needsum')throw Error('未知列合计规则');(evidence.columnSums??={})[id]=sum;evidence.coverage.push({kind:'colCal',config:id,state:'executed'});}
+        const target=cfg.mainCalCfg?.[id];
+        if(target){const dest=defs.find(x=>x.id===String(target));if(!dest||dest.table!=='main')throw Error('明细合计赋值主表目标未知');
+            const value=!rows.length&&String(form.propFileCfg?.colRule_noRow_empty)!=='1'?'':sum;
+            changed=write('main',-1,dest.id,{value},'mainCal')||changed;evidence.coverage.push({kind:'mainCal',config:id,target:String(target),state:'executed'});
+        }
+    }
+    for(const [trigger,rules]of Object.entries(cfg.fieldDateCfg??{}))for(const rule of rules){
+        const d=defs.find(x=>x.id===String(rule.assignField));
+        if(!d&&/^\d+$/.test(String(rule.assignField))&&form.cellInfo?.fieldCellInfo&&!Object.hasOwn(form.cellInfo.fieldCellInfo,String(rule.assignField))){evidence.coverage.push({kind:'fieldDate',config:String(rule.config),target:String(rule.assignField),state:'not-in-layout'});continue;}
+        if(!d)throw Error('日期规则目标未知');
+        for(const row of d.table==='main'?[-1]:(tables[d.table]?.rows??[]).map((_,i)=>i)){
+            const values={};for(const id of rule.relateFields??[]){const dep=defs.find(x=>x.id===String(id));if(!dep)throw Error('日期依赖不存在');values['field'+id+(dep.table==='main'?'':'_'+row)]=getCells(dep.table,dep.table==='main'?-1:row)?.['field'+id]?.value??'';}
+            const key='date:'+rule.config+':'+row,signature=JSON.stringify(values);if(seen.get(key)===signature)continue;seen.set(key,signature);step();
+            const p=form.params;
+            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:'0',linkageid:String(rule.config),linkageUUID:form.submitParams?.linkageUUID??'',
+                ['triFieldid_'+rule.config]:trigger,['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')};
+            const r=await api.post('/api/workflow/linkage/reqDateTimeResult',body,{forceCookie:true}),info=r.json?.['assignInfo_'+rule.config];
+            if(!info||info.error||info.resultOutOfLimit||r.json?.status===false)throw Error('日期联动失败：'+rule.config);
+            for(const k of Object.keys(info))if(!['changeValue','resultOutOfLimit','linkageSql'].includes(k))throw Error('日期联动响应尚未支持：'+k);
+            for(const [key,value]of Object.entries(info.changeValue??{})){
+                const m=key.match(/^field(\d+)(?:_(\d+))?$/),dest=m&&defs.find(x=>x.id===m[1]);if(!dest)throw Error('日期联动返回未知字段');
+                changed=write(dest.table,m[2]?Number(m[2]):dest.table==='main'?-1:row,dest.id,value,'date')||changed;
+            }
+            evidence.coverage.push({kind:'fieldDate',config:String(rule.config),row,state:'executed'});
+        }
+    }
+    evidence.viewAttributes={};
+    for(const [ref,rules]of Object.entries(cfg.viewAttrCfg??{})){
+        const id=ref.split('_')[0],d=defs.find(x=>x.id===id);if(!d||!Array.isArray(rules.relateFields))throw Error('属性联动配置未知');
+        for(const row of d.table==='main'?[-1]:(tables[d.table]?.rows??[]).map((_,i)=>i)){
+            const value=String(read(d.table+'.'+id,row)),assign={};
+            for(const [condition,targets]of Object.entries(rules))if(condition!=='relateFields'){
+                const [op,expected]=condition.split('|');if(expected===undefined||!['0','1','2','3','4','5'].includes(op))throw Error('属性联动条件未知');
+                const match=op==='0'?expected.split(',').includes(value):op==='1'?!expected.split(',').includes(value):op==='2'?(','+value+',').includes(','+expected+','):op==='3'?!(','+value+',').includes(','+expected+','):op==='4'?value==='1':value!=='1';
+                if(match)Object.assign(assign,targets);
+            }
+            for(const target of rules.relateFields){
+                const tid=target.split('_')[0],dest=defs.find(x=>x.id===tid);if(!dest)throw Error('属性联动目标未知');
+                const code=assign[target],attr=code===undefined?Number(dest.viewattr):({'1':2,'2':3,'3':1,'4':Number(dest.viewattr),'5':4})[String(code)];
+                if(attr===undefined)throw Error('属性联动属性未知');evidence.viewAttributes[dest.table+':'+(dest.table==='main'?-1:row)+':'+tid]=attr;
+            }
+            evidence.coverage.push({kind:'viewAttr',config:ref,row,state:'executed'});
+        }
+    }
+    return changed;
+}

package/dist/meetings.js

@@ -0,0 +1,172 @@
+import fs from 'node:fs';
+
+const clone = v => JSON.parse(JSON.stringify(v));
+const same = (a,b) => JSON.stringify(a) === JSON.stringify(b);
+const text = v => v == null ? '' : String(v);
+const minute = v => text(v).slice(0,16);
+const rowKeys = ['coding','subject','hrmid01','hrmid02','begindate','enddate'];
+const links = ['decisiontskids','decisiondoc','decisionprjids','decisionwfids','decisioncrmids','decisionatchids'];
+async function call(api, route, body={}) {
+  const r=await api.post(route.startsWith('/api/')?route:'/api/meeting/'+route,body,{forceCookie:true});
+  const j=r?.json;
+  if(r.status!==200 || !j || j.status===false || j.api_status===false || j.retstatus===false || j.ret==='false') throw Error('会议接口失败：'+route);
+  return j;
+}
+function walk(v, fn) {
+  if(!v || typeof v!=='object')return;
+  if(Array.isArray(v)){v.forEach(x=>walk(x,fn));return;}
+  fn(v); Object.values(v).forEach(x=>{if(x&&typeof x==='object')walk(x,fn);});
+}
+export async function fields(api) {
+  const meta=await call(api,'field/getMeetingBaseFieldMobx');
+  if(String(meta.onlyFlowCreate)==='1' || String(meta.hideCreateEntry)==='1')throw Error('平台限制直接新建会议，请按平台指定入口办理');
+  const defaults={},schema={};
+  walk(meta.datas,f=>{if(!Array.isArray(f.domkey))return;f.domkey.forEach((k,i)=>{
+    const value=Array.isArray(f.value)?f.value[i]:f.value;
+    schema[k]={viewAttr:f.viewAttr};
+    if(value!=null && typeof value!=='object')defaults[k]=text(value);
+  });});
+  if(!schema.name)throw Error('未取得会议表单结构');
+  return {meta,defaults,schema};
+}
+export async function view(api,id) {
+  if(!/^\d+$/.test(text(id)))throw Error('需提供合法会议ID');
+  const body={meetingid:text(id)};
+  const base=await call(api,'base/getMeetingBaseInfo',body);
+  if(!base.data)throw Error('会议不存在或无查看权限');
+  const display=await call(api,'field/getViewMeetingField',body);
+  const decision=await call(api,'decision/getDecisionData',body);
+  if(!Array.isArray(decision.datas))throw Error('决议数据不完整');
+  const key=display.decision?.list?.sessionkey,tasks=[];
+  if(key){
+    const seen=new Set();
+    for(let page=1;;page++){
+      const j=await call(api,'/api/ec/dev/table/datas',{dataKey:key,current:text(page),pageSize:'50'});
+      if(!Array.isArray(j.datas))throw Error('任务分页数据异常');
+      if(!j.datas.length)break;
+      const signature=JSON.stringify(j.datas);
+      if(seen.has(signature)||page>10000)throw Error('任务分页未完成，不能报告完整数量');
+      seen.add(signature);tasks.push(...j.datas);
+    }
+  }else if(decision.datas.length)throw Error('未取得会议任务查询入口');
+  return {meetingid:text(id),base:base.data,display,decision,tasks,taskCount:tasks.length};
+}
+function snapshot(v) {
+  return {base:Object.fromEntries(['meetingname','begindate','enddate','begintime','endtime','isdecision'].map(k=>[k,v.base[k]])),decision:{decision:v.decision.decision,datas:v.decision.datas.map(r=>Object.fromEntries(rowKeys.map(k=>[k,text(r[k])]))),...Object.fromEntries(links.map(k=>[k,v.decision[k]??[]]))}};
+}
+function validateRows(rows) {
+  if(!Array.isArray(rows))throw Error('tasks必须是完整任务数组');
+  for(const r of rows){
+    for(const k of rowKeys)if(!text(r[k]).trim())throw Error('决议任务缺少'+k+'；执行人、检查人未指定时先询问用户');
+    for(const k of ['hrmid01','hrmid02'])if(!/^\d+$/.test(text(r[k])))throw Error('执行人、检查人必须为已核实的账号ID');
+    for(const k of ['begindate','enddate'])if(!/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/.test(r[k]))throw Error('任务时间格式为YYYY-MM-DD HH:mm');
+    if(r.begindate>r.enddate)throw Error('任务开始时间晚于截止时间');
+  }
+}
+function decisionBody(id,d) {
+  const body={meetingid:text(id),decision:d.decision,decisionrows:text(d.datas.length)};
+  for(const k of links){
+    const values=d[k]??[];
+    if(!Array.isArray(values))throw Error('关联数据格式不支持：'+k);
+    body[k]=values.map(x=>{if(typeof x!=='object')return text(x);if(x?.id!=null)return text(x.id);throw Error('无法保留关联项：'+k);}).join(',');
+  }
+  d.datas.forEach((r,i)=>rowKeys.forEach(k=>{body[k+'_'+(i+1)]=text(r[k]);}));
+  return body;
+}
+async function conflicts(api,body) {
+  const custom=await call(api,'base/customMeetingChk',body);
+  const check=await call(api,'base/chkMeeting',body);
+  if(custom.chkstatus!==true || check.attribute?.cansub!==true || ['address','member','wpMember','service'].some(k=>check[k]?.chkstatus!==true))throw Error('会议冲突检查未通过，请核实时间、人员、会议室及服务');
+}
+function verifyCreate(v,body) {
+  for(const k of ['begindate','enddate','begintime','endtime'])if(text(v.base[k])!==body[k])throw Error('会议时间回读不一致：'+k);
+  if(v.base.meetingname!==body.name)throw Error('会议名称回读不一致');
+  const display={};walk(v.display.base,f=>{if(f.fieldname)display[f.fieldname]=f.fieldValue;});
+  for(const k of Object.keys(body)){
+    if(['name','begindate','enddate','begintime','endtime','method','isInterval','serviceitems','totalmember'].includes(k))continue;
+    if(k==='hrmmembers'){
+      if(!Array.isArray(display[k]) || !same(display[k].map(p=>text(p.id)).sort(),body[k].split(',').filter(Boolean).sort()))throw Error('参会人回读不一致');
+    }else if(k in display && typeof display[k]!=='object' && text(display[k])!==text(body[k]))throw Error('会议字段回读不一致：'+k);
+  }
+  if(text(v.base.address||'')!==text(body.address||''))throw Error('会议室回读不一致');
+  for(const k of ['desc_n','customizeAddress'])if(body[k] && text(display[k])!==body[k])throw Error('会议字段未完整回读：'+k);
+}
+function verifyDecision(v,plan) {
+  const expected=plan.expected;
+  if(text(v.base.isdecision)!==(plan.action==='decision-submit'?'2':'1') || v.decision.decision!==expected.decision)throw Error('决议正文或状态回读不一致');
+  if(v.decision.datas.length!==expected.datas.length || v.tasks.length!==expected.datas.length)throw Error('决议任务数量回读不一致');
+  expected.datas.forEach((r,i)=>{
+    for(const k of rowKeys)if(text(v.decision.datas[i][k])!==text(r[k]))throw Error('决议任务回读不一致：'+k);
+    const t=v.tasks[i];
+    for(const k of ['coding','subject','hrmid01','hrmid02'])if(text(t[k])!==text(r[k]))throw Error('会议任务回读不一致：'+k);
+    if(minute(t.begint??t.begindatespan)!==r.begindate || minute(t.endt??t.enddatespan)!==r.enddate)throw Error('会议任务时间回读不一致');
+    if(plan.action==='decision-submit' && (!t.id || text(t.meetingid)!==plan.meetingid))throw Error('已提交任务缺少会议关联');
+  });
+  for(const k of links)if(!same(v.decision[k]??[],expected[k]??[]))throw Error('决议关联项回读不一致：'+k);
+}
+export async function meetingMain(api,args,accountId,baseUrl) {
+  const [command,...rest]=args;
+  if(command==='fields')return fields(api);
+  if(command==='view'||command==='tasks'){const v=await view(api,rest[0]);return command==='tasks'?{meetingid:v.meetingid,count:v.taskCount,items:v.tasks}:v;}
+  if(command==='preview'){
+    const [action,inputFile,planFile]=rest;
+    if(!['create','decision-save','decision-submit'].includes(action)||!inputFile||!planFile)throw Error('用法：meeting preview <create|decision-save|decision-submit> <输入JSON> <新计划JSON>');
+    const input=JSON.parse(fs.readFileSync(inputFile,'utf8'));
+    const plan={action,accountId,baseUrl};
+    if(action==='create'){
+      const f=await fields(api);const values=input.values;
+      if(!values||typeof values!=='object'||Array.isArray(values))throw Error('缺少values');
+      for(const k of Object.keys(values)){
+        if(!['name','begindate','begintime','enddate','endtime','address','customizeAddress','hrmmembers','desc_n'].includes(k))throw Error('当前已验证的新建输入不支持：'+k+'；其他字段保留平台默认值');
+        if(!f.schema[k] || typeof values[k]==='object')throw Error('不支持的会议字段：'+k);
+        if(String(f.schema[k].viewAttr)==='1' && text(values[k])!==text(f.defaults[k]))throw Error('只读会议字段不能覆盖：'+k);
+      }
+      const body={...f.defaults,...Object.fromEntries(Object.entries(values).map(([k,v])=>[k,text(v)])),method:'',isInterval:'',serviceitems:''};
+      for(const [k,s] of Object.entries(f.schema))if(String(s.viewAttr)==='3'&&!body[k])throw Error('会议必填字段缺少：'+k);
+      if(!/^\d+(,\d+)*$/.test(body.hrmmembers??''))throw Error('需核实参会人ID');
+      body.totalmember=text(new Set(body.hrmmembers.split(',')).size);
+      if(!body.address&&!body.customizeAddress && input.noRoom!==true)throw Error('未选择地点，请明确noRoom:true表示不预约会议室');
+      if(!/^\d{4}-\d{2}-\d{2}$/.test(body.begindate)||!/^\d{4}-\d{2}-\d{2}$/.test(body.enddate)||!/^\d{2}:\d{2}$/.test(body.begintime)||!/^\d{2}:\d{2}$/.test(body.endtime)||body.begindate+' '+body.begintime>body.enddate+' '+body.endtime)throw Error('会议日期时间不合法');
+      await conflicts(api,body);Object.assign(plan,{body,schema:f.schema});
+    }else{
+      const v=await view(api,input.meetingid);
+      if(text(v.base.isdecision)==='2')throw Error('决议已经提交，停止重复保存或提交');
+      const d=clone(v.decision);
+      if(Object.keys(input).some(k=>!['meetingid','decision','tasks'].includes(k)))throw Error('决议输入仅支持meetingid、decision、tasks');
+      if(input.decision!==undefined){if(typeof input.decision!=='string')throw Error('决议正文需为字符串');d.decision=input.decision;}
+      if(input.tasks!==undefined)d.datas=input.tasks;
+      validateRows(d.datas);
+      if(action==='decision-submit' && (text(v.base.isdecision)!=='1'||!same(d,v.decision)))throw Error('正式提交前必须保存并回读，重新按已保存内容预览');
+      Object.assign(plan,{meetingid:v.meetingid,baseline:snapshot(v),expected:d,body:decisionBody(v.meetingid,d)});
+    }
+    fs.writeFileSync(planFile,JSON.stringify(plan,null,2),{flag:'wx'});
+    return {state:'preview-only',...plan};
+  }
+  if(command!=='run'&&command!=='verify')throw Error('会议命令：fields | view <ID> | tasks <ID> | preview <动作> <输入JSON> <新计划JSON> | run <计划JSON> --confirm | verify <计划JSON>');
+  const planFile=rest[0],receiptFile=planFile+'.receipt.json';
+  const plan=JSON.parse(fs.readFileSync(planFile,'utf8'));
+  if(plan.accountId!==accountId||plan.baseUrl!==baseUrl)throw Error('会议计划环境或账号已变化，请重新预览');
+  if(!['create','decision-save','decision-submit'].includes(plan.action))throw Error('未知会议动作');
+  let receipt=fs.existsSync(receiptFile)?JSON.parse(fs.readFileSync(receiptFile,'utf8')):null;
+  if(command==='run'){
+    if(!rest.includes('--confirm'))throw Error('请先展示预览，取得用户确认后使用--confirm');
+    if(receipt)throw Error('已有执行回执，禁止重复写入，请verify核验');
+    if(plan.action==='create'){
+      const f=await fields(api);if(!same(f.schema,plan.schema))throw Error('会议表单结构变化，请重新预览');
+      await conflicts(api,plan.body);
+    }else if(!same(snapshot(await view(api,plan.meetingid)),plan.baseline))throw Error('决议已变化，请重新预览');
+    receipt={state:'uncertain',action:plan.action,meetingid:plan.meetingid};
+    fs.writeFileSync(receiptFile,JSON.stringify(receipt,null,2),{flag:'wx'});
+    const result=await call(api,plan.action==='create'?'base/newMeeting':plan.action==='decision-save'?'decision/edit':'decision/submit',plan.body);
+    if(plan.action==='create')receipt.meetingid=text(result.meetingid);
+    fs.writeFileSync(receiptFile,JSON.stringify(receipt,null,2));
+    if(plan.action==='create'?![true,'true'].includes(result.retstatus):result.status!==true)throw Error('写入未确认，请核验，禁止自动重试');
+  }
+  if(!receipt?.meetingid)throw Error('缺少会议ID，结果不明，请人工核查，不自动重建');
+  receipt.state='verification-required';
+  fs.writeFileSync(receiptFile,JSON.stringify(receipt,null,2));
+  const v=await view(api,receipt.meetingid);
+  if(plan.action==='create')verifyCreate(v,plan.body);else verifyDecision(v,plan);
+  receipt.state='verified';receipt.taskCount=v.taskCount;receipt.isdecision=v.base.isdecision;
+  fs.writeFileSync(receiptFile,JSON.stringify(receipt,null,2));return receipt;
+}

package/dist/office-tools.js

@@ -8,6 +8,7 @@ export async function accounts(api) {
   const rows = r.json?.data?.accountlist;
   if (!Array.isArray(rows) || !rows.length) throw Error('未取得关联账号，请检查登录状态');
   const items = rows.map(a => ({id: String(a.userid), name: a.username,
+    divisionId: a.subcompanyid == null ? null : String(a.subcompanyid),
     division: a.subcompanyname || '所属分部未返回（请核实）', department: a.deptname || '',
     current: String(a.iscurrent) === '1'}));
   if (items.filter(a => a.current).length !== 1) throw Error('未能确认当前账号');
@@ -26,9 +27,13 @@ export async function shift(api, id) {
 }
 
 export async function main(argv = process.argv.slice(2)) {
-  const [command, ...args] = argv;
+  const [command, ...rawArgs] = argv;
+  const scopeIndex = rawArgs.indexOf('--person-scopes');
+  if (scopeIndex >= 0 && !rawArgs[scopeIndex + 1]) throw Error('--person-scopes 需要 JSON 文件路径');
+  const args = scopeIndex < 0 ? rawArgs : rawArgs.filter((_, i) => i !== scopeIndex && i !== scopeIndex + 1);
+  const personScopes = scopeIndex < 0 ? undefined : JSON.parse(fs.readFileSync(rawArgs[scopeIndex + 1], 'utf8'));
   if (!command || command === 'help') {
-    console.log('accounts | after-login | switch <账号ID> | default-set <账号ID> | default-clear | draft-preview <流程ID> <值文件> <标题> <计划文件> [明细文件] | draft-save <计划文件> | draft-verify <计划文件> | draft-submit <计划文件> --confirm | draft-update-preview <流程ID> <值文件> <标题> <新计划文件> <明细文件或-> <原requestId> | browser-options <流程ID> <字段ID> [上下文文件] | adapter-register <流程ID> <脚本文件> <映射文件>');
+    console.log('meeting fields|view|tasks|preview|run|verify | doc directories|list|init|upload | accounts | after-login | switch <账号ID> | default-set <账号ID> | default-clear | draft-preview <流程ID> <值文件> <标题> <计划文件> [明细文件] [--person-scopes <JSON文件>] | draft-save <计划文件> | draft-verify <计划文件> | draft-submit <计划文件> --confirm | draft-update-preview <流程ID> <值文件> <标题> <新计划文件> <明细文件或-> <原requestId> | browser-options <流程ID> <字段ID> [上下文文件] | adapter-register <流程ID> <脚本文件> <映射文件>');
     return;
   }
   const dist = path.dirname(fileURLToPath(import.meta.url));
@@ -59,6 +64,16 @@ export async function main(argv = process.argv.slice(2)) {
       prompt: prefs[scope] ? '已核验默认项目；是否需要切换其他项目？可以更改或取消默认项目。' : '是否切换项目（次账号）？可以设置默认项目，以后登录自动切换。'}, null, 2));
     return;
   }
+  if (command === 'meeting') {
+    const {meetingMain} = await load('meetings');
+    console.log(JSON.stringify(await meetingMain(api, args, accountId, cfg.baseUrl), null, 2));
+    return;
+  }
+  if (command === 'doc') {
+    const {documentMain} = await load('documents');
+    console.log(JSON.stringify(await documentMain(api, args, accountId, cfg), null, 2));
+    return;
+  }
   const runtime = await load('workflow-runtime');
   const preparation = await load('field-preparation');
   const getForm = async (workflowId, requestId) => {
@@ -69,6 +84,7 @@ export async function main(argv = process.argv.slice(2)) {
   if (command === 'browser-options') {
     const [workflowId,fieldId,contextFile]=args;
     const context=contextFile?JSON.parse(fs.readFileSync(contextFile,'utf8')):{};
+    context.baseUrl = cfg.baseUrl;
     const form=await getForm(workflowId,context.requestId);
     const adapter=await runtime.loadAdapter(cfg,workflowId,form);
     if(adapter?.browserContext) Object.assign(context,await adapter.browserContext({form,fieldId,context,mapping:adapter.mapping}));
@@ -85,6 +101,7 @@ export async function main(argv = process.argv.slice(2)) {
     if(command==='draft-update-preview' && !requestId)throw Error('更新原稿必须提供requestId');
     const form=await getForm(workflowId,requestId);
     const plan={workflowId,requestName:title,values:JSON.parse(fs.readFileSync(valuesFile,'utf8')),details:detailsFile&&detailsFile!=='-'?JSON.parse(fs.readFileSync(detailsFile,'utf8')):[],baseUrl:cfg.baseUrl,accountId,requestId};
+    if (personScopes) plan.personScopes = personScopes;
     if(plan.values.values) { const input=plan.values; plan.values=input.values;plan.browserNames=input.browserNames??{};plan.detailBrowserNames=input.detailBrowserNames??{}; }
     const prepared=await preparation.prepareFields(cfg,plan,{api,form});
     plan.expected=prepared.expected;

package/dist/person-selection.js

@@ -0,0 +1,81 @@
+import {buildHrmCardUrl} from './hrm.js';
+
+const clean = v => String(v ?? '').replace(/<[^>]*>/g,'').trim();
+export async function currentPersonAccount(api) {
+    const r=await api.get('/api/hrm/login/getAccountList',{__random__:Date.now()},{forceCookie:true});
+    const rows=r.json?.data?.accountlist;
+    const current=Array.isArray(rows)?rows.filter(a=>String(a.iscurrent)==='1'):[];
+    if(current.length!==1 || !/^\d+$/.test(String(current[0].userid??'')) || !/^\d+$/.test(String(current[0].subcompanyid??'')))throw Error('无法核实当前账号及所属分部，停止选人');
+    const a=current[0];
+    return {id:String(a.userid),divisionId:String(a.subcompanyid),division:a.subcompanyname,name:a.username};
+}
+const conditionKey=c=>Array.isArray(c?.domkey)?c.domkey[0]:c?.domkey;
+export function personSearchQuery(query,conditions,account,context={}) {
+    const q={...query};
+    const names=conditions.filter(c=>c.isQuickSearch&&c.conditionType==='INPUT');
+    const name=names.length===1?names[0]:null;
+    const division=conditions.find(c=>conditionKey(c)==='subcompanyid');
+    if(!name||!division)throw Error('未识别人员姓名/分部查询条件，需核实当前协议');
+    for(const c of conditions) {
+        const key=conditionKey(c);
+        const value=c.value??c.options?.filter(o=>o.selected).map(o=>o.key).join(',');
+        if(key&&value!==undefined&&value!==''&&q[key]===undefined)q[key]=value;
+    }
+    if(context.subcompanyId && String(context.subcompanyId)!==account.divisionId && context.crossDivision!==true)throw Error('跨分部查询需要用户明确指定范围');
+    const target=String(context.subcompanyId??account.divisionId);
+    if(!/^\d+$/.test(target))throw Error('分部ID格式错误');
+    const key=conditionKey(division),fixed=[q[key],q.subcompanyid1];
+    // 固定过滤只能收窄，不能被默认分部或跨分部要求覆盖。
+    if(fixed.some(v=>v!=null&&String(v)!==''&&!String(v).split(',').includes(target)))return {query:q,target,empty:true};
+    q[key]=target;
+    const nk=conditionKey(name);
+    if(context.search) {
+        if(q[nk] && String(q[nk])!==String(context.search))throw Error('姓名搜索与字段固定条件冲突');
+        q[nk]=String(context.search);
+    }
+    if(q.cmd&&q.cmd!=='search')throw Error('字段指定了其他人员协议，需适配');
+    q.cmd='search';
+    return {query:q,target,empty:false};
+}
+export function validPersonCandidates(rows,target,search,baseUrl) {
+    const selected=new Map();
+    for(const r of rows) {
+        const id=clean(r.id),divisionId=clean(r.subcompanyid??r.subcompanyid1),name=clean(r.lastnamespan??r.lastname);
+        if(!id||!divisionId)throw Error('人员结果缺少账号ID或分部ID，无法核验候选');
+        if(divisionId!==target || (search&&!name.includes(String(search))))continue;
+        selected.set(id,{id,name,department:clean(r.departmentname??r.departmentidspan),division:clean(r.subcompanyname??r.subcompanyid1span),divisionId,url:buildHrmCardUrl(baseUrl,id)});
+    }
+    return [...selected.values()];
+}
+export async function queryPersonBrowser(api,form,field,query,context={}) {
+    const before=await currentPersonAccount(api);
+    if(String(form.params.currentUserid)!==before.id)throw Error('表单身份与当前账号不符，请重新读取');
+    const path='/api/public/browser/';
+    const c=await api.get(path+'condition/'+field.detailtype,query,{forceCookie:true});
+    const conditions=c.json?.conditions;
+    if(!Array.isArray(conditions))throw Error('人员浏览条件查询失败，未证明表单可选性');
+    const scoped=personSearchQuery(query,conditions,before,context);
+    const rows=[],seen=new Set();let total=null,complete=scoped.empty;
+    const size=50;
+    for(let page=1;!complete&&page<=100;page++) {
+        const q={...scoped.query,current:String(page),pageSize:String(size),min:String((page-1)*size+1),max:String(page*size)};
+        const url=path+'data/'+field.detailtype;
+        const method=(url+'?'+new URLSearchParams(q)).length>6000?'post':'get';
+        const r=await api[method](url,q,{forceCookie:true}),j=r.json;
+        if(!r.ok||!j||j.status===false||j.status==='false'||!Array.isArray(j.datas)||j.count==null||!Number.isInteger(Number(j.count))||Number(j.count)<0)throw Error('人员浏览查询失败或分页总数缺失，未证明表单可选性');
+        if(total!==null&&total!==Number(j.count))throw Error('人员查询范围发生变化，请重查');
+        total=Number(j.count);
+        for(const row of j.datas){const id=String(row.id??'');if(seen.has(id))throw Error('人员分页重复，无法确认完整范围');seen.add(id);rows.push(row);}
+        if(rows.length>total)throw Error('人员分页条数与总数不符');
+        complete=rows.length>=total;
+        if(!complete&&!j.datas.length)throw Error('人员分页不完整');
+    }
+    if(!complete)throw Error('人员查询超出分页上限，不能据此唯一选人');
+    const after=await currentPersonAccount(api);
+    if(after.id!==before.id||after.divisionId!==before.divisionId)throw Error('选人期间账号/分部变化，候选已失效，请重查');
+    const items=validPersonCandidates(rows,scoped.target,context.search,context.baseUrl??'');
+    return {account:before,scope:{divisionId:scoped.target,crossDivision:context.crossDivision===true},conditions,
+        verification:'field-browser-api',complete:true,count:items.length,items,
+        resolution:items.length===1?'unique':items.length?'choose':'none',
+        note:'已核验当前字段浏览接口范围；不代替保存/提交时后端权限校验。零匹配不扩大范围。'};
+}