@yoooclaw/cli 0.0.4 → 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yoooclaw
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -3,10 +3,9 @@
 yoooclaw 独立 CLI 工具 —— 自带后台守护进程（daemon），不依赖 openclaw 客户端在线。
 设计对齐飞书 [lark-cli](https://github.com/larksuite/cli)：Service-oriented 命令树、三层命令体系（Shortcuts / Service Commands / Raw API）、统一 `--format`、Agent-Native。
 
-需求详见 [docs/features/prd-yoooclaw-standalone-cli.md](../../docs/features/prd-yoooclaw-standalone-cli.md)。
+完整文档见 [packages/docs/src/cli](../docs/src/cli)。
 
-> **状态：脚手架阶段。** 命令树、全局 flags、统一输出 / 错误层、profile 解析、目录布局已贯通；
-> 各 service 的真实逻辑按后续 imp 文档逐个落地，当前 action 返回 `YOOOCLAW_NOT_IMPLEMENTED` 占位。
+> **状态：可用。** 配置、认证、daemon、通知、录音、图片、灯效规则、监控、Relay、日志、gateway 自检和 raw API 等 service 命令已落地；本地查询类可纯读磁盘，控制类通过本地 daemon 协作。
 
 ## 安装与命令
 
@@ -48,11 +47,32 @@ yc --help              # 等价短 alias
 成功与失败共用同一通道（stdout）与可预测结构；失败额外以非零退出码表达：
 
 ```json
-{ "ok": false, "error": { "code": "YOOOCLAW_NOT_IMPLEMENTED", "message": "...", "hint": "..." } }
+{ "ok": false, "error": { "code": "YOOOCLAW_DAEMON_NOT_RUNNING", "message": "...", "hint": "..." } }
 ```
 
 错误码统一前缀 `YOOOCLAW_*`（见 [src/errors.ts](src/errors.ts)）。
 
+## 录音与 Relay
+
+独立 daemon 会复用 `@yoooclaw/phone-notifications` 的录音存储、状态机和 ASR 调度，并通过 `RelayClient + RelayDispatcher` 接收手机端 `recordings.sync` / `POST /recordings`。
+
+```bash
+# api 模式：未写 --api-key 时回退 account 级 ock- key
+yoooclaw recording setup-asr --mode api --language auto --non-interactive
+
+# 查询和跟随录音状态事件
+yoooclaw recording list
+yoooclaw recording events --since 1h --limit 50
+yoooclaw recording events --id <recording-id> --watch
+```
+
+录音配置与事件分别落在当前 profile 的：
+
+```text
+~/.yoooclaw/profiles/<profile>/recordings/asr-config.json
+~/.yoooclaw/profiles/<profile>/recordings/state/events.jsonl
+```
+
 ## Agent Skill
 
 随包发布 [skills/](skills/) 下的 SKILL.md（流式查通知、从 stdin 建灯效规则、隧道排查），教 Agent 直接调 `yoooclaw` 命令。在 openclaw 插件里这些 Skill 由 `openclaw.plugin.json` 自动注册；独立 CLI 形态下需手动安装到 Agent 的 skills 发现目录：
@@ -94,4 +114,7 @@ node dist/bin.cjs --help
 | [src/output/format.ts](src/output/format.ts) | `--format` 统一序列化 + 错误 schema    |
 | [src/errors.ts](src/errors.ts)           | `YOOOCLAW_*` 错误码 + `YoooclawError`      |
 | [src/paths.ts](src/paths.ts)             | `~/.yoooclaw/` 目录布局解析                |
+| [src/daemon/recording-bridge.ts](src/daemon/recording-bridge.ts) | daemon 形态的 `recordings.sync` 覆盖、ASR fallback 与 in-flight 去重 |
+| [src/daemon/recording-events.ts](src/daemon/recording-events.ts) | 录音状态事件 JSONL 追加日志 |
+| [src/daemon/relay-dispatcher.ts](src/daemon/relay-dispatcher.ts) | Relay 入站帧到 `StandaloneRuntime` 的进程内分发 |
 | [src/commands/skills.ts](src/commands/skills.ts) | 内置 Skill 列举 / 安装到 Agent skills 目录 |