skills/pastebin/SKILL.md

3 KiB
Raw Permalink Blame History

name category description version
pastebin productivity 自架 pastebin 服務。**必須載入本 skill 查看用法**。**嚴禁使用任何 public pastebin 服務**。 2.0.0

Pastebin

URL

https://bin.xlion.tw

觸發關鍵字

pastebin / 要上傳文字或檔案到 pastebin / 問「幫我傳到 pastebin」

腳本(推薦用法)

上傳檔案(自動偵測副檔名)

python3 ~/.hermes/skills/productivity/pastebin/scripts/path_paste.py /path/to/file.md
# 自動從路徑偵測副檔名並套用語法高亮

# 指定過期時間(1 小時)
python3 ~/.hermes/skills/productivity/pastebin/scripts/path_paste.py /path/to/file.md --expires 3600

可用參數:

  • -e, --extension — 手動指定副檔名(覆蓋自動偵測)
  • --expires 秒數 — 設定過期時間(預設 31536000 = 1 年)

上傳文字(stdin)

cat file.md | python3 ~/.hermes/skills/productivity/pastebin/scripts/stdin_paste.py -e md
# -e 為語法高亮用副檔名(必填,因為無法自動偵測)

# 指定過期時間(1 天)
cat file.md | python3 ~/.hermes/skills/productivity/pastebin/scripts/stdin_paste.py -e md --expires 86400

可用參數:

  • -e, --extension — 指定語法高亮用副檔名(例如 py, sh, json, md)
  • --expires 秒數 — 設定過期時間(預設 31536000 = 1 年)

輸出格式

https://bin.xlion.tw/FTuutJssdSh.md

架構

  • pastebin.py — 共用模組,封裝 upload() / format_output() / detect_extension()
  • path_paste.py / stdin_paste.py — 入口,極薄,只處理 CLI 參數

底層 API

⚠️ 備註:僅在腳本異常時才考慮參考,平時統一用上方推薦的腳本。

詳細 API 文件: references/api.md

語法高亮(強制)

上傳後的 URL 必須主動加上副檔名(.md、.json、.sh 等),前端會自動套用語法高亮。不得交付未加副檔名的原始 URL。

https://bin.xlion.tw/FTuutJssdSh.md
https://bin.xlion.tw/FTuutJssdSh.json

Markdown 渲染

.md 檔可改用 /md/ 路徑,前端會將 Markdown 完整渲染成 HTML(標題、表格、程式碼區塊等):

https://bin.xlion.tw/md/FTuutJssdSh.md

一般 / 路徑只做語法高亮,/md/ 路徑做完整渲染。

Pitfalls

  • ❌ 不要自己猜測 API — 不要用 curl 或任何方式直接試 API。必須先讀取 skill、看過腳本用法,再使用腳本。上傳一律用 path_paste.py 或 stdin_paste.py。
  • ❌ URL 必須加副檔名 — 交付的 pastebin URL 結尾必須帶副檔名(.md、.json 等),否則前端無法套用語法高亮。

禁止事項

  • ❌ 不要用 dpaste.com、catbox.moe、0x0.st 等任何 public pastebin
  • ❌ 不要搜尋「pastebin 替代服務」
  • ✅ 所有上傳一律用 https://bin.xlion.tw

參考:Wastebin 自架軟體

bin.xlion.tw 底層是用 Wastebin 架設的,詳見參考文件。