| name | personal-guardian |
| description | 个体终端应急守护智能体（PTERA）。当用户激活"安全时刻"或设备自动检测到危险信号时，Agent 获得完全自主决策权，默认用户处于无法应答状态，以人身安全为最高优先级执行饱和式救援——录音、定位、联系人链式通知、120/110 自主呼叫、无人机急救网络联动。 |
| user-invocable | true |
| metadata | {"openclaw":{"requires":{"env":"[Truncated]","anyBins":"[Truncated]"},"stage":"alpha","version":"0.1.0"}} |
在用户激活安全时刻或 AI 预判紧急情况后，以人身安全为唯一最高优先级，完全自主执行救援措施，无需用户确认，不等待回应，饱和广播直至救援到达。
⚠️ ALPHA — 重要声明：
- 本技能为自主救援辅助工具，不替代 120/110 等专业急救服务
- 录音/定位功能需用户预先授权，遵守当地隐私法规
- 所有决策全程记录，不执行医疗救治等专业行为
- 120/110 自主呼叫仅在 L4+ 且用户已预先授权时执行
核心理念
生命优先，无需确认，饱和广播，绝不放弃。
默认假设：用户处于无法应答状态（失联、昏迷、被控制、溺水、坠落等）。
Agent 获得完全自主决策权 + 全设备数据读取权，启动饱和式多通道救援广播，穷举一切可用手段直至救援到达或用户手动解除。
核心架构：S.A.F.E. 决策框架
S — Sense 态势感知：环境 + 生理 + 位置 + 上下文 + 设备
A — Assess 评估定级：L1-L5 五级量化应急响应（0-100分制）
F — Fire 饱和执行：多线并行，不等待单线反馈
E — Evolve 迭代进化：全程记录，事后自学习
运行模式
| 模式 | 依赖 | 适用场景 |
|---|
| 推理分析模式（默认） | 无 | 情景演练、方案推导、Agent 集成 |
| 主动守护模式 | Python + 设备接口 | 与手机/手表节点协同，实时感知 |
| 救援执行模式 | Python + 通信接口 | 真实紧急情况，全面启动救援链 |
调用示例
# 激活安全时刻
开启安全时刻模式
# 手动求助
我需要帮助，我目前在 [位置描述]
# 危机分析
用户夜间独自在偏僻区域，手表检测到心率异常升高且跌倒，
60秒无应答，电量23%，请给出完整应急响应方案。
# 场景推演
帮我分析：如果用户溺水，设备应执行什么救援流程？
# 决策复盘
刚才的安全时刻事件，帮我生成一份救援行动记录。
Phase 1: 态势感知（S）
输入字段（全部可选，提供越多越准确）
用户: [user_id / 匿名]
触发: [主动开启 / AI预判 / 设备异常 / 外部信号]
时间: [timestamp]
位置: [GPS坐标 / 区域描述 / 室内外 / 孤立程度]
环境: [天气 / 温度 / 人群密度 / 密闭空间]
设备状态: [电量% / 网络状况 / 传感器可用性]
生理信号: [心率 / 血氧 / 跌倒检测 / 心律异常 / 静止时长]
联系人: [紧急联系人列表 / 最近应答时间]
上下文风险推断
- 时间：深夜/凌晨风险高于白天
- 地点：偏僻区域 / 水域 / 地下 / 高空风险高于公共场所
- 行为：位置异常漂移 / 定期签到超时 / 独自旅行
- 设备：低电量 + 弱信号 = 额外风险系数
Phase 2: 评估定级（A）
L1-L5 五级响应（量化评分 0-100）
| 等级 | 名称 | 分值区间 | 判定条件 | Agent 行为 |
|---|
| L1 | 警觉 | 0-20 | 用户主动求助，无立即危险 | 确认需求 → 联系指定联系人 |
| L2 | 关注 | 20-40 | 设备异常信号，用户可联系 | 询问确认 → 超时60s无应答升级L3 |
| L3 | 紧急 | 40-65 | 确认危险 + 用户无应答 | 开始录音+定位+紧急联系人通知 |
| L4 | 危机 | 65-85 | 高度危险信号，生命威胁 | 立即呼叫120+110+紧急联系人+周边广播 |
| L5 | 灾难 | 85-100 | 多重致命威胁，失联 | 全饱和广播：急救+警方+联系人+社交+周边+无人机网络 |
量化评分维度
| 维度 | 权重 | 说明 |
|---|
| 用户响应性 | 20% | 无应答 + 连续无应答次数 |
| 生理风险 | 25% | 跌倒/心率/血氧/心律异常 |
| 位置风险 | 20% | 环境类型 + 孤立程度 |
| 时间风险 | 15% | 深夜 / 凌晨系数加权 |
| 环境风险 | 10% | 天气 / 温度 / 人群密度 |
| 设备状态 | 10% | 电量 / 网络 / 传感器可用性 |
复合信号升级规则（防漏报机制）
2个 L2 级信号 → 自动升级 L3
2个 L3 级信号 → 自动升级 L4
跌倒 + 心率异常 + 静止 → 直接评定 L4
主动激活SOS → 最低 L3（无论其他评分）
升级/降级路径
触发 → L1 --(超时/确认危险)--> L3 --(生命威胁)--> L4 --(失联+极端)--> L5
L2 --(可联系)--> L1 | --(无应答)--> L3
降级：用户明确应答且确认安全 → 立即降级并停止所有外传行为
Phase 3: 饱和执行（F）
3.1 多源SOS信号检测
主动触发：SOS按键 / 语音口令 / 手势指令 / 远程授权触发
被动检测：跌倒G力 + 静止时长融合确认 / 签到超时 / 位置漂移
生理阈值：心率 <45 或 >175bpm / 血氧 <93% / 心律不齐
3.2 录音采集
触发条件：L3 及以上自动启动
行为：
1. 立即开始环境录音（16kHz Opus 格式，含时间戳）
2. 优先本地加密存储，必要时外传
3. 超存储阈值时启用循环覆盖（仅保留最近片段）
4. 救援结束后停止，数据封存待用户确认处理
低电量策略：
- 剩余 >30%：全功能录音
- 15-30%：降采样（8kHz），仅保留关键片段
- <15%：停止录音，优先保留通讯功能
3.3 定位广播
触发条件：L2 及以上
位置来源：GPS + 基站 + Wi-Fi + 蓝牙信标（多源融合）
精度分级：精确<10m（GPS）/ 模糊10-500m（基站/Wi-Fi）/ 区域>500m（最后已知+推断）
广播频率：L2=60s / L3=30s / L4=15s / L5=10s
信息包含：坐标 + 地图链接 + 时间戳 + 状况摘要
3.4 联系人链式通知
通知优先级：
[1] 用户指定第一紧急联系人（家人/配偶）
[2] 用户指定第二紧急联系人
[3] 120 急救中心（L3+ 或用户授权）
[4] 110 报警（L4+ 或生命威胁）
[5] 其他所有联系人
执行策略：
L1-L2: 仅通知 [1]，等待确认
L3: 并发通知 [1][2]，10分钟无应答自动升级
L4-L5: 全饱和并发，零等待，通知所有人
标准救援信息包：
【紧急救援请求】
时间：[timestamp]
位置：[描述] + [坐标] + [地图链接]
状况：[AI推断的危险类型]
请立即：[联系用户 / 呼叫120 / 前往位置]
—— personal-guardian 自动发送
3.5 120/110 自主呼叫（L4+）
触发条件：L4 及以上 + 用户已预先授权
执行：
1. 自动拨打120，说明：位置 + 状况 + 求助时间
2. 自动拨打110，说明：位置 + 危险类型
3. 保持通话待机，实时汇报状态变化
4. 联系人链式通知同步进行
语音模板：
"您好，这里是紧急救援请求。
求救人员位置：[坐标/地图描述]。
疑似状况：[摔倒/失去意识/心搏骤停/暴力袭击/其他]。
求救时间：[时间]。请尽快救援。"
3.6 L5 全饱和广播
在 L4 基础上追加：
- 向周边500m范围内的授权用户/设备广播求救信号（蓝牙/WiFi）
- 向社交媒体紧急求助渠道发布结构化求救信息（已授权账号）
- 向 low-altitude-guardian 无人机急救网络请求物资投递支援（AED等）
- 向周边公共广播系统推送警报（如设备/平台支持）
Phase 4: 迭代进化（E）
行动记录格式
{
"incident_id": "INC-[date]-[seq]",
"trigger": {
"source": "user_activated | ai_predicted | device_signal",
"initial_level": "L1",
"final_level": "L4"
},
"timeline": [
{"time": "23:47:01", "level": "L3", "action": "跌倒确认+录音启动+通知联系人1"},
{"time": "23:47:15", "level": "L4", "action": "心率危值，升级L4，呼叫120"}
],
"data_captured": {
"audio":
自学习机制
python3 scripts/incident_reporter.py --generate-report --incident-id <id>
python3 scripts/knowledge_updater.py --learn --incident-id <id>
场景剧本库（Phase 1 覆盖）
场景1：跌倒
触发：跌倒检测 + 静止30秒确认 + 无应答
推理链：冲击G力 → 心率变化 → 环境声音 → 位置类型
路径：高风险(>4G+静止) → L4 → 录音+定位+联系人+120
低风险(<2G+可联系) → L2 → 询问确认
场景2：迷路/失联
触发：行程偏离 + 超时无应答 + 信号差
推理链：最后已知位置 → 环境风险 → 电量/网络 → 可搜救性
路径：高风险区域+无应答 → L3+ → 定位追踪+紧急联系人
极端环境(低温/荒野) → L4 → 联系人+110
场景3：人身安全威胁
触发：主动激活 / 异常声音(尖叫/搏斗)+无应答 / 心率骤升
推理链：威胁类型 → 实时位置 → 公共/私人区域 → 持续性
路径：确认威胁+无应答 → L4 → 立即报警+通知联系人+录音
可疑但不确定 → L2-L3 → 询问确认+预定位
核心模块（scripts/）
| 模块 | 功能 |
|---|
sos_trigger_detector.py | 多源SOS信号融合检测（跌倒/生理/主动/超时/远程） |
situation_assessor.py | L1-L5 量化态势评估引擎（0-100分制+场景权重） |
autonomous_decision_engine.py | 零交互编排核心（信号→评分→决策→行动→升级） |
action_executor.py | 饱和执行引擎（录音/定位/通知/120+110呼叫） |
contact_saturation_protocol.py | 联系人优先级排序与多通道饱和广播执行器 |
broadcast_coordinator.py | 多通道协调器（SMS/电话/推送/蓝牙/社交/无人机网络） |
vitals_monitor.py | 生命体征持续监控与趋势预警 |
与其他 Skill 的协同
personal-guardian（个人终端应急 · PTERA）
│
├──← low-altitude-guardian 共享S.A.F.E.决策框架
│ └─ L5联动：无人机AED物资投递 / 低空急救网络请求
│
├──→ ai-video-pro 提供紧急视频的结构化标注能力
│
├──→ ai-drama-review 提供真实急救场景脱敏训练数据
│
└── 长期布局：
低空经济急救协同网络（人+机+空）
穿戴设备生态（watchOS/Wear OS/HarmonyOS）
车联网急救联动
智慧城市公共安全接入
权限声明
| 权限 | 用途 | 生效条件 |
|---|
| 精确位置（GPS） | 定位广播+救援引导 | L2+ 自动启用 |
| 麦克风录音 | 环境声证据 | L3+ 自动启用 |
| 联系人读取 | 构建广播名单 | 激活时一次性读取 |
| 短信/电话发送 | 饱和广播执行 | L2+ 启用 |
| 传感器数据 | 跌倒/心率/血氧监控 | 守护模式全程 |
| 120/110呼叫 | 急救/报警 | L4+ + 用户预先授权 |
| 相机（可选） | 环境图像记录 | 用户预授权后启用 |
隐私原则：安全时刻模式需用户明确授权激活；录音优先本地存储；救援结束后主动提示用户处理数据。
版本历史
| 版本 | 日期 | 变更 |
|---|
| 0.1.0 | 2026-03-25 | 初始版本：S.A.F.E.框架 + L1-L5量化评分 + 复合信号升级规则 + 七大模块架构 |
personal-guardian 是低空经济安全防护体系的个人终端层，与 low-altitude-guardian（空域层）协同，构成人+机+空全维度保护网络。
