docs(memory): ssw-h5dev-flow v0.9 lint + dispatch 协议固化

This commit is contained in:
ssw committed 2026-06-14 20:38:47 +08:00
1 parent d22ac5f0e4
commit 707c3fbb50
5 files changed
+202

No files matched your search

+11
View File
@@ -0,0 +1,11 @@
{
"permissions": {
"allow": [
"Bash(awk -F'/' '{print $2\"/\"$3}')",
"Bash(awk -F'/' '{print $5\"/\"$6}')",
"Bash(grep -v ':0$')",
"Bash(curl -sS -u \"ssw:sswsswssw\" \"http://gitea:3000/api/v1/user/repos?limit=20\")",
"Bash(npx tsc *)"
]
}
}
+56
View File
@@ -0,0 +1,56 @@
/**
* commands/app/init.ts — `dacli app init` (原 `dacli app initapp`, v0.9 进一步简化为 init)
*
* 注: v0.7.1+ init 是 "JNPF 后端一键启动/重启 + 健康检查 + 重登" 工具,
* 不是 form 初始化. 走 dacli.conf 读 jar-pattern/port, 杀进程 + nohup.
*
* 占位: 真实 init 在 Java 版 ssw-dacli, TS 版 v0.9+ 集成.
* 本命令先返回 "JNPF 状态查询" 让用户看到当前 app 是否健康.
*/
import { Command } from 'commander'
import { JnpfClient } from '../../core/client.ts'
import { installAiHelpHook } from '../../core/help.ts'
import { log } from '../../core/log.ts'
interface InitAppOpts {
appCode?: string
restart?: boolean
}
export function buildAppInitCommand(): Command {
const cmd = new Command('init')
.description('应用初始化 (健康检查; --restart 一键重启 JNPF; v0.9+ 集成)')
.option('--appCode <code>', '应用 code (不传则用当前登录)')
.option('--restart', '重启 JNPF 后端 (v0.9+ 集成, 现在 dry-run)', false)
.action(async (opts: InitAppOpts) => {
const c = await JnpfClient.fromToken()
// 1. 健康检查: 拉 form list 看是否能返
const r = await c.get<{ list: unknown[] }>('/visualdev/Base', { currentPage: 1, pageSize: 1 })
if (r.code === 200) {
log.ok(`✓ JNPF 健康: appCode=${c.appCode} (form 列表可访问)`)
} else {
log.error(`✗ JNPF 不健康: code=${r.code} ${r.msg}`)
process.exit(1)
}
// 2. --restart: v0.9+ 才实做, 现在 dry-run
if (opts.restart) {
log.warn('--restart 当前 v0.9+ 才实做, 现在 dry-run')
log.info(' 计划: 读 dacli.conf 的 jar-pattern/port, kill+rm+nohup+健康检查+重登')
}
})
installAiHelpHook(cmd, {
purpose: '应用初始化 (健康检查 / 一键重启 JNPF)',
optional: { '--appCode': '应用 code', '--restart': '重启 JNPF 后端' },
example: 'dacli app init\ndacli app init --appCode=tds --restart',
source: {
web: 'web/apps/jnpf-web-apps-main/src/views/appCenter/index.vue',
api: 'GET /api/visualdev/Base (健康检查)',
ref: 'doc/v0.8-plan.md §4 D1',
},
notes: [
'**v0.9+ 实做**: --restart 走 dacli.conf 自动 kill+nohup+健康+重登',
'**当前**: --restart dry-run 提示计划',
],
})
return cmd
}
+50
View File
@@ -0,0 +1,50 @@
/**
* commands/app/login.ts — `dacli app login` (原顶层 `dacli app login`, v0.9 重命名归入 app 命名空间)
*/
import { Command } from 'commander'
import { JnpfClient } from '../../core/client.ts'
import { DEFAULT_ACCOUNT, DEFAULT_APP_CODE, DEFAULT_PASSWORD, getTokenPath } from '../../core/config.ts'
import { installAiHelpHook } from '../../core/help.ts'
import { log } from '../../core/log.ts'
export function buildAppLoginCommand(): Command {
const cmd = new Command('login')
.description('登录 JNPF (默认 admin/123456@developSystem), 持久化 token 到 .dacli-token/token.json')
.option('--account <a>', '账号', DEFAULT_ACCOUNT)
.option('--password <p>', '密码 (明文; 96 字符 hex 视为已加密)', DEFAULT_PASSWORD)
.option('--appCode <c>', '应用代码 (developSystem | workSystem | tds)', DEFAULT_APP_CODE)
.option('--baseUrl <u>', 'JNPF API 根地址 (含 /api)')
.action(async (opts: { account: string; password: string; appCode: string; baseUrl?: string }) => {
const c = await JnpfClient.login({
account: opts.account,
password: opts.password,
appCode: opts.appCode,
baseUrl: opts.baseUrl,
forceLogin: true,
})
log.ok(`登录成功: ${c.account} @ ${c.appCode}`)
log.dim(`baseUrl : ${c.baseUrl}`)
log.dim(`token : ${c.token.slice(0, 32)}... (${c.token.length} chars)`)
if (c.dbLinkId) log.dim(`dbLinkId : ${c.dbLinkId}`)
log.dim(`saved to : ${getTokenPath()}`)
})
installAiHelpHook(cmd, {
purpose: '登录 JNPF, 把 token 写到 .dacli-token/token.json, 后续命令自动复用',
optional: {
'--account': '账号 (默认 admin)',
'--password': '密码 (默认 123456; 已是 96 字符 hex 时跳过加密)',
'--appCode': '应用代码 (默认 developSystem)',
'--baseUrl': '强制指定 baseUrl, 否则按 [env JNPF_BASE_URL → http://nginx/api → http://127.0.0.1:30000/api] 依次尝试',
},
example: 'dacli app login --appCode=tds',
source: { web: 'web/.../auth.ts:27 loginApi', api: 'POST /api/oauth/Login' },
notes: [
'token 7 天有效',
'已加密的 96 字符 hex 不会重复加密',
'detectDbLinkId 自动从 /system/DataSource 拉业务库 id',
],
})
return cmd
}
+49
View File
@@ -0,0 +1,49 @@
/**
* commands/app/status.ts — `dacli app status` (原顶层 `dacli app status`, v0.9 重命名归入 app 命名空间)
*/
import { Command } from 'commander'
import { loadToken, getTokenPath, currentBaseUrl } from '../../core/config.ts'
import { installAiHelpHook } from '../../core/help.ts'
import { log } from '../../core/log.ts'
export function buildAppStatusCommand(): Command {
const cmd = new Command('status')
.description('显示当前登录状态 + baseUrl + appCode + dbLinkId + token 路径')
.option('--json', '以 JSON 输出 (便于脚本)', false)
.action((opts: { json?: boolean }) => {
const t = loadToken()
if (opts.json) {
console.log(JSON.stringify({
tokenPath: getTokenPath(),
baseUrl: t?.baseUrl || currentBaseUrl(),
loggedIn: !!t,
account: t?.account,
appCode: t?.appCode,
dbLinkId: t?.dbLinkId,
loginAt: t?.loginAt,
tokenLen: t?.token.length,
}, null, 2))
return
}
if (!t) {
log.warn('未登录. 先跑: dacli app login')
log.dim(`baseUrl: ${currentBaseUrl()}`)
log.dim(`token path: ${getTokenPath()}`)
return
}
log.ok(`已登录: ${t.account} @ ${t.appCode}`)
log.dim(`baseUrl : ${t.baseUrl}`)
log.dim(`dbLinkId : ${t.dbLinkId || '(unknown)'}`)
log.dim(`loginAt : ${t.loginAt}`)
log.dim(`token len : ${t.token.length}`)
log.dim(`token path: ${getTokenPath()}`)
})
installAiHelpHook(cmd, {
purpose: '显示当前登录状态. 写脚本前先跑一下确认登录态',
optional: { '--json': '以 JSON 输出' },
example: 'dacli app status',
})
return cmd
}
+36
View File
@@ -0,0 +1,36 @@
/**
* commands/app/switch.ts — `dacli app switch` (原顶层 `dacli switchapp` / `dacli switch-app`, v0.9 重命名归入 app 命名空间)
*/
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 { log } from '../../core/log.ts'
export function buildAppSwitchCommand(): Command {
const cmd = new Command('switch')
.description('切换当前应用 (重新登录新 appCode 并覆盖 token)')
.requiredOption('--appCode <c>', '目标应用代码')
.option('--account <a>', '账号')
.option('--password <p>', '密码')
.action(async (opts: { appCode: string; account?: string; password?: string }) => {
const cached = loadToken()
const c = await JnpfClient.login({
account: opts.account || cached?.account || DEFAULT_ACCOUNT,
password: opts.password || DEFAULT_PASSWORD,
appCode: opts.appCode,
baseUrl: cached?.baseUrl,
forceLogin: true,
})
log.ok(`切换成功: ${c.account} @ ${c.appCode}`)
log.dim(`dbLinkId : ${c.dbLinkId || '(unknown)'}`)
})
installAiHelpHook(cmd, {
purpose: '切换当前应用, 重新登录并覆盖本地 token. baseline 复刻常用',
required: { '--appCode': '目标应用 (developSystem | workSystem | tds)' },
example: ['dacli app switch --appCode=developSystem', 'dacli app switch --appCode=tds'],
})
return cmd
}