render-workspace-html

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Render Workspace HTML

渲染工作区HTML

Turns the

paper-workspace/

directory into a dashboard the author can open in a browser — lifecycle progress, every generated artifact grouped by stage with clickable links, and a recent-activity timeline. It's the visual "where am I / what's been done" view on top of the files the other skills produce.

This is opt-in: offer it when a visual overview would genuinely help (after a batch of work, or when the author asks), not on every turn. When the author wants it kept live, refresh it after each significant change so it never goes stale.

将

paper-workspace/

目录转换为作者可在浏览器中打开的仪表盘——展示生命周期进度、按阶段分组的所有生成成果（含可点击链接）以及近期活动时间线。它是在其他技能生成的文件之上，用于直观展示“当前进度/已完成工作”的视图。

此功能为可选：仅当可视化概览能真正提供帮助时（如完成一批工作后，或作者提出需求时）才提供，并非每次操作都生成。若作者希望保持仪表盘实时更新，每次重大变更后需刷新，确保内容不会过时。

When to use

使用场景

The author asks for an HTML view / dashboard / browser-readable summary of progress.
After several skills have run and the workspace has enough in it to be worth a glance.
The author says "keep the HTML updated" — then regenerate it at the end of each request that changed the workspace.

作者要求提供HTML视图/仪表盘/可在浏览器中阅读的进度摘要。
多个技能运行后，工作区已有足够内容值得查看时。
作者表示“保持HTML更新”——此时每次变更工作区的请求结束后，都需重新生成仪表盘。

Process

流程

Offer, don't impose. If the author hasn't asked, ask once: "Want an HTML dashboard of your progress? I can refresh it after each change." Generate only on yes.
Generate (deterministic):
```
python3 scripts/build_dashboard.py --workspace paper-workspace
```
It reads
```
paper-workspace/INDEX.md
```
and the stage folders (and
```
.paper-memory/profile.yml
```
for the title/venue if present) and writes
```
paper-workspace/dashboard.html
```
— one self-contained file, inline CSS, no network or external assets, light/dark aware. Exit 1 only if there is no workspace yet.
Point the author to it (
```
open paper-workspace/dashboard.html
```
). Summarize what it shows.
Refresh on request. If the author asked to keep it live, re-run step 2 at the end of any request that wrote new artifacts, and say you refreshed it. Otherwise regenerate only when asked again.

主动提供，而非强制生成。若作者未提出需求，可询问一次：“需要生成展示进度的HTML仪表盘吗？我可以在每次变更后刷新它。”仅在得到肯定答复时生成。
生成（确定性）：
```
python3 scripts/build_dashboard.py --workspace paper-workspace
```
该脚本读取
```
paper-workspace/INDEX.md
```
和阶段文件夹（若存在
```
.paper-memory/profile.yml
```
，则从中读取论文标题/会议信息），并生成
```
paper-workspace/dashboard.html
```
——单个独立文件，采用内联CSS，无需网络或外部资源，支持明暗模式。仅当工作区尚未创建时才会退出并返回状态码1。
引导作者查看（执行
```
open paper-workspace/dashboard.html
```
）。简要说明仪表盘展示的内容。
按需刷新。若作者要求保持实时更新，则在任何写入新成果的请求结束后重新执行步骤2，并告知作者已刷新仪表盘。否则仅在作者再次提出需求时重新生成。

Output

输出

paper-workspace/dashboard.html

— a stage-by-stage progress bar, artifact cards with links to each output, and a recent-activity timeline from

INDEX.md

. Opens offline in any browser.

paper-workspace/dashboard.html

——包含按阶段划分的进度条、带成果链接的卡片，以及来自

INDEX.md

的近期活动时间线。可在任何浏览器中离线打开。

Richer reports

更丰富的报告

This skill is built for speed and zero dependencies: one self-contained

dashboard.html

that works offline and can be refreshed repeatedly. If the author asks for a more designed or interactive report, and the current agent runtime has a separate web artifact, frontend, or report-building skill installed, offer to hand the workspace summary to that tool. Keep this dashboard as the default status view; use richer builders only when the author asks for presentation-grade HTML.

此技能专为速度和零依赖设计：生成单个独立的

dashboard.html

，可离线使用并反复刷新。若作者要求更具设计感或交互式的报告，且当前Agent运行环境已安装独立的Web成果、前端或报告生成技能，可提出将工作区摘要交由该工具处理。将此仪表盘作为默认状态视图；仅当作者要求演示级HTML时才使用更复杂的生成工具。

Guardrails

约束规则

Local only. The dashboard is a local file built from local artifacts; never upload it, host it, or copy it into this skills repo. No third-party paper content is rendered (only the author's own outputs).
Self-contained, no tracking. Inline CSS only — no external scripts, fonts, images, or analytics.
Opt-in. Don't generate the dashboard unprompted on every turn; offer it, then refresh per the author's preference.
It only displays what other skills produced; it never edits artifacts, scores, or the paper.

仅限本地。仪表盘是基于本地成果生成的本地文件；切勿上传、托管或复制到技能仓库中。不会渲染第三方论文内容（仅展示作者自身的输出）。
独立无跟踪。仅使用内联CSS——无外部脚本、字体、图片或分析工具。
可选生成。切勿在每次操作时自动生成仪表盘；需先提供选项，再根据作者偏好进行刷新。
仅展示其他技能生成的内容；从不编辑成果、评分或论文。

Memory

内存机制

Uses the shared

.paper-memory/

convention (paper-memory-convention.md).

At start: read
```
profile.yml
```
for the paper title/venue to label the dashboard; check whether the author opted into auto-refresh.
At end: record the auto-refresh preference (
```
date · render-workspace-html · auto-refresh on/off
```
) so later runs honor it without re-asking.
Create
```
.paper-memory/
```
on demand; local-only, never uploaded.

遵循共享的

.paper-memory/

约定（paper-memory-convention.md）。

启动时：读取
```
profile.yml
```
中的论文标题/会议信息以标记仪表盘；检查作者是否选择自动刷新。
结束时：记录自动刷新偏好（格式：
```
日期 · render-workspace-html · auto-refresh on/off
```
），以便后续运行无需再次询问即可遵循该偏好。
按需创建
```
.paper-memory/
```
；仅限本地使用，永不上传。