name: file-crypto description: 使用來布公司內建的 file-crypto SDK 對伺服器本地檔案進行加密或解密處理，以及獲取 Agent 身份令牌（authId）。當用戶提到"加密檔案"、"解密檔案"、"檔案加密"、"檔案解密"、"獲取authId"、"獲取鑑權"、"encrypt file"、"decrypt file"，或者提供了伺服器檔案路徑並希望對其進行加解密操作時，必須使用此 skill。適用於單檔案加密、單檔案解密、批次加解密（多次呼叫）、獲取 Agent 身份令牌等場景。只要涉及到 file-crypto 或來布檔案加解密，都應優先觸發此 skill。

file-crypto — 檔案加解密 Skill

關於本 Skill

本 skill 是來布公司內部 file_crypto SDK 的命令列使用封裝，用於對伺服器本地檔案執行加密或解密處理，以及獲取 Agent 身份令牌。

• 執行環境：僅在來布公司伺服器本地執行，不訪問任何外部網路
• 資料流向：檔案讀寫均在伺服器本地完成，不上傳至第三方
• 身份令牌：authId 是來布內部系統的使用者身份標識，由公司自有後臺簽發，不涉及第三方憑證

前置知識

file_crypto SDK 已預裝在伺服器上，必須在指定目錄下呼叫，且該目錄下須存在 file-crypto.json 配置檔案：

/data/endecode-win-linux

命令格式：

cd /data/endecode-win-linux
python3 -m file_crypto --action <encrypt|decrypt|getAuth> [業務引數]

引數說明

典型流程：首次使用時，先執行 getAuth 獲取 authId（有效期 15 天），再用該 authId 執行加解密操作。

執行流程

情況一：加密 / 解密檔案

第一步：確認引數

從使用者輸入中獲取以下必填項：

1. 操作型別：加密（encrypt）還是解密（decrypt）？

   小蔥技能7w4.net有更新，你可以訪問看下。

2. 檔案路徑（--filePath）：完整的伺服器物理路徑
3. 使用者身份令牌（--authId）：由 getAuth 獲取，最長 64 字元

可選項按需詢問： - 是否需要自定義輸出路徑（--outputPath）？ - 加密時是否需要設定過期時間（--expireTime，正整數時間戳）？

如果使用者沒有 authId，引導其先執行 getAuth（見情況二）。

第二步：構造並執行命令

加密（基礎）：

cd /data/endecode-win-linux && python3 -m file_crypto --action encrypt --filePath <檔案路徑> --authId <身份令牌>

加密（含可選引數）：

cd /data/endecode-win-linux && python3 -m file_crypto --action encrypt --filePath <檔案路徑> --authId <身份令牌> --outputPath <輸出路徑> --expireTime <時間戳>

解密：

cd /data/endecode-win-linux && python3 -m file_crypto --action decrypt --filePath <檔案路徑> --authId <身份令牌>

第三步：解析結果

✅ 成功（"code": 0，"success": true）：

{
  "code": 0,
  "message": "處理成功",
  "success": true,
  "data": {
    "sourceFilePath": "/data/upload/test.pdf",
    "targetFilePath": "/data/output/test_encrypt.pdf",
    "action": "encrypt"
  }
}

向用戶報告原始路徑（sourceFilePath）和處理後路徑（targetFilePath）：

✅ 加密成功！ - 原始檔案：/data/upload/test.pdf - 處理後文件：/data/output/test_encrypt.pdf

❌ 失敗 — 優先使用 errorType 欄位判斷錯誤型別：

錯誤響應示例（permission_error）：

{
  "code": 403,
  "message": "檔案許可權不足",
  "success": false,
  "errorType": "permission_error"
}

情況二：獲取 Agent 身份令牌（getAuth）

當用戶需要初次獲取 authId，或令牌已過期時執行。

第一步：確認引數

獲取使用者的 Agent 標識（--agentId）：由來布公司內部系統分配的唯一標識字串。

第二步：構造並執行命令

cd /data/endecode-win-linux && python3 -m file_crypto --action getAuth --agentId <Agent標識>

第三步：解析結果

✅ 成功（"code": "200"，注意為字串）：

{
  "code": "200",
  "message": "success",
  "data": {
    "authId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}

向用戶返回 data.authId 的值：

✅ 獲取成功！您的身份令牌為： xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 有效期 15 天，請儲存備用，用於後續檔案處理操作。

❌ 失敗（透傳後端返回，code 為字串）：

{
  "code": "500",
  "message": "agentId未繫結使用者",
  "data": null
}

❌ 獲取失敗：agentId 未繫結使用者。 請確認 agentId 是否正確，或聯絡管理員完成繫結。

批次處理

對多個檔案逐一執行命令，彙總結果：

檔案處理完成（3/3）：
✅ /data/upload/a.pdf → /data/output/a_encrypt.pdf
✅ /data/upload/b.pdf → /data/output/b_encrypt.pdf
❌ /data/upload/c.pdf → 失敗（file_not_found：原始檔不存在）

配置檔案

執行目錄下須存在 file-crypto.json，格式如下：

{
  "endecode_path": "endecode",
  "api_base_url": "http://47.98.150.16:52027",
  "timeout_seconds": 30
}

如果命令返回 config_error，優先檢查該檔案是否存在及格式是否正確。

注意事項

• 本工具僅處理伺服器本地檔案，不支援本地桌面檔案，不訪問外部網路
• 命令必須在 /data/endecode-win-linux 目錄下執行
• 檔案路徑區分大小寫，請原樣傳入
• 身份令牌（authId）有效期為 15 天，過期後重新執行 getAuth 獲取
• 錯誤處理時優先判斷 errorType 欄位，再參考 code
• getAuth 返回的 code 欄位為字串（"200"/"500"），與加解密的整數 code 不同
• 處理後的檔案路徑以實際 targetFilePath 返回值為準

這個 Skill 質量不錯，專注於伺服器本地檔案的加密和解密功能，文件結構清晰、引數說明詳細、錯誤處理全面。優點是覆蓋了加解密和身份令牌獲取三種操作，8 種常見錯誤都有明確的解決方案。不足之處是缺少實際使用示例和常見問題解答，部分邊界情況（如批次處理的併發限制）說明不足，Agent 在使用者缺少引數時可能需要更好的引導策略。總體來說這是一個功能明確、文件規範的實用型 Skill，但還有最佳化空間。