amdv：为AI Agent工作流打造的轻量级Markdown预览工具

amdv是一款基于Tauri构建的Markdown预览器，专为AI Agent人机协作场景设计，核心解决传统Markdown查看方式的断层问题，支持实时刷新、交互式审批和主题切换，让Agent生成的计划文档能够即时可视化呈现，助力高效人机协作闭环。

随着Claude Code、Cursor等AI编程助手进入主流开发工作流，Agent生成内容、人类审查确认的交互模式形成，Markdown成为Agent输出计划、文档、报告的首选格式。但传统方式存在明显断层：纯文本阅读难以快速把握层级结构、浏览器打开需要启动本地服务器或依赖在线服务、生成的计划文档缺乏即时预览反馈打断Agent工作流。amdv正是为填补这一断层而诞生的工具。

amdv选择Tauri作为技术底座，相比Electron具有显著优势：资源占用极低（安装包通常几MB，运行时内存占用远低于Electron）、原生性能（Rust后端处理文件IO和系统调用，响应延迟毫秒级）、安全沙箱（默认启用严格内容安全策略，预览含脚本标签的Markdown也不会威胁系统）。

• 基础预览模式：通过CLI命令amdv ./plan.md快速启动预览，因Tauri轻量特性，启动时间通常不到一秒；
• 交互式审批模式：-i参数启动交互界面，提供Accept/Reject按钮和备注输入框，实现Agent方案→人类审查→决策→Agent调整的协作闭环；
• 实时刷新机制：监听源文件变化自动重新渲染，无需手动重启，适合迭代式计划修订。

amdv内置7种预设主题（default-light、default-dark、purple/blue/green/red、red-light），配置持久化存储在~/.config/amdv/config.json。CLI命令支持查看可用主题（--list-themes）和设置主题（--set-theme），还提供CSS自定义主题的扩展指南。

• 开发者安装：克隆仓库后执行pnpm install安装依赖，pnpm tauri dev启动开发模式，pnpm build生成生产构建；
• 终端用户安装：pnpm install:app自动检测系统并完成安装；
• Claude Code集成：复制skill/using-amdv到Claude技能目录，Agent可在生成架构设计、项目计划等场景自动调用预览。

amdv采用分层测试架构：单元测试验证纯逻辑和数据转换正确性、组件测试隔离UI行为、集成测试验证流程完整性、Rust测试覆盖CLI和后端逻辑、E2E测试基于Playwright模拟端到端运行。分层策略平衡日常开发快速反馈与发布前最终保障。

典型使用场景：1.代码重构计划审查（交互预览决策）；2.多方案对比（并排预览选择）；3.文档即时预览（迭代修改实时刷新）。 开源与结语：amdv采用MIT许可证完全开源，聚焦Agent工作流关键环节，填补生态空白，是AI编程助手用户值得加入工具箱的实用组件。