# ERRORS.md

> Command failures, tool errors, API issues, and unexpected behavior.

## [ERR-20260326-001] memory_search

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

### Summary
memory_search 当前不可用，返回 embedding/provider 错误

### Error
```
Memory search is unavailable due to an embedding/provider error.
fetch failed
```

### Context
- Operation attempted: 调用 memory_search 检索 prior work / decisions / preferences / todos
- Result: disabled=true, unavailable=true
- Impact: 需要回忆历史决策时无法走语义检索链路，只能退回到直接读文件

### Suggested Fix
检查 memory_search 依赖的 embedding/provider 配置与可用性，恢复后重新验证长期记忆检索。

### Metadata
- Reproducible: unknown
- Related Files: MEMORY.md, memory/*.md

---

## [ERR-20260326-002] lightpanda

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

### Summary
Lightpanda 当前实例在访问多类站点时存在 SslConnectError、GotNothing 与连接被重置等稳定性问题

### Error
```
Observed failures while driving Lightpanda via CDP on ws://127.0.0.1:9222/:
- Navigation failedReason: SslConnectError
- Navigation failedReason: GotNothing
- ConnectionResetError: [Errno 54] Connection reset by peer
- IncompleteReadError after session dropped during/after navigation
```

### Context
- Operation attempted: 使用自写 CDP 探针连接本地 Lightpanda，访问 example.com、Google、Bing、DuckDuckGo、Wikipedia、lightpanda.io、Hacker News、GitHub、Baidu、Zhihu、Bilibili、docs.python.org、httpbin 等站点
- Successful sample: example.com、cn.bing.com/search?q=lightpanda
- Proxy finding: 本机 127.0.0.1:7890 不通；127.0.0.1:7897 可连接
- Impact: 目前 Lightpanda 仅适合作为受限场景下的实验性浏览器后端，不能默认承担通用网页访问任务

### Suggested Fix
检查 Lightpanda 启动参数、代理设置、TLS/证书处理与日志输出；优先确认浏览器实例是否显式走 127.0.0.1:7897，并改为串行站点测试后再逐步扩大兼容范围。

### Metadata
- Reproducible: yes
- Related Files: tmp/lightpanda_probe.py, tmp/lightpanda_nav.py, tmp/lightpanda_search.py, tmp/lightpanda_search_debug.py, tmp/lightpanda_probe_site.py
- See Also: ERR-20260326-001

---