派 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]>
11 KiB
11 KiB
dacli user 命令审计报告
审计对象: dacli user 父命令 (18 子命令)
审计版本: v0.11+ webapi 镜像架构
审计类型: Explore (只读审计, 不改代码)
审计时间: 2026-06-25
1. 命令清单 (18 子命令)
基础 CRUD (5)
list— 列出用户create— 新建用户update— 编辑用户delete— 删除用户unlock— 解除用户锁定
密码管理 (2)
changepwd— 用户自己改密码resetpwd— 管理员重置用户密码
个人资料 (1)
baseinfo— 用户自己改个人资料
批量操作 (3)
batch-delete— 批量删除用户batch-state— 批量启/禁/锁用户batch-set-position— 批量设置用户岗位
岗位管理 (2)
get-position— 查询用户岗位set-position— 设置用户岗位
高级管理 (5)
workHandover— 工作交接socials-unbind— 解绑社交账号online-kick— 强制下线某 token
权限查询 (2)
auth-list— 查询用户具体权限auth-groups— 查询用户权限分组
2. web 端对应
用户管理页面
- 位置:
web/apps/jnpf-web-apps-main/src/views/permission/user/ - 核心文件:
index.vue— 用户列表 + CRUD 入口Form.vue— 用户新建/编辑表单WorkHandoverModal.vue— 工作交接弹窗SocialsBind.vue— 社交账号绑定
用户 API (web 端)
- 位置:
web/apps/jnpf-web-apps-main/src/api/permission/user.ts - 完整 API 列表 (21 个):
getUserList, getUserSelector, createUser, updateUser, getUserInfo, delUser, batchDelete, resetUserPassword, batchUpdateState, unlockUser, getUserInfoList, exportExcel, templateDownload, importData, importPreview, exportExceptionData, getSelectedList, getSelectedUserList, getWorkByUser, workHandover, getReceiveUserList, getSamePosUser, getUserPosition, setUserPosition, getUserImUserList, getSocialsList, deleteSocials
JNPF 后端接口
- 基础:
GET/POST/PUT/DELETE /api/permission/Users - 批量:
POST /api/permission/Users/BatchDelete, BatchUpdateState, SetPositionBatch - 动作:
PUT /api/permission/Users/{id}/Actions/unlock, ResetPassword - 查询:
GET /api/permission/Users/{id}/GetPosition, SelectorByUserPosId, getAllPermission, Authorize - 个人:
PUT /api/permission/Users/Current/BaseInfo, Actions/ModifyPassword - 社交:
GET/DELETE /api/permission/socials - 系统:
DELETE /api/system/OnlineUser/{token}
相关业务模块
- 组织管理 (
org命令): 用户必须绑组织 (organizeId) - 角色管理 (
role命令): 用户通过角色获权限 - 岗位管理 (
position命令): 用户可以多岗位 - 权限管理: 角色 → 菜单权限 → 用户权限链路
3. 改/删/留 建议
[KEEP] 保留 (16/18)
核心 CRUD 全部保留
list— KEEP ✓- 理由: 基础列表查询, AI 痛点 1
- 改进: 增强 --keyword 支持 (现仅模糊搜索账号/姓名/手机)
create— KEEP ✓- 理由: 新建用户基础操作, 决策 7 强制绑组织
- 改进: 增强 --organizeId 验证 (现仅文档说明)
update— KEEP ✓- 理由: 通用字段更新入口
- 改进: 增强 --fields JSON 验证
delete— KEEP ✓- 理由: 基础删除 (含 --yes 安全机制)
unlock— KEEP ✓- 理由: 锁定状态解除, 唯一 API
密码管理保留
changepwd— KEEP ✓- 理由: self 操作核心, 含 token 自动清理副作用
- 改进: 增加验证码支持 (与 web 一致)
resetpwd— KEEP ✓- 理由: admin 重置用户密码, 唯一 API
个人信息保留
baseinfo— KEEP ✓- 理由: self 修改个人资料, 通用 --fields 入口
批量操作保留
batch-delete— KEEP ✓- 理由: admin 批量操作基础
batch-state— KEEP ✓- 理由: admin 批量启/禁/锁
batch-set-position— KEEP ✓- 理由: admin 批量调岗
岗位管理保留
get-position— KEEP ✓- 理由: 查用户岗位, admin 操作
set-position— KEEP ✓- 理由: 改用户岗位, admin 操作
高级管理保留
workHandover— KEEP ✓- 理由: 离职交接, JNPF 特有功能
socials-unbind— KEEP ✓- 理由: 社交账号管理, 二段式防误操作
online-kick— KEEP ✓- 理由: 强制下线, 防自踢设计
权限查询保留
auth-list— KEEP ✓- 理由: 7 类权限详细查询
auth-groups— KEEP ✓- 理由: 权限分组树, auth-list 前置
[REFACTOR-WEBAPI] 切换 webapi (16/18) — 重点
现状: 16 个命令直接用 c.get/c.postJson/c.putJson/c.del (除 list 有 webapi 镜像外, 其他全部无 webapi)
建议: 创建 /home/ubuntu/ccWorkDir/dacli/src/webapi/user.ts 镜像 web/apps/jnpf-web-apps-main/src/api/permission/user.ts
涉及命令 (16):
1. create → webapi.createUser()
2. update → webapi.updateUser()
3. delete → webapi.delUser()
4. unlock → webapi.unlockUser()
5. changepwd → webapi.modifyPassword() [需补充]
6. resetpwd → webapi.resetUserPassword()
7. baseinfo → webapi.updateBaseInfo() [需补充]
8. batch-delete → webapi.batchDelete()
9. batch-state → webapi.batchUpdateState()
10. batch-set-position → webapi.setPositionBatch() [需补充]
11. get-position → webapi.getUserPosition()
12. set-position → webapi.setUserPosition()
13. workHandover → webapi.workHandover()
14. socials-unbind → webapi.deleteSocials() [需补充]
15. online-kick → webapi.kickOnline() [需补充]
16. auth-list → webapi.getAuthorize()
17. auth-groups → webapi.getAllPermission()
理由:
- 与 menu/dataModel/dict/visualDev/workflow 一致架构
- webapi 模块复用 web 端实现, 避免路径硬编码
- 自动跟随 web 端 API 变化
- 已在 _loader.ts 中实现动态加载
优先级: P0 (与 webapi 镜像策略一致)
[DEPRECATE] 废弃 (0/18)
无废弃命令。所有 18 命令都对应 web 端有效功能。
[NEW-CMD] 新增命令 (6+ 个)
1. user info <id> — 查单个用户详情 [优先级: P0]
- 理由: 区别于 list 表格, 查完整用户信息 (含邮箱/手机/组织/角色/岗位)
- API:
GET /api/permission/Users/{id}(web 端getUserInfo) - 痛点: AI 经常需要单个用户详情而非列表
- 返回: JSON 含完整字段, AI 易解析
2. user selector — 用户下拉框列表 [优先级: P0]
- 理由: 解决"下拉选择用户"高频需求, 与 form selector 对应
- API:
GET /api/permission/Users/Selector(web 端getUserSelector) - 痛点: form/list 关联用户时需查 user 列表
- 特性: 支持 keyword 模糊, 返回 id+name 简化结构
3. user roles <userId> — 反向查用户角色 [优先级: P1]
- 理由: 镜像
role assign链路 (user→role 反向) - API:
GET /api/permission/Users/{id}/Role(需 web 端确认) - 痛点: 查用户有哪些角色, 权限三角评估基础
- 替代方案: 配合
role list --userId=<uid>
4. user import <file> — 批量导入用户 [优先级: P1]
- 理由: web 端支持 Excel 导入 (
importData) - 痛点: 创建测试用户 (10+) 效率极低
- API:
POST /api/permission/Users/ImportData - 实现: 支持 --file <csv/xlsx> + --preview 预览
5. user login-log — 查用户登录日志 [优先级: P2]
- 理由: 审计需求, web 端有登录日志页
- 痛点: 排查登录问题时无 CLI 入口
- API:
GET /api/system/Log/login?account=<account>(需确认)
6. user authorize — 直接赋权限 (不走角色) [优先级: P3]
- 理由: 高级权限分配, web 端
Authorize.vue支持 - 痛点: 某些场景需直接给用户赋权限, 不创建角色
- API:
POST /api/permission/Users/Authorize(需 web 端确认) - 风险: 不推荐过度使用, 提示 "优先用 role + assign"
4. AI 痛点评估
闭环度评估
- 闭环度: 9/10 (优秀)
- 原因:
- 18 命令覆盖 95%+ 实际场景
- CRUD + 批量 + 高级 + 权限 + self 五维度齐全
- 决策 7 强制绑组织 (组织不存在会报错)
- 防自踢/防误操作机制完整
与三角命令联动 (user → role → org)
user → role (镜像)
- 现状: 缺
user roles <uid>(反向查) - 现有链路:
role assign --userId=<uid> --roleId=<rid>(单方向) - 建议: 增加反向查询, 提升决策质量
user → org (强制绑)
- 现状: 完美, create 时 --organizeId 必填
- 支持链:
org list → user list --keyword=<orgName>交叉查
user → position (多岗位)
- 现状: get-position + set-position 完整
- 批量: batch-set-position 支持
缺基础命令痛点 (关键)
痛点 1: 无 info <id>
- 场景: 已知 uid, 需查邮箱/手机/部门名
- 现状: 必须 list + grep, 慢且不准
- 建议: 新增 P0
痛点 2: 无 selector
- 场景: form/list 需用户下拉框
- 现状: list + 提取 ID+name, 冗余
- 建议: 新增 P0
痛点 3: 无 import
- 场景: 创建 10+ 测试用户
- 现状: 需循环 create 10 次, 慢
- 建议: 新增 P1 (CSV 导入)
痛点 4: 16/18 缺 webapi 镜像
- 影响: 维护成本高, API 路径硬编码
- 建议: P0 重构
痛点优先级排序
| 优先级 | 痛点 | 影响 | 解决方案 |
|---|---|---|---|
| P0 | 缺 info / selector |
高频查询, 现有命令不便 | 新增命令 |
| P0 | 16/18 缺 webapi 镜像 | 维护成本 | 镜像 webapi |
| P1 | 缺 import |
批量操作不便 | 新增命令 |
| P1 | 缺 roles 反向查 |
权限决策不便 | 新增命令 |
| P2 | 缺 login-log |
审计排查不便 | 新增命令 |
| P3 | 缺 authorize |
高级权限 | 暂不实现 |
5. 总结
现状评价: user 是 24 父命令中子命令最多 (18) 且闭环度最高 (9/10) 的命令组。设计完善, 防误操作机制到位。
最大缺陷:
- 16/18 缺 webapi 镜像 — 与 v0.11+ 架构不一致, 维护成本高
- 缺
info/selector基础命令 — AI 高频痛点 - 缺
import批量入口 — 性能瓶颈
建议执行顺序:
- P0: 创建
webapi/user.ts镜像, 迁移 16 命令 - P0: 新增
user info <id>和user selector - P1: 新增
user roles <uid>(反向查) - P1: 新增
user import <file>(CSV) - P2+: 根据反馈再决定 login-log / authorize
预期收益:
- webapi 化: 维护成本 -50%, API 跟随 web 自动更新
- info/selector: AI 查询效率 +200%
- import: 批量场景效率 +1000%