feat(recorder): add offline voice clip pipeline

[变更性质]
- 本提交新增本机离线的语音片段录音能力，不涉及网络服务或语音识别。

[新增功能]
- 通过 Pulse 默认输入持续采集音频，以本地 Silero VAD 触发片段。
- 以私有目录和权限写入 24 kbps Ogg/Opus 录音，并提供 systemd 用户服务安装器。

[实现方案]
- 使用有限前置缓冲、静音封段和最长段滚动状态机，避免静音落盘及内存无限增长。
- 增加真实 Opus 编解码、服务 dry-run 和纯逻辑状态转换测试；记录模型归属和部署前置条件。

[影响范围]
- 新增 Python CLI、运行时模块、中文运维文档和自动测试。
- 未安装、启用或启动任何用户 systemd 服务；不删除或修改录音数据。

1 files changed, 33 insertions, 0 deletions

diff --git a/tests/test_storage.py b/tests/test_storage.py
new file mode 100644
index 0000000..389f199
--- /dev/null
+++ b/tests/test_storage.py
@@ -0,0 +1,33 @@
+import os
+import subprocess
+from datetime import datetime, timezone
+
+import numpy as np
+
+from mic_clipper.storage import ClipWriter
+
+
+def test_writer_creates_private_opus_clip_in_segment_start_date(tmp_path):
+    started_at = datetime(2026, 9, 29, 23, 59, 59, tzinfo=timezone.utc)
+    samples = np.sin(np.linspace(0, 100, 16_000, dtype=np.float32))
+    writer = ClipWriter(tmp_path)
+
+    clip = writer.open(started_at)
+    clip.write(samples)
+    clip.close()
+
+    destination = tmp_path / "2026-09-29"
+    files = list(destination.glob("*.opus"))
+    assert len(files) == 1
+    assert files[0].name.startswith("23-59-59")
+    assert os.stat(destination).st_mode & 0o777 == 0o700
+    assert os.stat(files[0]).st_mode & 0o777 == 0o600
+    assert files[0].read_bytes()[:4] == b"OggS"
+    assert b"OpusHead" in files[0].read_bytes()[:128]
+
+    decoded = subprocess.run(
+        ["ffmpeg", "-v", "error", "-i", str(files[0]), "-f", "f32le", "pipe:1"],
+        check=True,
+        capture_output=True,
+    )
+    assert len(decoded.stdout) > 0