管理員檔案中心完整教學

檔案中心是 ScriptVerify 的檔案管理和分發系統。作為管理員，您可以上傳各種檔案供客戶下載，包括配置檔、資源包、文檔等。

檔案中心概述

什麼是檔案中心？

檔案中心是一個集中式的檔案儲存和分發平台，讓您可以：

管理員上傳 → 檔案中心 → 客戶下載
    ↓
配置檔案
資源包
文檔
更新檔
工具

檔案類型支持

支持的檔案類型：

類別	檔案類型	範例
配置檔	`.lua`, `.json`, `.yml`	`config.lua`, `settings.json`
腳本檔	`.lua`	`client.lua`, `server.lua`
壓縮檔	`.zip`, `.rar`, `.7z`	`resources.zip`
文檔	`.pdf`, `.md`, `.txt`	`manual.pdf`, `README.md`
圖片	`.png`, `.jpg`, `.svg`	`logo.png`
其他	`.xml`, `.sql`	`database.sql`

檔案大小限制：

單檔上限：100MB
總容量：根據 Firebase Storage 配額

上傳檔案

基本上傳流程

步驟1：進入檔案中心

左側導航欄 → 檔案中心管理 (File Center)

步驟2：點擊上傳按鈕

在頁面右上角找到：

 + 上傳檔案

步驟3：選擇檔案

彈出的上傳對話框：

┌─────────────────────────────────┐
│  選擇檔案                     │
│ [點擊選擇] 或 拖曳檔案到此處    │
├─────────────────────────────────┤
│  檔案名稱                     │
│ [自動填入或可修改]              │
├─────────────────────────────────┤
│ 📂 分類                         │
│  選擇分類                      │
│   - 配置檔                      │
│   - 腳本                        │
│   - 資源包                      │
│   - 文檔                        │
│   - 其他                        │
├─────────────────────────────────┤
│  可見性                       │
│  公開（所有客戶可見）          │
│  私有（需要授權）              │
├─────────────────────────────────┤
│  描述（選填）                 │
│ [輸入檔案說明...]              │
└─────────────────────────────────┘

步驟4：設置檔案屬性

屬性	說明	建議
檔案名稱	顯示給客戶的名稱	使用有意義的名稱
分類	檔案分類	選擇適當分類便於查找
可見性	公開或私有	配置檔通常設為私有
描述	檔案說明	說明用途和版本

步驟5：上傳

點擊「上傳」按鈕，系統會：

上傳檔案到 Firebase Storage
生成唯一的下載連結
顯示在檔案列表中
通知上傳成功

實戰範例

範例1：上傳配置檔

目的：為 sun_carry 腳本提供配置檔模板

上傳資訊：
┌─────────────────────────────┐
│ 檔案：config.lua            │
│ 名稱：陽光搬運系統配置檔    │
│ 分類：配置檔                │
│ 可見性：私有                │
│ 描述：sun_carry v2.0       │
│       配置檔模板，          │
│       包含所有可用選項      │
└─────────────────────────────┘

授權對象：購買 sun_carry 的客戶

範例2：上傳資源包

目的：提供完整的腳本資源包

上傳資訊：
┌─────────────────────────────┐
│ 檔案：sun_carry_v2.zip      │
│ 名稱：陽光搬運系統完整資源包│
│ 分類：資源包                │
│ 可見性：私有                │
│ 描述：包含 client.lua,      │
│       config.lua, README    │
│       版本：v2.0.0          │
└─────────────────────────────┘

檔案內容：
sun_carry_v2.zip
├── client.lua
├── config.lua
├── fxmanifest.lua
├── README.md
└── sv_config.lua (模板)

範例3：上傳文檔

目的：提供使用手冊

上傳資訊：
┌─────────────────────────────┐
│ 檔案：manual.pdf            │
│ 名稱：ScriptVerify 使用手冊 │
│ 分類：文檔                  │
│ 可見性：公開                │
│ 描述：系統完整使用手冊      │
│       適用於所有客戶        │
└─────────────────────────────┘

管理檔案可見性

公開 vs 私有檔案

公開檔案：

 所有登入的客戶都能看到
 適合：
   - 系統文檔
   - 通用工具
   - 公告文件
   - 示範檔案

範例：
- ScriptVerify 使用手冊.pdf
- 常見問題解答.md
- 更新日誌.txt

私有檔案：

 需要明確授權才能下載
 適合：
   - 配置檔
   - 腳本資源
   - 客戶專屬檔案
   - 付費內容

範例：
- sun_carry_config.lua
- vip_scripts.zip
- custom_database.sql

修改檔案可見性

步驟：

在檔案列表中找到目標檔案
點擊檔案卡片的 ** 設置圖標**
切換「可見性」開關：
```
 公開     私有
```
保存變更

自動效果：

公開 → 私有：客戶立即無法下載（需要授權）
私有 → 公開：所有客戶立即可見

授權檔案給客戶

為什麼需要授權？

情境：

問題：您有 50 個客戶，但只有 20 個購買了 sun_carry

解決方案：
1. sun_carry 相關檔案設為「私有」
2. 只授權給購買的 20 個客戶
3. 其他客戶看不到這些檔案

授權流程

方法1：在檔案管理中授權

步驟：

找到要授權的檔案
點擊 ** 授權管理** 按鈕
彈出授權對話框：

┌─────────────────────────────────┐
│  sun_carry_config.lua         │
│                                 │
│ 已授權客戶：                    │
│  customer_abc123 ([email protected])│
│  customer_def456 ([email protected])│
│                                 │
│ 添加授權：                      │
│ [搜索客戶...]                   │
│                                 │
│ 可用客戶：                      │
│  customer_ghi789               │
│  customer_jkl012               │
│                                 │
│ [批量授權] [保存]              │
└─────────────────────────────────┘

勾選要授權的客戶
點擊「保存」

方法2：在授權管理中批量授權

步驟：

進入「授權管理」頁面
選擇一個客戶
點擊「授權檔案」
勾選要授權的所有檔案
保存

批量授權範例：

客戶：customer_abc123

授權檔案清單：
 sun_carry_config.lua
 sun_carry_v2.zip
 sun_carry_manual.pdf
 sun_carry_database.sql

一次完成所有授權！

取消授權

步驟：

在檔案的授權管理中
找到要取消的客戶
點擊 ** 移除** 按鈕
確認

效果：

客戶立即無法下載該檔案
檔案從客戶的檔案中心消失

📂 教學4：檔案分類管理

預設分類

系統提供以下預設分類：

分類	圖標	適用檔案
配置檔		config.lua, settings.json
腳本		client.lua, server.lua
資源包		.zip, .rar 檔案
文檔		.pdf, .md, .txt
其他		不屬於以上分類的檔案

使用分類的好處

1. 快速篩選

客戶端檔案中心：
[全部] [配置檔] [腳本] [資源包] [文檔]

點擊「配置檔」→ 只顯示配置檔

2. 組織清晰

sun_carry 相關檔案：
├──  sun_carry_v2.zip (資源包)
├──  config.lua (配置檔)
├──  manual.pdf (文檔)
└──  custom.lua (腳本)

3. 搜索優化

搜索 "config" + 篩選「配置檔」
= 精確找到所需檔案

修改檔案分類

步驟：

找到檔案
點擊 ** 編輯**
選擇新分類
保存

檔案資訊和統計

查看檔案詳情

點擊檔案卡片查看完整資訊：

┌─────────────────────────────────┐
│  sun_carry_config.lua         │
├─────────────────────────────────┤
│ 📂 分類：配置檔                 │
│  大小：12.5 KB                │
│  上傳時間：2025-10-04 14:30  │
│  上傳者：[email protected]   │
│  可見性：私有                 │
│ 📥 下載次數：45                 │
│  授權客戶：20                 │
├─────────────────────────────────┤
│  描述：                       │
│ sun_carry v2.0 配置檔模板       │
│ 包含所有可用選項和說明          │
├─────────────────────────────────┤
│ 🔗 下載連結：                   │
│ [複製連結] [預覽] [下載]       │
└─────────────────────────────────┘

下載統計

查看方式：

檔案列表中每個檔案顯示：

📥 45 次下載

詳細統計 (點擊查看)：

下載記錄：
┌──────────────┬──────────┬─────────────────┐
│ 客戶         │ 次數     │ 最後下載時間    │
├──────────────┼──────────┼─────────────────┤
│ customer_abc │ 5        │ 2025-10-04 10:00│
│ customer_def │ 3        │ 2025-10-03 15:30│
│ customer_ghi │ 2        │ 2025-10-02 09:15│
└──────────────┴──────────┴─────────────────┘

用途：

了解檔案使用情況
發現熱門檔案
追蹤客戶活動

檔案操作進階

批量操作

批量刪除：

勾選多個檔案
點擊「批量操作」
選擇「刪除」
確認

已選擇 5 個檔案：
 old_config_v1.lua
 deprecated_script.lua
 temp_file.zip
 test.txt
 backup.sql

[批量刪除]

批量修改可見性：

勾選多個檔案
批量操作 → 設為公開/私有

批量授權：

勾選多個檔案
批量操作 → 授權給客戶
選擇客戶
確認

檔案搜索

搜索框功能：

 搜索檔案...

支持搜索：
- 檔案名稱
- 描述內容
- 分類
- 上傳者

高級篩選：

篩選條件：
┌─────────────────────┐
│ 分類：[全部 ]     │
│ 可見性：[全部 ]   │
│ 日期：[全部 ]     │
│ 大小：[全部 ]     │
└─────────────────────┘

檔案預覽

支持預覽的檔案：

文字檔 (.txt, .md, .lua, .json)
圖片 (.png, .jpg, .svg)
PDF (.pdf)

預覽方式：

點擊檔案的 ** 預覽圖標**：

┌─────────────────────────────────┐
│  config.lua                   │
│                                 │
│ [代碼內容顯示]                  │
│ Config = {                      │
│   EnableCarry = true,           │
│   MaxDistance = 50.0,           │
│   ...                           │
│ }                               │
│                                 │
│ [關閉] [下載] [複製]           │
└─────────────────────────────────┘

實戰案例

案例1：為新腳本準備檔案包

背景：

剛開發完成 vehicle_shop 腳本
需要為客戶準備完整的檔案包

步驟：

1. 準備檔案

vehicle_shop/
├── vehicle_shop_v1.0.0.zip (完整資源包)
├── config.lua (配置檔模板)
├── database.sql (資料庫檔案)
├── README.md (說明文檔)
└── images/ (圖片資源)
    ├── logo.png
    └── preview.jpg

2. 上傳檔案

檔案1：
 名稱：vehicle_shop 完整資源包 v1.0.0
 分類：資源包
 可見性：私有
 描述：包含所有必要檔案，適用於 ESX/QBCore

檔案2：
 名稱：vehicle_shop 配置檔
 分類：配置檔
 可見性：私有
 描述：配置選項說明，請根據需求修改

檔案3：
 名稱：vehicle_shop 資料庫
 分類：其他
 可見性：私有
 描述：導入到 MySQL，執行前請備份

檔案4：
 名稱：vehicle_shop 使用手冊
 分類：文檔
 可見性：公開
 描述：詳細安裝和配置指南

3. 授權給客戶

客戶 A 購買了 vehicle_shop
→ 授權檔案 1, 2, 3, 4

客戶 B 只想看文檔
→ 檔案 4 已經是公開，無需授權

4. 通知客戶

 Email 通知：

親愛的客戶，

感謝您購買 vehicle_shop！

您的檔案已準備完成，請登入客戶面板下載：
1. vehicle_shop 完整資源包 v1.0.0
2. 配置檔模板
3. 資料庫檔案
4. 使用手冊

安裝步驟請參考使用手冊。

案例2：更新檔案版本

背景：

vehicle_shop 發布了 v1.1.0
需要更新資源包

步驟：

1. 上傳新版本

上傳：vehicle_shop_v1.1.0.zip
設置與 v1.0.0 相同的授權

2. 保留舊版本

不要刪除 v1.0.0！

原因：
- 某些客戶可能還沒準備好升級
- 作為備份

3. 標記版本

新增描述：
v1.1.0 (最新版本) - 新增 XX 功能
v1.0.0 (穩定版本) - 初始發布

4. 通知客戶

 更新通知：

vehicle_shop v1.1.0 現已推出！

新功能：
✨ 新增車輛試駕功能
✨ 優化購買流程
 修復若干 Bug

下載：
- 客戶面板 → 檔案中心 → vehicle_shop v1.1.0

注意：
 需要更新資料庫（執行 update_v1.1.sql）
 配置檔新增選項（請查看新的配置檔模板）

安全最佳實踐

檔案安全

1. 敏感資料處理

 不要上傳：
- 包含真實資料庫密碼的配置檔
- 個人資料
- API 密鑰

 應該：
- 使用佔位符：DB_PASSWORD = "your_password_here"
- 提供模板檔案
- 額外說明敏感設定

2. 檔案命名規範

 好的命名：
- vehicle_shop_v1.0.0.zip
- config_template.lua
- README_zh-TW.md

 不好的命名：
- 新檔案(1).zip
- config最終版本最後確定.lua
- 文檔.pdf

3. 檔案掃描

上傳前檢查：

是否包含惡意代碼
是否有敏感資訊
檔案是否完整
壓縮檔是否正常

授權管理安全

原則：

最小權限原則：
- 只授權必要的檔案
- 定期檢查授權列表
- 客戶到期後立即取消授權

檢查清單：

每月檢查：
 是否有過期授權需要取消
 是否有客戶權限需要更新
 是否有不再使用的檔案需要刪除
 下載統計是否異常

檔案組織最佳實踐

目錄結構建議

雖然系統使用扁平化結構，但建議使用命名規範模擬目錄：

sun_carry/
  sun_carry_v1.0.0.zip
  sun_carry_v2.0.0.zip
  sun_carry_config_v1.lua
  sun_carry_config_v2.lua
  sun_carry_manual.pdf
  sun_carry_database.sql

vehicle_shop/
  vehicle_shop_v1.0.0.zip
  vehicle_shop_v1.1.0.zip
  vehicle_shop_config.lua
  vehicle_shop_manual.pdf

通用文檔/
  ScriptVerify_使用手冊.pdf
  常見問題解答.md
  更新日誌.txt

命名規範

格式：

{腳本名稱}_{檔案類型}_{版本}.{副檔名}

範例：
- sun_carry_config_v2.lua
- vehicle_shop_manual_zh-TW.pdf
- esx_society_database_v1.0.sql

版本管理

檔案版本標記：

v1.0.0 - 初始發布
v1.1.0 - 功能更新
v1.1.1 - Bug 修復
v2.0.0 - 重大更新

版本對應：

腳本版本 ↔ 檔案版本

sun_carry v2.0 → sun_carry_config_v2.lua
sun_carry v1.0 → sun_carry_config_v1.lua

故障排除

問題1：上傳失敗

症狀：檔案上傳時顯示錯誤

可能原因和解決方法：

原因1：檔案太大
解決：
- 檢查檔案大小（限制 100MB）
- 壓縮大型檔案
- 分割為多個檔案

原因2：網絡問題
解決：
- 檢查網絡連接
- 重新上傳
- 使用穩定網絡

原因3：Firebase Storage 問題
解決：
- 檢查 Firebase 配額
- 驗證 Firebase 配置
- 查看瀏覽器控制台錯誤

問題2：客戶無法下載

症狀：客戶回報看不到檔案或無法下載

檢查清單：

 檔案是否設為「私有」但未授權？
  → 在授權管理中添加客戶

 客戶授權是否過期？
  → 檢查授權管理，更新授權

 檔案是否已刪除？
  → 檢查檔案列表

 客戶是否登入？
  → 確認客戶已正確登入

問題3：下載連結失效

症狀：下載連結無法使用

可能原因：

1. Firebase Storage Token 過期
   解決：重新生成下載連結

2. 檔案已被刪除
   解決：重新上傳檔案

3. Firebase 權限問題
   解決：檢查 Firebase Storage 規則

延伸學習

完成本教學後，您可以繼續學習：

客戶檔案中心 - 了解客戶端如何下載檔案
授權管理 - 深入了解授權系統
Protected Scripts - 腳本管理進階技巧

小技巧和捷徑

快速操作

鍵盤快捷鍵：

Ctrl + U - 快速上傳
Ctrl + F - 搜索檔案
Ctrl + A - 全選檔案
Delete - 刪除選中檔案

批量操作技巧：

按住 Shift + 點擊 = 選擇範圍
按住 Ctrl + 點擊 = 多選
全選 → 取消不需要的 = 批量操作

工作流程優化

範本系統：

創建常用檔案的範本：
1. 配置檔範本
2. 說明文檔範本
3. 資料庫範本

好處：
- 減少重複工作
- 保持一致性
- 快速部署新腳本

恭喜！您已經掌握了檔案中心的完整管理！

現在您可以高效地管理和分發檔案給客戶了。有任何問題都可以查看其他文檔或聯繫技術支援。

管理員檔案中心

On this page