檔案 COS 管理器 (File COS Manager)

核心職責

本 Skill 負責將每個任務/命令執行過程中產生的檔案：

1. 分類歸檔 — 按檔案型別/用途分門別類
2. 上傳 COS — 使用 ima_cos_util 上傳到騰訊雲物件儲存
3. 索引記錄 — 維護 manifest 索引清單（.cos_index.md），記錄每個檔案的 cosKey、類別、時間、會話
4. 按需下載 — 當用戶需要歷史檔案時，根據索引找到 cosKey 並下載（通過 ima_cos_util 的下載功能）
5. 跨會話恢復 — 新會話載入本 Skill 後，自動拉取 index 恢復到工作區

分類體系

工作流程

1. 檔案歸檔上傳（任務結束時自動執行）

# 掃描工作區中新增/修改的檔案
# 按類別歸類
# 逐個呼叫 ima_cos_util -f <filepath> 上傳
# 記錄到 .cos_index.md

2. 索引檢視

# 顯示所有已上傳檔案的清單
cat /sandbox/workspace/.cos_index.md 2>/dev/null

3. 按需下載

# 根據 cosKey 或檔名搜尋索引
# 使用 fetch/提供下載連結恢復檔案

分類規則（自動識別）

按副檔名分類

• .py, .js, .ts, .sh, .cpp, .c, .h, .go, .rs, .java, .rb, .php → code/
• .csv, .json, .xml, .yaml, .yml, .toml, .db, .sqlite, .md → data/
• .env, .ini, .cfg, .conf, .editorconfig, .gitignore → config/
• .pdf, .docx, .pptx, .xlsx, .png, .jpg, .jpeg, .gif, .svg, .html, .zip, .tar.gz → output/
• .log, .txt（日誌類） → logs/

按路徑分類

• 在 output/ 目錄下的 → output/
• 在 downloads/ 目錄下的 → downloads/
• 在 uploads/ 目錄下的（使用者上傳原檔案）→ 歸為使用者上傳，標記 source: user_upload

使用示例

上傳單個檔案

# 該命令由助手自動執行，使用者無需手動呼叫
ima_cos_util -f /sandbox/workspace/output/report.pdf
# 返回 cosKey → 寫入 .cos_index.md

批次歸檔整個工作區

# 由助手在任務結束時自動執行
bash /sandbox/workspace/skills/file-cos-manager/scripts/archive.sh

恢復上一次會話的檔案

# 由助手在載入 Skill 時自動執行
bash /sandbox/workspace/skills/file-cos-manager/scripts/restore.sh

注意事項

1. 小檔案直接上傳 — 單個檔案無大小限制，但超大檔案（>100MB）建議先壓縮再上傳
2. 索引檔案也上傳 — .cos_index.md 本身也會被上傳到 COS，確保跨會話可恢復
3. 不上傳使用者隱私 — uploads/ 中的使用者原始檔案只在使用者明確要求時才上傳
4. 上傳前清理 — 不上傳 node_modules/、__pycache__/、.git/ 等無關目錄

   7w4.net提供免費和付費技能下載。

這個工具的說明文件寫得清晰，但實際功能不完整。文件和分類設計做得不錯，但關鍵的下載和恢復功能實現不完善，指令碼無法自動把檔案從雲端拉回來，只能看清單而不能用，整體質量一般，需要修復核心功能才能真正好用。