自訂指令入門

自訂指令入門為開發者打造

專爲開發者打造的高階功能，讓您像操作命令行一樣處理剪貼板資料。

爲何需要自訂指令？

當你在查看日誌時發現一個時間戳（如 1735704110），可能需要去 Google 搜尋在線轉換工具。這個過程會打斷您的工作狀態。自訂指令將這些常用邏輯直接集成到軟體中。

實戰案例：時間戳轉換

假設您已經創建了一個名爲 'dt' 的指令，用於在時間戳和日期之間進行轉換。

只需在搜尋框輸入指令前綴和參數：

主控台

dt 1735704110

-> 2025-01-01 12:01:50

反過來也可以！輸入日期，即刻獲得對應的時間戳。

保持心流

Base64 快速編解碼
JSON / XML 格式化與校驗
URL 縮短或隨機 ID 生成
文字大小寫轉換與正則替換

實用提示

Any executable can be a command. Node, Python, Bash, binaries—you name it.

如何開啓您的第一個指令？

自訂指令與編程語言無關。您可以調用 Python, Node.js, Ruby 等腳本，甚至是 C++, Go, Rust 編譯出的二進制檔案。

1. 從系統托盤菜單中進入「自訂指令」管理頁面。

2. 點擊「新建」來創建一個全新的指令定義。

設定說明

名稱

Name: 用於記錄該腳本的功能名稱。

前綴

Trigger Prefix: 觸發該腳本的短命令（例如 dt）。

解譯器

Interpreter Path: 對應腳本的解釋器路徑（二進制檔案可不填）。

路徑

Script Path: 您的腳本代碼或可執行檔案的絕對路徑。

點擊保存後，您就可以在主界面通過「指令+空格」的形式快速調用了。您的輸入會被轉發至腳本處理，結果將實時回寫。

完整 Python 代碼實現

下面的 Python 腳本演示瞭如何實現上述 'dt' 時間戳轉換邏輯。您可以將其保存爲本地檔案，並在軟體配置中將 Script Path 指向該檔案。

convert.py

#!/usr/bin/env python3
import sys
from datetime import datetime

DATE_FORMATS = [
    "%Y-%m-%d",
    "%Y-%m-%d %H:%M:%S",
    "%Y/%m/%d",
    "%Y/%m/%d %H:%M:%S"
]

def is_timestamp(s: str):
    try:
        float(s)
        return True
    except:
        return False

def parse_date(s: str):
    for fmt in DATE_FORMATS:
        try:
            return datetime.strptime(s, fmt)
        except:
            continue
    return None

def convert(s: str):
    if is_timestamp(s):
        ts = float(s)
        if ts > 1e12:
            ts = ts / 1000
        dt = datetime.fromtimestamp(ts)
        return dt.strftime("%Y-%m-%d %H:%M:%S")
    dt = parse_date(s)
    if dt:
        return int(dt.timestamp())

    return f"Unrecognized format: {s}"

if __name__ == "__main__":
    if len(sys.argv) < 2:
        print("Parameter error")
        sys.exit(1)

    value = sys.argv[1]
    print(convert(value))

自訂指令入門 為開發者打造