介绍
# Alter Action Trigger
通过 Clawdbot 或命令行使用 x-callback-urls 触发 Alter 动作。
## 快速开始
```bash # Trigger an action directly node index.js trigger ask-anything --input "What is AI?"
# Find actions with natural language node index.js find "summarize video"
# List all actions in a category node index.js list --category writing ```
## URL 格式
所有 Alter 动作均使用 x-callback-url 格式： ``` alter://action/{action-id}?input={encoded-text}¶m={value} ```
## 函数
### `triggerAction(actionId, input, params)` 通过 x-callback-url 触发一个 Alter 动作。
### `findActions(query)` 查找匹配自然语言查询的动作。
### `listActions(category)` 列出所有动作，可选择按类别筛选。
### `getActionInfo(actionId)` 返回特定动作的详细信息。
### `buildCallbackUrl(actionId, input, params)` 构建 x-callback-url 但不执行它。
---
## 可用动作参考
### 📝 写作动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `analyze-prose` | 分析散文 | 评估写作质量并提供评分和建议 | 无 | | `aphorisms` | 格言 | 查找并打印现有的已知格言 | 无 | | `change-tone` | 更改语气 | 在保留原意的情况下更改文本语气 | `tone`：Assertive, Friendly, Informal, Professional, Simple and direct | | `correct-grammar` | 更正语法与拼写 | 修复语法和拼写错误 | 无 | | `cut-filler-words` | 删除填充词 | 删除填充词使文本更自信 | 无 | | `fill-in` | 填写 | 智能补全部分文本 | 无 | | `improve-writing` | 改进写作 | 润色文本以提高清晰度、连贯性和语法 | 无 | | `lengthen` | 扩充 | 通过添加细节扩充文本 | 无 | | `poll` | 投票 | 生成引人入胜的投票 | 无 | | `rewrite` | 重写 | 用全新的视角重写文本 | 无 | | `shorten` | 缩短 | 在保留要点的同时精简文本 | 无 | | `write-essay` | 撰写文章 | 构建结构良好的文章 | `input`：主题/指令 |
### 💻 代码动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `act-code` | 执行代码操作 | 修改并改进代码 | `input`：指令 | | `document` | 文档化代码 | 用注释为代码添加文档 | 无 | | `explain-code` | 解释代码 | 解释代码和文档 | 无 | | `fill-code` | 填充代码 | 填补缺失的代码 | 无 | | `fix-code` | 修复代码 | 修复代码错误 | `input`：错误信息 | | `language-gpt` | 语言-GPT | 针对编程语言的专业见解 | `input`：问题 | | `suggest-improvements` | 建议代码改进 | 分析代码以进行增强 | 无 | | `transcode` | 转码为其他语言 | 在不同语言之间转换代码 | `language`：目标语言 |
### 🌐 翻译动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `translate` | 翻译 | 在不同语言之间翻译文本 | `language`：Arabic, Chinese, Dutch, English, Filipino, French, German, Indonesian, Italian, Japanese, Korean, Portuguese, Russian, Spanish, Vietnamese | | `translate-to-english` | 翻译成英语 | 将任何语言翻译成英语 | 无 | | `translate-to-french` | 翻译成法语 | 将任何语言翻译成法语 | 无 | | `translate-to-spanish` | 翻译成西班牙语 | 将任何语言翻译成西班牙语 | 无 |
### 📊 摘要动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `summarize-detailed` | 详细 | 包含概述、要点和结论的全面摘要 | 无 | | `summarize-micro` | 微型 | 简明、集中的摘要 | 无 | | `summarize-newsletter` | 新闻简报摘要 | 提取新闻简报的关键更新 | 无 |
### 🔍 提取动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `extract-mails` | 邮件 | 提取电子邮件地址 | 无 | | `extract-names` | 姓名 | 提取人名 | 无 | | `extract-any` | 人物/公司 | 提取个人/商务信息 | 无 | | `extract-predictions` | 预测 | 提取预测 | 无 | | `extract-recommendations` | 建议 | 提取建议 | 无 | | `extract-todo` | 任务 | 提取可执行的任务 | 无 | | `extract-trends` | 趋势 | 提取趋势 | 无 | | `extract-wisdom` | 提取智慧 | 提取见解和有趣的信息 | 无 |
### 📋 格式化动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `format-to-bullet-list` | 项目符号列表 | 将文本转换为项目符号列表 | 无 | | `format-to-markdown-checklist` | Markdown 检查清单 | 将文本转换为检查清单 | 无 | | `format-to-markdown-table` | Markdown 表格 | 将文本转换为表格 | 无 | | `format-to-numbered-list` | 编号列表 | 将文本转换为编号列表 | 无 | | `sort-az` | A-Z 排序 | 按字母升序排序 | 无 | | `sort-za` | Z-A 排序 | 按字母降序排序 | 无 |
### 🎨 创建动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `create-alter-action` | Alter 动作 | 创建 Alter 动作 | `input`：指令 | | `create-charts` | 图表 | 创建 Recharts 可视化图表 | `input`：指令 | | `create-diagrams` | 图表 | 生成 Mermaid 图表 | `input`：指令 | | `create-html` | HTML 页面 | 创建 HTML 页面 | `input`：指令 | | `create-images` | 图像 | 生成 AI 图像 (Flux, Ideogram) | `input`：指令 | | `create-maps` | 地图 | 创建 LeafletJS 地图 | `input`：指令 | | `create-presentations` | HTML 演示文稿 | 生成幻灯片演示文稿 | `input`：指令 | | `create-react-app` | Tailwind React 应用 | 创建 React 应用 | `input`：指令 |
### 🔎 解释动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `analyze-paper` | 分析论文 | 分析研究论文 | 无 | | `explain-selection` | 解释 | 简单解释复杂概念 | 无 | | `hidden-message` | 隐藏信息 | 揭示文本中的隐藏信息 | 无 |
### 🔀 Git 动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `git-commit` | 提交信息 | 生成提交信息 | 无 | | `git-review` | 审查 | 审查代码变更 | 无 | | `git-summarize` | 摘要 | 摘要 Git 提交 | 无 | | `pull-request` | 拉取请求 | 创建 PR 描述 | 无 |
### 🧠 协同智能动作 (专家 GPT)
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `business-strategist-gpt` | 商业战略专家 | 商业战略建议 | `input`：问题 | | `children-educator` | 儿童教育专家 | 早期儿童教育指导 | `input`：问题 | | `e-commerce-strategist-gpt` | 电子商务战略专家 | 电子商务战略建议 | `input`：问题 | | `hrmanager-gpt` | 人力资源经理专家 | 人力资源管理指导 | `input`：问题 | | `marketer-gpt` | 营销专家 | 营销战略建议 | `input`：问题 | | `mental-models-gpt` | 心理模型专家 | 决策制定的心理模型 | `input`：问题 | | `software-architect-gpt` | 软件架构师专家 | 软件架构指导 | `input`：问题 |
### 💬 通用动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `ask-anything` | 随便问 | 开放式 AI 对话 | `input`：指令 | | `ask-web` | 搜索网络 | 带来源的网页搜索 | `input`：问题 |
### 📧 邮件动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `mail-draft` | 邮件草稿 | 创建邮件草稿 | `input`：指令 | | `mail-multi-summary` | 多对话摘要 | 摘要多个邮件线程 | 无 | | `mail-reply` | 邮件回复 | 生成邮件回复 | `answerType`：Any updates?, Doesn't work, I don't know, etc. | | `mail-summary` | 线程摘要 | 摘要邮件线程 | 无 |
### 📱 社交媒体动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `linkedin-post` | LinkedIn 帖子 | 创建 LinkedIn 帖子 | 无 | | `linkedin-reply` | LinkedIn 回复 | 生成 LinkedIn 回复 | 无 | | `twitter-post` | Twitter 帖子 | 创建引人入胜的推文 | 无 | | `twitter-reply` | Twitter 回复 | 生成推文回复 | 无 | | `twitter-thread` | Twitter 话题 | 创建 Twitter 话题 | 无 |
### 📺 YouTube 动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `youtube-hidden-message` | YouTube 隐藏信息 | 分析视频中的隐藏信息 | 无 | | `youtube-summarize-detailed` | YouTube 详细摘要 | 全面的视频摘要 | 无 | | `youtube-summarize-micro` | YouTube 微型摘要 | 快速视频摘要 | 无 |
### 🎯 其他动作
| 动作 ID | 名称 | 描述 | 参数 | |-----------|------|-------------|------------| | `create-a-keynote-deck` | 生成 Keynote 幻灯片 | 生成 Keynote 演示文稿 | `input`：指令 | | `edit-a-keynote-deck` | 编辑 Keynote 幻灯片 | 编辑 Keynote 幻灯片 | `input`：指令 | | `translate-the-deck` | 翻译演示文稿 | 翻译 Keynote 演示文稿 | `language`：目标语言 | | `write-presenter-notes` | 撰写演讲者备注 | 创建演讲者备注 | 无 | | `meeting-scribe` | 会议报告 | 将录音转换为笔记 | 无 | | `spreadsheet-formula` | 电子表格公式 | 创建电子表格公式 | `input`：指令 | | `user-story` | 用户故事 | 创建敏捷用户故事 | 无 |
---
## 类别
| 类别 | 描述 | 动作数量 | |----------|-------------|--------------| | `code` | 编程与开发 | 8 | | `writing` | 文本编辑与创作 | 12 | | `translate` | 语言翻译 | 4 | | `summarize` | 内容摘要 | 2 | | `extract` | 信息提取 | 7 | | `format` | 文本格式化 | 6 | | `create` | 内容创作 | 8 | | `explain` | 解释与分析 | 4 | | `git` | Git 版本控制 | 4 | | `co-intelligences` | 专家 AI 助手 | 7 |
---
## 使用示例
### 来自 Clawdbot
```javascript // Trigger ask-anything with a question const { triggerAction } = require('./index.js'); triggerAction('ask-anything', 'What is machine learning?');
// Find actions for "translate text" const { findActions } = require('./index.js'); const matches = findActions('translate text'); console.log(matches[0]); // { id: 'translate', name: 'Translate', ... }
// Build URL without triggering const { buildCallbackUrl } = require('./index.js'); const url = buildCallbackUrl('translate', null, { language: 'French' }); // -> alter://action/translate?language=French ```
### 来自命令行
```bash # Ask a question node index.js trigger ask-anything --input "Explain quantum computing"
# Translate with specific language node index.js trigger translate --param "language=Japanese"
# Fix code with error message node index.js trigger fix-code --input "TypeError: undefined is not a function"
# Change tone node index.js trigger change-tone --param "tone=Professional"
# Search for actions node index.js find "create a chart"
# Get action details node index.js info create-images ```
---
## 注意事项
- 动作对 Alter 中当前选中的文本/文件进行操作 - 参数会自动进行 URL 编码 - `hasParameters: false` 的动作通常需要在 Alter 中选中内容 - `open` 命令用于在 macOS 上触发 x-callback-urls