Math Worksheet

Math Worksheet — 公式转图片

把口述/速记的数学题变成清晰可打印的图片。核心是一个本地实时预览页面：你把题目写成 LaTeX （一行一题）追加进一个文本文件，浏览器页面每秒自动读取并渲染，用户点按钮就能把单题复制成 PNG/SVG 贴进 Word/WPS。整套只依赖 python3 和一个浏览器，无需安装 LaTeX。

启动（每个会话第一次用时跑一次，幂等）

bash ~/.claude/skills/math-worksheet/scripts/start.sh

它会：拷贝页面与离线 MathJax 到运行目录 → 后台起 python3 -m http.server 8765 → 打开浏览器。 输出里有三行关键信息，记住 FORMULAS= 那个路径：

RUN_DIR=.../math-worksheet
FORMULAS=.../math-worksheet/formulas.txt   ← 你要写入的文件
URL=http://localhost:8765/index.html

• 端口被占用时可换端口：start.sh 8770。
• 已在运行则直接复用，不会重复启动。
• 结束：bash ~/.claude/skills/math-worksheet/scripts/stop.sh。

工作循环（启动后）

用户每报一道（或一组）题，你只做一件事：把 LaTeX 写入 FORMULAS 文件（用 Write 工具， 整体覆盖即可），页面 1 秒内自动更新。一行一题。出一组题就写多行。

例如用户说“1/6 加 3/6，等号后留空”，写入：

\dfrac{1}{6}+\dfrac{3}{6}=\underline{\hspace{2cm}}

然后告诉用户“已更新，去页面点该题的 复制PNG 贴进 WPS”。不要每题再去单独生成 PNG 文件—— 复制按钮已经在页面上，这才是省事的路径。

LaTeX 写法约定（务必遵守）

| 需求 | 写法 | |---|---| | 分数 | \dfrac{a}{b} | | 答案填空线 | \underline{\hspace{2cm}}（改 cm 调长短） | | 空白分数（让学生填分子分母） | \dfrac{\hspace{1.2cm}}{\hspace{1.2cm}}（分数线即横线，不要再套 \underline） | | 带分数填空 | \underline{\hspace{1.5cm}}+\dfrac{\hspace{1.2cm}}{\hspace{1.2cm}} | | 比大小填空（填 > < =） | \;\bigcirc\;，如 \dfrac{3}{8}\;\bigcirc\;\dfrac{5}{8} | | 运算符 | + - \times \div = | | 根号 / 乘方 | \sqrt{...} x^{2} | | 括号（自动适配高度） | \left( ... \right) | | 单位（正体）+ 细空格 | \,\text{m}，如 50\,\text{m}\times 30\,\text{m} | | 除法用分数线表示 | \dfrac{\,被除式\,}{\,除式\,} |

硬性规则：

1. 不要在公式外加 $ … $，页面会自动用 $$ 包裹。
2. 公式里不要写中文（MathJax 的数学字体没有中文字形，会显示成方块）。

需要中文标注时放在题面文字里，不要放进公式。

1. 一行一题；空行忽略。
2. 嵌套在 \sqrt{} 或分母里的小分数，可用 \frac（小号）让排版更紧凑。

页面上的按钮（告诉用户怎么用）

• 复制PNG：把该题渲染成 4× 高清 PNG 写入剪贴板，去 Word/WPS Ctrl/Cmd+V 直接贴图。最稳。
• 复制SVG：尝试把矢量 SVG 放进剪贴板；浏览器多半不允许，会自动退回复制源码文本。
• 下载SVG：保存成 .svg 文件，再用“插入→图片”插入，可得真正矢量（新版 WPS/Word 支持）。
• 白底/透明：切换；透明模式下复制出来的 PNG 是透明底（贴进彩色单元格不带白框）。
• 字号滑块：调大让截图/复制更清晰。

注意

• 剪贴板复制需要安全上下文——本页用 http://localhost 已满足。Chrome / Edge / Arc 最稳；

Firefox 对 ClipboardItem 支持弱，复制 PNG 可能失败，建议用 Chrome 系浏览器打开。

• 用户也能脱离 AI 独立使用：在左侧文本框直接敲 LaTeX → 点“渲染”。
• 离线可用：MathJax 库已随 skill 打包；首次若缺失会联网补下一次，之后纯离线。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: caoxg
• Source: caoxg/math-worksheet
• License: MIT

Install and usage instructions live in the source repository linked above.