listpage_cli 0.0.303 → 0.0.305

package/bin/adapters/cli-interaction.js

@@ -174,6 +174,12 @@ function printHelp() {
         "    说明: 使用 docker.remote + docker.container 执行部署，支持 ports[] 与 envFile/env 合并",
         `    备注: ${helpColor("默认会清理并拉取镜像；传入 --skip-image 时只执行容器相关步骤（假定镜像已是最新且已存在）", "yellow")}`,
         `          ${helpColor("参数优先级为 CLI > profile > base", "yellow")}`,
+        "",
+        `  ${helpColor("lark", "green")}`,
+        `    用法: ${helpColor("listpage_cli lark read <doc_token>", "dim")}`,
+        `          ${helpColor("listpage_cli lark check-todo <doc_token> <todo_index>", "dim")}`,
+        `          ${helpColor("listpage_cli lark update-block <doc_token> <emoji_id> <markdown_content_path>", "dim")}`,
+        "    说明: 飞书文档相关操作（读取文档、勾选TODO、更新高亮块）",
     ].join("\n");
     console.log(h);
 }

package/bin/app/parse-args.js

@@ -9,6 +9,7 @@ const KNOWN_COMMANDS = new Set([
     "build-project",
     "release-project",
     "deploy-project",
+    "lark",
 ]);
 function parseArgs(argv) {
     const rawArgs = [...argv];

package/bin/cli.js

@@ -9,6 +9,7 @@ const install_skill_command_1 = require("./commands/install-skill-command");
 const build_project_command_1 = require("./commands/build-project-command");
 const release_project_command_1 = require("./commands/release-project-command");
 const deploy_project_command_1 = require("./commands/deploy-project-command");
+const lark_command_1 = require("./commands/lark-command");
 const node_fs_adapter_1 = require("./adapters/node-fs-adapter");
 const filesystem_capability_service_1 = require("./services/filesystem-capability-service");
 const fsAdapter = (0, node_fs_adapter_1.createNodeFsAdapter)();
@@ -41,6 +42,9 @@ const releaseProjectCommandHandler = (0, release_project_command_1.createRelease
 const deployProjectCommandHandler = (0, deploy_project_command_1.createDeployProjectCommandHandler)({
     fs: fsAdapter,
 });
+const larkCommandHandler = (0, lark_command_1.createLarkCommandHandler)({
+    fs: fsAdapter,
+});
 async function main() {
     const result = await (0, execute_1.executeCommand)(process.argv.slice(2), {
         printHelp: cli_interaction_1.printHelp,
@@ -51,6 +55,7 @@ async function main() {
             "build-project": buildProjectCommandHandler,
             "release-project": releaseProjectCommandHandler,
             "deploy-project": deployProjectCommandHandler,
+            lark: larkCommandHandler,
         },
     });
     applyCommandResult(result);

package/bin/commands/lark/check-todo-command.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleCheckTodoCommand = handleCheckTodoCommand;
+const command_result_1 = require("../../domain/command-result");
+async function handleCheckTodoCommand(input, client, fs) {
+    const docToken = input.positionals[1];
+    const todoIndex = input.positionals[2];
+    if (!docToken || !todoIndex) {
+        return (0, command_result_1.commandError)("错误: 参数缺失。用法: listpage_cli lark check-todo <doc_token> <todo_index>", "missing_args", 1);
+    }
+    const index = parseInt(todoIndex, 10);
+    if (isNaN(index) || index < 1) {
+        return (0, command_result_1.commandError)("错误: todo_index 必须为大于 0 的整数", "invalid_index", 1);
+    }
+    try {
+        // 1. 获取所有 block，寻找 emoji_id 为 "rocket" 的高亮块
+        // (参考用户需求，check_todo 默认在 rocket 块下操作，或者后续可扩展为参数)
+        const targetEmojiId = "rocket";
+        const blocksRes = await client.docx.documentBlock.list({
+            path: { document_id: docToken },
+        });
+        if (blocksRes.code !== 0 || !blocksRes.data?.items) {
+            return (0, command_result_1.commandError)(`获取文档 blocks 失败: ${blocksRes.msg}`, "get_blocks_failed", 1);
+        }
+        let targetBlockId;
+        for (const block of blocksRes.data.items) {
+            // block_type 14 是 Callout (高亮块)
+            if (block.block_type === 19 &&
+                block.callout?.emoji_id === targetEmojiId) {
+                targetBlockId = block.block_id;
+                break;
+            }
+        }
+        if (!targetBlockId) {
+            return (0, command_result_1.commandError)(`未在文档中找到 emoji_id 为 "${targetEmojiId}" 的高亮块`, "block_not_found", 1);
+        }
+        // 2. 获取该高亮块下的子节点 (Todo List)
+        const childrenRes = await client.docx.documentBlockChildren.get({
+            path: {
+                document_id: docToken,
+                block_id: targetBlockId,
+            },
+        });
+        if (childrenRes.code !== 0 || !childrenRes.data?.items) {
+            return (0, command_result_1.commandError)(`获取高亮块子节点失败: ${childrenRes.msg}`, "get_children_failed", 1);
+        }
+        const todoItems = childrenRes.data.items;
+        // index 从 1 开始，所以需要 -1
+        const todoBlock = todoItems[index - 1];
+        if (!todoBlock) {
+            return (0, command_result_1.commandError)(`未找到第 ${index} 个待办事项 (总数: ${todoItems.length})`, "todo_not_found", 1);
+        }
+        // 检查是否为 Todo Block (block_type 11 是 Todo)
+        if (todoBlock.block_type !== 11) {
+            // 如果不是 TODO 类型，可能是文本或其他，视情况处理
+            // 这里简单判断，如果不是 TODO 块，可能 index 指向了非 TODO 元素
+            console.warn(`警告: 第 ${index} 个子节点类型为 ${todoBlock.block_type}，可能不是待办事项。尝试继续操作...`);
+        }
+        // 3. 检查是否已完成
+        if (todoBlock.todo?.style?.done === true) {
+            console.log(`待办事项 (ID: ${todoBlock.block_id}) 已经是完成状态。`);
+            return (0, command_result_1.commandOk)();
+        }
+        // 4. 更新 Todo 状态
+        const todoElements = todoBlock.todo?.elements;
+        const firstTextRun = todoElements?.find((e) => e.text_run)?.text_run;
+        const todoContent = firstTextRun?.content || "";
+        console.log(`正在勾选待办事项: "${todoContent}" (ID: ${todoBlock.block_id})`);
+        const updateRes = await client.docx.documentBlock.patch({
+            path: {
+                document_id: docToken,
+                block_id: todoBlock.block_id,
+            },
+            params: {
+                document_revision_id: -1,
+            },
+            data: {
+                update_text: {
+                    style: {
+                        done: true,
+                    },
+                    fields: [2],
+                    elements: [
+                        {
+                            text_run: {
+                                content: todoContent,
+                            },
+                        },
+                    ],
+                },
+            },
+        });
+        if (updateRes.code !== 0) {
+            return (0, command_result_1.commandError)(`更新待办事项失败: ${updateRes.msg}`, "update_todo_failed", 1);
+        }
+        console.log("飞书文档 TODO 勾选成功！");
+        return (0, command_result_1.commandOk)();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`Check Todo 执行异常: ${message}`, "check_todo_exception", 1);
+    }
+}

package/bin/commands/lark/lark-config.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readLarkConfig = readLarkConfig;
+const command_result_1 = require("../../domain/command-result");
+const json_with_comments_1 = require("../../shared/json-with-comments");
+function readLarkConfig(fs) {
+    const cwd = fs.cwd();
+    const configPath = fs.resolve(cwd, "listpage.config.json");
+    if (!fs.exists(configPath)) {
+        return (0, command_result_1.commandError)("错误: 当前目录下未找到 listpage.config.json。请确保在项目根目录下执行该命令。", "config_not_found", 1);
+    }
+    try {
+        const configContent = fs.readText(configPath);
+        const config = (0, json_with_comments_1.parseJsonWithComments)(configContent);
+        const appId = config.lark?.APP_ID;
+        const appSecret = config.lark?.APP_SECRET;
+        if (!appId || !appSecret) {
+            return (0, command_result_1.commandError)("错误: listpage.config.json 中缺失 lark.APP_ID 或 lark.APP_SECRET 配置。", "missing_lark_config", 1);
+        }
+        return { appId, appSecret };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`错误: 解析 listpage.config.json 失败: ${message}`, "config_parse_error", 1);
+    }
+}

package/bin/commands/lark/read-command.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleReadCommand = handleReadCommand;
+const command_result_1 = require("../../domain/command-result");
+async function handleReadCommand(input, client, fs) {
+    const docToken = input.positionals[1];
+    if (!docToken) {
+        return (0, command_result_1.commandError)("错误: 请提供飞书文档的 doc_token。用法: listpage_cli lark read <doc_token>", "missing_doc_token", 1);
+    }
+    console.log(`正在读取飞书文档内容，doc_token: ${docToken}`);
+    const response = await client.docx.document.rawContent({
+        path: {
+            document_id: docToken,
+        },
+        params: {
+            lang: 0,
+        },
+    });
+    if (response.code !== 0) {
+        return (0, command_result_1.commandError)(`读取飞书文档失败，错误码: ${response.code}, 错误信息: ${response.msg}`, "read_doc_failed", 1);
+    }
+    const docContent = response.data?.content || "";
+    const outputPath = fs.resolve(fs.cwd(), `.listpage/lark/${docToken}.md`);
+    fs.writeText(outputPath, docContent);
+    console.log(`飞书文档读取成功！内容已保存至: ${outputPath}`);
+    return (0, command_result_1.commandOk)();
+}

package/bin/commands/lark/update-block-command.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleUpdateBlockCommand = handleUpdateBlockCommand;
+const command_result_1 = require("../../domain/command-result");
+async function handleUpdateBlockCommand(input, client, fs) {
+    const docToken = input.positionals[1];
+    const emojiId = input.positionals[2];
+    const markdownContentPath = input.positionals[3];
+    if (!docToken || !emojiId || !markdownContentPath) {
+        return (0, command_result_1.commandError)("错误: 参数缺失。用法: listpage_cli lark update-block <doc_token> <emoji_id> <markdown_content_path>", "missing_args", 1);
+    }
+    console.log(`正在更新高亮块文本，doc_token: ${docToken}, emojiId: ${emojiId}, path: ${markdownContentPath}`);
+    try {
+        // 1. 读取本地 Markdown 文件
+        const absolutePath = fs.resolve(fs.cwd(), markdownContentPath);
+        if (!fs.exists(absolutePath)) {
+            return (0, command_result_1.commandError)(`错误: 找不到文件 ${absolutePath}`, "file_not_found", 1);
+        }
+        const markdownContent = fs.readText(absolutePath);
+        // 2. 获取文档的所有 Block，寻找匹配 emojiId 的高亮块
+        const blocksRes = await client.docx.documentBlock.list({
+            path: { document_id: docToken },
+            params: {
+                page_size: 500,
+                document_revision_id: -1,
+            },
+        });
+        if (blocksRes.code !== 0 || !blocksRes.data?.items) {
+            return (0, command_result_1.commandError)(`获取文档 blocks 失败: ${blocksRes.msg}`, "get_blocks_failed", 1);
+        }
+        // 假设高亮块是一个 callout (高亮块)，并且其 emoji_id 匹配用户输入
+        // 你需要根据实际的飞书 Block 结构调整寻找逻辑
+        const blocks = blocksRes.data.items || [];
+        const targetBlock = blocks.find((b) => b.block_type === 19 && b.callout?.emoji_id === emojiId);
+        if (!targetBlock?.block_id) {
+            return (0, command_result_1.commandError)(`未在文档中找到 emoji_id 为 ${emojiId} 的高亮块`, "block_not_found", 1);
+        }
+        // 3. 获取目标块的子节点数量，以便进行批量删除
+        const childrenCounts = targetBlock.children?.length || 0;
+        // 4. 清空原有内容
+        if (childrenCounts > 1) {
+            console.log(`清空高亮块中原有的 ${childrenCounts} 个子节点...`);
+            await client.docx.documentBlockChildren.batchDelete({
+                params: {
+                    document_revision_id: -1,
+                },
+                data: {
+                    start_index: 1,
+                    end_index: childrenCounts,
+                },
+                path: {
+                    document_id: docToken,
+                    block_id: targetBlock.block_id,
+                },
+            });
+        }
+        // 5. 将 Markdown 内容转换为 Blocks
+        const convertRes = await client.docx.document.convert({
+            data: {
+                content: markdownContent,
+                content_type: "markdown",
+            },
+        });
+        if (convertRes.code !== 0) {
+            return (0, command_result_1.commandError)(`转换 Markdown 失败: ${convertRes.msg}`, "convert_failed", 1);
+        }
+        const newBlocks = convertRes.data?.blocks || [];
+        // 6. 添加新内容
+        if (newBlocks.length > 0) {
+            console.log("插入新的内容到高亮块...");
+            await client.docx.documentBlockChildren.create({
+                path: {
+                    document_id: docToken,
+                    block_id: targetBlock.block_id,
+                },
+                data: {
+                    children: newBlocks,
+                    index: -1,
+                },
+            });
+        }
+        console.log("飞书文档高亮块更新成功！");
+        return (0, command_result_1.commandOk)();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`更新高亮块时发生异常: ${message}`, "update_block_exception", 1);
+    }
+}

package/bin/commands/lark-command.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLarkCommandHandler = createLarkCommandHandler;
+const command_result_1 = require("../domain/command-result");
+const node_sdk_1 = require("@larksuiteoapi/node-sdk");
+const lark_config_1 = require("./lark/lark-config");
+const read_command_1 = require("./lark/read-command");
+const check_todo_command_1 = require("./lark/check-todo-command");
+const update_block_command_1 = require("./lark/update-block-command");
+function createLarkCommandHandler(deps) {
+    return async function larkCommand(input) {
+        try {
+            // 尝试读取 lark 配置
+            const configResult = (0, lark_config_1.readLarkConfig)(deps.fs);
+            if ("ok" in configResult) {
+                // 如果返回的是 CommandResult，说明读取失败，直接返回错误
+                return configResult;
+            }
+            const { appId, appSecret } = configResult;
+            const client = new node_sdk_1.Client({
+                appId,
+                appSecret,
+                disableTokenCache: false,
+            });
+            // 解析 lark 后面的参数
+            const subCommand = input.positionals[0];
+            switch (subCommand) {
+                case "read":
+                    return await (0, read_command_1.handleReadCommand)(input, client, deps.fs);
+                case "check-todo":
+                    return await (0, check_todo_command_1.handleCheckTodoCommand)(input, client, deps.fs);
+                case "update-block":
+                    return await (0, update_block_command_1.handleUpdateBlockCommand)(input, client, deps.fs);
+                default:
+                    return (0, command_result_1.commandError)("错误: 未知的子命令。目前仅支持: read, check-todo, update-block", "invalid_subcommand", 1);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return (0, command_result_1.commandError)(`Lark 命令执行失败: ${message}`, "lark_command_failed", 1);
+        }
+    };
+}

package/bin/commands/read-feishu-command.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReadFeishuCommandHandler = createReadFeishuCommandHandler;
+const command_result_1 = require("../domain/command-result");
+function createReadFeishuCommandHandler(deps) {
+    return async function readFeishuCommand(input) {
+        try {
+            // 提取命令行参数，例如：listpage_cli read-feishu <docUrl>
+            const docUrl = input.positionals[0];
+            if (!docUrl) {
+                return (0, command_result_1.commandError)("错误: 请提供飞书文档 URL 或标识符", "invalid_argument", 1);
+            }
+            console.log(`正在读取飞书文档: ${docUrl}`);
+            // TODO: 在这里实现具体的读取飞书文档内容的功能
+            // const docContent = await fetchFeishuDoc(docUrl);
+            // TODO: 在这里实现具体的写入本地文件的功能
+            // await deps.fs.writeFile("feishu-doc.md", docContent);
+            console.log("飞书文档读取成功！");
+            return (0, command_result_1.commandOk)();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return (0, command_result_1.commandError)(`读取飞书文档失败: ${message}`, "read_feishu_failed", 1);
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "listpage_cli",
-  "version": "0.0.303",
+  "version": "0.0.305",
   "private": false,
   "bin": {
     "listpage_cli": "bin/cli.js"
@@ -26,6 +26,7 @@
   "dependencies": {
     "@types/dockerode": "^4.0.1",
     "dockerode": "^4.0.9",
-    "enquirer": "^2.4.1"
+    "enquirer": "^2.4.1",
+    "@larksuiteoapi/node-sdk": "~1.59.0"
   }
 }

package/templates/backend-template/package.json.tmpl

@@ -25,7 +25,7 @@
     "class-transformer": "^0.5.1",
     "class-validator": "~0.14.2",
     "rxjs": "^7.8.1",
-    "listpage-next-nest": "~0.0.303"
+    "listpage-next-nest": "~0.0.305"
   },
   "devDependencies": {
     "@nestjs/schematics": "^11.0.0",

package/templates/frontend-template/package.json.tmpl

@@ -12,7 +12,7 @@
   "dependencies": {
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "listpage-next": "~0.0.303",
+    "listpage-next": "~0.0.305",
     "react-router-dom": ">=6.0.0",
     "@ant-design/v5-patch-for-react-19": "~1.0.3",
     "ahooks": "^3.9.5",
@@ -23,7 +23,7 @@
     "styled-components": "^6.1.19",
     "mobx": "~6.15.0",
     "@ant-design/icons": "~6.0.2",
-    "listpage-components": "~0.0.303",
+    "listpage-components": "~0.0.305",
     "lucide-react": "~0.575.0"
     "mobx-react-lite": "~4.1.1"
   },

package/templates/skills-template/listpage-http/api.md

@@ -65,7 +65,11 @@ export interface ClientOptions {
     port?: number;
     publicPath?: string;
   };
-  onError?: (code: number, message: string) => void;
+  onError?: (
+    code: number,
+    message: string,
+    options?: { quiet?: boolean }
+  ) => void;
 }
 ```
 
@@ -87,6 +91,7 @@ export interface RequestOptions {
     key?: string;
     time?: number; // 缓存时间(ms)
   };
+  quiet?: boolean; // 为 true 时表示本次请求静默错误，不在 onError 中弹通用提示
 }
 ```