用途:dev-log 用于 AI 辅助调试协作。AI 负责在代码中埋点,用户负责操作,日志经 HTTP 实时上传到本地服务,AI 再自行读取分析,避免截图和手动复制控制台输出。
主要能力:通过 npx @dev-log/cli start 启动日志服务(固定端口 7331,后台 daemon);gen 命令可为 js、ts、python、go、swift、kotlin、dart、cpp、rust、java、csharp、php、ruby 生成可粘贴的日志语句,支持 state、error、validation、click、request 等类型,自动注入 sessionId 与时间戳;logs 读取收集的日志;clear 清除日志;status 查看状态;tunnel 启动 HTTPS 隧道;stop 停止服务。
必要用法:首次运行建议加 -y 跳过安装确认,如 npx -y @dev-log/cli start。每个调试目标应选定同一个 sessionId 并在每次 gen 时传入 --session,否则日志会被拆分到不同会话。先生成 --ready 连通性探测,再生成业务日志。读取日志时用 --session 过滤。HTTPS 页面、移动端或远程机器需先 tunnel 并用 --url 传入隧道地址。
适用场景:前端代码调试与验证、追踪异步流程(fetch、Promise、async/await)、查看运行时变量值。
限制:不适用于纯静态内容、琐碎检查或纯后端 Node 服务端代码。服务仅限本地开发,不应暴露到公网。绝不记录敏感信息,如 password、pwd、token、secret、apikey、key、credit、cvv、ssn、auth 等字段需先过滤。发布前应移除所有调试埋点。日志和 PID 写入系统临时目录 $TMPDIR/dev-log/。收费、价格等信息暂未提供。