v0.10.4

Added

• agentDebugger() / agentProxy() 增加配置诊断：endpoint 未以 / 开头、flushMs / maxBytes 过小、proxy target 非 http(s) 时输出 [agent-eyes] warning。
• 新增配置诊断测试，覆盖 agentDebugger 与 agentProxy 的 warning 行为。

Changed

• 补强导出函数 JSDoc，让 agentDebugger()、agentProxy()、autoInstrument()、installAgentErrorReporter()、installAgentInteractionTracer() 在 IDE hover 和 .d.ts 中有更明确说明。
• agentProxy({ extra: { configure } }) 现在会保留用户传入的 configure 回调。

Verification

• pnpm test
• pnpm typecheck
• pnpm build
• npm pack --dry-run --json

v0.10.3

Added

• 新增 AGENT_BOOTSTRAP.md，明确 Codex、Claude Code、Gemini CLI、Hermes agent 的可用性、推荐入口文件和可复制指令片段。
• AGENT_GUIDE.md 增加 supported agents 说明，强调日志是普通文件，多个 agent 都能使用，但自动发现需要各自启动入口。

Changed

• README、SKILL、运行时 log//README.md 均补充 AGENT_BOOTSTRAP.md 入口，避免 agent 只看到人类文档而不会主动使用日志。

Verification

• pnpm build
• npm pack --dry-run --json

v0.10.2

Added

• 新增 AGENT_GUIDE.md，作为独立于 README 的 agent 操作手册，覆盖 setup 检查、运行时日志入口、排查顺序和安全边界。

Changed

• README 增加文档入口，明确人读 README、agent 读 AGENT_GUIDE.md / log/README.md、skill 机制读 SKILL.md。
• SKILL.md 版本同步到 0.10.2。
• 运行时生成的 log//README.md 指向 AGENT_GUIDE.md。

Verification

• pnpm build
• npm pack --dry-run --json

v0.10.1

Fixed

• 删除 README 中依赖 Bundlephobia 实时解析的 bundle size badge，避免 img.shields.io/bundlephobia/minzip 超时导致页面显示坏图。

Verification

• pnpm build
• npm pack --dry-run --json

v0.10.0

Added

• 新增脱敏交互轨迹：记录 click/input/change/submit/route 到 log//interaction.log。
• 新增客户端 API：installAgentInteractionTracer()、recordInteraction()；autoInstrument() 默认启用，可用 interactions: false 关闭。
• 新增 interaction 单元测试、客户端上报测试和 middleware 落盘测试。

Safety

• input/change 不保存真实输入值，只写 。

Verification

• pnpm test
• pnpm typecheck
• pnpm build
• npm pack --dry-run --json

v0.2.0 — autoInstrument + 脱敏 + 聚合 + 节流 + 12 项 review 修复

✨ 新增

• autoInstrument() 一键自动埋点：fetch + XHR + 路由导航 + 全局错误，无需逐个拦截器手动埋点
• 敏感字段自动脱敏：password/token/secret/authorization 等默认打码，raw:true 放行
• errors.log 聚合去重：Top Errors 按频率排序，省去 agent 自己数
• 多代理分文件：proxy-<host>.log，互不覆盖

🔧 改进

• 日志写入改为内存 buffer + 节流批写（200ms），降低高频上报 IO 开销
• 框架无关：去 React 化，明确支持 React/Vue/Svelte/Solid/原生 JS

🐛 修复（经对抗式 code review，12 项致命+高危）

• 🔴 自动埋点递归死循环（上报自身触发包装后的 fetch）
• 🔴 method 非字符串导致 /dev/log 整体挂死
• 🔴 StrictMode/HMR 重复调用导致 console.error 永久损坏（现已幂等）
• 🔴 多代理共用 proxy.log 互相清空
• 🟠 脱敏误杀 key/auth、漏判 csrfToken 等 7 项高危

详见 CHANGELOG.md。