← 返回 Skills 市场
rokokol

Math Notes KaTeX

作者 ilysha · GitHub ↗ · v0.1.3 · MIT-0
cross-platform ⚠ suspicious
165
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install math-notes-katex
功能描述
Render math-heavy notes to PNG using KaTeX (LaTeX) + headless Brave. Use when the user asks for a clean “solution/конспект as an image”, “formulas as a pictu...
安全使用建议
This skill seems to do what it claims (turn LaTeX-like notes into PNGs) but it's incomplete in practice. Before installing or running it: - Do not run blindly. Inspect the full render_note_png.js (the portion that launches Brave) to confirm it only screenshots local HTML and does not fetch or post to external URLs. - The package has no install spec or package.json. You will need Node.js and the katex module available in the runtime, and an executable Brave/Chromium on PATH (or pass a full --brave path). Add/verify a package.json or run npm install katex in a controlled environment. - Running headless Chromium as root may require flags (--no-sandbox --disable-setuid-sandbox); using those flags reduces sandboxing — avoid running the browser as root where possible. Prefer running inside an isolated container or dedicated VM if you are unsure. - The scripts link KaTeX CSS via file:// to load fonts locally; ensure the katex package and fonts are present and that CSS does not include remote font URLs. If you must allow remote resources, be aware that could introduce network fetches. If you want to proceed: run the scripts in an isolated environment (container or VM), add explicit dependency/install steps (npm install katex and any other modules), and verify the Brave invocation flags are reasonable for your security posture.
功能分析
Type: OpenClaw Skill Name: math-notes-katex Version: 0.1.3 The math-notes-katex skill is a utility for rendering LaTeX-formatted notes into PNG images using KaTeX and a headless Brave/Chromium browser. The bundle includes Node.js scripts for splitting markdown into pages (split_note_md.js) and rendering them (render_note_png.js), along with a shell script wrapper (render_note_pages.sh). The renderer includes a helpful 'preflight lint' feature to detect common character confusables (e.g., Cyrillic vs. Latin letters) that break LaTeX. While the browser is invoked with high-privilege flags like --no-sandbox and --allow-file-access-from-files, these are used to render locally generated HTML and are documented as necessary for headless operation in restricted environments. No indicators of malicious intent, data exfiltration, or unauthorized execution were found.
能力评估
Purpose & Capability
Name/description match the code: the JS and shell scripts implement KaTeX -> HTML -> headless Brave screenshot flows. However the skill declares no required binaries or env vars while its runtime clearly needs node, the 'katex' node package, and a Chromium-family browser (Brave). That omission is an incoherence: someone building this feature would reasonably need to declare these dependencies or provide an install step.
Instruction Scope
Runtime instructions (SKILL.md and scripts) stay on-topic: they read a local markdown file, split/render it, build local HTML, and invoke a headless browser to produce PNGs. There are no instructions to read unrelated system files or to send data to external endpoints. The troubleshooting notes explicitly call out the headless flags needed to access local files.
Install Mechanism
No install specification is provided despite code that depends on Node modules (katex) and an external browser binary. There is no package.json or npm install guidance, so it's unclear how katex (and any other runtime modules) will be made available. This is a practical and security concern: missing install instructions may lead users to run ad-hoc installs or run the code in an unexpected environment.
Credentials
The skill requests no environment variables or credentials. That is proportionate for the stated purpose. Note: runtime access to the filesystem (reading input file, writing out/ directories) is required and expected for rendering; no credentials are requested.
Persistence & Privilege
The skill does not request elevated or persistent privileges and 'always' is false. It does invoke an external browser (headless Brave) which will be run when the script is executed — this is expected for the task and not flagged by itself.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install math-notes-katex
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /math-notes-katex 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.3
Tidy docs; clarify usage without extra security notes
v0.1.2
Add multi-page rendering (heuristic split + per-page PNG render)
v0.1.1
EN docs + clearer scope; remove --disable-web-security; keep local file-only rendering
v0.1.0
Initial release: render LaTeX-heavy notes to PNG via KaTeX + headless Brave; includes preflight lint for common confusable symbols
元数据
Slug math-notes-katex
版本 0.1.3
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 4
常见问题

Math Notes KaTeX 是什么?

Render math-heavy notes to PNG using KaTeX (LaTeX) + headless Brave. Use when the user asks for a clean “solution/конспект as an image”, “formulas as a pictu... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 165 次。

如何安装 Math Notes KaTeX?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install math-notes-katex」即可一键安装,无需额外配置。

Math Notes KaTeX 是免费的吗?

是的,Math Notes KaTeX 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Math Notes KaTeX 支持哪些平台?

Math Notes KaTeX 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Math Notes KaTeX?

由 ilysha(@rokokol)开发并维护,当前版本 v0.1.3。

💬 留言讨论