Files
dacli/docs/cmd-review/app.md
T
ssw b2e86f6660 refactor(config): 统一 token 路径到 ~/.dacli-token (v0.15)
**根因**: v0.14- src/core/config.ts L17 默认 cwd 模式 (resolve(process.cwd(), '.dacli-token')),
导致 token 散落 6+ 位置:
  - ./dacli/.dacli-token/
  - ./test/.dacli-token/
  - ./boot/jnpf-admin/.dacli-token/
  - ./.dacli-token/
  - ./.claude/skills/.dacli-token/
跟 docs/尚数网基本开发规范v3.0.md '配置 ~/.dacli-token/' 不一致。
也跟同仓 src/commands/user/changepwd.ts L27 (已经用 homedir()) 不一致。

**改动**:
1. src/core/config.ts: tokenDir() 默认 homedir()/.dacli-token (跟 changepwd 一致)
2. src/commands/app/login.ts: 描述/帮助文本同步
3. docs/cmd-review/app.md: dacli app login 描述同步

**破坏性变更**:
- 老的 cwd 模式 token.json 不再被读, 用户需重新 dacli app login
- DACLI_TOKEN_DIR env 变量支持不变 (覆盖用)

**清理**: 老 6 个 .dacli-token/ 已删除, 新 token 只在 ~/.dacli-token/token.json
**验证**: dacli app status / dacli app context --json / dacli form list 全部 PASS
2026-07-01 18:36:23 +08:00

110 lines
5.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 <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 步):
```bash
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 命令