@ty_krystal/sei-ai 0.1.3 → 0.1.5

package/README.md

@@ -2,7 +2,7 @@
 
 独立的 SEI MCP 服务，使用 `@modelcontextprotocol/sdk` 运行。
 支持 `stdio`、`streamable-http` 和开发者 CLI 启动，默认只开放受控的低代码查询、保存和字段元数据工具，`querySql` 默认关闭。
-构建改为使用 Vite 进行 Node 侧打包，产物输出到 `dist/`。
+CLI 已迁移到 `oclif`，命令面改为顶层子命令。
 
 ## 安装
 
@@ -26,30 +26,28 @@ pnpm -F sei-ai-mcp run test
 sei-ai help
 sei-ai stdio --config ./config.example.json
 sei-ai streamable-http --host 0.0.0.0 --port 3000 --path /mcp --config ./config.example.json
-sei-ai cli api-docs --format markdown
-sei-ai cli query-sql "SELECT _UID,_NAME FROM _SYS_USER"
-sei-ai cli call POST /api/sei/data/removeAllCache --json '{}'
+sei-ai api-docs --format markdown
+sei-ai relogin
+sei-ai query-sql "SELECT _UID,_NAME FROM _SYS_USER"
+sei-ai call POST /api/sei/data/removeAllCache --json '{}'
+sei-ai dict:list --type status
+sei-ai dict:add-category sex 性别
+sei-ai dict:add-item sex male 男
+sei-ai init:base-data --sysid sys --admin-uid admin
 ```
 
 ## 开发者 CLI
 
 CLI 是新增的开发者命令面，不会改变现有 MCP server 的启动方式、tool 列表或 Host 集成配置。
 
-首版支持：
-
-- `call`
-- `query`
-- `save`
-- `query-sql`
-- `api-docs`
-
 命令示例：
 
 ```bash
-sei-ai cli query --json '{"head":{"module":"sys_user"},"option":{"fields":"_UID,_NAME"}}'
-sei-ai cli save --json '{"head":{"module":"sys_user"},"data":[{"action":"edit","rows":[{"keyVal":"admin","row":{"_NAME":"管理员"}}]}]}'
-sei-ai cli query-sql "SELECT _UID,_NAME FROM _SYS_USER" --page 1 --size 20
-sei-ai cli api-docs --keyword login --format json
+sei-ai query --json '{"head":{"module":"sys_user"},"option":{"fields":"_UID,_NAME"}}'
+sei-ai save --json '{"head":{"module":"sys_user"},"data":[{"action":"edit","rows":[{"keyVal":"admin","row":{"_NAME":"管理员"}}]}]}'
+sei-ai query-sql "SELECT _UID,_NAME FROM _SYS_USER" --page 1 --size 20
+sei-ai api-docs --keyword login --format json
+sei-ai relogin --role admin
 ```
 
 常用认证参数：
@@ -76,12 +74,21 @@ sei-ai cli api-docs --keyword login --format json
 - `--file ./payload.json`
 - `--stdin`
 
-当前仍未覆盖：
+当前命令面：
 
-- `init-base-data`
-- 字典相关命令
-- DDL/DML
-- 文件上传下载
+- `stdio`
+- `streamable-http`
+- `query`
+- `save`
+- `call`
+- `query-sql`
+- `sql`
+- `api-docs`
+- `relogin`
+- `dict:list`
+- `dict:add-category`
+- `dict:add-item`
+- `init:base-data`
 
 HTTP 模式：
 

package/dist/README.md

@@ -2,7 +2,7 @@
 
 独立的 SEI MCP 服务，使用 `@modelcontextprotocol/sdk` 运行。
 支持 `stdio`、`streamable-http` 和开发者 CLI 启动，默认只开放受控的低代码查询、保存和字段元数据工具，`querySql` 默认关闭。
-构建改为使用 Vite 进行 Node 侧打包，产物输出到 `dist/`。
+CLI 已迁移到 `oclif`，命令面改为顶层子命令。
 
 ## 安装
 
@@ -26,30 +26,28 @@ pnpm -F sei-ai-mcp run test
 sei-ai help
 sei-ai stdio --config ./config.example.json
 sei-ai streamable-http --host 0.0.0.0 --port 3000 --path /mcp --config ./config.example.json
-sei-ai cli api-docs --format markdown
-sei-ai cli query-sql "SELECT _UID,_NAME FROM _SYS_USER"
-sei-ai cli call POST /api/sei/data/removeAllCache --json '{}'
+sei-ai api-docs --format markdown
+sei-ai relogin
+sei-ai query-sql "SELECT _UID,_NAME FROM _SYS_USER"
+sei-ai call POST /api/sei/data/removeAllCache --json '{}'
+sei-ai dict:list --type status
+sei-ai dict:add-category sex 性别
+sei-ai dict:add-item sex male 男
+sei-ai init:base-data --sysid sys --admin-uid admin
 ```
 
 ## 开发者 CLI
 
 CLI 是新增的开发者命令面，不会改变现有 MCP server 的启动方式、tool 列表或 Host 集成配置。
 
-首版支持：
-
-- `call`
-- `query`
-- `save`
-- `query-sql`
-- `api-docs`
-
 命令示例：
 
 ```bash
-sei-ai cli query --json '{"head":{"module":"sys_user"},"option":{"fields":"_UID,_NAME"}}'
-sei-ai cli save --json '{"head":{"module":"sys_user"},"data":[{"action":"edit","rows":[{"keyVal":"admin","row":{"_NAME":"管理员"}}]}]}'
-sei-ai cli query-sql "SELECT _UID,_NAME FROM _SYS_USER" --page 1 --size 20
-sei-ai cli api-docs --keyword login --format json
+sei-ai query --json '{"head":{"module":"sys_user"},"option":{"fields":"_UID,_NAME"}}'
+sei-ai save --json '{"head":{"module":"sys_user"},"data":[{"action":"edit","rows":[{"keyVal":"admin","row":{"_NAME":"管理员"}}]}]}'
+sei-ai query-sql "SELECT _UID,_NAME FROM _SYS_USER" --page 1 --size 20
+sei-ai api-docs --keyword login --format json
+sei-ai relogin --role admin
 ```
 
 常用认证参数：
@@ -76,12 +74,21 @@ sei-ai cli api-docs --keyword login --format json
 - `--file ./payload.json`
 - `--stdin`
 
-当前仍未覆盖：
+当前命令面：
 
-- `init-base-data`
-- 字典相关命令
-- DDL/DML
-- 文件上传下载
+- `stdio`
+- `streamable-http`
+- `query`
+- `save`
+- `call`
+- `query-sql`
+- `sql`
+- `api-docs`
+- `relogin`
+- `dict:list`
+- `dict:add-category`
+- `dict:add-item`
+- `init:base-data`
 
 HTTP 模式：
 

package/dist/cli-actions.js

@@ -0,0 +1,157 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { BASE_SEED_DEFAULT_ADMIN_ROLE, BASE_SEED_DEFAULT_ADMIN_UID } from './constants.js';
+import { formatCliError, SeiMcpError } from './errors.js';
+import { buildBaseSeedSqlVars, buildDictCategoryRow, buildDictItemRow, buildDictQueryPayload, buildDictSavePayload, buildDictTree, removeSqlCommentLines, renderBaseSeedSql, splitSqlStatements, } from './cli-helpers.js';
+import { buildOpenApiDocSummary, renderOpenApiMarkdown } from './openapi.js';
+export async function runApiDocs(options) {
+    const raw = await options.client.readApiDocs();
+    const summary = buildOpenApiDocSummary(raw, options.keyword);
+    const output = options.format === 'json' ? `${JSON.stringify(summary, null, 2)}\n` : renderOpenApiMarkdown(summary);
+    await writeOutput(options.outputPath, output);
+}
+export async function runRelogin(options) {
+    const token = await options.client.relogin();
+    printJson({
+        success: true,
+        code: 1,
+        message: '重新登录成功',
+        data: { token },
+    });
+}
+export async function runCall(options) {
+    const response = await options.client.call(options.method, options.path, options.payload, {
+        allowFailure: options.allowFailure,
+        allowEmpty: options.allowEmpty,
+        skipAuth: options.skipAuth,
+    });
+    printJson(response);
+}
+export async function runQuery(options) {
+    const response = await options.client.query(options.payload, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runSave(options) {
+    const response = await options.client.save(options.payload, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runQuerySql(options) {
+    const response = await options.client.querySql(options.sql, options.page, options.size, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runDictList(options) {
+    const payload = buildDictQueryPayload(options.typeCode, options.keyword, options.size ?? 1000);
+    const response = await options.client.query(payload, {
+        allowFailure: options.allowFailure,
+    });
+    if (!options.flat && isObject(response) && isObject(response.data) && Array.isArray(response.data.rows)) {
+        response.data.tree = buildDictTree(response.data.rows);
+    }
+    printJson(response);
+}
+export async function runDictAddCategory(options) {
+    const payload = buildDictSavePayload(buildDictCategoryRow({
+        body: stringOrUndefined(options.rowOptions?.body),
+        code: stringOrUndefined(options.rowOptions?.code),
+        ctype: stringOrUndefined(options.rowOptions?.ctype),
+        dictFlag: numberOrUndefined(options.rowOptions?.dictFlag),
+        ename: stringOrUndefined(options.rowOptions?.ename),
+        memo: stringOrUndefined(options.rowOptions?.memo),
+        name: options.name,
+        sort: numberOrUndefined(options.rowOptions?.sort),
+        sysid: stringOrUndefined(options.rowOptions?.sysid),
+        typeCode: options.typeCode,
+        uuid: stringOrUndefined(options.rowOptions?.uuid),
+    }));
+    const response = await options.client.save(payload, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runDictAddItem(options) {
+    const payload = buildDictSavePayload(buildDictItemRow({
+        body: stringOrUndefined(options.rowOptions?.body),
+        code: options.code,
+        ctype: stringOrUndefined(options.rowOptions?.ctype),
+        dictFlag: numberOrUndefined(options.rowOptions?.dictFlag),
+        ename: stringOrUndefined(options.rowOptions?.ename),
+        memo: stringOrUndefined(options.rowOptions?.memo),
+        name: options.name,
+        parent: stringOrUndefined(options.rowOptions?.parent),
+        sort: numberOrUndefined(options.rowOptions?.sort),
+        sysid: stringOrUndefined(options.rowOptions?.sysid),
+        typeCode: options.typeCode,
+        uuid: stringOrUndefined(options.rowOptions?.uuid),
+    }));
+    const response = await options.client.save(payload, {
+        allowFailure: options.allowFailure,
+    });
+    printJson(response);
+}
+export async function runInitBaseData(options) {
+    const sqlFile = resolveBaseSeedSqlPath(options.sqlFile);
+    const template = await readFile(sqlFile, 'utf8');
+    const sql = renderBaseSeedSql(template, buildBaseSeedSqlVars({
+        adminName: options.adminName,
+        adminPassword: options.adminPassword,
+        adminRole: options.adminRole,
+        adminRoleName: options.adminRoleName,
+        adminUid: options.adminUid,
+        resetAdminPassword: options.resetAdminPassword,
+        sysid: options.sysid,
+    }));
+    const statements = splitSqlStatements(removeSqlCommentLines(sql));
+    if (statements.length === 0) {
+        throw new SeiMcpError('初始化 SQL 文件没有可执行语句', 'INVALID_PARAMS');
+    }
+    const executed = await options.client.executeDdlStatements(statements, {
+        allowFailure: options.allowFailure,
+    });
+    await options.client.call('POST', '/api/sei/data/removeAllCache', {}, { allowFailure: false }).catch(() => undefined);
+    printJson({
+        success: true,
+        code: 1,
+        message: '基础源数据初始化完成',
+        data: {
+            executed: Array.isArray(executed) ? executed.length : 0,
+            sqlFile,
+            admin: options.adminUid ?? BASE_SEED_DEFAULT_ADMIN_UID,
+            role: options.adminRole ?? BASE_SEED_DEFAULT_ADMIN_ROLE,
+        },
+    });
+}
+export async function writeOutput(path, text) {
+    if (!path) {
+        process.stdout.write(text);
+        return;
+    }
+    await writeFile(path, text, 'utf8');
+    process.stdout.write(`已写入：${path}\n`);
+}
+export function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+export function resolveBaseSeedSqlPath(path) {
+    if (path) {
+        return resolve(path);
+    }
+    return resolve(process.cwd(), '.codex/skills/sei-ai/scripts/init-base-data.sql');
+}
+export function formatActionError(error) {
+    return formatCliError(error);
+}
+function stringOrUndefined(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function numberOrUndefined(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}

package/dist/cli-helpers.js

@@ -0,0 +1,246 @@
+import { createHash } from 'node:crypto';
+import { BASE_SEED_DEFAULT_ADMIN_PASSWORD, BASE_SEED_DEFAULT_ADMIN_ROLE, BASE_SEED_DEFAULT_ADMIN_UID, BASE_SEED_DEFAULT_SYSID, DICT_DEFAULT_SYSID, DICT_FIELDS, DICT_MODULE, } from './constants.js';
+import { SeiMcpError } from './errors.js';
+export function buildDictQueryPayload(typeCode, keyword, size = 1000) {
+    return {
+        head: {
+            module: DICT_MODULE,
+        },
+        option: {
+            keyField: true,
+            privilege: true,
+            fields: DICT_FIELDS.join(','),
+            filter: buildDictQueryFilter(typeCode, keyword),
+            order: '_SORT ASC,_CODE ASC',
+            page: 1,
+            size,
+        },
+    };
+}
+export function buildDictSavePayload(row) {
+    return {
+        head: {
+            module: DICT_MODULE,
+        },
+        data: [
+            {
+                action: 'add',
+                option: {
+                    keyVal: true,
+                },
+                rows: [
+                    {
+                        row,
+                    },
+                ],
+            },
+        ],
+    };
+}
+export function buildDictCategoryRow(input) {
+    const typeCode = requiredText(input.typeCode, '字典类别');
+    const name = requiredText(input.name, '字典名称');
+    const uuid = requiredText(input.uuid || typeCode, '字典编号');
+    const code = requiredText(input.code || typeCode, '字典代码');
+    return {
+        _UUID: uuid,
+        _PID: '',
+        _SYSID: requiredText(input.sysid || DICT_DEFAULT_SYSID, '所属系统'),
+        _TYPE: typeCode,
+        _CTYPE: normalizeText(input.ctype),
+        _CODE: code,
+        _NAME: name,
+        _ENAME: normalizeText(input.ename),
+        _DICT: normalizeDictFlag(input.dictFlag),
+        _SORT: normalizeSort(input.sort),
+        _BODY: normalizeText(input.body),
+        _MEMO: normalizeText(input.memo),
+    };
+}
+export function buildDictItemRow(input) {
+    const typeCode = requiredText(input.typeCode, '字典类别');
+    const code = requiredText(input.code, '字典代码');
+    const name = requiredText(input.name, '字典名称');
+    const parent = requiredText(input.parent || typeCode, '父级编号');
+    const uuid = requiredText(input.uuid || `${parent}_${code}`, '字典编号');
+    return {
+        _UUID: uuid,
+        _PID: parent,
+        _SYSID: requiredText(input.sysid || DICT_DEFAULT_SYSID, '所属系统'),
+        _TYPE: typeCode,
+        _CTYPE: normalizeText(input.ctype),
+        _CODE: code,
+        _NAME: name,
+        _ENAME: normalizeText(input.ename),
+        _DICT: normalizeDictFlag(input.dictFlag),
+        _SORT: normalizeSort(input.sort),
+        _BODY: normalizeText(input.body),
+        _MEMO: normalizeText(input.memo),
+    };
+}
+export function buildDictTree(rows) {
+    if (!Array.isArray(rows)) {
+        return [];
+    }
+    const recordMap = new Map();
+    const childrenMap = new Map();
+    const roots = [];
+    for (const row of rows) {
+        if (!isObject(row)) {
+            continue;
+        }
+        const key = normalizeText(row._UUID);
+        if (!key) {
+            continue;
+        }
+        recordMap.set(key, { ...row });
+    }
+    for (const record of recordMap.values()) {
+        const parentId = normalizeText(record._PID);
+        if (!parentId || !recordMap.has(parentId)) {
+            roots.push(record);
+            continue;
+        }
+        const children = childrenMap.get(parentId) ?? [];
+        children.push(record);
+        childrenMap.set(parentId, children);
+    }
+    for (const [key, record] of recordMap.entries()) {
+        const children = childrenMap.get(key);
+        if (children && children.length > 0) {
+            record.children = children.sort(dictSortKey);
+        }
+    }
+    return roots.sort(dictSortKey);
+}
+export function buildBaseSeedSqlVars(input) {
+    const adminPassword = input.adminPassword || BASE_SEED_DEFAULT_ADMIN_PASSWORD;
+    const passwordHash = createHash('md5').update(adminPassword, 'utf8').digest('hex');
+    const adminUid = input.adminUid || BASE_SEED_DEFAULT_ADMIN_UID;
+    const adminRole = input.adminRole || BASE_SEED_DEFAULT_ADMIN_ROLE;
+    const resetSql = input.resetAdminPassword === true
+        ? `UPDATE _SYS_USER\nSET _PWD = ${sqlLiteral(passwordHash)}\nWHERE _UID = ${sqlLiteral(adminUid)};`
+        : '';
+    return {
+        SYSID: sqlLiteral(input.sysid || BASE_SEED_DEFAULT_SYSID),
+        ADMIN_UID: sqlLiteral(adminUid),
+        ADMIN_NAME: sqlLiteral(input.adminName || '管理员'),
+        ADMIN_ROLE: sqlLiteral(adminRole),
+        ADMIN_ROLE_NAME: sqlLiteral(input.adminRoleName || '管理员'),
+        ADMIN_PASSWORD_MD5: sqlLiteral(passwordHash),
+        RESET_ADMIN_PASSWORD_SQL: resetSql,
+    };
+}
+export function renderBaseSeedSql(template, values) {
+    let rendered = template;
+    for (const [key, value] of Object.entries(values)) {
+        rendered = rendered.replaceAll(`{{${key}}}`, value);
+    }
+    const missing = [...rendered.matchAll(/\{\{[A-Z0-9_]+\}\}/g)].map((item) => item[0]);
+    if (missing.length > 0) {
+        throw new SeiMcpError(`初始化 SQL 存在未替换变量：${[...new Set(missing)].join(', ')}`, 'INVALID_PARAMS');
+    }
+    return rendered;
+}
+export function removeSqlCommentLines(sql) {
+    return sql
+        .split('\n')
+        .filter((line) => !line.trimStart().startsWith('--'))
+        .join('\n');
+}
+export function splitSqlStatements(sql) {
+    const statements = [];
+    let current = '';
+    let quote = null;
+    let escaped = false;
+    for (const char of sql) {
+        if (escaped) {
+            current += char;
+            escaped = false;
+            continue;
+        }
+        if (char === '\\' && quote !== null) {
+            current += char;
+            escaped = true;
+            continue;
+        }
+        if (quote !== null) {
+            current += char;
+            if (char === quote) {
+                quote = null;
+            }
+            continue;
+        }
+        if (char === '\'' || char === '"' || char === '`') {
+            current += char;
+            quote = char;
+            continue;
+        }
+        if (char === ';') {
+            const statement = current.trim();
+            if (statement) {
+                statements.push(statement);
+            }
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    const finalStatement = current.trim();
+    if (finalStatement) {
+        statements.push(finalStatement);
+    }
+    return statements;
+}
+function buildDictQueryFilter(typeCode, keyword) {
+    const filters = [];
+    const normalizedType = normalizeText(typeCode);
+    const normalizedKeyword = normalizeText(keyword);
+    if (normalizedType) {
+        filters.push({ _TYPE: { '=': normalizedType } });
+    }
+    if (normalizedKeyword) {
+        filters.push({
+            OR: [
+                { _UUID: { '*LIKE*': normalizedKeyword } },
+                { _TYPE: { '*LIKE*': normalizedKeyword } },
+                { _CODE: { '*LIKE*': normalizedKeyword } },
+                { _NAME: { '*LIKE*': normalizedKeyword } },
+            ],
+        });
+    }
+    return filters;
+}
+function dictSortKey(a, b) {
+    const sortA = normalizeSort(typeof a._SORT === 'number' ? a._SORT : Number(a._SORT ?? 0));
+    const sortB = normalizeSort(typeof b._SORT === 'number' ? b._SORT : Number(b._SORT ?? 0));
+    if (sortA !== sortB) {
+        return sortA - sortB;
+    }
+    return normalizeText(a._CODE).localeCompare(normalizeText(b._CODE), 'zh-CN');
+}
+function normalizeDictFlag(value) {
+    return value === 1 ? 1 : 0;
+}
+function normalizeSort(value) {
+    return Number.isInteger(value) && Number(value) >= 0 ? Number(value) : 100;
+}
+function requiredText(value, label) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        throw new SeiMcpError(`${label} 不能为空`, 'INVALID_PARAMS');
+    }
+    return normalized;
+}
+function normalizeText(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function sqlLiteral(value) {
+    if (value === null || value === undefined) {
+        return 'NULL';
+    }
+    return `'${String(value).replace(/'/g, "''")}'`;
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}

package/dist/command-base/context.js

@@ -0,0 +1,10 @@
+import { loadConfig } from '../config.js';
+import { DEFAULT_LOG_LEVEL } from '../constants.js';
+import { loadWorkingDirEnv } from '../env.js';
+import { createLogger } from '../logger.js';
+export async function loadCliContext(argv = process.argv.slice(2), env = process.env) {
+    await loadWorkingDirEnv();
+    const logger = createLogger(env.SEI_MCP_LOG_LEVEL ?? DEFAULT_LOG_LEVEL);
+    const config = await loadConfig(argv, env);
+    return { config, logger };
+}

package/dist/command-base/output.js

@@ -0,0 +1,6 @@
+export function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+export function writeText(text) {
+    process.stdout.write(text);
+}

package/dist/command-base/payload.js

@@ -0,0 +1,33 @@
+import { readFile } from 'node:fs/promises';
+import { SeiMcpError } from '../errors.js';
+export async function loadPayload(options) {
+    const sources = [options.stdin, options.jsonText !== undefined, options.filePath !== undefined].filter(Boolean).length;
+    if (sources > 1) {
+        throw new SeiMcpError('只能选择一种载荷来源：--json、--file 或 --stdin', 'INVALID_PARAMS');
+    }
+    if (options.jsonText !== undefined) {
+        return parseJson(options.jsonText);
+    }
+    if (options.filePath !== undefined) {
+        return parseJson(await readFile(options.filePath, 'utf8'));
+    }
+    if (options.stdin) {
+        return parseJson(await readStdin());
+    }
+    return options.fallback;
+}
+export function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new SeiMcpError(`载荷不是合法 JSON：${error instanceof Error ? error.message : String(error)}`, 'INVALID_PARAMS');
+    }
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}