Mac 自定义工作流

把复制的内容变成你自己的可重复操作。

用可视化步骤或代码构建工作流，选择它支持的剪贴板类型，然后直接在 Pasteon 内置操作旁运行。

官方 Workflow Hub

下载 Pasteon for Mac 创建第一个工作流

可视化步骤或代码Simple 与 Script Filter本地执行脚本

工作流编辑器

步骤已启用

匹配文本

包含“user”

清理文本

空格与换行

转换命名格式

snake_case

返回文本

粘贴或仅复制结果

+ 添加步骤

检查器

转换命名格式

格式

snake_case

输入

测试结果通过 · 0.8 ms

hello world

→

hello_world

选择构建方式

从可视化开始，需要时再进入代码。

Workflow 是保存的处理配方；只有当前剪贴板项目匹配你选择的输入条件时，它的 Action 才会出现在 Pasteon 中。

Steps

用条件、转换、脚本和一个最终输出组成线性流程。在独立检查器中配置每一步，并对比测试前后的值。

适合: 文本清理、模板、格式转换和文件生成

高级

Code

使用指定解释器、参数、工作目录和超时运行内联代码或外部脚本。单一结果用 Simple，运行时选择用 Script Filter。

适合: 自定义工具、开发自动化和动态操作列表

分步教程

四步创建一个文本清理工作流。

这个示例会清理复制文本的空白、统一命名格式，并把结果返回到你正在使用的 App。

01 / 创建

创建工作流并选择输入类型

打开“设置 → Workflows”，新增工作流，填写名称和图标，再选择它应该在哪些剪贴板类型下出现。

02 / 构建

按执行顺序添加转换步骤

添加清理文本、转换命名格式等步骤，并拖拽排序。Output 固定在末尾，让流程始终可预测。

03 / 测试

用当前剪贴板作为测试数据

测试不会真正复制、粘贴或打开内容。你可以查看每一步的前后值、耗时和校验状态。

04 / 运行

启用后从 Pasteon Actions 运行

工作流会直接显示在内置 Primary Actions 之后。点击或按 Enter 粘贴结果；按住 Command 则只复制。

可视化步骤库

常见部分直接组合，特殊部分才写脚本。

步骤从上到下执行。条件决定 Action 何时可用，转换更新当前值，一个输出决定 Pasteon 如何处理结果。

条件

匹配文本来源 App目标 App

转换

清理空白替换 / 正则命名格式URL 编码 / 解码JSON 格式化 / 压缩模板OCR

脚本

内联代码外部脚本自定义解释器

输出

返回文本创建文件PNG 文件在 Finder 中显示打开 URL

代码工作流

一个脚本既能返回结果，也能生成可选操作。

Pasteon 通过 stdin 发送版本化 JSON，并从 stdout 读取协议 JSON。日志写入 stderr；超时、取消和输出限制让运行过程保持可控。

Simple Workflow

执行一次，返回一个结果

当一个 Action 只需要生成一份文本、文件或 URL 结果时，使用 Simple 模式。

{
  "version": 1,
  "result": {
    "type": "text",
    "value": "Ready to paste"
  }
}

Script Filter Workflow

先描述选项，选择后再执行

Filter 阶段只返回轻量候选信息。用户选择某一项后，Pasteon 才运行 execute。

{
  "version": 1,
  "actions": [
    {
      "id": "swift",
      "title": "Generate Swift Model",
      "argument": { "language": "swift" }
    }
  ]
}

Filter

脚本收到 phase “filter”，最多返回 20 个候选 Action。

选择

Pasteon 展示标题、说明、图标和 JSON 参数，不提前计算最终结果。

Execute

被选中的 actionId 和 argument 回传脚本，只计算当前这一项。

stdout 只能输出协议 JSON，诊断信息请写入 stderr。内联代码与外部脚本使用同一套输入输出契约。

协议参考

逐项说明每个字段、取值与运行规则。

编写 Code Workflow 或生成 .pasteon-workflow 文件时可查阅这里。字段名和限制与当前 Pasteon Runner 完全一致。

Open protocol reference →

结果行为

返回下一个 App 真正需要的形态。

普通执行会立即处理结果。Command 点击或 Command + Enter 会把文本、文件和 URL 切换为仅复制；Finder 定位始终直接显示文件。

text

粘贴或复制文本

返回生成文本、清理后的内容、模板、代码或任意字符串。

files

粘贴或复制文件

在提供的输出目录创建文件，并把路径返回给 Pasteon。

openURL

打开或复制 URL

普通模式打开支持的网页或邮件链接，Command 模式复制 URL。

revealFile

在 Finder 中显示文件

在 Finder 中定位返回的本地文件；测试 Workflow 时只展示路径，不打开 Finder。

开箱即用

默认能力也是普通 Workflow。

Pasteon 默认启用这些工作流。你可以像处理其他 Workflow 一样检查、编辑、关闭、复制、导出或删除它们。

转换命名格式Script Filter

粘贴为 JSON 文件.json

粘贴为 TXT 文件.txt

粘贴为 Markdown 文件.md

在浏览器中打开openURL

URL 编码 / 解码Script Filter

粘贴为 Markdown 链接Simple

转换颜色Script Filter

OCROCR → 文本

PNG 文件图片 → .png

在 Finder 中打开revealFile

导入、导出与信任

分享处理配方，也让运行内容保持可审查。

Workflow 文件保持可读和可迁移。导入的 Workflow 默认关闭，检查并信任代码后才能启用。

导入和导出 .pasteon-workflow JSON 文件。

内联代码随 Workflow 导出；外部脚本只保留路径引用。

导入的 Workflow 默认关闭，运行脚本前需要用户确认。

Workflow 脚本以当前 macOS 用户权限在本地运行。

常见问题

自定义 Workflow 常见问题

我需要会编程吗？

不需要。Steps 模式通过线性可视化编辑器提供常用条件、文本转换、模板、脚本和输出；需要自定义行为时再使用 Code。

Simple 和 Script Filter 有什么区别？

Simple 执行一次并返回一个结果。Script Filter 先返回轻量候选项，再在独立的 execute 阶段运行用户选择的那一项。

Workflow 什么时候会出现在 Pasteon 中？

启用的 Workflow 会在当前剪贴板项目匹配输入类型和可视化条件时，显示在内置 Primary Actions 之后。

脚本在哪里运行？

脚本使用你配置的解释器和工作目录在本机运行。导入的 Workflow 在你检查并启用前不会执行。

自定义 Workflow 是 Pro 功能吗？

是。Pasteon Pro 支持创建、测试、导入、导出和运行自定义 Workflow。

创建工作中一直缺少的剪贴板操作。

下载 Pasteon for Mac，从可视化 Workflow 开始，只有流程真正需要时再进入脚本。

下载 Pasteon for Mac 开始 7 天免费试用