@meet-im/lxcli 0.1.3 → 0.1.5

package/dist/commands/auth.js

@@ -15,14 +15,22 @@ function parseEnv(value) {
     return value;
 }
 export function registerAuthCommand(program) {
+    const tenantNames = getTenantNames();
     program
         .command('auth <name> [token]')
         .description('Add user authentication')
-        .requiredOption('--tenant <tenant>', `Tenant name (${getTenantNames().join(', ')})`)
+        .requiredOption('--tenant <tenant>', `Account owning tenant (${tenantNames.join(', ')})`)
         .option('--token-env <envName>', 'Read token from environment variable')
         .option('--token-stdin', 'Read token from stdin')
         .option('-e, --env <env>', `Environment (${ENVIRONMENTS.join(', ')})`, parseEnv, 'prod')
         .option('--company <id>', 'Company ID (default: 1)', Number, 1)
+        .addHelpText('after', `
+Tenant selection:
+  --tenant identifies the account's owning tenant.
+  If the user has not explicitly provided it, ask the user which tenant the account belongs to: ${tenantNames.slice(0, -1).join(', ')}, or ${tenantNames.at(-1)}.
+  Wait for confirmation before constructing the auth command.
+  Do not infer it from the username, default user, or existing configuration.
+`)
         .action((name, token, options) => {
         const { tenant, env, company, tokenEnv, tokenStdin } = options;
         if (!tenantExists(tenant)) {

package/dist/commands/generate-skills.js

@@ -3,12 +3,32 @@ import { promises as fs } from 'fs';
 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_SHORTCUT_PARAMS, METHOD_SKILL_METADATA } from './services/kb/skill-metadata.js';
+import { METHODS as KB_METHODS, PARAM_DEFS as KB_PARAM_DEFS, METHOD_DESCRIPTIONS as KB_METHOD_DESCRIPTIONS, } from './services/kb/descriptions.js';
+import { METHOD_SHORTCUT_PARAMS as KB_METHOD_SHORTCUT_PARAMS, METHOD_SKILL_METADATA as KB_METHOD_SKILL_METADATA, } from './services/kb/skill-metadata.js';
+import { METHODS as MEET_METHODS, PARAM_DEFS as MEET_PARAM_DEFS, METHOD_DESCRIPTIONS as MEET_METHOD_DESCRIPTIONS, } from './services/meet/descriptions.js';
+import { METHOD_SHORTCUT_PARAMS as MEET_METHOD_SHORTCUT_PARAMS, METHOD_SKILL_METADATA as MEET_METHOD_SKILL_METADATA, } from './services/meet/skill-metadata.js';
 const API_ROOT = path.resolve('api');
 const DEFAULT_SKILLS_DIR = path.resolve('api/skills');
 const DEFAULT_OUTPUT = 'api/docs/skills.md';
 const PACKAGE_JSON_PATH = path.resolve('package.json');
+const SERVICE_SKILL_DEFINITIONS = {
+    kb: {
+        displayName: 'Kanboard',
+        methods: KB_METHODS,
+        descriptions: KB_METHOD_DESCRIPTIONS,
+        paramDefs: KB_PARAM_DEFS,
+        shortcutParams: KB_METHOD_SHORTCUT_PARAMS,
+        metadata: KB_METHOD_SKILL_METADATA,
+    },
+    meet: {
+        displayName: 'MeetIM',
+        methods: MEET_METHODS,
+        descriptions: MEET_METHOD_DESCRIPTIONS,
+        paramDefs: MEET_PARAM_DEFS,
+        shortcutParams: MEET_METHOD_SHORTCUT_PARAMS,
+        metadata: MEET_METHOD_SKILL_METADATA,
+    },
+};
 // 分类配置：前缀 -> 分类名/描述
 const CATEGORY_CONFIG = {
     'lxcli-builtin': { title: 'Builtin', description: 'lxcli 内置命令。' },
@@ -199,14 +219,16 @@ function buildParamsExample(params) {
     }
     return paramsExample;
 }
-function renderSkillMd(method, version) {
-    const description = METHOD_DESCRIPTIONS[method];
-    const metadata = METHOD_SKILL_METADATA[method];
-    const params = metadata?.skillParams || PARAM_DEFS[method] || [];
-    const skillName = `lxcli-kb-${camelToKebab(method)}`;
+function renderSkillMd(method, version, serviceName, service) {
+    const serviceCommand = `lxcli ${serviceName}`;
+    const methodCommand = `${serviceCommand} ${method}`;
+    const description = service.descriptions[method];
+    const metadata = service.metadata[method];
+    const params = metadata?.skillParams || service.paramDefs[method] || [];
+    const skillName = `lxcli-${serviceName}-${camelToKebab(method)}`;
     const hasParams = params.length > 0;
     // 快捷参数列表（显式配置，不从 required 自动推断）
-    const shortcutParams = METHOD_SHORTCUT_PARAMS[method] || [];
+    const shortcutParams = service.shortcutParams[method] || [];
     const shortcuts = shortcutParams.map((name) => {
         const param = params.find((p) => p.name === name);
         if (!param) {
@@ -214,8 +236,8 @@ function renderSkillMd(method, version) {
         }
         return `--${param.name} <${param.type === 'integer' ? 'ID' : 'VALUE'}>`;
     });
-    const shortcutUsage = metadata?.shortcutUsageExample || (shortcuts.length > 0 ? `lxcli kb ${method} ${shortcuts.join(' ')}` : '');
-    const paramsUsage = hasParams ? `lxcli kb ${method} --params '${JSON.stringify(metadata?.paramsExample || buildParamsExample(params))}'` : '';
+    const shortcutUsage = metadata?.shortcutUsageExample || (shortcuts.length > 0 ? `${methodCommand} ${shortcuts.join(' ')}` : '');
+    const paramsUsage = hasParams ? `${methodCommand} --params '${JSON.stringify(metadata?.paramsExample || buildParamsExample(params))}'` : '';
     // Usage 部分
     const usageLines = ['## Usage', '', '```bash'];
     if (hasParams) {
@@ -225,21 +247,21 @@ function renderSkillMd(method, version) {
         usageLines.push(paramsUsage);
     }
     else {
-        usageLines.push(`lxcli kb ${method}`);
+        usageLines.push(methodCommand);
     }
     usageLines.push('```', '');
     // 快捷参数说明
     if (hasParams && shortcutUsage) {
         usageLines.push(`快捷参数使用见上方；\`--params\` 用于完整参数场景。若同时传入，CLI 优先使用 \`--params\`。`, '');
-        usageLines.push(`完整参数与最新 CLI 帮助请查看 \`lxcli kb ${method} --help\`。`, '');
+        usageLines.push(`完整参数与最新 CLI 帮助请查看 \`${methodCommand} --help\`。`, '');
     }
     else if (hasParams) {
-        usageLines.push(`完整参数与最新 CLI 帮助请查看 \`lxcli kb ${method} --help\`。`, '');
+        usageLines.push(`完整参数与最新 CLI 帮助请查看 \`${methodCommand} --help\`。`, '');
     }
     // 组装 SKILL.md
     const frontmatter = `---
 name: ${skillName}
-description: "Kanboard: ${description}"
+description: "${service.displayName}: ${description}"
 metadata:
   version: ${version}
   openclaw:
@@ -247,21 +269,32 @@ metadata:
     requires:
       bins:
         - lxcli
-    cliHelp: "lxcli kb ${method} --help"
+    cliHelp: "${methodCommand} --help"
 ---`;
     const lines = [
         frontmatter,
         '',
-        `# kb ${method}`,
+        `# ${serviceName} ${method}`,
         '',
         description + '。',
         '',
+        '## Network approval',
+        '',
+        'This service command requires outbound network access.',
+        '',
+        `- Treat every \`${serviceCommand}\` invocation as requiring network access.`,
+        '- If the runtime reports outbound network access is enabled, execute directly.',
+        '- If access is disabled, or the runtime does not expose network status, request sandbox escalation for the first actual service command.',
+        '- Use the justification: "需要访问远程服务 API 执行请求。"',
+        `- Request the reusable command prefix \`${serviceCommand}\` when supported.`,
+        '- Do not run a separate network probe before the service command.',
+        '',
         ...usageLines,
     ];
     if (hasParams) {
         lines.push(renderParamsTable(params));
     }
-    lines.push('## Examples', '', '```bash', shortcutUsage || paramsUsage || `lxcli kb ${method}`, '```', '');
+    lines.push('## Examples', '', '```bash', shortcutUsage || paramsUsage || methodCommand, '```', '');
     const extraSections = renderExtraSections(metadata);
     if (extraSections) {
         lines.push(extraSections);
@@ -275,12 +308,12 @@ function camelToKebab(str) {
     return str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();
 }
 async function generateServiceSkills(skillsDir, serviceName, force) {
-    // 目前只支持 kb 服务
-    if (serviceName !== 'kb') {
-        logger.info(`Service "${serviceName}" is not supported. Supported services: kb`);
+    const service = SERVICE_SKILL_DEFINITIONS[serviceName];
+    if (!service) {
+        logger.info(`Service "${serviceName}" is not supported. Supported services: ${Object.keys(SERVICE_SKILL_DEFINITIONS).join(', ')}`);
         return;
     }
-    const methods = Object.keys(PARAM_DEFS);
+    const methods = service.methods;
     const version = await readPackageVersion();
     for (const method of methods) {
         const skillName = `lxcli-${serviceName}-${camelToKebab(method)}`;
@@ -298,7 +331,7 @@ async function generateServiceSkills(skillsDir, serviceName, force) {
             }
         }
         await fs.mkdir(skillDir, { recursive: true });
-        const content = renderSkillMd(method, version);
+        const content = renderSkillMd(method, version, serviceName, service);
         await fs.writeFile(skillPath, content, 'utf-8');
         logger.info(`Generated ${skillName}/SKILL.md`);
     }

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

@@ -47,13 +47,15 @@ function renderMethodExtraHelp(method) {
     }
     return lines.join('\n');
 }
-function addParamsOption(command, method) {
+function addParamsOption(command, method, required = false) {
     const paramsHelp = renderParamsHelp(method);
     const extraHelp = renderMethodExtraHelp(method);
     const description = paramsHelp
         ? `JSON/JSON5 params; CLI fills jsonrpc/method/id\n${paramsHelp}${extraHelp ? `\n${extraHelp}` : ''}`
         : 'JSON/JSON5 params; CLI fills jsonrpc/method/id';
-    return command.option('--params <json>', description);
+    return required
+        ? command.requiredOption('--params <json>', description)
+        : command.option('--params <json>', description);
 }
 const kbService = {
     name: 'kb',
@@ -199,10 +201,11 @@ const kbService = {
             item !== 'createTaskFile' &&
             item !== 'downloadTaskFile' &&
             item !== 'createProjectFile')) {
-            cmd
+            const methodCommand = cmd
                 .command(method)
-                .description(METHOD_DESCRIPTIONS[method])
-                .requiredOption('--params <json>', 'JSON/JSON5 params only; CLI fills jsonrpc/method/id')
+                .description(METHOD_DESCRIPTIONS[method]);
+            addParamsOption(methodCommand, method, true);
+            methodCommand
                 .option('--user <user>', 'Specify user')
                 .option('--gateway <url>', 'Override kanboard gateway')
                 .action(createKbAction(method));

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

@@ -49,7 +49,7 @@ export const PARAM_DEFS = {
         { name: 'owner_id', type: 'integer', required: false, description: '处理人 Kanboard 用户 ID。处理人必须可分配到该项目。' },
         { name: 'creator_id', type: 'integer', required: false, description: '创建人 Kanboard 用户 ID。登录态存在时创建人会使用当前用户。' },
         { name: 'category_id', type: 'integer', required: false, description: '分类 ID。服务端会根据分类和 bug 类型选择泳道。' },
-        { name: 'iteration_id', type: 'integer', required: false, description: '迭代 ID；未传或为 0 时由服务端选择需求池或首个迭代。' },
+        { name: 'iteration_id', type: 'integer', required: false, description: '迭代 ID；未传或为 0 时由服务端选择需求池或首个迭代。可用 getAllActiveIterations 查询启用迭代列表，根据 date_start/date_end（Unix 时间戳）确定目标迭代。' },
         { name: 'date_due', type: 'string', required: false, description: '截止日期，建议使用 YYYY-MM-DD' },
         { name: 'date_started', type: 'string', required: false, description: '开始日期，建议使用 YYYY-MM-DD' },
         { name: 'priority', type: 'integer', required: false, description: '优先级：0 高、1 中、2 低，其他值为无关紧要' },
@@ -58,6 +58,7 @@ export const PARAM_DEFS = {
         { name: 'cc_id', type: 'array<string>', required: false, description: '抄送人列表。数组元素格式为 用户ID-用户名称，例如 ["22-Alice", "33-Bob"]；未传时不设置抄送人。' },
         { name: 'is_bug', type: 'integer', required: false, description: '是否为 bug，1 表示 bug，0 表示需求' },
         { name: 'platform', type: 'string', required: false, description: 'bug 平台，例如 Server，未传时保存为空字符串' },
+        { name: 'bug_test', type: 'integer', required: false, description: 'bug 测试人员的 Kanboard 用户 ID，即 queryUsers 返回项中的 id（不是 oauth2_uid）。传入前先调用 queryUsers 查询确认；正整数必须是项目可分配用户，0 表示不指定；未传时使用服务端默认。' },
         { name: 'related_task_id', type: 'integer', required: false, description: '关联需求 ID。创建 bug 时可传入对应的需求 ID，建立 bug 与需求的关联；未传时不关联。' },
     ],
     createSubtask: [
@@ -74,7 +75,7 @@ export const PARAM_DEFS = {
         { name: 'description', type: 'string', required: false, description: '描述内容（Markdown）' },
         { name: 'owner_id', type: 'integer', required: false, description: '处理人用户 ID。目标用户必须可分配到该项目。' },
         { name: 'category_id', type: 'integer', required: false, description: '分类 ID' },
-        { name: 'iteration_id', type: 'integer', required: false, description: '迭代 ID。传入后修改需求/bug 所属迭代；未传时保持原迭代不变。' },
+        { name: 'iteration_id', type: 'integer', required: false, description: '迭代 ID。传入后修改需求/bug 所属迭代；未传时保持原迭代不变。可用 getAllActiveIterations 查询启用迭代列表，根据 date_start/date_end（Unix 时间戳）确定目标迭代。' },
         { name: 'date_due', type: 'string', required: false, description: '截止日期，建议使用 YYYY-MM-DD' },
         { name: 'date_started', type: 'string', required: false, description: '开始日期，建议使用 YYYY-MM-DD' },
         { name: 'priority', type: 'integer', required: false, description: '优先级：0 高、1 中、2 低，其他值为无关紧要' },
@@ -83,6 +84,7 @@ export const PARAM_DEFS = {
         { name: 'reference', type: 'string', required: false, description: '外部引用编号' },
         { name: 'tags', type: 'array<string>', required: false, description: '标签列表，例如 ["Meet", "Sky", "Co"]' },
         { name: 'cc_id', type: 'array<string>', required: false, description: '抄送人列表。数组元素格式为 用户ID-用户名称，例如 ["22-Alice", "33-Bob"]；传空数组 [] 表示清空抄送人，未传则保持不变。' },
+        { name: 'bug_test', type: 'integer', required: false, description: 'bug 测试人员的 Kanboard 用户 ID，即 queryUsers 返回项中的 id（不是 oauth2_uid）。传入前先调用 queryUsers 查询确认；正整数必须是项目可分配用户，0 表示清空；未传时保持不变。' },
         { name: 'related_task_id', type: 'integer', required: false, description: '修改 bug 时可传入要关联的需求 ID。仅当前任务是 bug 时生效；目标必须是已存在的需求（is_bug = 0）。' },
         { name: 'time_spent', type: 'number', required: false, description: '已花费时间' },
         { name: 'time_estimated', type: 'number', required: false, description: '预估时间' },

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

@@ -26,6 +26,42 @@ export const METHOD_SKILL_METADATA = {
             '仅在确实需要时才传 `with_comments`、`with_files`、`with_links`、`with_subtasks`，避免把额外第三方内容带入代理上下文。',
         ],
     },
+    getAllActiveIterations: {
+        paramsExample: {
+            project_id: 4,
+        },
+        sections: [
+            {
+                title: '返回值说明',
+                kind: 'bullets',
+                items: [
+                    '返回数组中每个对象包含 `id`、`name`、`date_start`、`date_end`、`position`、`nb_open_tasks`、`nb_closed_tasks` 等字段。',
+                    '`date_start` 和 `date_end` 是 **Unix 时间戳**（秒级整数），`0` 表示未设置。显示或比较前需转换为可读日期。',
+                ],
+            },
+            {
+                title: '确定下个迭代',
+                kind: 'bullets',
+                items: [
+                    '将当前时间转为 Unix 时间戳（秒），筛选 `date_start > 当前时间戳` 的迭代。',
+                    '在筛选结果中取 `date_start` 最小的那个，即为"下个迭代"。',
+                    '若所有迭代的 `date_start` 都 ≤ 当前时间，说明没有未来的迭代；可取 `date_end` 最大且仍 ≥ 当前时间的迭代作为"当前迭代"。',
+                    '获得迭代后，将其 `id` 传入 `createTask --iteration_id` 或 `updateTask --iteration_id`。',
+                ],
+            },
+        ],
+    },
+    createTask: {
+        notes: [
+            '如需指定迭代，先调用 `getAllActiveIterations` 查询项目的启用迭代列表，根据 `date_start`/`date_end`（Unix 时间戳）确定目标迭代 ID，再传入 `iteration_id`。',
+            '如需指定 bug 测试人员，先调用 `queryUsers` 查询目标用户，再将返回项中的 Kanboard 用户 `id` 传入 `bug_test`；不要使用 `oauth2_uid`。',
+        ],
+    },
+    updateTask: {
+        notes: [
+            '如需修改 bug 测试人员，先调用 `queryUsers` 查询目标用户，再将返回项中的 Kanboard 用户 `id` 传入 `bug_test`；不要使用 `oauth2_uid`。',
+        ],
+    },
     searchTasks: {
         paramsExample: {
             project_id: 4,

package/package.json

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