用途:把某个仓库固定到 Moda 的默认上下文,使该仓库内每次运行都自动落到正确的工作区、品牌与画布,避免重复传参。
主要能力:仅支持三个键——org、brand、canvas。.moda/context.json 提交到仓库,作为团队共享默认;.moda/context.local.json 被 gitignore,仅个人生效且优先级更高。配置从工作目录向上查找,子目录继承仓库的固定值。优先级从高到低为:命令行显式 flag → 环境变量 MODA_ORG / MODA_API_BASE → context.local.json → context.json → 本安装配置 → 内置默认。
使用方式: moda context show 查看生效值及每项来源([source] 标记); moda context set brand [bk_…] 固定品牌套件; moda context set canvas [cvs_…] 固定仓库持续更新的画布; moda context set org [ORG_ID] --local 将个人组织固定值排除在提交之外; moda context clear [key] 省略 key 则清除全部三项。 固定 brand 前应先用 moda brand list 确认用户所指套件,不要在两个套件间猜测;canvas 仅在仓库确实只有一个持续维护的产物时固定,显式 ref 始终优先;org 不要自行固定或切换,需询问用户后按其所指设置。
限制与说明:这些文件不含密钥,凭据存放于操作系统钥匙串或环境变量。画布创作、读取、截图、导出与站点在所有计划上均消耗 0 积分,仅媒体生成与网络研究计费;直接媒体调用不返回单次积分,应以 moda account status 的余额为准,用量见 moda account usage。若固定 id 失效,会在使用该值的动词处报错而非 set 时,需重新运行 moda context show 后重新固定或清除。资料未提供具体价格、平台支持范围与更多细节。