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

This commit is contained in:
showen
2026-03-13 05:52:26 +08:00
parent f764f27d77
commit 086b4600eb
9 changed files with 1220 additions and 55 deletions

View File

@@ -84,6 +84,7 @@
- 并行派发有文件重叠的任务会导致编译冲突,需要串行或明确文件锁定
- 关键路径任务git push应派给最可靠的人而非按头衔分配
- PM 不可靠时可以跳过 PM 直接派开发者,但要记录原因
- **CEO 绝不自己修代码/测试** — 即使是小修复也要派回给原作者,否则违反角色定位
## 团队经验
- kilo agent 倾向于自作主张读 diff/分析代码,即使明确说不要。解决方案:只给命令,不给"任务描述"

View File

@@ -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` 全量通过,后续继续保持先验证再汇报的节奏。

View File

@@ -30,6 +30,9 @@
- unclutter -idle 0 -root: 立即隐藏光标
- stop 时恢复光标用 pkill unclutter
- cfg(not(target_os = "linux")) 保持状态变量同步但不执行命令
- 为 Rust SDK 写文档时,优先给 pub 类型字段和 trait 方法补齐上下文,示例统一用 `# Examples`
- 对 FFI / 插件宏示例doc-test 以 `ignore` 展示用法,避免引入动态库导出场景的编译噪音
- Rust 验证命令固定先注入 stable 工具链 PATH再跑 `cargo check``cargo test`
## 技能树
- Web 前端和响应式设计:★★★★★

View File

@@ -76,3 +76,4 @@
- 关键指标60fps 渲染、3秒启动、7x24小时稳定
- 旧版本对比测试很重要
- **必须实际运行并截图,不能只看代码**
- 2026-03-13补齐 `src/core/tests.rs` 的关键路径覆盖,重点覆盖动态插件 FFI 返回 null 的降级、无效 manifest 跳过、禁用插件消息跳过、无稳定版本回退失败、以及 `Message` 全变体 JSON round-trip