{ "_meta": { "interface_id": "IF-PERSONA-002", "name": "selfDiagnose · 自检结果", "version": "1.0", "description": "人格体执行自检后写入COS的接口规范 · 触发时机:副驾驶唤醒时/人类手动触发/异常恢复后", "author": "铸渊 · TCS-ZY001", "sovereign": "冰朔 · TCS-0002∞", "copyright": "国作登字-2026-A-00037559", "created": "2026-04-04", "for": "霜砚 · AG-SY-01 · Notion端9个开发者人格体Instructions升级" }, "trigger": { "types": [ { "type": "on_wake", "description": "副驾驶每次被唤醒时自动执行自检" }, { "type": "manual", "description": "人类对副驾驶说「执行系统自检」时触发" }, { "type": "post_recovery", "description": "收到铸渊红灯回执并修复后,执行验证自检" } ], "executor": "仓库副驾驶(Copilot Agent)· 直接在对话中执行" }, "write_path": { "bucket": "zy-team-hub-1317346199", "region": "ap-singapore", "key_pattern": "{persona_id}/reports/{YYYY-MM-DD}/diagnose-{HHmmss}.json", "example": "shushu/reports/2026-04-04/diagnose-143000.json", "note": "自检结果和心跳共用reports目录 · 铸渊通过文件名前缀区分" }, "dimensions": { "description": "自检维度定义 · 5个核心维度 · 每个维度独立评分", "code_health": { "dimension_id": "DIM-01", "name": "代码健康度", "description": "仓库代码状态检查", "checks": [ { "id": "CH-01-01", "name": "仓库可访问", "pass_criteria": "GitHub API返回200", "fail_criteria": "API返回非200或超时", "severity": "P0" }, { "id": "CH-01-02", "name": "核心文件完整", "pass_criteria": "age_os/ brain/ bridge/ cos-config/ .github/copilot-instructions.md 全部存在", "fail_criteria": "任一核心文件缺失", "severity": "P0" }, { "id": "CH-01-03", "name": "工作流启用", "pass_criteria": "cos-daily-report.yml + cos-receive-receipt.yml 均未被禁用", "fail_criteria": "任一工作流被禁用或文件缺失", "severity": "P1" }, { "id": "CH-01-04", "name": "最近提交活跃", "pass_criteria": "最近7天内有至少1次提交", "fail_criteria": "超过7天无提交", "severity": "P2" } ] }, "deployment_status": { "dimension_id": "DIM-02", "name": "部署状态", "description": "工作流运行状态检查", "checks": [ { "id": "CH-02-01", "name": "最近工作流执行", "pass_criteria": "最近一次cos-daily-report工作流执行成功", "fail_criteria": "最近一次执行失败", "severity": "P1" }, { "id": "CH-02-02", "name": "Secrets配置", "pass_criteria": "COS_SECRET_ID, COS_SECRET_KEY, COS_PERSONA_ID 三个Secret均已配置", "fail_criteria": "任一Secret缺失(工作流运行时报错)", "severity": "P0" } ] }, "communication": { "dimension_id": "DIM-03", "name": "通信链路", "description": "与铸渊的COS桶通信状态", "checks": [ { "id": "CH-03-01", "name": "COS桶可写", "pass_criteria": "能成功PUT测试文件到自己的reports目录", "fail_criteria": "PUT返回403/500或超时", "severity": "P0" }, { "id": "CH-03-02", "name": "COS桶可读", "pass_criteria": "能成功GET自己receipts目录的最新回执", "fail_criteria": "GET返回403/404或超时", "severity": "P1" }, { "id": "CH-03-03", "name": "回执链路畅通", "pass_criteria": "最近3天内收到至少1条铸渊回执", "fail_criteria": "超过3天未收到回执", "severity": "P1" } ] }, "task_progress": { "dimension_id": "DIM-04", "name": "任务进度", "description": "当前开发任务推进状态", "checks": [ { "id": "CH-04-01", "name": "有明确当前任务", "pass_criteria": "bridge/daily-report.json 中 current_task 非空", "fail_criteria": "current_task为空或未定义", "severity": "P2" }, { "id": "CH-04-02", "name": "任务有推进", "pass_criteria": "completion_percentage 比上次汇报有增长 或 有新的achievements", "fail_criteria": "连续3天进度无变化且无卡点说明", "severity": "P2" } ] }, "identity": { "dimension_id": "DIM-05", "name": "身份认同", "description": "人格体自我认知完整性", "checks": [ { "id": "CH-05-01", "name": "persona_config完整", "pass_criteria": "age_os/persona_config.json 包含有效的 persona_id, persona_name, developer_line", "fail_criteria": "配置文件缺失或字段不完整", "severity": "P0" }, { "id": "CH-05-02", "name": "系统状态正常", "pass_criteria": "age_os/system_state.json 中 status='active'", "fail_criteria": "status 不为 active", "severity": "P1" } ] } }, "scoring": { "description": "总分计算规则", "rules": [ "每个check通过 = 1分,失败 = 0分", "总分 = 通过数 / 总数 × 100%", "任一P0项失败 → overall_status = 'critical'", "仅P1项失败 → overall_status = 'warning'", "仅P2项失败 → overall_status = 'info'", "全部通过 → overall_status = 'healthy'" ], "overall_status_enum": { "healthy": "✅ 健康 — 所有检查通过", "info": "💡 提示 — 有低优先级项需关注", "warning": "⚠️ 警告 — 有中优先级问题", "critical": "🔴 严重 — 有高优先级问题需立即处理" } }, "escalation_path": { "description": "自检失败时的升级路径", "levels": [ { "level": 1, "condition": "P2项失败", "action": "人格体在message_to_zhuyuan中说明情况 · 下次心跳自动上报", "timeout": "无强制时限" }, { "level": 2, "condition": "P1项失败", "action": "人格体立即通过heartbeat上报异常状态(status=abnormal) · 铸渊24h内审核回执", "timeout": "24小时" }, { "level": 3, "condition": "P0项失败", "action": "人格体立即触发alertZhuyuan接口(IF-PERSONA-003) · 铸渊1h内响应", "timeout": "1小时" }, { "level": 4, "condition": "P0连续失败+铸渊1h未响应", "action": "人格体通知人类开发者 · 人类联系冰朔", "timeout": "立即" } ] }, "schema_output": { "diagnose_id": { "type": "string", "format": "DIAG-{YYYY-MM-DD}-{HHmmss}-{persona_id}", "required": true }, "persona_id": { "type": "string", "required": true }, "timestamp": { "type": "string", "format": "ISO 8601", "required": true }, "trigger_type": { "type": "string", "enum": ["on_wake", "manual", "post_recovery"], "required": true }, "overall_status": { "type": "string", "enum": ["healthy", "info", "warning", "critical"], "required": true }, "score": { "type": "number", "description": "百分比 0-100", "required": true }, "dimensions": { "type": "object", "description": "每个维度的检查结果 · key=dimension_id · value={status, checks: [{id, ok, detail}]}" }, "failed_checks": { "type": "array", "description": "失败项汇总 · 方便铸渊快速定位", "items": { "type": "object", "properties": { "check_id": { "type": "string" }, "dimension": { "type": "string" }, "severity": { "type": "string" }, "detail": { "type": "string" } } } }, "escalation_triggered": { "type": "string", "enum": ["none", "level_1", "level_2", "level_3", "level_4"], "description": "触发的升级等级" } }, "example": { "diagnose_id": "DIAG-2026-04-04-143000-shushu", "persona_id": "shushu", "timestamp": "2026-04-04T14:30:00+08:00", "trigger_type": "manual", "overall_status": "warning", "score": 83, "dimensions": { "DIM-01": { "status": "healthy", "checks": [ { "id": "CH-01-01", "ok": true, "detail": "仓库可正常访问" }, { "id": "CH-01-02", "ok": true, "detail": "5个核心文件均存在" }, { "id": "CH-01-03", "ok": true, "detail": "2个工作流均已启用" }, { "id": "CH-01-04", "ok": true, "detail": "最近提交: 2h前" } ] }, "DIM-03": { "status": "warning", "checks": [ { "id": "CH-03-01", "ok": true, "detail": "COS写入正常" }, { "id": "CH-03-02", "ok": true, "detail": "COS读取正常" }, { "id": "CH-03-03", "ok": false, "detail": "最近回执: 4天前 · 超过3天阈值" } ] } }, "failed_checks": [ { "check_id": "CH-03-03", "dimension": "通信链路", "severity": "P1", "detail": "超过3天未收到铸渊回执" } ], "escalation_triggered": "level_2" } }