1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | answer-me-with-html |
| 作者/维护者 | QingYunA(个人开发者),另有多位外部贡献者 |
| 来源链接 | https://github.com/QingYunA/answer-me-with-html |
| 许可证 | MIT |
| GitHub Stars / Forks | 1,025 / 72(GitHub API,2026-10-05;仓库创建于 2026-10-02) |
| 最新版本 | v0.4.7(2026-10-04 发布,GitHub Release) |
| 安装方式 | npx skills add QingYunA/answer-me-with-html,或 Claude Code 插件市场,或手动复制 skills 子目录 |
| 运行依赖 | Node.js 20+,无需 npm install(CLI 已打包在 skill 目录内) |
2. 功能介绍与亮点
遇到需要看图才能懂的复杂问题时,agent 只写一份简短的 Markdown 内容稿,随 skill 附带的 am 命令行工具负责排版、配色、流程图与时序图的坐标计算,输出一个可离线打开的单文件 HTML 页面。
- 省 token:作者基准测试中输出 token 中位数由 6,873 降到 923,耗时由 46 秒降到 13 秒;总费用基本持平(数据来自仓库自述,未独立复测)。
- 组件齐全:flow 流程图、sequence 时序图、tree、timeline、limits、annot 逐词点评、callout,以及带 ✓/✗ 徽章的对比表。
- 出错可自修:稿件有错时,命令返回行号、组件名与正确示例,agent 通常一次改对。
- STE 受控写作检查:按句长、被动语态、套话给出警告,可调为严格模式。
- 局部改稿:
am patch只替换页面中的某一个面板。 - 解释视频:
am video把稿件生成 3Blue1Brown 风格的带旁白播放页,可选导出 MP4。 - 两套主题(blueprint 图纸风 / shadcn 卡片风),均支持明暗模式。
3. 适用场景
所属分类:数据分析与可视化。适合需要把协议流程、模块架构、方案取舍、历史演进讲清楚的开发者与技术写作者,尤其是想让 agent 的长篇文字回答变成一页可视化图解、又不想等模型逐行手写 CSS 与 SVG 的用户。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持。提供插件市场安装与
npx skills安装,SKILL.md 使用${CLAUDE_SKILL_DIR}变量定位脚本。 - Codex:⚠️ 需适配。README 声明支持并给出
~/.codex/skills/手动复制路径;未实测,且变量需替换为实际目录。 - OpenClaw:❓ 未验证。README 未提及;SKILL.md 为标准格式,安装器声称覆盖 70 余种 agent。
- Hermes Agent:❓ 未验证,依据同上。
判断依据:仓库 README 与 SKILL.md 文字,未做实机运行。
5. 推荐理由
复杂问题的答案堆在终端里很难读。这个 skill 把“写页面”的体力活交给确定性的代码:模型只出内容,布局由程序算,版面不会错位,标签不会被截断。装好即用,没有额外配置,出错时的反馈也足够具体。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 建仓约三天即获 1,025 stars 与 72 forks,并有多位独立贡献者提交 PR 与 issue;项目年龄尚短,暂无具名第三方评测 |
| 可用性 | 8 | 一条命令安装、文档含示例、近日每天都有提交;需 Node.js 20+,项目处于 0.4.x 快速迭代期 |
| 安全性 | 8 | 命令执行与联网范围明确,MIT 许可证清晰,无可疑指令;个人作者、项目较新 |
综合分 = 三项均值 = 7.67。
安全检查清单:
- 命令执行:agent 通过 Bash 运行
node am.mjs;会在~/.answer-me-with-html/写入页面,可能自动打开浏览器;导出 MP4 才需要 Chrome 与 ffmpeg。 - 联网外发:每周一次后台读取 GitHub 上的
package.json检查新版本,不上传用户数据,可设update_check off关闭;仅当设置了ELEVENLABS_API_KEY时,旁白文本才会发往 ElevenLabs。 - 凭据:无强制凭据;ElevenLabs 密钥只从环境变量读取。
- 可疑指令:SKILL.md 与脚本中未发现要求推广第三方或越权操作的内容。可选的 always-on 插件会在每轮注入一段约 90 token 的提醒,用户可随时关闭。
- 作者信誉:个人开发者,抽查 fork 账号年龄与活跃度分布正常,未见批量异常迹象。
- License:MIT。
- 维护:2026-10-04 仍有多次提交,并在数小时内响应 issue。
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 差异 |
|---|---|---|
| answer-me-with-html | 稿件 + 确定性 CLI 渲染 | 模型只写内容,输出 token 少;带写作检查、局部改稿、解释视频 |
| visual-explainer(nicobailon,9,293 stars,2026-07-21 数据) | 由 agent 直接生成自包含 HTML | 自带 diff 评审、计划审计、项目复盘等场景命令,用 Mermaid 与 Chart.js,幻灯片模式;产出自由度更高但 token 开销更大 |
| 直接让模型手写 HTML | 无附加工具 | 版面自由,但需输出数千 token 的 CSS 与 SVG,坐标易错 |
核心差异:前者靠程序保证版面稳定与低 token 消耗,后者适合场景命令更丰富的代码评审类讲解。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。仓库 issue 区有外部用户的使用反馈:
- laoz8888(GitHub issue #18,2026-10-04):反馈主题变量缺失时流程图渲染为全黑,附根因分析,当日修复关闭。
- pkuqiuning(GitHub issue #23,2026-10-04):反馈在 zcode 中因 description 超过 1024 字符导致技能不加载,约 10 分钟内修复关闭。
- Linw09(GitHub issue #19,2026-10-04):建议扩展图片类表达,尚未关闭。
9. 其他补充
稿件语言自动识别中文、英文、日文,页面按钮与旁白语音随之切换。附带 bench/ 基准脚本,可自行复测。
10. 安装使用方式
npx skills add QingYunA/answer-me-with-html
或在 Claude Code 中:
/plugin marketplace add QingYunA/answer-me-with-html
/plugin install answer-me-with-html@answer-me-with-html
安装后无需配置。直接提问“解释 TCP 三次握手”“这个仓库的模块怎么组织的”,agent 会按需生成页面;要视频就说“做个 3b1b 风格的视频”。页面保存在 ~/.answer-me-with-html/pages/。设置用 am config(如 am config set open off 关闭自动弹浏览器)。
11. 注意事项
- 需要 Node.js 20+;导出 MP4 另需 Chrome、ffmpeg 与 Node.js 22+。
- 项目于 2026-10-02 创建,版本号 0.4.x,接口与行为仍在快速变化,更新为手动。
- 可选的 always-on 插件会让 agent 在几乎每次给出结论时都附带一页 HTML,不需要时不要安装。
- 非 Claude Code 的 agent 需把 SKILL.md 中的
${CLAUDE_SKILL_DIR}换成脚本所在目录的绝对路径。