对号 jo!
    对号 jo!
    • 一、项目说明
    • 二、接口说明
    • 三、应用模块接口
      • 3.1 系统相关API
      • 3.2 网盘文件API
      • 3.3 媒体相关API
      • 3.4 资源相关API
      • 3.5 用户相关API
      • 3.6 分享管理API
    • 四、开发说明
      • 4.1 技术开发总述
      • 4.2 通用数据库接口说明
      • 4.3 前端 API 调用示例
      • 4.3 后端API实现

    一、项目说明

    对号 Jo! - 让你的数据和时间更有价值!

    对号#

    一款面向个人用户省时、省钱、增效的小工具
    对号入座,数造价值!
    你的数据只是你的,对号不往云上存!
    为你省时、省钱、省心!
    让你的数据和时间更有价值!
    本软件是对号科技有限公司面向各类用户推出的Jo!系列开源软件的主推项目,将持续更新,并可依循开源协议及相关特定原则免费商用。

    系统概述#

    对号是一款面向个人用户的多功能工具,支持PC、手机、电视多端访问,几秒钟让自己的电脑变成私人专享服务器。专为个人用户提供NAS网盘、追踪器、智记、钱册、语音秘书、U盘制作、网站导航等工具,帮助用户管理数字资源,提高工作和生活效率。
    基于Tauri和Vue.js开发的跨平台桌面应用,采用现代化的界面设计和稳定的Rust后端架构,为用户提供高效、安全的数字资源管理和工具使用体验。

    主要功能模块#

    1. NAS网盘(Disk)#

    文件操作#

    上传功能:支持单文件上传和大文件分片上传,自动检测文件类型
    下载功能:支持各类文件下载,自动设置正确的Content-Type和Content-Length
    删除功能:支持普通删除(放入回收站)和彻底删除,文件夹删除支持递归操作
    其他操作:文件重命名、移动、收藏标记

    文件夹管理#

    创建、删除、重命名、移动文件夹
    基于路径的文件夹操作
    递归管理子文件夹和文件

    高级功能#

    搜索功能:按关键词、文件类型、收藏状态、删除状态进行搜索
    回收站:支持文件恢复和批量删除
    视图模式:网格视图和列表视图切换

    2. 资源追踪器(Resource)#

    追踪功能#

    资源搜索和追踪
    资源状态监控
    追踪历史记录

    3. 智记(Thinktank)#

    记录功能#

    智能记录和笔记
    笔记分类和标签管理
    搜索和检索功能

    4. 钱册(Wallet)#

    财务管理#

    收支记录和分类
    财务统计和报表
    预算管理

    5. 语音秘书(Voice Assistant)#

    语音功能#

    语音识别和指令
    语音提醒和日程管理
    语音笔记和记录

    6. U盘制作(UPan)#

    U盘功能#

    U盘启动盘制作
    系统安装盘制作
    U盘数据管理

    7. 网站导航(Homepage)#

    导航功能#

    个性化网站导航
    网站分类和管理
    快速访问常用网站

    8. 分享功能(Share)#

    分享创建#

    支持文件和文件夹分享
    可自定义分享标题(默认使用文件名)
    支持设置分享有效期

    分享管理#

    分享列表管理
    分享状态监控
    分享链接复制和取消分享功能

    技术架构#

    前端技术栈#

    Vue.js 3:现代化的前端框架,使用Composition API
    TypeScript:提供类型安全
    Element Plus:UI组件库
    Vue Router:路由管理
    Axios:HTTP客户端

    后端技术栈#

    Rust:安全高效的系统编程语言
    Axum:基于Hyper的Web框架
    SQLite:轻量级嵌入式数据库
    Tokio:异步运行时
    Tauri:跨平台桌面应用框架

    系统架构#

    ┌─────────────────────────────────────────────────────┐
    │                     前端界面                         │
    │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐    │
    │  │   网盘管理   │ │   音乐播放   │ │   视频播放   │    │
    │  └─────────────┘ └─────────────┘ └─────────────┘    │
    │  ┌─────────────┐ ┌─────────────┐                    │
    │  │   资源管理   │ │   分享功能   │                    │
    │  └─────────────┘ └─────────────┘                    │
    └─────────────────────────────────────────────────────┘
                          │
                          ▼
    ┌─────────────────────────────────────────────────────┐
    │                     API层                           │
    │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐    │
    │  │  文件API    │ │  音乐API    │ │  视频API    │    │
    │  └─────────────┘ └─────────────┘ └─────────────┘    │
    │  ┌─────────────┐ ┌─────────────┐                    │
    │  │  资源API    │ │  分享API    │                    │
    │  └─────────────┘ └─────────────┘                    │
    └─────────────────────────────────────────────────────┘
                          │
                          ▼
    ┌─────────────────────────────────────────────────────┐
    │                     后端服务                         │
    │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐    │
    │  │  文件服务   │ │  数据库服务  │ │  搜索服务   │    │
    │  └─────────────┘ └─────────────┘ └─────────────┘    │
    │  ┌─────────────┐ ┌─────────────┐                    │
    │  │  分享服务   │ │  认证服务   │                    │
    │  └─────────────┘ └─────────────┘                    │
    └─────────────────────────────────────────────────────┘
                          │
                          ▼
    ┌─────────────────────────────────────────────────────┐
    │                     数据存储                         │
    │  ┌─────────────┐ ┌─────────────┐ ┌─────────────┐    │
    │  │  SQLite数据库│ │  文件存储    │ │  缓存存储    │    │
    │  └─────────────┘ └─────────────┘ └─────────────┘    │
    └─────────────────────────────────────────────────────┘

    开发环境#

    推荐IDE设置#

    VS Code
    Vue - Official
    Tauri
    rust-analyzer

    依赖安装#

    开发运行#

    构建与部署#

    构建发布版本#

    部署#

    构建完成后,可在src-tauri/target/release目录下找到可执行文件。

    系统特点#

    1.
    跨平台支持:支持Windows、macOS、Linux系统
    2.
    安全性:采用Rust语言开发后端,确保系统安全稳定
    3.
    高性能:支持大文件上传下载,采用分片上传技术
    4.
    易用性:现代化的界面设计,操作简单直观
    5.
    扩展性:模块化设计,便于功能扩展和维护
    6.
    多格式支持:支持常见的文档、图片、音频、视频格式
    7.
    离线使用:无需网络连接即可使用大部分功能

    使用说明#

    1. 网盘管理#

    上传文件:点击上传按钮或拖拽文件到界面
    下载文件:点击文件或右键选择下载
    分享文件:右键点击文件/文件夹,选择分享选项
    搜索文件:使用搜索框按关键词查找文件

    2. 音乐播放#

    添加音乐:将音乐文件上传到音乐文件夹
    播放音乐:在音乐列表中选择音乐进行播放
    管理播放列表:创建和管理自定义播放列表

    3. 视频播放#

    添加视频:将视频文件上传到视频文件夹
    播放视频:在视频列表中选择视频进行播放
    全屏播放:点击全屏按钮进入全屏模式

    4. 资源管理#

    分类浏览:按文件类型浏览不同类别的资源
    预览资源:点击资源进行预览
    管理资源:对资源进行重命名、移动、删除等操作

    注意事项#

    1.
    请定期备份重要文件,避免意外丢失
    2.
    大文件上传可能需要较长时间,请耐心等待
    3.
    分享链接请妥善保管,避免泄露敏感信息
    4.
    彻底删除的文件不可恢复,请谨慎操作
    5.
    建议使用最新版本的浏览器以获得最佳体验

    许可证#

    MIT License

    联系方式#

    如有问题或建议,请联系开发团队:
    邮箱:open@duihao.com
    官方网站:https://www.duihao.com
    修改于 2026-01-21 21:32:54
    下一页
    二、接口说明
    Built with