feishu-docs-cli 0.1.0-beta.2

package/dist/commands/share.js

@@ -0,0 +1,210 @@
+/**
+ * share command: Manage document permissions (list/add/set).
+ */
+import { createClient, fetchWithAuth } from "../client.js";
+import { CliError } from "../utils/errors.js";
+import { resolveDocument } from "../utils/document-resolver.js";
+import { validateMemberId, detectMemberType } from "../utils/member.js";
+import { mapToDriveType } from "../utils/drive-types.js";
+export const meta = {
+    subcommands: {
+        list: {
+            options: {},
+            positionals: true,
+            handler: list,
+        },
+        add: {
+            options: {
+                role: { type: "string", default: "view" },
+            },
+            positionals: true,
+            handler: add,
+        },
+        set: {
+            options: {
+                public: { type: "string" },
+            },
+            positionals: true,
+            handler: set,
+        },
+    },
+};
+/**
+ * Map user-friendly role name to API perm value.
+ */
+export function mapRole(role) {
+    const map = {
+        view: "view",
+        edit: "edit",
+        manage: "full_access",
+    };
+    const mapped = map[role];
+    if (!mapped) {
+        throw new CliError("INVALID_ARGS", `无效的角色: ${role}。可选值: view, edit, manage`);
+    }
+    return mapped;
+}
+/**
+ * Map public mode string to link_share_entity value.
+ */
+export function mapPublicMode(mode, role = "view") {
+    if (mode === "closed")
+        return "closed";
+    if (mode === "tenant" && role === "view")
+        return "tenant_readable";
+    if (mode === "tenant" && role === "edit")
+        return "tenant_editable";
+    if (mode === "open" && role === "view")
+        return "anyone_readable";
+    if (mode === "open" && role === "edit")
+        return "anyone_editable";
+    // Default: treat as tenant_readable for "tenant", anyone_readable for "open"
+    if (mode === "tenant")
+        return "tenant_readable";
+    if (mode === "open")
+        return "anyone_readable";
+    throw new CliError("INVALID_ARGS", `无效的公开模式: ${mode}。可选值: closed, tenant, open`);
+}
+/**
+ * Check if an API error indicates missing OAuth scope.
+ */
+function isScopeError(err) {
+    const code = err?.apiCode ||
+        err?.code;
+    return code === 99991668 || code === 99991671;
+}
+async function resolveDocForShare(client, authInfo, input) {
+    const doc = await resolveDocument(client, authInfo, input);
+    // For wiki nodes, use the node_token with type "wiki" for permission APIs
+    const token = doc.spaceId ? doc.parsed.token : doc.objToken;
+    const type = doc.spaceId ? "wiki" : mapToDriveType(doc.objType);
+    return { token, type, doc };
+}
+async function list(args, globalOpts) {
+    const input = args.positionals[0];
+    if (!input) {
+        throw new CliError("INVALID_ARGS", "缺少文档 URL 或 token。用法: feishu-docs share list <url>");
+    }
+    const { client, authInfo } = await createClient(globalOpts);
+    let token, type;
+    try {
+        ({ token, type } = await resolveDocForShare(client, authInfo, input));
+    }
+    catch (err) {
+        if (isScopeError(err)) {
+            throw new CliError("AUTH_REQUIRED", "缺少权限 scope: drive:drive:permission。请运行 feishu-docs login 重新授权");
+        }
+        throw err;
+    }
+    const res = await fetchWithAuth(authInfo, `/open-apis/drive/v1/permissions/${encodeURIComponent(token)}/members`, { params: { type } });
+    const shareResData = res?.data;
+    const members = (shareResData?.members || []);
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true, members }, null, 2) + "\n");
+        return;
+    }
+    if (members.length === 0) {
+        process.stdout.write("没有协作者\n");
+        return;
+    }
+    for (const m of members) {
+        const name = m.member_name || m.member_id || "(未知)";
+        const perm = m.perm || "unknown";
+        const memberType = m.member_type || "";
+        process.stdout.write(`  ${name}  [${perm}]  (${memberType}: ${m.member_id})\n`);
+    }
+}
+async function add(args, globalOpts) {
+    const input = args.positionals[0];
+    const memberId = args.positionals[1];
+    if (!input || !memberId) {
+        throw new CliError("INVALID_ARGS", "用法: feishu-docs share add <url> <member> --role <role>");
+    }
+    validateMemberId(memberId);
+    const { client, authInfo } = await createClient(globalOpts);
+    const { token, type } = await resolveDocForShare(client, authInfo, input);
+    const memberType = detectMemberType(memberId);
+    const perm = mapRole(args.role || "view");
+    try {
+        await fetchWithAuth(authInfo, `/open-apis/drive/v1/permissions/${encodeURIComponent(token)}/members`, {
+            method: "POST",
+            params: { type },
+            body: { member_type: memberType, member_id: memberId, perm },
+        });
+    }
+    catch (err) {
+        // Error 1201003: member already exists → fallback to update
+        const code = err?.apiCode ||
+            err?.code;
+        if (code === 1201003) {
+            await fetchWithAuth(authInfo, `/open-apis/drive/v1/permissions/${encodeURIComponent(token)}/members/${encodeURIComponent(memberId)}`, {
+                method: "PUT",
+                params: { type },
+                body: { member_type: memberType, perm },
+            });
+        }
+        else if (isScopeError(err)) {
+            throw new CliError("AUTH_REQUIRED", "缺少权限 scope: drive:drive:permission。请运行 feishu-docs login 重新授权");
+        }
+        else {
+            throw err;
+        }
+    }
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({
+            success: true,
+            member_id: memberId,
+            member_type: memberType,
+            perm,
+        }) + "\n");
+    }
+    else {
+        process.stdout.write(`已添加协作者 ${memberId} (${perm})\n`);
+    }
+}
+async function set(args, globalOpts) {
+    const input = args.positionals[0];
+    if (!input) {
+        throw new CliError("INVALID_ARGS", "用法: feishu-docs share set <url> --public <closed|tenant|open>");
+    }
+    if (!args.public) {
+        throw new CliError("INVALID_ARGS", "缺少 --public 参数。可选值: closed, tenant, open");
+    }
+    const { client, authInfo } = await createClient(globalOpts);
+    const { token, type } = await resolveDocForShare(client, authInfo, input);
+    // Extract optional role from --public value like "tenant:edit"
+    let mode = args.public;
+    let shareRole = "view";
+    if (mode.includes(":")) {
+        const parts = mode.split(":");
+        mode = parts[0];
+        shareRole = parts[1] || "view";
+    }
+    if (shareRole !== "view" && shareRole !== "edit") {
+        throw new CliError("INVALID_ARGS", `无效的分享角色: ${shareRole}。可选值: view, edit（如 tenant:edit）`);
+    }
+    const linkShareEntity = mapPublicMode(mode, shareRole);
+    try {
+        await fetchWithAuth(authInfo, `/open-apis/drive/v1/permissions/${encodeURIComponent(token)}/public`, {
+            method: "PATCH",
+            params: { type },
+            body: { link_share_entity: linkShareEntity },
+        });
+    }
+    catch (err) {
+        if (isScopeError(err)) {
+            throw new CliError("AUTH_REQUIRED", "缺少权限 scope: drive:drive:permission。请运行 feishu-docs login 重新授权");
+        }
+        throw err;
+    }
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({
+            success: true,
+            link_share_entity: linkShareEntity,
+        }) + "\n");
+    }
+    else {
+        process.stdout.write(`已修改分享设置为 ${linkShareEntity}\n`);
+    }
+}
+//# sourceMappingURL=share.js.map

package/dist/commands/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../../src/commands/share.ts"],"names":[],"mappings":"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"}

package/dist/commands/spaces.d.ts

@@ -0,0 +1,6 @@
+/**
+ * spaces command: List all knowledge bases.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function spaces(_args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/spaces.js

@@ -0,0 +1,43 @@
+/**
+ * spaces command: List all knowledge bases.
+ */
+import { createClient, fetchWithAuth } from "../client.js";
+export const meta = {
+    options: {},
+    positionals: false,
+    handler: spaces,
+};
+export async function spaces(_args, globalOpts) {
+    const { authInfo } = await createClient(globalOpts);
+    const allSpaces = [];
+    let pageToken;
+    do {
+        const params = {
+            page_size: 50,
+        };
+        if (pageToken)
+            params.page_token = pageToken;
+        const res = await fetchWithAuth(authInfo, "/open-apis/wiki/v2/spaces", {
+            params,
+        });
+        const data = res?.data;
+        if (data?.items) {
+            allSpaces.push(...data.items);
+        }
+        pageToken = data?.has_more ? data.page_token : undefined;
+    } while (pageToken);
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true, spaces: allSpaces }, null, 2) + "\n");
+        return;
+    }
+    if (allSpaces.length === 0) {
+        process.stdout.write("没有找到知识库\n");
+        return;
+    }
+    for (const space of allSpaces) {
+        const name = space.name || "(未命名)";
+        const desc = space.description ? ` — ${space.description}` : "";
+        process.stdout.write(`${space.space_id}  ${name}${desc}\n`);
+    }
+}
+//# sourceMappingURL=spaces.js.map

package/dist/commands/spaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spaces.js","sourceRoot":"","sources":["../../src/commands/spaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG3D,MAAM,CAAC,MAAM,IAAI,GAAgB;IAC/B,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,MAAM;CAChB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAAkB,EAClB,UAAsB;IAEtB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAc,EAAE,CAAC;IAChC,IAAI,SAA6B,CAAC;IAElC,GAAG,CAAC;QACF,MAAM,MAAM,GAAgD;YAC1D,SAAS,EAAE,EAAE;SACd,CAAC;QACF,IAAI,SAAS;YAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;QAE7C,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,2BAA2B,EAAE;YACrE,MAAM;SACP,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,GAAG,EAAE,IAA2C,CAAC;QAC9D,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,SAAS,CAAC,IAAI,CAAC,GAAI,IAAI,CAAC,KAAmB,CAAC,CAAC;QAC/C,CAAC;QACD,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,UAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,CAAC,QAAQ,SAAS,EAAE;IAEpB,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACrE,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,SAA0C,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/commands/tree.d.ts

@@ -0,0 +1,6 @@
+/**
+ * tree command: Display knowledge base node tree.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function tree(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/tree.js

@@ -0,0 +1,101 @@
+/**
+ * tree command: Display knowledge base node tree.
+ */
+import { createClient, fetchWithAuth } from "../client.js";
+import { fetchChildren } from "../services/wiki-nodes.js";
+import { CliError } from "../utils/errors.js";
+import { validateToken } from "../utils/validate.js";
+/**
+ * Recursively build the tree structure.
+ */
+async function buildNodeTree(authInfo, spaceId, parentNodeToken, currentDepth, maxDepth) {
+    if (maxDepth !== undefined && currentDepth >= maxDepth)
+        return [];
+    const children = await fetchChildren(authInfo, spaceId, parentNodeToken);
+    const result = [];
+    for (const node of children) {
+        const entry = {
+            title: node.title || "(无标题)",
+            nodeToken: node.node_token,
+            objType: node.obj_type || "unknown",
+            hasChild: node.has_child,
+            children: [],
+        };
+        if (node.has_child) {
+            entry.children = await buildNodeTree(authInfo, spaceId, node.node_token, currentDepth + 1, maxDepth);
+        }
+        result.push(entry);
+    }
+    return result;
+}
+/**
+ * Render tree to text output.
+ */
+function renderTree(nodes, prefix = "") {
+    const lines = [];
+    for (let i = 0; i < nodes.length; i++) {
+        const node = nodes[i];
+        const last = i === nodes.length - 1;
+        const connector = last ? "└── " : "├── ";
+        const childPrefix = last ? "    " : "│   ";
+        lines.push(`${prefix}${connector}${node.title} (${node.objType}, ${node.nodeToken})`);
+        if (node.children.length > 0) {
+            const childLines = renderTree(node.children, prefix + childPrefix);
+            lines.push(...childLines);
+        }
+    }
+    return lines;
+}
+export const meta = {
+    options: {
+        node: { type: "string" },
+        depth: { type: "string" },
+    },
+    positionals: true,
+    handler: tree,
+};
+export async function tree(args, globalOpts) {
+    const spaceId = args.positionals[0];
+    if (!spaceId) {
+        throw new CliError("INVALID_ARGS", "缺少知识库 ID。用法: feishu-docs tree <space_id> [--node <token>]");
+    }
+    validateToken(spaceId, "space_id");
+    const { authInfo } = await createClient(globalOpts);
+    const parentNode = args.node || undefined;
+    if (parentNode)
+        validateToken(parentNode, "node_token");
+    const maxDepth = args.depth !== undefined ? Number(args.depth) : undefined;
+    // Get space info for root label
+    let spaceName = spaceId;
+    if (!parentNode) {
+        try {
+            const res = await fetchWithAuth(authInfo, `/open-apis/wiki/v2/spaces/${encodeURIComponent(spaceId)}`);
+            const data = res?.data;
+            spaceName =
+                data?.space?.name || spaceId;
+        }
+        catch {
+            // ignore, use spaceId as name
+        }
+    }
+    const nodes = await buildNodeTree(authInfo, spaceId, parentNode, 0, maxDepth);
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true, space_id: spaceId, nodes }, null, 2) +
+            "\n");
+        return;
+    }
+    if (parentNode) {
+        process.stdout.write(`节点 ${parentNode} (space: ${spaceId})\n`);
+    }
+    else {
+        process.stdout.write(`${spaceName} (space: ${spaceId})\n`);
+    }
+    const lines = renderTree(nodes);
+    for (const line of lines) {
+        process.stdout.write(line + "\n");
+    }
+    if (nodes.length === 0) {
+        process.stdout.write("(空)\n");
+    }
+}
+//# sourceMappingURL=tree.js.map

package/dist/commands/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../src/commands/tree.ts"],"names":[],"mappings":"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"}

package/dist/commands/update.d.ts

@@ -0,0 +1,9 @@
+/**
+ * update command: Update existing documents (append, overwrite, restore).
+ *
+ * Uses Convert + Descendant API for writing new content.
+ * Restore uses the old children API (backup data is raw blocks, not markdown).
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function update(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/update.js

@@ -0,0 +1,211 @@
+/**
+ * update command: Update existing documents (append, overwrite, restore).
+ *
+ * Uses Convert + Descendant API for writing new content.
+ * Restore uses the old children API (backup data is raw blocks, not markdown).
+ */
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { resolve, normalize, sep } from "node:path";
+import { randomUUID } from "node:crypto";
+import { createClient, fetchWithAuth } from "../client.js";
+import { CliError } from "../utils/errors.js";
+import { convertAndWrite } from "../services/markdown-convert.js";
+import { resolveDocument } from "../utils/document-resolver.js";
+import { readBody, getDocumentInfo, clearDocument, backupDocument, sleep, BATCH_SIZE, QPS_DELAY, BACKUPS_DIR, } from "../services/block-writer.js";
+export const meta = {
+    options: {
+        body: { type: "string" },
+        append: { type: "boolean", default: false },
+        restore: { type: "string" },
+    },
+    positionals: true,
+    handler: update,
+};
+export async function update(args, globalOpts) {
+    const input = args.positionals[0];
+    if (!input) {
+        throw new CliError("INVALID_ARGS", "缺少文档 URL 或 token。用法: feishu-docs update <url|token> --body <file>");
+    }
+    const { client, authInfo } = await createClient(globalOpts);
+    const doc = await resolveDocument(client, authInfo, input);
+    const documentId = doc.objToken;
+    if (doc.objType !== "docx") {
+        throw new CliError("INVALID_ARGS", `该文档类型 (${doc.objType}) 不支持更新`);
+    }
+    if (args.restore) {
+        return restoreFromBackup(client, authInfo, documentId, args.restore, globalOpts);
+    }
+    if (!args.body) {
+        throw new CliError("INVALID_ARGS", "缺少 --body 参数。用法: feishu-docs update <url|token> --body <file>");
+    }
+    const bodyContent = await readBody(args.body);
+    if (!bodyContent.trim()) {
+        throw new CliError("INVALID_ARGS", "文档内容为空，至少需要一行内容");
+    }
+    if (args.append) {
+        return appendToDocument(client, authInfo, documentId, bodyContent, globalOpts);
+    }
+    return overwriteDocument(client, authInfo, documentId, bodyContent, globalOpts);
+}
+async function appendToDocument(client, authInfo, documentId, bodyContent, globalOpts) {
+    const docInfo = await getDocumentInfo(client, authInfo, documentId);
+    await convertAndWrite(authInfo, documentId, bodyContent, docInfo.revisionId, -1);
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({
+            success: true,
+            document_id: documentId,
+            mode: "append",
+        }) + "\n");
+    }
+    else {
+        process.stdout.write(`已追加内容到文档 ${documentId}\n`);
+    }
+}
+async function overwriteDocument(client, authInfo, documentId, bodyContent, globalOpts) {
+    let backupPath;
+    try {
+        const backup = await backupDocument(client, authInfo, documentId);
+        backupPath = backup.filepath;
+    }
+    catch (err) {
+        throw new CliError("API_ERROR", `备份失败，操作中止: ${err.message}`);
+    }
+    const docInfo = await getDocumentInfo(client, authInfo, documentId);
+    let rev;
+    try {
+        rev = await clearDocument(client, authInfo, documentId, docInfo.revisionId);
+    }
+    catch (err) {
+        process.stderr.write(`feishu-docs: error: 清空文档失败: ${err.message}\n`);
+        process.stderr.write(`feishu-docs: info: 备份文件: ${backupPath}\n`);
+        throw err;
+    }
+    try {
+        await convertAndWrite(authInfo, documentId, bodyContent, rev);
+    }
+    catch (err) {
+        process.stderr.write(`feishu-docs: error: 写入新内容失败，尝试从备份恢复...\n`);
+        try {
+            await restoreFromBackup(client, authInfo, documentId, backupPath, globalOpts);
+            process.stderr.write("feishu-docs: info: 已从备份自动恢复\n");
+        }
+        catch (restoreErr) {
+            process.stderr.write(`feishu-docs: error: 自动恢复也失败: ${restoreErr.message}\n`);
+            process.stderr.write(`feishu-docs: info: 请手动恢复，备份文件: ${backupPath}\n`);
+            process.stderr.write("feishu-docs: info: 也可在飞书客户端中使用版本历史回退\n");
+        }
+        throw err;
+    }
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({
+            success: true,
+            document_id: documentId,
+            mode: "overwrite",
+            backup: backupPath,
+        }) + "\n");
+    }
+    else {
+        process.stdout.write(`已覆盖更新文档 ${documentId}\n`);
+    }
+}
+/**
+ * Recursively restore blocks and their descendants from a backup block map.
+ * Uses the old children API (backup data is raw blocks, not markdown).
+ */
+const MAX_RESTORE_DEPTH = 20;
+async function restoreChildren(authInfo, documentId, parentBlockId, childIds, blockMap, revisionId, depth = 0) {
+    let rev = revisionId;
+    if (!childIds || childIds.length === 0)
+        return rev;
+    if (depth >= MAX_RESTORE_DEPTH) {
+        process.stderr.write(`feishu-docs: warning: 恢复深度超过 ${MAX_RESTORE_DEPTH} 层，跳过更深层级\n`);
+        return rev;
+    }
+    for (let i = 0; i < childIds.length; i += BATCH_SIZE) {
+        const batchIds = childIds.slice(i, i + BATCH_SIZE);
+        const batch = batchIds
+            .map((id) => blockMap.get(id))
+            .filter(Boolean)
+            .map((b) => {
+            const { block_id, parent_id, children, ...rest } = b;
+            return rest;
+        });
+        if (batch.length === 0)
+            continue;
+        if (i > 0)
+            await sleep(QPS_DELAY);
+        const res = await fetchWithAuth(authInfo, `/open-apis/docx/v1/documents/${encodeURIComponent(documentId)}/blocks/${encodeURIComponent(parentBlockId)}/children`, {
+            method: "POST",
+            body: { children: batch, index: i },
+            params: { document_revision_id: rev, client_token: randomUUID() },
+        });
+        const resData = res?.data;
+        rev = resData?.document_revision_id ?? rev;
+        const createdIds = (resData?.children ?? []).map((c) => c.block_id);
+        for (let j = 0; j < createdIds.length && j < batchIds.length; j++) {
+            const original = blockMap.get(batchIds[j]);
+            if (original?.children?.length && original.children.length > 0) {
+                await sleep(QPS_DELAY);
+                rev = await restoreChildren(authInfo, documentId, createdIds[j], original.children, blockMap, rev, depth + 1);
+            }
+        }
+    }
+    return rev;
+}
+async function restoreFromBackup(client, authInfo, documentId, backupPath, globalOpts) {
+    const resolvedPath = resolve(normalize(backupPath));
+    const resolvedBackups = resolve(BACKUPS_DIR);
+    if (!resolvedPath.startsWith(resolvedBackups + sep)) {
+        throw new CliError("INVALID_ARGS", `备份文件必须位于 ${resolvedBackups} 目录下`, { recovery: `请使用 ${resolvedBackups} 下的备份文件路径` });
+    }
+    if (!existsSync(resolvedPath)) {
+        throw new CliError("FILE_NOT_FOUND", `备份文件不存在: ${resolvedPath}`);
+    }
+    if (!resolvedPath.endsWith(".json")) {
+        throw new CliError("INVALID_ARGS", "备份文件必须是 .json 格式");
+    }
+    const raw = await readFile(resolvedPath, "utf8");
+    let blocks;
+    try {
+        blocks = JSON.parse(raw);
+    }
+    catch {
+        throw new CliError("INVALID_ARGS", `备份文件 JSON 格式无效: ${resolvedPath}`);
+    }
+    if (!Array.isArray(blocks)) {
+        throw new CliError("INVALID_ARGS", "备份文件格式无效：期望 JSON 数组");
+    }
+    const rootBlock = blocks.find((b) => b.block_type === 1);
+    if (!rootBlock) {
+        throw new CliError("INVALID_ARGS", "备份文件格式无效：未找到根 block");
+    }
+    const topLevelIds = rootBlock.children || [];
+    if (topLevelIds.length === 0) {
+        process.stderr.write("feishu-docs: warning: 备份文件中没有可恢复的内容\n");
+        return;
+    }
+    const blockMap = new Map(blocks.map((b) => [b.block_id, b]));
+    const docInfo = await getDocumentInfo(client, authInfo, documentId);
+    let rev = await clearDocument(client, authInfo, documentId, docInfo.revisionId);
+    try {
+        rev = await restoreChildren(authInfo, documentId, documentId, topLevelIds, blockMap, rev);
+    }
+    catch (restoreErr) {
+        process.stderr.write(`feishu-docs: error: 恢复过程中出错: ${restoreErr.message}\n` +
+            `  文档可能处于不完整状态。备份文件路径: ${resolvedPath}\n` +
+            `  你可以在飞书客户端中使用版本历史恢复文档。\n`);
+        throw restoreErr;
+    }
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({
+            success: true,
+            document_id: documentId,
+            mode: "restore",
+        }) + "\n");
+    }
+    else {
+        process.stdout.write(`已从备份恢复文档 ${documentId}\n`);
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"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"}

package/dist/commands/wiki.d.ts

@@ -0,0 +1,6 @@
+/**
+ * wiki command: Wiki space and node management.
+ * Subcommands: create-space, add-member, remove-member, rename, move, copy.
+ */
+import { SubcommandMeta } from "../types/index.js";
+export declare const meta: SubcommandMeta;