listpage_cli 0.0.309 → 0.0.311

package/bin/adapters/cli-interaction.js

@@ -160,17 +160,15 @@ function printHelp() {
         `    用法: ${helpColor("listpage_cli install-skill [skillName] [--project]", "dim")}`,
         "    说明: 安装技能到 Cursor；默认 skillName 为 test，安装到当前命令执行目录的 .cursor/skills/",
         "",
-        `  ${helpColor("build-project", "green")}`,
-        `    用法: ${helpColor("listpage_cli build-project", "dim")}`,
-        "    说明: 非交互校验当前目录是否为有效项目根（需存在 listpage.config.json）",
+        `  ${helpColor("project", "green")}`,
+        `    用法: ${helpColor("listpage_cli project build", "dim")}`,
+        "    说明: 非交互校验当前目录是否为有效项目根（需存在 listpage.config.json），构建并写入 .listpage/output",
         "",
-        `  ${helpColor("release-project", "green")}`,
-        `    用法: ${helpColor("listpage_cli release-project [tag] [--profile dev] [--platform linux/amd64] [--env KEY=VALUE]", "dim")}`,
+        `    用法: ${helpColor("listpage_cli project release [tag] [--profile dev] [--platform linux/amd64] [--env KEY=VALUE]", "dim")}`,
         "    说明: 先校验 .listpage/output 产物，再按 login/build/tag/push 执行 Docker 发布",
         `    备注: ${helpColor("参数优先级为 CLI > profile > base", "yellow")}`,
         "",
-        `  ${helpColor("deploy-project", "green")}`,
-        `    用法: ${helpColor("listpage_cli deploy-project [tag] [--profile dev] [--platform linux/amd64] [--env KEY=VALUE] [--skip-image]", "dim")}`,
+        `    用法: ${helpColor("listpage_cli project deploy [tag] [--profile dev] [--platform linux/amd64] [--env KEY=VALUE] [--skip-image]", "dim")}`,
         "    说明: 使用 docker.remote + docker.container 执行部署，支持 ports[] 与 envFile/env 合并",
         `    备注: ${helpColor("默认会清理并拉取镜像；传入 --skip-image 时只执行容器相关步骤（假定镜像已是最新且已存在）", "yellow")}`,
         `          ${helpColor("参数优先级为 CLI > profile > base", "yellow")}`,

package/bin/app/parse-args.js

@@ -1,16 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.cliOptionArgStartIndex = cliOptionArgStartIndex;
+exports.parseProjectTailPositionals = parseProjectTailPositionals;
 exports.parseArgs = parseArgs;
 exports.parseCommandOptions = parseCommandOptions;
 exports.parseCommandPositionals = parseCommandPositionals;
 const KNOWN_COMMANDS = new Set([
     "init",
     "install-skill",
-    "build-project",
-    "release-project",
-    "deploy-project",
+    "project",
     "lark",
 ]);
+function cliOptionArgStartIndex(command) {
+    return 1;
+}
+/**
+ * `project <sub> [tag] ...` 中，子命令之后的位置参数（如 release/deploy 的镜像 tag）。
+ */
+function parseProjectTailPositionals(rawArgs) {
+    return parseCommandPositionals(rawArgs, "project").slice(1);
+}
 function parseArgs(argv) {
     const rawArgs = [...argv];
     const commandToken = rawArgs[0];
@@ -41,8 +50,8 @@ function parseArgs(argv) {
         positionals,
     };
 }
-function parseCommandOptions(rawArgs) {
-    const args = rawArgs.slice(1);
+function parseCommandOptions(rawArgs, command) {
+    const args = rawArgs.slice(cliOptionArgStartIndex(command));
     const profile = readSingleOption(args, "profile");
     const platform = readSingleOption(args, "platform");
     const envEntries = readMultiOption(args, "env");
@@ -55,8 +64,8 @@ function parseCommandOptions(rawArgs) {
         skipImage: skipImage || undefined,
     };
 }
-function parseCommandPositionals(rawArgs) {
-    const args = rawArgs.slice(1);
+function parseCommandPositionals(rawArgs, command) {
+    const args = rawArgs.slice(cliOptionArgStartIndex(command));
     const positionals = [];
     const optionsWithValue = new Set(["--profile", "--platform", "--env"]);
     for (let index = 0; index < args.length; index += 1) {

package/bin/cli.js

@@ -6,9 +6,7 @@ const execute_1 = require("./app/execute");
 const command_result_1 = require("./domain/command-result");
 const init_command_1 = require("./commands/init-command");
 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 project_command_1 = require("./commands/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");
@@ -33,14 +31,10 @@ const installSkillCommandHandler = (0, install_skill_command_1.createInstallSkil
         defaultSkillName: "test",
     },
 });
-const buildProjectCommandHandler = (0, build_project_command_1.createBuildProjectCommandHandler)({
-    fs: fsAdapter,
-});
-const releaseProjectCommandHandler = (0, release_project_command_1.createReleaseProjectCommandHandler)({
-    fs: fsAdapter,
-});
-const deployProjectCommandHandler = (0, deploy_project_command_1.createDeployProjectCommandHandler)({
-    fs: fsAdapter,
+const projectCommandHandler = (0, project_command_1.createProjectCommandHandler)({
+    build: { fs: fsAdapter },
+    release: { fs: fsAdapter },
+    deploy: { fs: fsAdapter },
 });
 const larkCommandHandler = (0, lark_command_1.createLarkCommandHandler)({
     fs: fsAdapter,
@@ -52,9 +46,7 @@ async function main() {
         handlers: {
             init: initCommandHandler,
             "install-skill": installSkillCommandHandler,
-            "build-project": buildProjectCommandHandler,
-            "release-project": releaseProjectCommandHandler,
-            "deploy-project": deployProjectCommandHandler,
+            project: projectCommandHandler,
             lark: larkCommandHandler,
         },
     });

package/bin/commands/deploy-project-command.js

@@ -5,11 +5,11 @@ const parse_args_1 = require("../app/parse-args");
 const deploy_project_service_1 = require("../services/deploy-project-service");
 function createDeployProjectCommandHandler(deps) {
     return async (input) => {
-        const firstPositional = (0, parse_args_1.parseCommandPositionals)(input.rawArgs)[0];
+        const firstPositional = (0, parse_args_1.parseProjectTailPositionals)(input.rawArgs)[0];
         const tag = typeof firstPositional === "string" && firstPositional.trim() !== ""
             ? firstPositional.trim()
             : undefined;
-        const options = (0, parse_args_1.parseCommandOptions)(input.rawArgs);
+        const options = (0, parse_args_1.parseCommandOptions)(input.rawArgs, "project");
         const cliOverrides = {
             tag,
             profile: options.profile,

package/bin/commands/lark/parse-doc.js

@@ -133,29 +133,24 @@ async function parseBlocksToMarkdown(blocks, options) {
                 const token = block.image?.token;
                 if (token) {
                     const downloadUrl = `https://internal-api-drive-stream.feishu.cn/space/api/box/stream/download/v2/cover/${token}/?fallback_source=1&mount_node_token=${block.block_id}&mount_point=docx_image&policy=equal`;
-                    if (options?.fs && options?.outputDir) {
-                        try {
-                            const imageFileName = `assets/${token}.png`; // 保存到 assets 目录
-                            const imagePath = options.fs.resolve(options.outputDir, imageFileName);
-                            // 确保 assets 目录存在
-                            const imageDir = options.fs.dirname(imagePath);
-                            if (!options.fs.exists(imageDir)) {
-                                options.fs.ensureDir(imageDir);
-                            }
-                            // 使用 sdk 提供的下载方法，并直接使用 writeFile 写入
-                            const fileRes = await options.client.drive.media.download({
-                                path: { file_token: token },
-                            });
-                            // 使用官方推荐的 writeFile 方法直接将文件保存到本地
-                            await fileRes.writeFile(imagePath);
-                            content += `${indent}![image](./${imageFileName})\n\n`;
-                        }
-                        catch (e) {
-                            console.warn(`[Lark Parse] Download image failed for block ${block.block_id}:`, e);
-                            content += `${indent}![image](${downloadUrl})\n\n`;
+                    try {
+                        const imageFileName = `assets/${token}.png`; // 保存到 assets 目录
+                        const imagePath = options.fs.resolve(options.outputDir, imageFileName);
+                        // 确保 assets 目录存在
+                        const imageDir = options.fs.dirname(imagePath);
+                        if (!options.fs.exists(imageDir)) {
+                            options.fs.ensureDir(imageDir);
                         }
+                        // 使用 sdk 提供的下载方法，并直接使用 writeFile 写入
+                        const fileRes = await options.client.drive.media.download({
+                            path: { file_token: token },
+                        });
+                        // 使用官方推荐的 writeFile 方法直接将文件保存到本地
+                        await fileRes.writeFile(imagePath);
+                        content += `${indent}![image](./${imageFileName})\n\n`;
                     }
-                    else {
+                    catch (e) {
+                        console.warn(`[Lark Parse] Download image failed for block ${block.block_id}:`, e);
                         content += `${indent}![image](${downloadUrl})\n\n`;
                     }
                 }

package/bin/commands/project-command.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProjectCommandHandler = createProjectCommandHandler;
+const command_result_1 = require("../domain/command-result");
+const build_project_command_1 = require("./build-project-command");
+const release_project_command_1 = require("./release-project-command");
+const deploy_project_command_1 = require("./deploy-project-command");
+function createProjectCommandHandler(deps) {
+    const build = (0, build_project_command_1.createBuildProjectCommandHandler)(deps.build);
+    const release = (0, release_project_command_1.createReleaseProjectCommandHandler)(deps.release);
+    const deploy = (0, deploy_project_command_1.createDeployProjectCommandHandler)(deps.deploy);
+    return async (input) => {
+        const subCommand = input.positionals[0];
+        switch (subCommand) {
+            case "build":
+                return build(input);
+            case "release":
+                return release(input);
+            case "deploy":
+                return deploy(input);
+            default:
+                return (0, command_result_1.commandError)("错误: 未知的子命令。目前仅支持: build, release, deploy", "invalid_subcommand", 1);
+        }
+    };
+}

package/bin/commands/release-project-command.js

@@ -5,11 +5,11 @@ const parse_args_1 = require("../app/parse-args");
 const release_project_service_1 = require("../services/release-project-service");
 function createReleaseProjectCommandHandler(deps) {
     return async (input) => {
-        const firstPositional = (0, parse_args_1.parseCommandPositionals)(input.rawArgs)[0];
+        const firstPositional = (0, parse_args_1.parseProjectTailPositionals)(input.rawArgs)[0];
         const tag = typeof firstPositional === "string" && firstPositional.trim() !== ""
             ? firstPositional.trim()
             : undefined;
-        const options = (0, parse_args_1.parseCommandOptions)(input.rawArgs);
+        const options = (0, parse_args_1.parseCommandOptions)(input.rawArgs, "project");
         const cliOverrides = {
             tag,
             profile: options.profile,

package/bin/services/build-project-service.js

@@ -76,13 +76,36 @@ function getBuildTargets(projectRoot, config) {
         projectDir: resolveBuildTarget(projectRoot, item.projectDir),
     }));
 }
+function resolveArtifactsBuildSlice(config) {
+    const artifacts = config.artifacts;
+    if (artifacts && typeof artifacts === "object" && !Array.isArray(artifacts)) {
+        const a = artifacts;
+        return {
+            frontend: a.frontend ?? config.frontend,
+            backend: a.backend ?? config.backend,
+            copyFiles: a.copyFiles ?? config.copyFiles,
+        };
+    }
+    return {
+        frontend: config.frontend,
+        backend: config.backend,
+        copyFiles: config.copyFiles,
+    };
+}
 function toBuildProjectConfig(config) {
-    const frontendRaw = config.frontend;
-    const backendRaw = config.backend;
+    const slice = resolveArtifactsBuildSlice(config);
+    const frontendRaw = slice.frontend;
+    if (!Array.isArray(frontendRaw) || frontendRaw.length === 0) {
+        throw new Error("配置字段无效: frontend (至少包含一个构建项)");
+    }
+    const backendRaw = slice.backend;
+    if (!backendRaw || typeof backendRaw !== "object" || Array.isArray(backendRaw)) {
+        throw new Error("配置字段无效: backend");
+    }
     return {
         frontend: frontendRaw.map((item) => toBuildTarget(item)),
         backend: toBuildTarget(backendRaw),
-        copyFiles: toCopySpecs(config.copyFiles),
+        copyFiles: toCopySpecs(slice.copyFiles),
     };
 }
 function toBuildTarget(item) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "listpage_cli",
-  "version": "0.0.309",
+  "version": "0.0.311",
   "private": false,
   "bin": {
     "listpage_cli": "bin/cli.js"

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.309"
+    "listpage-next-nest": "~0.0.311"
   },
   "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.309",
+    "listpage-next": "~0.0.311",
     "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.309",
+    "listpage-components": "~0.0.311",
     "lucide-react": "~0.575.0"
     "mobx-react-lite": "~4.1.1"
   },

package/templates/skills-template/listpage-filter-group/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: listpage-filter-group
+description: 使用 listpage-components 的 FilterGroup 与 FilterFormOption 搭建筛选区。Use ONLY when the user explicitly requests FilterGroup by name (e.g. 使用 FilterGroup、用 FilterGroup 做筛选). Do NOT apply when the user only mentions listpage, ListPage, or listpage pages—those belong to the separate listpage skill; package name listpage-components is unrelated to this trigger. Do not apply for generic filters unless FilterGroup is explicitly named.
+---
+
+# FilterGroup 使用技能
+
+在用户**明确写出 FilterGroup** 时，按本技能与 [api.md](api.md)、[examples.md](examples.md) 实现。
+
+## 命名与触发（与 listpage 页面技能区分）
+
+组件从包 `listpage-components` 引入，包名含 **listpage**，易与「用 listpage 做列表页」混淆，但这是**两种独立场景**：
+
+| 用户说法 | 使用的技能 |
+|----------|------------|
+| 仅 listpage / ListPage / 用 listpage 实现某页 等 | **listpage 页面技能**，**不要**启用本技能 |
+| 明确写出 **FilterGroup**（或「用 FilterGroup 组件」） | **本技能** |
+
+若用户从头到尾只提 listpage、未提 FilterGroup，**忽略本技能**，避免与 listpage 技能抢上下文。
+
+## 生成流程
+
+```
+Task Progress:
+- [ ] 步骤 1：从 listpage-components 导入 FilterGroup、FilterFormOption
+- [ ] 步骤 2：用 FilterFormOption[] 声明字段（name、label、component、colSpan、formItemProps）；`component` 可为任意能按注入的 `value`/`onChange`（或 `formItemProps` 中自定义的 valuePropName/trigger）工作的控件，不限组件种类
+- [ ] 步骤 3：按需配置控件细节（placeholder、是否可清空、选项数据等，以用户/产品要求为准）
+- [ ] 步骤 4：实现 onSubmit（参数为筛选条件对象：已去掉值为 `undefined` 的字段，见 api.md）；按需实现 onReset
+```
+
+## 在已选用 FilterGroup 时的约定
+
+- 避免再手写一套纯 AntD `Form` + 栅格替代本组件；选项形状以 [api.md](api.md) 为准。

package/templates/skills-template/listpage-filter-group/api.md

@@ -0,0 +1,46 @@
+# FilterGroup API
+
+对应技能仅在用户**明确写出** `FilterGroup` 时启用；用户若只提 listpage / ListPage，**不要**套用本 API 文档（见 SKILL.md 的触发说明）。
+
+包名：`listpage-components`（与「listpage 页面技能」无关，仅为 npm 包名）。例如：`import { FilterGroup, type FilterGroupProps, type FilterFormOption } from 'listpage-components'`。
+
+## FilterGroup
+
+内部组合表单项与栅格布局。
+
+### 提交给 `onSubmit` 的数据
+
+点击「搜索」或触发与提交等价的逻辑时，`onSubmit` 收到的是**当前筛选条件对象**：在表单取值之后，会**去掉值为 `undefined` 的字段**再传入，便于直接用于请求参数或状态；值为 `null` 的字段会保留，是否参与请求由业务决定。
+
+重置流程中在调用 `onReset` 之前，也会用**同样规则**得到当前表单值并调用一次 `onSubmit`（见下）。
+
+### FilterGroupProps
+
+| 属性 | 类型 | 说明 |
+|------|------|------|
+| `options` | `FilterFormOption[]` | 筛选项配置（必填） |
+| `initialValues` | `FormValue` | 表单初始值 |
+| `onSubmit` | `(values?: FormValue) => void` | 筛选条件变化需提交时触发，参数为上一节说明的对象 |
+| `onReset` | `() => void` | 重置时额外回调（在内部已 `resetFields`、并会再触发一次 `onSubmit` 之后调用） |
+
+**重置行为（需牢记）**：用户点「重置」时，会先清空字段，再按上述规则调用 `onSubmit`，最后调用 `onReset`。若你只关心「条件变化后拉数」，通常只实现 `onSubmit` 即可。
+
+## FilterFormOption
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `name` | `string` | 表单字段名（必填） |
+| `label` | `ReactNode` | 标签文案 |
+| `component` | `ReactElement` | 筛选项控件，**具体用哪种组件不限制**（见下） |
+| `colSpan` | `number` | 栅格占位，对应 12 列网格，**默认 2** |
+| `formItemProps` | 除 `children` 外的 `FormItemProps` | 传给 `Form.Item` 的额外配置；若控件不用 `value`/`onChange`，可在此设 `valuePropName`、`trigger` |
+
+### `component` 与受控
+
+`FilterItem` 会对 `component` 做 `cloneElement`，注入**当前值**与**变更回调**（默认对应受控的 `value` 与 `onChange`，与 Ant Design Form 常见写法一致）。只要传入的节点能按注入后的 props 作为受控组件工作即可，**不限定**必须是 `Input`、`Select`、`DatePicker` 等某一种。
+
+若控件使用其它字段名（例如 `checked`），通过 `formItemProps.valuePropName`、`formItemProps.trigger` 与 Ant Design `Form.Item` 约定一致即可。
+
+未提供 `component` 时，该筛选项使用默认的 `Input`。
+
+布局使用内部 `FilterGridLayout`（`grid-cols-12`），操作按钮占一列；筛选项 `colSpan` 为 1–12。

package/templates/skills-template/listpage-filter-group/examples.md

@@ -0,0 +1,82 @@
+# FilterGroup 示例
+
+本技能仅在用户**明确写出 FilterGroup** 时启用；以下为实现参考。
+
+## 仅筛选区 + 本地状态或请求
+
+示例里使用 `Input` / `Select` / `DatePicker` 仅为演示；`component` 可换成任意合适的受控控件（见 [api.md](api.md) 中 `component` 说明）。示例中部分使用 `allowClear` 仅为常见写法，以实际需求为准。
+
+```tsx
+import { useState, useCallback } from 'react';
+import { Input, Select, DatePicker } from 'antd';
+import type { Dayjs } from 'dayjs';
+import {
+  FilterGroup,
+  type FilterFormOption,
+} from 'listpage-components';
+
+type FilterValues = {
+  keyword?: string;
+  status?: string;
+  date?: Dayjs;
+};
+
+export function ReportFilterPanel() {
+  const [filters, setFilters] = useState<FilterValues>({});
+
+  const options: FilterFormOption[] = [
+    {
+      name: 'keyword',
+      label: '关键词',
+      colSpan: 3,
+      component: <Input placeholder="请输入" allowClear />,
+    },
+    {
+      name: 'status',
+      label: '状态',
+      colSpan: 2,
+      component: (
+        <Select
+          allowClear
+          placeholder="全部"
+          options={[
+            { label: '启用', value: '1' },
+            { label: '停用', value: '0' },
+          ]}
+        />
+      ),
+    },
+    {
+      name: 'date',
+      label: '日期',
+      colSpan: 3,
+      component: <DatePicker className="w-full" allowClear />,
+    },
+  ];
+
+  const handleSubmit = useCallback((values?: FilterValues) => {
+    setFilters(values ?? {});
+    // 此处可改为调用 API：fetchReport({ ...values })
+  }, []);
+
+  return (
+    <div className="bg-white px-6 py-4 rounded-lg border border-[#f0f0f0]">
+      <FilterGroup<FilterValues>
+        options={options}
+        initialValues={filters}
+        onSubmit={handleSubmit}
+        onReset={() => {
+          /* 可选：仅重置以外的副作用 */
+        }}
+      />
+    </div>
+  );
+}
+```
+
+## 自检
+
+- 各控件的交互（是否可清空、选项来源等）与用户/产品要求一致
+- `name` 与类型/接口字段一致
+- 理解「重置」会再次触发 `onSubmit`，避免重复请求未做防抖时可在业务侧处理
+