weaver-work-cli 0.1.8 → 0.1.20

package/dist/shortcuts/caizhilian/operations/specs.js

@@ -0,0 +1,623 @@
+import { schemaOf } from './types.js';
+/**
+ * 采知连（E10 文档中心）操作规格表。
+ *
+ * 由源 Skill `weaver-e10-caizhilian` 的 64 个 operation（scripts/*_plugins.py +
+ * doc-business-operations/*.json）1:1 派生：
+ * - 60 个 canonical operation 保留（4 个本地配置类 operation 落到 manifest.withheldOperations）；
+ * - 入参名严格保持源 snake_case（doc_id / folder_id / page_no / save_path ...）；
+ * - `sourceOperation` 记录源 operation 名，便于回溯；
+ * - `requiresConfirmation` 的写操作由 registry 展开为 `<name>.prepare` / `<name>.apply`。
+ */
+const S = (description, extra = {}) => ({ type: 'string', description, ...extra });
+const ID = (description) => ({ type: 'string', pattern: '^\\d+$', minLength: 1, description });
+const INT = (description, extra = {}) => ({ type: 'integer', description, ...extra });
+const BOOL = (description, extra = {}) => ({ type: 'boolean', description, ...extra });
+const LIST = (description, items = { type: 'string' }) => ({
+    type: 'array',
+    minItems: 1,
+    items,
+    description,
+});
+const FILE = (description) => ({ type: 'string', minLength: 1, description });
+/** 源 folder_plugins._VALID_PERMISSION_TYPES。 */
+export const PERMISSION_TYPES = [
+    'copyPermission',
+    'deletePremisstion',
+    'downloadPremisstion',
+    'folderDefaultParticipants',
+    'movePermission',
+    'newCreateDocPremisstion',
+    'newCreateFolderPremisstion',
+    'settingPermission',
+];
+/** 源 folder_plugins._VALID_DETAIL_TYPES。 */
+export const SETTING_TYPES = [
+    'copyPermission',
+    'defaultShares',
+    'deletePremisstion',
+    'downloadPremisstion',
+    'folderDefaultParticipants',
+    'movePermission',
+    'newCreateDocPremisstion',
+    'newCreateFolderPremisstion',
+    'settingPermission',
+];
+/** 源 folder_plugins._QUERY_FOLDER_VALID_PERMISSION_KEYS。 */
+export const FOLDER_PERMISSION_KEYS = [
+    'copyPermission',
+    'deletePremisstion',
+    'downloadPremisstion',
+    'folderDefaultParticipants',
+    'folderDefaultShareNew',
+    'movePermission',
+    'newCreateDocPremisstion',
+    'newCreateFolderPremisstion',
+    'settingPermission',
+];
+/** 源 document_plugins._FIELD_MAP 的键。 */
+export const DOC_UPDATE_FIELDS = ['abstract', 'auto_invalid_date', 'keywords', 'name'];
+const FOLDER_TYPE = S('文件夹类型：company=公共/privy=个人/sys=系统', { enum: ['company', 'privy', 'sys'] });
+const KB_TYPE = S('知识库类型', { enum: ['company', 'privy', 'sys'], default: 'company' });
+const PERMISSION_TYPE = S('权限类型', { enum: [...PERMISSION_TYPES] });
+const SETTING_TYPE = S('设置项类型', { enum: [...SETTING_TYPES] });
+function pageProps(defaultPageSize) {
+    return {
+        page_no: INT('页码（1-indexed）', { minimum: 1, default: 1 }),
+        page_size: INT('每页条数', { minimum: 1, default: defaultPageSize }),
+    };
+}
+/** 源 create_html_document / create_markdown_document / create_office_document 的公共可选入参。 */
+const CREATE_DOC_OPTIONALS = {
+    participant_ids: LIST('参与人（人员 ID）列表；缺省时按文件夹默认参与人回填'),
+    abstract_text: S('摘要'),
+    keywords: S('关键词'),
+    auto_invalidate_date: S('自动失效日期（YYYY-MM-DD）'),
+    tags: LIST('标签列表（源样透传给 document.tags）', { type: 'object', additionalProperties: true }),
+    virtual_folder_ids: LIST('虚拟文件夹 ID 列表；缺省时按文件夹默认虚拟目录回填'),
+    doc_category: INT('文档类别：0=普通，1=重要', { enum: [0, 1], default: 0 }),
+    cover_picture_id: ID('封面图片文件 ID'),
+};
+/** 源 add_doc_share / add_folder_set_default_share 的共享对象 ID 字段（1:1 保留 11 个）。 */
+const SHARE_ID_FIELDS = {
+    obj_id: LIST('共享对象 ID（人员等）'),
+    obj_id_department: LIST('部门 ID'),
+    obj_id_subcompany: LIST('分部/子公司 ID'),
+    obj_id_role: LIST('角色 ID'),
+    obj_id_group: LIST('组 ID'),
+    obj_id_external: LIST('外部人员 ID'),
+    obj_id_customer: LIST('客户 ID'),
+    obj_id_customer_type: LIST('客户类型 ID'),
+    obj_id_position: LIST('岗位 ID'),
+    obj_id_manager: LIST('上级 ID'),
+    obj_id_grade: LIST('职级 ID'),
+};
+/** 源共享表单的可选级联参数。 */
+const SHARE_OPTION_FIELDS = {
+    download: LIST('下载权限（share_level != 1 且未传时默认 ["download"]）'),
+    department_attribute: LIST('部门属性'),
+    role_level: S('角色层级'),
+    position_level: S('岗位层级'),
+    position_attribute: LIST('岗位属性'),
+    virtualCompany: S('虚拟组织'),
+    createrPositionLevel: S('创建人岗位层级'),
+};
+function spec(resource, action, sourceOperation, risk, summary, properties, required = [], options = {}) {
+    return {
+        name: `caizhilian.${resource}.${action}`,
+        resource,
+        method: options.method ?? 'plugin',
+        action,
+        summary,
+        risk,
+        ...(options.requiresConfirmation ? { requiresConfirmation: true } : {}),
+        sourceOperation,
+        ...(options.deprecatedInputAliases ? { deprecatedInputAliases: options.deprecatedInputAliases } : {}),
+        ...(options.permissions ? { permissions: options.permissions } : {}),
+        inputSchema: schemaOf(properties, { required }),
+    };
+}
+/**
+ * 源资料声明的权限/接口前置条件（doc-business-operations 的「权限校验：…」表述）。
+ * 只在源明确写出的操作上记录，不推断。
+ */
+const PERMISSION_FOLDER_CREATE_DOCUMENT = ['folder.create-document'];
+const PERMISSION_COMPARE_UPLOAD = ['compare.upload'];
+export const caizhilianOperationSpecs = [
+    // ── document ────────────────────────────────────────────
+    spec('document', 'search', 'search_documents', 'read', '按关键词/文件夹/创建人/创建时间检索文档（源 search_documents）', {
+        keywords: S('检索关键词'),
+        folder_id: ID('文件夹 ID：100=系统，200=公共，300=个人'),
+        include_sub_folder: BOOL('是否包含子文件夹（仅在传了 folder_id 时生效）', { default: false }),
+        creator_user_id: ID('创建人（人员 ID）'),
+        create_time: S('创建时间范围，支持 today/last_7_days 等枚举或 last_<N>_days'),
+        ...pageProps(40),
+    }),
+    spec('document', 'get', 'fetch_doc_base_info_by_docid', 'read', '按 doc_id 获取文档详情（源模板 FetchDocBaseInfoByDocid）', {
+        doc_id: ID('文档 ID'),
+    }, ['doc_id'], { method: 'http_template' }),
+    spec('document', 'create-html', 'create_html_document', 'high-risk-write', '在指定文件夹创建 HTML 文档（源 create_html_document）', {
+        name: S('文档标题'),
+        folder_id: ID('目标文件夹 ID'),
+        folder_type: FOLDER_TYPE,
+        author_id: ID('作者（人员 ID）'),
+        summary: S('HTML 正文内容'),
+        ...CREATE_DOC_OPTIONALS,
+    }, ['name', 'folder_id', 'folder_type', 'author_id'], {
+        requiresConfirmation: true,
+        permissions: PERMISSION_FOLDER_CREATE_DOCUMENT,
+    }),
+    spec('document', 'create-markdown', 'create_markdown_document', 'high-risk-write', '在指定文件夹创建 Markdown 文档（源 create_markdown_document）', {
+        name: S('文档标题'),
+        folder_id: ID('目标文件夹 ID'),
+        folder_type: FOLDER_TYPE,
+        author_id: ID('作者（人员 ID）'),
+        summary: S('Markdown 正文内容；传 file_path 时其内容覆盖 summary，两者都可不传'),
+        file_path: FILE('本地 .md/.markdown 文件路径，读取内容覆盖 summary'),
+        ...CREATE_DOC_OPTIONALS,
+    }, ['name', 'folder_id', 'folder_type', 'author_id'], {
+        requiresConfirmation: true,
+        permissions: PERMISSION_FOLDER_CREATE_DOCUMENT,
+    }),
+    spec('document', 'create-office', 'create_office_document', 'read-with-upload', '上传 Office 文件并创建文档（源 create_office_document）', {
+        file_path: FILE('本地 Office 文件路径（.doc/.docx/.xls/.xlsx/.ppt/.pptx）'),
+        name: S('文档标题，缺省取文件名（不含扩展名）'),
+        folder_id: ID('目标文件夹 ID'),
+        folder_type: FOLDER_TYPE,
+        author_id: ID('作者（人员 ID）'),
+        ...CREATE_DOC_OPTIONALS,
+    }, ['file_path', 'folder_id', 'folder_type', 'author_id'], {
+        requiresConfirmation: true,
+        permissions: PERMISSION_FOLDER_CREATE_DOCUMENT,
+    }),
+    spec('document', 'create-by-upload', 'create_document_by_upload', 'read-with-upload', '批量上传文件直接建文档（源 create_document_by_upload）', {
+        file_paths: LIST('本地文件路径列表（最多并发 8 个）'),
+        folder_id: ID('目标文件夹 ID'),
+        folder_type: FOLDER_TYPE,
+        author_id: ID('作者（人员 ID），缺省取当前登录人'),
+        participant_ids: LIST('参与人（人员 ID）列表'),
+        keywords: S('关键词'),
+        abstract_text: S('摘要'),
+        auto_invalidate_date: S('自动失效日期（YYYY-MM-DD）'),
+        tags: LIST('标签列表', { type: 'object', additionalProperties: true }),
+        virtual_folder_ids: LIST('虚拟文件夹 ID 列表'),
+        doc_category: INT('文档类别：0=普通，1=重要', { enum: [0, 1], default: 0 }),
+    }, ['file_paths', 'folder_id', 'folder_type'], {
+        requiresConfirmation: true,
+        permissions: PERMISSION_FOLDER_CREATE_DOCUMENT,
+    }),
+    spec('document', 'update-field', 'update_doc_field', 'high-risk-write', '修改文档基础字段（源 update_doc_field）', {
+        doc_id: ID('文档 ID'),
+        field: S('字段名', { enum: [...DOC_UPDATE_FIELDS] }),
+        value: S('字段值（name 字段不允许空串）'),
+    }, ['doc_id', 'field', 'value'], { requiresConfirmation: true }),
+    spec('document', 'update-author', 'update_doc_author', 'high-risk-write', '变更文档作者（源 update_doc_author）', {
+        doc_id: ID('文档 ID'),
+        user_id: ID('新作者（人员 ID）'),
+    }, ['doc_id', 'user_id'], { requiresConfirmation: true }),
+    spec('document', 'update-html', 'update_doc_html_content', 'high-risk-write', '保存 HTML 正文并生成新版本（源 update_doc_html_content）', {
+        doc_id: ID('文档 ID'),
+        summary: S('HTML 正文内容'),
+    }, ['doc_id', 'summary'], { requiresConfirmation: true }),
+    spec('document', 'replace-content', 'replace_document_content', 'read-with-upload', '用本地文件替换文档正文（源 replace_document_content，走 reUpload）', {
+        file_path: FILE('本地文件路径，扩展名需与文档正文类型匹配'),
+        doc_id: ID('文档 ID'),
+    }, ['file_path', 'doc_id'], { requiresConfirmation: true }),
+    // ── folder ──────────────────────────────────────────────
+    spec('folder', 'create', 'create_folder', 'high-risk-write', '创建文件夹（源 create_folder）', {
+        name: S('文件夹名称'),
+        parent_id: ID('父文件夹 ID'),
+        parent_type: S('父文件夹类型', { enum: ['company', 'privy'] }),
+        sequence: INT('排序号，范围 -9999~99999；parent_type=privy 时强制为 0', { minimum: -9999, maximum: 99999, default: 0 }),
+        inherit_parent: BOOL('是否继承父文件夹设置；parent_type=privy 时强制为 false', { default: false }),
+    }, ['name', 'parent_id', 'parent_type'], { requiresConfirmation: true }),
+    spec('folder', 'search-virtual', 'search_virtual_folders', 'read', '检索虚拟文件夹（源 search_virtual_folders）', {
+        name: S('虚拟文件夹名称关键词'),
+        ...pageProps(50),
+    }),
+    spec('folder', 'query-by-name', 'query_folders_by_name', 'read', '按名称查询文件夹并展平为路径列表（源模板 FlattenSearchResultFolderTree）', {
+        folder_name: S('文件夹名称'),
+        kb_type: KB_TYPE,
+    }, ['folder_name'], { method: 'http_template' }),
+    spec('folder', 'get-settings', 'fetch_folder_default_settings', 'read', '查询文件夹默认设置（虚拟目录/默认参与人/默认共享）', {
+        folder_id: ID('文件夹 ID'),
+    }, ['folder_id'], { method: 'http_template' }),
+    spec('folder', 'list-default-shares', 'fetch_folder_default_shares', 'read', '查询文件夹文档默认共享人列表（源入参名为 folderId）', {
+        folder_id: ID('文件夹 ID'),
+        folderId: ID('旧名字段，等价 folder_id（已废弃，与新名同时出现且取值不一致会报 alias_conflict）'),
+    }, ['folder_id'], { deprecatedInputAliases: { folder_id: ['folderId'] } }),
+    spec('folder', 'default-share.form', 'fetch_folder_set_default_share_form', 'read', '查询“默认共享人”表单配置（对象类型 + 级联参数）', {
+        folder_id: ID('文件夹 ID'),
+        category: S('表单类别', { enum: ['creator', 'generic'] }),
+    }, ['folder_id', 'category']),
+    spec('folder', 'default-share.list', 'fetch_folder_set_default_share_list', 'read', '查询“默认共享人”设置列表', {
+        folder_id: ID('文件夹 ID'),
+    }, ['folder_id']),
+    spec('folder', 'default-share.add', 'add_folder_set_default_share', 'high-risk-write', '添加文件夹默认共享人', {
+        folder_id: ID('文件夹 ID'),
+        obj_type: S('共享对象类型（取自 default-share.form 的 obj_types[].id）'),
+        share_level: S('共享级别'),
+        ...SHARE_ID_FIELDS,
+        ...SHARE_OPTION_FIELDS,
+        seclevel_min: INT('密级下限，范围 -999~999', { minimum: -999, maximum: 999 }),
+        seclevel_max: INT('密级上限，范围 -999~999', { minimum: -999, maximum: 999 }),
+    }, ['folder_id', 'obj_type', 'share_level'], { requiresConfirmation: true }),
+    spec('folder', 'default-share.delete', 'delete_folder_set_default_share', 'high-risk-write', '删除文件夹默认共享人', {
+        folder_id: ID('文件夹 ID'),
+        ids: LIST('待删除条目 ID 列表'),
+    }, ['folder_id', 'ids'], { requiresConfirmation: true }),
+    spec('folder', 'permission.form', 'fetch_folder_permission_form', 'read', '查询文件夹文档权限设置的表单配置', {
+        folder_id: ID('文件夹 ID'),
+        permission_type: PERMISSION_TYPE,
+    }, ['folder_id', 'permission_type']),
+    spec('folder', 'permission.list', 'list_folder_permission', 'read', '查询文件夹文档权限设置列表', {
+        folder_id: ID('文件夹 ID'),
+        permission_type: PERMISSION_TYPE,
+    }, ['folder_id', 'permission_type']),
+    spec('folder', 'permission.add', 'add_folder_permission', 'high-risk-write', '添加文件夹文档权限设置', {
+        folder_id: ID('文件夹 ID'),
+        permission_type: PERMISSION_TYPE,
+        obj_type: S('权限对象类型'),
+        obj_id: LIST('对象 ID（人员等）'),
+        obj_id_department: LIST('部门 ID'),
+        obj_id_subcompany: LIST('分部 ID'),
+        obj_id_role: LIST('角色 ID'),
+        obj_id_position: LIST('岗位 ID'),
+        obj_id_customer: LIST('客户 ID'),
+        obj_id_customer_type: LIST('客户类型 ID'),
+        department_attribute: LIST('部门属性'),
+        role_level: S('角色层级'),
+        position_level: S('岗位层级'),
+        position_attribute: LIST('岗位属性'),
+        position_level_department: LIST('岗位层级-部门'),
+        position_level_subcompany: LIST('岗位层级-分部'),
+    }, ['folder_id', 'permission_type', 'obj_type'], { requiresConfirmation: true }),
+    spec('folder', 'permission.delete', 'delete_folder_permission', 'high-risk-write', '删除文件夹文档权限设置', {
+        folder_id: ID('文件夹 ID'),
+        permission_type: PERMISSION_TYPE,
+        ids: LIST('待删除条目 ID 列表'),
+    }, ['folder_id', 'permission_type', 'ids'], { requiresConfirmation: true }),
+    spec('folder', 'permission.get-auth', 'fetch_folder_permission_auth', 'read', '查询文件夹权限类型当前值（true/user/false）', {
+        folder_id: ID('文件夹 ID'),
+        permission_type: PERMISSION_TYPE,
+    }, ['folder_id', 'permission_type']),
+    spec('folder', 'permission.set-auth', 'update_folder_permission_auth', 'high-risk-write', '设置文件夹权限类型（true/user/false）', {
+        folder_id: ID('文件夹 ID'),
+        permission_type: PERMISSION_TYPE,
+        value: S('目标值', { enum: ['true', 'user', 'false'] }),
+    }, ['folder_id', 'permission_type', 'value'], { requiresConfirmation: true }),
+    spec('folder', 'permission.detail', 'fetch_folder_permission_detail', 'read', '查询文件夹单个设置项详情（含标题与人员明细）', {
+        folder_id: ID('文件夹 ID'),
+        setting_type: SETTING_TYPE,
+    }, ['folder_id', 'setting_type']),
+    spec('folder', 'permission.query', 'query_folder_permissions', 'read', '批量查询文件夹权限白名单字段（源模板 FilterFolderPermissionFields）', {
+        folder_ids: LIST('文件夹 ID 列表'),
+    }, ['folder_ids'], { method: 'http_template' }),
+    spec('folder', 'query-by-permission', 'query_folders_by_permission', 'read', '按权限类型 + 权限对象反查文件夹', {
+        permission_key: S('权限类型', { enum: [...FOLDER_PERMISSION_KEYS] }),
+        permissions: LIST('权限对象列表，如 [{"object_type":"all"}] 或 [{"object_type":"resource","object_ids":["123"]}]', {
+            type: 'object',
+            additionalProperties: false,
+            properties: {
+                object_type: S('对象类型'),
+                object_ids: LIST('对象 ID 列表（正整数）'),
+            },
+            required: ['object_type'],
+        }),
+        ...pageProps(20),
+    }, ['permission_key', 'permissions']),
+    // ── setting-attach ──────────────────────────────────────
+    spec('setting-attach', 'get', 'get_setting_attach', 'read', '读取附件设置（文件设置 → 附件设置）', {}, [], {
+        method: 'http_template',
+    }),
+    spec('setting-attach', 'list-workflows-by-folders', 'list_approval_workflows_by_folders', 'read', '通过文件夹 ID 反查哪些审批流程将这些文件夹设置为附件上传目录', {
+        folder_ids: LIST('文件夹 ID 列表'),
+    }, ['folder_ids'], {
+        method: 'http_template',
+    }),
+    spec('setting-attach', 'set', 'set_setting_attach', 'high-risk-write', '保存附件设置（只改指定字段，未指定字段透传原值）', {
+        items: {
+            type: 'object',
+            properties: {
+                'upload-max': S('上传最大（如 2G、512MB）'),
+                'shard-size': INT('上传分片大小（MB，1-50）'),
+                'format-mode': S('格式控制方式（whitelist/blacklist）'),
+                'format-list': S('格式列表（逗号分隔扩展名）'),
+                'non-image-open': S('非图片打开方式（newTab/popupWindow）'),
+                'image-open': S('图片打开方式（newTab/previewComponent）'),
+                'show-attach-list': BOOL('预览显示附件列表'),
+                'attach-expand': BOOL('附件列默认展开'),
+                'custom-msg': S('附加提示（true::文本 或 false）'),
+                'batch-download': BOOL('附件批量下载'),
+                'mobile-block': BOOL('禁止移动端下载'),
+            },
+            additionalProperties: false,
+        },
+    }, ['items'], { requiresConfirmation: true }),
+    // ── setting-backup ──────────────────────────────────────
+    spec('setting-backup', 'get', 'get_setting_backup', 'read', '读取备份开关状态（文件设置 → 备份设置）', {}, [], {
+        method: 'http_template',
+    }),
+    spec('setting-backup', 'set', 'set_setting_backup', 'high-risk-write', '设置备份开关', {
+        enabled: BOOL('是否启用本地备份'),
+    }, ['enabled'], { requiresConfirmation: true }),
+    spec('setting-backup', 'rule.list', 'list_backup_rules', 'read', '列出备份规则', {
+        ...pageProps(20),
+    }),
+    spec('setting-backup', 'rule.get', 'get_backup_rule', 'read', '获取备份规则详情', {
+        id: ID('规则 ID'),
+    }, ['id']),
+    spec('setting-backup', 'rule.update', 'update_backup_rule', 'high-risk-write', '更新备份规则', {
+        id: ID('规则 ID'),
+        name: S('规则名称'),
+        path: S('备份路径'),
+        period: INT('备份周期（分钟，60-1440）'),
+    }, ['id'], { requiresConfirmation: true }),
+    spec('setting-backup', 'rule.delete', 'delete_backup_rule', 'high-risk-write', '删除备份规则', {
+        id: ID('规则 ID'),
+    }, ['id'], { requiresConfirmation: true }),
+    spec('setting-backup', 'rule.enable', 'enable_backup_rule', 'high-risk-write', '启停备份规则', {
+        id: ID('规则 ID'),
+        enabled: BOOL('是否启用'),
+    }, ['id', 'enabled'], { requiresConfirmation: true }),
+    // ── setting-encrypt ─────────────────────────────────────
+    spec('setting-encrypt', 'get', 'get_setting_encrypt', 'read', '读取加解密设置（文件设置 → 加解密设置）', {}, [], {
+        method: 'http_template',
+    }),
+    spec('setting-encrypt', 'set', 'set_setting_encrypt', 'high-risk-write', '保存加解密设置（整对象 POST）', {
+        items: {
+            type: 'object',
+            properties: {
+                'enabled': BOOL('是否启用加解密功能'),
+                'plugs': S('加解密插件类型'),
+                'url': S('加解密服务地址'),
+                'scene': S('加解密场景（uploadAndDownloadEncrypt/uploadEncrypt/downloadEncrypt/custom）'),
+                'upload-encrypted': S('加密文件上传规则'),
+                'download-encrypted': S('加密文件下载规则'),
+                'upload-unencrypted': S('未加密文件上传规则'),
+                'download-unencrypted': S('未加密文件下载规则'),
+            },
+            additionalProperties: false,
+        },
+    }, ['items'], { requiresConfirmation: true }),
+    // ── setting-storage ─────────────────────────────────────
+    spec('setting-storage', 'instance.list', 'list_storage_instances', 'read', '列出存储实例', {
+        ...pageProps(20),
+    }),
+    spec('setting-storage', 'instance.get', 'get_storage_instance', 'read', '获取存储实例详情', {
+        id: ID('实例 ID'),
+        instance_type: S('实例类型（可选）'),
+    }, ['id']),
+    spec('setting-storage', 'rule.form', 'get_rule_form', 'read', '拉规则表单', {
+        id: ID('规则 ID（可选，不传拉默认）'),
+    }),
+    spec('setting-storage', 'rule.table', 'get_rule_table', 'read', '拉规则表', {}, [], {
+        method: 'http_template',
+    }),
+    spec('setting-storage', 'rule.search', 'search_rules', 'read', '高级搜索规则', {
+        conditions: LIST('搜索条件数组', {
+            type: 'object',
+            properties: {
+                field: S('字段名'),
+                value: S('值'),
+                operate: S('操作符'),
+            },
+            required: ['field', 'value', 'operate'],
+        }),
+        rule_type: S('规则类型（可选）'),
+    }),
+    spec('setting-storage', 'rule.save', 'save_rule', 'high-risk-write', '保存存储规则', {
+        rule_info_list: LIST('规则信息列表', {
+            type: 'object',
+            additionalProperties: true,
+        }),
+        default_rule: BOOL('是否默认规则'),
+    }, ['rule_info_list'], { requiresConfirmation: true }),
+    spec('setting-storage', 'rule.delete', 'delete_rule', 'high-risk-write', '删除存储规则', {
+        rule_ids: LIST('规则 ID 列表'),
+    }, ['rule_ids'], { requiresConfirmation: true }),
+    spec('setting-storage', 'rule.enable', 'enable_rule', 'high-risk-write', '启停存储规则', {
+        rule_info_list: LIST('规则信息列表（含 id 和 openStatus）', {
+            type: 'object',
+            properties: {
+                id: ID('规则 ID'),
+                openStatus: BOOL('是否启用'),
+            },
+            required: ['id', 'openStatus'],
+        }),
+    }, ['rule_info_list'], { requiresConfirmation: true }),
+    spec('setting-storage', 'rule.order', 'save_rule_order', 'high-risk-write', '改规则顺序', {
+        rule_ids: LIST('规则 ID 列表（按顺序）'),
+    }, ['rule_ids'], { requiresConfirmation: true }),
+    // ── file-collection ─────────────────────────────────────
+    spec('file-collection', 'task.list', 'list_collection_tasks', 'read', '列出采集任务', {}, [], {
+        method: 'http_template',
+    }),
+    spec('file-collection', 'task.form', 'get_collection_task_form', 'read', '获取采集任务表单', {
+        id: ID('任务 ID（可选）'),
+    }),
+    spec('file-collection', 'storage.check', 'check_collection_storage', 'read', '检查存储连接', {}, [], {
+        method: 'http_template',
+    }),
+    spec('file-collection', 'scan', 'scan_collection', 'high-risk-write', '扫描采集任务', {
+        task_id: ID('任务 ID'),
+        full_coll: BOOL('是否全量扫描（默认增量）'),
+    }, ['task_id'], { requiresConfirmation: true }),
+    spec('file-collection', 'scan.progress', 'scan_collection_progress', 'read', '查询扫描进度', {}, [], {
+        method: 'http_template',
+    }),
+    spec('file-collection', 'run', 'run_collection', 'high-risk-write', '运行/暂停采集任务', {
+        task_id: ID('任务 ID'),
+        action: S('操作类型（run/pause）'),
+    }, ['task_id', 'action'], { requiresConfirmation: true }),
+    spec('file-collection', 'run.progress', 'run_collection_progress', 'read', '查询运行进度', {}, [], {
+        method: 'http_template',
+    }),
+    spec('file-collection', 'detail', 'get_collection_detail', 'read', '查询采集详情', {}, [], {
+        method: 'http_template',
+    }),
+    spec('file-collection', 'cancel', 'cancel_collection', 'high-risk-write', '取消采集任务', {
+        task_id: ID('任务 ID'),
+    }, ['task_id'], { requiresConfirmation: true }),
+    spec('file-collection', 'delete', 'delete_collection_task', 'high-risk-write', '删除采集任务', {
+        task_id: ID('任务 ID'),
+    }, ['task_id'], { requiresConfirmation: true }),
+    // ── file-upload ─────────────────────────────────────────
+    spec('file-upload', 'contract', 'get_upload_contract', 'read', '获取上传接口合约', {}, [], {
+        method: 'http_template',
+    }),
+    spec('file-upload', 'prepare', 'prepare_upload', 'read', '准备上传（本地文件校验与元数据）', {
+        file_path: FILE('本地文件绝对路径'),
+        module: S('业务模块（如 document、workflow 等）'),
+    }, ['file_path', 'module']),
+    spec('file-upload', 'upload', 'upload_file', 'high-risk-write', '上传文件到文件服务', {
+        file_path: FILE('本地文件绝对路径'),
+        module: S('业务模块（如 document、workflow 等）'),
+        user_confirmed: BOOL('用户已确认上传'),
+    }, ['file_path', 'module', 'user_confirmed'], { requiresConfirmation: true }),
+    // ── org ─────────────────────────────────────────────────
+    spec('org', 'search-user', 'search_user', 'read', '人员浏览器检索（源 search_user → /api/hrm/common/browser/data/resource）', {
+        keyword: S('检索关键词（按 username 快搜）'),
+        ...pageProps(50),
+    }),
+    spec('org', 'search-department', 'search_department', 'read', '部门浏览器检索（源 search_department）', {
+        keyword: S('检索关键词'),
+        ...pageProps(50),
+    }),
+    spec('org', 'search-subcompany', 'search_subcompany', 'read', '分部/子公司浏览器检索（源 search_subcompany）', {
+        keyword: S('检索关键词'),
+        ...pageProps(50),
+    }),
+    spec('org', 'search-external', 'search_external', 'read', '外部人员浏览器检索（源 search_external）', {
+        keyword: S('检索关键词'),
+        ...pageProps(50),
+    }),
+    spec('org', 'search-position', 'search_position', 'read', '岗位浏览器检索（源 search_position）', {
+        keyword: S('检索关键词'),
+        ...pageProps(50),
+    }),
+    spec('org', 'search-role', 'search_role', 'read', '角色浏览器检索（源 search_role）', {
+        keyword: S('检索关键词'),
+        ...pageProps(50),
+    }),
+    spec('org', 'search-customer', 'search_customer', 'read', 'CRM 客户浏览器检索（源 search_customer）', {
+        keyword: S('检索关键词'),
+        ...pageProps(50),
+    }),
+    spec('org', 'search-customer-type', 'search_customer_type', 'read', 'CRM 客户类型字典检索（源 search_customer_type）', {
+        keyword: S('检索关键词'),
+        ...pageProps(50),
+    }),
+    // ── user ────────────────────────────────────────────────
+    spec('user', 'current', 'fetch_current_user_info', 'read', '获取当前登录人信息（employeeId / employeeName）', {}, [], {
+        method: 'http_template',
+    }),
+    // ── tag ─────────────────────────────────────────────────
+    spec('tag', 'search', 'search_tags', 'read', '检索标签（type=0 公共标签限定 document 模块，type=1 个人标签）', {
+        name: S('标签名称关键词'),
+        type: INT('标签类型：0=公共，1=个人', { enum: [0, 1] }),
+        ...pageProps(50),
+    }, ['type']),
+    spec('tag', 'list', 'fetch_doc_tags', 'read', '查询文档已打标签（公共 + 个人合并）', {
+        doc_id: ID('文档 ID'),
+    }, ['doc_id']),
+    spec('tag', 'add', 'add_doc_tag', 'high-risk-write', '为文档添加标签', {
+        doc_id: ID('文档 ID'),
+        tags: LIST('标签列表，元素形如 {"id":"1","privacy":false} 或 {"name":"xx","privacy":true}', {
+            type: 'object',
+            additionalProperties: true,
+        }),
+    }, ['doc_id', 'tags'], { requiresConfirmation: true }),
+    spec('tag', 'remove', 'remove_doc_tag', 'high-risk-write', '移除文档标签', {
+        doc_id: ID('文档 ID'),
+        tags: LIST('标签列表，元素形如 {"id":"1","privacy":false}', { type: 'object', additionalProperties: true }),
+    }, ['doc_id', 'tags'], { requiresConfirmation: true }),
+    // ── participant ─────────────────────────────────────────
+    spec('participant', 'list', 'fetch_doc_participants', 'read', '查询文档参与人列表', {
+        doc_id: ID('文档 ID'),
+    }, ['doc_id']),
+    spec('participant', 'add', 'add_doc_participant', 'high-risk-write', '添加文档参与人', {
+        doc_id: ID('文档 ID'),
+        user_id: ID('人员 ID'),
+    }, ['doc_id', 'user_id'], { requiresConfirmation: true }),
+    spec('participant', 'remove', 'remove_doc_participant', 'high-risk-write', '移除文档参与人', {
+        share_entry_id: ID('共享条目 ID（来自 participant.list）'),
+        doc_id: ID('文档 ID'),
+    }, ['share_entry_id', 'doc_id'], { requiresConfirmation: true }),
+    // ── share ───────────────────────────────────────────────
+    spec('share', 'form', 'fetch_doc_share_form', 'read', '查询文档共享表单配置（对象类型 + 级联参数）', {
+        doc_id: ID('文档 ID'),
+    }, ['doc_id']),
+    spec('share', 'list', 'fetch_doc_share_list', 'read', '查询文档共享列表（含 download / can_delete）', {
+        doc_id: ID('文档 ID'),
+    }, ['doc_id']),
+    spec('share', 'add', 'add_doc_share', 'high-risk-write', '添加文档共享', {
+        doc_id: ID('文档 ID'),
+        obj_type: S('共享对象类型'),
+        share_level: S('共享级别'),
+        ...SHARE_ID_FIELDS,
+        ...SHARE_OPTION_FIELDS,
+    }, ['doc_id', 'obj_type', 'share_level'], { requiresConfirmation: true }),
+    spec('share', 'delete', 'delete_doc_share', 'high-risk-write', '删除文档共享', {
+        doc_id: ID('文档 ID'),
+        ids: LIST('待删除共享条目 ID 列表'),
+    }, ['doc_id', 'ids'], { requiresConfirmation: true }),
+    // ── attachment ──────────────────────────────────────────
+    spec('attachment', 'upload', 'upload_attachment_to_doc', 'read-with-upload', '向文档上传附件', {
+        file_path: FILE('本地文件路径'),
+        doc_id: ID('文档 ID'),
+        folder_id: ID('文档所属文件夹 ID'),
+    }, ['file_path', 'doc_id'], { requiresConfirmation: true }),
+    spec('attachment', 'replace', 'replace_document_attachment', 'read-with-upload', '替换文档附件（reUpload，保留附件 ID）', {
+        file_path: FILE('本地文件路径'),
+        doc_id: ID('文档 ID'),
+        attachment_id: ID('被替换的附件 ID'),
+        folder_id: ID('文档所属文件夹 ID'),
+    }, ['file_path', 'doc_id', 'attachment_id', 'folder_id'], { requiresConfirmation: true }),
+    spec('attachment', 'download', 'download_doc_attachment', 'local-file-write', '下载文档附件到本地（写本地磁盘，不改服务端）', {
+        attachment_id: ID('附件 ID'),
+        doc_id: ID('文档 ID'),
+        save_path: FILE('保存路径（完整文件路径或目录）'),
+    }, ['attachment_id', 'doc_id']),
+    spec('attachment', 'download-as-pdf', 'download_doc_attachment_to_pdf', 'local-file-write', '下载文档附件的 PDF 转换版本（写本地磁盘）', {
+        attachment_id: ID('附件 ID'),
+        doc_id: ID('文档 ID'),
+        save_path: FILE('保存路径（完整文件路径或目录）'),
+    }, ['attachment_id', 'doc_id']),
+    // ── cover ───────────────────────────────────────────────
+    spec('cover', 'upload', 'upload_cover_image', 'read-with-upload', '上传封面图片，仅返回 file_id（不改文档）', {
+        file_path: FILE('本地图片路径（.png/.jpg/.jpeg/.gif/.webp/.bmp）'),
+    }, ['file_path'], { requiresConfirmation: true }),
+    spec('cover', 'set', 'set_doc_cover', 'read-with-upload', '上传图片并设为文档封面', {
+        doc_id: ID('文档 ID'),
+        file_path: FILE('本地图片路径'),
+    }, ['doc_id', 'file_path'], { requiresConfirmation: true }),
+    spec('cover', 'remove', 'remove_doc_cover', 'high-risk-write', '移除文档封面', {
+        doc_id: ID('文档 ID'),
+    }, ['doc_id'], { requiresConfirmation: true }),
+    // ── compare ─────────────────────────────────────────────
+    spec('compare', 'search-documents', 'search_doc_compare_documents', 'read', '文档比对：检索可比对文档', {
+        name: S('文档名称'),
+        author: S('作者'),
+        creator: S('创建人'),
+        create_time: S('创建时间范围'),
+        folder: S('所属文件夹'),
+        ...pageProps(20),
+    }),
+    spec('compare', 'list-file-objects', 'doc_compare_query_file_objects', 'read', '文档比对：列出文档下可比对的文件对象', {
+        doc_id: ID('文档 ID'),
+    }, ['doc_id']),
+    spec('compare', 'upload-file', 'doc_compare_upload_file', 'read-with-upload', '文档比对：上传本地文件参与比对', {
+        file_path: FILE('本地文件路径'),
+    }, ['file_path'], {
+        requiresConfirmation: true,
+        permissions: PERMISSION_COMPARE_UPLOAD,
+    }),
+    spec('compare', 'submit', 'doc_compare_upload_compared', 'external-artifact', '文档比对：提交左右文件生成比对链接（外部制品）', {
+        left_file_id: ID('左侧文件 ID'),
+        right_file_id: ID('右侧文件 ID'),
+    }, ['left_file_id', 'right_file_id'], { requiresConfirmation: true }),
+    // ── system ──────────────────────────────────────────────
+    spec('system', 'health', 'check_system_health', 'read', '采知连接口连通性与登录态自检', {}),
+];
+export const CAIZHILIAN_SPECS_BY_NAME = new Map(caizhilianOperationSpecs.map((item) => [item.name, item]));