weaver-work-cli 0.1.36 → 0.1.39

package/dist/shortcuts/meeting/operations/invitation.js

@@ -20,6 +20,7 @@ import { fileURLToPath } from 'node:url';
 import { meetingValidationError } from '../errors.js';
 import { meetingStateDir } from './env.js';
 import { renderDocx } from '../invitation/docx.js';
+import { renderInvitationMarkdown } from '../invitation/text.js';
 import { meetingSuccess, SCHEMA_ID } from './types.js';
 /** 模板随 CLI 包分发（`templates/` 已在 package.json 的 files 白名单内）。 */
 function templatePath() {
@@ -250,8 +251,80 @@ async function resolveIssuerOrganization(env, creatorId) {
         return null;
     }
 }
-/** 组装占位符解析器：派生字段 → 会议标准字段 → extra（租户自定义字段）→ 待补充。 */
-export function buildResolver(row, extra, issuerOrg) {
+/**
+ * 取当前登录人的姓名 —— 会议既没填召集人、又没有创建人名时，用**发起人本人**兜底。
+ *
+ * 理由：邀请函里「XXX 诚邀您参加…」这句必须有个人名，否则通篇【待补充】没法看。
+ * 实际业务上发起建会的人就是召集人，比留空更接近事实（2026-10-31 用户对【待补充】有意见）。
+ */
+async function resolveSessionUserName(env) {
+    try {
+        const session = await env.host.getSession();
+        const userId = String(session?.userId ?? '').trim();
+        if (!userId)
+            return '';
+        const { hrmEmployeeOperations } = await import('../../hrm/operations/employee.js');
+        const batch = hrmEmployeeOperations.find((operation) => operation.name === 'hrm.employee.batch');
+        if (!batch)
+            return '';
+        const result = await batch.handler({ ids: [userId] }, env);
+        const row = (result?.data?.rows ?? [])[0];
+        return String(row?.name ?? '').trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * 用 `meeting.eb.meeting.detail` 补列表单查里**空着**的字段。
+ *
+ * 为什么需要（2026-10-31 真机取证）：同一个会议
+ *   · `meeting.eb.meeting.list`（单查）→ `hrm_members = ""`
+ *   · `meeting.eb.meeting.detail`     → `hrm_members = "王丹丹"`
+ * 邀请函原先只读 list，于是"明明有参会人却写成【待补充】"—— 这正是用户投诉过的
+ * 「参会人员没有带出来」。detail 的价值在于**字段更多且有值**，代价是 `address` 回的是
+ * 会议室 id（不是名称），所以这里**只补白名单字段、且只填空值**，绝不覆盖 list 已有的值。
+ */
+const DETAIL_FALLBACK_KEYS = [
+    'hrm_members', 'mt_desc', 'total_member', 'caller', 'contacter',
+    'begin_datetime', 'end_datetime', 'other_members', 'mt_creator',
+    'topic_presenter', 'mt_format', 'mt_type', 'video_url',
+    'org_members', 'with_secauth',
+];
+async function supplementRowFromDetail(row, mtId, env) {
+    const isBlank = (value) => {
+        if (value === undefined || value === null)
+            return true;
+        if (Array.isArray(value))
+            return value.length === 0;
+        return String(value).trim() === '';
+    };
+    const missing = DETAIL_FALLBACK_KEYS.filter((key) => isBlank(row[key]));
+    if (missing.length === 0)
+        return { row, filled: [] };
+    try {
+        const { getMeetingOperation } = await import('./registry.js');
+        const detailOperation = getMeetingOperation('meeting.eb.meeting.detail');
+        const result = await detailOperation.handler({ id: mtId }, env);
+        // detail 的字段是**扁平**挂在 `data.data` 下（不是 mainTable），两种都兜一下
+        const flat = (result?.data?.data ?? result?.data ?? {});
+        const merged = { ...row };
+        const filled = [];
+        for (const key of missing) {
+            const value = flat[key];
+            if (!isBlank(value)) {
+                merged[key] = value;
+                filled.push(key);
+            }
+        }
+        return { row: merged, filled };
+    }
+    catch {
+        // detail 读失败不能拖垮邀请函：列表数据照样能出一份（缺的字段仍标【待补充】）
+        return { row, filled: [] };
+    }
+}
+/** 组装占位符解析器：派生字段 → 会议标准字段 → extra（租户自定义字段）→ 待补充。 */ export function buildResolver(row, extra, issuerOrg) {
     const begin = parseDateTime(row.begin_datetime);
     const end = parseDateTime(row.end_datetime);
     const derived = {
@@ -297,6 +370,9 @@ export function buildResolver(row, extra, issuerOrg) {
         org_members: orgMembers,
         // 落款公司全称：`extra.company_name` 可覆盖（对外开放时客户传自己的公司名）
         company_name: String(extra.company_name ?? '').trim() || DEFAULT_COMPANY_NAME,
+        // 客户单位（「尊敬的 XXX」）：先看 extra（建会时由 create.flow 把参会客户名带进来），
+        // 再看会议主表的 crm_members（部分租户会存），都没有才留【待补充】
+        guest_org: String(extra.guest_org ?? '').trim() || flattenFieldValue(row.crm_members) || '',
         // 单独暴露上级公司，模板需要「公司级落款」时可直接用
         issuer_company: issuerCompany,
         other_members: humanizeMembers(row.other_members),
@@ -320,8 +396,14 @@ export function buildResolver(row, extra, issuerOrg) {
     const lookup = (key) => {
         if (key in derived)
             return derived[key];
-        if (key in standard)
-            return standard[key];
+        if (key in standard) {
+            const standardValue = standard[key];
+            // ⛔ 会议里该字段**空着**时要继续往 extra 找（2026-10-31）：
+            // 以前 `key in standard` 直接返回空串，导致「会议没填召集人 → extra.caller 也压不上」，
+            // 明明调用方补了值还是渲染成【待补充】。空值不算"有值"，让 extra 有机会兜底。
+            if (String(standardValue ?? '').trim() !== '')
+                return standardValue;
+        }
         if (key.startsWith('extra.') && key.slice(6) in extra)
             return extra[key.slice(6)];
         if (key in extra)
@@ -353,7 +435,10 @@ const meetingInvitationRender = {
     resource: 'invitation',
     method: 'render',
     action: 'meeting.invitation.render',
-    summary: '按会议真实数据生成邀请函 docx（只读，不发送）：数据取 meeting.eb.meeting.list 单查；议程有议题就按议题自动填、没有则保留模板示例行；取不到的字段渲染成黄色高亮【待补充】；租户自定义字段用 extra 传入',
+    summary: '按会议真实数据生成邀请函（只读，不发送）：**同时返回 docx 与对话内可展示的 Markdown 全文**（`text` 字段），'
+        + '会话里应直接把 `text` 贴出来，不要只给文件名让人自己下载；'
+        + '数据取 meeting.eb.meeting.list 单查；议程有议题就按议题自动填、没有则保留模板示例行；'
+        + '取不到的字段渲染成【待补充】（docx 里是黄色高亮）；租户自定义字段用 extra 传入',
     capability: 'invitation',
     risk: 'read',
     inputSchema: {
@@ -395,6 +480,8 @@ const meetingInvitationRender = {
         let row;
         /** meeting=按真实会议数据；payload=按调用方传入的申请单字段（会议可能还没生成）。 */
         let dataSource = 'meeting';
+        /** 用 detail 补回来的字段名（列表单查会丢「参会人员」，见下方注释）。 */
+        let detailSupplementary = [];
         if (!mtId) {
             // ⛔ 邀请函本质是「预置函」：项目人员下载后自己改、自己发（2026-10-30 用户明确要求）。
             // 所以不该卡在"会议必须已生成"——流程还在审批时，用申请单已知信息先生成一份，
@@ -437,6 +524,21 @@ const meetingInvitationRender = {
             if (!row) {
                 throw meetingValidationError('not_found', `未找到会议 id=${mtId}，或当前账号无权限查看`, { mtId });
             }
+            // 列表单查在真机上会**丢「参会人员」**（2026-10-31 实测：同一会议 list 里 `hrm_members=""`，
+            // detail 里是「王丹丹」）⇒ 只对**空字段**用 detail 补，避免邀请函把明明有的人写成【待补充】。
+            const supplement = await supplementRowFromDetail(row, mtId, env);
+            row = supplement.row;
+            detailSupplementary = supplement.filled;
+        }
+        // 召集人再兜一层：会议没填 caller、也没有创建人名时，用**发起人本人**（当前登录人）。
+        // 否则邀请函开头「XXX 诚邀您参加…」整句就是【待补充】，对话里贴出来很难看。
+        let callerFromSession = false;
+        if (!String(row.caller ?? '').trim() && !String(row.mt_creator ?? '').trim()) {
+            const sessionName = await resolveSessionUserName(env);
+            if (sessionName) {
+                row = { ...row, caller: sessionName };
+                callerFromSession = true;
+            }
         }
         // 落款单位回落：会议 org_members 为空时，用「发起人（creator 人员 id）的所属组织」
         const creatorId = String(row.creator ?? '').trim();
@@ -463,6 +565,10 @@ const meetingInvitationRender = {
         const rendered = renderDocx(template, resolver, {
             agenda: { headerKeyword: AGENDA_HEADER_KEYWORD, rows: agendaRows },
         });
+        // 对话内文本版（2026-10-31 用户要求「直接展示在对话里」）：
+        // docx 是给打印/外发的成品，但会话里用户看不见内容 ⇒ 同一份 resolver 再渲染一遍 Markdown，
+        // 上层（create.flow / 模型回复）可以直接把 text 贴出来，字段与 docx 完全一致。
+        const textVersion = renderInvitationMarkdown(resolver, agendaRows);
         const begin = parseDateTime(row.begin_datetime);
         const dateTag = begin ? `${begin.getFullYear()}${pad(begin.getMonth() + 1)}${pad(begin.getDate())}` : '未知日期';
         const fileName = `邀请函-${safeFileName(String(row.mt_name ?? ''))}-${dateTag}.docx`;
@@ -499,14 +605,21 @@ const meetingInvitationRender = {
             meetingName: String(row.mt_name ?? ''),
             // meeting=按真实会议数据；payload=按申请单字段预生成（会议可能还没生成，属预置函）
             dataSource,
+            // 列表单查丢字段时，用 detail 补回来的字段名（有值 = 邀请函用的是合并后的数据）
+            detailSupplemented: detailSupplementary,
+            // 对话内展示用的 Markdown 全文（与 docx 同源）。上层应直接把这段贴进回复正文，
+            // ⛔ 不要只丢一个 filePath 让用户自己去本地打开看内容。
+            text: textVersion.markdown,
             filledFields: rendered.filled,
             pendingFields: rendered.pending,
             // 落款单位的实际来源，便于调用方判断是否需要人工改写
             orgSource,
-            // 召集人来源：meeting.caller=会议自己填的 / meeting.mt_creator=回落到创建人 / none=都没有
-            callerSource: String(row.caller ?? '').trim()
-                ? 'meeting.caller'
-                : (String(row.mt_creator ?? '').trim() ? 'meeting.mt_creator' : 'none'),
+            // 召集人来源：meeting.caller=会议自己填的 / meeting.mt_creator=回落到创建人 / session.user=回落到发起人本人 / none=都没有
+            callerSource: callerFromSession
+                ? 'session.user'
+                : (String(row.caller ?? '').trim()
+                    ? 'meeting.caller'
+                    : (String(row.mt_creator ?? '').trim() ? 'meeting.mt_creator' : 'none')),
             // 议程来源：meeting.topic=按议题自动填 / extra=调用方传入 / template=保留模板示例行
             agendaSource,
             agendaRows: agendaRows.length,

package/dist/shortcuts/okr/host.js

@@ -6,6 +6,7 @@ import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
 import { requireE10Session } from '../../internal/e10/context.js';
 import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10SessionExpiredResponse } from '../../internal/e10/auth-recovery.js';
 import { okrStateRoot } from './continuation.js';
 import { OkrCliError, okrAuthError, okrNetworkError, okrValidationError } from './errors.js';
 function inferProfile(ctx) {
@@ -143,7 +144,7 @@ export function createOkrHost(ctx, dependencies = {}) {
         catch (error) {
             mapRuntimeNetworkError(error);
         }
-        if (response.status === 401 || response.status === 302) {
+        if (isE10SessionExpiredResponse(response)) {
             throw okrAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, { httpStatus: response.status });
         }
         if (response.parseError) {

package/dist/shortcuts/plan/host.js

@@ -6,6 +6,7 @@ import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
 import { requireE10Session } from '../../internal/e10/context.js';
 import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10SessionExpiredResponse } from '../../internal/e10/auth-recovery.js';
 import { planStateRoot } from './continuation.js';
 import { PlanCliError, planAuthError, planNetworkError, planValidationError } from './errors.js';
 function inferProfile(ctx) {
@@ -150,7 +151,7 @@ export function createPlanHost(ctx, dependencies = {}) {
         catch (error) {
             mapRuntimeNetworkError(error);
         }
-        if (response.status === 401 || response.status === 302) {
+        if (isE10SessionExpiredResponse(response)) {
             throw planAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, { httpStatus: response.status });
         }
         if (response.parseError) {

package/dist/shortcuts/project/host.js

@@ -2,6 +2,7 @@ import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
 import { requireE10Session } from '../../internal/e10/context.js';
 import { E10ApiError, createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10SessionExpiredResponse } from '../../internal/e10/auth-recovery.js';
 import { ProjectCliError, projectApiError, projectAuthError, projectNetworkError, projectValidationError, } from './errors.js';
 const PROJECT_PATH_PREFIXES = [
     '/api/ebuilder/form/formdata/v2/',
@@ -133,7 +134,7 @@ export function createProjectHost(ctx, dependencies = {}) {
         catch (error) {
             mapRuntimeNetworkError(error);
         }
-        if (response.status === 401 || response.status === 302) {
+        if (isE10SessionExpiredResponse(response)) {
             throw projectAuthError('session_expired', E10_SESSION_EXPIRED_MESSAGE, {
                 httpStatus: response.status,
             });

package/dist/shortcuts/workflow/host.js

@@ -2,6 +2,7 @@ import { E10_SESSION_EXPIRED_MESSAGE } from '../../internal/e10/auth/messages.js
 import { requireE10Session } from '../../internal/e10/context.js';
 import { getActiveProfile } from '../../internal/e10/auth/session.js';
 import { createE10RequestRuntime } from '../../internal/e10/request-runtime.js';
+import { isE10AuthenticationRequired } from '../../internal/e10/auth-recovery.js';
 import { workflowApiError, workflowAuthError, workflowNetworkError } from './errors.js';
 const DEFAULT_TIMEOUT_MS = 30_000;
 /**
@@ -81,6 +82,8 @@ export function isAtustRedirect(status, value) {
 export function isLoginExpired(value, httpStatus) {
     if (httpStatus === 401 || httpStatus === 403)
         return true;
+    if (isE10AuthenticationRequired({ status: httpStatus ?? 200, value }))
+        return true;
     if (isAtustRedirect(httpStatus, value))
         return true;
     const joined = payloadTexts(value).join('\n').toLowerCase();

package/dist/shortcuts/workflow/index.js

@@ -215,7 +215,7 @@ export const workflowShortcut = {
             const user = readUserIntents({ ctx: ctx });
             ctx.output.write({
                 dir: loaded.dir,
-                defaultFile: join(loaded.dir, 'default.json'),
+                defaultFile: loaded.dir ? join(loaded.dir, 'default.json') : null,
                 userIntentFile: user.file,
                 userIntentExists: user.exists,
                 userIntentError: user.error,

package/dist/shortcuts/workflow/operations/form.js

@@ -34,8 +34,16 @@ import { buildChatSceneInput, formatLocalNow, requestFormFill } from './chatscen
 const TEXTAREA_COMPONENTS = new Set(['textarea', 'richtext', 'editor', 'html', 'htmltext']);
 const SELECT_COMPONENTS = new Set(['select', 'selectmultiple', 'radiobox', 'checkbox', 'radio', 'multiselect']);
 const BROWSER_COMPONENTS = new Set([
-    'employee', 'department', 'subcompany', 'jobtitle', 'job', 'relatebrowser',
-    'browser', 'workflow', 'ebuilder', 'customer', 'project',
+    // 人员 / 组织类
+    'employee', 'department', 'subcompany', 'jobtitle', 'job',
+    'employeeorganization', 'employeeshare', 'employeeauthshare', 'odocreceivecomponent',
+    // 关联类型（设计器「表单组件 / 关联类型」面板）
+    'ebuilder', 'mainline', 'project', 'task', 'document', 'workflow', 'formcomponent',
+    'customer', 'customercomponent', 'cluecomponent', 'ordercomponent', 'contactcomponent',
+    'productioncomponent', 'contractcomponent', 'activitycomponent', 'competitorcomponent',
+    'kpiflowcomponent', 'workreportcomponent', 'attendcomponent', 'agendacomponent', 'chancecomponent',
+    'relatebrowser', 'relateodoc', 'relatetag', 'relateintegrate', 'modulecomponent', 'paas',
+    'quotecomponent', 'drivingrecord', 'browser',
 ]);
 const NON_INPUT_COMPONENTS = new Set([
     'paragraph', 'label', 'divider', 'option', 'detailtable', 'group', 'layout', 'internaltitle', 'multilingualtag',
@@ -4726,8 +4734,19 @@ const XIAOE_FILL_FORM_SDK_OPTIONS = {
  */
 const XIAOE_INITIAL_VALUES_MULTI_SEPARATOR = ',';
 const XIAOE_INITIAL_VALUES_ROW_SEPARATOR = ';';
+/**
+ * 浏览按钮字段的值是**对象 id** 时加的前缀（2026-11-02 用户裁定）。
+ *
+ * 口径：`isBrowser === true` 的字段值来自 `[{id, name}]` 里的 `id`，落进 `customParams` / `src`
+ * 时写成 `##<id>`，让页面能区分「这是记录 id」与「这是用户手打的名称」；而**名称不拼前缀**
+ * （非浏览字段的值本来就是字符串，原样透传）。
+ *
+ * 多值逐个判定，所以 `##<id>,<名称>` 是合法形态（同一字段里既有解析出的 id、又有原样名称）。
+ * 明细多行同口径：`##<id>;<名称>`。
+ */
+const XIAOE_BROWSER_ID_PREFIX = '##';
 /** 单个标量 → URL 传参里的那一段文本。对象按「id 优先」取标识（附件取到的就是 fileid）。 */
-function xiaoEUrlParamScalar(value) {
+function xiaoEUrlParamScalar(value, prefixBrowserId = false) {
     if (value === null || value === undefined)
         return '';
     if (typeof value === 'object') {
@@ -4740,24 +4759,26 @@ function xiaoEUrlParamScalar(value) {
             if (picked === null || picked === undefined)
                 continue;
             const text = String(picked).trim();
-            if (text)
-                return text;
+            if (!text)
+                continue;
+            // 浏览按钮字段：这一段的来源是对象 id（不是用户给的名称），按 2026-11-02 口径加 `##`。
+            return prefixBrowserId ? `${XIAOE_BROWSER_ID_PREFIX}${text}` : text;
         }
         return '';
     }
     return String(value).trim();
 }
 /** 单个字段的值 → URL 传参里的那一段文本（数组按「同字段多值」用 `,` 连接）。 */
-function xiaoEUrlParamValue(value) {
+function xiaoEUrlParamValue(value, prefixBrowserId = false) {
     if (value === null || value === undefined)
         return '';
     if (Array.isArray(value)) {
         return value
-            .map((item) => xiaoEUrlParamScalar(item))
+            .map((item) => xiaoEUrlParamScalar(item, prefixBrowserId))
             .filter(Boolean)
             .join(XIAOE_INITIAL_VALUES_MULTI_SEPARATOR);
     }
-    return xiaoEUrlParamScalar(value);
+    return xiaoEUrlParamScalar(value, prefixBrowserId);
 }
 /**
  * `params.customParams` 里**字段值**那一份 = `{字段id: 值}`（用户裁定用**字段 id**，不用数据 key）；
@@ -4768,6 +4789,10 @@ function xiaoEUrlParamValue(value) {
  *
  * 明细字段（`preview` 里带 `dataIndex`）按**行号升序**取值、用 `;` 连接；主表字段就是它自己的值。
  * 值为空（没解析出内容）的字段整个省略，不生成空参数。
+ *
+ * **浏览按钮字段的值加 `##` 前缀**（2026-11-02 用户裁定，见 `XIAOE_BROWSER_ID_PREFIX`）：这类字段解析
+ * 出来的每一段都是对象 id，写成 `##<id>`；名称（非浏览字段的字符串）原样不加。多值/多行逐个判定，
+ * 因此 `##<id>,<名称>`、`##<id>;<名称>` 都是合法形态。`src` 末尾的字段参数与这里同源，一起带上。
  */
 /**
  * 小e 档交给浏览器页面的字段值：只留**可见且可编辑**的那些（2026-10-21 用户裁定）。
@@ -4810,15 +4835,23 @@ function editablePreviewForXiaoE(preview, fields, visibility) {
     }
     return kept;
 }
-function xiaoECustomParams(preview) {
+function xiaoECustomParams(preview, fields) {
     const ordered = [];
     const mainValues = new Map();
     const detailValues = new Map();
+    // 「这个字段是不是浏览按钮」决定要不要给对象 id 拼 `##`（2026-11-02 用户裁定）——
+    // 判据取 `extractFields` 算好的 `isBrowser`，与值解析走的是同一份结论，不在这里二次推断。
+    const browserFieldIds = new Set();
+    for (const field of toArray(fields)) {
+        const id = String(field?.id ?? '').trim();
+        if (id && field?.isBrowser)
+            browserFieldIds.add(id);
+    }
     for (const item of toArray(preview)) {
         const fieldId = String(item?.fieldId ?? '').trim();
         if (!fieldId)
             continue;
-        const text = xiaoEUrlParamValue(item?.value);
+        const text = xiaoEUrlParamValue(item?.value, browserFieldIds.has(fieldId));
         if (!text)
             continue;
         const isDetail = item?.dataIndex !== undefined && item?.dataIndex !== null;
@@ -5234,7 +5267,7 @@ async function runCreateRequest(args, env, options = {}) {
                 baseUrl: xiaoEBaseUrl,
                 title: String(context.workflow?.name ?? ''),
                 workflowId: String(context.workflow?.id ?? context.runtime?.workflow_id ?? ''),
-                customParams: xiaoECustomParams(fillPreview),
+                customParams: xiaoECustomParams(fillPreview, fields),
             }),
         });
     }

package/dist/shortcuts/workflow/operations/todoSmartConvert/aigroupRules.js

@@ -12,7 +12,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { stateRoot } from '../../../../core/state.js';
-import { cacheRoots } from './summaryCache.js';
+import { resolveSkillDir } from './summaryCache.js';
 export const AIGROUP_DIR_NAME = 'aigroup';
 export const DEFAULT_RULE_FILE = 'default.json';
 export const USER_INTENT_RULE_FILE = 'user-intents.json';
@@ -30,6 +30,7 @@ export const FALLBACK_DEFAULTS = {
     summaryMaxChars: 150,
     groupSummaryMaxChars: 100,
     groupSummaryTail: '可展开逐条查看或直接汇总处理',
+    excludeOriginFormDataFields: [],
 };
 export function emptyRuleFile(error = null) {
     return {
@@ -66,16 +67,38 @@ function validateFocusKeyword(raw, index) {
         return `focusKeyword[${index}] 必须是 [指标, 算子, 值] 三元组`;
     return null;
 }
+/** 校验排除字段清单：缺省放行；给了就必须是字符串或字符串数组（允许空数组）。 */
+function validateExcludeFields(raw, where) {
+    if (raw === undefined)
+        return null;
+    if (typeof raw === 'string') {
+        return raw.trim() === '' ? `${where} 不能是空字符串（不排除就别给这个键）` : null;
+    }
+    if (!Array.isArray(raw))
+        return `${where} 必须是字符串数组`;
+    for (const item of raw) {
+        if (typeof item !== 'string' || item.trim() === '')
+            return `${where} 的每一项都必须是非空字符串`;
+    }
+    return null;
+}
 /** 校验整份规则文件；返回错误列表（空数组 = 合法）。 */
 export function validateRuleFile(raw) {
     const errors = [];
     const file = raw;
     if (!file || typeof file !== 'object')
         return ['规则文件必须是 JSON 对象'];
+    // schemaVersion：不能是废字段。给值时必须受支持（2 = aigroup set 写入的意图文件，3 = default.json）；缺省允许（规则级校验兼容）。
+    if (file.schemaVersion !== undefined && file.schemaVersion !== 2 && file.schemaVersion !== 3) {
+        errors.push(`schemaVersion 只支持 2 或 3，收到 ${JSON.stringify(file.schemaVersion ?? null)}`);
+    }
     if (!Array.isArray(file.rules)) {
         errors.push('rules 必须是数组');
         return errors;
     }
+    const defaultsExclude = validateExcludeFields(file.defaults?.excludeOriginFormDataFields, 'defaults.excludeOriginFormDataFields');
+    if (defaultsExclude)
+        errors.push(defaultsExclude);
     const seen = new Set();
     file.rules.forEach((rule, index) => {
         if (!rule || typeof rule !== 'object') {
@@ -98,6 +121,16 @@ export function validateRuleFile(raw) {
         if (rule.summaryMaxChars !== undefined && (typeof rule.summaryMaxChars !== 'number' || rule.summaryMaxChars <= 0)) {
             errors.push(`rules[${index}].summaryMaxChars 必须是正数`);
         }
+        const excludeReason = validateExcludeFields(rule.excludeOriginFormDataFields, `rules[${index}].excludeOriginFormDataFields`);
+        if (excludeReason)
+            errors.push(excludeReason);
+        if (rule.summaryRequiredFields !== undefined) {
+            if (!Array.isArray(rule.summaryRequiredFields) || rule.summaryRequiredFields.length === 0
+                || rule.summaryRequiredFields.some((f) => typeof f !== 'string' || !f.trim() || f.trim().length > 50)
+                || rule.summaryRequiredFields.length > 20) {
+                errors.push(`rules[${index}].summaryRequiredFields 必须是非空字符串数组（1~20 项、每项 1~50 字）`);
+            }
+        }
         const groupRule = rule.aiGroup?.groupRule;
         if (groupRule) {
             if (typeof groupRule.focus !== 'boolean')
@@ -162,47 +195,42 @@ export function loadRuleFile(file) {
         return emptyRuleFile(`规则文件校验失败：${errors.join('；')}`);
     return { file: parsed, error: null };
 }
-/** 默认规则目录（**随 skill 分发、只读**）：`WEAVER_WORK_CLI_AIGROUP_DIR` → skill 目录下的 `aigroup/` → CLI 状态目录。 */
-export function aigroupDir(ctx) {
-    const explicit = process.env.WEAVER_WORK_CLI_AIGROUP_DIR?.trim();
-    if (explicit)
-        return join(explicit);
-    const roots = cacheRoots(ctx);
-    return roots.skillDir ? join(roots.skillDir, AIGROUP_DIR_NAME) : join(stateRoot(ctx), AIGROUP_DIR_NAME);
-}
 /**
- * 用户意图目录（**运行时产物，绝不写进 skill 目录**）：`WEAVER_WORK_CLI_AIGROUP_DIR` → CLI 状态目录。
- *
- * 刻意与 `aigroupDir()` 分开：意图文件是本机产生的，一旦落在 skill 目录里，
- * 打包/安装时会跟着 skill 跑到别人机器上（既是泄漏，也会污染别人的分组口径）。
+ * 当前 skill 的 aigroup 目录（`default.json` 与 `user-intents.json` 同目录；
+ * 2026-11-01 用户定稿：规则与意图都锚定**当前 agent 的 skill 目录**）。
+ * 裸 CLI（无当前 skill 上下文）返回 null ⇒ 规则不加载、意图不可读写。
  */
+export function aigroupDir(ctx) {
+    const skillDir = resolveSkillDir();
+    return skillDir ? join(skillDir, AIGROUP_DIR_NAME) : null;
+}
+/** 用户意图目录：与 `default.json` 同目录（见 `aigroupDir`）。 */
 export function aigroupUserDir(ctx) {
-    const explicit = process.env.WEAVER_WORK_CLI_AIGROUP_DIR?.trim();
-    if (explicit)
-        return join(explicit);
-    return join(stateRoot(ctx), AIGROUP_DIR_NAME);
+    return aigroupDir(ctx);
 }
 /**
  * 加载并合并规则：默认文件 +（可选）用户意图文件（**同 workflowName 整条覆盖**，系统默认不被覆盖）。
  * 用户意图文件里的条目按 `workflowName` 粒度替换默认条目，缺字段由 defaults 补。
+ * 裸 CLI（无当前 skill 上下文）⇒ 按无规则处理 + warning（缓存与规则都拒绝，见 cacheRoots）。
  */
 export function loadRules(options = {}) {
-    const dir = options.dir ?? aigroupDir(options.ctx);
-    // 显式 `dir` 时（测试/现场）默认文件与意图文件放一起；否则意图文件只从状态目录读。
-    const userDir = options.dir ?? aigroupUserDir(options.ctx);
     const warnings = [];
+    const dir = options.dir ?? aigroupDir(options.ctx);
+    if (!dir) {
+        warnings.push('无当前 skill 上下文（WEAVER_WORK_CLI_SKILL_DIR 未设置）：aigroup 规则未加载，按无规则处理');
+        return { file: emptyRuleFile(null).file, warnings, dir: null };
+    }
     const base = loadRuleFile(join(dir, DEFAULT_RULE_FILE));
     if (base.error)
         warnings.push(base.error);
     const rules = [...base.file.rules];
-    // 兼容迁移：意图文件原先写在 skill 目录里，改到状态目录后老文件不会被自动搬走；
-    // 状态目录没有时就回读老位置，避免用户已有的意图「凭空消失」。
-    const userIntentFile = join(userDir, USER_INTENT_RULE_FILE);
-    const legacyIntentFile = join(dir, USER_INTENT_RULE_FILE);
+    // 意图文件与 default.json 同目录；兼容迁移：老位置（CLI 状态目录）若存在且新位置没有 ⇒ 回读 + 提示
+    const userIntentFile = join(dir, USER_INTENT_RULE_FILE);
+    const legacyIntentFile = join(stateRoot(options.ctx), AIGROUP_DIR_NAME, USER_INTENT_RULE_FILE);
     let intentFile = userIntentFile;
     if (!options.dir && !existsSync(userIntentFile) && existsSync(legacyIntentFile)) {
         intentFile = legacyIntentFile;
-        warnings.push(`用户意图仍读自 skill 目录（${legacyIntentFile}）：新位置是 ${userIntentFile}，重新执行 aigroup set 即可迁移`);
+        warnings.push(`用户意图仍读自 CLI 状态目录（${legacyIntentFile}）：新位置是 ${userIntentFile}，重新执行 aigroup set 即可迁移`);
     }
     const intent = loadRuleFile(intentFile);
     if (intent.error) {
@@ -274,13 +302,16 @@ export function resolveRule(file, workflowName) {
             summaryMaxChars: raw.summaryMaxChars ?? defaults.summaryMaxChars,
             groupSummaryMaxChars: defaults.groupSummaryMaxChars,
             groupSummaryTail: defaults.groupSummaryTail,
+            // 显式给 `[]` = 规则级覆盖（清空 defaults 的清单）；未给才落 defaults
+            excludeOriginFormDataFields: raw.excludeOriginFormDataFields === undefined
+                ? defaults.excludeOriginFormDataFields
+                : asStringArray(raw.excludeOriginFormDataFields) ?? [],
             aiGroup: raw.aiGroup
                 ? {
                     groupSummary: {
                         needAI: groupSummary?.needAI ?? false,
                         ...(groupSummary?.prompt === undefined ? {} : { prompt: groupSummary.prompt }),
                         ...(groupSummary?.template === undefined ? {} : { template: groupSummary.template }),
-                        maxChars: defaults.groupSummaryMaxChars,
                         tail: defaults.groupSummaryTail,
                     },
                     groupRule: groupRule ?? EMPTY_GROUP_RULE,
@@ -446,3 +477,23 @@ export function resetActiveRules() {
     activeFile = null;
     activeDir = null;
 }
+// ---------------------------------------------------------------------------
+// formData 排除字段（2026-10-30 用户定稿：excludeOriginFormDataFields）
+// ---------------------------------------------------------------------------
+/**
+ * 当前生效规则的 formData 排除字段清单（空数组 = 不排除）。
+ *
+ * 消费方：`todoDetailFetcher.fetchOneDetail` —— 拿到接口 formData 后按 fieldName 精确匹配剔除；
+ * 详情缓存用 `excludeTagFor()` 做**口径失效**：清单一变，旧缓存条目整体 miss。
+ */
+export function excludeFieldsFor(workflowName) {
+    return activeRuleFor(workflowName)?.excludeOriginFormDataFields ?? [];
+}
+/** 排除清单的特征串（原文拼接）。规则没配 = 空串，与「无口径」条目互相匹配。 */
+export function excludeTagOf(fields) {
+    return [...fields].join('\u0001');
+}
+/** 便捷组合：某流程当前生效的排除口径特征串。 */
+export function excludeTagFor(workflowName) {
+    return excludeTagOf(excludeFieldsFor(workflowName));
+}

package/dist/shortcuts/workflow/operations/todoSmartConvert/aigroupStore.js

@@ -44,6 +44,8 @@ function namesOf(rule) {
  */
 export function saveUserIntents(payload, options = {}) {
     const dir = options.dir ?? aigroupUserDir(options.ctx);
+    if (!dir)
+        throw workflowValidationError('aigroup_no_skill_context', '无当前 skill 上下文（WEAVER_WORK_CLI_SKILL_DIR 未设置）：用户意图不可读写');
     const warnings = [];
     const entries = normalizeIntentPayload(payload);
     if (entries.length === 0)
@@ -86,6 +88,8 @@ export function saveUserIntents(payload, options = {}) {
 /** 读用户意图文件（诊断/展示用）。 */
 export function readUserIntents(options = {}) {
     const dir = options.dir ?? aigroupUserDir(options.ctx);
+    if (!dir)
+        return { dir: null, file: '', exists: false, error: '无当前 skill 上下文（WEAVER_WORK_CLI_SKILL_DIR 未设置）', rules: [] };
     const file = join(dir, USER_INTENT_RULE_FILE);
     if (!existsSync(file))
         return { dir, file, exists: false, error: null, rules: [] };
@@ -95,6 +99,8 @@ export function readUserIntents(options = {}) {
 /** 清空用户意图（只删内容、不删文件，保持目录结构）。 */
 export function clearUserIntents(options = {}) {
     const dir = options.dir ?? aigroupUserDir(options.ctx);
+    if (!dir)
+        throw workflowValidationError('aigroup_no_skill_context', '无当前 skill 上下文（WEAVER_WORK_CLI_SKILL_DIR 未设置）：用户意图不可读写');
     const file = join(dir, USER_INTENT_RULE_FILE);
     mkdirSync(dir, { recursive: true, mode: 0o700 });
     writeFileSync(file, `${JSON.stringify({ schemaVersion: 2, rules: [] }, null, 2)}\n`, { mode: 0o600 });