用途:本技能是墨问 CLI 技能库的前置技能,指导通过 mocli 完成配置初始化、API Key 配置与管理、响应解析与展示,以及安全规则。
主要能力与用法:首次使用需用户提供墨问 API Key,执行 mocli auth init --apik <api-key> 初始化;出现 AUTH 错误时可用 mocli auth init --apik <api-key> [--force] 重新初始化或更换 Key;用 mocli auth info [--profile] 查看配置,加 --profile 可获取账户 Profile。执行命令后先读顶层 code、status、reason,成功(code=0 且 status=OK)再解析 reply;列表结果优先用 reply 中的有序 ID 列表(如 note_ids、uids、events),再到对应 Map 取详情。需要 UID 而用户只给人名时,优先用 mo-remark 查找。
展示与错误处理:meta.alerts 为重要提示,需优先关注;失败时优先展示 reason、msg 和 meta.hints。reason=AUTH 提醒重新提供 Key,不输出旧 Key;VALIDATE 说明参数不合法并给修正建议;NETWORK 说明网络或代理失败;API 且有 api_error.trace_id 时展示 trace_id 便于反馈。空列表或空 Map 应明确说明未找到数据,不编造。展示时按用户要求与数据量选择表格或列表,时间戳格式化,Bool 用 emoji,UserInfo.name 与 NoteInfo.title 在支持链接且 home_url/url 非空时用链接包裹。
更新提醒:mocli 检测到新版本时通过 meta.alerts 返回,应显式展示当前版本、最新版本、构建时间和更新命令,不自动执行更新,除非用户明确要求;同一提醒重复出现时弱化为简短尾注。
限制与安全:禁止输出 user_key、api_key 明文;写入/删除操作前必须确认用户意图。具体子命令参数范围、输出协议字段等细节以官方资料为准,本资料未提供完整清单。