@yanhaidao/wecom 2.4.160 → 2.5.110

package/{src/capability/doc/client.ts → dist/src/capability/doc/client.js}

@@ -1,126 +1,103 @@
-import type { ResolvedAgentAccount } from "../../types/index.js";
 import { getAccessToken } from "../../transport/agent-api/core.js";
 import { wecomFetch } from "../../http.js";
 import { resolveWecomEgressProxyUrlFromNetwork } from "../../config/index.js";
 import { LIMITS } from "../../types/constants.js";
-import {
-    BatchUpdateDocResponse,
-    GetDocContentResponse,
-    Node,
-    UpdateRequest
-} from "./types.js";
-
-function readString(value: unknown): string {
+function readString(value) {
     const trimmed = String(value ?? "").trim();
     return trimmed || "";
 }
-
-function normalizeDocType(docType: unknown): 3 | 4 | 10 {
-    if (docType === 3 || docType === "3") return 3;
-    if (docType === 4 || docType === "4") return 4;
-    if (docType === 10 || docType === "10" || docType === 5 || docType === "5") return 10;
+function normalizeDocType(docType) {
+    if (docType === 3 || docType === "3")
+        return 3;
+    if (docType === 4 || docType === "4")
+        return 4;
+    if (docType === 10 || docType === "10" || docType === 5 || docType === "5")
+        return 10;
     const normalized = readString(docType).toLowerCase();
-    if (!normalized || normalized === "doc") return 3;
-    if (normalized === "spreadsheet" || normalized === "sheet" || normalized === "table") return 4;
-    if (normalized === "smart_table" || normalized === "smarttable") return 10;
+    if (!normalized || normalized === "doc")
+        return 3;
+    if (normalized === "spreadsheet" || normalized === "sheet" || normalized === "table")
+        return 4;
+    if (normalized === "smart_table" || normalized === "smarttable")
+        return 10;
     throw new Error(`Unsupported WeCom docType: ${String(docType)}`);
 }
-
-function mapDocTypeLabel(docType: 3 | 4 | 10): string {
-    if (docType === 10) return "smart_table";
-    if (docType === 4) return "spreadsheet";
+function mapDocTypeLabel(docType) {
+    if (docType === 10)
+        return "smart_table";
+    if (docType === 4)
+        return "spreadsheet";
     return "doc";
 }
-
-function isRecord(value: unknown): value is Record<string, unknown> {
+function isRecord(value) {
     return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-
-function readObject(value: unknown): Record<string, unknown> {
+function readObject(value) {
     return isRecord(value) ? value : {};
 }
-
-function readArray(value: unknown): unknown[] {
+function readArray(value) {
     return Array.isArray(value) ? value : [];
 }
-
-export interface DocMemberEntry {
-    userid?: string;
-    partyid?: string;
-    tagid?: string;
-    /**
-     * 权限位：1-查看，2-编辑，7-管理
-     * 只有“智能表格”才支持读写权限（auth=2）？
-     * 实际上企微文档现在也支持设置协作者权限了。
-     */
-    auth?: number;
-}
-
-function normalizeDocMemberEntry(value: unknown): DocMemberEntry | null {
+function normalizeDocMemberEntry(value) {
     if (typeof value === "string" || typeof value === "number") {
         const userid = readString(value);
         return userid ? { userid } : null;
     }
-    if (!isRecord(value)) return null;
-    const entry: DocMemberEntry = { ...value } as DocMemberEntry;
+    if (!isRecord(value))
+        return null;
+    const entry = { ...value };
     if (!readString(entry.userid) && readString(value.userId)) {
         entry.userid = readString(value.userId);
     }
     if (!readString(entry.userid) && !readString(entry.partyid) && !readString(entry.tagid)) {
         return null;
     }
-    if (readString(entry.userid)) entry.userid = readString(entry.userid);
-    if (readString(entry.partyid)) entry.partyid = readString(entry.partyid);
-    if (readString(entry.tagid)) entry.tagid = readString(entry.tagid);
-    if (entry.auth !== undefined) entry.auth = Number(entry.auth);
+    if (readString(entry.userid))
+        entry.userid = readString(entry.userid);
+    if (readString(entry.partyid))
+        entry.partyid = readString(entry.partyid);
+    if (readString(entry.tagid))
+        entry.tagid = readString(entry.tagid);
+    if (entry.auth !== undefined)
+        entry.auth = Number(entry.auth);
     return entry;
 }
-
-function normalizeDocMemberEntryList(values: unknown): DocMemberEntry[] {
-    return readArray(values).map(normalizeDocMemberEntry).filter((v): v is DocMemberEntry => v !== null);
+function normalizeDocMemberEntryList(values) {
+    return readArray(values).map(normalizeDocMemberEntry).filter((v) => v !== null);
 }
-
-function buildDocMemberAuthRequest(params: {
-    docId: string;
-    viewers?: unknown;
-    collaborators?: unknown;
-    removeViewers?: unknown;
-    removeCollaborators?: unknown;
-    authLevel?: number; // Default auth level for new members if not specified in entry
-}): Record<string, unknown> {
+function buildDocMemberAuthRequest(params) {
     const { docId, viewers, collaborators, removeViewers, removeCollaborators, authLevel } = params;
-    const payload: Record<string, unknown> = {
+    const payload = {
         docid: readString(docId),
     };
-    if (!payload.docid) throw new Error("docId required");
-
+    if (!payload.docid)
+        throw new Error("docId required");
     const normalizedViewers = normalizeDocMemberEntryList(viewers).map(v => ({ ...v, auth: v.auth ?? authLevel ?? 1 }));
     const normalizedCollaborators = normalizeDocMemberEntryList(collaborators).map(v => ({ ...v, auth: v.auth ?? authLevel ?? 2 }));
     const normalizedRemovedViewers = normalizeDocMemberEntryList(removeViewers);
     const normalizedRemovedCollaborators = normalizeDocMemberEntryList(removeCollaborators);
-
-    if (normalizedViewers.length > 0) payload.update_file_member_list = normalizedViewers;
-    if (normalizedCollaborators.length > 0) payload.update_co_auth_list = normalizedCollaborators;
-    if (normalizedRemovedViewers.length > 0) payload.del_file_member_list = normalizedRemovedViewers;
-    if (normalizedRemovedCollaborators.length > 0) payload.del_co_auth_list = normalizedRemovedCollaborators;
-
-    if (
-        !payload.update_doc_member_list &&
+    if (normalizedViewers.length > 0)
+        payload.update_file_member_list = normalizedViewers;
+    if (normalizedCollaborators.length > 0)
+        payload.update_co_auth_list = normalizedCollaborators;
+    if (normalizedRemovedViewers.length > 0)
+        payload.del_file_member_list = normalizedRemovedViewers;
+    if (normalizedRemovedCollaborators.length > 0)
+        payload.del_co_auth_list = normalizedRemovedCollaborators;
+    if (!payload.update_doc_member_list &&
         !payload.update_co_auth_list &&
         !payload.del_doc_member_list &&
-        !payload.del_co_auth_list
-    ) {
+        !payload.del_co_auth_list) {
         throw new Error("at least one viewer/collaborator change is required");
     }
-
     return payload;
 }
-
-async function parseJsonResponse(res: Response, actionLabel: string): Promise<any> {
-    let payload: any = null;
+async function parseJsonResponse(res, actionLabel) {
+    let payload = null;
     try {
         payload = await res.json();
-    } catch {
+    }
+    catch {
         if (!res.ok) {
             throw new Error(`WeCom ${actionLabel} failed: HTTP ${res.status}`);
         }
@@ -135,34 +112,22 @@ async function parseJsonResponse(res: Response, actionLabel: string): Promise<an
     if (Array.isArray(payload)) {
         const failedItem = payload.find((item) => Number(item?.errcode ?? 0) !== 0);
         if (failedItem) {
-            throw new Error(
-                `WeCom ${actionLabel} failed: ${String(failedItem?.errmsg || "unknown error")} (errcode ${String(failedItem?.errcode)})`,
-            );
+            throw new Error(`WeCom ${actionLabel} failed: ${String(failedItem?.errmsg || "unknown error")} (errcode ${String(failedItem?.errcode)})`);
         }
         return payload;
     }
     if (Number(payload.errcode ?? 0) !== 0) {
-        throw new Error(
-            `WeCom ${actionLabel} failed: ${String(payload.errmsg || "unknown error")} (errcode ${String(payload.errcode)})`,
-        );
+        throw new Error(`WeCom ${actionLabel} failed: ${String(payload.errmsg || "unknown error")} (errcode ${String(payload.errcode)})`);
     }
     return payload;
 }
-
 export class WecomDocClient {
-    private async postWecomDocApi(params: {
-        path: string;
-        actionLabel: string;
-        agent: ResolvedAgentAccount;
-        body: Record<string, unknown> | unknown[];
-    }): Promise<any> {
+    async postWecomDocApi(params) {
         const { path, actionLabel, agent, body } = params;
-
         const token = await getAccessToken(agent);
         const url = `https://qyapi.weixin.qq.com${path}?access_token=${encodeURIComponent(token)}`;
         const proxyUrl = resolveWecomEgressProxyUrlFromNetwork(agent.network);
-
-        let lastErr: any;
+        let lastErr;
         for (let attempt = 1; attempt <= 3; attempt++) {
             try {
                 const res = await wecomFetch(url, {
@@ -172,9 +137,9 @@ export class WecomDocClient {
                     },
                     body: JSON.stringify(body ?? {}),
                 }, { proxyUrl, timeoutMs: LIMITS.REQUEST_TIMEOUT_MS });
-
                 return await parseJsonResponse(res, actionLabel);
-            } catch (err) {
+            }
+            catch (err) {
                 lastErr = err;
                 if (attempt < 3) {
                     await new Promise(r => setTimeout(r, 1000));
@@ -183,20 +148,21 @@ export class WecomDocClient {
         }
         throw lastErr;
     }
-
-    async createDoc(params: { agent: ResolvedAgentAccount; docName: string; docType?: unknown; spaceId?: string; fatherId?: string; adminUsers?: string[] }) {
+    async createDoc(params) {
         const { agent, docName, docType, spaceId, fatherId, adminUsers } = params;
         const normalizedDocType = normalizeDocType(docType);
-        const payload: Record<string, unknown> = {
+        const payload = {
             doc_type: normalizedDocType,
             doc_name: readString(docName),
         };
-        if (!payload.doc_name) throw new Error("docName required");
+        if (!payload.doc_name)
+            throw new Error("docName required");
         const normalizedSpaceId = readString(spaceId);
         const normalizedFatherId = readString(fatherId);
-        if (normalizedSpaceId) payload.spaceid = normalizedSpaceId;
-        if (normalizedFatherId) payload.fatherid = normalizedFatherId;
-        
+        if (normalizedSpaceId)
+            payload.spaceid = normalizedSpaceId;
+        if (normalizedFatherId)
+            payload.fatherid = normalizedFatherId;
         // admin_users is required for smart_table to ensure proper permissions
         const normalizedAdminUsers = Array.isArray(adminUsers)
             ? adminUsers.map((item) => readString(item)).filter(Boolean)
@@ -204,14 +170,12 @@ export class WecomDocClient {
         if (normalizedAdminUsers.length > 0) {
             payload.admin_users = normalizedAdminUsers;
         }
-        
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/create_doc",
             actionLabel: "create_doc",
             agent,
             body: payload,
         });
-        
         const result = {
             raw: json,
             docId: readString(json.docid),
@@ -219,15 +183,12 @@ export class WecomDocClient {
             docType: normalizedDocType,
             docTypeLabel: mapDocTypeLabel(normalizedDocType),
         };
-        
         // Auto-initialize smart_table: clean up default fields and records
         if (normalizedDocType === 10) {
             await this.initializeSmartTable({ agent, docId: result.docId });
         }
-        
         return result;
     }
-
     /**
      * Initialize smart_table after creation:
      * 1. Get default sheet (smartsheet type)
@@ -236,21 +197,18 @@ export class WecomDocClient {
      * 4. Get default records (usually 5 empty records)
      * 5. Delete all default records
      */
-    private async initializeSmartTable(params: { agent: ResolvedAgentAccount; docId: string }) {
+    async initializeSmartTable(params) {
         const { agent, docId } = params;
-        
         try {
             // Step 1: Get sheet list to find the default smartsheet
             const sheetsResult = await this.smartTableGetSheets({ agent, docId });
-            const defaultSheet = sheetsResult.sheets.find((s: any) => s.type === "smartsheet");
-            if (!defaultSheet) return; // No smartsheet found, skip initialization
-            
-            const sheetId = (defaultSheet as any).sheet_id;
-            
+            const defaultSheet = sheetsResult.sheets.find((s) => s.type === "smartsheet");
+            if (!defaultSheet)
+                return; // No smartsheet found, skip initialization
+            const sheetId = defaultSheet.sheet_id;
             // Step 2: Get default fields
             const fieldsResult = await this.smartTableGetFields({ agent, docId, sheetId });
             const fields = fieldsResult.fields || [];
-            
             if (fields.length > 1) {
                 // Keep the last field as primary key, delete the rest
                 // Primary key capable types: TEXT, NUMBER, DATE_TIME, URL, PROGRESS, EMAIL, PHONE_NUMBER, FORMULA, LOCATION, CURRENCY, AUTONUMBER, TITLE, WWGROUP
@@ -260,58 +218,55 @@ export class WecomDocClient {
                     'FIELD_TYPE_PHONE_NUMBER', 'FIELD_TYPE_LOCATION', 'FIELD_TYPE_CURRENCY',
                     'FIELD_TYPE_AUTONUMBER', 'FIELD_TYPE_WWGROUP'
                 ];
-                
                 // Find a field that can be primary key (prefer the last one)
-                let fieldToDelete: string[] = [];
-                let fieldToKeep: string | null = null;
-                
+                let fieldToDelete = [];
+                let fieldToKeep = null;
                 for (let i = fields.length - 1; i >= 0; i--) {
-                    const field = fields[i] as any;
+                    const field = fields[i];
                     if (!fieldToKeep && primaryKeyCapableTypes.includes(field.field_type)) {
                         fieldToKeep = field.field_id;
-                    } else if (field.field_id) {
+                    }
+                    else if (field.field_id) {
                         fieldToDelete.push(field.field_id);
                     }
                 }
-                
                 // If no primary key capable field found, keep the last one anyway
                 if (!fieldToKeep && fields.length > 0) {
-                    const lastField = fields[fields.length - 1] as any;
+                    const lastField = fields[fields.length - 1];
                     fieldToKeep = lastField.field_id;
-                    fieldToDelete = fields.slice(0, -1).map((f: any) => f.field_id);
+                    fieldToDelete = fields.slice(0, -1).map((f) => f.field_id);
                 }
-                
                 // Delete the fields
                 if (fieldToDelete.length > 0) {
                     await this.smartTableDelFields({ agent, docId, sheetId, field_ids: fieldToDelete });
                 }
             }
-            
             // Step 3: Get default records
             const recordsResult = await this.smartTableGetRecords({ agent, docId, sheetId, limit: 100 });
             const records = recordsResult.records || [];
-            
             if (records.length > 0) {
                 // Delete all default empty records
-                const recordIds = records.map((r: any) => r.record_id).filter(Boolean);
+                const recordIds = records.map((r) => r.record_id).filter(Boolean);
                 if (recordIds.length > 0) {
                     await this.smartTableDelRecords({ agent, docId, sheetId, record_ids: recordIds });
                 }
             }
-        } catch (err) {
+        }
+        catch (err) {
             // Non-fatal: smart_table created, just default cleanup failed
             console.error(`[WecomDocClient] initializeSmartTable failed:`, err);
         }
     }
-
-    async renameDoc(params: { agent: ResolvedAgentAccount; docId: string; newName: string }) {
+    async renameDoc(params) {
         const { agent, docId, newName } = params;
         const payload = {
             docid: readString(docId),
             new_name: readString(newName),
         };
-        if (!payload.docid) throw new Error("docId required");
-        if (!payload.new_name) throw new Error("newName required");
+        if (!payload.docid)
+            throw new Error("docId required");
+        if (!payload.new_name)
+            throw new Error("newName required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/rename_doc",
             actionLabel: "rename_doc",
@@ -324,17 +279,19 @@ export class WecomDocClient {
             newName: payload.new_name,
         };
     }
-
-    async copyDoc(params: { agent: ResolvedAgentAccount; docId: string; newName?: string; spaceId?: string; fatherId?: string }) {
+    async copyDoc(params) {
         const { agent, docId, newName, spaceId, fatherId } = params;
-        const payload: Record<string, unknown> = {
+        const payload = {
             docid: readString(docId),
         };
-        if (!payload.docid) throw new Error("docId required");
-        if (newName) payload.new_name = readString(newName);
-        if (spaceId) payload.spaceid = readString(spaceId);
-        if (fatherId) payload.fatherid = readString(fatherId);
-
+        if (!payload.docid)
+            throw new Error("docId required");
+        if (newName)
+            payload.new_name = readString(newName);
+        if (spaceId)
+            payload.spaceid = readString(spaceId);
+        if (fatherId)
+            payload.fatherid = readString(fatherId);
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/copy",
             actionLabel: "copy_smartsheet",
@@ -347,11 +304,11 @@ export class WecomDocClient {
             url: readString(json.url),
         };
     }
-
-    async getDocBaseInfo(params: { agent: ResolvedAgentAccount; docId: string }) {
+    async getDocBaseInfo(params) {
         const { agent, docId } = params;
         const normalizedDocId = readString(docId);
-        if (!normalizedDocId) throw new Error("docId required");
+        if (!normalizedDocId)
+            throw new Error("docId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/get_doc_base_info",
             actionLabel: "get_doc_base_info",
@@ -363,11 +320,11 @@ export class WecomDocClient {
             info: json.doc_base_info && typeof json.doc_base_info === "object" ? json.doc_base_info : {},
         };
     }
-
-    async shareDoc(params: { agent: ResolvedAgentAccount; docId: string }) {
+    async shareDoc(params) {
         const { agent, docId } = params;
         const normalizedDocId = readString(docId);
-        if (!normalizedDocId) throw new Error("docId required");
+        if (!normalizedDocId)
+            throw new Error("docId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/doc_share",
             actionLabel: "doc_share",
@@ -379,11 +336,11 @@ export class WecomDocClient {
             shareUrl: readString(json.share_url),
         };
     }
-
-    async getDocAuth(params: { agent: ResolvedAgentAccount; docId: string }) {
+    async getDocAuth(params) {
         const { agent, docId } = params;
         const normalizedDocId = readString(docId);
-        if (!normalizedDocId) throw new Error("docId required");
+        if (!normalizedDocId)
+            throw new Error("docId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/doc_get_auth",
             actionLabel: "doc_get_auth",
@@ -398,14 +355,15 @@ export class WecomDocClient {
             coAuthList: Array.isArray(json.co_auth_list) ? json.co_auth_list : [],
         };
     }
-
-    async deleteDoc(params: { agent: ResolvedAgentAccount; docId?: string; formId?: string }) {
+    async deleteDoc(params) {
         const { agent, docId, formId } = params;
-        const payload: Record<string, string> = {};
+        const payload = {};
         const normalizedDocId = readString(docId);
         const normalizedFormId = readString(formId);
-        if (normalizedDocId) payload.docid = normalizedDocId;
-        if (normalizedFormId) payload.formid = normalizedFormId;
+        if (normalizedDocId)
+            payload.docid = normalizedDocId;
+        if (normalizedFormId)
+            payload.formid = normalizedFormId;
         if (!payload.docid && !payload.formid) {
             throw new Error("docId or formId required");
         }
@@ -421,14 +379,14 @@ export class WecomDocClient {
             formId: payload.formid || "",
         };
     }
-
-    async setDocJoinRule(params: { agent: ResolvedAgentAccount; docId: string; request: any }) {
+    async setDocJoinRule(params) {
         const { agent, docId, request } = params;
         const payload = {
             ...readObject(request),
         };
         payload.docid = readString(docId || payload.docid);
-        if (!payload.docid) throw new Error("docId required");
+        if (!payload.docid)
+            throw new Error("docId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/mod_doc_join_rule",
             actionLabel: "mod_doc_join_rule",
@@ -437,17 +395,17 @@ export class WecomDocClient {
         });
         return {
             raw: json,
-            docId: payload.docid as string,
+            docId: payload.docid,
         };
     }
-
-    async setDocMemberAuth(params: { agent: ResolvedAgentAccount; docId: string; request: any }) {
+    async setDocMemberAuth(params) {
         const { agent, docId, request } = params;
         const payload = {
             ...readObject(request),
         };
         payload.docid = readString(docId || payload.docid);
-        if (!payload.docid) throw new Error("docId required");
+        if (!payload.docid)
+            throw new Error("docId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/mod_doc_member",
             actionLabel: "mod_doc_member",
@@ -456,21 +414,11 @@ export class WecomDocClient {
         });
         return {
             raw: json,
-            docId: payload.docid as string,
+            docId: payload.docid,
         };
     }
-
-    async grantDocAccess(params: {
-        agent: ResolvedAgentAccount;
-        docId: string;
-        viewers?: unknown;
-        collaborators?: unknown;
-        removeViewers?: unknown;
-        removeCollaborators?: unknown;
-        authLevel?: number;
-    }) {
+    async grantDocAccess(params) {
         const { agent, docId, viewers, collaborators, removeViewers, removeCollaborators, authLevel } = params;
-        
         // Auto-detect: if adding collaborators, check if they are already viewers and need to be removed
         // This prevents the "user is viewer but not collaborator" issue
         let finalRemoveViewers = removeViewers;
@@ -479,32 +427,29 @@ export class WecomDocClient {
             try {
                 const currentAuth = await this.getDocAuth({ agent, docId });
                 // Build a map of viewer entries with their full structure (preserving type and other fields)
-                const viewerMap = new Map<string, any>();
+                const viewerMap = new Map();
                 (currentAuth.docMembers || [])
-                    .filter((m: any) => m.userid)
-                    .forEach((m: any) => viewerMap.set(m.userid, m));
-                
+                    .filter((m) => m.userid)
+                    .forEach((m) => viewerMap.set(m.userid, m));
                 // Normalize new collaborators to get their userids
                 const newCollaboratorEntries = normalizeDocMemberEntryList(collaborators);
-                
                 // Auto-add viewers who are being promoted to collaborators, preserving their original structure
                 const autoRemoveViewers = newCollaboratorEntries
                     .filter(entry => entry.userid && viewerMap.has(entry.userid))
                     .map(entry => {
-                        // Preserve the original viewer's full structure (type, userid, etc.)
-                        const originalViewer = viewerMap.get(entry.userid!);
-                        return { ...originalViewer };
-                    });
-                
+                    // Preserve the original viewer's full structure (type, userid, etc.)
+                    const originalViewer = viewerMap.get(entry.userid);
+                    return { ...originalViewer };
+                });
                 if (autoRemoveViewers.length > 0) {
                     finalRemoveViewers = autoRemoveViewers;
                 }
-            } catch (err) {
+            }
+            catch (err) {
                 // If we can't check auth, proceed without auto-removal
                 // The caller can explicitly pass removeViewers if needed
             }
         }
-        
         const payload = buildDocMemberAuthRequest({
             docId,
             viewers,
@@ -515,19 +460,18 @@ export class WecomDocClient {
         });
         const result = await this.setDocMemberAuth({
             agent,
-            docId: payload.docid as string,
+            docId: payload.docid,
             request: payload,
         });
         return {
             ...result,
-            addedViewerCount: (payload.update_file_member_list as any[])?.length ?? 0,
-            addedCollaboratorCount: (payload.update_co_auth_list as any[])?.length ?? 0,
-            removedViewerCount: (payload.del_file_member_list as any[])?.length ?? 0,
-            removedCollaboratorCount: (payload.del_co_auth_list as any[])?.length ?? 0,
+            addedViewerCount: payload.update_file_member_list?.length ?? 0,
+            addedCollaboratorCount: payload.update_co_auth_list?.length ?? 0,
+            removedViewerCount: payload.del_file_member_list?.length ?? 0,
+            removedCollaboratorCount: payload.del_co_auth_list?.length ?? 0,
         };
     }
-
-    async addDocCollaborators(params: { agent: ResolvedAgentAccount; docId: string; collaborators: unknown; auth?: number }) {
+    async addDocCollaborators(params) {
         const { agent, docId, collaborators, auth } = params;
         return this.grantDocAccess({
             agent,
@@ -536,14 +480,14 @@ export class WecomDocClient {
             authLevel: auth ?? 2, // Default to edit/read-write for collaborators
         });
     }
-
-    async setDocSafetySetting(params: { agent: ResolvedAgentAccount; docId: string; request: any }) {
+    async setDocSafetySetting(params) {
         const { agent, docId, request } = params;
         const payload = {
             ...readObject(request),
         };
         payload.docid = readString(docId || payload.docid);
-        if (!payload.docid) throw new Error("docId required");
+        if (!payload.docid)
+            throw new Error("docId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/mod_doc_safty_setting",
             actionLabel: "mod_doc_safty_setting",
@@ -552,45 +496,40 @@ export class WecomDocClient {
         });
         return {
             raw: json,
-            docId: payload.docid as string,
+            docId: payload.docid,
         };
     }
-
-    async createCollect(params: { agent: ResolvedAgentAccount; formInfo: any; spaceId?: string; fatherId?: string }) {
+    async createCollect(params) {
         const { agent, formInfo, spaceId, fatherId } = params;
-        
         // Validate form_info structure per API spec
         if (!formInfo || typeof formInfo !== 'object') {
             throw new Error("formInfo 必须是非空对象");
         }
-        
         // Validate required fields
         if (!formInfo.form_title || readString(formInfo.form_title).length === 0) {
             throw new Error("form_title 必填");
         }
-        
         if (!formInfo.form_question || !formInfo.form_question.items || !Array.isArray(formInfo.form_question.items)) {
             throw new Error("form_question.items 必填且必须为数组");
         }
-        
         // Validate questions count ≤ 200
         const questions = formInfo.form_question.items;
         if (questions.length > 200) {
             throw new Error("问题数量不能超过 200 个");
         }
-        
         // Auto-fill status fields for questions and options
-        questions.forEach((q: any) => {
-            if (q.status === undefined) q.status = 1;
+        questions.forEach((q) => {
+            if (q.status === undefined)
+                q.status = 1;
             if (Array.isArray(q.option_item)) {
-                q.option_item.forEach((opt: any) => {
-                    if (opt.status === undefined) opt.status = 1;
+                q.option_item.forEach((opt) => {
+                    if (opt.status === undefined)
+                        opt.status = 1;
                 });
             }
         });
-        
         // Validate each question
-        questions.forEach((q: any, index: number) => {
+        questions.forEach((q, index) => {
             if (!q.question_id || !Number.isInteger(q.question_id) || q.question_id < 1) {
                 throw new Error(`第${index + 1}个问题：question_id 必填且必须从 1 开始`);
             }
@@ -609,7 +548,6 @@ export class WecomDocClient {
             if (q.status !== undefined && ![1, 2].includes(q.status)) {
                 throw new Error(`第${index + 1}个问题：status 必须为 1(正常) 或 2(删除)`);
             }
-            
             // Validate option_item for single/multiple/dropdown questions
             const requiresOptions = [2, 3, 15].includes(q.reply_type); // 单选/多选/下拉列表
             if (requiresOptions) {
@@ -617,7 +555,7 @@ export class WecomDocClient {
                     throw new Error(`第${index + 1}个问题：单选/多选/下拉列表必须提供 option_item 数组`);
                 }
                 // Validate option keys are sequential from 1
-                q.option_item.forEach((opt: any, optIndex: number) => {
+                q.option_item.forEach((opt, optIndex) => {
                     if (!opt.key || !Number.isInteger(opt.key) || opt.key < 1) {
                         throw new Error(`第${index + 1}个问题的第${optIndex + 1}个选项：key 必填且从 1 开始`);
                     }
@@ -629,7 +567,6 @@ export class WecomDocClient {
                     }
                 });
             }
-            
             // Validate image/file upload limits
             if ([9, 10].includes(q.reply_type)) { // 图片/文件
                 const setting = q.question_extend_setting;
@@ -646,22 +583,19 @@ export class WecomDocClient {
                 }
             }
         });
-        
         // Validate timed_repeat_info and timed_finish are mutually exclusive
         const formSetting = formInfo.form_setting || {};
         if (formSetting.timed_repeat_info?.enable && formSetting.timed_finish) {
             console.warn("警告：timed_finish 与 timed_repeat_info 互斥，若都填优先定时重复");
         }
-        
         // Validate timed_repeat_info.enable=true requires fill_in_range
         if (formSetting.timed_repeat_info?.enable) {
             if (!formSetting.fill_in_range || (!formSetting.fill_in_range.userids?.length && !formSetting.fill_in_range.departmentids?.length)) {
                 throw new Error("timed_repeat_info 开启时，fill_in_range 必填（需指定 userids 或 departmentids）");
             }
         }
-        
         // Build payload
-        const payload: Record<string, unknown> = {
+        const payload = {
             form_info: {
                 form_title: readString(formInfo.form_title),
                 form_desc: formInfo.form_desc ? readString(formInfo.form_desc) : undefined,
@@ -670,12 +604,12 @@ export class WecomDocClient {
                 form_setting: formSetting,
             },
         };
-        
         const normalizedSpaceId = readString(spaceId);
         const normalizedFatherId = readString(fatherId);
-        if (normalizedSpaceId) payload.spaceid = normalizedSpaceId;
-        if (normalizedFatherId) payload.fatherid = normalizedFatherId;
-        
+        if (normalizedSpaceId)
+            payload.spaceid = normalizedSpaceId;
+        if (normalizedFatherId)
+            payload.fatherid = normalizedFatherId;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/create_form",
             actionLabel: "create_form",
@@ -685,52 +619,47 @@ export class WecomDocClient {
         return {
             raw: json,
             formId: readString(json.formid),
-            title: readString((payload.form_info as any).form_title),
+            title: readString(payload.form_info.form_title),
         };
     }
-
-    async modifyCollect(params: { agent: ResolvedAgentAccount; oper: string; formId: string; formInfo: any }) {
+    async modifyCollect(params) {
         const { agent, oper, formId, formInfo } = params;
-        
         // Validate oper parameter
         const operNum = Number(oper);
         if (!operNum || ![1, 2].includes(operNum)) {
             throw new Error("oper 必填且必须为 1 或 2：1=全量修改问题，2=全量修改设置");
         }
-        
         const normalizedFormId = readString(formId);
-        if (!normalizedFormId) throw new Error("formId required");
-        
+        if (!normalizedFormId)
+            throw new Error("formId required");
         // Build payload based on oper type
-        const payload: Record<string, unknown> = {
+        const payload = {
             oper: operNum,
             formid: normalizedFormId,
         };
-        
         if (operNum === 1) {
             // 全量修改问题：必须提供完整的 form_question 数组
             if (!formInfo || !formInfo.form_question || !Array.isArray(formInfo.form_question.items)) {
                 throw new Error("oper=1 时，必须提供 form_question.items 数组（包含所有问题，缺失的问题将被删除）");
             }
-            
             // Validate questions count ≤ 200
             const questions = formInfo.form_question.items;
             if (questions.length > 200) {
                 throw new Error("问题数量不能超过 200 个");
             }
-            
             // Auto-fill status fields for questions and options
-            questions.forEach((q: any) => {
-                if (q.status === undefined) q.status = 1;
+            questions.forEach((q) => {
+                if (q.status === undefined)
+                    q.status = 1;
                 if (Array.isArray(q.option_item)) {
-                    q.option_item.forEach((opt: any) => {
-                        if (opt.status === undefined) opt.status = 1;
+                    q.option_item.forEach((opt) => {
+                        if (opt.status === undefined)
+                            opt.status = 1;
                     });
                 }
             });
-            
             // Validate each question (same as createCollect)
-            questions.forEach((q: any, index: number) => {
+            questions.forEach((q, index) => {
                 if (!q.question_id || !Number.isInteger(q.question_id) || q.question_id < 1) {
                     throw new Error(`第${index + 1}个问题：question_id 必填且必须从 1 开始`);
                 }
@@ -746,14 +675,13 @@ export class WecomDocClient {
                 if (q.must_reply === undefined || typeof q.must_reply !== 'boolean') {
                     throw new Error(`第${index + 1}个问题：must_reply 必填且必须为布尔值`);
                 }
-                
                 // Validate option_item for single/multiple/dropdown questions
                 const requiresOptions = [2, 3, 15].includes(q.reply_type);
                 if (requiresOptions) {
                     if (!Array.isArray(q.option_item) || q.option_item.length === 0) {
                         throw new Error(`第${index + 1}个问题：单选/多选/下拉列表必须提供 option_item 数组`);
                     }
-                    q.option_item.forEach((opt: any, optIndex: number) => {
+                    q.option_item.forEach((opt, optIndex) => {
                         if (!opt.key || !Number.isInteger(opt.key) || opt.key < 1) {
                             throw new Error(`第${index + 1}个问题的第${optIndex + 1}个选项：key 必填且从 1 开始`);
                         }
@@ -763,24 +691,20 @@ export class WecomDocClient {
                     });
                 }
             });
-            
             payload.form_info = { form_question: formInfo.form_question };
-            
-        } else if (operNum === 2) {
+        }
+        else if (operNum === 2) {
             // 全量修改设置：必须提供完整的 form_setting 对象
             if (!formInfo || !formInfo.form_setting || typeof formInfo.form_setting !== 'object') {
                 throw new Error("oper=2 时，必须提供 form_setting 对象（缺失的设置项将被重置为默认值）");
             }
-            
             // Validate timed_repeat_info and timed_finish are mutually exclusive
             const formSetting = formInfo.form_setting;
             if (formSetting.timed_repeat_info?.enable && formSetting.timed_finish) {
                 console.warn("警告：timed_finish 与 timed_repeat_info 互斥，若都填优先定时重复");
             }
-            
             payload.form_info = { form_setting: formSetting };
         }
-        
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/modify_form",
             actionLabel: "modify_form",
@@ -789,16 +713,16 @@ export class WecomDocClient {
         });
         return {
             raw: json,
-            formId: payload.formid as string,
-            oper: payload.oper as string,
+            formId: payload.formid,
+            oper: payload.oper,
             title: formInfo?.form_title ? readString(formInfo.form_title) : undefined,
         };
     }
-
-    async getFormInfo(params: { agent: ResolvedAgentAccount; formId: string }) {
+    async getFormInfo(params) {
         const { agent, formId } = params;
         const normalizedFormId = readString(formId);
-        if (!normalizedFormId) throw new Error("formId required");
+        if (!normalizedFormId)
+            throw new Error("formId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/get_form_info",
             actionLabel: "get_form_info",
@@ -810,23 +734,21 @@ export class WecomDocClient {
             formInfo: readObject(json.form_info),
         };
     }
-
-    async getFormAnswer(params: { agent: ResolvedAgentAccount; repeatedId: string; answerIds?: unknown[] }) {
+    async getFormAnswer(params) {
         const { agent, repeatedId, answerIds } = params;
         const normalizedRepeatedId = readString(repeatedId);
-        if (!normalizedRepeatedId) throw new Error("repeatedId required");
+        if (!normalizedRepeatedId)
+            throw new Error("repeatedId required");
         const normalizedAnswerIds = Array.isArray(answerIds)
             ? answerIds
                 .map((item) => Number(item))
                 .filter((item) => Number.isFinite(item))
             : [];
-        
         // Official API limit: ≤100 answer IDs
         if (normalizedAnswerIds.length > 100) {
             throw new Error(`answer_ids 不能超过 100 个，当前：${normalizedAnswerIds.length}`);
         }
-        
-        const payload: Record<string, unknown> = {
+        const payload = {
             repeated_id: normalizedRepeatedId,
         };
         if (normalizedAnswerIds.length > 0) {
@@ -842,11 +764,10 @@ export class WecomDocClient {
         return {
             raw: json,
             answer,
-            answerList: readArray((answer as any).answer_list),
+            answerList: readArray(answer.answer_list),
         };
     }
-
-    async getFormStatistic(params: { agent: ResolvedAgentAccount; requests: unknown[] }) {
+    async getFormStatistic(params) {
         const { agent, requests } = params;
         const payload = Array.isArray(requests)
             ? requests.map((item) => readObject(item)).filter((item) => Object.keys(item).length > 0)
@@ -854,11 +775,9 @@ export class WecomDocClient {
         if (payload.length === 0) {
             throw new Error("requests required");
         }
-        
         // Validate each request per official API
-        payload.forEach((req: any, index: number) => {
+        payload.forEach((req, index) => {
             const reqType = Number(req.req_type);
-            
             // req_type=2: Get submitted list - requires start_time and end_time (same day timestamps)
             if (reqType === 2) {
                 if (!req.start_time || !req.end_time) {
@@ -873,13 +792,11 @@ export class WecomDocClient {
                     throw new Error(`第${index + 1}个请求：end_time 必须大于等于 start_time`);
                 }
             }
-            
             // Validate repeated_id is present
             if (!req.repeated_id) {
                 throw new Error(`第${index + 1}个请求：repeated_id 必填`);
             }
         });
-        
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/get_form_statistic",
             actionLabel: "get_form_statistic",
@@ -890,21 +807,18 @@ export class WecomDocClient {
         return {
             raw: json,
             items: statisticList,
-            successCount: statisticList.filter((item: any) => Number(item?.errcode ?? 0) === 0).length,
+            successCount: statisticList.filter((item) => Number(item?.errcode ?? 0) === 0).length,
         };
     }
-
     // --- Content Operations (New) ---
-
-    async getDocContent(params: { agent: ResolvedAgentAccount; docId: string }) {
+    async getDocContent(params) {
         const { agent, docId } = params;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/document/get",
             actionLabel: "get_doc_content",
             agent,
             body: { docid: readString(docId) },
-        }) as GetDocContentResponse;
-        
+        });
         // Ensure structure strictly matches official API: { version: number, document: Node }
         return {
             raw: json,
@@ -912,16 +826,13 @@ export class WecomDocClient {
             document: json.document
         };
     }
-
-    async updateDocContent(params: { agent: ResolvedAgentAccount; docId: string; requests: UpdateRequest[]; version?: number; batchMode?: boolean }) {
+    async updateDocContent(params) {
         const { agent, docId, requests, version } = params;
-        
         // Validate requests structure basic check
         const requestList = readArray(requests);
         if (requestList.length === 0) {
-             throw new Error("requests list cannot be empty");
+            throw new Error("requests list cannot be empty");
         }
-        
         // Validate version difference (≤100 per official API)
         if (version !== undefined && version !== null) {
             const currentContent = await this.getDocContent({ agent, docId });
@@ -930,9 +841,8 @@ export class WecomDocClient {
                 throw new Error(`version 与最新版本差值不能超过 100（当前版本：${currentContent.version}，传入版本：${version}，差值：${versionDiff}）`);
             }
         }
-        
         // Validate each request's ranges count (≤10 per official API)
-        requestList.forEach((req: any, index: number) => {
+        requestList.forEach((req, index) => {
             if (req.replace_text?.ranges && req.replace_text.ranges.length > 10) {
                 throw new Error(`第${index + 1}个操作：replace_text.ranges 不能超过 10 个`);
             }
@@ -942,70 +852,65 @@ export class WecomDocClient {
             // Validate insert_table limits
             if (req.insert_table) {
                 const { rows, cols } = req.insert_table;
-                if (rows > 100) throw new Error(`第${index + 1}个操作：insert_table 行数不能超过 100`);
-                if (cols > 60) throw new Error(`第${index + 1}个操作：insert_table 列数不能超过 60`);
-                if (rows * cols > 1000) throw new Error(`第${index + 1}个操作：insert_table 单元格总数不能超过 1000`);
+                if (rows > 100)
+                    throw new Error(`第${index + 1}个操作：insert_table 行数不能超过 100`);
+                if (cols > 60)
+                    throw new Error(`第${index + 1}个操作：insert_table 列数不能超过 60`);
+                if (rows * cols > 1000)
+                    throw new Error(`第${index + 1}个操作：insert_table 单元格总数不能超过 1000`);
             }
         });
-
         // Official API limit: ≤30 operations per batch
         const MAX_OPERATIONS = 30;
         if (requestList.length <= MAX_OPERATIONS) {
             // Single batch
-            const body: Record<string, unknown> = {
+            const body = {
                 docid: readString(docId),
                 requests: requestList,
             };
             if (version !== undefined && version !== null) {
                 body.version = Number(version);
             }
-            
             const json = await this.postWecomDocApi({
                 path: "/cgi-bin/wedoc/document/batch_update",
                 actionLabel: "update_doc_content",
                 agent,
                 body,
-            }) as BatchUpdateDocResponse;
+            });
             return { raw: json, batches: 1 };
         }
-        
         // Auto-batch: split into multiple requests
         // Note: Each batch updates the version, so we need to get latest version for each batch
-        const batches: BatchUpdateDocResponse[] = [];
+        const batches = [];
         for (let i = 0; i < requestList.length; i += MAX_OPERATIONS) {
             const batchRequests = requestList.slice(i, i + MAX_OPERATIONS);
-            
             // Get latest version before each batch (except first if version provided)
             let currentVersion = version;
             if (i > 0 || currentVersion === undefined || currentVersion === null) {
                 const content = await this.getDocContent({ agent, docId });
                 currentVersion = content.version;
             }
-            
-            const body: Record<string, unknown> = {
+            const body = {
                 docid: readString(docId),
                 requests: batchRequests,
                 version: currentVersion,
             };
-            
             const json = await this.postWecomDocApi({
                 path: "/cgi-bin/wedoc/document/batch_update",
                 actionLabel: `update_doc_content_batch_${Math.floor(i / MAX_OPERATIONS) + 1}`,
                 agent,
                 body,
-            }) as BatchUpdateDocResponse;
+            });
             batches.push(json);
         }
-        
         return { raw: batches[batches.length - 1], batches: batches.length, allBatches: batches };
     }
-
     // --- Spreadsheet Operations ---
-
-    async getSheetProperties(params: { agent: ResolvedAgentAccount; docId: string }) {
+    async getSheetProperties(params) {
         const { agent, docId } = params;
         const normalizedDocId = readString(docId);
-        if (!normalizedDocId) throw new Error("docId required");
+        if (!normalizedDocId)
+            throw new Error("docId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/spreadsheet/get_sheet_properties",
             actionLabel: "get_sheet_properties",
@@ -1014,15 +919,13 @@ export class WecomDocClient {
         });
         return {
             raw: json,
-            properties:
-                (Array.isArray(json.properties) && json.properties) ||
+            properties: (Array.isArray(json.properties) && json.properties) ||
                 (Array.isArray(json.sheet_properties) && json.sheet_properties) ||
                 (Array.isArray(json.sheet_list) && json.sheet_list) ||
                 [],
         };
     }
-
-    async modDocMemberNotifiedScope(params: { agent: ResolvedAgentAccount; docId: string; notified_scope_type: number; notified_member_list?: any[] }) {
+    async modDocMemberNotifiedScope(params) {
         const { agent, docId, notified_scope_type, notified_member_list } = params;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/mod_doc_member_notified_scope",
@@ -1032,106 +935,88 @@ export class WecomDocClient {
         });
         return json;
     }
-
-    async editSheetData(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string;
-        startRow?: number;
-        startColumn?: number;
-        gridData?: any;
-        requests?: any[];  // For direct batch_update with multiple operations
-    }) {
+    async editSheetData(params) {
         const { agent, docId, sheetId, startRow = 0, startColumn = 0, gridData, requests } = params;
-        
         // Validate required docId
         const normalizedDocId = readString(docId);
         if (!normalizedDocId) {
             throw new Error('docId is required');
         }
-        
         // Validate required sheetId
         const normalizedSheetId = readString(sheetId);
         if (!normalizedSheetId) {
             throw new Error('sheetId is required');
         }
-        
         // Handle direct requests (for multiple operations)
         if (requests && requests.length > 0) {
             // Official API limit: ≤5 operations per batch
             const MAX_OPERATIONS = 5;
-            
             // Validate each request
-            requests.forEach((req: any, index: number) => {
+            requests.forEach((req, index) => {
                 if (req.update_range_request?.grid_data?.rows) {
                     const rows = req.update_range_request.grid_data.rows;
                     const rowCount = rows.length;
-                    const rowWidths = rows.map((row: any) => row.values?.length || 0);
+                    const rowWidths = rows.map((row) => row.values?.length || 0);
                     const columnCount = rowWidths.length > 0 ? Math.max(...rowWidths) : 0;
-                    const totalCells = rowWidths.reduce((sum: number, width: number) => sum + width, 0);
-                    
-                    if (rowCount > 1000) throw new Error(`第${index + 1}个操作：行数不能超过 1000`);
-                    if (columnCount > 200) throw new Error(`第${index + 1}个操作：列数不能超过 200`);
-                    if (totalCells > 10000) throw new Error(`第${index + 1}个操作：单元格总数不能超过 10000`);
+                    const totalCells = rowWidths.reduce((sum, width) => sum + width, 0);
+                    if (rowCount > 1000)
+                        throw new Error(`第${index + 1}个操作：行数不能超过 1000`);
+                    if (columnCount > 200)
+                        throw new Error(`第${index + 1}个操作：列数不能超过 200`);
+                    if (totalCells > 10000)
+                        throw new Error(`第${index + 1}个操作：单元格总数不能超过 10000`);
                 }
             });
-            
             if (requests.length > MAX_OPERATIONS) {
                 throw new Error(`单次批量更新最多${MAX_OPERATIONS}个操作，当前：${requests.length}`);
             }
-            
             const body = {
                 docid: normalizedDocId,
                 requests: requests
             };
-            
             const json = await this.postWecomDocApi({
                 path: "/cgi-bin/wedoc/spreadsheet/batch_update",
                 actionLabel: "spreadsheet_batch_update",
                 agent, body,
             });
-            return { 
-                raw: json, 
+            return {
+                raw: json,
                 docId: normalizedDocId,
                 operations: requests.length
             };
         }
-        
         // Handle single gridData update
         if (!gridData) {
             throw new Error('gridData or requests is required');
         }
-        
         // Build GridData per official API
         // gridData.rows[i].values[j] must be: {cell_value: {text} | {link: {text, url}}, cell_format?: {...}}
-        const rows = (gridData.rows || []).map((row: any) => ({
-            values: (row.values || []).map((cell: any) => {
+        const rows = (gridData.rows || []).map((row) => ({
+            values: (row.values || []).map((cell) => {
                 // If already CellData format, use as-is
                 if (cell && typeof cell === 'object' && cell.cell_value) {
                     return cell;
                 }
                 // Support link simplified format: { url: '...', text: '...' }
                 if (cell && typeof cell === 'object' && cell.url) {
-                    return { 
-                        cell_value: { 
-                            link: { 
-                                url: String(cell.url), 
-                                text: String(cell.text ?? cell.url) 
-                            } 
-                        } 
+                    return {
+                        cell_value: {
+                            link: {
+                                url: String(cell.url),
+                                text: String(cell.text ?? cell.url)
+                            }
+                        }
                     };
                 }
                 // Otherwise wrap primitive as CellValue with text
                 return { cell_value: { text: String(cell ?? '') } };
             })
         }));
-        
         // Validate range limits per API spec
         const rowCount = rows.length;
-        const rowWidths = rows.map((row: any) => row.values?.length || 0);
+        const rowWidths = rows.map((row) => row.values?.length || 0);
         const columnCount = rowWidths.length > 0 ? Math.max(...rowWidths) : 0;
-        const totalCells = rowWidths.reduce((sum: number, width: number) => sum + width, 0);
-        
+        const totalCells = rowWidths.reduce((sum, width) => sum + width, 0);
         if (rowCount > 1000) {
             throw new Error(`行数不能超过 1000，当前：${rowCount}`);
         }
@@ -1141,42 +1026,37 @@ export class WecomDocClient {
         if (totalCells > 10000) {
             throw new Error(`单元格总数不能超过 10000，当前：${totalCells}`);
         }
-        
         const finalGridData = {
             start_row: startRow,
             start_column: startColumn,
             rows: rows
         };
-        
         // Build batch_update request per official API (single operation)
         const body = {
             docid: normalizedDocId,
             requests: [{
-                update_range_request: {
-                    sheet_id: normalizedSheetId,
-                    grid_data: finalGridData
-                }
-            }]
+                    update_range_request: {
+                        sheet_id: normalizedSheetId,
+                        grid_data: finalGridData
+                    }
+                }]
         };
-        
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/spreadsheet/batch_update",
             actionLabel: "spreadsheet_batch_update",
             agent, body,
         });
-        return { 
-            raw: json, 
+        return {
+            raw: json,
             docId: normalizedDocId,
             updatedCells: json.data?.responses?.[0]?.update_range_response?.updated_cells || 0
         };
     }
-    
     /**
      * Build CellFormat object per official API
      */
-    private buildCellFormat(formatData: any): any {
-        const textFormat: any = {};
-        
+    buildCellFormat(formatData) {
+        const textFormat = {};
         // Font properties
         if (formatData.font != null) {
             textFormat.font = String(formatData.font);
@@ -1196,7 +1076,6 @@ export class WecomDocClient {
         if (formatData.underline != null) {
             textFormat.underline = Boolean(formatData.underline);
         }
-        
         // Color (RGBA)
         if (formatData.color != null && typeof formatData.color === "object") {
             const color = formatData.color;
@@ -1207,16 +1086,13 @@ export class WecomDocClient {
                 alpha: Math.min(255, Math.max(0, Number(color.alpha ?? 255)))
             };
         }
-        
         // Return empty object if no format properties
         if (Object.keys(textFormat).length === 0) {
             return null;
         }
-        
         return { text_format: textFormat };
     }
-
-    async getSheetData(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; range: string }) {
+    async getSheetData(params) {
         const { agent, docId, sheetId, range } = params;
         const body = { docid: readString(docId), sheet_id: readString(sheetId), range: readString(range) };
         const json = await this.postWecomDocApi({
@@ -1226,8 +1102,7 @@ export class WecomDocClient {
         });
         return { raw: json, data: json };
     }
-
-    async modifySheetProperties(params: { agent: ResolvedAgentAccount; docId: string; requests: unknown[] }) {
+    async modifySheetProperties(params) {
         const { agent, docId, requests } = params;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/spreadsheet/batch_update",
@@ -1236,10 +1111,8 @@ export class WecomDocClient {
         });
         return { raw: json, docId: docId };
     }
-
     // --- Smart Table Operations ---
-
-    async smartTableOperate(params: { agent: ResolvedAgentAccount; docId: string; operation: string; bodyData: any }) {
+    async smartTableOperate(params) {
         const { agent, docId, operation, bodyData } = params;
         const body = { docid: readString(docId), ...readObject(bodyData) };
         const path = `/cgi-bin/wedoc/smartsheet/${operation}`;
@@ -1250,14 +1123,15 @@ export class WecomDocClient {
         });
         return { raw: json, docId };
     }
-
-    async smartTableGetSheets(params: { agent: ResolvedAgentAccount; docId: string; sheet_id?: string; need_all_type_sheet?: boolean }) {
+    async smartTableGetSheets(params) {
         const { agent, docId, sheet_id, need_all_type_sheet } = params;
-        const payload: Record<string, unknown> = {
+        const payload = {
             docid: readString(docId),
         };
-        if (sheet_id) payload.sheet_id = sheet_id;
-        if (need_all_type_sheet !== undefined) payload.need_all_type_sheet = need_all_type_sheet;
+        if (sheet_id)
+            payload.sheet_id = sheet_id;
+        if (need_all_type_sheet !== undefined)
+            payload.need_all_type_sheet = need_all_type_sheet;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/get_sheet",
             actionLabel: "smartsheet_get_sheet",
@@ -1269,33 +1143,21 @@ export class WecomDocClient {
             sheets: readArray(json.sheet_list),
         };
     }
-
-    async smartTableAddSheet(params: { agent: ResolvedAgentAccount; docId: string; title: string; index?: number }) {
+    async smartTableAddSheet(params) {
         const { agent, docId, title, index } = params;
         return this.smartTableOperate({ agent, docId, operation: "add_sheet", bodyData: { properties: { title, index } } });
     }
-
-    async smartTableDelSheet(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string }) {
+    async smartTableDelSheet(params) {
         const { agent, docId, sheetId } = params;
         return this.smartTableOperate({ agent, docId, operation: "delete_sheet", bodyData: { sheet_id: sheetId } });
     }
-
-    async smartTableUpdateSheet(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; title: string }) {
+    async smartTableUpdateSheet(params) {
         const { agent, docId, sheetId, title } = params;
         return this.smartTableOperate({ agent, docId, operation: "update_sheet", bodyData: { properties: { sheet_id: sheetId, title } } });
     }
-    async smartTableAddView(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string; 
-        view_title: string; 
-        view_type: string;
-        property?: any;  // ViewProperty: sort_spec, filter_spec, group_spec, etc.
-        property_gantt?: any;  // Deprecated, use property instead
-        property_calendar?: any;  // Deprecated, use property instead
-    }) {
+    async smartTableAddView(params) {
         const { agent, docId, sheetId, view_title, view_type, property, property_gantt, property_calendar } = params;
-        const payload: Record<string, unknown> = {
+        const payload = {
             docid: readString(docId),
             sheet_id: readString(sheetId),
             view_title: readString(view_title),
@@ -1305,9 +1167,10 @@ export class WecomDocClient {
             payload.property = property;
         }
         // Support deprecated property_gantt/property_calendar for backward compatibility
-        if (property_gantt) payload.property_gantt = property_gantt;
-        if (property_calendar) payload.property_calendar = property_calendar;
-        
+        if (property_gantt)
+            payload.property_gantt = property_gantt;
+        if (property_calendar)
+            payload.property_calendar = property_calendar;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/add_view",
             actionLabel: "smartsheet_add_view",
@@ -1319,31 +1182,23 @@ export class WecomDocClient {
             view: json.view,
         };
     }
-
-    async smartTableUpdateView(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string; 
-        view_id: string; 
-        view_title?: string;
-        property?: any;  // ViewProperty: sort_spec, filter_spec, group_spec, etc.
-        property_gantt?: any;  // Deprecated, use property instead
-        property_calendar?: any;  // Deprecated, use property instead
-    }) {
+    async smartTableUpdateView(params) {
         const { agent, docId, sheetId, view_id, view_title, property, property_gantt, property_calendar } = params;
-        const payload: Record<string, unknown> = {
+        const payload = {
             docid: readString(docId),
             sheet_id: readString(sheetId),
             view_id: readString(view_id),
         };
-        if (view_title) payload.view_title = readString(view_title);
+        if (view_title)
+            payload.view_title = readString(view_title);
         if (property && typeof property === 'object') {
             payload.property = property;
         }
         // Support deprecated property_gantt/property_calendar for backward compatibility
-        if (property_gantt) payload.property_gantt = property_gantt;
-        if (property_calendar) payload.property_calendar = property_calendar;
-        
+        if (property_gantt)
+            payload.property_gantt = property_gantt;
+        if (property_calendar)
+            payload.property_calendar = property_calendar;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/update_view",
             actionLabel: "smartsheet_update_view",
@@ -1355,14 +1210,11 @@ export class WecomDocClient {
             view: json.view,
         };
     }
-
-    async smartTableDelView(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; view_ids: string[] }) {
+    async smartTableDelView(params) {
         const { agent, docId, sheetId, view_ids } = params;
-        
         if (!Array.isArray(view_ids) || view_ids.length === 0) {
             throw new Error("view_ids 必须是非空数组");
         }
-        
         return this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/delete_views",
             actionLabel: "smartsheet_del_view",
@@ -1374,24 +1226,18 @@ export class WecomDocClient {
             },
         });
     }
-
-    async smartTableGetViews(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string; 
-        view_ids?: string[];
-        offset?: number;
-        limit?: number;
-    }) {
+    async smartTableGetViews(params) {
         const { agent, docId, sheetId, view_ids, offset, limit } = params;
-        const payload: Record<string, unknown> = {
+        const payload = {
             docid: readString(docId),
             sheet_id: readString(sheetId),
         };
-        if (view_ids && Array.isArray(view_ids)) payload.view_ids = view_ids;
-        if (offset !== undefined) payload.offset = offset;
-        if (limit !== undefined) payload.limit = limit;
-        
+        if (view_ids && Array.isArray(view_ids))
+            payload.view_ids = view_ids;
+        if (offset !== undefined)
+            payload.offset = offset;
+        if (limit !== undefined)
+            payload.limit = limit;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/get_views",
             actionLabel: "smartsheet_get_views",
@@ -1406,23 +1252,14 @@ export class WecomDocClient {
             next: json.next,
         };
     }
-
-    async smartTableAddFields(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string; 
-        fields: any[];
-        autoCleanupDefaultField?: boolean; // Auto-delete leftover default field after adding new fields
-    }) {
+    async smartTableAddFields(params) {
         const { agent, docId, sheetId, fields, autoCleanupDefaultField = true } = params;
-        
         // Validate fields per official API spec
         if (!Array.isArray(fields) || fields.length === 0) {
             throw new Error("fields 必须是非空数组");
         }
-        
         // Validate each field has required field_title and field_type
-        fields.forEach((field: any, index: number) => {
+        fields.forEach((field, index) => {
             if (!field.field_title) {
                 throw new Error(`第${index + 1}个字段：field_title 必填`);
             }
@@ -1444,7 +1281,6 @@ export class WecomDocClient {
                 throw new Error(`第${index + 1}个字段：field_type 必须是有效的字段类型（见 FieldType 枚举）`);
             }
         });
-        
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/add_fields",
             actionLabel: "smartsheet_add_fields",
@@ -1455,38 +1291,27 @@ export class WecomDocClient {
                 fields: fields,
             },
         });
-        
         const result = {
             raw: json,
             fields: readArray(json.fields),
         };
-        
         // Auto-cleanup: delete leftover default field after successfully adding new fields
         // This handles the case where initializeSmartTable kept 1 default field
         if (autoCleanupDefaultField) {
             await this.cleanupLeftoverDefaultField({ agent, docId, sheetId, newlyAddedFieldCount: result.fields.length });
         }
-        
         return result;
     }
-
     /**
      * Cleanup leftover default field after adding new fields
      * When user adds new fields, we can safely delete the leftover default field from initialization
      */
-    private async cleanupLeftoverDefaultField(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string;
-        newlyAddedFieldCount: number;
-    }) {
+    async cleanupLeftoverDefaultField(params) {
         const { agent, docId, sheetId, newlyAddedFieldCount } = params;
-        
         try {
             // Get all fields to find the leftover default field
             const fieldsResult = await this.smartTableGetFields({ agent, docId, sheetId, limit: 100 });
             const allFields = fieldsResult.fields || [];
-            
             // After adding N new fields to a table with 1 default field, we should have N+1 fields
             // If total = newlyAdded + 1, then there's 1 leftover default field to delete
             if (allFields.length === newlyAddedFieldCount + 1 && newlyAddedFieldCount > 0) {
@@ -1494,38 +1319,29 @@ export class WecomDocClient {
                 // Default fields typically have generic titles like "文本", "数字", "日期", "单选", "人员"
                 const defaultFieldTitles = ['文本', '数字', '日期', '单选', '人员', '文本 1', '数字 1', '日期 1', '单选 1', '人员 1'];
                 const defaultFieldTypes = ['FIELD_TYPE_TEXT', 'FIELD_TYPE_NUMBER', 'FIELD_TYPE_DATE_TIME', 'FIELD_TYPE_SINGLE_SELECT', 'FIELD_TYPE_USER'];
-                
-                const leftoverField = allFields.find((field: any) => {
+                const leftoverField = allFields.find((field) => {
                     const isDefaultTitle = defaultFieldTitles.includes(field.field_title);
                     const isDefaultType = defaultFieldTypes.includes(field.field_type);
                     return isDefaultTitle && isDefaultType;
-                }) as any;
-                
+                });
                 if (leftoverField && leftoverField.field_id) {
                     await this.smartTableDelFields({ agent, docId, sheetId, field_ids: [leftoverField.field_id] });
                 }
             }
-        } catch (err) {
+        }
+        catch (err) {
             // Non-fatal: new fields added, just cleanup failed
             console.error(`[WecomDocClient] cleanupLeftoverDefaultField failed:`, err);
         }
     }
-
-    async smartTableUpdateFields(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string; 
-        fields: any[];
-    }) {
+    async smartTableUpdateFields(params) {
         const { agent, docId, sheetId, fields } = params;
-        
         // Validate fields per official API spec
         if (!Array.isArray(fields) || fields.length === 0) {
             throw new Error("fields 必须是非空数组");
         }
-        
         // Validate each field has required field_id and field_type
-        fields.forEach((field: any, index: number) => {
+        fields.forEach((field, index) => {
             if (!field.field_id) {
                 throw new Error(`第${index + 1}个字段：field_id 必填`);
             }
@@ -1537,7 +1353,6 @@ export class WecomDocClient {
                 throw new Error(`第${index + 1}个字段：field_title 或 property_* 属性至少提供一个`);
             }
         });
-        
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/update_fields",
             actionLabel: "smartsheet_update_fields",
@@ -1553,14 +1368,11 @@ export class WecomDocClient {
             fields: readArray(json.fields),
         };
     }
-
-    async smartTableDelFields(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; field_ids: string[] }) {
+    async smartTableDelFields(params) {
         const { agent, docId, sheetId, field_ids } = params;
-        
         if (!Array.isArray(field_ids) || field_ids.length === 0) {
             throw new Error("field_ids 必须是非空数组");
         }
-        
         return this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/delete_fields",
             actionLabel: "smartsheet_del_fields",
@@ -1572,28 +1384,22 @@ export class WecomDocClient {
             },
         });
     }
-
-    async smartTableGetFields(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string; 
-        view_id?: string;
-        field_ids?: string[];
-        field_titles?: string[];
-        offset?: number;
-        limit?: number;
-    }) {
+    async smartTableGetFields(params) {
         const { agent, docId, sheetId, view_id, field_ids, field_titles, offset, limit } = params;
-        const payload: Record<string, unknown> = {
+        const payload = {
             docid: readString(docId),
             sheet_id: readString(sheetId),
         };
-        if (view_id) payload.view_id = view_id;
-        if (field_ids && Array.isArray(field_ids)) payload.field_ids = field_ids;
-        if (field_titles && Array.isArray(field_titles)) payload.field_titles = field_titles;
-        if (offset !== undefined) payload.offset = offset;
-        if (limit !== undefined) payload.limit = limit;
-        
+        if (view_id)
+            payload.view_id = view_id;
+        if (field_ids && Array.isArray(field_ids))
+            payload.field_ids = field_ids;
+        if (field_titles && Array.isArray(field_titles))
+            payload.field_titles = field_titles;
+        if (offset !== undefined)
+            payload.offset = offset;
+        if (limit !== undefined)
+            payload.limit = limit;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/get_fields",
             actionLabel: "smartsheet_get_fields",
@@ -1608,192 +1414,162 @@ export class WecomDocClient {
             next: json.next,
         };
     }
-
-    async smartTableAddGroup(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; name: string; children?: string[] }) {
+    async smartTableAddGroup(params) {
         const { agent, docId, sheetId, name, children } = params;
         return this.smartTableOperate({ agent, docId, operation: "add_field_group", bodyData: { sheet_id: sheetId, name, children } });
     }
-
-    async smartTableDelGroup(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; field_group_id: string }) {
+    async smartTableDelGroup(params) {
         const { agent, docId, sheetId, field_group_id } = params;
         return this.smartTableOperate({ agent, docId, operation: "delete_field_group", bodyData: { sheet_id: sheetId, field_group_id } });
     }
-
-    async smartTableUpdateGroup(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; field_group_id: string; name?: string; children?: string[] }) {
+    async smartTableUpdateGroup(params) {
         const { agent, docId, sheetId, field_group_id, name, children } = params;
         return this.smartTableOperate({ agent, docId, operation: "update_field_group", bodyData: { sheet_id: sheetId, field_group_id, name, children } });
     }
-
-    async smartTableGetGroups(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string }) {
+    async smartTableGetGroups(params) {
         const { agent, docId, sheetId } = params;
         return this.smartTableOperate({ agent, docId, operation: "get_field_groups", bodyData: { sheet_id: sheetId } });
     }
-
-    async smartTableAddExternalRecords(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; records: any[] }) {
+    async smartTableAddExternalRecords(params) {
         const { agent, docId, sheetId, records } = params;
         return this.smartTableOperate({ agent, docId, operation: "add_external_records", bodyData: { sheet_id: sheetId, records } });
     }
-
-    async smartTableUpdateExternalRecords(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; records: any[] }) {
+    async smartTableUpdateExternalRecords(params) {
         const { agent, docId, sheetId, records } = params;
         return this.smartTableOperate({ agent, docId, operation: "update_external_records", bodyData: { sheet_id: sheetId, records } });
     }
-
-    async smartTableAddRecords(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string; 
-        records: any[];
-        key_type?: string;
-    }) {
+    async smartTableAddRecords(params) {
         const { agent, docId, sheetId, records, key_type } = params;
-        
         // Validate records format per official API spec (doc2.txt line 1594-1601)
         if (!Array.isArray(records) || records.length === 0) {
             throw new Error("records 必须是非空数组");
         }
-        
         // Strict validation: require correct format based on field type
         // Do NOT auto-convert ambiguous values to avoid corrupting user intent
-        const validatedRecords = records.map((record: any, recordIndex: number) => {
+        const validatedRecords = records.map((record, recordIndex) => {
             if (!record.values || typeof record.values !== 'object' || Array.isArray(record.values)) {
                 throw new Error(`第${recordIndex + 1}条记录：values 必须是非空对象`);
             }
-            
-            const validatedValues: Record<string, any> = {};
+            const validatedValues = {};
             for (const [key, value] of Object.entries(record.values)) {
                 // Accept both array and non-array formats based on field type
                 // Array types: TEXT, USER, SELECT, SINGLE_SELECT, CHECKBOX, PHONE_NUMBER, EMAIL, URL, LOCATION, BARCODE, ATTACHMENT, IMAGE
                 // Non-array types: NUMBER, DATE_TIME, PROGRESS, CURRENCY, PERCENTAGE
-                
                 if (Array.isArray(value)) {
                     // Array format - validate structure
                     if (value.length === 0) {
                         throw new Error(`第${recordIndex + 1}条记录字段 "${key}": 数组不能为空`);
                     }
                     validatedValues[key] = value;
-                } else if (typeof value === 'number') {
+                }
+                else if (typeof value === 'number') {
                     // Non-array number - valid for NUMBER, PROGRESS, CURRENCY, PERCENTAGE
                     validatedValues[key] = value;
-                } else if (typeof value === 'string' && /^\d{13}$/.test(value)) {
+                }
+                else if (typeof value === 'string' && /^\d{13}$/.test(value)) {
                     // Non-array 13-digit string - valid for DATE_TIME (millisecond timestamp)
                     validatedValues[key] = value;
-                } else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                }
+                else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
                     // Object format - wrap in array for types like USER, TEXT object
                     // This allows {user_id: "..."} to become [{user_id: "..."}]
                     validatedValues[key] = [value];
-                } else {
+                }
+                else {
                     // Reject ambiguous primitives (plain strings, booleans)
                     // Users should explicitly use array format: [{type: "text", text: "..."}]
-                    throw new Error(
-                        `第${recordIndex + 1}条记录字段 "${key}": 值格式不明确。` +
+                    throw new Error(`第${recordIndex + 1}条记录字段 "${key}": 值格式不明确。` +
                         `数字/日期类型直接写值 (25, "1704067200000")，` +
-                        `文本/成员/选项类型用数组 ([{"type": "text", "text": "..."}], [{"user_id": "..."}])`
-                    );
+                        `文本/成员/选项类型用数组 ([{"type": "text", "text": "..."}], [{"user_id": "..."}])`);
                 }
             }
-            
             return {
                 ...record,
                 values: validatedValues,
             };
         });
-        
-        const bodyData: Record<string, unknown> = {
+        const bodyData = {
             sheet_id: readString(sheetId),
             records: validatedRecords,
         };
-        
         if (key_type) {
             bodyData.key_type = key_type;
         }
-        
         return this.smartTableOperate({ agent, docId, operation: "add_records", bodyData });
     }
-
-    async smartTableUpdateRecords(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; records: any[] }) {
+    async smartTableUpdateRecords(params) {
         const { agent, docId, sheetId, records } = params;
-        
         // Strict validation: same as addRecords
         if (!Array.isArray(records) || records.length === 0) {
             throw new Error("records 必须是非空数组");
         }
-        
-        const validatedRecords = records.map((record: any, recordIndex: number) => {
+        const validatedRecords = records.map((record, recordIndex) => {
             if (!record.record_id) {
                 throw new Error(`第${recordIndex + 1}条记录缺少 record_id`);
             }
             if (!record.values || typeof record.values !== 'object' || Array.isArray(record.values)) {
                 throw new Error(`第${recordIndex + 1}条记录：values 必须是非空对象`);
             }
-            
-            const validatedValues: Record<string, any> = {};
+            const validatedValues = {};
             for (const [key, value] of Object.entries(record.values)) {
                 if (Array.isArray(value)) {
                     if (value.length === 0) {
                         throw new Error(`第${recordIndex + 1}条记录字段 "${key}": 数组不能为空`);
                     }
                     validatedValues[key] = value;
-                } else if (typeof value === 'number') {
+                }
+                else if (typeof value === 'number') {
                     validatedValues[key] = value;
-                } else if (typeof value === 'string' && /^\d{13}$/.test(value)) {
+                }
+                else if (typeof value === 'string' && /^\d{13}$/.test(value)) {
                     validatedValues[key] = value;
-                } else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                }
+                else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
                     validatedValues[key] = [value];
-                } else {
-                    throw new Error(
-                        `第${recordIndex + 1}条记录字段 "${key}": 值格式不明确。` +
+                }
+                else {
+                    throw new Error(`第${recordIndex + 1}条记录字段 "${key}": 值格式不明确。` +
                         `数字/日期类型直接写值 (25, "1704067200000")，` +
-                        `文本/成员/选项类型用数组 ([{"type": "text", "text": "..."}], [{"user_id": "..."}])`
-                    );
+                        `文本/成员/选项类型用数组 ([{"type": "text", "text": "..."}], [{"user_id": "..."}])`);
                 }
             }
-            
             return {
                 ...record,
                 values: validatedValues,
             };
         });
-        
         return this.smartTableOperate({ agent, docId, operation: "update_records", bodyData: { sheet_id: sheetId, records: validatedRecords } });
     }
-
-    async smartTableDelRecords(params: { agent: ResolvedAgentAccount; docId: string; sheetId: string; record_ids: string[] }) {
+    async smartTableDelRecords(params) {
         const { agent, docId, sheetId, record_ids } = params;
         return this.smartTableOperate({ agent, docId, operation: "delete_records", bodyData: { sheet_id: sheetId, record_ids } });
     }
-
-    async smartTableGetRecords(params: { 
-        agent: ResolvedAgentAccount; 
-        docId: string; 
-        sheetId: string; 
-        view_id?: string;
-        record_ids?: string[];
-        key_type?: string;
-        field_titles?: string[];
-        field_ids?: string[];
-        sort?: any[];
-        offset?: number;
-        limit?: number;
-        ver?: number;
-        filter_spec?: any;
-    }) {
+    async smartTableGetRecords(params) {
         const { agent, docId, sheetId, view_id, record_ids, key_type, field_titles, field_ids, sort, offset, limit, ver, filter_spec } = params;
-        const payload: Record<string, unknown> = {
+        const payload = {
             docid: readString(docId),
             sheet_id: readString(sheetId),
         };
-        if (view_id) payload.view_id = view_id;
-        if (record_ids && Array.isArray(record_ids)) payload.record_ids = record_ids;
-        if (key_type) payload.key_type = key_type;
-        if (field_titles && Array.isArray(field_titles)) payload.field_titles = field_titles;
-        if (field_ids && Array.isArray(field_ids)) payload.field_ids = field_ids;
-        if (sort && Array.isArray(sort)) payload.sort = sort;
-        if (offset !== undefined) payload.offset = offset;
-        if (limit !== undefined) payload.limit = limit;
-        if (ver !== undefined) payload.ver = ver;
-        if (filter_spec && typeof filter_spec === 'object') payload.filter_spec = filter_spec;
-        
+        if (view_id)
+            payload.view_id = view_id;
+        if (record_ids && Array.isArray(record_ids))
+            payload.record_ids = record_ids;
+        if (key_type)
+            payload.key_type = key_type;
+        if (field_titles && Array.isArray(field_titles))
+            payload.field_titles = field_titles;
+        if (field_ids && Array.isArray(field_ids))
+            payload.field_ids = field_ids;
+        if (sort && Array.isArray(sort))
+            payload.sort = sort;
+        if (offset !== undefined)
+            payload.offset = offset;
+        if (limit !== undefined)
+            payload.limit = limit;
+        if (ver !== undefined)
+            payload.ver = ver;
+        if (filter_spec && typeof filter_spec === 'object')
+            payload.filter_spec = filter_spec;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/get_records",
             actionLabel: "smartsheet_get_records",
@@ -1809,10 +1585,8 @@ export class WecomDocClient {
             ver: json.ver,
         };
     }
-
     // --- Smartsheet Content Permissions ---
-
-    async smartTableGetSheetPriv(params: { agent: ResolvedAgentAccount; docId: string; type: number; rule_id_list?: number[] }) {
+    async smartTableGetSheetPriv(params) {
         const { agent, docId, type, rule_id_list } = params;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/content_priv/get_sheet_priv",
@@ -1822,13 +1596,13 @@ export class WecomDocClient {
         });
         return { raw: json };
     }
-
-    async smartTableUpdateSheetPriv(params: { agent: ResolvedAgentAccount; docId: string; type: number; rule_id?: number; name?: string; priv_list: any[] }) {
+    async smartTableUpdateSheetPriv(params) {
         const { agent, docId, type, rule_id, name, priv_list } = params;
-        const body: any = { docid: readString(docId), type, priv_list };
-        if (rule_id !== undefined) body.rule_id = rule_id;
-        if (name !== undefined) body.name = name;
-        
+        const body = { docid: readString(docId), type, priv_list };
+        if (rule_id !== undefined)
+            body.rule_id = rule_id;
+        if (name !== undefined)
+            body.name = name;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/content_priv/update_sheet_priv",
             actionLabel: "smartsheet_update_sheet_priv",
@@ -1837,8 +1611,7 @@ export class WecomDocClient {
         });
         return { raw: json };
     }
-
-    async smartTableCreateRule(params: { agent: ResolvedAgentAccount; docId: string; name: string }) {
+    async smartTableCreateRule(params) {
         const { agent, docId, name } = params;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/content_priv/create_rule",
@@ -1848,13 +1621,13 @@ export class WecomDocClient {
         });
         return { raw: json, rule_id: json.rule_id };
     }
-
-    async smartTableModRuleMember(params: { agent: ResolvedAgentAccount; docId: string; rule_id: number; add_member_range?: any; del_member_range?: any }) {
+    async smartTableModRuleMember(params) {
         const { agent, docId, rule_id, add_member_range, del_member_range } = params;
-        const body: any = { docid: readString(docId), rule_id };
-        if (add_member_range) body.add_member_range = add_member_range;
-        if (del_member_range) body.del_member_range = del_member_range;
-
+        const body = { docid: readString(docId), rule_id };
+        if (add_member_range)
+            body.add_member_range = add_member_range;
+        if (del_member_range)
+            body.del_member_range = del_member_range;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/content_priv/mod_rule_member",
             actionLabel: "smartsheet_mod_rule_member",
@@ -1863,8 +1636,7 @@ export class WecomDocClient {
         });
         return { raw: json };
     }
-
-    async smartTableDeleteRule(params: { agent: ResolvedAgentAccount; docId: string; rule_id_list: number[] }) {
+    async smartTableDeleteRule(params) {
         const { agent, docId, rule_id_list } = params;
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/smartsheet/content_priv/delete_rule",
@@ -1874,10 +1646,8 @@ export class WecomDocClient {
         });
         return { raw: json };
     }
-
     // --- Advanced Account Management ---
-
-    async assignDocAdvancedAccount(params: { agent: ResolvedAgentAccount; userid_list: string[] }) {
+    async assignDocAdvancedAccount(params) {
         const { agent, userid_list } = params;
         return this.postWecomDocApi({
             path: "/cgi-bin/meeting/vip/submit_batch_add_job",
@@ -1886,8 +1656,7 @@ export class WecomDocClient {
             body: { userid_list },
         });
     }
-
-    async cancelDocAdvancedAccount(params: { agent: ResolvedAgentAccount; userid_list: string[] }) {
+    async cancelDocAdvancedAccount(params) {
         const { agent, userid_list } = params;
         return this.postWecomDocApi({
             path: "/cgi-bin/meeting/vip/submit_batch_del_job",
@@ -1896,8 +1665,7 @@ export class WecomDocClient {
             body: { userid_list },
         });
     }
-
-    async getDocAdvancedAccountList(params: { agent: ResolvedAgentAccount; cursor?: number; limit?: number }) {
+    async getDocAdvancedAccountList(params) {
         const { agent, cursor, limit } = params;
         return this.postWecomDocApi({
             path: "/cgi-bin/meeting/vip/get_vip_user_list",
@@ -1906,14 +1674,12 @@ export class WecomDocClient {
             body: { cursor: cursor !== undefined ? String(cursor) : undefined, limit: limit ?? 100 },
         });
     }
-
     // --- Material Management ---
-
-    async uploadDocImage(params: { agent: ResolvedAgentAccount; docId: string; base64_content: string }) {
+    async uploadDocImage(params) {
         const { agent, docId, base64_content } = params;
         const normalizedDocId = readString(docId);
-        if (!normalizedDocId) throw new Error("docId required");
-        
+        if (!normalizedDocId)
+            throw new Error("docId required");
         const json = await this.postWecomDocApi({
             path: "/cgi-bin/wedoc/image_upload",
             actionLabel: "upload_doc_image",
@@ -1923,7 +1689,6 @@ export class WecomDocClient {
                 base64_content: base64_content
             }
         });
-        
         return {
             raw: json,
             url: readString(json.url),