MD Web — 将 Markdown 转换为网页

将原始 .md 文件上传至一个兼容 S3 的对象存储桶（bucket），由预部署的 Docsify 服务器自动将其渲染为网页。此举可避免在对话中发送大段文本内容。

适用场景

上传的内容将公开可访问。 仅当用户明确要求时，才可使用该技能：

• 用户希望在浏览器中展示或预览内容为网页形式
• 用户希望生成、导出或发布内容为网页形式
• 用户需要内容的可共享链接
• 用户希望输出以网页形式交付，而非在聊天窗口中以长文本形式呈现
• 用户希望编译或组织内容，并以网页形式呈现
• 用户通过技能名称主动调用（例如：/md-web）

使用方法

步骤 1：检查配置

检查 ~/.md-web/config.json 是否存在（跨平台：使用用户的主目录）。若该文件不存在，或其中存在空字段，请先参考下方的配置章节完成设置。

步骤 2：准备 Markdown 文件

可直接使用已有的 .md 文件，也可将内容写入临时文件。临时路径需根据当前平台选择（例如 Linux/macOS 下为 /tmp/，Windows 下为系统临时目录）。请选用当前 shell 环境下可用的路径。

步骤 3：通过 upload.js 上传

node {SKILL_DIR}/upload.js  

• {SKILL_DIR}：本技能的根目录（技能加载时顶部会显示）
• ：采用小写、带连字符的描述性名称（例如 api-docs.md、project-guide.md）。脚本会自动在文件名前添加时间戳（如 20260305-091500-api-docs.md），以避免命名冲突。
• 首次运行时，脚本将自动检测并部署 Docsify 服务器所需文件，无需手动配置。

步骤 4：返回结果

• 成功时：脚本将打印生成的 URL。请仅回复文件名及可点击链接，切勿将 Markdown 内容粘贴至聊天窗口中。
• 失败时（非零退出码）：向用户报告错误，并回退为直接在聊天中以纯文本形式发送 Markdown 内容。

成功示例输出：

api-docs - https://example.r2.dev/index.html#/md-web/20260305-091500-api-docs

配置

该步骤仅需执行一次。后续运行时，config.json 已存在。

1. 告知用户：本技能需依赖一个具备公开读取权限的兼容 S3 的存储桶。请用户查阅 {SKILL_DIR}/README.md 获取详细配置说明（支持 Cloudflare R2 / AWS S3 / 其他兼容 S3 的服务）。
2. 请用户提供以下 5 个必需字段：
   • access_key：API 访问密钥 ID
   • secret_key：API 密钥访问密钥
   • endpoint：S3 接入点主机名，不含 https:// 前缀（例如：ACCOUNT_ID.r2.cloudflarestorage.com）
   • bucket：存储桶名称
   • public_url：公开访问地址。若用户已为该存储桶绑定自定义域名，请使用该域名（例如：https://docs.example.com）；否则请使用默认 R2.dev 地址（例如：https://pub-XXXX.r2.dev）。生产环境强烈推荐使用自定义域名——R2.dev 地址存在请求频率限制。
3. 询问用户是否配置以下可选参数：
   • region：S3 区域。Cloudflare R2 请填 auto；AWS S3 请填写实际区域（例如：us-east-1）。默认值为 auto。
   • expire_days：上传的 Markdown 文件在存储桶中自动删除前的保留天数。默认为 30。设为 0 表示永久保留。脚本将设置一条 S3 生命周期规则，且该规则作用范围严格限定于 md-web/ 键前缀，因此仅影响本技能上传的文件——Docsify 服务器文件及其他存储桶内对象均不受影响。注意：此功能要求 API Token 具备管理员级读写权限（而不仅是对象级读写权限）。若 Token 权限不足，脚本将发出警告但仍可正常上传；用户可随后在 Cloudflare 控制台中手动配置生命周期规则。
4. 将配置写入 ~/.md-web/config.json（若 ~/.md-web/ 目录不存在，则自动创建）。请使用用户主目录（Unix 系统为 $HOME，Windows 系统为 %USERPROFILE%）：

{
  "access_key": "...",
  "secret_key": "...",
  "endpoint": "...",
  "bucket": "...",
  "region": "auto",
  "public_url": "...",
  "expire_days": 30
}

5. 完成后即可继续执行上传操作。

重要提示

• 请勿生成 HTML。只需上传原始 .md 文件——Docsify 负责渲染。
• 除非上传失败，否则不得将 Markdown 内容发送至聊天窗口。
• upload.js 仅依赖 Node.js 内置模块（零第三方依赖）。
• 所有 Docsify 资源（JS/CSS）均本地打包——运行时不依赖任何外部 CDN。

外部端点

本技能仅连接用户在 config.json 中配置的 S3 接入点，不会向技能作者或任何第三方服务发送数据。

安全与隐私

• 所有上传内容将在返回的 URL 上公开可访问——切勿上传密钥、凭据、个人身份信息（PII）或其他敏感内容。
• 凭证（access_key、secret_key）以明文形式保存于 ~/.md-web/config.json（位于技能目录之外，升级时不受影响），且仅用于向用户自己的 S3 接入点发起认证请求。请务必保护该文件——切勿提交至代码仓库或分享给他人。
• 请使用专用存储桶。 所有上传文件均存放于 md-web/ 键前缀下，且自动过期规则也限定于此前缀；但当 expire_days: 0 时，脚本会清空整个存储桶的生命周期配置——使用专用存储桶可确保本技能绝不会影响您自行管理的其他对象或生命周期规则。
• 本技能自身不采集任何遥测数据、分析数据或用户行为数据。
• upload.js 仅使用 Node.js 内置模块——无任何第三方依赖。

使用本技能时，Markdown 内容将上传至您自己的兼容 S3 的存储桶，并对外公开。全程不向技能作者或任何第三方服务发送数据。仅当您信任所配置的存储服务提供商时，方可安装使用。