Files
dacli/docs/cmd-review/app.md
T
sswandClaude b9c9e318af feat(v0.11+): Phase 1 - 23 个 dacli 父命令审计完成
派 25 个 Explore 子代理 (5 批 × 5) 审计 23 个父命令.
产出 cmd-review/{cmd}.md (24 文件) + _summary.md.

关键发现:
- webapi 镜像使用率 < 30% (12+ 父命令 100% 绕 webapi)
- 30+ P0 必补新命令 (form update, log exception, di CRUD, role authorize 等)
- 3 处 P0 端点错误 (假 PASS):
  * integration emailTest/smsTest
  * msg templateCreate
- 用户关键修正: bigscreen → jnpf-web-datascreen-vue3 (独立子项目)
- 用户关键修正: report → jnpf-web-datareport (独立子项目)

下一步: Phase 2 按 P0 优先级执行 (修端点 + 新命令 + webapi 化)

Co-Authored-By: Claude <[email protected]>
2026-06-25 14:58:32 +08:00

5.8 KiB
Raw Blame History

dacli app 命令审计报告 (2026-06-25)

1. 命令清单

子命令 格式 用途
dacli app login [--account] [--password] [--appCode] [--baseUrl] 登录 JNPF,持久化 token 到 .dacli-token/token.json (默认 admin/123456@developSystem)
dacli app status [--json] 显示当前登录状态 (token 路径 / baseUrl / appCode / dbLinkId)
dacli app switch --appCode <c> [--account] [--password] 切换当前应用(重新登录新 appCode 并覆盖 token)
dacli app init [--appCode] [--restart] 应用初始化(健康检查;--restart 一键重启 JNPF)
dacli app create --appCode <c> --appName <n> [--dbName] [--account] [--password] [--force-rebuild] [--skip-grant] [--skip-db] [--json] 真·创建 JNPF 应用(System+DB+DataSource+授权+重登,端到端 0 差错)
dacli app clear --appCode <c> [--dry-run] [--skip-db] [--no-restart] [--workspace] 清除应用本地资源+DB记录(破坏性,强制 TTY + 双重人工确认)
dacli app info --id <id> [--json] 查看应用详情(含 systemId/系统配置等)
dacli app list [--keyword] [--json] 列出所有应用(JNPF 多 app 生命周期)
dacli app context [--json] [--app] 输出当前应用环境快照(dbLinkId/enCode/表/菜单/token 状态)。AI 新会话第一步必跑

2. web 端对应

app 命令涉及认证 + 应用管理两大域:

2.1 认证 API

  • POST /api/oauth/Login (web 源: web/.../api/core/auth.ts:27 loginApi)
    • 参数:account, password (加密), code, origin, timestamp, jnpf_ticket, grant_type
    • 返回:token
  • POST /api/oauth/Logout (web 源: auth.ts:47 logoutApi)

2.2 应用管理 API (web 源: web/.../api/system/system.ts)

  • GET /api/system/System — 获取应用列表
  • GET /api/system/System/{id} — 获取单个应用
  • POST /api/system/System — 新建应用
  • PUT /api/system/System/{id} — 修改应用
  • DELETE /api/system/System/{id} — 删除应用
  • POST /api/system/System/{id}/Actions/Copy — 复制应用
  • GET /api/system/System/{id}/Actions/Export — 导出应用

2.3 当前 dacli 实现方式

  • 直接 import web 端 API 函数 (webapi 镜像架构) — 用于 menu/dict/dataModel 等模块
  • 直接调用 JnpfClient.get/postJson — 用于 app/login/status/switch/context/list/info (app/* 当前均走裸 HTTP,未用 webapi)

3. 改/删/留 建议

[KEEP] 保留(核心 AI 接口)

  • app context — ⭐ P0.1 优先级,AI 新会话第一步;v0.10+ 已生产验证
  • app login — 登录入口,token 持久化核心
  • app status — 状态查询,脚本入口必备
  • app switch — 多 app 切换的基线复刻常用命令

[REFACTOR-WEBAPI] 改用 webapi 镜像

  • app list — 应改用 webapi 镜像(导入 web/.../api/system/system.ts 的 getSystemList)
  • app info — 应改用 webapi 镜像(getInfo)
  • app create — 应改用 webapi 镜像(create + saveAppAuth)
  • app switch — 内部复用 app login,但逻辑应改为调用 webapi 的 loginApi 镜像

应新增 webapi/auth.ts + webapi/system.ts 模块,与现有 menu/dict 一致。

[DEPRECATE] 已废弃或需改进

  • app init --restart — 当前仅 dry-run(注释明确说 "v0.9+ 才实做"),是虚假功能。建议:
    • 短期:加 @deprecated 标签 + 提示用户改用 dacli app context 验证健康
    • 长期(v0.12+):实做 kill+nohup+健康检查+重登(读 dacli.conf)

[NEW-CMD] 缺新命令

  • dacli app logout — 当前无登出命令。web 端有 logoutApi,dacli 仅做 clearToken 即可
  • dacli app health — 单独的健康检查命令(不依赖 init 的 --restart 模糊语义)
  • dacli app refresh-token — token 即将过期前(剩余 < 1 天)自动刷新
  • dacli app context --include-drafts --include-schemas — context 当前仅返回表单 ID+enCode 列表
  • dacli app use <code> — 一体化 switch+context 命令,AI 一次调用拿全

4. AI 痛点评估

4.1 切应用 + 拿上下文流程

当前流程(AI 必跑 2 步):

dacli app switch --appCode=tds  # 切应用
dacli app context --json         # 拿快照

痛点:

  • ❌ 需 2 次调用。AI 经常忘记先 switch 直接 context
  • ❌ switch 不返回 systemId/dbLinkId,context 还得另查
  • ❌ 无 --app 一次性模式

建议:

  • 新增 dacli app use <appCode> 一体化命令(switch + context 二合一)

4.2 token 失效场景

当前:dacli app init -- --appCode=X --restart 用于 token 失效

痛点:

  • ❌ SKILL.md 明确写此命令用于 token 过期(BS-8 兜底),但 app init 实际不重新登录
  • ❌ token 失效后 AI 必须手动跑 dacli app login --appCode=X
  • ❌ 7 天有效期内无提醒

建议:

  • context 自动检测 token 即将过期(剩余 < 1 天)并输出 WARN
  • 新增 dacli app refresh:当检测到 401 时自动重新登录
  • 文档修正:SKILL.md 的 "BS-8" 兜底指引应改为 "跑 dacli app login --appCode=X"

核心结论:app 父命令 9 个子命令覆盖了认证+应用管理全生命周期,但存在 3 个核心问题:

  1. 架构不一致:当前 9 个子命令全走裸 HTTP,未用 v0.11+ webapi 镜像
  2. app context 不充分:缺字段级、schema 级信息,AI 仍需多次调用
  3. app init --restart 是虚假功能:dry-run 未实做,误导用户

最关键 3 个建议:

  1. 新增 webapi/auth.ts + webapi/system.ts,将 app/list/info/create/switch 改用 webapi 镜像
  2. context 增强:加 --full 一次性拉所有信息,加 token 过期预警
  3. 新增 dacli app use <code>:一体化 switch+context 命令