**根因**: 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
5.8 KiB
5.8 KiB
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 步):
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 个核心问题:
- 架构不一致:当前 9 个子命令全走裸 HTTP,未用 v0.11+ webapi 镜像
- app context 不充分:缺字段级、schema 级信息,AI 仍需多次调用
- app init --restart 是虚假功能:dry-run 未实做,误导用户
最关键 3 个建议:
- 新增
webapi/auth.ts+webapi/system.ts,将 app/list/info/create/switch 改用 webapi 镜像 - context 增强:加
--full一次性拉所有信息,加 token 过期预警 - 新增
dacli app use <code>:一体化 switch+context 命令