# dacli `app` 命令审计报告 (2026-06-25) ## 1. 命令清单 | 子命令 | 格式 | 用途 | |--------|------|------| | `dacli app login` | `[--account] [--password] [--appCode] [--baseUrl]` | 登录 JNPF,持久化 token 到 **~/.dacli-token/token.json** (默认 admin/123456@testspace; DACLI_TOKEN_DIR env 可覆盖) | | `dacli app status` | `[--json]` | 显示当前登录状态 (token 路径 / baseUrl / appCode / dbLinkId) | | `dacli app switch` | `--appCode [--account] [--password]` | 切换当前应用(重新登录新 appCode 并覆盖 token) | | `dacli app init` | `[--appCode] [--restart]` | 应用初始化(健康检查;--restart 一键重启 JNPF) | | `dacli app create` | `--appCode --appName [--dbName] [--account] [--password] [--force-rebuild] [--skip-grant] [--skip-db] [--json]` | 真·创建 JNPF 应用(System+DB+DataSource+授权+重登,端到端 0 差错) | | `dacli app clear` | `--appCode [--dry-run] [--skip-db] [--no-restart] [--workspace]` | 清除应用本地资源+DB记录(破坏性,强制 TTY + 双重人工确认) | | `dacli app info` | `--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 `** — 一体化 switch+context 命令,AI 一次调用拿全 ## 4. AI 痛点评估 ### 4.1 切应用 + 拿上下文流程 **当前流程**(AI 必跑 2 步): ```bash dacli app switch --appCode=tds # 切应用 dacli app context --json # 拿快照 ``` **痛点**: - ❌ 需 2 次调用。AI 经常忘记先 switch 直接 context - ❌ switch 不返回 systemId/dbLinkId,context 还得另查 - ❌ 无 `--app` 一次性模式 **建议**: - **新增 `dacli app use `** 一体化命令(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 `**:一体化 switch+context 命令