DSH | static-html-comments | 本机静态 HTML 点选批注，批注落文件、Agent 回写回复

[rxdage]

非官方项目，由社区成员独立开发和维护。
Unofficial project, independently developed and maintained by a community member.

项目地址：https://github.com/rxdage/static-html-comments

简介

给本机静态 HTML 加一层点击批注。点页面上的元素、写一句，意见连同元素路径存进项目内的 .page-comments/comments.json；Agent 读文件改稿，用一条命令把回复写回页面上那条意见。网页文件本身一个字节不改，零依赖（只要 Node 16+）。

和 DSH 的集成

这是一个 DSH skill，不是 plugin。把仓库放到 ~/.dsh/skills/static-html-comments（或项目里的 .dsh/skills/static-html-comments），DSH 扫描到第一层的 SKILL.md 之后，直接说“给这个页面开批注”或“按批注改”即可。dsh plugin add 装不了它。

起因

一份 18 页的本机 HTML 讲稿，和 Agent 改了五轮，前几轮都在对话里描述“第 12 页下面那排方程”。现在是边翻边点，Agent 拿到的是元素和原话，改完逐条回一句。

它不是什么

“在页面上批注、让 Agent 照着改”不是新东西。页面是 React 应用就用 Agentation；主要批文字和贴图就用 html-annotate；不介意往 HTML 里加标签、想看改动走查就用 make-pages-interactive。README 里逐个写了什么时候该用别的。这个工具只占一小格：页面必须原样保留、要点的是元素、每条意见要有回复、不想装别的东西。

边界

只在 Windows 11 的 Chrome 和 Edge 上实测。发布前做过三轮独立评审，每轮找出了什么（包括第二轮发现我报告“已修好”的两处其实没修住）都写在 docs/评审记录.md 里。

一个请求

用你自己的一份本地 HTML 跑一遍，回我一句最不顺手的地方。示例页是我写的，暴露不了你的真实页面会踩到什么。