登录

帮助中心

本站功能全面指南 —— 文件格式转换工具、博客系统、代码片段库、资源分享、竞赛统计、音频降噪与管理后台。帮助你快速上手,充分利用本站所有功能。

📅 2025 年 6 月 📂 网站帮助 🏷️ 功能指南 · 使用教程 · FAQ

一、网站概览

vanadium ZIP To PDF 是一个多功能的在线工具平台,提供文件格式转换、博客写作、资源分享等丰富的功能。无论你是需要转换文档格式、撰写技术博客,还是分享文件资源,本站都能满足你的需求。

📦
文件转换
压缩包/图片/PDF/PPT 互转
📝
博客系统
Markdown 写作与分享
🛡️
管理后台
单管理员 · 文件化存储
💻
代码片段
ACM 算法 · VS Code 集成
☁️
资源分享
本地文件夹存储 · 在线预览
🔐
管理后台
用户 · 博客 · 资源管理
🎬
视频播放
流媒体播放 · ASS 弹幕
🔊
音频降噪
MP3/WAV 降噪处理
📊
竞赛统计
Rating · 解题数 · 热力图
🔍
全局搜索
博客 · 资源 · 代码片段

二、文件格式转换工具

本站提供多种文件格式转换工具,覆盖压缩包、图片、PDF、PPT 等常见格式。

压缩包转 PDF

上传 ZIP / RAR / 7z / TAR 等格式的压缩包,系统会自动解压并收集其中的图片文件,按文件夹结构生成 PDF 文件,最终打包为 ZIP 供下载。

  • 支持递归解压嵌套文件夹
  • 按文件夹分别生成独立的 PDF 文件
  • 支持后台异步处理,实时查询处理进度(/status/<task_id>)
  • 大文件支持分块上传

图片拼接

将多张图片拼接为一张大图,支持自定义行数和列数布局。

  • 自由选择拼接的行数和列数
  • 支持多种图片格式输入
  • 输出为高分辨率拼接图

PDF 合并与截断

PDF 合并: 将多个 PDF 文件合并为一个,支持指定每个文件参与合并的页码范围(如 1-3,5,7-9)。

PDF 截断: 从 PDF 文件中提取指定范围的页面,生成新的 PDF 文件。

图片格式转换

支持多种图片格式互转:PNG、JPG、WEBP、BMP、GIF、TIFF、ICO 等。

  • 支持批量处理多张图片
  • 实时显示处理进度
  • 可自定义输出格式和质量

图片转 PDF

将多张图片合成单个 PDF 文件。

  • 支持 A4 / Letter 等多种页面大小
  • 自适应布局,超长图自动分页
  • 支持按名称、修改时间、文件大小排序

PPT 转 PDF

上传 PPT / PPTX 文件,转换为 PDF 格式。

  • 优先使用 LibreOffice 进行高质量转换
  • 回退方案使用 python-pptx + PIL + img2pdf
  • 支持批量转换

HTML 与 Markdown 互转

HTML → Markdown: 将 HTML 字符串或文件转换为 Markdown 格式,支持自定义标题样式、自动链接等选项。

Markdown → HTML: 将 Markdown 字符串或文件转换为 HTML,支持代码高亮、行号显示、目录生成等功能。

Polygon 题目格式转换

将 Polygon Codeforces 题目包转换为其他竞赛平台支持的格式。

  • 支持输出为 FPS XML 格式
  • 支持输出为 Hydro / DOMjudge ZIP 格式
  • 保留题目描述、数据、配置等完整信息

音频降噪

上传 MP3 / WAV 格式的音频文件,自动进行降噪处理,输出更清晰的音频。

  • 支持批量上传多个音频文件
  • 实时显示处理进度
  • 支持在线预览降噪前后的效果对比
  • 可打包批量下载处理结果
💡 提示: 大部分转换工具支持后台异步处理,你可以在处理过程中离开页面,稍后通过任务 ID 查询处理进度和下载结果。大文件上传时建议使用分块上传功能。

三、账号与登录

本站无需注册,管理员账号由部署时的 .env 配置决定。

登录

  • 账号来源: ADMIN_USERNAME 与 ADMIN_PASSWORD 在 .env 中配置
  • 登录: 支持用户名或 ADMIN_EMAIL 登录,可选"记住我"功能
  • 登出: 点击登出按钮安全退出(仅支持 POST 方式,防止 CSRF 攻击)

权限说明

  • 普通访问者无需登录即可浏览博客、代码片段与公开资源
  • 博客管理、代码片段管理、资源上传与删除仅限管理员登录后操作
  • 不再提供注册、邮箱验证、找回密码与个人资料功能
💡 提示: 修改管理员密码后需要重启应用(或重新加载 .env)才能生效。

四、博客系统

本站提供完整的博客写作与阅读平台,支持 Markdown 格式撰写、分类标签管理、全文搜索等功能。

阅读文章

  • 博客列表: 支持分页浏览,可按分类、标签筛选,按发布时间或浏览量排序
  • 文章详情: Markdown 渲染为精美 HTML 页面,支持代码高亮、数学公式、告示块等
  • 搜索文章: 支持全文搜索,快速定位感兴趣的内容

写作与编辑

  • 新建文章: 需要管理员登录
  • Markdown 编辑器: 带有实时预览功能,支持 代码高亮、数学公式、表格、告示块 等丰富语法
  • 分类与标签: 为文章添加分类和标签,方便读者检索
  • 封面图片: 可为文章设置封面图
  • 草稿与发布: 文章可保存为草稿,待完善后再发布

文章截断

在文章中插入 <!--more--> 标记可以控制列表页显示的摘要内容,标记前的内容作为摘要,之后的内容在详情页展示。

详细的 Markdown 写作语法请参考本页第九部分:Markdown 写作指南。

五、代码片段系统

本站提供了 ACM 算法代码片段库,收录了常用算法和数据结构的 C++ 代码片段,支持按分类浏览、搜索和下载。

浏览代码片段

  • 通过 代码片段页面 按一级/二级分类浏览
  • 支持按关键字搜索代码片段(名称或描述)
  • 展示片段名称、英文简称、描述和代码内容

下载与导出

  • 单文件下载: 支持下载为 .cpp 文件
  • VS Code 集成: 支持下载为 VS Code 代码片段 JSON 格式,可直接导入编辑器使用
  • 批量导出: 支持一键导出全部代码片段为 JSON(VS Code 格式)或 Markdown 文档
💡 提示: 代码片段前缀格式为 acm-[一级编号].[二级编号][英文简称],可直接在 VS Code 中通过前缀触发自动补全。

六、资源分享系统

本站使用 本地文件夹存储,提供文件的上传、存储、分享和在线预览功能。

浏览资源

  • 通过 分享页面 浏览资源树形结构
  • 所有公开资源均可直接下载或在线预览
  • 支持按文件名搜索资源

文件预览

支持多种格式文件的在线预览:

  • 图片: 直接在浏览器中显示
  • PDF: 在线文档查看
  • 视频: 使用 DPlayer 播放器,支持 ASS 弹幕
  • 文本: 纯文本文件内容展示
  • Word 文档: 在线内容预览

上传与下载

  • 上传: 支持普通上传和分块上传(大文件自动分割为 5MB 分块)
  • 下载: 单文件直链下载,文件夹可打包为 ZIP 下载

视频播放与 ASS 弹幕

  • 支持常见视频格式在线播放
  • ASS 字幕文件自动解析为 DPlayer 兼容的 JSON 弹幕格式
  • 自动关联视频与同名的弹幕文件

七、竞赛统计

本站提供了面向算法竞赛选手的 编程竞赛数据统计 功能,汇聚多平台竞赛数据。

在线 Rating 数据

通过 /api/ratings 接口返回 Codeforces 和 AtCoder 的 Rating 数据,数据缓存过期时自动抓取更新。

各平台解题数

通过 /api/solved 接口返回以下平台的解题数数据:

  • Codeforces
  • AtCoder
  • 力扣 (LeetCode)
  • 洛谷 (Luogu)
  • 牛客 (Nowcoder)
  • Vjudge
  • 杭电 (HDU)

AC 提交热力图

通过 /api/ac_heatmap 接口返回近一年各平台按日的 AC 提交数及统计信息,支持生成类似 GitHub 贡献图的提交热力图。

💡 提示: 所有数据接口均带有缓存机制,后台线程会定期预热缓存,确保数据响应的及时性。数据仅供个人参考,请遵守各平台的使用规则。

八、管理后台

管理员登录后可通过管理后台管理博客、代码片段与分享资源。

博客管理

  • 查看所有文章列表
  • 新建、编辑与删除文章
  • 切换文章置顶状态
  • 切换文章发布/草稿状态

资源管理

  • 树形文件管理界面
  • 新建文件夹、上传、重命名、移动与删除文件
  • 上传文件到本地存储(带动画进度条)

代码片段管理

  • 维护代码片段分类与片段内容
  • 数据保存在 data/snippets.json

九、Markdown 写作指南

本站博客系统使用 Markdown 作为撰写格式。以下是最常用的语法参考。

基础语法

标题与段落

使用 # 号标记标题,最多支持六级标题。段落之间使用空行分隔。

# 一级标题
## 二级标题
### 三级标题

文本样式

**加粗文字**
*斜体文字*
~~删除线文字~~
`行内代码`

渲染效果:加粗文字、斜体文字、删除线文字、行内代码

列表

- 无序列表项
- 另一项
  - 子项目(缩进两个空格)

1. 有序列表第一项
2. 有序列表第二项

链接与图片

[链接文字](https://example.com)
![图片描述](图片URL)

代码块与语法高亮

使用三个反引号包裹代码块,并指定语言名称以获得语法高亮:

```python
def hello():
    print("Hello, World!")
```

渲染效果:

def fibonacci(n):
    if n <= 1:
        return n
    a, b = 0, 1
    for _ in range(2, n + 1):
        a, b = b, a + b
    return b
// 异步函数示例
async function fetchData(url) {
    const response = await fetch(url);
    return response.json();
}
#include <iostream>
int main() {
    std::cout << "Hello, C++!" << std::endl;
    return 0;
}
💡 提示: 本站的代码块支持一键复制功能——将鼠标悬停在代码块右上角,点击 📋 复制按钮即可复制代码内容。该功能通过事件委托实现,对动态加载的内容同样有效。

表格

使用标准 Markdown 表格语法,支持对齐控制:

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容    | 内容     | 内容    |
语法特性 支持情况 说明
标题✅ 支持h1 ~ h6
列表✅ 支持有序/无序/嵌套
代码块✅ 支持围栏/缩进/行内
表格✅ 支持对齐控制
数学公式✅ 支持MathJax 渲染
告示块✅ 支持OI Wiki 风格

引用与告示块

普通引用:

> 这是一段引用文字
知识就是力量。
—— 弗朗西斯·培根

OI Wiki 风格告示块:

??? note "标题"
    详细内容,支持 **Markdown** 语法。
📝 笔记(默认展开)

使用 ???+ 可让告示块默认展开;使用 ???- 或 ??? 则默认折叠。

⚠️ 警告类型

支持的类型:note、warning、tip、info、danger 等,不同颜色标识。

💡 提示类型

内部支持任意 Markdown 内容。

数学公式

本站使用 MathJax 渲染 LaTeX 数学公式。

行内公式 用单个 $ 包裹:$E = mc^2$ → \(E = mc^2\)

公式块 用双 $$ 包裹:

$$
\sum_{i=1}^{n} i = \frac{n(n+1)}{2}
$$

文章截断与摘要

在文章中插入 <!--more--> 标记可手动控制摘要:

这是摘要内容,显示在列表页。

<!--more-->

这是正文,点击进入详情页后可见。

未使用截断标记时,系统自动截取前 200 个字符作为摘要。

写作规范建议

  1. 合理使用标题层级:从 ##(二级标题)开始,不要跳级
  2. 代码块指定语言:始终标注语言名称以获得正确语法高亮
  3. 适当使用空行:提高可读性
  4. 控制文章长度:使用 <!--more--> 控制摘要
  5. 标签分类:添加合适的分类和标签方便检索

十、全局搜索

本站提供 全局搜索功能,支持同时搜索博客文章、资源文件和代码片段,快速定位你需要的内容。

  • 博客文章: 搜索文章标题和正文内容
  • 资源文件: 在已分享的资源文件中按名称搜索
  • 代码片段: 搜索 ACM 代码片段的名称和描述
  • 快速定位: 搜索结果直接链接到目标页面,一键跳转

你可以在导航栏的搜索框中输入关键字,或访问 搜索页面 获得更完整的搜索结果。

十一、常见问题

Q: 上传文件大小有限制吗?

大文件建议使用分块上传功能(自动将文件分割为 5MB 分块上传),支持断点续传。普通上传受服务器配置限制。

Q: 转换任务可以后台运行吗?

是的,大部分转换工具支持后台异步处理。提交任务后会获得一个任务 ID,你可以关闭页面,稍后通过该 ID 查询处理进度和下载结果。

Q: 如何发布博客文章?

本站没有开放注册,管理员登录后即可在后台新建、编辑与发布文章。

Q: 资源分享的文件安全吗?

所有文件存储在服务器本地文件夹,上传、重命名与删除操作仅限管理员登录后执行。

Q: 视频支持哪些格式?弹幕如何工作?

支持常见视频格式在线播放。系统会自动检测与视频同名的 ASS 字幕文件,并将其解析为 DPlayer 兼容的弹幕格式进行显示。

Q: 如何切换移动端/桌面端视图?

页面底部或顶部有视图切换按钮,点击即可在移动端和桌面端视图之间切换,方便在不同设备上获得最佳浏览体验。

Q: 忘记管理员密码怎么办?

修改服务器上的 .env 文件中的 ADMIN_PASSWORD,然后重启应用即可。

Q: 遇到问题如何反馈?

如有任何问题或建议,请联系网站管理员。你也可以在博客评论区留言反馈。

Q: 如何了解网站开发者?

访问 关于页面 可以了解网站开发者的个人信息、技术栈和项目经历。


希望这份帮助指南能让你更好地使用本站。祝你使用愉快!🎉

📖 博客列表 💻 代码片段 ☁️ 资源分享 👤 关于 🔄 刷新本页 🏠 首页