**根因**: 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
110 lines
5.8 KiB
Markdown
110 lines
5.8 KiB
Markdown
# 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 命令
|