@meet-im/lxcli 0.0.2 → 0.0.4

package/dist/commands/generate-skills.js

@@ -4,6 +4,7 @@ import * as path from 'path';
 import { outputCliError } from '../core/error.js';
 import { logger } from '../core/logger.js';
 import { PARAM_DEFS, METHOD_DESCRIPTIONS } from './services/kb/descriptions.js';
+import { METHOD_SKILL_METADATA } from './services/kb/skill-metadata.js';
 const API_ROOT = path.resolve('api');
 const DEFAULT_SKILLS_DIR = path.resolve('api/skills');
 const DEFAULT_OUTPUT = 'api/docs/skills.md';
@@ -157,6 +158,7 @@ async function readPackageVersion() {
 function renderSkillMd(method, version) {
     const description = METHOD_DESCRIPTIONS[method];
     const params = PARAM_DEFS[method] || [];
+    const metadata = METHOD_SKILL_METADATA[method];
     const skillName = `lxcli-kb-${method}`;
     const hasParams = params.length > 0;
     // 快捷参数列表
@@ -223,6 +225,9 @@ metadata:
         lines.push(renderParamsTable(params));
     }
     lines.push('## Examples', '', '```bash', shortcutUsage || `lxcli kb ${method}`, '```', '');
+    if (metadata?.notes?.length) {
+        lines.push('## Notes', '', ...metadata.notes.map((note) => `- ${note}`), '');
+    }
     return lines.join('\n');
 }
 async function generateServiceSkills(skillsDir, serviceName) {

package/dist/commands/services/kb/config.js

@@ -2,25 +2,25 @@
 // kanboard gateway 配置（按企业、按环境）
 // 实际地址需要根据部署环境配置
 const meetGateways = {
-    test: 'https://kanboard-test.miyachat.com',
+    test: 'https://kanboard-staging.miyachat.com',
     pre: 'https://kanboard-pre.miyachat.com',
     staging: 'https://kanboard-staging.miyachat.com',
-    beta: 'https://kanboard-beta.miyachat.com',
+    beta: 'https://kanboard-staging.miyachat.com',
     prod: 'https://kanboard.miyachat.com',
 };
 const coGateways = {
-    test: 'https://kanboard-test.co.example.com',
-    pre: 'https://kanboard-pre.co.example.com',
-    staging: 'https://kanboard-staging.co.example.com',
-    beta: 'https://kanboard-beta.co.example.com',
-    prod: 'https://kanboard.co.example.com',
+    test: 'https://kanboard.mecord668.com',
+    pre: 'https://kanboard.mecord668.com',
+    staging: 'https://kanboard.mecord668.com',
+    beta: 'https://kanboard.mecord668.com',
+    prod: 'https://kanboard.mecord668.com',
 };
 const skyGateways = {
-    test: 'https://kanboard-test.sky.example.com',
-    pre: 'https://kanboard-pre.sky.example.com',
-    staging: 'https://kanboard-staging.sky.example.com',
-    beta: 'https://kanboard-beta.sky.example.com',
-    prod: 'https://kanboard.sky.example.com',
+    test: 'https://kanboard.2tianxin.com',
+    pre: 'https://kanboard.2tianxin.com',
+    staging: 'https://kanboard.2tianxin.com',
+    beta: 'https://kanboard.2tianxin.com',
+    prod: 'https://kanboard.2tianxin.com',
 };
 export const kbConfig = {
     name: 'kb',

package/dist/commands/services/kb/descriptions.js

@@ -16,10 +16,13 @@ export const METHOD_DESCRIPTIONS = {
     createTask: '创建需求/bug',
     createSubtask: '创建子任务',
     updateTask: '修改需求',
+    updateSubtask: '更新子任务',
     getAllComments: '获取评论列表',
     createComment: '对需求增加评论',
     createProjectFile: '上传附件到项目',
+    downloadProjectFile: '下载项目附件',
     createTaskFile: '上传附件到需求',
+    downloadTaskFile: '下载需求附件',
 };
 // 重新导出 params.ts 的类型和定义，方便其他模块使用
 export { PARAM_DEFS } from './params.js';

package/dist/commands/services/kb/handler.d.ts

@@ -4,9 +4,15 @@ export interface KbCommandOptions {
     task_id?: string;
     title?: string;
     project_id?: string;
+    file_id?: string;
+    owner_id?: string;
+    category_id?: string;
     query?: string;
+    user_id?: string;
+    content?: string;
     user?: string;
     gateway?: string;
     file?: string;
+    out?: string;
 }
 export declare function createKbAction(method: Method): (options: KbCommandOptions) => Promise<void>;

package/dist/commands/services/kb/handler.js

@@ -1,4 +1,4 @@
-import { readFile } from 'fs/promises';
+import { readFile, writeFile } from 'fs/promises';
 import { basename } from 'path';
 import { getCurrentUser, getGatewayForUser } from '../../../core/auth.js';
 import { outputCliError } from '../../../core/error.js';
@@ -87,13 +87,15 @@ export function createKbAction(method) {
             }
             params = { task_id: taskId };
         }
-        else if (method === 'createTask' && options.title && options.project_id) {
+        else if (method === 'createTask' && options.title && options.project_id && options.owner_id && options.category_id) {
             const projectId = parseTaskId(options.project_id);
-            if (projectId === null) {
-                outputCliError('PARAM_INVALID', '--project_id must be a positive integer');
+            const ownerId = parseTaskId(options.owner_id);
+            const categoryId = parseTaskId(options.category_id);
+            if (projectId === null || ownerId === null || categoryId === null) {
+                outputCliError('PARAM_INVALID', '--project_id, --owner_id and --category_id must be positive integers');
                 return;
             }
-            params = { title: options.title, project_id: projectId };
+            params = { title: options.title, project_id: projectId, owner_id: ownerId, category_id: categoryId };
         }
         else if (method === 'searchTasks' && options.project_id && options.query) {
             const projectId = parseTaskId(options.project_id);
@@ -127,6 +129,24 @@ export function createKbAction(method) {
             }
             params = { task_id: taskId };
         }
+        else if (method === 'createComment' && options.task_id && options.user_id && options.content) {
+            const taskId = parseTaskId(options.task_id);
+            const userId = options.user_id === '0' ? 0 : parseTaskId(options.user_id);
+            if (taskId === null || userId === null) {
+                outputCliError('PARAM_INVALID', '--task_id and --user_id must be non-negative integers');
+                return;
+            }
+            params = { task_id: taskId, user_id: userId, content: options.content };
+        }
+        else if (method === 'downloadProjectFile' && options.project_id && options.file_id) {
+            const projectId = parseTaskId(options.project_id);
+            const fileId = parseTaskId(options.file_id);
+            if (projectId === null || fileId === null) {
+                outputCliError('PARAM_INVALID', '--project_id and --file_id must be positive integers');
+                return;
+            }
+            params = { project_id: projectId, file_id: fileId };
+        }
         else if (method === 'createProjectFile' && options.file && options.project_id) {
             const projectId = parseTaskId(options.project_id);
             if (projectId === null) {
@@ -144,6 +164,14 @@ export function createKbAction(method) {
                 return;
             }
         }
+        else if (method === 'downloadTaskFile' && options.file_id) {
+            const fileId = parseTaskId(options.file_id);
+            if (fileId === null) {
+                outputCliError('PARAM_INVALID', '--file_id must be a positive integer');
+                return;
+            }
+            params = { file_id: fileId };
+        }
         else if (method === 'createTaskFile' && options.file && options.task_id && options.project_id) {
             const taskId = parseTaskId(options.task_id);
             const projectId = parseTaskId(options.project_id);
@@ -169,12 +197,15 @@ export function createKbAction(method) {
         else {
             const shortcuts = {
                 getTask: '--task_id',
-                createTask: '--title and --project_id',
+                createTask: '--title, --project_id, --owner_id and --category_id',
                 searchTasks: '--project_id and --query',
                 getAllActiveIterations: '--project_id',
                 getAllCategories: '--project_id',
                 getAllComments: '--task_id',
+                createComment: '--task_id, --user_id and --content',
+                downloadProjectFile: '--project_id and --file_id',
                 createProjectFile: '--file and --project_id',
+                downloadTaskFile: '--file_id',
                 createTaskFile: '--file, --task_id and --project_id',
             };
             outputCliError('PARAM_INVALID', shortcuts[method]
@@ -183,6 +214,21 @@ export function createKbAction(method) {
             return;
         }
         const result = await jsonRpcCall(gateway, method, params, user.token);
+        if ((method === 'downloadProjectFile' || method === 'downloadTaskFile') && options.out) {
+            if (typeof result !== 'string') {
+                outputCliError('PARAM_INVALID', `${method} result must be a Base64 string`);
+                return;
+            }
+            try {
+                const buffer = Buffer.from(result, 'base64');
+                await writeFile(options.out, buffer);
+                outputJson({ success: true, path: options.out, bytes: buffer.length });
+            }
+            catch (error) {
+                outputCliError('PARAM_INVALID', `Failed to write file: ${options.out}`);
+            }
+            return;
+        }
         outputJson(result);
     };
 }

package/dist/commands/services/kb/index.js

@@ -38,13 +38,15 @@ const kbService = {
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('getTask'));
-        // createTask 支持快捷参数 --title / --project_id，且 --params 仍然可用
+        // createTask 支持快捷参数 --title / --project_id / --owner_id / --category_id，且 --params 仍然可用
         cmd
             .command('createTask')
             .description(METHOD_DESCRIPTIONS.createTask)
             .option('--params <json>', 'JSON/JSON5 params; CLI fills jsonrpc/method/id')
             .option('--title <title>', 'Task title (shortcut)')
             .option('--project_id <id>', 'Project ID (shortcut)')
+            .option('--owner_id <id>', 'Owner user ID (shortcut)')
+            .option('--category_id <id>', 'Category ID (shortcut)')
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('createTask'));
@@ -85,6 +87,17 @@ const kbService = {
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('getAllComments'));
+        // createComment 支持快捷参数 --task_id / --user_id / --content
+        cmd
+            .command('createComment')
+            .description(METHOD_DESCRIPTIONS.createComment)
+            .option('--params <json>', 'JSON/JSON5 params; CLI fills jsonrpc/method/id')
+            .option('--task_id <id>', 'Task ID (shortcut)')
+            .option('--user_id <id>', 'Comment author user ID (shortcut)')
+            .option('--content <content>', 'Comment content (shortcut)')
+            .option('--user <user>', 'Specify user')
+            .option('--gateway <url>', 'Override kanboard gateway')
+            .action(createKbAction('createComment'));
         for (const method of METHODS.filter((item) => item !== 'getMe' &&
             item !== 'getMyProjects' &&
             item !== 'getTask' &&
@@ -93,7 +106,10 @@ const kbService = {
             item !== 'getAllActiveIterations' &&
             item !== 'getAllCategories' &&
             item !== 'getAllComments' &&
+            item !== 'createComment' &&
+            item !== 'downloadProjectFile' &&
             item !== 'createTaskFile' &&
+            item !== 'downloadTaskFile' &&
             item !== 'createProjectFile')) {
             cmd
                 .command(method)
@@ -113,6 +129,17 @@ const kbService = {
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('createProjectFile'));
+        // downloadProjectFile 支持快捷参数 --project_id / --file_id，可选 --out 落盘
+        cmd
+            .command('downloadProjectFile')
+            .description(METHOD_DESCRIPTIONS.downloadProjectFile)
+            .option('--params <json>', 'JSON/JSON5 params; CLI fills jsonrpc/method/id')
+            .option('--project_id <id>', 'Project ID (shortcut)')
+            .option('--file_id <id>', 'Project file ID (shortcut)')
+            .option('--out <path>', 'Write decoded file to path')
+            .option('--user <user>', 'Specify user')
+            .option('--gateway <url>', 'Override kanboard gateway')
+            .action(createKbAction('downloadProjectFile'));
         // createTaskFile 支持快捷参数 --file / --task_id / --project_id，自动转 base64
         cmd
             .command('createTaskFile')
@@ -124,6 +151,16 @@ const kbService = {
             .option('--user <user>', 'Specify user')
             .option('--gateway <url>', 'Override kanboard gateway')
             .action(createKbAction('createTaskFile'));
+        // downloadTaskFile 支持快捷参数 --file_id，可选 --out 落盘
+        cmd
+            .command('downloadTaskFile')
+            .description(METHOD_DESCRIPTIONS.downloadTaskFile)
+            .option('--params <json>', 'JSON/JSON5 params; CLI fills jsonrpc/method/id')
+            .option('--file_id <id>', 'Task file ID (shortcut)')
+            .option('--out <path>', 'Write decoded file to path')
+            .option('--user <user>', 'Specify user')
+            .option('--gateway <url>', 'Override kanboard gateway')
+            .action(createKbAction('downloadTaskFile'));
     },
 };
 export default kbService;

package/dist/commands/services/kb/params.d.ts

@@ -1,4 +1,4 @@
-export type ParamType = 'integer' | 'string' | 'array<integer>' | 'array<string>' | 'object' | 'file';
+export type ParamType = 'integer' | 'number' | 'string' | 'array<integer>' | 'array<string>' | 'object' | 'file';
 export interface ParamDef {
     name: string;
     type: ParamType;

package/dist/commands/services/kb/params.js

@@ -43,8 +43,8 @@ export const PARAM_DEFS = {
         { name: 'task_id', type: 'integer', required: true, description: '父需求/bug ID' },
         { name: 'title', type: 'string', required: true, description: '子任务标题' },
         { name: 'user_id', type: 'integer', required: false, description: '子任务处理人 Kanboard 用户 ID' },
-        { name: 'time_estimated', type: 'integer', required: false, description: '预估时间（小时）' },
-        { name: 'time_spent', type: 'integer', required: false, description: '已花费时间（小时）' },
+        { name: 'time_estimated', type: 'number', required: false, description: '预估时间（小时）' },
+        { name: 'time_spent', type: 'number', required: false, description: '已花费时间（小时）' },
         { name: 'status', type: 'integer', required: false, description: '状态：0 未开始，1 进行中，2 已完成' },
     ],
     updateTask: [
@@ -56,6 +56,16 @@ export const PARAM_DEFS = {
         { name: 'iteration_id', type: 'integer', required: false, description: '迭代 ID' },
         { name: 'column_id', type: 'integer', required: false, description: '状态列 ID' },
     ],
+    updateSubtask: [
+        { name: 'id', type: 'integer', required: true, description: '子任务 ID' },
+        { name: 'task_id', type: 'integer', required: true, description: '父需求/bug ID' },
+        { name: 'title', type: 'string', required: false, description: '子任务标题' },
+        { name: 'user_id', type: 'integer', required: false, description: '子任务处理人，传 0 表示未分配' },
+        { name: 'time_estimated', type: 'number', required: false, description: '预估时间（小时）' },
+        { name: 'time_spent', type: 'number', required: false, description: '已花费时间（小时）' },
+        { name: 'status', type: 'integer', required: false, description: '状态：0 未开始，1 进行中，2 已完成' },
+        { name: 'position', type: 'integer', required: false, description: '子任务排序位置' },
+    ],
     createComment: [
         { name: 'task_id', type: 'integer', required: true, description: '需求/bug ID' },
         { name: 'user_id', type: 'integer', required: true, description: '评论作者 Kanboard 用户 ID' },
@@ -67,10 +77,17 @@ export const PARAM_DEFS = {
         { name: 'filename', type: 'string', required: true, description: '文件名' },
         { name: 'blob', type: 'string', required: true, description: '文件内容 Base64 编码' },
     ],
+    downloadProjectFile: [
+        { name: 'project_id', type: 'integer', required: true, description: '项目 ID' },
+        { name: 'file_id', type: 'integer', required: true, description: '项目附件 ID' },
+    ],
     createTaskFile: [
         { name: 'project_id', type: 'integer', required: true, description: '项目 ID' },
         { name: 'task_id', type: 'integer', required: true, description: '需求/bug ID' },
         { name: 'filename', type: 'string', required: true, description: '文件名' },
         { name: 'blob', type: 'string', required: true, description: '文件内容 Base64 编码' },
     ],
+    downloadTaskFile: [
+        { name: 'file_id', type: 'integer', required: true, description: '需求附件 ID' },
+    ],
 };

package/dist/commands/services/kb/skill-metadata.d.ts

@@ -0,0 +1,5 @@
+import type { Method } from './descriptions.js';
+export interface MethodSkillMetadata {
+    notes?: string[];
+}
+export declare const METHOD_SKILL_METADATA: Partial<Record<Method, MethodSkillMetadata>>;

package/dist/commands/services/kb/skill-metadata.js

@@ -0,0 +1,15 @@
+export const METHOD_SKILL_METADATA = {
+    downloadProjectFile: {
+        notes: [
+            '当附件链接包含 `project_id` 时，使用 `downloadProjectFile`。',
+            '例如：`/FileViewer/browser?project_id=4&file_id=168`。',
+            '例如：`/?controller=FileViewerController&action=browser&project_id=4&file_id=168`。',
+        ],
+    },
+    downloadTaskFile: {
+        notes: [
+            '当附件链接包含 `task_id` 时，使用 `downloadTaskFile`。',
+            '例如：`?controller=FileViewerController&action=browser&task_id=2000757&file_id=3870`。',
+        ],
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meet-im/lxcli",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "连续科技命令行工具",
   "type": "module",
   "main": "dist/index.js",