test+docs: 新增4个测试(66总计) + SDK API文档 + 员工soul更新

souls/liu-jianguo.md

@@ -80,3 +80,12 @@
 - 每个任务必须 cargo check 通过
 - 旧代码参考：`/home/showen/Showen/hologram_player_rust/`
 - 编译环境：`export PATH="/home/showen/.rustup/toolchains/stable-aarch64-unknown-linux-gnu/bin:$PATH"`
+
+## 复盘记录
+
+### 2026-03-13 示例插件完善
+- 示例插件不能只演示 `init/start/stop` 空壳流程，必须覆盖消息发送、消息匹配、配置解析、后台任务、自测与注释文档，否则第三方开发者无法照着扩展。
+- Rust 示例配置优先使用 `serde + #[serde(default)] + deny_unknown_fields + validate()`，把“语法解析”和“业务校验”分成两个阶段，问题定位更清晰。
+- 定时任务示例用 `Arc<MessageSender> + AtomicBool + JoinHandle` 就能讲清楚最小可用线程模型；`stop()` 和配置重载都要负责回收线程。
+- 验收固定执行：`export PATH=... && cargo check --workspace --all-targets`，再执行 `export PATH=... && cargo test --workspace`，两项都绿灯后再汇报。
+- 本次任务一次性通过 `cargo check` 零 warning 和 `cargo test` 全量通过，后续继续保持先验证再汇报的节奏。