@yoooclaw/phone-notifications 1.10.0-beta.8 → 1.10.0

package/README.md

@@ -31,7 +31,7 @@ OpenClaw / QClaw 手机通知同步插件：接收手机通知并写入本地 JS
 - 通知写入 `YYYY-MM-DD.json` 的 JSON 数组（append-only）
 - 通知条目字段为 `appName`、`title`、`content`、`timestamp`（ISO 8601 含时区）
 - 同一天内按 `notification-id` 去重（使用内部索引文件）
-- `retentionDays`（默认 30）会清理过期日期文件
+- 未设置 `retentionDays` 时永久保存；显式设置后会按天数清理过期日期文件
 
 ## 前置要求
 
@@ -139,7 +139,7 @@ bash install.sh --tgz-url ./yoooclaw-phone-notifications-1.2.3.tgz
 | `--host-cli <cmd>` | 宿主 CLI 命令名 | `openclaw` |
 | `--api-key <apiKey>` | 灯控鉴权 API Key | - |
 | `--token <token>` | 兼容旧参数，等价于 `--api-key` | - |
-| `--retention-days <n>` | 通知数据保留天数 | 30 |
+| `--retention-days <n>` | 通知数据保留天数 | 不设置则永久保存 |
 
 #### 脚本做了什么
 
@@ -195,7 +195,7 @@ openclaw phone-notifications -v
 安装脚本会自动写入必要的插件注册配置。如需手动调整：
 
 ```bash
-# 可选：数据保留天数（默认 30）
+# 可选：数据保留天数（不设置则永久保存）
 openclaw config set plugins.entries.phone-notifications.config.retentionDays 30
 
 # 可选：忽略特定 app
@@ -203,7 +203,7 @@ openclaw config set plugins.entries.phone-notifications.config.ignoredApps '["co
 ```
 
 配置项说明：
-- `retentionDays?: number`（默认 30）
+- `retentionDays?: number`（未设置则永久保存；设置后按天数清理）
 - `ignoredApps?: string[]`
 
 ## 长录音 & ASR 配置
@@ -217,14 +217,14 @@ openclaw config set plugins.entries.phone-notifications.config.ignoredApps '["co
 | `asr.mode` | 说明 | 额外依赖 |
 |---|---|---|
 | `"local"` | 本地离线 Whisper（推荐，隐私安全） | `whisper-cli`（brew install whisper-cpp） |
-| `"api"` | 云端 API（DashScope / OpenAI Whisper） | API Key |
+| `"api"` | 云端 model-proxy 长录音转写 | 请求级 `asr.api.apiKey`，未传则回退插件本地 API Key |
 | 未传 `asr` | 关闭转写，仅下载保存音频 | — |
 
 ### 初始化接口
 
 客户端在正式转写前可先调用 `recordings.asr.init`：
 
-- `mode = "api"`：校验 `provider` / `apiKey` 是否齐全，不持久化保存
+- `mode = "api"`：校验请求级或插件本地 API Key 是否可用，并返回当前环境的长录音 submit-task 端点
 - `mode = "local"`：探测本地环境并预下载所需 Whisper 模型
 
 示例：
@@ -274,7 +274,7 @@ openclaw config set plugins.entries.phone-notifications.config.ignoredApps '["co
 }
 ```
 
-云端 API（OpenAI Whisper 兼容）：
+云端 API（model-proxy 长录音）：
 
 ```json
 {
@@ -293,9 +293,31 @@ openclaw config set plugins.entries.phone-notifications.config.ignoredApps '["co
     "asr": {
       "mode": "api",
       "api": {
-        "provider": "openai",
-        "apiKey": "sk-xxx",
-        "endpoint": "https://your-proxy/v1/audio/transcriptions"
+        "language": "zh",
+        "enableNormalization": true
+      }
+    }
+  }
+}
+```
+
+### 手动重新触发转写
+
+当录音状态为 `synced`、`transcribe_failed` 或 `transcribed` 时，客户端可通过 Gateway Native 主动调用 `recordings.retranscribe`。
+
+- 当前接口必须再次传入 `asr`
+- HTTP `POST /recordings` 仅支持同步录音，不支持重新转写
+- 接口会立即返回，实际转写进度应结合 `recording.status` 广播或 `recordings.status` 查询确认
+
+```json
+{
+  "method": "recordings.retranscribe",
+  "params": {
+    "recordingId": "2026-03-23_14-32",
+    "asr": {
+      "mode": "api",
+      "api": {
+        "language": "zh"
       }
     }
   }
@@ -426,10 +448,10 @@ openclaw ntf stats --dim hour --from 2026-03-01 --to 2026-03-09
 # 扫描未同步通知
 openclaw ntf sync scan
 
-# 获取指定日期未处理通知
+# 获取指定日期未处理通知（单次最多 300 条）
 openclaw ntf sync fetch --date 2026-03-09
 
-# 标记同步完成
+# 标记当前批次同步完成；若 fetch 返回 hasMore=true，继续重复 fetch/commit
 openclaw ntf sync commit --date 2026-03-09
 ```