← 返回 Skills 市场
Md Viewer
作者
hoangcongst
· GitHub ↗
· v1.0.2
· MIT-0
117
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install md-viewer
功能描述
LAN-accessible web viewer for Markdown files optimized for e-readers. Auto-binds to LAN IP for easy access. TRIGGER when user says "cho tôi xem", "show me",...
安全使用建议
This skill appears to be what it claims: a local LAN web viewer for .md files. Before installing, consider these practical security/privacy points:
- Network exposure: the default behavior auto-binds to your LAN IP and opens a listening port (8765). Only run on trusted networks or use the --localhost option to restrict to loopback.
- URL tokens: links include the password/token in the URL. Tokens in URLs can leak via browser referrers, logs, or chat messages. Treat links as sensitive and avoid sharing on untrusted systems.
- Cookie lifetime & auth: the cookie is persistent (30 days). If someone can access the browser on a device that opened the link, they may gain access until the cookie expires.
- History file: the server stores a history file (~/.md-viewer-history.json) that may include names/paths of viewed files. Use --no-history if you prefer not to persist that.
- Path checks: the code blocks common sensitive paths/patterns, but path-blocking is based on string checks. If you have concerns, review server.py to confirm it resolves symlinks and enforces absolute paths before serving.
- Sanitization: the code prefers bleach for sanitization; if bleach is not installed, it falls back to regex-based sanitization which is less robust. Install bleach (pip3 install bleach) to improve XSS protection.
If you want to minimize risk: run with --localhost, use a strong custom password (--password), disable history (--no-history), and keep bleach installed. Review the bundled server.py yourself if you handle sensitive files.
能力评估
Purpose & Capability
Name/description match what the code and SKILL.md do: a local web server that renders .md files and generates LAN links. No unrelated credentials, binaries, or cloud services are requested.
Instruction Scope
SKILL.md instructs the agent to start a local server and generate LAN links rather than reading/summarizing file contents — this matches the code. The server necessarily reads markdown files to serve them (expected), but the skill does not instruct the agent to collect or transmit unrelated system data. Be aware the agent will instruct the local system to run a network-facing server.
Install Mechanism
No remote installers or downloads are used; code is bundled in the skill and dependencies are typical Python packages (markdown, bleach). No high-risk install URLs or archive extraction are present.
Credentials
The skill requests no environment variables or external credentials. It stores history to a file in the user's home directory and uses a generated password/token to protect access — these are proportionate and expected for its functionality.
Persistence & Privilege
always:false (no forced installation). The server writes a history file (~/.md-viewer-history.json) and creates a long-lived cookie (30 days) for convenience. It also binds to a LAN IP by default (network exposure), which is necessary for sharing but is a privileged network-facing behaviour to be aware of.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install md-viewer - 安装完成后,直接呼叫该 Skill 的名称或使用
/md-viewer触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
md-viewer 1.0.2
- Server now auto-binds to LAN IP for easier network access.
- Password authentication upgraded: supports cookie-based login (30 days), enabling seamless future access.
- Viewer theme and font optimized for e-reader comfort (light theme, high contrast, serif fonts).
- Improved security: HTML sanitized with bleach library and enhanced blocked path list.
- Simplified sharing: access links contain token, with password auto-saved on first use.
- New server options allow easier LAN/localhost selection and disabling history for privacy.
- Added VERSION.md.
v1.0.1
- Adds a Markdown web viewer skill accessible via LAN, letting users open .md files directly in their browser from any device on the same WiFi.
- Triggers when the user requests to view/review a Markdown file (in English or Vietnamese).
- Enforces security: only allows .md files, blocks sensitive paths, password protects access, and sanitizes output to prevent XSS.
- Provides simple commands to start the server and generate secure viewing links.
- Mobile-friendly, features GitHub-style dark mode and syntax highlighting for Markdown files.
元数据
常见问题
Md Viewer 是什么?
LAN-accessible web viewer for Markdown files optimized for e-readers. Auto-binds to LAN IP for easy access. TRIGGER when user says "cho tôi xem", "show me",... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 117 次。
如何安装 Md Viewer?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install md-viewer」即可一键安装,无需额外配置。
Md Viewer 是免费的吗?
是的,Md Viewer 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Md Viewer 支持哪些平台?
Md Viewer 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Md Viewer?
由 hoangcongst(@hoangcongst)开发并维护,当前版本 v1.0.2。
推荐 Skills