自定义指令入门

自定义指令入门面向开发者

专为开发者打造的高阶功能，让您像操作命令行一样处理剪贴板数据。

为何需要自定义指令？

当你在查看日志时发现一个时间戳（如 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))

自定义指令入门 面向开发者