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

package/dist/nodemap.js

@@ -0,0 +1,242 @@
+/**
+ * 流程节点名解析：nodeid → nodename。
+ *
+ * 背景：待办/已办/我发起列表服务端**只给当前节点的 id**——行字段 `currentnodeid` 的值形如 "2882"，
+ *   且行里没有节点名（实测 `currentnodeidspan` 也只是 id 本身，整行不含 currentnodename/currentnodespan）。
+ *   要显示名字只能按流程另取节点表。
+ *
+ * 接口（2026-10-14 实测 e9pc.e-cology.com.cn）：
+ *   POST /api/workflow/test/getNodeInfo   body: { workflowId }
+ *     → { nodeInfo: [{id, name, type}], wfInfo: {workflowName, version}, authority, tabInfo, ... }
+ *   - 只需 workflowId；文档里的 requestid/userId/type 都非必需（逐个试过）。
+ *   - ⚠️ 路径必须带 `/api` 前缀：`/workflow/test/getNodeInfo`（无前缀）返回登录页 HTML。
+ *   - ⚠️ 接口挂在「流程测试」模块下，非所有部署/版本都有 → **一律 fail-soft**：
+ *       拿不到就返回 null，调用方退回显示节点 id，绝不让列表整体报错。
+ *   - `type`：0=发起节点 / 1=审批节点 / 3=归档节点。
+ *
+ * 缓存：`~/.bdip/node_map_<envkey>.json`，按 workflowId 存，TTL 30 天
+ *   （节点表几乎不变；响应带 version，流程改版后重新拉取自然覆盖）。
+ *   - `E9_NODEMAP_CACHE_DIR` 覆盖缓存目录（测试隔离用，避免污染真实 ~/.e9）。
+ *   - `E9_NO_NODE_NAME=1` 或 CLI `--no-node-name` 整体停用解析。
+ */
+import { createApiFromProfile } from './client.js';
+import { endpointFor, profileNameFromBaseUrl } from './config.js';
+import { stripHtml } from './parse.js';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+/** 节点表缓存 TTL（天）。 */
+export const NODEMAP_TTL_MS = (Number(process.env.E9_NODEMAP_TTL_DAYS ?? '30') || 30) * 24 * 3600 * 1000;
+/** 并发拉取上限（一次列表页通常 ≤10 个流程，全量拉取路径可能几十个，别一次打满）。 */
+const FETCH_CHUNK = 6;
+
+function str(v) {
+    if (v === undefined || v === null || v === '')
+        return undefined;
+    return String(v);
+}
+
+/** 缓存目录（测试可用 E9_NODEMAP_CACHE_DIR 覆盖）。 */
+export function nodeMapCacheDir() {
+    return process.env.E9_NODEMAP_CACHE_DIR || path.join(os.homedir(), '.bdip');
+}
+/** 缓存文件路径：~/.bdip/node_map_<envkey>.json（按环境隔离，nodeid 不跨环境通用）。 */
+export function nodeMapCachePath(cfg) {
+    const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    return path.join(nodeMapCacheDir(), `node_map_${profileNameFromBaseUrl(baseUrl)}.json`);
+}
+
+/** 是否停用节点名解析（E9_NO_NODE_NAME=1）。 */
+export function isNodeNameDisabled() {
+    return process.env.E9_NO_NODE_NAME === '1';
+}
+
+/**
+ * 纯函数：把 getNodeInfo 响应归一化为 { workflowName, version, nodes:{id:name} }。
+ * 结构不符（登录页/空表/非 JSON）返回 null——调用方据此 fail-soft。
+ */
+export function parseNodeInfo(json) {
+    const list = json?.nodeInfo;
+    if (!Array.isArray(list))
+        return null;
+    const nodes = {};
+    for (const n of list) {
+        const id = str(n?.id);
+        if (!id)
+            continue;
+        nodes[id] = stripHtml(n?.name) || id;
+    }
+    if (Object.keys(nodes).length === 0)
+        return null;
+    return {
+        workflowName: str(json?.wfInfo?.workflowName),
+        version: str(json?.wfInfo?.version),
+        nodes,
+    };
+}
+
+/** 读缓存文件；坏文件/不存在返回 {}。 */
+function readCache(cfg) {
+    try {
+        const p = nodeMapCachePath(cfg);
+        if (!fs.existsSync(p))
+            return {};
+        const raw = JSON.parse(fs.readFileSync(p, 'utf8'));
+        return raw && typeof raw === 'object' && raw.workflows ? raw.workflows : {};
+    }
+    catch {
+        return {};
+    }
+}
+
+/** 写回缓存（单流程）；写入失败不阻断（节点名只是锦上添花）。 */
+function writeCache(cfg, workflowId, entry) {
+    try {
+        const p = nodeMapCachePath(cfg);
+        const workflows = readCache(cfg);
+        workflows[workflowId] = entry;
+        const baseUrl = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+        fs.mkdirSync(path.dirname(p), { recursive: true });
+        fs.writeFileSync(p, JSON.stringify({
+            envkey: profileNameFromBaseUrl(baseUrl),
+            baseUrl,
+            updatedAt: new Date().toISOString(),
+            workflows,
+        }, null, 2) + '\n', 'utf8');
+    }
+    catch { /* 忽略：缓存写失败不影响本次结果 */ }
+}
+
+function isStale(entry) {
+    if (!entry || !entry.fetchedAt)
+        return true;
+    return Date.now() - new Date(entry.fetchedAt).getTime() > NODEMAP_TTL_MS;
+}
+
+/**
+ * 取某流程的节点表（带缓存）。任何失败返回 null（fail-soft，不抛）。
+ * @returns {Promise<{workflowName?:string, version?:string, nodes:Record<string,string>}|null>}
+ */
+export async function getNodeMap(cfg, workflowId, opts = {}) {
+    const wfId = str(workflowId);
+    if (!wfId)
+        return null;
+    const cached = readCache(cfg)[wfId];
+    if (!opts.refresh && cached && !isStale(cached) && cached.nodes)
+        return { workflowName: cached.workflowName, version: cached.version, nodes: cached.nodes };
+    const api = opts.api ?? await createApiFromProfile(cfg);
+    let json = null;
+    try {
+        const r = await api.post('/api/workflow/test/getNodeInfo', { workflowId: wfId });
+        json = r?.json ?? null;
+    }
+    catch {
+        json = null; // 网络/鉴权异常同上：降级，不打断列表
+    }
+    const parsed = parseNodeInfo(json);
+    if (!parsed)
+        return null;
+    writeCache(cfg, wfId, { ...parsed, workflowId: wfId, fetchedAt: new Date().toISOString() });
+    return parsed;
+}
+
+/**
+ * 列出**本地缓存**里所有流程的节点表（供「按节点名跨流程解析」用）。
+ * 缓存来自历次列表查询；从没查过的流程不在其中。
+ */
+export function listCachedNodeMaps(cfg) {
+    const workflows = readCache(cfg);
+    return Object.entries(workflows)
+        .filter(([, w]) => w && w.nodes && Object.keys(w.nodes).length)
+        .map(([workflowId, w]) => ({ workflowId: String(workflowId), workflowName: w.workflowName, nodes: w.nodes }));
+}
+
+/**
+ * 按**节点名**解析节点 id（供 CLI `--node-name`）。
+ *
+ * 节点 id 是**流程内编号**（每个流程一套），故解析必须先限定流程范围：
+ *   - 给了 `workflowId`：只在该流程的节点表内找（按需拉取，不依赖缓存）；
+ *   - 未给：在**本地缓存**的所有流程节点表内找（缓存来自历次列表查询）。
+ *
+ * 匹配规则：**先精确同名**；无精确才做模糊（互相包含）。多候选一律**全部返回**，
+ * 由调用方列给用户选——严禁自动取首条（本仓库硬规则）。
+ *
+ * @returns {Promise<{candidates:Array<{workflowId,workflowName,nodeId,nodeName,matchType}>,
+ *                    exact:Array, scoped:boolean, poolSize:number, unavailable:boolean}>}
+ *   `unavailable`：限定了流程但节点表取不到（接口不存在/异常）——与"确实没有同名节点"要区分开。
+ */
+export async function resolveNodeByName(cfg, name, opts = {}) {
+    const want = String(name ?? '').trim();
+    const empty = { candidates: [], exact: [], scoped: Boolean(opts.workflowId), poolSize: 0, unavailable: false };
+    if (!want)
+        return empty;
+    let pool = [];
+    if (opts.workflowId) {
+        const m = await getNodeMap(cfg, opts.workflowId, opts);
+        if (!m)
+            return { ...empty, unavailable: true };
+        pool = [{ workflowId: String(opts.workflowId), workflowName: m.workflowName, nodes: m.nodes }];
+    }
+    else {
+        pool = listCachedNodeMaps(cfg);
+    }
+    const candidates = [];
+    for (const w of pool) {
+        for (const [nodeId, nodeName] of Object.entries(w.nodes)) {
+            if (!nodeName)
+                continue;
+            const isExact = nodeName === want;
+            const isFuzzy = !isExact && (nodeName.includes(want) || want.includes(nodeName));
+            if (isExact || isFuzzy)
+                candidates.push({ workflowId: w.workflowId, workflowName: w.workflowName, nodeId, nodeName, matchType: isExact ? 'exact' : 'fuzzy' });
+        }
+    }
+    return {
+        candidates,
+        exact: candidates.filter((c) => c.matchType === 'exact'),
+        scoped: Boolean(opts.workflowId),
+        poolSize: pool.length,
+        unavailable: false,
+    };
+}
+
+/** 从列表行取流程 id（normalizeRow 归一字段优先，回退原始行）。 */
+function workflowIdOf(item) {
+    return str(item?.workflowId) ?? str(item?.raw?.workflowid) ?? str(item?.raw?.workflowId);
+}
+
+/**
+ * 给列表行补 `nodeName`（就地写回）。返回补上的行数。
+ *
+ * - 行需带 `node`（节点 id）；流程 id 取 `workflowId` 或 `raw.workflowid`。
+ * - 按流程去重，每个流程只请求一次；同一流程的多行共用一张表。
+ * - 任何失败都不抛：拿不到节点表的行保持原样（渲染层回退显示 id）。
+ */
+export async function annotateNodeNames(cfg, items, opts = {}) {
+    if (!Array.isArray(items) || items.length === 0)
+        return 0;
+    if (opts.disabled)
+        return 0;
+    // 只对「node 是纯数字 id」的行解析：服务端不同列表的 span 给的东西不一样——
+    // 待办/公文给的是**节点 id**（需要解析），流程代理办理记录给的是**节点名**（解析无从匹配，纯浪费请求）。
+    const rows = items.filter((it) => /^\d+$/.test(str(it?.node) ?? '') && workflowIdOf(it));
+    if (rows.length === 0)
+        return 0;
+    const wfIds = [...new Set(rows.map(workflowIdOf))];
+    const maps = new Map();
+    for (let i = 0; i < wfIds.length; i += FETCH_CHUNK) {
+        const chunk = wfIds.slice(i, i + FETCH_CHUNK);
+        const got = await Promise.all(chunk.map((w) => getNodeMap(cfg, w, opts)));
+        chunk.forEach((w, idx) => maps.set(w, got[idx]));
+    }
+    let filled = 0;
+    for (const it of rows) {
+        const name = maps.get(workflowIdOf(it))?.nodes?.[str(it.node)];
+        if (name) {
+            it.nodeName = name;
+            filled++;
+        }
+    }
+    return filled;
+}

package/dist/odoc.js

@@ -0,0 +1,199 @@
+/**
+ * BDIP5 公文（odoc）模块。
+ *
+ * 抓包+实跑确认的接口（测试环境）：
+ *   POST /api/odoc/odocCustomPage/getCustomPageList   公文待办/待阅列表入口（拿 dataKey，customListId/customTabId 定列表与 tab）
+ *   POST /api/ec/dev/table/datas                       取列+行（同待办 table 链路第 2 步）
+ *   POST /api/ec/dev/table/counts                      取总数（同待办 table 链路第 3 步）
+ *   POST /api/odoc/odocTodoList/getTodoCount           待办/待阅计数（发文/收文/签报，按 officalType 分）
+ *   POST /api/odoc/odocCenter/createOfficalList        发文/收文流程列表（officalType=1 发文拟稿 / 2 收文登记，结构同 create 列表）
+ *   POST /api/odoc/odocCenter/getCenterInfo            公文中心首页两个新建入口（发文拟稿/收文登记）
+ *   POST /api/odoc/odocCenter/getCountByOdocType       按公文种类计数
+ *   POST /api/odoc/odocCenter/getCountByTopicType      按主题分类计数
+ *
+ * 走当前 baseUrl（单一环境，所有功能同地址），aiAgentToken 鉴权（e9pc 不支持 token 时回退 cookie）。
+ */
+import { createApiFromProfile } from './client.js';
+import { pickByPaths, stripHtml, extractDataKey, extractColumns, extractRows, extractTotal } from './parse.js';
+const DATERANGE_EMPTY = '0,,'; // type=0(不过滤), from 空, to 空
+/**
+ * 公文待办/待阅列表。3 步 table 链路（POST，form-urlencoded），同待办/workplan-search：
+ *   1. /api/odoc/odocCustomPage/getCustomPageList（过滤项 + customListId/customTabId）→ dataKey（sessionkey 字段）
+ *   2. /api/ec/dev/table/datas（dataKey + current + sortParams=[]）→ columns + 行
+ *   3. /api/ec/dev/table/counts（dataKey）→ 总数（失败不阻断）
+ * 行字段：原值 + `<字段>span` 渲染值（去 HTML）。
+ */
+export async function listOdocTodo(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const filters = {
+        btnType: opts.btnType ?? '1',
+        readstatus: opts.readStatus ?? '',
+        odocSubject: opts.odocSubject ?? '',
+        sendnode: '',
+        topictype: opts.topicType ?? '',
+        secretlevel: opts.secretLevel ?? '',
+        send_unit: opts.sendUnit ?? '',
+        issueduserid: opts.issuedUserid ?? '',
+        writtendateselect: opts.writtenDateSelect ?? DATERANGE_EMPTY,
+        ownerid: opts.ownerId ?? '',
+        createdateselect: opts.createDateSelect ?? DATERANGE_EMPTY,
+        lastmodifydateselect: opts.lastModifyDateSelect ?? DATERANGE_EMPTY,
+        dealinguserid: opts.dealingUserid ?? '',
+        undealeduserid: opts.undealedUserid ?? '',
+        docabstract: opts.docAbstract ?? '',
+        opendateselect: opts.openDateSelect ?? DATERANGE_EMPTY,
+        deadlineselect: opts.deadlineSelect ?? DATERANGE_EMPTY,
+        receivenum: opts.receiveNum ?? '',
+        receivedateselect: opts.receiveDateSelect ?? DATERANGE_EMPTY,
+        workflowid: opts.workflowId ?? '',
+        requestname: opts.requestName ?? '',
+        dispatchnum: opts.dispatchNum ?? '',
+        urgencydegree: opts.urgencyDegree ?? '',
+        receive_unit: opts.receiveUnit ?? '',
+        issueddateselect: opts.issuedDateSelect ?? DATERANGE_EMPTY,
+        departmentid: opts.departmentId ?? '',
+        odoctype: opts.odocType ?? '',
+        customListId: opts.customListId ?? '-12',
+        customTabId: opts.customTabId ?? '-24',
+    };
+    const r1 = await api.post('/api/odoc/odocCustomPage/getCustomPageList', filters);
+    const dataKey = extractDataKey(r1.json);
+    if (!dataKey) {
+        throw new Error(`odoc list 未拿到 dataKey，getCustomPageList 响应: ${(r1.text ?? '').slice(0, 200)}`);
+    }
+    const page = opts.page ?? 1;
+    const r2 = await api.post('/api/ec/dev/table/datas', {
+        dataKey,
+        current: String(page),
+        sortParams: '[]',
+        // table/datas 认 pageSize（同待办链路）：显式 10 条/页，避免服务端默认 30 条/页导致
+        // --page N 按 30 条跳页、本页第 11~30 条看不到的错位。
+        pageSize: opts.pageSize ?? '10',
+    });
+    const columns = extractColumns(r2.json);
+    const rows = extractRows(r2.json);
+    const items = rows.map((r) => normalizeOdocRow(r)).filter((it) => it.requestId || it.requestName);
+    const pageSize = pickByPaths(r2.json, ['pageSize', 'data.pageSize']);
+    let total = null;
+    let countsResp = null;
+    try {
+        const r3 = await api.post('/api/ec/dev/table/counts', { dataKey });
+        countsResp = r3.json;
+        total = extractTotal(r3.json);
+    }
+    catch {
+        // counts 失败不阻断
+    }
+    return {
+        dataKey,
+        page,
+        total,
+        pageSize: typeof pageSize === 'number' ? pageSize : null,
+        columns,
+        items,
+        raw: { getCustomPageList: r1.json, datas: r2.json, counts: countsResp },
+    };
+}
+/** 解析公文待办表行（原值 + span 渲染值）。 */
+export function normalizeOdocRow(row) {
+    if (!row || typeof row !== 'object')
+        return {};
+    const get = (keys) => pickByPaths(row, keys);
+    const spanOr = (dataIndex, extraKeys = []) => stripHtml(get([`${dataIndex}span`, dataIndex, ...extraKeys]));
+    return {
+        requestId: stringify(get(['requestid', 'randomField2'])),
+        requestName: stripHtml(get(['requestnamespan'])) || stringify(get(['requestname'])),
+        odocType: stringify(get(['odoctype'])),
+        odocTypeName: stripHtml(get(['odoctypespan'])),
+        issuedNum: stringify(get(['issued_num', 'issued_numspan'])),
+        receiveNum: stripHtml(get(['receivenumspan'])) || stringify(get(['receivenum'])),
+        topicType: stringify(get(['topictype'])),
+        urgencyDegree: stringify(get(['urgencydegree'])),
+        secretLevel: stripHtml(get(['secretlevelspan'])) || stringify(get(['secretlevel'])),
+        issuedUnit: stringify(get(['issued_unit'])),
+        receiveUnit: stripHtml(get(['receiveunitspan'])) || stringify(get(['receiveunit'])),
+        issuedUserid: stripHtml(get(['issued_useridspan'])) || stringify(get(['issued_userid'])),
+        writtenDate: stripHtml(get(['written_datespan'])) || stringify(get(['written_date'])),
+        issuedDate: stringify(get(['issued_date'])),
+        createrId: stripHtml(get(['createridspan'])) || stringify(get(['createrid', 'creater'])),
+        createDate: stringify(get(['createdate'])),
+        sendDepartment: stringify(get(['senddepartment'])),
+        lastOperateDate: stringify(get(['lastoperatedate'])),
+        // ⚠️ BDIP5 公文列表这两列的**字段名与内容是反的**（2026-10-14 实测 wf=552 发文）：
+        //   currentnodeidspan → "拟稿"（公文环节名，是标签不是 id）
+        //   currentnodespan   → "2868"（真正的**节点 id**，用 getNodeInfo 可解析出节点名「拟稿发起」）
+        // 故不再沿用误导性的原名，改为语义正确的 stageName / node；nodeName 由 nodemap 回填。
+        stageName: stripHtml(get(['currentnodeidspan'])) || stringify(get(['currentnodeid'])),
+        node: stripHtml(get(['currentnodespan'])) || stringify(get(['currentnode'])),
+        nodeName: undefined,
+        zbr: stringify(get(['zbr'])),
+        wbr: stringify(get(['wbr'])),
+        docAbstract: stripHtml(get(['docabstractspan'])) || stringify(get(['docabstract'])),
+        deadline: stripHtml(get(['deadlinespan'])) || stringify(get(['deadline'])),
+        openDate: stripHtml(get(['opendatespan'])) || stringify(get(['opendate'])),
+        receiveDate: stripHtml(get(['receivedatespan'])) || stringify(get(['receivedate'])),
+        operateDate: stripHtml(get(['operatedatespan'])) || stringify(get(['operatedate'])),
+        workflowId: stringify(get(['workflowid', 'randomField0'])),
+        raw: row,
+    };
+}
+/**
+ * 公文待办/待阅计数。POST /api/odoc/odocTodoList/getTodoCount。
+ * - view=false（默认）：待办计数（iscomplete=0）
+ * - view=true：待阅计数（isview=0）
+ * 返回 datalist：[{officalType, title, count}]（发文/收文/签报）。
+ */
+export async function getOdocTodoCount(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const body = opts.view
+        ? { isview: '0', isNew: 'false' }
+        : { iscomplete: '0', isNew: 'false' };
+    const r = await api.post('/api/odoc/odocTodoList/getTodoCount', body);
+    const j = r.json || {};
+    const arr = pickByPaths(j, ['datalist', 'data.datalist']) ?? [];
+    const items = (Array.isArray(arr) ? arr : [])
+        .map((d) => ({
+        officalType: stringify(d?.officalType) ?? '',
+        title: stringify(d?.title) ?? '',
+        count: typeof d?.count === 'number' ? d.count : Number(d?.count ?? 0),
+    }))
+        .filter((it) => it.title);
+    return { view: !!opts.view, items, raw: j };
+}
+/**
+ * 发文/收文流程列表。POST /api/odoc/odocCenter/createOfficalList。
+ * - officalType=1（默认）：发文拟稿
+ * - officalType=2：收文登记
+ * 返回 datas[{typeName, id, wfCount, wfbeans[]}]，结构同 create 列表，
+ * 故"新建公文"可复用 create start（wfstart.ts）的发起链路。
+ */
+export async function listOdocCreate(cfg, opts = {}) {
+    const api = await createApiFromProfile(cfg);
+    const officalType = opts.officalType ?? '1';
+    const r = await api.post('/api/odoc/odocCenter/createOfficalList', { officalType });
+    const j = r.json || {};
+    const arr = pickByPaths(j, ['datas', 'data.datas']) ?? [];
+    const toplabel = stringify(pickByPaths(j, ['createwflabels.toplabel']));
+    const categories = (Array.isArray(arr) ? arr : [])
+        .map((d) => ({
+        id: stringify(d?.id),
+        name: stringify(d?.typeName),
+        wfCount: typeof d?.wfCount === 'number' ? d.wfCount : Number(d?.wfCount ?? 0),
+        workflows: (Array.isArray(d?.wfbeans) ? d.wfbeans : [])
+            .map((w) => ({
+            id: stringify(w?.id),
+            name: stringify(w?.name),
+            typeId: stringify(w?.typeId),
+            spell: stringify(w?.spell),
+            letter: stringify(w?.letter),
+        }))
+            .filter((w) => w.id || w.name),
+    }))
+        .filter((c) => c.workflows.length > 0);
+    return { officalType, toplabel, categories, raw: j };
+}
+function stringify(v) {
+    if (v === undefined || v === null || v === '')
+        return undefined;
+    return String(v);
+}

package/dist/office-tools.js

@@ -0,0 +1,155 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import {createHash} from 'node:crypto';
+import {pathToFileURL, fileURLToPath} from 'node:url';
+
+export async function accounts(api) {
+  const r = await api.get('/api/hrm/login/getAccountList', {__random__: Date.now()}, {forceCookie: true});
+  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('未能确认当前账号');
+  return items;
+}
+
+export async function shift(api, id) {
+  const before = await accounts(api);
+  if (!before.some(a => a.id === id)) throw Error('目标不在关联账号列表中');
+  if (!before.find(a => a.id === id).current) {
+    await api.post('/api/hrm/login/identityShift', {shiftid: id}, {forceCookie: true});
+  }
+  const after = await accounts(api);
+  if (!after.find(a => a.id === id)?.current) throw Error('切换未验证成功，停止后续业务操作');
+  return after;
+}
+
+export async function main(argv = process.argv.slice(2)) {
+  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('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));
+  const load = name => import(pathToFileURL(path.join(dist, name + '.js')).href);
+  const {loadConfig} = await load('config');
+  const {createApiFromProfile} = await load('client');
+  const cfg = loadConfig(), api = await createApiFromProfile(cfg);
+  const list = await accounts(api);
+  const accountId = list.find(a => a.current).id;
+  // 独立偏好文件，避免工具写配置时丢失；按环境和关联账号组隔离。
+  const prefFile = path.join(path.dirname(cfg._configPath), 'office-project-defaults.json');
+  const scope = createHash('sha256').update(cfg.baseUrl + '\n' + list.map(a => a.id).sort().join(',')).digest('hex');
+  const prefs = fs.existsSync(prefFile) ? JSON.parse(fs.readFileSync(prefFile, 'utf8')) : {};
+  if (['accounts', 'after-login', 'switch', 'default-set', 'default-clear'].includes(command)) {
+    let result = list;
+    if (command === 'default-set') {
+      if (!list.some(a => a.id === args[0])) throw Error('默认账号必须属于当前关联账号列表');
+      prefs[scope] = args[0];
+      fs.writeFileSync(prefFile, JSON.stringify(prefs, null, 2));
+    }
+    if (command === 'default-clear') {
+      delete prefs[scope];
+      fs.writeFileSync(prefFile, JSON.stringify(prefs, null, 2));
+    }
+    if (command === 'switch') result = await shift(api, args[0]);
+    if (command === 'after-login' && prefs[scope]) result = await shift(api, prefs[scope]);
+    console.log(JSON.stringify({accounts: result, defaultAccountId: prefs[scope] || null,
+      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) => {
+    const r = await api.post('/api/workflow/reqform/loadForm', {workflowid:workflowId, iscreate:requestId?'0':'1', requestid:String(requestId??'-1')}, {forceCookie:true});
+    if(r.json?.params?.verifyRight!==true || String(r.json.params.currentUserid)!==accountId) throw Error('表单权限或账号不符');
+    return r.json;
+  };
+  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}));
+    console.log(JSON.stringify(await runtime.queryBrowser(api,form,fieldId,context),null,2));return;
+  }
+  if (command === 'adapter-register') {
+    const [workflowId,source,mappingFile]=args;
+    runtime.registerAdapter(cfg,workflowId,await getForm(workflowId),source,JSON.parse(fs.readFileSync(mappingFile,'utf8')));
+    console.log('已登记本机适配；不随升级包分发');return;
+  }
+  if (command === 'draft-preview' || command === 'draft-update-preview') {
+    const [workflowId, valuesFile, title, planFile, detailsFile, requestId] = args;
+    if(!planFile || !title || fs.existsSync(planFile)) throw Error('参数不全或计划已存在');
+    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;
+    plan.prepared={...prepared,body:Object.fromEntries(Object.entries(prepared.body).filter(([k])=>!/token|signature|UUID/i.test(k)))};
+    fs.writeFileSync(planFile,JSON.stringify(plan,null,2),{flag:'wx'});
+    console.log(JSON.stringify({state:'local-preview-only',...plan},null,2));return;
+  }
+  if(!['draft-save','draft-verify','draft-submit'].includes(command))throw Error('未知命令');
+  const planFile=args[0],receiptFile=planFile+'.receipt.json';
+  const plan=JSON.parse(fs.readFileSync(planFile,'utf8'));
+  if(plan.baseUrl!==cfg.baseUrl || plan.accountId!==accountId || !plan.expected)throw Error('计划环境/账号不符或旧版计划，请重新预览，不重复新建');
+  let receipt=fs.existsSync(receiptFile)?JSON.parse(fs.readFileSync(receiptFile,'utf8')):null;
+  const action=command==='draft-submit'?'submit':'save';
+  if(command==='draft-submit' && args[1]!=='--confirm')throw Error('正式提交需在完整预览后明确确认，使用 --confirm');
+  if(command==='draft-save'||command==='draft-submit') {
+    if(receipt)throw Error('已有保存回执，禁止重复执行，请先核验');
+    const form=await getForm(plan.workflowId,plan.requestId);
+    if(!plan.prepared)throw Error('旧计划缺少统一准备快照，请重新预览');
+    const prepared=plan.prepared;
+    await preparation.checkAdapter(cfg,plan,form);
+    const tables=await runtime.detailTables(api,form,plan.workflowId,plan.requestId);
+    preparation.checkBaseline(prepared,form,tables);
+    const body=preparation.actionBody(prepared,form,action);
+    const menu=await api.post('/api/workflow/reqform/rightMenu',{...form.params,...form.submitParams,isaffirmance:'0',isaffirmanceSrc:''},{forceCookie:true});
+    if(!menu.json?.rightMenus?.some(m=>m.systemMenuType===(action==='save'?'SAVE':'SUBMIT')))throw Error('没有保存权限');
+    receipt={state:'executing',action,requestId:plan.requestId};fs.writeFileSync(receiptFile,JSON.stringify(receipt),{flag:'wx'});
+    const saved=await api.post('/api/workflow/reqform/requestOperation',body,{forceCookie:true});
+    Object.assign(receipt,preparation.classifyWrite(saved,plan.requestId));
+    fs.writeFileSync(receiptFile,JSON.stringify(receipt,null,2));
+    if(receipt.state==='failed')throw Error('保存明确失败：'+JSON.stringify(receipt.messageInfo));
+    if(receipt.state==='uncertain')throw Error('保存结果不明，请核验，禁止重复新建');
+  }
+  if(!receipt?.requestId)throw Error('结果不明，禁止重复新建，请到我的请求核验');
+  const form=await getForm(plan.workflowId,receipt.requestId);
+  const tables=await runtime.detailTables(api,form,plan.workflowId,receipt.requestId);
+  if(receipt.state==='failed')throw Error('上次保存明确失败，不能将原稿回读冒充保存成功');
+  const problems=preparation.verifyAction(plan.expected,form,tables,receipt.action??'save');
+  const current=(await accounts(api)).find(a=>a.current);
+  if(current.id!==plan.accountId)problems.push('账号变化');
+  receipt.state=problems.length?'verification-required':receipt.action==='submit'?'submitted-verified':'draft-verified';receipt.problems=problems;
+  fs.writeFileSync(receiptFile,JSON.stringify(receipt,null,2));
+  const {buildRequestFormUrl}=await load('wfcreate');
+  // The business receipt is already durable; link issuance must never replay the write.
+  const {resolveBrowserLink} = await load('browser-links');
+  const link = await resolveBrowserLink(cfg, buildRequestFormUrl(cfg.baseUrl,receipt.requestId,plan.workflowId));
+  console.log(JSON.stringify({...receipt,...link},null,2));
+  if(problems.length)process.exitCode=1;
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href) {
+  main().catch(e => {console.error(e.message); process.exitCode = 1;});
+}

package/dist/pageopen.js

@@ -0,0 +1,29 @@
+import { endpointFor } from './config.js';
+
+const PAGE_MAP = {
+    center: '/wui/index.html#/main/workflow/index',
+    todo: '/wui/index.html#/main/workflow/doing',
+    done: '/wui/index.html#/main/workflow/done',
+    mine: '/wui/index.html#/main/workflow/mine',
+    draft: '/wui/index.html#/main/workflow/draft',
+    all: '/wui/index.html#/main/workflow/all',
+    newflow: '/spa/workflow/static4form/index.html#/main/workflow/req?iscreate=1',
+    monitor: '/wui/index.html#/main/workflow/monitor',
+};
+
+export function pageUrl(cfg, page, requestId) {
+    const base = endpointFor(cfg).baseUrl.replace(/\/+$/, '');
+    if (page === 'view') {
+        if (!requestId)
+            throw new Error('打开流程详情需要 --request-id <请求 ID>。');
+        return `${base}/spa/workflow/static4form/index.html#/main/workflow/req?iscreate=0&requestid=${encodeURIComponent(requestId)}`;
+    }
+    const path = PAGE_MAP[page];
+    if (!path)
+        throw new Error(`不支持的页面“${page}”。可选：${Object.keys(PAGE_MAP).join('、')}、view。`);
+    return base + path;
+}
+
+export function availablePages() {
+    return [...Object.keys(PAGE_MAP), 'view'];
+}