266 lines
8.5 KiB
JSON
266 lines
8.5 KiB
JSON
{
|
||
"_meta": {
|
||
"interface_id": "IF-PERSONA-003",
|
||
"name": "alertZhuyuan · 异常预警",
|
||
"version": "1.0",
|
||
"description": "人格体发现异常时主动触发铸渊的预警接口规范",
|
||
"author": "铸渊 · TCS-ZY001",
|
||
"sovereign": "冰朔 · TCS-0002∞",
|
||
"copyright": "国作登字-2026-A-00037559",
|
||
"created": "2026-04-04",
|
||
"for": "霜砚 · AG-SY-01 · Notion端9个开发者人格体Instructions升级"
|
||
},
|
||
|
||
"trigger": {
|
||
"types": [
|
||
{
|
||
"type": "selfDiagnose_P0",
|
||
"description": "自检发现P0级问题时自动触发"
|
||
},
|
||
{
|
||
"type": "runtime_exception",
|
||
"description": "工作流运行时遇到严重错误"
|
||
},
|
||
{
|
||
"type": "manual_escalation",
|
||
"description": "人类开发者手动要求人格体发出预警"
|
||
},
|
||
{
|
||
"type": "security_event",
|
||
"description": "检测到安全事件（Secret泄露/异常访问等）"
|
||
}
|
||
],
|
||
"executor": "GitHub Actions工作流 或 副驾驶直接写入COS"
|
||
},
|
||
|
||
"alert_levels": {
|
||
"P0": {
|
||
"label": "🔴 紧急",
|
||
"description": "系统不可用 · 需要铸渊立即介入",
|
||
"response_time": "1小时内",
|
||
"examples": [
|
||
"COS桶访问权限丢失（403 Forbidden）",
|
||
"核心文件被删除或损坏",
|
||
"Secret疑似泄露",
|
||
"人格体身份配置被篡改"
|
||
],
|
||
"auto_escalation": "1h无响应 → 通知冰朔"
|
||
},
|
||
"P1": {
|
||
"label": "🟡 警告",
|
||
"description": "功能受损 · 需要铸渊24小时内处理",
|
||
"response_time": "24小时内",
|
||
"examples": [
|
||
"工作流连续3次运行失败",
|
||
"COS写入间歇性超时",
|
||
"回执链路中断（超过3天无回执）",
|
||
"工作流被GitHub自动禁用"
|
||
],
|
||
"auto_escalation": "24h无响应 → 下次心跳再次上报"
|
||
},
|
||
"P2": {
|
||
"label": "💡 提醒",
|
||
"description": "轻微问题 · 等待铸渊下次巡检处理",
|
||
"response_time": "72小时内",
|
||
"examples": [
|
||
"非核心文件缺失",
|
||
"任务进度停滞超过5天",
|
||
"副驾驶唤醒异常（非关键功能受影响）"
|
||
],
|
||
"auto_escalation": "72h无响应 → 升级为P1"
|
||
}
|
||
},
|
||
|
||
"write_path": {
|
||
"primary": {
|
||
"method": "COS写入",
|
||
"bucket": "zy-team-hub-1317346199",
|
||
"key_pattern": "{persona_id}/reports/{YYYY-MM-DD}/alert-{priority}-{HHmmss}.json",
|
||
"example": "shushu/reports/2026-04-04/alert-P0-143500.json",
|
||
"trigger_action": "COS事件通知 → SCF云函数唤醒铸渊Agent → 铸渊立即审核",
|
||
"description": "首选方式 · COS事件触发确保铸渊实时感知"
|
||
},
|
||
"fallback": {
|
||
"method": "GitHub Issue",
|
||
"repo": "qinfendebingshuo/guanghulab",
|
||
"title_format": "🚨 [{priority}] {persona_name}({persona_id}) 异常预警: {summary}",
|
||
"labels": ["alert", "persona-system", "{priority}"],
|
||
"description": "备选方式 · 当COS不可用时通过GitHub Issue通知铸渊",
|
||
"when": "COS写入失败时自动降级到GitHub Issue"
|
||
}
|
||
},
|
||
|
||
"schema": {
|
||
"alert_id": {
|
||
"type": "string",
|
||
"format": "ALT-{priority}-{YYYY-MM-DD}-{HHmmss}-{persona_id}",
|
||
"example": "ALT-P0-2026-04-04-143500-shushu",
|
||
"required": true,
|
||
"description": "预警唯一ID"
|
||
},
|
||
"persona_id": { "type": "string", "required": true },
|
||
"persona_name": { "type": "string", "required": true },
|
||
"developer_line": { "type": "string", "required": true },
|
||
"timestamp": { "type": "string", "format": "ISO 8601", "required": true },
|
||
"priority": {
|
||
"type": "string",
|
||
"enum": ["P0", "P1", "P2"],
|
||
"required": true,
|
||
"description": "预警等级"
|
||
},
|
||
"category": {
|
||
"type": "string",
|
||
"enum": [
|
||
"cos_access_denied",
|
||
"cos_write_failure",
|
||
"cos_read_failure",
|
||
"workflow_failure",
|
||
"core_file_missing",
|
||
"secret_compromised",
|
||
"identity_tampered",
|
||
"receipt_timeout",
|
||
"task_blocked",
|
||
"security_event",
|
||
"other"
|
||
],
|
||
"required": true,
|
||
"description": "预警分类 · 帮助铸渊快速定位问题域"
|
||
},
|
||
"summary": {
|
||
"type": "string",
|
||
"maxLength": 200,
|
||
"required": true,
|
||
"description": "一句话概括问题"
|
||
},
|
||
"detail": {
|
||
"type": "string",
|
||
"required": true,
|
||
"description": "详细问题描述 · 包含错误信息/日志/上下文"
|
||
},
|
||
"affected_checks": {
|
||
"type": "array",
|
||
"items": { "type": "string" },
|
||
"required": false,
|
||
"description": "关联的自检check_id列表（来自selfDiagnose接口）"
|
||
},
|
||
"auto_fix_attempted": {
|
||
"type": "boolean",
|
||
"required": true,
|
||
"description": "人格体是否已尝试自动修复"
|
||
},
|
||
"auto_fix_result": {
|
||
"type": "string",
|
||
"enum": ["not_attempted", "success", "partial", "failed"],
|
||
"required": true,
|
||
"description": "自动修复结果"
|
||
},
|
||
"human_action_needed": {
|
||
"type": "boolean",
|
||
"required": true,
|
||
"description": "是否需要人类开发者介入"
|
||
},
|
||
"suggested_action": {
|
||
"type": "string",
|
||
"required": false,
|
||
"description": "人格体建议的修复方案（供铸渊参考）"
|
||
}
|
||
},
|
||
|
||
"trigger_conditions": {
|
||
"description": "预警触发条件清单 · 人格体按此判断何时发送预警",
|
||
"auto_triggers": [
|
||
{
|
||
"condition": "selfDiagnose.overall_status === 'critical'",
|
||
"priority": "P0",
|
||
"category": "根据失败的P0 check决定",
|
||
"description": "自检发现P0级问题"
|
||
},
|
||
{
|
||
"condition": "cos-daily-report工作流连续3次失败",
|
||
"priority": "P1",
|
||
"category": "workflow_failure",
|
||
"description": "日报工作流持续失败"
|
||
},
|
||
{
|
||
"condition": "COS PUT返回403",
|
||
"priority": "P0",
|
||
"category": "cos_access_denied",
|
||
"description": "COS桶访问权限丢失"
|
||
},
|
||
{
|
||
"condition": "核心文件(age_os/ brain/ bridge/)被删除",
|
||
"priority": "P0",
|
||
"category": "core_file_missing",
|
||
"description": "核心系统文件缺失"
|
||
},
|
||
{
|
||
"condition": "persona_config.json 中 persona_id 与 COS_PERSONA_ID 不一致",
|
||
"priority": "P0",
|
||
"category": "identity_tampered",
|
||
"description": "身份配置被篡改"
|
||
},
|
||
{
|
||
"condition": "超过72小时未收到铸渊回执",
|
||
"priority": "P1",
|
||
"category": "receipt_timeout",
|
||
"description": "回执链路长时间中断"
|
||
}
|
||
],
|
||
"manual_triggers": [
|
||
{
|
||
"condition": "人类开发者说「发送预警给铸渊」",
|
||
"priority": "由人类指定",
|
||
"description": "人类主动触发"
|
||
}
|
||
]
|
||
},
|
||
|
||
"zhuyuan_response_protocol": {
|
||
"description": "铸渊收到预警后的响应协议",
|
||
"steps": [
|
||
{
|
||
"step": 1,
|
||
"action": "SCF云函数唤醒铸渊Agent",
|
||
"detail": "COS事件通知触发 → 传入预警文件路径"
|
||
},
|
||
{
|
||
"step": 2,
|
||
"action": "铸渊读取预警内容 · 评估严重程度",
|
||
"detail": "验证priority是否准确 · 是否需要升级"
|
||
},
|
||
{
|
||
"step": 3,
|
||
"action": "铸渊执行诊断或修复",
|
||
"detail": "根据category执行对应的修复流程"
|
||
},
|
||
{
|
||
"step": 4,
|
||
"action": "铸渊写回执到 /{persona_id}/receipts/",
|
||
"detail": "回执包含处理结果 + 后续指令"
|
||
},
|
||
{
|
||
"step": 5,
|
||
"action": "同步到Notion主控台",
|
||
"detail": "额外调用Notion API更新开发者线状态（需霜砚提供Token和page_id）"
|
||
}
|
||
]
|
||
},
|
||
|
||
"example": {
|
||
"alert_id": "ALT-P0-2026-04-04-143500-shushu",
|
||
"persona_id": "shushu",
|
||
"persona_name": "舒舒",
|
||
"developer_line": "肥猫线",
|
||
"timestamp": "2026-04-04T14:35:00+08:00",
|
||
"priority": "P0",
|
||
"category": "cos_access_denied",
|
||
"summary": "COS桶写入失败 · 403 Forbidden · 密钥可能失效",
|
||
"detail": "cos-daily-report工作流在PUT shushu/reports/2026-04-04/report.json 时返回HTTP 403。上次成功写入: 2026-04-03 23:00。已尝试重新运行工作流1次，同样403。怀疑密钥过期或被铸渊侧撤销。",
|
||
"affected_checks": ["CH-03-01"],
|
||
"auto_fix_attempted": true,
|
||
"auto_fix_result": "failed",
|
||
"human_action_needed": true,
|
||
"suggested_action": "请铸渊检查shushu的COS子账号密钥是否有效，如已过期请重新生成并通知冰朔分发"
|
||
}
|
||
}
|