render-workspace-html

渲染工作区 HTML

将 paper-workspace/ 目录转换为一个仪表板，供作者在浏览器中打开——展示生命周期进度、按阶段分组且带可点击链接的所有生成产物，以及近期活动时间线。这是在其他技能生成的文件之上，直观呈现“我在哪里／已完成哪些工作”的视图。

这是可选功能：只有在可视化概览确实有帮助时才提供（例如完成一批工作后，或作者提出要求时），不要每轮都提供。作者希望保持内容实时更新时，每次重大变更后都刷新，避免内容过时。

适用场景

• 作者要求查看 HTML 页面／仪表板／可在浏览器中查看的进度摘要。
• 已运行多个技能，工作区内容足够丰富，值得一览时。
• 作者说“保持 HTML 更新”——之后每次请求只要更改了工作区，就在结尾重新生成。

流程

1. 提供选项，不要擅自生成。 如果作者没有提出要求，询问一次：“需要一个 HTML 仪表板来查看进度吗？我可以在每次变更后刷新。”只有作者同意后才生成。
2. 生成（确定性）：

   python3 scripts/build_dashboard.py --workspace paper-workspace
   

   它会读取 paper-workspace/INDEX.md 和各阶段文件夹（以及存在时的 .paper-memory/profile.yml，以获取标题／投稿 venue），并写入 paper-workspace/dashboard.html——这是一个独立文件，包含内嵌 CSS，无需网络或外部资源，并能适配浅色／深色模式。仅当工作区尚不存在时才以状态码 1 退出。
3. 告知作者文件位置（open paper-workspace/dashboard.html）。概述其中展示的内容。
4. 按需刷新。 如果作者要求保持实时更新，则在任何会写入新产物的请求结束时重新运行步骤 2，并告知作者已刷新。否则，只有作者再次提出要求时才重新生成。

输出

paper-workspace/dashboard.html——展示分阶段进度条、带有各项输出链接的产物卡片，以及根据 INDEX.md 生成的近期活动时间线。可在任何浏览器中离线打开。

更丰富的报告

此技能旨在快速运行且零依赖：只生成一个可反复刷新的独立 dashboard.html，并可离线使用。如果作者要求设计更精美或交互性更强的报告，且当前 Agent 运行环境安装了独立的 Web 工件、前端或报告构建技能，则可提出将工作区摘要交给该工具处理。保留此仪表板作为默认状态视图；只有作者要求达到演示级 HTML 效果时，才使用更丰富的构建工具。

防护措施

• 仅限本地。 仪表板是根据本地产物生成的本地文件；不得上传、托管或复制到此技能仓库中。不得渲染第三方论文内容（仅展示作者自己的输出）。
• 独立运行，不跟踪。 仅使用内嵌 CSS——不使用外部脚本、字体、图片或分析工具。
• 可选功能。 不要在每一轮中未经询问就生成仪表板；先提供选项，再按作者的偏好刷新。
• 它只会展示其他技能生成的内容；不会编辑产物、打分或修改论文。

记忆

使用共享的 .paper-memory/ 约定（paper-memory-convention.md）。

• 开始时： 读取 profile.yml 中的论文标题／投稿 venue，用于标注仪表板；检查作者是否选择了自动刷新。
• 结束时： 记录自动刷新偏好（date · render-workspace-html · auto-refresh on/off），以便后续运行遵循此设置，无需再次询问。
• 按需创建 .paper-memory/；仅限本地，绝不上传。