# LEARNINGS.md

> Corrections, knowledge gaps, and better repeatable approaches.

## [LRN-20260326-001] best_practice

**Logged**: 2026-03-26T09:11:25+0800
**Priority**: high
**Status**: pending
**Area**: config

### Summary
主动机制只按风险/到期触发会显得过于安静，不符合谷老板对“秘书型主动”的预期

### Details
当前 heartbeat 规则过度强调减少打扰，只在 TODO 活跃任务出现到期、超期、阻塞或明确风险时才主动发消息。结果虽然降低了噪音，但也削弱了陪伴感与推进感。谷老板明确反馈“你太安静了”，并在方案选择上倾向更强主动型（方案 C）。后续默认应采用“有价值的秘书型主动”，允许围绕 open loop、邮箱、日历、系统状态做低频高价值触达，而不是仅在任务风险触发时说话。

### Suggested Action
将主动策略升级为秘书型主动：保留任务风险驱动，同时加入 open loop follow-up 与邮箱/日历/系统状态巡检；保持夜间静默和节流，禁止寒暄型主动。

### Metadata
- Source: user_feedback
- Related Files: HEARTBEAT.md, CURRENT.md, memory/heartbeat-state.json
- Tags: proactive, heartbeat, user-preference, secretary-mode
- Pattern-Key: proactive.too_quiet_due_to_overconstrained_rules
- Recurrence-Count: 1
- First-Seen: 2026-03-26
- Last-Seen: 2026-03-26

---

## [LRN-20260326-002] best_practice

**Logged**: 2026-03-26T08:35:04Z
**Priority**: high
**Status**: pending
**Area**: config

### Summary
使用 Lightpanda 做网页自动化时，应优先把它视为“待验证的特定站点浏览器”，而不是默认当作通用浏览器

### Details
在连接本地 9222 端口的 Lightpanda 实例后，已验证其支持基本 CDP 流程：可连接 websocket、创建 target、attach session、打开 example.com，并读取 document.title 与 document.body.innerText。同时也验证到站点兼容性非常不均匀：cn.bing.com 搜索页可正常加载并提取结果；但 Google 搜索会话会中途断开，DuckDuckGo、Wikipedia、lightpanda.io、Hacker News 等站点出现 SslConnectError，GitHub 及多站点并发探测时还出现 Connection reset by peer。由此可知，当前实例更适合单站点、串行、小范围验证，不适合直接假设为稳定的通用浏览器后端。

### Suggested Action
后续使用 Lightpanda 时，先用一小组目标站点做串行兼容性验证并记录结果；默认优先使用已验证可用的站点（如 Bing），避免一开始并发探测或直接依赖复杂站点。

### Metadata
- Source: conversation
- Related Files: tmp/lightpanda_probe.py, tmp/lightpanda_nav.py, tmp/lightpanda_probe_site.py
- Tags: lightpanda, cdp, browser-automation, compatibility, best-practice
- Pattern-Key: lightpanda.validate_target_sites_before_generalizing
- Recurrence-Count: 1
- First-Seen: 2026-03-26
- Last-Seen: 2026-03-26

---