kunchenguid/lavish-axi

项目介绍

Lavish 解决的是 Agent 生成 HTML 之后人机协作环节缺失的问题。与其用截图和长段文字说明「这里要改」，不如在本地浏览器里直接打开生成的 HTML 文件，点选元素或文本范围进行标注，编辑 Mermaid 白板，再把反馈排队交给 Agent。会话以 HTML 文件的规范路径作为标识，Agent 不需要额外维护不透明 ID；产物运行在沙箱 iframe 中，由 Lavish 注入用于标注、快照和渲染期布局检查的 SDK。

它适合那些已经在用编程 Agent（Claude Code、Codex、OpenCode、GitHub Copilot CLI 等）并希望获得比聊天记录更丰富的审阅界面的人。项目还提供布局问题检测：等字体和动画稳定后，把严重的渲染问题收集到收件箱，由用户挑选后作为修复提示排队；检测是被动的，本身不会唤醒 Agent。

快速使用

推荐方式只安装技能，CLI 通过 npx 按需拉取。

1. 用 Agent Skills CLI 安装技能：npx skills add kunchenguid/lavish-axi --skill lavish；加 -g 可安装到所有项目而不是当前项目。
2. 在支持斜杠命令的 Agent 中直接调用，例如 /lavish let's discuss our plan here，或者直接索要计划、图表、对比等视觉化产物。
3. Agent 编写 HTML 文件并运行 lavish-axi <file>，打开本地浏览器编辑器。
4. 标注并排队反馈后发送；Agent 通过 lavish-axi poll <file> 取走反馈，并用 lavish-axi reply 回复。

另一种方式是全局安装（npm install -g lavish-axi）后运行 lavish-axi setup hooks，为 Claude Code、Codex、OpenCode 和 GitHub Copilot CLI 安装 SessionStart hook，之后需要重启 Agent 会话。lavish-axi setup plugin 可以把 npm 包注册为 VS Code、Cursor 和 GitHub Copilot CLI 中的 Agent Plugin。从源码构建需要 pnpm，依次执行 pnpm install --frozen-lockfile、pnpm run build、pnpm link。

使用约束

核心审阅流程是本地化的，但分享不是：lavish-axi share 会把产物发布到第三方托管服务 ht-ml.app，默认公开，可用 --private 或 --password 设置密码保护。自动生成的密码会出现在命令输出和 Agent 会话记录中，因为需要由 Agent 转达，Lavish 不保存它。托管方不支持移除密码；--unpublish 只是把页面替换为加锁的占位内容而非删除，URL 仍然可访问。原本公开的页面在加锁后仍可能被托管方 CDN 缓存继续提供数分钟。

本地资源应放在产物旁边并用相对路径引用，以 / 开头的根路径无法通过 Lavish 的产物路由解析。export 只内联本地资源，远程 CDN 和字体引用保留为需要联网的链接；单个资源和整体内联上限默认分别为 10 MB 和 25 MB。npm 发布版默认向 Umami 服务器发送匿名使用遥测，可用 LAVISH_AXI_TELEMETRY=0 关闭。项目采用 MIT 许可证，徽章标注支持 macOS、Linux 和 Windows。

HotRepo 点评

2026-11-11 的 JavaScript 日榜记录显示该项目当日新增 50 Star、位列该语言榜第 2，仓库总计 4,532 Star、418 Fork。这是单日单语言榜的强表现，但不足以说明持续采用情况；站内没有该项目全部语言日榜的名次记录，现有证据更像一次带日期的尖峰，而非趋势。技术上的亮点在于面向 Agent 的刻意设计：长轮询投递、带类型的监听与失败状态，以及只作薄存根、指向 --help 和 playbooks 的技能，避免安装副本过期。默认开启的遥测和依赖第三方托管服务的分享模式，是采用前需要权衡的部分。

项目源码与说明