personal-html-workspace

Files (200)

• marketplace.json · .claude-plugin/
• plugin.json · .claude-plugin/
• error-notebook.md · .codex/
• html-goal-handoff.md · .codex/
• .gitignore
• AGENTS.md
• LICENSE
• README.md
• SKILL.md
• STYLES.md
• animation.js · assets/content/
• content.css · assets/content/
• content.js · assets/content/
• document.html · assets/content/
• font-picker.js · assets/content/
• image-size.js · assets/content/
• reader-tools.js · assets/content/
• reading.js · assets/content/
• report.html · assets/content/
• academic.css · assets/themes/
• botanical.css · assets/themes/
• default.css · assets/themes/
• minimalist.css · assets/themes/
• neo-brutalism.css · assets/themes/
• playful-geometric.css · assets/themes/
• professional.css · assets/themes/
• retro.css · assets/themes/
• sketch.css · assets/themes/
• terminal.css · assets/themes/
• LICENSE · assets/vendor/katex/
• auto-render.min.js · assets/vendor/katex/contrib/
• KaTeX_AMS-Regular.ttf · assets/vendor/katex/fonts/
• KaTeX_AMS-Regular.woff · assets/vendor/katex/fonts/
• KaTeX_AMS-Regular.woff2 · assets/vendor/katex/fonts/
• KaTeX_Caligraphic-Bold.ttf · assets/vendor/katex/fonts/
• KaTeX_Caligraphic-Bold.woff · assets/vendor/katex/fonts/
• KaTeX_Caligraphic-Bold.woff2 · assets/vendor/katex/fonts/
• KaTeX_Caligraphic-Regular.ttf · assets/vendor/katex/fonts/
• KaTeX_Caligraphic-Regular.woff · assets/vendor/katex/fonts/
• KaTeX_Caligraphic-Regular.woff2 · assets/vendor/katex/fonts/
• KaTeX_Fraktur-Bold.ttf · assets/vendor/katex/fonts/
• KaTeX_Fraktur-Bold.woff · assets/vendor/katex/fonts/
• KaTeX_Fraktur-Bold.woff2 · assets/vendor/katex/fonts/
• KaTeX_Fraktur-Regular.ttf · assets/vendor/katex/fonts/
• KaTeX_Fraktur-Regular.woff · assets/vendor/katex/fonts/
• KaTeX_Fraktur-Regular.woff2 · assets/vendor/katex/fonts/
• KaTeX_Main-Bold.ttf · assets/vendor/katex/fonts/
• KaTeX_Main-Bold.woff · assets/vendor/katex/fonts/
• KaTeX_Main-Bold.woff2 · assets/vendor/katex/fonts/
• KaTeX_Main-BoldItalic.ttf · assets/vendor/katex/fonts/
• KaTeX_Main-BoldItalic.woff · assets/vendor/katex/fonts/
• KaTeX_Main-BoldItalic.woff2 · assets/vendor/katex/fonts/
• KaTeX_Main-Italic.ttf · assets/vendor/katex/fonts/
• KaTeX_Main-Italic.woff · assets/vendor/katex/fonts/
• KaTeX_Main-Italic.woff2 · assets/vendor/katex/fonts/
• KaTeX_Main-Regular.ttf · assets/vendor/katex/fonts/
• KaTeX_Main-Regular.woff · assets/vendor/katex/fonts/
• KaTeX_Main-Regular.woff2 · assets/vendor/katex/fonts/
• KaTeX_Math-BoldItalic.ttf · assets/vendor/katex/fonts/
• KaTeX_Math-BoldItalic.woff · assets/vendor/katex/fonts/
• …and 140 more

SKILL.md (first lines)

# Personal HTML Workspace

按读者和使用目的选择场景，再整理正文、图解和交付形式。学习与博客主要优化文稿质量和有效图片密度：学习覆盖主题内相关知识并详细、直白地解释；博客聚焦具体知识点简明讲清原理，不主动扩展；两者按重要解释任务补足图解，共用阅读模板。汇报与小红书首先优化视觉效果，其次校准文稿重点与详略，先实看代表页再展开全篇；汇报用16:9演示支撑听众判断，小红书用academic竖版图文讲清一个问题。准确性与必要条件始终是底线，章节、图数和布局按实际内容调整，不为场景重复设计模板。

## 选择场景

| 意图 | scene | 默认交付 | 读取 |
|---|---|---|---|
| 系统理解概念、算法、推导与实现 | `learning` | 连续学习 HTML、章节目录、明暗切换 | [四场景流程](references/content-workflow.md)、[场景规则](references/content-scenes.md) |
| 用简明解释与图解讲清具体知识点 | `blog` | 连贯博客 HTML、阅读目录、明暗切换 | 同上 |
| 让听众迅速形成明确判断，理解依据与意义 | `report` | 16:9 演示 HTML、目录、键盘翻页、默认收起的讲者备注、逐页 PNG | 同上 |
| 小红书图文、竖版卡片或已有制图任务 | `rednote` | 原 academic 3:4 PNG、HTML 源页、标题与摘要配文 | [原小红书流程](references/rednote-scene.md)、[工作区](references/workspace.md) |

沿用已明确的场景。只有“HTML/生图模式”时，不从工具推断场景；已有小红书任务沿用原行为。明确只请求辅助图时遵从其范围，不扩成整篇。没有场景线索且无法从上下文判断时，先确认成品用途。

## 共同约束

- 先阅读实际材料、图片和来源，核对变量、条件、公式、shape 与论证顺序。重要论断就近给来源；区分原文事实、教学构造、自行推导和推断，不虚构实验或因果结论。疑似技术错误单独指出，不静默猜测或修正。
- 学习稿按主题建立较广的知识覆盖，讲清核心、前提与直接相关知识，用直白说明、例子和必要推导接通理解；博客只保留讲清当前原理所需的内容与条件，不扩成学习教程。汇报先区分成果、进展、方案评审或论文/技术分享，尽早提出本次主判断或待讨论问题，以证据支持；一个讲解任务可跨多页，不把他人成果、教学构造或拟议方案写成本人的实测结果。页面和备注只保留实际汇报内容，制作提醒留在工作记录，真实限制仍须准确表达。小红书先选小主题，用通俗短正文讲清机制，允许略去难推导但保留理由与条件，图片独立串起主线，配文只作摘要。具体范围、解释深度与完成标准以所选场景Prompt为准。
- 无原稿时先依据主题或调研结果查证、拟稿并审核，材料基线与正文路径按[工作区约定](references/workspace.md#输入与正文选择)处理。有文档时以实际文档为依据。逐段主动寻找图解机会，确认能帮助理解就充分配置，不设数量上限；每图先明确所解疑问与应看出的关系，再制作实际图解。算法执行、shape 映射、数量尺度、几何或状态变化先依据代码、计算或明确构造核对真实关系；HTML 模式用 SVG／程序图呈现，生图模式使用已核实的说明与必要参考图，并核对实际生成结果，不静默换工具；小红书细则见[生图流程](references/image-mode.md)，其他场景不套用卡片画幅。算法动画必须在具体输入下展示数据对象、当前操作与状态转移，让读者看清比较、移动、更新及其原因。流程框依次高亮、说明文字轮播或静态步骤淡入不算算法动画；步数由执行过程决定，不套固定四步。按视觉规则提供暂停与逐步查看，保留可读静态状态。`html/images` 只决定合适的辅助视觉工具；正文可靠排版，精确关系不交给生图猜测。
- 新材料默认拖入 `inputs/待分类/`，收到“处理新材料”后先识别主题、主稿与分类，将本次材料整理到 `inputs/<内容分类>/<主题>/`，不改正文、不覆盖重名、不迁移其他原稿。制作在独立工作副本进行，原稿只读；已有 `blogs/` 原地兼容。仅给主题名时搜索两个入口，唯一匹配直接处理。新成品用 `output/<主题短名>-<学习|博客|汇报|小红书>/`，显式传 `--name` 并核对来源和场景，已有成品改版沿用原入口。记录在 `output/_work/`，交付后同步分类总览。命名、冲突、去重与版本规则以[工作区约定](references/workspace.md)为准。
- 日常制作复用当前公共模板与约束，单篇内容只在工作副本中整理；只有用户明确提出模板修改时才改共享模板。
- 学习、博客和汇报使用 `assets/content/` 的离线模板，来源见[模板设计](references/template-design.md)。学习/博客保留明暗切换与六套阅读配色；汇报默认纯白，只可切换纯白/纸白背景，不提供深色或明暗样张，背景选择独立于长文阅读偏好。小红书固定纸白 `#FAF9F6`，不用纯白或深色。内嵌Noto Sans SC字形子集，标题和正文分别设置字重；首次显式运行 `download_content_fonts.py` 准备缓存。证据原图不反色，切换保留阅读位置或当前汇报页。
- 实际打开HTML检查字体、公式、图解与边界；学习/博客检查明暗截图，汇报检查白底页及纸白背景切换，小红书检查纸白原图。长文另查代码复制、章节直达、续读提示及折叠内容，操作与用法见[四场景流程](references/content-workflow.md)。机器检查不能代替技术与视觉判断。汇报正文不能侵入页脚，容量不足就调整分组和增页，不靠缩字或裁切。

## 执行入口

当前存储的共同与场景 Prompt 见[Prompt入口](prompts/README.md)。日常制作读取这些源文件，在 `output/_work/` 建立当前任务；`work/任务Prompt.txt` 保存本次规则快照，`archive/` 只用于历史归档。查看当前规则时不以归档中的任务副本替代源文件。

学习、博客和汇报读取 `prompts/common.txt`、所选 `prompts/scenes/<scene>.txt` 与[成品视觉规则](references/visual-system.md)，用 `prepare_content.py` 建立副本；先在 `work/` 完成可独立审读的内容稿，按共同与场景 Prompt 分别修订内容与读者理解并确定图文分工，再制作最终图解、Markdown 排版稿或可信 HTML 正文片段。`build_content.py` 组装自包含 HTML，`render_content.py` 按场景检查外观、离线资源和缩放，实际查看后用 `publish_content.py` 汇总。长文与汇报不单独验收手机适配；长文支持字号调节与图像放大。小红书另用 `check_rednote.py` 检查默认画幅并生成手机预览。成品全部文案都须审读，包括图注、页脚、小字和备注；不得夹带草稿、占位或制作说明，构建器不能替代撰稿和目视检查。

小红书日常新建工作目录统一用 `prepare_content.py --scene rednote` 准备，兼容 `inputs/` 和已有 `blogs/`，记录共同与场景Prompt；调用原 `rednote_render.py`，通过 `publish_content.py` 汇总。`prepare_blog.py` 与 `publish_blog.py` 仅兼容历史调用和工作目录。规则见[小红书流程](references/rednote-scene.md)，不将新阅读模板套入卡片。明暗阅读模板不会改变既有 PNG 默认效果。

脚本负责准备、排版、检查、截图和本地汇总，不调用生成模型、不发布社交平台。学习、博客、汇报在 `work/content-review.json` 逐步记录实际审读依据，成稿审读先于排版，成品核对后用 `content_review.py` 绑定最终HTML；发布器核对记录是否完整、是否对应当前版本及当前文案警告。该记录不能代替实际审读，HTML改变后重新检查并记录。全部完成后才标记 `run.json` 为 `completed`；未验证事项如实记录。源码变更不表示已安装到个人技能目录。

From highting/personal-html-workspace, MIT.

More from highting/personal-html-workspace