diff --git a/src/commands/_selfcheck.ts b/src/commands/_selfcheck.ts index e54f3c8..6a5fe24 100644 --- a/src/commands/_selfcheck.ts +++ b/src/commands/_selfcheck.ts @@ -22,7 +22,7 @@ import { Command } from 'commander' import * as fs from 'node:fs' import * as path from 'node:path' -import { installAiHelpHook } from '../core/help.ts' +import { installHelpHook } from '../core/help.ts' import { log, printJson } from '../core/log.ts' import { execSync } from 'node:child_process' @@ -184,7 +184,7 @@ const checks: Array<{ name: string; fn: (file: string) => CheckResult }> = [ return { name: '--help 描述含 "镜像"', ok: true, message: '⊘ 通用文件 (_*.ts), 不要求' } as CheckResult } const content = fs.readFileSync(file, 'utf-8') - // 找 installAiHelpHook 调用的 purpose 字段 + // 找 installHelpHook 调用的 purpose 字段 const match = content.match(/purpose:\s*['"`]([^'"`]+)['"`]/) const has: boolean = !!(match && match[1].includes('镜像')) return { @@ -405,15 +405,15 @@ const checks: Array<{ name: string; fn: (file: string) => CheckResult }> = [ return { name: 'AI 友好检查', ok: true, message: '⊘ 通用文件 (_*.ts), 不要求' } as CheckResult } const content = fs.readFileSync(file, 'utf-8') - // 检查 installAiHelpHook + source 字段 - const hasAiHelp = /installAiHelpHook/.test(content) + // 检查 installHelpHook + source 字段 + const hasAiHelp = /installHelpHook/.test(content) const hasSource = /source:\s*\{/.test(content) return { name: 'AI 友好检查', ok: hasAiHelp && hasSource, message: hasAiHelp && hasSource - ? '✓ 找到 installAiHelpHook + source 字段 (AI 学习材料完整)' - : `✗ 缺 installAiHelpHook 或 source 字段 (AI 调试时查不到 web/backend 权威源)`, + ? '✓ 找到 installHelpHook + source 字段 (AI 学习材料完整)' + : `✗ 缺 installHelpHook 或 source 字段 (AI 调试时查不到 web/backend 权威源)`, } }, }, @@ -514,7 +514,7 @@ export function buildSelfCheckCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: 'v0.11d+ 强制纪律自检 (镜像 CLAUDE.md §2.7.1 自检清单 8 项). AI 场景补充, 非 web 镜像. 防止改前漏读 web/backend 源码 / 漏写 MEMORY / --help 漏 "镜像" / SKILL.md 漏 v0.11d+ 段.', required: { '': 'TS 文件路径 (可多个)' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/apis/info.ts b/src/commands/apis/info.ts index ce76a65..65a7bf0 100644 --- a/src/commands/apis/info.ts +++ b/src/commands/apis/info.ts @@ -16,7 +16,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { loadOpenApi, type OpenApiDoc } from './_cache.ts' @@ -138,7 +138,7 @@ export function buildApisInfoCommand(): Command { console.log(' ' + JSON.stringify(out, null, 2).split('\n').join('\n ')) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查单个 API 详情. 递归解析 $ref 展开 schema (含 ActionResult.data 内层), 写后端/调 API 必备.', required: { '': 'API 路径: "GET /api/xxx" 或 "/api/xxx" (默认 GET)' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/apis/list.ts b/src/commands/apis/list.ts index 247c3e5..26a49fc 100644 --- a/src/commands/apis/list.ts +++ b/src/commands/apis/list.ts @@ -5,7 +5,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { loadOpenApi } from './_cache.ts' @@ -42,7 +42,7 @@ export function buildApisListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列 JNPF 平台全量 API. AI 干活前先 --tag 查相关业务接口.', required: {}, optional: { '--tag': '按 tag 过滤', '--method': 'GET/POST', '--keyword': '搜索' }, diff --git a/src/commands/apis/refresh.ts b/src/commands/apis/refresh.ts index 99d9ccf..851cb96 100644 --- a/src/commands/apis/refresh.ts +++ b/src/commands/apis/refresh.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { loadOpenApi, getStatus } from './_cache.ts' @@ -23,7 +23,7 @@ export function buildApisRefreshCommand(): Command { log.ok(`✓ 刷新成功: pathCount=${after.pathCount} openapiSize=${after.openapiSize}B`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '强制重拉 /v3/api-docs, 忽略 12h TTL. JNPF 升级/新增 API 后必跑.', required: {}, example: 'dacli apis refresh', diff --git a/src/commands/apis/search.ts b/src/commands/apis/search.ts index 24f34c5..a71d2a0 100644 --- a/src/commands/apis/search.ts +++ b/src/commands/apis/search.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { loadOpenApi, type OpenApiDoc } from './_cache.ts' @@ -131,7 +131,7 @@ export function buildApisSearchCommand(): Command { log.info(`\n💡 用法: dacli apis info "${result.apis[0]?.method} ${result.apis[0]?.path}" (看 schema 详情)`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '按字段名搜索 API (P0 字段盲猜痛点, AI 知道 f_xxx 但不知道哪个 API 接受)', required: { '--field': '字段名' }, optional: { diff --git a/src/commands/apis/status.ts b/src/commands/apis/status.ts index 01bae29..76c4e3d 100644 --- a/src/commands/apis/status.ts +++ b/src/commands/apis/status.ts @@ -6,7 +6,7 @@ * 诊断 "为什么 list 看不到新 API" —— 看 loaded/ageMs/pathCount/openapiSize */ import { Command } from 'commander' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { getStatus } from './_cache.ts' @@ -30,7 +30,7 @@ export function buildApisStatusCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查 OpenAPI 缓存状态. 诊断"list 看不到新 API"——看 ageMs / pathCount.', required: {}, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/apis/tags.ts b/src/commands/apis/tags.ts index d9d655e..08b8f88 100644 --- a/src/commands/apis/tags.ts +++ b/src/commands/apis/tags.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { loadOpenApi, type OpenApiDoc } from './_cache.ts' @@ -52,7 +52,7 @@ export function buildApisTagsCommand(): Command { log.info(`\n💡 用法: dacli apis list --tag=`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列 OpenAPI 所有 tag + 每个 tag 下的 API 数量. AI 引导.', optional: { '--json': '原始 JSON 输出' }, example: [ diff --git a/src/commands/app/clear.ts b/src/commands/app/clear.ts index be91f27..6647e88 100644 --- a/src/commands/app/clear.ts +++ b/src/commands/app/clear.ts @@ -30,7 +30,7 @@ import { fileURLToPath } from 'node:url' import { createInterface } from 'node:readline/promises' import { stdin as input, stdout as output } from 'node:process' import { parse as yamlParse, stringify as yamlStringify } from 'yaml' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { DacliError } from '../../core/types.ts' import { clearToken, getTokenPath, loadToken } from '../../core/config.ts' @@ -118,7 +118,7 @@ export function buildAppClearCommand(): Command { await runClear(opts) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '清除 JNPF 应用的本地资源 + 数据库记录. DB 操作走 ssw-common POST /api/ssw/db/clear (PG/MySQL 自动适配), 文件备份到 docs/{app}/history-bak/{ts}/.', required: { '--appCode': '要清除的应用代码 (e.g. tds, tds2, testspace)', diff --git a/src/commands/app/context.ts b/src/commands/app/context.ts index 7b29cc7..abd1532 100644 --- a/src/commands/app/context.ts +++ b/src/commands/app/context.ts @@ -18,7 +18,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { loadToken } from '../../core/config.ts' import type { AppContext, FormSummary } from '../../core/types.ts' @@ -402,7 +402,7 @@ export function buildAppContextCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '输出当前应用环境快照 (appCode/dbLinkId/token 状态/enCode/表/菜单). ' + 'AI 新会话第一步先跑此命令, 所有参数从此快照取, 不要猜测.', diff --git a/src/commands/app/create.ts b/src/commands/app/create.ts index fe05f21..dbfa79a 100644 --- a/src/commands/app/create.ts +++ b/src/commands/app/create.ts @@ -26,7 +26,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { saveToken } from '../../core/config.ts' import type { TokenFile } from '../../core/types.ts' @@ -82,7 +82,7 @@ export function buildAppCreateCommand(): Command { await runCreate(opts) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '真·创建 JNPF 应用 (System+DB+DataSource+授权+重登, 端到端 0 差错). v3.0+ step 1/4 走 webapi/system 镜像', required: { '--appCode': '应用编码 (英文, 唯一)', diff --git a/src/commands/app/info.ts b/src/commands/app/info.ts index 6f39b9a..64b8884 100644 --- a/src/commands/app/info.ts +++ b/src/commands/app/info.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initSystemWebapi, getInfo } from '../../webapi/system.ts' @@ -39,7 +39,7 @@ export function buildAppInfoCommand(): Command { console.log(`creatorTime: ${d.creatorTime || '-'}`) if (d.propertyJson) console.log(`propertyJson: ${d.propertyJson}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查看应用详情 (含 systemId/系统配置等). v3.0+ 走 webapi/system.getInfo', required: { '--id': '应用 id' }, example: 'dacli app info --id=835128640063677381', diff --git a/src/commands/app/init.ts b/src/commands/app/init.ts index 57bb383..74252f5 100644 --- a/src/commands/app/init.ts +++ b/src/commands/app/init.ts @@ -30,7 +30,7 @@ import { existsSync } from 'node:fs' import { dirname, join } from 'node:path' import { fileURLToPath } from 'node:url' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { healthCheck, formatHealthCheckForHuman } from '../../core/_health_check.ts' @@ -106,7 +106,7 @@ export function buildAppInitCommand(): Command { <<<<<<< Updated upstream } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '应用初始化 (健康检查 + system 缺失检测; v3.0+ 移除 --restart)', optional: { '--appCode': '应用 code (不传则用当前登录)', @@ -119,7 +119,7 @@ export function buildAppInitCommand(): Command { log.info(' 计划: 读 dacli.conf 的 jar-pattern/port, kill+rm+nohup+健康检查+重登') } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '应用初始化 (健康检查 / 重启 JNPF / system 缺失时自动重建)', optional: { '--appCode': '应用 code (不传则用当前登录)', diff --git a/src/commands/app/list.ts b/src/commands/app/list.ts index 6d9610b..bebc898 100644 --- a/src/commands/app/list.ts +++ b/src/commands/app/list.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initSystemWebapi, getSystemList } from '../../webapi/system.ts' @@ -61,7 +61,7 @@ export function buildAppListCommand(): Command { console.log(`${id}${name}${code}${del}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出所有应用 (JNPF 多 app 生命周期, 不同于当前登录 appCode). v3.0+ 走 webapi/system.getSystemList', optional: { '--keyword': '按名称/编码模糊搜索' }, example: 'dacli app list\ndacli app list --keyword=tds', diff --git a/src/commands/app/login.ts b/src/commands/app/login.ts index 97d3955..6d12e9d 100644 --- a/src/commands/app/login.ts +++ b/src/commands/app/login.ts @@ -14,7 +14,7 @@ import { clearToken, getTokenPath, } from '../../core/config.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { checkSystemExists } from './_check_system.ts' @@ -82,7 +82,7 @@ export function buildAppLoginCommand(): Command { log.dim(`saved to : ${getTokenPath()}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '登录 JNPF, 把 token 写到 ~/.dacli-token/token.json (默认 home, 可由 DACLI_TOKEN_DIR env 覆盖), 后续命令自动复用', optional: { '--account': '账号 (默认 admin)', diff --git a/src/commands/app/logout.ts b/src/commands/app/logout.ts index 7f6384c..a322e10 100644 --- a/src/commands/app/logout.ts +++ b/src/commands/app/logout.ts @@ -19,7 +19,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { clearToken, getTokenPath } from '../../core/config.ts' import { initWebapi as initAuthWebapi, logoutApi } from '../../webapi/auth.ts' @@ -97,7 +97,7 @@ export function buildAppLogoutCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '退出登录 (走 webapi/auth.logoutApi + 清本地 token). v3.0+ 新增 (cmd-review/app.md 识别)', optional: { '--no-remote-logout': '跳过 web logoutApi, 仅清本地 token', diff --git a/src/commands/app/status.ts b/src/commands/app/status.ts index aa99415..6efa3f7 100644 --- a/src/commands/app/status.ts +++ b/src/commands/app/status.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { loadToken, getTokenPath, currentBaseUrl } from '../../core/config.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { JnpfClient } from '../../core/client.ts' import { healthCheck, formatHealthCheckForHuman } from '../../core/_health_check.ts' @@ -110,7 +110,7 @@ export function buildAppStatusCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '显示当前登录状态. 写脚本前先跑一下确认登录态', optional: { '--json': '以 JSON 输出', diff --git a/src/commands/app/switch.ts b/src/commands/app/switch.ts index d45b5bd..09a6645 100644 --- a/src/commands/app/switch.ts +++ b/src/commands/app/switch.ts @@ -4,7 +4,7 @@ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' import { DEFAULT_ACCOUNT, DEFAULT_PASSWORD, loadToken } from '../../core/config.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' export function buildAppSwitchCommand(): Command { @@ -26,7 +26,7 @@ export function buildAppSwitchCommand(): Command { log.dim(`dbLinkId : ${c.dbLinkId || '(unknown)'}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '切换当前应用, 重新登录并覆盖本地 token. baseline 复刻常用', required: { '--appCode': '目标应用 (testspace=测试场 | jxcj=业务 | developSystem/workSystem=只读 baseline, 禁止改)' }, example: ['dacli app switch --appCode=testspace', 'dacli app switch --appCode=jxcj'], diff --git a/src/commands/app/use.ts b/src/commands/app/use.ts index eacc8da..8c875a3 100644 --- a/src/commands/app/use.ts +++ b/src/commands/app/use.ts @@ -21,7 +21,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { DEFAULT_ACCOUNT, DEFAULT_PASSWORD, loadToken } from '../../core/config.ts' import { getUserInfoApi } from '../../webapi/user.ts' @@ -168,7 +168,7 @@ export function buildAppUseCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '一体化命令 (v3.0+ P1): switch + context + CurrentUser, AI 工作流一步到位', required: { '': '目标应用代码' }, optional: { diff --git a/src/commands/bigscreen/construct.ts b/src/commands/bigscreen/construct.ts index e11b4e4..b0d1280 100644 --- a/src/commands/bigscreen/construct.ts +++ b/src/commands/bigscreen/construct.ts @@ -29,7 +29,7 @@ import { Command } from 'commander' import { readFileSync, existsSync } from 'node:fs' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualData } from '../../webapi/visualdata.ts' import { @@ -118,7 +118,7 @@ export function buildBigscreenConstructCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '构造大屏 (v0.13+ 镜像 web 端 save formdata 镜像 + 内置模板/用户 JSON/单组件添加, 端到端一气呵成)', required: { '--fullName | --enCode | --category': '大屏基础信息 (跟 create 命令相同)', diff --git a/src/commands/bigscreen/create.ts b/src/commands/bigscreen/create.ts index 52c8a89..57cbb79 100644 --- a/src/commands/bigscreen/create.ts +++ b/src/commands/bigscreen/create.ts @@ -13,7 +13,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualData } from '../../webapi/visualdata.ts' @@ -82,7 +82,7 @@ export function buildBigscreenCreateCommand(): Command { ) if (opts.json) printJson({ id, enCode: opts.enCode }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建大屏 (jnpf 6.x 6.2.0, 走 datascreen-vue3 webapp /api/visual/save 端口 32000)', required: { '--fullName | --enCode | --category': '中文名 + 英文编码 + 分类 (1=数据大屏 2=仪表盘)' }, optional: { diff --git a/src/commands/bigscreen/delete.ts b/src/commands/bigscreen/delete.ts index 14bccf9..7a2aade 100644 --- a/src/commands/bigscreen/delete.ts +++ b/src/commands/bigscreen/delete.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadVisualData } from '../../webapi/visualdata.ts' @@ -31,7 +31,7 @@ export function buildBigscreenDeleteCommand(): Command { await loadVisualData.delObj(opts.id) log.ok(`✓ 大屏已删除 (id=${opts.id})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '大屏删除', required: { '--id': '大屏 id', '--yes': '跳过确认' }, example: 'dacli bigscreen delete --id=123 --yes', diff --git a/src/commands/bigscreen/info.ts b/src/commands/bigscreen/info.ts index bb53982..1ad4f17 100644 --- a/src/commands/bigscreen/info.ts +++ b/src/commands/bigscreen/info.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualData } from '../../webapi/visualdata.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -46,7 +46,7 @@ export function buildBigscreenInfoCommand(): Command { console.log(`status: ${visual.status === 1 ? '已发布' : '未发布'}`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查看大屏详情', required: { '--id': '大屏 id' }, example: 'dacli bigscreen info --id=835246813026985082', diff --git a/src/commands/bigscreen/list.ts b/src/commands/bigscreen/list.ts index 87f5249..b23f92d 100644 --- a/src/commands/bigscreen/list.ts +++ b/src/commands/bigscreen/list.ts @@ -11,7 +11,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualData } from '../../webapi/visualdata.ts' @@ -54,7 +54,7 @@ export function buildBigscreenListCommand(): Command { console.log(`${id}${name}${code}${cat}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出大屏 (大屏设计器产物)', optional: { '--keyword': '按名称/编码模糊搜索' }, example: 'dacli bigscreen list\ndacli bigscreen list --keyword=销售', diff --git a/src/commands/bigscreen/release.ts b/src/commands/bigscreen/release.ts index 632312a..5514fdc 100644 --- a/src/commands/bigscreen/release.ts +++ b/src/commands/bigscreen/release.ts @@ -15,7 +15,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadVisualData } from '../../webapi/visualdata.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -57,7 +57,7 @@ export function buildBigscreenReleaseCommand(): Command { await loadVisualData.updateObj(visual) log.info(`✓ 大屏 id=${opts.id} 已发布 (status=1)`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '发布大屏 (state 0→1, 菜单可挂)', required: { '--id': '大屏 id' }, example: 'dacli bigscreen release --id=1234567890', diff --git a/src/commands/bigscreen/update.ts b/src/commands/bigscreen/update.ts index b75a70c..2bb8f88 100644 --- a/src/commands/bigscreen/update.ts +++ b/src/commands/bigscreen/update.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualData } from '../../webapi/visualdata.ts' import { dirtyCheck, dirtyCheckFailAndExit } from '../_dirty_check.ts' @@ -77,7 +77,7 @@ export function buildBigscreenUpdateCommand(): Command { log.ok(`✓ 大屏更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '大屏修改. 改 fullName/enCode/category, PUT 语义 + v0.11e+ dirty check.', required: { '--id': '大屏 id' }, optional: { diff --git a/src/commands/datasource/create.ts b/src/commands/datasource/create.ts index 636b4c6..6e5901d 100644 --- a/src/commands/datasource/create.ts +++ b/src/commands/datasource/create.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { encryptAesEcb, isEncrypted } from '../../core/crypto.ts' import { initWebapi, loadDataSource } from '../../webapi/dataSource.ts' @@ -105,7 +105,7 @@ export function buildDatasourceCreateCommand(): Command { log.info(`✓ 数据源创建成功 id=${id}`) if (opts.json) printJson({ ...(r as object), id }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建数据源 (数据库连接配置)', required: { '--fullName': '数据源名称', diff --git a/src/commands/datasource/delete.ts b/src/commands/datasource/delete.ts index e14dcef..98cccd6 100644 --- a/src/commands/datasource/delete.ts +++ b/src/commands/datasource/delete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadDataSource } from '../../webapi/dataSource.ts' @@ -34,7 +34,7 @@ export function buildDatasourceDeleteCommand(): Command { } log.info(`✓ 数据源 id=${opts.id} 已删除`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '删除数据源 (硬删, 无回收)', required: { '--id': '数据源 id', '--yes': '跳过确认' }, example: 'dacli datasource delete --id=1234567890 --yes', diff --git a/src/commands/datasource/list.ts b/src/commands/datasource/list.ts index e431be0..4c6b342 100644 --- a/src/commands/datasource/list.ts +++ b/src/commands/datasource/list.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataSource } from '../../webapi/dataSource.ts' @@ -42,7 +42,7 @@ export function buildDatasourceListCommand(): Command { console.log(`${id}${name}${code}${type}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出当前应用所有数据源 (MySQL/SQLServer/Oracle/PostgreSQL 等)', optional: { '--keyword': '按名称/编码模糊搜索' }, example: 'dacli datasource list\ndacli datasource list --keyword=test', diff --git a/src/commands/datasource/test.ts b/src/commands/datasource/test.ts index 17ef8c6..6b6cd91 100644 --- a/src/commands/datasource/test.ts +++ b/src/commands/datasource/test.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { encryptAesEcb, isEncrypted } from '../../core/crypto.ts' import { initWebapi, loadDataSource } from '../../webapi/dataSource.ts' @@ -66,7 +66,7 @@ export function buildDatasourceTestCommand(): Command { log.info(`✓ 数据源连接成功`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '测试数据源连接 (按 --id 拉配置, 或直接给参数)', required: { '--id | --dbType+--host+--user+--password': '已存在 id 或 新建连接' }, example: 'dacli datasource test --id=1234567890\ndacli datasource test --dbType=MySQL --host=127.0.0.1 --port=3306 --user=root --password=123456', diff --git a/src/commands/di/copy.ts b/src/commands/di/copy.ts index cc94cdd..46235ce 100644 --- a/src/commands/di/copy.ts +++ b/src/commands/di/copy.ts @@ -13,7 +13,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' import { initWebapi as initDiWebapi, loadDataInterface } from '../../webapi/di.ts' @@ -75,7 +75,7 @@ export function buildDiCopyCommand(): Command { log.ok(`✓ DI 复制成功 (源 id=${opts.id} → 新 id=${newId})`) if (opts.json) printJson({ sourceId: opts.id, newId, code: code ?? 200, msg: msg ?? '复制成功' }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '复制数据接口 (v0.15+ 镜像 web copy)', required: { '--id': '源 DI id' }, example: [ diff --git a/src/commands/di/create.ts b/src/commands/di/create.ts index b37cba7..7e563b6 100644 --- a/src/commands/di/create.ts +++ b/src/commands/di/create.ts @@ -14,7 +14,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataInterface, getDataInterfaceList } from '../../webapi/di.ts' // v0.15+ (P0-8): getDataInterfaceList 替代 c.get import { validateDiUpdate, type DiOpts } from './_validate.ts' @@ -187,7 +187,7 @@ export function buildDiCreateCommand(): Command { if (opts.json) printJson({ ...(r.data as object), id: newId }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建数据接口 (v0.11d+ webapi 化 + step machine 校验). 镜像 web dataInterface/Form.vue + 后端 DataInterfaceController.create', required: { '--fullName': '名称 (必填, maxlength 50)', diff --git a/src/commands/di/delete.ts b/src/commands/di/delete.ts index 35b54f4..0181f08 100644 --- a/src/commands/di/delete.ts +++ b/src/commands/di/delete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadDataInterface } from '../../webapi/di.ts' @@ -32,7 +32,7 @@ export function buildDiDeleteCommand(): Command { } log.ok(`✓ DI id=${opts.id} 已删除`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '数据接口删除. 引用该 DI 的 form 会失效.', required: { '--id': 'DI id', '--yes': '跳过确认' }, example: 'dacli di delete --id=1234567890 --yes', diff --git a/src/commands/di/export.ts b/src/commands/di/export.ts index 689b1ab..eb95456 100644 --- a/src/commands/di/export.ts +++ b/src/commands/di/export.ts @@ -15,7 +15,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' import { initWebapi as initDiWebapi, loadDataInterface } from '../../webapi/di.ts' @@ -69,7 +69,7 @@ export function buildDiExportCommand(): Command { log.info(`提示: 复制 URL 用 curl/浏览器下载, 或加 -o 走 wget`) if (opts.json) printJson({ id: opts.id, name: obj.name, url: obj.url }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '导出数据接口 (v0.15+ 镜像 web exportData)', required: { '--id': 'DI id' }, example: [ diff --git a/src/commands/di/info.ts b/src/commands/di/info.ts index df1c7fd..b5892fc 100644 --- a/src/commands/di/info.ts +++ b/src/commands/di/info.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataInterface } from '../../webapi/di.ts' @@ -40,7 +40,7 @@ export function buildDiInfoCommand(): Command { if (d.requestParams) console.log(` requestParams : ${JSON.stringify(d.requestParams).slice(0, 200)}`) if (d.responseParams) console.log(` responseParams : ${JSON.stringify(d.responseParams).slice(0, 200)}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '数据接口详情 (含 request/response schema + 参数).', required: { '--id': '数据接口 id' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/di/list.ts b/src/commands/di/list.ts index ac3909b..bc83119 100644 --- a/src/commands/di/list.ts +++ b/src/commands/di/list.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataInterface } from '../../webapi/di.ts' @@ -42,7 +42,7 @@ export function buildDiListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出所有数据接口 (弹窗选择/下拉补全/关联表单用).', required: {}, optional: { '--keyword': '搜索' }, diff --git a/src/commands/di/test.ts b/src/commands/di/test.ts index fa32880..c6eea35 100644 --- a/src/commands/di/test.ts +++ b/src/commands/di/test.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataInterface } from '../../webapi/di.ts' @@ -61,7 +61,7 @@ export function buildDiTestCommand(): Command { if (opts.json) printJson(r.data) else console.log(JSON.stringify(r.data ?? {}, null, 2).slice(0, 500)) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '数据接口测试调用. AI 验证 DI 配置正确性 (链路, 鉴权, 返回值).', required: { '--id': '数据接口 id' }, optional: { diff --git a/src/commands/di/update.ts b/src/commands/di/update.ts index 6c4428a..4bf5090 100644 --- a/src/commands/di/update.ts +++ b/src/commands/di/update.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataInterface, getDataInterfaceList } from '../../webapi/di.ts' // v0.15+ (P0-8): getDataInterfaceList 替代 c.get import { validateDiUpdate, type DiOpts } from './_validate.ts' @@ -95,7 +95,7 @@ export function buildDiUpdateCommand(): Command { log.ok(`✓ DI 更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '数据接口修改 (改 schema/path/参数). PUT 语义, 未传字段保留原值. v0.11d+ 加 step machine 校验 (3 step 镜像 web dataInterface/Form.vue + 后端 DataInterfaceController.update, BS-47 唯一性预校验, 聚合错误)', required: { '--id': '数据接口 id' }, optional: { '--fullName': '中文名', '--enCode': '英文编码', '--categoryId': '分类 id', '--action': '动作 (1=增 2=改 3=查 4=删, type=1 必填)', '--url': '接口路径/URL', '--expected-enCode': '防 AI 误覆盖 (A2)', '--expected-state': '防 AI 误覆盖 (A2)', '--force': '跳过 dirty check (A2)' }, diff --git a/src/commands/dict/datacreate.ts b/src/commands/dict/datacreate.ts index 267d456..306c10d 100644 --- a/src/commands/dict/datacreate.ts +++ b/src/commands/dict/datacreate.ts @@ -11,7 +11,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDict } from '../../webapi/dict.ts' import { lookupDataIdByEnCode } from './_lookup.ts' @@ -166,7 +166,7 @@ export function buildDictDataCreateCommand(): Command { if (opts.json) printJson({ typeId: opts.typeId, success: ok, skipped: skippedItems.length, failed: fail, ids }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '往已存在字典类型追加字典项 (单条/批量, 自动跳过重复).', required: { '--typeId': '字典类型 id' }, optional: { diff --git a/src/commands/dict/datadelete.ts b/src/commands/dict/datadelete.ts index e1fc332..1c6b0dc 100644 --- a/src/commands/dict/datadelete.ts +++ b/src/commands/dict/datadelete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadDict } from '../../webapi/dict.ts' @@ -33,7 +33,7 @@ export function buildDictDataDeleteCommand(): Command { } log.ok(`✓ 字典项已删除 (id=${opts.id})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '字典项删除', required: { '--id': '字典项 id', '--yes': '跳过确认' }, example: 'dacli dict dataDelete --id=123 --yes', diff --git a/src/commands/dict/datalist.ts b/src/commands/dict/datalist.ts index 2e230a4..4359536 100644 --- a/src/commands/dict/datalist.ts +++ b/src/commands/dict/datalist.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDict } from '../../webapi/dict.ts' @@ -49,7 +49,7 @@ export function buildDictDataListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '看字典数据. --typeId 看单类型, 不传 --all 拿全部.', required: {}, optional: { '--typeId': '字典类型 id', '--all': '拿全部字典' }, diff --git a/src/commands/dict/dataupdate.ts b/src/commands/dict/dataupdate.ts index 3b34f21..a9d9f4c 100644 --- a/src/commands/dict/dataupdate.ts +++ b/src/commands/dict/dataupdate.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDict } from '../../webapi/dict.ts' import { dirtyCheck, dirtyCheckFailAndExit } from '../_dirty_check.ts' @@ -82,7 +82,7 @@ export function buildDictDataUpdateCommand(): Command { log.ok(`✓ 字典项更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '字典项修改 (改名/排序/启用). PUT 语义, 未传保留.', required: { '--id': '字典项 id' }, optional: { '--enCode': '编码', '--fullName': '名', '--sortCode': '排序', '--enabledMark': '启用/禁用' }, diff --git a/src/commands/dict/typecreate.ts b/src/commands/dict/typecreate.ts index d0e172a..54f0070 100644 --- a/src/commands/dict/typecreate.ts +++ b/src/commands/dict/typecreate.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDict } from '../../webapi/dict.ts' import { validateDictTypeCreate, type DictItemLite } from './_validate.ts' @@ -176,7 +176,7 @@ export function buildDictTypeCreateCommand(): Command { if (opts.json) printJson({ typeId, enCode: opts.enCode, fullName: opts.fullName }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '创建字典类型 (含可选 items 批量建). 端到端 1 条命令替代 web UI 手敲. v0.11d+ 加 step machine 校验 (3 step 镜像 web dict/components/Form.vue + 后端 DictionaryTypeController.create, BS-47 唯一性预校验, 聚合错误)', required: { '--enCode': '字典编码 (英文唯一, BS-47)', diff --git a/src/commands/dict/typedelete.ts b/src/commands/dict/typedelete.ts index d00dd08..49daa01 100644 --- a/src/commands/dict/typedelete.ts +++ b/src/commands/dict/typedelete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadDict } from '../../webapi/dict.ts' @@ -33,7 +33,7 @@ export function buildDictTypeDeleteCommand(): Command { } log.ok(`✓ 字典类型已删除 (id=${opts.id})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '字典类型删除 (级联删字典项)', required: { '--id': '字典类型 id', '--yes': '跳过确认' }, example: 'dacli dict typeDelete --id=123 --yes', diff --git a/src/commands/dict/typelist.ts b/src/commands/dict/typelist.ts index 74d2dde..0016e91 100644 --- a/src/commands/dict/typelist.ts +++ b/src/commands/dict/typelist.ts @@ -13,7 +13,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDict } from '../../webapi/dict.ts' @@ -111,7 +111,7 @@ export function buildDictTypeListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出所有字典类型 (默认递归展平 children, BS-New-6 ON).', required: {}, optional: { diff --git a/src/commands/dict/typeupdate.ts b/src/commands/dict/typeupdate.ts index ba20bc0..2260c0d 100644 --- a/src/commands/dict/typeupdate.ts +++ b/src/commands/dict/typeupdate.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDict } from '../../webapi/dict.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -88,7 +88,7 @@ export function buildDictTypeUpdateCommand(): Command { log.ok(`✓ 字典类型更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '字典类型修改 (改名/分类/树形/排序). PUT 语义, 未传保留.', required: { '--id': '字典类型 id' }, optional: { '--fullName': '名', '--enCode': '编码', '--category': '分类', '--isTree': '树形', '--sortCode': '排序', '--expected-enCode': '防 AI 误覆盖 (A2)', '--expected-state': '防 AI 误覆盖 (A2)', '--force': '跳过 dirty check (A2)' }, diff --git a/src/commands/dm/create.ts b/src/commands/dm/create.ts index 4130a52..49887b7 100644 --- a/src/commands/dm/create.ts +++ b/src/commands/dm/create.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { preCheckDmCreate, handlePreCheckResult, loadContextSafe } from '../_precheck.ts' import { runGuards, handleGuardResult } from '../_blindspot_guards.ts' @@ -173,7 +173,7 @@ export function buildDmCreateCommand(): Command { if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '在指定业务库建物理表. fields JSON 必含 field/fieldName/dataType/dataLength. v0.11d+ 加 step machine 校验 (3 step 镜像 web dataModel/Form.vue + 后端 DbTableController.checkName, 聚合错误, AI 不用去浏览器试错)', required: { '--table': '表名', '--tableName': '中文名', '--fields': '字段 JSON' }, optional: { '--dbLinkId': '业务库 id' }, diff --git a/src/commands/dm/drop.ts b/src/commands/dm/drop.ts index ec1a331..412ea47 100644 --- a/src/commands/dm/drop.ts +++ b/src/commands/dm/drop.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadDataModel } from '../../webapi/dataModel.ts' @@ -43,7 +43,7 @@ export function buildDmDropCommand(): Command { log.ok(`已删除: ${opts.table}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '删除物理表. ⚠️ 不可恢复.', required: { '--table': '表名', '--yes': '必须传 --yes 跳过确认' }, optional: { '--dbLinkId': '业务库 id' }, diff --git a/src/commands/dm/fields.ts b/src/commands/dm/fields.ts index 9896e21..cb8ed59 100644 --- a/src/commands/dm/fields.ts +++ b/src/commands/dm/fields.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataModel } from '../../webapi/dataModel.ts' @@ -56,7 +56,7 @@ export function buildDmFieldsCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查指定物理表的所有字段定义.', required: { '--table': '表名' }, optional: { '--dbLinkId': '业务库 id' }, diff --git a/src/commands/dm/list.ts b/src/commands/dm/list.ts index 7ca8dc1..987a843 100644 --- a/src/commands/dm/list.ts +++ b/src/commands/dm/list.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataModel } from '../../webapi/dataModel.ts' @@ -52,7 +52,7 @@ export function buildDmListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出指定业务库的所有数据模型表. dbLinkId=0 是主库 (平台库).', required: {}, optional: { '--dbLinkId': '业务库 id', '--keyword': '表名搜索', '--page': '页码', '--pageSize': '每页条数' }, diff --git a/src/commands/doc/get.ts b/src/commands/doc/get.ts index a9870c4..f6eb1d6 100644 --- a/src/commands/doc/get.ts +++ b/src/commands/doc/get.ts @@ -17,7 +17,7 @@ */ import { Command } from 'commander' import { resolve } from 'node:path' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { getSection, getRawLines, listSections } from './_parser.ts' @@ -80,7 +80,7 @@ export function buildDocGetCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '读 HTML 文档 section 纯文本. 上下文恢复核心 (CLAUDE.md 强调 token 降低 80%).', required: { '--file': 'HTML 文件路径' }, optional: { diff --git a/src/commands/doc/list.ts b/src/commands/doc/list.ts index f643d31..aca9b6d 100644 --- a/src/commands/doc/list.ts +++ b/src/commands/doc/list.ts @@ -7,7 +7,7 @@ import { Command } from 'commander' import { readdirSync, statSync, existsSync } from 'node:fs' import { join, resolve } from 'node:path' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface Opts { dir?: string; json?: boolean } @@ -49,7 +49,7 @@ export function buildDocListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列 HTML/MD 文档, AI 上下文恢复时先看 list 再 cat 关键 section.', required: {}, optional: { '--dir': '扫描目录' }, diff --git a/src/commands/doc/search.ts b/src/commands/doc/search.ts index e101780..3260a47 100644 --- a/src/commands/doc/search.ts +++ b/src/commands/doc/search.ts @@ -7,7 +7,7 @@ import { Command } from 'commander' import { resolve } from 'node:path' import { existsSync } from 'node:fs' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { parseFile } from './_parser.ts' @@ -93,7 +93,7 @@ export function buildDocSearchCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '按关键词全文搜索 HTML 文档, 避免 get 全文再 grep 的 token 浪费', required: { '--file': 'HTML 文件路径', '--keyword': '搜索关键词 (支持正则)' }, optional: { diff --git a/src/commands/doc/toc.ts b/src/commands/doc/toc.ts index 0bb7f64..b372518 100644 --- a/src/commands/doc/toc.ts +++ b/src/commands/doc/toc.ts @@ -7,7 +7,7 @@ import { Command } from 'commander' import { resolve } from 'node:path' import { existsSync } from 'node:fs' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { listSections } from './_parser.ts' @@ -38,7 +38,7 @@ export function buildDocTocCommand(): Command { log.info(`\n💡 用法: dacli doc get --file=${opts.file} --section=`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列 HTML 文件 section 清单 (P0 上下文恢复核心), AI 精准切片避免全文 Read', required: { '--file': 'HTML 文件路径' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/form/audit.ts b/src/commands/form/audit.ts index 91356da..089a854 100644 --- a/src/commands/form/audit.ts +++ b/src/commands/form/audit.ts @@ -49,7 +49,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' @@ -629,7 +629,7 @@ export function buildFormAuditCommand(): Command { process.exit(totalIssues > 0 ? 1 : 0) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '审计表单业务盲点 (BS-新61~64: select 空字典 / input FK / 数字范围 / formRules 缺失) — 镜像 web FormGenerator + JNPF VisualdevController 后端 schema 检测', required: { '--formId / --enCode / --all': '三选一' }, optional: { diff --git a/src/commands/form/bindflow.ts b/src/commands/form/bindflow.ts index 8a8d728..aa3f3e9 100644 --- a/src/commands/form/bindflow.ts +++ b/src/commands/form/bindflow.ts @@ -23,7 +23,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' @@ -207,7 +207,7 @@ export function buildFormBindFlowCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '表单绑工作流 (BS-New-4: form 端 flowId + workflow start node formId 双向持久化).', required: { '--formId': '表单 id', '--flowId': '工作流模板 id' }, example: 'dacli form bindFlow --formId=836303723314554053 --flowId=836303152285230277', diff --git a/src/commands/form/codegen.ts b/src/commands/form/codegen.ts index bbd30f2..4d5a975 100644 --- a/src/commands/form/codegen.ts +++ b/src/commands/form/codegen.ts @@ -27,7 +27,7 @@ import { Command } from 'commander' import { writeFileSync, mkdirSync, existsSync, readdirSync } from 'node:fs' import { dirname, join } from 'node:path' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' @@ -1005,7 +1005,7 @@ export function buildFormCodegenCommand(): Command { await autoMountMenu(c, formId, fullName, enCode) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '表单代码生成 (白皮书 5.5) — 调平台 CodePreview, 写到本地目录, 参考 aibridge CodeGenerator', required: { '': 'form id (要先 release, state=1)' }, optional: { diff --git a/src/commands/form/delete.ts b/src/commands/form/delete.ts index a528110..a778b47 100644 --- a/src/commands/form/delete.ts +++ b/src/commands/form/delete.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface DeleteOpts { @@ -84,7 +84,7 @@ export function buildFormDeleteCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '删除表单. 不可恢复, 加 --yes 跳过确认. --cascade 级联删关联菜单.', required: { '': '表单 id' }, optional: { '--yes': '跳过确认', '--cascade': '级联删关联菜单 (解决 BS-43 名称重复)' }, diff --git a/src/commands/form/export.ts b/src/commands/form/export.ts index 40873b2..596775f 100644 --- a/src/commands/form/export.ts +++ b/src/commands/form/export.ts @@ -17,7 +17,7 @@ import { writeFileSync } from 'node:fs' import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import type { FormDetail } from '../../core/types.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' @@ -109,7 +109,7 @@ export function buildFormExportCommand(): Command { if (!opts.out) printJson({ id, enCode: data.enCode, path, physicalTables: phyCount, physicalFields: phyFields }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '导出表单完整 schema + 物理表 schema 到文件 (v0.7 解 #15). 用于 baseline 复刻 / 备份 / 跨应用迁移', required: { '': '源表单 id' }, optional: { diff --git a/src/commands/form/fix_entity.ts b/src/commands/form/fix_entity.ts index 3e4d60f..038036c 100644 --- a/src/commands/form/fix_entity.ts +++ b/src/commands/form/fix_entity.ts @@ -23,7 +23,7 @@ import { Command } from 'commander' import { existsSync, readFileSync, writeFileSync, readdirSync } from 'node:fs' import { join } from 'node:path' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { loadToken } from '../../core/config.ts' @@ -167,7 +167,7 @@ export function buildFormFixEntityCommand(): Command { } log.info(`完成: fixed=${totalFixed} skipped=${totalSkipped}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: 'P0 修复: entity 加 @TableId + Service 加 jnpf-origin null check (jnpf 雪花 id 必需, jxcj 2026-06-29 实战教训).', required: {}, optional: { '--table': '只修指定表', '--dir': '自定义目录', '--type': 'entity|biz|all', '--dry-run': '只显示不写' }, diff --git a/src/commands/form/import.ts b/src/commands/form/import.ts index b9f7b7c..ce3208f 100644 --- a/src/commands/form/import.ts +++ b/src/commands/form/import.ts @@ -16,7 +16,7 @@ import { readFileSync } from 'node:fs' import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' import { browserVerify } from './_browser_verify.ts' @@ -368,7 +368,7 @@ export function buildFormImportCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '从 JSON 导入表单. v0.7 默认 --autoTable 在目标库重建物理表, 解 #15.', required: { '': 'JSON 文件路径' }, optional: { diff --git a/src/commands/form/info.ts b/src/commands/form/info.ts index 99bfca3..70f2a3d 100644 --- a/src/commands/form/info.ts +++ b/src/commands/form/info.ts @@ -13,7 +13,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { printJson, log } from '../../core/log.ts' import type { FormDetail } from '../../core/types.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' @@ -69,7 +69,7 @@ export function buildFormInfoCommand(): Command { printJson(data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '拉表单完整 schema. clone 前先 info 看结构', required: { '': '表单 id' }, optional: { diff --git a/src/commands/form/list.ts b/src/commands/form/list.ts index 5b1913d..1e19473 100644 --- a/src/commands/form/list.ts +++ b/src/commands/form/list.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import type { FormSummary } from '../../core/types.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' @@ -83,7 +83,7 @@ export function buildFormListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出当前应用的所有表单 (BS-53 v0.12+: 默认显示 STATE 列, --state 支持 2, --summary 输出分布). AI 干活前先跑 --summary 看 state 健康度', optional: { '--keyword': '过滤 (服务器侧)', diff --git a/src/commands/form/preview.ts b/src/commands/form/preview.ts index ed31140..c96326f 100644 --- a/src/commands/form/preview.ts +++ b/src/commands/form/preview.ts @@ -24,7 +24,7 @@ import { Command } from 'commander' import * as fs from 'node:fs' import * as path from 'node:path' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' @@ -98,7 +98,7 @@ export function buildFormPreviewCommand(): Command { log.info(` 列表列数: ${(columnList as unknown[]).length} 表单字段数: ${(formDataFields as unknown[]).length}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '输出 form standalone HTML 预览, 浏览器打开即可, 无需 JNPF/nginx. AI 场景增强 (web 没专门 FormPreview 组件, 是 FormGenerator 复用)', required: { '--id': '表单 id' }, optional: { diff --git a/src/commands/form/release.ts b/src/commands/form/release.ts index 9bc0256..a481b07 100644 --- a/src/commands/form/release.ts +++ b/src/commands/form/release.ts @@ -12,7 +12,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { loadContextSafe, preCheckFormRelease } from '../_precheck.ts' import { runGuards, handleGuardResult, formatIssues } from '../_blindspot_guards.ts' @@ -88,7 +88,7 @@ export function buildFormReleaseCommand(): Command { process.exit(1) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '把表单从 state=0|2 切到 state=1, 前端列表才能看到 (BS-53: state=2 = 已发布被编辑过, 自动重新发布)', required: { '': '表单 id' }, optional: { '--soft': 'type=4 时软跳过' }, diff --git a/src/commands/form/selector.ts b/src/commands/form/selector.ts index c681143..4f07d1f 100644 --- a/src/commands/form/selector.ts +++ b/src/commands/form/selector.ts @@ -11,7 +11,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' @@ -72,7 +72,7 @@ export function buildFormSelectorCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '功能 (form) 下拉框, AI 创建菜单 / 工作流 / select 字段时必跑.', required: {}, optional: { diff --git a/src/commands/form/update.ts b/src/commands/form/update.ts index e3fd151..51b70c5 100644 --- a/src/commands/form/update.ts +++ b/src/commands/form/update.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' import { dirtyCheck, dirtyCheckFailAndExit } from '../_dirty_check.ts' @@ -241,7 +241,7 @@ export function buildFormUpdateCommand(): Command { if (opts.json) printJson({ id: opts.id, action: 'updated' }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '表单修改 (高需求 P0 NEW-CMD, 改 schema/字段/enCode, PUT 语义). 解决之前需 export → 改 → import 的无原子性.', required: { '--id': '表单 id' }, optional: { diff --git a/src/commands/integration/emailtest.ts b/src/commands/integration/emailtest.ts index d6bf9bf..263ff38 100644 --- a/src/commands/integration/emailtest.ts +++ b/src/commands/integration/emailtest.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -58,7 +58,7 @@ export function buildIntegrationEmailTestCommand(): Command { } log.info(`✓ 邮件测试发送 OK (configId=${opts.configId}, to=${opts.email})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '邮件测试发送 (修复 v0.10 假 PASS 端点)', required: { '--configId': 'AccountConfig id' }, optional: { diff --git a/src/commands/integration/smstest.ts b/src/commands/integration/smstest.ts index 48f6584..c571dbf 100644 --- a/src/commands/integration/smstest.ts +++ b/src/commands/integration/smstest.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -57,7 +57,7 @@ export function buildIntegrationSmsTestCommand(): Command { } log.info(`✓ 短信测试发送 OK (configId=${opts.configId}, to=${opts.phone})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '短信测试发送 (修复 v0.10 假 PASS 端点)', required: { '--configId': 'AccountConfig id' }, optional: { diff --git a/src/commands/integration/webhooktest.ts b/src/commands/integration/webhooktest.ts index 51e57fe..0403df6 100644 --- a/src/commands/integration/webhooktest.ts +++ b/src/commands/integration/webhooktest.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -72,7 +72,7 @@ export function buildIntegrationWebhookTestCommand(): Command { } log.info(`✓ Webhook 测试发送 OK (configId=${opts.configId || '-'}, url=${opts.url || '(from config)'})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: 'Webhook 测试发送 (修复 v0.10 假 PASS 端点)', required: {}, optional: { diff --git a/src/commands/log/exception.ts b/src/commands/log/exception.ts index dc4af30..9e6c147 100644 --- a/src/commands/log/exception.ts +++ b/src/commands/log/exception.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadLog } from '../../webapi/log.ts' @@ -57,7 +57,7 @@ export function buildLogExceptionCommand(): Command { } } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '异常日志 (Java 异常堆栈, AI 调试后端错误核心入口).', optional: { '--keyword': '按账号/异常名/URL 模糊搜索', '--limit': '最多取 N 条', '--json': '原始 JSON 输出' }, example: [ diff --git a/src/commands/log/login.ts b/src/commands/log/login.ts index 9b2b06f..a6ceec6 100644 --- a/src/commands/log/login.ts +++ b/src/commands/log/login.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadLog } from '../../webapi/log.ts' @@ -44,7 +44,7 @@ export function buildLogLoginCommand(): Command { console.log(JSON.stringify(d).slice(0, 200)) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '登录日志', optional: { '--keyword': '按账号/姓名模糊搜索' }, example: 'dacli log login\ndacli log login --keyword=admin', diff --git a/src/commands/log/operate.ts b/src/commands/log/operate.ts index 501f9a1..387ff7a 100644 --- a/src/commands/log/operate.ts +++ b/src/commands/log/operate.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadLog } from '../../webapi/log.ts' @@ -44,7 +44,7 @@ export function buildLogOperateCommand(): Command { console.log(JSON.stringify(d).slice(0, 200)) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '操作日志', optional: { '--keyword': '按账号/姓名模糊搜索' }, example: 'dacli log operate\ndacli log operate --keyword=admin', diff --git a/src/commands/log/request.ts b/src/commands/log/request.ts index 89f5600..72ddb7a 100644 --- a/src/commands/log/request.ts +++ b/src/commands/log/request.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadLog } from '../../webapi/log.ts' @@ -51,7 +51,7 @@ export function buildLogRequestCommand(): Command { console.log(`[${time}] ${user} ${method} ${url} ip=${ip} status=${status}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '请求日志 (API 调用审计). 排查 API 调用失败 / IP 异常.', optional: { '--keyword': '按账号/URL 模糊搜索', '--limit': '最多取 N 条', '--json': '原始 JSON 输出' }, example: [ diff --git a/src/commands/menu/create.ts b/src/commands/menu/create.ts index b613d6a..73e1c42 100644 --- a/src/commands/menu/create.ts +++ b/src/commands/menu/create.ts @@ -23,7 +23,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { loadContextSafe } from '../_precheck.ts' import { runGuards, handleGuardResult } from '../_blindspot_guards.ts' @@ -367,7 +367,7 @@ export function buildMenuCreateCommand(): Command { return }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '创建菜单. 挂表单菜单 (--formId) 走 web 真路径 Actions/Module, 后端自动处理所有字段. v0.11d+ 加 step machine 校验 (4 step 镜像 web Form.vue + 后端 ModuleController.create, 聚合错误, AI 不用去浏览器试错)', required: { '--fullName': '中文名' }, optional: { diff --git a/src/commands/menu/delete.ts b/src/commands/menu/delete.ts index ceb8004..fe5b48c 100644 --- a/src/commands/menu/delete.ts +++ b/src/commands/menu/delete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { fetchMenuTree, findByEnCode, flattenTree } from './_helpers.ts' import { initWebapi, loadMenu } from '../../webapi/menu.ts' @@ -105,7 +105,7 @@ export function buildMenuDeleteCommand(): Command { log.info(`汇总: ${ok} 成功 / ${fail} 失败`) if (fail) process.exit(1) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '删除菜单. v0.7+ 支持 --enCode (容错 hash 后缀) / --cascade (递归子菜单) / --fallback (失败兜底).', required: { '--id 或 --enCode': '二选一', '--yes': '确认' }, optional: { diff --git a/src/commands/menu/info.ts b/src/commands/menu/info.ts index 78fe20a..d206729 100644 --- a/src/commands/menu/info.ts +++ b/src/commands/menu/info.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadMenu } from '../../webapi/menu.ts' @@ -61,7 +61,7 @@ export function buildMenuInfoCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '拉菜单完整 schema. 用于诊断"菜单创建了但侧边栏不显示"等问题 (BS-43/BS-50 防御).', required: { '--id': '菜单 id' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/menu/list.ts b/src/commands/menu/list.ts index 98e6ddc..b651cf6 100644 --- a/src/commands/menu/list.ts +++ b/src/commands/menu/list.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { fetchAllFormReleasedMenus, type FormReleasedMenu } from './_helpers.ts' import { initWebapi, loadMenu } from '../../webapi/menu.ts' @@ -87,7 +87,7 @@ export function buildMenuListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出当前 app 的菜单树 (按请求头 App-Code 过滤).', required: {}, optional: { diff --git a/src/commands/menu/purge.ts b/src/commands/menu/purge.ts index 3872458..c150677 100644 --- a/src/commands/menu/purge.ts +++ b/src/commands/menu/purge.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { fetchFormReleasedMenus } from './_helpers.ts' import { initWebapi as initMenuWebapi, loadMenu } from '../../webapi/menu.ts' @@ -69,7 +69,7 @@ export function buildMenuPurgeCommand(): Command { if (fail) process.exit(1) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '按 formId 删除所有挂载菜单 (PC+APP). 走 getReleaseMenu → DELETE 真实删菜单, vs unrelease 只重置 form 关联.', required: { '--formId': '表单 id' }, optional: { '--yes': '跳过确认', '--unrelease': '同时清 form 挂载状态' }, diff --git a/src/commands/menu/releases.ts b/src/commands/menu/releases.ts index c834103..4d476a7 100644 --- a/src/commands/menu/releases.ts +++ b/src/commands/menu/releases.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { fetchFormReleasedMenus } from './_helpers.ts' @@ -37,7 +37,7 @@ export function buildMenuReleasesCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查 form 已挂的菜单 (走 web 真实端点 getReleaseMenu, 之前 dacli 缺).', required: { '--formId': '表单 id' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/menu/unrelease.ts b/src/commands/menu/unrelease.ts index 68cc449..f1dbbba 100644 --- a/src/commands/menu/unrelease.ts +++ b/src/commands/menu/unrelease.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -40,7 +40,7 @@ export function buildMenuUnreleaseCommand(): Command { } log.ok(`✓ 已取消挂菜单 (formId=${opts.formId})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '取消 form 的菜单发布. 用于 dacli menu delete 失败时兜底 (DELETE /api/system/Menu/X 报 System abnormality).', required: { '--formId': '表单 id' }, example: 'dacli menu unrelease --formId=835141398800901061', diff --git a/src/commands/menu/update.ts b/src/commands/menu/update.ts index b547181..cfb7e32 100644 --- a/src/commands/menu/update.ts +++ b/src/commands/menu/update.ts @@ -15,7 +15,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadMenu } from '../../webapi/menu.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -190,7 +190,7 @@ export function buildMenuUpdateCommand(): Command { if (opts.json) printJson({ id: menuId, ...body, _propertyJsonParsed: propertyJsonObj }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '菜单修改 (B-20 NEW-CMD). 改 urlAddress/enCode/propertyJson (镜像 web Menu/Form.vue handleSubmit). 杀手特性 --formEnCode 一键同步 form enCode 改名后的菜单 urlAddress.', required: { 'menuId (位置参数) 或 --id': '菜单 id' }, optional: { diff --git a/src/commands/monitor/flow.ts b/src/commands/monitor/flow.ts index c0af31d..821f467 100644 --- a/src/commands/monitor/flow.ts +++ b/src/commands/monitor/flow.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadFlowMonitor } from '../../webapi/flowMonitor.ts' @@ -32,7 +32,7 @@ export function buildMonitorFlowCommand(): Command { console.log(JSON.stringify(d)) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '流程监控 (待办/运行中流程)', example: 'dacli monitor flow', source: { api: 'GET /api/workflow/monitor', ref: 'web/.../api/workFlow/flowMonitor.ts getFlowMonitorList()' }, diff --git a/src/commands/monitor/online.ts b/src/commands/monitor/online.ts index 09c3439..f023616 100644 --- a/src/commands/monitor/online.ts +++ b/src/commands/monitor/online.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadOnlineUser } from '../../webapi/onlineUser.ts' @@ -34,7 +34,7 @@ export function buildMonitorOnlineCommand(): Command { console.log(`${String(d.id || '').padEnd(30)}${String(d.userName || d.account || '')}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '在线用户监控 (当前登录的用户)', example: 'dacli monitor online', source: { api: 'GET /api/system/OnlineUser', ref: 'web/.../api/permission/onlineUser.ts getOnlineUser()' }, diff --git a/src/commands/monitor/server.ts b/src/commands/monitor/server.ts index 696e06b..23f5cad 100644 --- a/src/commands/monitor/server.ts +++ b/src/commands/monitor/server.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadMonitor } from '../../webapi/monitor.ts' @@ -39,7 +39,7 @@ export function buildMonitorServerCommand(): Command { console.log(` 运行时间 : ${d.uptime || '-'}`) console.log(` JDK版本 : ${d.jdkVersion || '-'}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '服务器状态 (CPU/内存/磁盘/JVM, AI 性能诊断最高优先级). v0.11+ webapi.', optional: { '--json': '原始 JSON 输出' }, example: ['dacli monitor server', 'dacli monitor server --json'], diff --git a/src/commands/monitor/sql.ts b/src/commands/monitor/sql.ts index 76dab18..0281719 100644 --- a/src/commands/monitor/sql.ts +++ b/src/commands/monitor/sql.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadDataInterface } from '../../webapi/di.ts' @@ -38,7 +38,7 @@ export function buildMonitorSqlCommand(): Command { console.log(JSON.stringify(d)) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: 'SQL 监控 (数据接口调用日志)', required: { '--id': '数据接口 id' }, example: 'dacli monitor sql --id=420587863533428357', diff --git a/src/commands/msg/noticecreate.ts b/src/commands/msg/noticecreate.ts index 2a83659..8faff16 100644 --- a/src/commands/msg/noticecreate.ts +++ b/src/commands/msg/noticecreate.ts @@ -5,7 +5,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { validateMsgCreate } from './_validate.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -72,7 +72,7 @@ export function buildMsgNoticeCreateCommand(): Command { log.info(`✓ 通知公告创建成功 id=${id}`) if (opts.json) printJson({ ...(r.data as object), id }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建通知公告 (草稿, 用 notice-release 发布)', required: { '--fullName': '通知标题', '--enCode': '通知编码' }, optional: { '--body': '通知正文' }, diff --git a/src/commands/msg/noticedelete.ts b/src/commands/msg/noticedelete.ts index 5887c8d..308d24e 100644 --- a/src/commands/msg/noticedelete.ts +++ b/src/commands/msg/noticedelete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadNotice } from '../../webapi/message.ts' @@ -33,7 +33,7 @@ export function buildMsgNoticeDeleteCommand(): Command { } log.ok(`✓ 公告已删除 (id=${opts.id})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '通知公告删除', required: { '--id': '公告 id', '--yes': '跳过确认' }, example: 'dacli msg noticeDelete --id=123 --yes', diff --git a/src/commands/msg/noticelist.ts b/src/commands/msg/noticelist.ts index c292df7..d77c522 100644 --- a/src/commands/msg/noticelist.ts +++ b/src/commands/msg/noticelist.ts @@ -5,7 +5,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface NoticeItem { @@ -57,7 +57,7 @@ export function buildMsgNoticeListCommand(): Command { console.log(`${id}${name}${code}${state}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出通知公告 (站内信, msgCenter)', optional: { '--keyword': '按名称/编码模糊搜索' }, example: 'dacli msg noticelist\ndacli msg noticelist --keyword=系统', diff --git a/src/commands/msg/noticesend.ts b/src/commands/msg/noticesend.ts index e1a8797..c0e3bf4 100644 --- a/src/commands/msg/noticesend.ts +++ b/src/commands/msg/noticesend.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface SendOpts { @@ -41,7 +41,7 @@ export function buildMsgNoticeSendCommand(): Command { log.info(` 提示: 走 dacli integration ${opts.type} send (W12+)`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '发送/发布通知 (决策 8: 通道 site/email/sms/webhook/dingTalk/weCom)', required: { '--id': '通知 id' }, optional: { '--type': '发送通道 (默认 site)' }, diff --git a/src/commands/msg/noticeupdate.ts b/src/commands/msg/noticeupdate.ts index bf48efa..6d888f1 100644 --- a/src/commands/msg/noticeupdate.ts +++ b/src/commands/msg/noticeupdate.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadNotice } from '../../webapi/message.ts' import { dirtyCheck, dirtyCheckFailAndExit } from '../_dirty_check.ts' @@ -81,7 +81,7 @@ export function buildMsgNoticeUpdateCommand(): Command { log.ok(`✓ 公告更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '通知公告修改. 改 fullName/enCode/body/category, PUT 语义 + v0.11e+ dirty check.', required: { '--id': '公告 id' }, optional: { diff --git a/src/commands/msg/templatecreate.ts b/src/commands/msg/templatecreate.ts index c4a7d27..fbbe887 100644 --- a/src/commands/msg/templatecreate.ts +++ b/src/commands/msg/templatecreate.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { validateMsgCreate } from './_validate.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -78,7 +78,7 @@ export function buildMsgTemplateCreateCommand(): Command { log.info(`✓ 消息模板创建成功 id=${id}`) if (opts.json) printJson({ ...(r.data as object), id }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建消息模板 (修复 v0.10 错误端点)', required: { '--fullName': '模板名称', '--enCode': '模板编码' }, optional: { diff --git a/src/commands/msg/templatedelete.ts b/src/commands/msg/templatedelete.ts index bdd9973..d7ca105 100644 --- a/src/commands/msg/templatedelete.ts +++ b/src/commands/msg/templatedelete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadMsgTemplate } from '../../webapi/message.ts' @@ -33,7 +33,7 @@ export function buildMsgTemplateDeleteCommand(): Command { } log.ok(`✓ 模板已删除 (id=${opts.id})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '消息模板删除', required: { '--id': '模板 id', '--yes': '跳过确认' }, example: 'dacli msg templateDelete --id=123 --yes', diff --git a/src/commands/msg/templatelist.ts b/src/commands/msg/templatelist.ts index 8b1c020..e3e4848 100644 --- a/src/commands/msg/templatelist.ts +++ b/src/commands/msg/templatelist.ts @@ -5,7 +5,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface TemplateItem { @@ -55,7 +55,7 @@ export function buildMsgTemplateListCommand(): Command { console.log(`${id}${name}${code}${en}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出消息模板 (站内信/邮件/短信 模板)', optional: { '--keyword': '按名称/编码模糊搜索' }, example: 'dacli msg templatelist\ndacli msg templatelist --keyword=告警', diff --git a/src/commands/msg/templateupdate.ts b/src/commands/msg/templateupdate.ts index d5b0f80..2980c8c 100644 --- a/src/commands/msg/templateupdate.ts +++ b/src/commands/msg/templateupdate.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadMsgTemplate } from '../../webapi/message.ts' @@ -55,7 +55,7 @@ export function buildMsgTemplateUpdateCommand(): Command { log.ok(`✓ 模板更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '消息模板修改', required: { '--id': '模板 id' }, optional: { '--fullName': '模板名', '--enCode': '英文编码', '--category': '分类', '--content': '内容', '--enabledMark': '启用/禁用' }, diff --git a/src/commands/org/create.ts b/src/commands/org/create.ts index 181c0b9..79a471e 100644 --- a/src/commands/org/create.ts +++ b/src/commands/org/create.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { validateOrgCreate } from './_validate.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -92,7 +92,7 @@ export function buildOrgCreateCommand(): Command { log.info(`✓ 组织创建成功 id=${id}`) if (opts.json) printJson({ ...(r as object), id }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建组织 (v0.11e+ Phase D1 + step machine 校验, 镜像 web organize/Form.vue + 后端 OrganizeController + PS013/PS036)', required: { '--fullName': '组织名称', diff --git a/src/commands/org/list.ts b/src/commands/org/list.ts index 33d8021..eec7f92 100644 --- a/src/commands/org/list.ts +++ b/src/commands/org/list.ts @@ -5,7 +5,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface OrgItem { @@ -59,7 +59,7 @@ export function buildOrgListCommand(): Command { console.log(`${idShort} ${name} ${parent} ${cat} ${ch}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出组织树 (P1 权限三角 3 号)', optional: { '--parentId': '从指定父节点展开 (默认 "0" 根)' }, example: 'dacli org list\ndacli org list --parentId=829724597300494342', diff --git a/src/commands/org/tree.ts b/src/commands/org/tree.ts index 4b32e52..ed7521d 100644 --- a/src/commands/org/tree.ts +++ b/src/commands/org/tree.ts @@ -5,7 +5,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface OrgItem { @@ -62,7 +62,7 @@ export function buildOrgTreeCommand(): Command { console.log('组织树 (单层, maxDepth=' + opts.maxDepth + '):') printTree(list, 0, opts.parentId || '0') }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '组织树形结构 (单层展示)', optional: { '--parentId': '根节点 id (默认 "0")', '--maxDepth': '最大深度' }, example: 'dacli org tree\ndacli org tree --parentId=829724597300494342', diff --git a/src/commands/portal/create.ts b/src/commands/portal/create.ts index 39f5d0c..df34db0 100644 --- a/src/commands/portal/create.ts +++ b/src/commands/portal/create.ts @@ -16,7 +16,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { validatePortalCreate } from './_validate.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -243,7 +243,7 @@ export function buildPortalCreateCommand(): Command { if (opts.json) printJson({ ...(r as object), id, category: realCategoryId, categoryName: resolvedCategory.name }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建门户 (首页/工作台设计器产物)', required: { '--fullName': '门户名称', diff --git a/src/commands/portal/info.ts b/src/commands/portal/info.ts index c3d00ed..a9e6478 100644 --- a/src/commands/portal/info.ts +++ b/src/commands/portal/info.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initPortalWebapi, loadPortal } from '../../webapi/portal.ts' @@ -41,7 +41,7 @@ export function buildPortalInfoCommand(): Command { console.log(`--- 完整 JSON (含 formData 布局) ---`) printJson(d) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查看门户的完整 schema (含布局/组件)', required: { '--id': '门户 id' }, example: 'dacli portal info --id=1234567890\ndacli portal info --id=1234567890 --json', diff --git a/src/commands/portal/list.ts b/src/commands/portal/list.ts index 1008a7d..36b4aad 100644 --- a/src/commands/portal/list.ts +++ b/src/commands/portal/list.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initPortalWebapi, loadPortal } from '../../webapi/portal.ts' @@ -48,7 +48,7 @@ export function buildPortalListCommand(): Command { console.log(`${id}${name}${code}${cat}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出门户 (门户设计器产物)', optional: { '--keyword': '按名称/编码模糊搜索' }, example: 'dacli portal list\ndacli portal list --keyword=工作台', diff --git a/src/commands/portal/release.ts b/src/commands/portal/release.ts index cb68d56..8682e0c 100644 --- a/src/commands/portal/release.ts +++ b/src/commands/portal/release.ts @@ -19,7 +19,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi as initPortalWebapi, @@ -168,7 +168,7 @@ export function buildPortalReleaseCommand(): Command { } log.info(`✓ 门户 id=${opts.id} 已发布 (pc=${pc} app=${app}${pcModuleParentId ? `, 挂菜单父级 ${pcModuleParentId}` : ''})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '发布门户 (state 0→1, 必传 pc/app/platformRelease 三参; BS-109 自动检测 pcModuleParentId)', required: { '--id': '门户 id' }, optional: { diff --git a/src/commands/portal/setDefault.ts b/src/commands/portal/setDefault.ts index 3cb1bb7..7b32b66 100644 --- a/src/commands/portal/setDefault.ts +++ b/src/commands/portal/setDefault.ts @@ -18,7 +18,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initPortalWebapi, @@ -128,7 +128,7 @@ export function buildPortalSetDefaultCommand(): Command { log.ok(`✓ 门户已设为默认 (BS-110, menuId=${menuId}, msg="${msg || '设置成功'}")`) if (opts.json) printJson({ menuId, code, msg, raw: r }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '设为默认门户 (BS-110 jyzs 2026-07-02; 注意: setDefaultPortal 收 menu id 不是 portal id, 命令内部自动转换)', optional: { diff --git a/src/commands/print/create.ts b/src/commands/print/create.ts index 3884a36..ae715e0 100644 --- a/src/commands/print/create.ts +++ b/src/commands/print/create.ts @@ -20,7 +20,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { validatePrintCreate } from './_validate.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -119,7 +119,7 @@ export function buildPrintCreateCommand(): Command { log.info(`✓ 打印模板创建成功 id=${id}`) if (opts.json) printJson({ ...(r as object), id }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建打印模板 (绑 form 数据, 套打)', required: { '--fullName': '打印模板名称', diff --git a/src/commands/print/delete.ts b/src/commands/print/delete.ts index 0c00d51..df8c994 100644 --- a/src/commands/print/delete.ts +++ b/src/commands/print/delete.ts @@ -16,7 +16,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' import { initWebapi as initPrintDevWebapi, loadPrintDev } from '../../webapi/printDev.ts' @@ -63,7 +63,7 @@ export function buildPrintDeleteCommand(): Command { log.ok(`✓ 打印模板已删除 id=${opts.id} (v0.15+ webapi 镜像)`) if (opts.json) printJson({ id: opts.id, code: 200, msg: '删除成功' }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '删除打印模板 (v0.15+ 镜像 web delPrintDev)', required: { '--id': '打印模板 id' }, optional: { '--yes': '跳过 TTY 确认 (强制删除)' }, diff --git a/src/commands/print/info.ts b/src/commands/print/info.ts index fa4b80e..00522a2 100644 --- a/src/commands/print/info.ts +++ b/src/commands/print/info.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' import { initWebapi as initPrintDevWebapi, getPrintDevInfo } from '../../webapi/printDev.ts' @@ -52,7 +52,7 @@ export function buildPrintInfoCommand(): Command { process.exit(1) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查看打印模板详情', required: { '--id': '打印模板 id' }, example: 'dacli print info --id=585817367276160133', diff --git a/src/commands/print/list.ts b/src/commands/print/list.ts index a407119..ba37af6 100644 --- a/src/commands/print/list.ts +++ b/src/commands/print/list.ts @@ -11,7 +11,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initPrintDevWebapi, getPrintDevList } from '../../webapi/printDev.ts' @@ -63,7 +63,7 @@ export function buildPrintListCommand(): Command { console.log(`${id}${name}${code}${state}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出打印模板 (绑 form 数据, 套打)', optional: { '--keyword': '按名称/编码模糊搜索' }, example: 'dacli print list\ndacli print list --keyword=套打', diff --git a/src/commands/print/update.ts b/src/commands/print/update.ts index 97df7c8..0ef35dd 100644 --- a/src/commands/print/update.ts +++ b/src/commands/print/update.ts @@ -15,7 +15,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' import { @@ -130,7 +130,7 @@ export function buildPrintUpdateCommand(): Command { log.ok(`✓ 打印模板修改成功 id=${opts.id} enCode=${body.enCode}`) if (opts.json) printJson({ id: opts.id, code: 200, msg: '更新成功', raw: r }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '修改打印模板 (v0.15+ 镜像 web 端 updatePrintDev)', required: { '--id': '打印模板 id' }, optional: { diff --git a/src/commands/report/create.ts b/src/commands/report/create.ts index 633c77b..360652b 100644 --- a/src/commands/report/create.ts +++ b/src/commands/report/create.ts @@ -17,7 +17,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' import { validateReportCreate } from './_validate.ts' // v0.15+ (P1-1, 2026-07-02): 4 命令接入 _validate @@ -155,7 +155,7 @@ export function buildReportCreateCommand(): Command { log.ok(`✓ 报表创建成功 id=${id} enCode=${opts.enCode} (镜像 web 端 report.ts:17 createReport)`) if (opts.json) printJson({ id, enCode: opts.enCode, raw: r }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建报表模板 (jnpf 6.x 6.2.0, 走独立报表服务 /api/Report 端口 32000)', required: { '--fullName | --enCode': '中文名 + 英文编码 (BS-56 字符限制)' }, optional: { diff --git a/src/commands/report/delete.ts b/src/commands/report/delete.ts index 62c4b6f..71b6440 100644 --- a/src/commands/report/delete.ts +++ b/src/commands/report/delete.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' @@ -89,7 +89,7 @@ export function buildReportDeleteCommand(): Command { log.ok(`✓ 报表已删除 id=${opts.id} (BS-新116 配套, msg="${msg || '删除成功'}")`) if (opts.json) printJson({ id: opts.id, code, msg, raw: r, cascade: opts.cascade }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '删除报表 (BS-新116 配套, 镜像 web report.ts:30 delReport, jnpf-datareport-univer /api/Report/{id})', required: { '--id': '报表 id' }, optional: { diff --git a/src/commands/report/info.ts b/src/commands/report/info.ts index bd2905b..67704d4 100644 --- a/src/commands/report/info.ts +++ b/src/commands/report/info.ts @@ -12,7 +12,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' @@ -54,7 +54,7 @@ export function buildReportInfoCommand(): Command { console.log(`enabledMark: ${found.enabledMark ?? 'N/A'}`) if (opts.json) printJson(found) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查看报表详情 (走 webapi 镜像, 端点 /api/Report/{id} 端口 32000)', required: { '--id': '报表 id (webapi getReportInfo)' }, example: 'dacli report info --id=842026612399540421', diff --git a/src/commands/report/list.ts b/src/commands/report/list.ts index 8a7f3c1..4ad7341 100644 --- a/src/commands/report/list.ts +++ b/src/commands/report/list.ts @@ -19,7 +19,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' @@ -101,7 +101,7 @@ export function buildReportListCommand(): Command { console.log(`${id}${name}${cat}${code}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出报表 (走 webapi 镜像, 端点 /api/Report 端口 32000)', optional: { '--keyword': '按名称模糊搜索', diff --git a/src/commands/report/publish.ts b/src/commands/report/publish.ts index 0ad782c..27a5805 100644 --- a/src/commands/report/publish.ts +++ b/src/commands/report/publish.ts @@ -21,7 +21,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' import { validateReportCreate } from './_validate.ts' @@ -115,7 +115,7 @@ export function buildReportPublishCommand(): Command { log.ok(`✓ 报表已发布+部署 id=${opts.id} (v0.16+ 新 publish 命令, type=1)`) if (opts.json) printJson({ id: opts.id, code, msg, raw: r }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '发布+部署报表 (v0.16+ 新增, 替代 release --type=1)', required: { '--id': '报表 id' }, optional: { diff --git a/src/commands/report/release.ts b/src/commands/report/release.ts index b3b388b..77bc91b 100644 --- a/src/commands/report/release.ts +++ b/src/commands/report/release.ts @@ -18,7 +18,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' import { validateBasicInfo, validateNumeric } from './_validate.ts' // v0.15+ (P1-1) @@ -151,7 +151,7 @@ export function buildReportReleaseCommand(): Command { ) if (opts.json) printJson({ id: opts.id, type: releaseType, code, msg, raw: r }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '发布/保存报表设计 (BS-新116, jyzs 2026-07-02 实战补 release 子命令, 走 webapi/report.saveVersion 镜像 web 端 saveVersion)', required: { '--id': '报表 id' }, diff --git a/src/commands/report/save.ts b/src/commands/report/save.ts index 0c8e71f..d18c1a8 100644 --- a/src/commands/report/save.ts +++ b/src/commands/report/save.ts @@ -19,7 +19,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' import { validateReportCreate } from './_validate.ts' @@ -111,7 +111,7 @@ export function buildReportSaveCommand(): Command { log.ok(`✓ 报表设计已保存 id=${opts.id} (v0.16+ 新 save 命令, type=0)`) if (opts.json) printJson({ id: opts.id, code, msg, raw: r }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '保存报表设计 (v0.16+ 新增, 替代 release --type=0)', required: { '--id': '报表 id' }, optional: { diff --git a/src/commands/report/templates.ts b/src/commands/report/templates.ts index e76af75..9d83ae9 100644 --- a/src/commands/report/templates.ts +++ b/src/commands/report/templates.ts @@ -16,7 +16,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' @@ -43,7 +43,7 @@ export function buildReportTemplatesCommand(): Command { // 默认打印原始 JSON (树形结构, 跟 web 端 report/index.vue 用法一致) printJson(data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '报表选择器 (web 等价: 菜单/下拉/树形展示用, 端点 /api/Report/Selector)', required: {}, example: 'dacli report templates\ndacli report templates --json', diff --git a/src/commands/report/update.ts b/src/commands/report/update.ts index a0607fd..53538f3 100644 --- a/src/commands/report/update.ts +++ b/src/commands/report/update.ts @@ -14,7 +14,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi as initReportWebapi, loadReport } from '../../webapi/report.ts' import { validateBasicInfo, validateNumeric } from './_validate.ts' // v0.15+ (P1-1) @@ -141,7 +141,7 @@ export function buildReportUpdateCommand(): Command { log.ok(`✓ 报表修改成功 id=${opts.id} (镜像 web 端 report.ts:21 updateReport, msg="${msg || '更新成功'}")`) if (opts.json) printJson({ id: opts.id, code, msg, raw: r }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '修改报表模板 (镜像 web 端 updateReport, jnpf-datareport-univer 微服务 /api/Report/{id})', required: { '--id': '报表 id' }, optional: { diff --git a/src/commands/role/assign.ts b/src/commands/role/assign.ts index b10f041..57b2057 100644 --- a/src/commands/role/assign.ts +++ b/src/commands/role/assign.ts @@ -13,7 +13,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi as initRoleRelationWebapi, loadRoleRelation } from '../../webapi/roleRelation.ts' @@ -69,7 +69,7 @@ export function buildRoleAssignCommand(): Command { } log.info(`✓ 角色 id=${opts.roleId} ${opts.action} ${userIds.length} 个用户 OK`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '给角色赋用户 (或从角色删用户, v0.15+ webapi 镜像 web roleRelation.ts addRoles/removeRoles)', required: { '--roleId': '角色 id', '--userIds': '用户 id 列表' }, optional: { '--action': 'add/remove' }, diff --git a/src/commands/role/create.ts b/src/commands/role/create.ts index 94bad0c..e15ef77 100644 --- a/src/commands/role/create.ts +++ b/src/commands/role/create.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { validateRoleCreate } from './_validate.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -82,7 +82,7 @@ export function buildRoleCreateCommand(): Command { log.info(`✓ 角色创建成功 id=${id}${userIdsArray.length > 0 ? ` (含 ${userIdsArray.length} 个用户绑定)` : ''}`) if (opts.json) printJson({ ...(r.data as object), id }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建角色 (P1 权限三角核心). v0.11d+ 加 step machine 校验 (3 step 镜像 web role/Form.vue + 后端 RoleController.create, BS-47 唯一性预校验, 约束字段联动校验, 聚合错误). v0.11e+ Phase A3 加 --user-ids 跨命令事务 (建角色后批量绑用户, 镜像 web roleRelationService.create).', required: { '--fullName': '角色名称', '--enCode': '角色编码' }, optional: { '--type': '0=全局 1=业务', '--user-ids': '关联用户 id 列表 (A3 跨命令事务)' }, diff --git a/src/commands/role/delete.ts b/src/commands/role/delete.ts index 3e737d0..fbf278e 100644 --- a/src/commands/role/delete.ts +++ b/src/commands/role/delete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadRole } from '../../webapi/role.ts' @@ -34,7 +34,7 @@ export function buildRoleDeleteCommand(): Command { } log.info(`✓ 角色 id=${opts.id} 已删除`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '删除角色 (isSystem=1 系统内置角色不可删)', required: { '--id': '角色 id', '--yes': '跳过确认' }, example: 'dacli role delete --id=1234567890 --yes', diff --git a/src/commands/role/info.ts b/src/commands/role/info.ts index 534d165..b85d99b 100644 --- a/src/commands/role/info.ts +++ b/src/commands/role/info.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadRole } from '../../webapi/role.ts' @@ -37,7 +37,7 @@ export function buildRoleInfoCommand(): Command { console.log(` isSystem : ${d.isSystem} (1=系统内置, 不可删改)`) console.log(` description : ${d.description || '-'}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '角色详情. AI 创建角色后验证 (P0 闭环, v0.11+ webapi).', required: { '--id': '角色 id' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/role/list.ts b/src/commands/role/list.ts index 291d41c..ed71550 100644 --- a/src/commands/role/list.ts +++ b/src/commands/role/list.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadRole } from '../../webapi/role.ts' @@ -58,7 +58,7 @@ export function buildRoleListCommand(): Command { console.log(`${id}${name}${code}${type}${enabled}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出角色 (权限载体, P1 权限三角核心)', optional: { '--keyword': '按名称/编码模糊搜索' }, example: 'dacli role list\ndacli role list --keyword=管理员', diff --git a/src/commands/role/selector.ts b/src/commands/role/selector.ts index ca16f59..805fc26 100644 --- a/src/commands/role/selector.ts +++ b/src/commands/role/selector.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadRole } from '../../webapi/role.ts' @@ -45,7 +45,7 @@ export function buildRoleSelectorCommand(): Command { console.log(`${id}${name}${code}${sys}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '角色下拉框. AI 选角色 id 必需 (form 配置 / menu 授权).', optional: { '--type': '角色类型 (0=全局 1=部门)', '--isSystem': '是否系统内置' }, example: ['dacli role selector', 'dacli role selector --type=0 (全局)', 'dacli role selector --isSystem=0 (非系统内置)'], diff --git a/src/commands/role/update.ts b/src/commands/role/update.ts index 1f52450..68a74ca 100644 --- a/src/commands/role/update.ts +++ b/src/commands/role/update.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadRole } from '../../webapi/role.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -97,7 +97,7 @@ export function buildRoleUpdateCommand(): Command { log.ok(`✓ 角色更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '角色修改 (改 fullName/enCode/enabledMark/description). PUT 语义, 未传字段保留原值.', required: { '--id': '角色 id' }, optional: { '--fullName': '中文名', '--enCode': '英文编码', '--enabledMark': '启用/禁用 (0|1)', '--description': '描述' }, diff --git a/src/commands/schedule/create.ts b/src/commands/schedule/create.ts index 4bbb815..66ec6ce 100644 --- a/src/commands/schedule/create.ts +++ b/src/commands/schedule/create.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadSchedule } from '../../webapi/schedule.ts' import { validateScheduleCreate } from './_validate.ts' @@ -80,7 +80,7 @@ export function buildScheduleCreateCommand(): Command { log.info(`✓ 定时任务创建成功 id=${id}`) if (opts.json) printJson(r.data || r) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建定时任务 (Quartz cron, 决策 9: 与工作流区别)', required: { '--fullName': '任务名称', '--enCode': '任务编码', '--executeType': '执行类型', '--executeContent': '执行内容' }, optional: { '--cron': 'cron 表达式' }, diff --git a/src/commands/schedule/delete.ts b/src/commands/schedule/delete.ts index 2eedddd..d165738 100644 --- a/src/commands/schedule/delete.ts +++ b/src/commands/schedule/delete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadSchedule } from '../../webapi/schedule.ts' @@ -32,7 +32,7 @@ export function buildScheduleDeleteCommand(): Command { } log.ok(`✓ 定时任务已删除 (id=${opts.id})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '定时任务删除. 任务调度会停.', required: { '--id': '任务 id', '--yes': '跳过确认' }, example: 'dacli schedule delete --id=123 --yes', diff --git a/src/commands/schedule/info.ts b/src/commands/schedule/info.ts index f59ce7e..597ed92 100644 --- a/src/commands/schedule/info.ts +++ b/src/commands/schedule/info.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadSchedule } from '../../webapi/schedule.ts' @@ -38,7 +38,7 @@ export function buildScheduleInfoCommand(): Command { console.log(`executeContent: ${d.executeContent || '-'}`) console.log(`enabledMark: ${d.enabledMark === 1 ? '启用' : '停用'}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查看定时任务详情 (Quartz cron + 执行配置)', required: { '--id': '定时任务 id' }, example: 'dacli schedule info --id=1234567890', diff --git a/src/commands/schedule/list.ts b/src/commands/schedule/list.ts index 5c78e1c..8cc1ed1 100644 --- a/src/commands/schedule/list.ts +++ b/src/commands/schedule/list.ts @@ -18,7 +18,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadSchedule } from '../../webapi/schedule.ts' @@ -50,7 +50,7 @@ export function buildScheduleListCommand(): Command { } if (opts.json) printJson(r) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列定时任务 (JNPF 6.2 端点 bug, 兜底用 info/log 单点查)', example: 'dacli schedule list (已知返空)\ndacli schedule info --id=1234567890', source: { diff --git a/src/commands/schedule/log.ts b/src/commands/schedule/log.ts index 80916b2..e01dbb3 100644 --- a/src/commands/schedule/log.ts +++ b/src/commands/schedule/log.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadSchedule } from '../../webapi/schedule.ts' @@ -51,7 +51,7 @@ export function buildScheduleLogCommand(): Command { console.log(`${id}${t}${r2} ${d.description || '-'}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查看定时任务执行日志', required: { '--id': '定时任务 id' }, example: 'dacli schedule log --id=1234567890', diff --git a/src/commands/schedule/trigger.ts b/src/commands/schedule/trigger.ts index e545615..585f2a4 100644 --- a/src/commands/schedule/trigger.ts +++ b/src/commands/schedule/trigger.ts @@ -5,7 +5,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface TriggerOpts { @@ -25,7 +25,7 @@ export function buildScheduleTriggerCommand(): Command { } log.info(`✓ 定时任务 id=${opts.id} 已触发`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '手动触发定时任务 (不等 cron, 立即跑)', required: { '--id': '定时任务 id' }, example: 'dacli schedule trigger --id=1234567890', diff --git a/src/commands/schedule/update.ts b/src/commands/schedule/update.ts index 08649dc..27efb2b 100644 --- a/src/commands/schedule/update.ts +++ b/src/commands/schedule/update.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadSchedule } from '../../webapi/schedule.ts' import { dirtyCheck, dirtyCheckFailAndExit } from '../_dirty_check.ts' @@ -110,7 +110,7 @@ export function buildScheduleUpdateCommand(): Command { log.ok(`✓ 定时任务更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '定时任务修改 (改 cron/executeContent/enabledMark, v0.11+ webapi + v0.11e+ dirty check + step machine)', required: { '--id': '任务 id' }, optional: { diff --git a/src/commands/storage/backup.ts b/src/commands/storage/backup.ts index f153ec2..0d7e8ad 100644 --- a/src/commands/storage/backup.ts +++ b/src/commands/storage/backup.ts @@ -6,7 +6,7 @@ import { Command } from 'commander' import { defaultYmlPath, backupYml } from './_helpers.ts' import { log } from '../../core/log.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' interface BackupOpts { profile?: string @@ -23,7 +23,7 @@ export function buildStorageBackupCommand(): Command { const bak = backupYml(ymlPath) log.info(`✓ 已备份: ${ymlPath} → ${bak}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '显式备份 application-{profile}.yml 到 .history/ 目录', optional: { '--profile': 'spring profile (默认 dev)', '--yml': '显式 yml 路径' }, example: 'dacli storage backup\ndacli storage backup --profile=prod', diff --git a/src/commands/storage/diff.ts b/src/commands/storage/diff.ts index 8bc8182..e7640e9 100644 --- a/src/commands/storage/diff.ts +++ b/src/commands/storage/diff.ts @@ -7,7 +7,7 @@ import { Command } from 'commander' import { defaultYmlPath, diffYmlWithGit } from './_helpers.ts' import { log } from '../../core/log.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' interface DiffOpts { profile?: string @@ -28,7 +28,7 @@ export function buildStorageDiffCommand(): Command { } console.log(out) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '跟 git HEAD 对比 application-{profile}.yml — 看 storage use 改了什么', optional: { '--profile': 'spring profile (默认 dev)', '--yml': '显式 yml 路径' }, example: 'dacli storage diff\ndacli storage diff --profile=prod', diff --git a/src/commands/storage/info.ts b/src/commands/storage/info.ts index df222df..b9c3c14 100644 --- a/src/commands/storage/info.ts +++ b/src/commands/storage/info.ts @@ -4,7 +4,7 @@ import { Command } from 'commander' import { readStorageConfig, defaultYmlPath, maskPlatform } from './_helpers.ts' import { log, printJson } from '../../core/log.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' interface InfoOpts { profile?: string @@ -46,7 +46,7 @@ export function buildStorageInfoCommand(): Command { console.log(` ${key} ${JSON.stringify(v)}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '显示某 platform 的详细配置 (access-key / secret-key 等敏感字段自动脱敏)', required: { '': 'platform 实例名, 如 local-plus-1 / aliyun-oss-1 / minio-1 (先用 list 看)' }, optional: { diff --git a/src/commands/storage/list.ts b/src/commands/storage/list.ts index 5ff67f4..35e7d9d 100644 --- a/src/commands/storage/list.ts +++ b/src/commands/storage/list.ts @@ -7,7 +7,7 @@ import { Command } from 'commander' import { readStorageConfig, defaultYmlPath, maskPlatform } from './_helpers.ts' import { log, printJson } from '../../core/log.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' interface ListOpts { profile?: string @@ -51,7 +51,7 @@ export function buildStorageListCommand(): Command { log.warn('yml 中未发现任何已知后端 (7 种 backend-type 都没出现)') } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出 application-{profile}.yml 中 file-storage 配置的所有后端 (含 enable-storage / default 状态)', optional: { '--profile': 'spring profile (默认 dev, 可选 dev/test/prod/preview)', diff --git a/src/commands/storage/test.ts b/src/commands/storage/test.ts index 40ae1ea..4385509 100644 --- a/src/commands/storage/test.ts +++ b/src/commands/storage/test.ts @@ -13,7 +13,7 @@ import { join } from 'node:path' import { JnpfClient } from '../../core/client.ts' import { readStorageConfig, defaultYmlPath } from './_helpers.ts' import { log, printJson } from '../../core/log.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' interface TestOpts { @@ -100,7 +100,7 @@ export function buildStorageTestCommand(): Command { } log.info(`共 ${results.length} 个全部通过`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '测试存储后端连通性 — 走 JNPF /api/file/Uploader/{type} 上传 1KB 测试文件', required: { '[platform]': '可选, 不传则测所有 enableStorage=true 的' }, optional: { diff --git a/src/commands/storage/use.ts b/src/commands/storage/use.ts index 0b34a44..63f6e9b 100644 --- a/src/commands/storage/use.ts +++ b/src/commands/storage/use.ts @@ -9,7 +9,7 @@ import { Command } from 'commander' import { readStorageConfig, defaultYmlPath, writeDefaultPlatform, backupYml } from './_helpers.ts' import { log } from '../../core/log.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' interface UseOpts { profile?: string @@ -58,7 +58,7 @@ export function buildStorageUseCommand(): Command { process.exit(1) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '切换 file-storage.default-platform — 改 yml + 备份 + 提示手动重启', required: { '': '目标 platform 实例名, 如 minio-1 / aliyun-oss-1 (先用 list 看)' }, optional: { diff --git a/src/commands/test/generate.ts b/src/commands/test/generate.ts index 0901d64..5263862 100644 --- a/src/commands/test/generate.ts +++ b/src/commands/test/generate.ts @@ -19,7 +19,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import * as fs from 'node:fs/promises' @@ -83,7 +83,7 @@ export function buildTestGenerateCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '生成浏览器 E2E 脚本 (playwright bash, 覆盖 vmodel bind bug)', required: { '--formId': '目标 form id' }, optional: { diff --git a/src/commands/test/render.ts b/src/commands/test/render.ts index 21b9a06..1ae8aef 100644 --- a/src/commands/test/render.ts +++ b/src/commands/test/render.ts @@ -79,7 +79,7 @@ import { initWebapi as initWebapiUser, loadUser } from '../../webapi/user.ts' import { initWebapi as initWebapiLog, loadLog } from '../../webapi/log.ts' import { initWebapi as initWebapiReport, loadReport } from '../../webapi/report.ts' import { initWebapi as initWebapiVisualData, loadVisualData } from '../../webapi/visualdata.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import * as fs from 'node:fs/promises' @@ -229,7 +229,7 @@ export function buildTestRenderCommand(): Command { if (failPages > 0) process.exit(1) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '源码渲染验证 (替代浏览器验证) — 读 vue 渲染契约 + 调 API, 检查字段完整性 (~2s)', required: { '--module': 'dict | form | di | menu | portal | workflow | role | msg | schedule | monitor | user | log | report | bigscreen' }, optional: { diff --git a/src/commands/test/run.ts b/src/commands/test/run.ts index 9d864ad..2d9ddc6 100644 --- a/src/commands/test/run.ts +++ b/src/commands/test/run.ts @@ -26,7 +26,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface RunOpts { @@ -529,7 +529,7 @@ export function buildTestRunCommand(): Command { if (failCount > 0) process.exit(1) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '跑 form API 测试 (POST/GET/PUT/DELETE + 跨表 join + 业务规则, 默认走真实业务数据)', required: { '--formId': '目标 form id' }, optional: { diff --git a/src/commands/user/auth-groups.ts b/src/commands/user/auth-groups.ts index 2e4b089..1b35e82 100644 --- a/src/commands/user/auth-groups.ts +++ b/src/commands/user/auth-groups.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface AuthGroupItem { @@ -71,7 +71,7 @@ export function buildUserAuthGroupsCommand(): Command { console.log(`${id}${type}${name}${child}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查用户权限分组 (admin 操作, 返回角色/岗位/组织树)', required: { '--userId': '用户 id' }, optional: { '--json': '原始 JSON 输出 (含 children 嵌套)' }, diff --git a/src/commands/user/auth-list.ts b/src/commands/user/auth-list.ts index cebc618..db210fc 100644 --- a/src/commands/user/auth-list.ts +++ b/src/commands/user/auth-list.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface AuthItem { @@ -86,7 +86,7 @@ export function buildUserAuthListCommand(): Command { } } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查用户具体权限 (admin 操作, 7 类: 菜单/按钮/列表/表单/数据/流程/打印)', required: { '--userId': '用户 id', diff --git a/src/commands/user/baseinfo.ts b/src/commands/user/baseinfo.ts index c2d3cae..fbb1a3f 100644 --- a/src/commands/user/baseinfo.ts +++ b/src/commands/user/baseinfo.ts @@ -11,7 +11,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface BaseinfoOpts { @@ -38,7 +38,7 @@ export function buildUserBaseinfoCommand(): Command { } log.info(`✓ 个人资料已更新: ${Object.keys(fields).map((k) => `${k}=${fields[k]}`).join(', ')}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '修改当前用户个人资料 (self 操作, 通用入口)', required: { '--fields': '字段 JSON, 支持 mobilePhone/email/realName/gender/nation/education/birthday/...' }, example: diff --git a/src/commands/user/batch-delete.ts b/src/commands/user/batch-delete.ts index ffdf382..b6ee54b 100644 --- a/src/commands/user/batch-delete.ts +++ b/src/commands/user/batch-delete.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface BatchDeleteOpts { @@ -38,7 +38,7 @@ export function buildUserBatchDeleteCommand(): Command { } log.info(`✓ 已删除 ${ids.length} 个用户`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '批量删除用户 (admin 操作)', required: { '--ids': '用户 id 列表 (逗号分隔)', '--yes': '跳过确认' }, example: 'dacli user batch-delete --ids=id1,id2,id3 --yes', diff --git a/src/commands/user/batch-set-position.ts b/src/commands/user/batch-set-position.ts index 881cdeb..08ca1b2 100644 --- a/src/commands/user/batch-set-position.ts +++ b/src/commands/user/batch-set-position.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface BatchSetPositionOpts { @@ -36,7 +36,7 @@ export function buildUserBatchSetPositionCommand(): Command { } log.info(`✓ 已为 ${userIds.length} 个用户设置 ${ids.length} 个岗位`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '批量设置用户岗位 (admin 操作)', required: { '--userIds': '用户 id 列表', '--positionIds': '岗位 id 列表' }, example: 'dacli user batch-set-position --userIds=uid1,uid2 --positionIds=pid1,pid2', diff --git a/src/commands/user/batch-state.ts b/src/commands/user/batch-state.ts index b1093c5..ebab61f 100644 --- a/src/commands/user/batch-state.ts +++ b/src/commands/user/batch-state.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface BatchStateOpts { @@ -40,7 +40,7 @@ export function buildUserBatchStateCommand(): Command { const stateName = enabledMark === 1 ? '启用' : enabledMark === 2 ? '锁定' : '禁用' log.info(`✓ 已更新 ${ids.length} 个用户状态为${stateName}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '批量启/禁/锁用户 (admin 操作)', required: { '--ids': '用户 id 列表 (逗号分隔)', '--state': '0=禁用 1=启用 2=锁定' }, example: 'dacli user batch-state --ids=id1,id2,id3 --state=1', diff --git a/src/commands/user/changepwd.ts b/src/commands/user/changepwd.ts index 3ea21d1..f363277 100644 --- a/src/commands/user/changepwd.ts +++ b/src/commands/user/changepwd.ts @@ -11,7 +11,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { encryptByMd5 } from '../../core/crypto.ts' import { rmSync } from 'node:fs' @@ -54,7 +54,7 @@ export function buildUserChangepwdCommand(): Command { } log.info('下次命令将自动重登') }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '修改当前用户密码 (self 操作, 简化: 仅需旧密码+新密码)', required: { '--oldPassword': '旧密码 (明文)', '--newPassword': '新密码 (明文)' }, example: 'dacli user changepwd --oldPassword=123456 --newPassword=newpass', diff --git a/src/commands/user/create.ts b/src/commands/user/create.ts index 97cbc9b..ab9ae62 100644 --- a/src/commands/user/create.ts +++ b/src/commands/user/create.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { encryptByMd5 } from '../../core/crypto.ts' import { initWebapi, loadUser } from '../../webapi/user.ts' @@ -94,7 +94,7 @@ export function buildUserCreateCommand(): Command { log.info(`✓ 用户创建成功 id=${id}`) if (opts.json) printJson({ ...(r.data as object || r), id }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建用户 (P1 权限三角 2 号)', required: { '--account': '账号', '--realName': '真实姓名', '--password': '明文密码' }, optional: { '--organizeId': '所属组织 id (决策 7 必填)' }, diff --git a/src/commands/user/delete.ts b/src/commands/user/delete.ts index b60b617..4a6a95b 100644 --- a/src/commands/user/delete.ts +++ b/src/commands/user/delete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadUser } from '../../webapi/user.ts' @@ -35,7 +35,7 @@ export function buildUserDeleteCommand(): Command { } log.info(`✓ 用户 id=${opts.id} 已删除`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '删除用户 (isAdministrator=1 不可删)', required: { '--id': '用户 id', '--yes': '跳过确认' }, example: 'dacli user delete --id=1234567890 --yes', diff --git a/src/commands/user/get-position.ts b/src/commands/user/get-position.ts index bc7791a..549ed34 100644 --- a/src/commands/user/get-position.ts +++ b/src/commands/user/get-position.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface PositionItem { @@ -57,7 +57,7 @@ export function buildUserGetPositionCommand(): Command { console.log(`${pid}${org}${pname}${main}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查询用户岗位 (admin 操作, 返回岗位数组)', required: { '--id': '用户 id' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/user/info.ts b/src/commands/user/info.ts index 958e5d1..8909132 100644 --- a/src/commands/user/info.ts +++ b/src/commands/user/info.ts @@ -20,7 +20,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { loadToken } from '../../core/config.ts' import { getUserInfoApi } from '../../webapi/user.ts' @@ -101,7 +101,7 @@ export function buildUserInfoCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '用户信息查询 (v3.0+ 双入口: 无 id 走 CurrentUser, 有 id 走 web getUserInfo)', optional: { '': '用户 id (省略则查 CurrentUser)', diff --git a/src/commands/user/list.ts b/src/commands/user/list.ts index 5962271..d36a8f2 100644 --- a/src/commands/user/list.ts +++ b/src/commands/user/list.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadUser } from '../../webapi/user.ts' @@ -61,7 +61,7 @@ export function buildUserListCommand(): Command { console.log(`${id}${acct}${name}${org}${pos}${en}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '列出用户 (P1 权限三角 2 号, 登录主体)', optional: { '--keyword': '按账号/姓名/手机模糊搜索' }, example: 'dacli user list\ndacli user list --keyword=admin', diff --git a/src/commands/user/online-kick.ts b/src/commands/user/online-kick.ts index 3ee8c18..f8c5bc9 100644 --- a/src/commands/user/online-kick.ts +++ b/src/commands/user/online-kick.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface OnlineKickOpts { @@ -34,7 +34,7 @@ export function buildUserOnlineKickCommand(): Command { } log.info(`✓ token=${opts.token.slice(0, 8)}... 已踢下线`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '强制下线某 token (admin/self 操作, 防自踢)', required: { '--token': '要踢的 token (从 onlineUser 列表获取)' }, example: 'dacli user online-kick --token=eyJhbGciOi...', diff --git a/src/commands/user/resetpwd.ts b/src/commands/user/resetpwd.ts index 7f525a2..194354b 100644 --- a/src/commands/user/resetpwd.ts +++ b/src/commands/user/resetpwd.ts @@ -10,7 +10,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { encryptByMd5 } from '../../core/crypto.ts' @@ -57,7 +57,7 @@ export function buildUserResetPwdCommand(): Command { } log.ok(`✓ 用户 id=${opts.id} (account=${account}) 密码已重置`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '重置用户密码 (admin 操作, 镜像 web 端 ResetPassword.vue)', required: { '--id': '用户 id', '--password': '新明文密码' }, example: 'dacli user resetpwd --id=1234567890 --password=123456', diff --git a/src/commands/user/set-position.ts b/src/commands/user/set-position.ts index f133577..7674c47 100644 --- a/src/commands/user/set-position.ts +++ b/src/commands/user/set-position.ts @@ -8,7 +8,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface SetPositionOpts { @@ -34,7 +34,7 @@ export function buildUserSetPositionCommand(): Command { } log.info(`✓ 用户 id=${opts.id} 已设置 ${ids.length} 个岗位`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '设置用户岗位 (admin 操作, 全量替换)', required: { '--id': '用户 id', '--positionIds': '岗位 id 列表 (逗号分隔)' }, example: 'dacli user set-position --id=1234567890 --positionIds=pid1,pid2', diff --git a/src/commands/user/socials-unbind.ts b/src/commands/user/socials-unbind.ts index 9ed48ac..96650f1 100644 --- a/src/commands/user/socials-unbind.ts +++ b/src/commands/user/socials-unbind.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface SocialsItem { @@ -61,7 +61,7 @@ export function buildUserSocialsUnbindCommand(): Command { } log.info(`✓ 用户 id=${opts.userId} 社交账号 socialsId=${opts.socialsId} 已解绑`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '解绑社交账号 (admin 操作)', required: { '--userId': '用户 id' }, optional: { '--socialsId': '社交账号 entity.id (不传只列出)', '--list': '只列出不解绑' }, diff --git a/src/commands/user/unlock.ts b/src/commands/user/unlock.ts index 45b9b40..a8c94f9 100644 --- a/src/commands/user/unlock.ts +++ b/src/commands/user/unlock.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface UnlockOpts { @@ -27,7 +27,7 @@ export function buildUserUnlockCommand(): Command { } log.info(`✓ 用户 id=${opts.id} 已解除锁定`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '解除用户锁定 (admin 操作)', required: { '--id': '用户 id' }, example: 'dacli user unlock --id=1234567890', diff --git a/src/commands/user/update.ts b/src/commands/user/update.ts index a25a6a0..6d2ba36 100644 --- a/src/commands/user/update.ts +++ b/src/commands/user/update.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { dirtyCheck, dirtyCheckFailAndExit } from '../_dirty_check.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -63,7 +63,7 @@ export function buildUserUpdateCommand(): Command { } log.info(`✓ 用户 id=${opts.id} 已更新: ${Object.keys(fields).join(', ')}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '编辑用户 (admin 操作, PUT /Users/{id} + v0.11e+ dirty check)', required: { '--id': '用户 id', '--fields': '字段 JSON (realName/email/mobilePhone/enabledMark/sortCode/...)' }, optional: { '--expected-account': '防 AI 误覆盖 (A2)', '--force': '跳过 dirty check (A2)' }, diff --git a/src/commands/user/workHandover.ts b/src/commands/user/workHandover.ts index fbfc3b8..33bbeb3 100644 --- a/src/commands/user/workHandover.ts +++ b/src/commands/user/workHandover.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' interface WorkItem { @@ -74,7 +74,7 @@ export function buildUserWorkHandoverCommand(): Command { } log.info(`✓ 工作已从 id=${opts.fromUserId} 交接给 id=${opts.toUserId}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '工作交接 (admin 操作, 默认全交接)', required: { '--fromUserId': '移交人 id', '--toUserId': '接收人 id' }, optional: { diff --git a/src/commands/workflow/approve.ts b/src/commands/workflow/approve.ts index e20a219..c1596d7 100644 --- a/src/commands/workflow/approve.ts +++ b/src/commands/workflow/approve.ts @@ -5,7 +5,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface Opts { @@ -39,7 +39,7 @@ export function buildWorkflowApproveCommand(): Command { if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '审批流程节点. 0=同意 1=不同意 2=退回.', required: { '--operatorId': '审批节点 id', '--status': '0/1/2' }, optional: { '--opinion': '审批意见' }, diff --git a/src/commands/workflow/create.ts b/src/commands/workflow/create.ts index a310650..5d386e1 100644 --- a/src/commands/workflow/create.ts +++ b/src/commands/workflow/create.ts @@ -25,7 +25,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { callAiWorkflow, detectTrivialFlowXml } from '../form/_ai.ts' import { buildFlowNodes, validateFlowNodeStructure } from './_webapi_helpers.ts' @@ -380,7 +380,7 @@ export function buildWorkflowCreateCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '新建流程模板 (v0.12+ BS-新27: 6 步 webapi 路径, 镜像 web AiCreateModal 端到端可用)', required: { '--fullName': '中文名', '--category': '分类 id 或中文' }, optional: { diff --git a/src/commands/workflow/decision.ts b/src/commands/workflow/decision.ts index 54c0224..62cfc96 100644 --- a/src/commands/workflow/decision.ts +++ b/src/commands/workflow/decision.ts @@ -12,7 +12,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface DecisionOpts { @@ -82,7 +82,7 @@ export function buildWorkflowDecisionCommand(): Command { console.log(` ${k.padEnd(20)} : ${vShort}`) } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '决策流参数 (白皮书 5.6.5) — 漏斗/覆盖/规则集/评分卡/交叉表/异常, 是 template 的子配置', required: { ' | --list': '模板 id, 或 --list 列所有含决策流的' }, optional: { '--json': '原始 JSON' }, diff --git a/src/commands/workflow/delete.ts b/src/commands/workflow/delete.ts index 8c4417d..098d3ed 100644 --- a/src/commands/workflow/delete.ts +++ b/src/commands/workflow/delete.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log } from '../../core/log.ts' import { initWebapi, loadWorkflow } from '../../webapi/workflow.ts' @@ -42,7 +42,7 @@ export function buildWorkflowDeleteCommand(): Command { } log.ok(`✓ 流程模板已删除 (id=${opts.id})`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '流程模板删除. 引用该流程的 form 会失效.', required: { '--id': '流程模板 id', '--yes': '跳过确认' }, example: 'dacli workflow delete --id=1234567890 --yes', diff --git a/src/commands/workflow/info.ts b/src/commands/workflow/info.ts index e70b1ed..ad97d50 100644 --- a/src/commands/workflow/info.ts +++ b/src/commands/workflow/info.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadWorkflow } from '../../webapi/workflow.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -95,7 +95,7 @@ export function buildWorkflowInfoCommand(): Command { console.log(` flowNodes 节点数: ${d.flowNodes ? Object.keys(d.flowNodes as object).length : 0}`) console.log(` description : ${d.description || '-'}`) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '流程模板详情. AI 引用 workflow id 验证 (P0 闭环). v0.12+ 优先 getFlowInfo 返回完整信息 (含 flowXml/flowNodes/enabledMark/flowId).', required: { '--id': '流程模板 id' }, optional: { '--json': '原始 JSON 输出' }, diff --git a/src/commands/workflow/launch.ts b/src/commands/workflow/launch.ts index 1df4044..5716223 100644 --- a/src/commands/workflow/launch.ts +++ b/src/commands/workflow/launch.ts @@ -11,7 +11,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface Opts { @@ -58,7 +58,7 @@ export function buildWorkflowLaunchCommand(): Command { if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '发起一个流程实例. 需 form.enableFlow=1.', required: { '--flowId': '流程模板 id', '--formId': '绑定 form id', '--data': '表单数据 JSON' }, example: `dacli workflow launch --flowId= --formId= --data='{"f_name":"张三"}'`, diff --git a/src/commands/workflow/list.ts b/src/commands/workflow/list.ts index 36bf8f7..0186fc2 100644 --- a/src/commands/workflow/list.ts +++ b/src/commands/workflow/list.ts @@ -7,7 +7,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface ListOpts { @@ -51,7 +51,7 @@ export function buildWorkflowListCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '看流程模板 (--category) 或 我的待办 (--todo 1/2/3).', required: {}, optional: { '--category': '模板分类', '--todo': '1=待审批 2=已审批 3=抄送', '--pageSize': '每页' }, diff --git a/src/commands/workflow/selector.ts b/src/commands/workflow/selector.ts index 6fcda86..bb32462 100644 --- a/src/commands/workflow/selector.ts +++ b/src/commands/workflow/selector.ts @@ -9,7 +9,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadWorkflow } from '../../webapi/workflow.ts' @@ -49,7 +49,7 @@ export function buildWorkflowSelectorCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '流程模板下拉框, AI 创建菜单挂工作流 (type=4) 时必跑.', required: {}, optional: { diff --git a/src/commands/workflow/syncForm.ts b/src/commands/workflow/syncForm.ts index 24342cb..f75b058 100644 --- a/src/commands/workflow/syncForm.ts +++ b/src/commands/workflow/syncForm.ts @@ -19,7 +19,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface SyncFormOpts { @@ -69,7 +69,7 @@ export function buildWorkflowSyncFormCommand(): Command { ) if (opts.json) printJson({ flowId: opts.flowId, status: 'synced', ...(r as object) }) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: 'BS-新27 同步 workflow formData + form.workflowEnabled (修 jxcj TC-B 5 fail modal-not-opened)', required: { '--flowId': '工作流模板 id' }, diff --git a/src/commands/workflow/tasks.ts b/src/commands/workflow/tasks.ts index 9d79098..7c01416 100644 --- a/src/commands/workflow/tasks.ts +++ b/src/commands/workflow/tasks.ts @@ -11,7 +11,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' interface Opts { @@ -76,7 +76,7 @@ export function buildWorkflowTasksCommand(): Command { } }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '查我的流程任务 (待签/待办/已办/抄送 4 类)', optional: { '--category': '1=待签 2=待办 3=已办 4=抄送', diff --git a/src/commands/workflow/update.ts b/src/commands/workflow/update.ts index 9d4c0c8..26d7552 100644 --- a/src/commands/workflow/update.ts +++ b/src/commands/workflow/update.ts @@ -6,7 +6,7 @@ */ import { Command } from 'commander' import { JnpfClient } from '../../core/client.ts' -import { installAiHelpHook } from '../../core/help.ts' +import { installHelpHook } from '../../core/help.ts' import { log, printJson } from '../../core/log.ts' import { initWebapi, loadWorkflow } from '../../webapi/workflow.ts' import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts' @@ -191,7 +191,7 @@ export function buildWorkflowUpdateCommand(): Command { log.ok(`✓ 流程模板更新成功 (id=${opts.id})`) if (opts.json) printJson(r.data) }) - installAiHelpHook(cmd, { + installHelpHook(cmd, { purpose: '流程模板修改 (PUT 语义). v0.12+ Bug 2 修: --enabledMark=1 走 saveFlow; Bug 3 修: --startFormId 绑 start node 表单', required: { '--id': '流程模板 id' }, optional: {