前言¶

在 DeepSeek Harness（DSH）里让智能体解释架构选型、协议细节或仓库模块关系时，常见输出是长段 Markdown 或零散代码块。读起来像终端日志，表格和流程图往往要读者自己脑补排版。若希望交付物像一篇可离线打开的文档页——白底、细分割线、标题与正文字号统一——需要额外约定格式，或事后手工整理 HTML。

Answer me with HTML 已能把 Markdown 草稿转成单文件 HTML；本仓库是其 fork，内置 Shimo Docs 主题并设为默认，面向「复杂问题 → 短 Markdown 草稿 → 一页自包含 HTML」这条链路。下面介绍插件定位、能力与在 DSH 中的安装用法。

这是什么¶

Answer me with HTML in Shimo Style（仓库名 answer-me-with-html-in-Shimo-Style）由维护者 kanzakivnw 发布，在 DSH 社区目录中归类为模型推理。简介：让 AI Agent 用一页石墨风格 HTML 回答复杂问题。

工作方式可以概括为：智能体只写 Markdown 草稿，不直接写 HTML、CSS 或 SVG；项目内捆绑的 am CLI 负责版式、主题 token、图表坐标、明暗模式，以及写作质量检查（STE）。最终产物是单个 HTML 文件（内联 CSS 与 JS），无需服务器、无需构建步骤、不依赖 CDN。

与上游项目相比，CLI、草稿流程、组件与视频能力保持不变；本 fork 新增并默认启用 shimo 主题（白页、灰底画布 #f7f7f7、标题 30px/700、正文 15px/1.7 等，主题说明中标注对照石墨编辑器 2026-10 度量，并通过 WCAG AA 对比度检查）。页面与配置目录与上游共用 ~/.answer-me-with-html/，同一台机器上建议只安装其中一个，避免设置与页面互相覆盖。

核心功能¶

下面列出的能力均来自项目 README 与 package.json 描述，可按需选用。

石墨文档视觉（默认主题）
浅色为白页加浅灰分割线与中性灰阶，强调色为可访问的石墨蓝 #2b68c2；支持 am config set mode dark 或页面工具栏切换深色。主题源码在仓库 src/themes/shimo.js；若在 ~/.answer-me-with-html/themes/shimo.json 放置同名用户主题会覆盖内置版本。

单文件、可离线
输出一页 HTML，表格、代码块、提示框、流程/时序/ER 图、图表、时间线、树与数学公式等由 CLI 渲染；模型侧只需维护结构化 Markdown。

写作约束
STE 检查会在落盘前标记冗长句子和过长段落，便于控制篇幅。

配置与浏览
生成页面默认写入 ~/.answer-me-with-html/pages/，用浏览器打开即可。页面右上角工具栏可切换主题与明暗、打开评论、将回复 Markdown 复制回智能体。

运行环境要求 Node.js ≥ 20（README 徽章与 package.json 的 engines 一致）。许可证为 MIT（README 与仓库一致）。

在 DSH 中安装与启用¶

插件以 DSH 插件形式接入时，使用官方文档中的命令（勿自行拼接其它 dsh plugin add 变体）：

dsh plugin --profile web add github:kanzakivnw/answer-me-with-html-in-Shimo-Style

README 还给出通过智能体阅读安装说明的方式：让 Agent 打开
https://raw.githubusercontent.com/kanzakivnw/answer-me-with-html-in-Shimo-Style/main/INSTALL.md 并按步骤执行。跨 Agent 的一键安装示例为：

npx skills add kanzakivnw/answer-me-with-html-in-Shimo-Style

安装完成后，技能目录位于 DeepSeek Harness 的 ~/.dsh/skills/（与 README 中「Manual install」路径说明一致）。CLI 已捆绑在技能内，无需对仓库单独执行 npm install 即可按技能文档使用 am 命令。

注意： DSH 插件在当前 dsh 进程的权限下运行。安装前请自行查看 GitHub 源码与 MIT 许可证，确认符合你的安全与合规要求。

典型用法¶

安装并启用技能后，用平时提问的方式即可，例如 README 中的示意：

> Explain the TCP three-way handshake
> Redis or Memcached for our cache?
> Map out how the modules in this repo fit together

智能体生成短 Markdown 草稿并调用捆绑 CLI 后，在 ~/.answer-me-with-html/pages/ 得到 HTML 文件，本地浏览器打开阅读。

需要改默认主题或明暗模式时，可直接在终端操作（主题默认 shimo）：

am config                      # 查看当前设置
am config set theme shimo      # 使用石墨 Docs 主题
am config set theme auto       # 按内容自动选主题
am config set mode dark        # 深色配色
am list                        # 查看模板、主题、组件列表

也可通过智能体对话执行 config 相关操作。在线效果可参考项目 GitHub Pages Demo：
https://kanzakivnw.github.io/answer-me-with-html-in-Shimo-Style/

适用场景与注意¶

适合谁
需要在 Agent 对话后得到可分享、可归档、版式统一的技术说明页的团队或个人；尤其偏好石墨文档阅读体验、又希望模型只写 Markdown、版式由工具兜底的场景。

不适合或需知悉
若你只需要纯文本或极简 Markdown 回复，不必启用本插件。与上游共用数据目录时，请勿并行安装两个 answer-me-with-html 变体。本介绍未覆盖的开发构建流程（npm ci、npm run build、npm test）见仓库 README 的 Development 一节。

结尾¶

Answer me with HTML in Shimo Style 把「复杂问题的 Agent 回答」收敛为：Markdown 进、单页石墨风 HTML 出，由捆绑 CLI 承担版式与图表，减轻手写 HTML 的负担。社区目录页与源码如下，版本与星标以站点与 GitHub 实时信息为准。

• 目录页：https://www.skillhub.cn/plugins/kanzakivnw/answer-me-with-html-in-Shimo-Style
• GitHub：https://github.com/kanzakivnw/answer-me-with-html-in-Shimo-Style