SuperAPI AI 工具集

docyrus-account-settings

办公与效率

查看项目

更新于 10-15 21:11

技能介绍

用途:管理 Docyrus 中两类账户设置。用户资料(account user-profile)针对已登录用户本人,自助修改,无需管理员权限,且始终作用于当前用户,没有 id 选择器。租户偏好(account tenant-preferences)作用于整个工作区的区域与格式默认值,包括语言、日期、数字、货币、工作时间;任何人可读,更新需租户管理员权限。两者均只有读取和更新,没有创建或删除。

主要能力:用户资料可编辑字段为 --firstname、--lastname、--mobile、--dateOfBirth(YYYY-MM-DD)、--gender、--timeZone、--language;邮箱、头像、职位、角色、组织单位不在此处编辑。租户偏好可设置语言与区域(--language、--locale、--timeZone、--startWeekOn 0–6、--fiscalYear 1–12)、日期时间格式(PHP 风格,如 Y-m-d、H:i)、工作时间(--businessHoursBegin/End 为 HH:mm:ss,结束须晚于开始;--dailyWorkingHours 单位为秒,8 小时为 28800;--weeklyWorkingCapacity 单位为小时)、货币与数字(--baseCurrency、--currencyAbbrPosition 为 BEFORE 或 AFTER、--decimalPrecision 0–8、--decimalSeparator、--thousandSeparator 为单字符)。

使用方式:先确认认证与目标工作区,运行 docyrus auth who --json;无会话则让用户执行 docyrus auth login。读取当前值:docyrus account user-profile get --json、docyrus account tenant-preferences get --json。更新为部分更新,未发送字段保持原值,空更新会被拒绝。更新后重新读取确认。批量或脚本化可用 --data '<json>' 或 --from-file <file.json>(仅 JSON),其中使用 snake_case 键(如 time_zone、date_format、business_hours_begin、currency_abbr_position、decimal_precision),便捷标志与 --data 冲突时以标志为准。清空可空字段(longDateFormat、timeRounding)需通过 --data 传 null,空标志值会被忽略。

限制:偏好更新需租户管理员,非管理员会收到权限错误;用户资料只能改自己;字段完整列表见 references/fields.md。相关技能包括 docyrus-cli-app、docyrus-tenant-brand-management、docyrus-platform。