fm-system

FM Platform 系统管理

所有平台访问都必须通过 fm-cli 完成。不要直接调用后端 HTTP 接口，也不要读取本地 token 文件。

必须流程

1. 先检查本地连通性和登录状态：

fm-cli doctor --json --timeout 5s

2. 检查本地 Agent Skill 是否过期：

fm-cli agent-skills status --json

如果状态为 update_available，提示用户先执行：

fm-cli agent-skills update

3. 如果未登录或登录已过期，让用户完成 OAuth2 登录：

fm-cli auth login

4. 使用通用 Agent 调用前，先查看当前用户可用能力和参数结构：

fm-cli agent list --json --refresh
fm-cli agent schema /user/query --json

5. 有领域快捷命令时优先使用快捷命令：

fm-cli user list --page-size 20 --json
fm-cli user detail --user-name admin --json
fm-cli dept list --json
fm-cli role list --json
fm-cli menu list --json
fm-cli post list --json

规则

• 使用用户、部门、角色、菜单、岗位 ID 前，必须先查询确认。
• 领域快捷命令和 agent call 以返回结果中的 code == 200 作为业务成功判断。
• 自动化场景统一使用 --json。
• 写操作先执行 --dry-run --json，确认目标和影响后再真正执行。
• 同一次写操作重试时复用稳定的 --request-id。
• 如果没有对应快捷命令，以 fm-cli agent schema <api> --json 作为参数事实源，再调用 fm-cli agent call <api> --data '<json>' --json。