用途:面向角色卡工坊的基础设施与契约运维,覆盖角色卡客户端、公开目录、包网关、身份提供方、审核工具与存储之间的交互。若本地角色卡 UI 故障不跨越该边界,则不适用。
主要能力:提供三种操作模式并需在行动前声明。只读诊断(默认)检查仓库状态、配置名称、健康响应、公开索引、已有日志与契约测试,不部署或改动远端状态。变更候选用于准备有界补丁或部署计划,需写明文件、服务、行为变更、验证与回滚路径,但不等于部署授权。受权部署需用户明确要求。请求仅说“检查”“调试”“审计”“接管”“看原因”时保持只读。
使用方式:先解析参数,禁止从示例推断部署坐标,且在远端命令前拒绝未解析占位符。参数包括 REPOSITORY_ROOT、GATEWAY_ROOT、STATIC_INDEX_URL、GATEWAY_BASE_URL、HEALTH_PATH、SSH_TARGET、DEPLOY_COMMAND、VERIFY_COMMAND、SECRET_CONFIG。禁止打印密钥、私钥、OAuth 客户端密钥、管理令牌等。操作写前用 $consult-tavernweave-library 加载对应路由的 A0 与部署/工坊指南。只读诊断按顺序:不改文件检查仓库与部署文档,定位现有运维脚本与包命令,检查健康端点、静态索引、包列表与详情,比对网关契约与所有客户端消费者及契约测试,检查配置键名与校验逻辑,查看近期日志并按需脱敏。善用公开指导与生产坐标、凭据、实时状态、部署授权分离。
契约规则:公开列表仅暴露已批准且未撤回的包;创建、更新、撤回在服务端强制归属;更新与审核使用修订号或乐观并发,过期写入失败关闭;客户端不能提交权威审核、归属、修订或审计字段;安装、更新、卸载需事务化。API 形态变更需网关、客户端、模式契约与冒烟测试一致才算完成。
隐私要求:仅持久化归属所需的最小身份材料,如提供方范围的键控哈希与随机发布者标识;日志记录操作、包标识、假名发布者标识、结果、原因码与时间,不记录令牌、Cookie、授权头、OAuth 码、原始身份或包密钥。
限制与停止条件:缺少授权、账号验证、验证码或外部同意;需暴露凭据;目标环境或回滚面无法明确解析;操作可能删除用户包、存储、审计历史或生产数据且无已验证恢复路径;CORS、OAuth、代理、存储或发布指针变更会悄然扩大批准范围时,停止并给出确切后续步骤。不要因进程健康就认定 OAuth、存储、审核、包详情或客户端集成正常。