马斯多登频道
此包通过 Mastodon API 提供代理状态发布、回复、助推、首选、搜索、趋势化内容、跟踪和参与度量表 masto。 。 。 .
安装
npm install @framers/agentos-ext-channel-mastodon
同伴依赖 : @framers/agentos >=0.10.40。 。 。 .
使用量
import { AgentOS } from '@framers/agentos';
const agentos = await AgentOS.create({
extensionManifest: {
packs: [
{
package: '@framers/agentos-ext-channel-mastodon',
options: {
accessToken: process.env.MASTODON_ACCESS_TOKEN,
instanceUrl: process.env.MASTODON_INSTANCE_URL,
},
},
],
},
});
配置
| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
accessToken | mastodon.accessToken | MASTODON_ACCESS_TOKEN | 对 | 空字符串 |
instanceUrl | mastodon.instanceUrl | MASTODON_INSTANCE_URL | 没有 | https://mastodon.social |
secrets | | | 没有 | A. 背景情况 secrets,则 {} |
选择优先于秘密,然后是环境变量。 选项 secrets 优先于上下文 secrets。激活尝试 FileTokenStore 页:1 mastodon 当访问符为空时。 存储的元数据可以覆盖 instanceUrl 当存储的符号被装入时.
| 工具 | 它会做什么 |
mastodonPost | 张贴可选内容警告、能见度和媒体的状态. |
mastodonReply | 对现有状况的答复. |
mastodonBoost | 启动或解除启动状态 . |
mastodonFavourite | 喜欢或不喜欢一种状态. |
mastodonSearch | 搜索账户、标签或状态. |
mastodonTrending | 在实例上获得趋势标记、状态或链接. |
mastodonFollow | 跟踪或不跟踪账户. |
mastodonAnalytics | 得到提升,最爱和答复 状态. |
mastodonPost
| 参数 | 类型 | 需求 | 说明 |
text | 字符串 | 对 | 状态文本 |
spoilerText | 字符串 | 没有 | 内容警告/ 破坏者文本 |
visibility | 字符串, enum : public, (中文(简体) ), unlisted, (中文(简体) ), private, (中文(简体) ), direct | 没有 | 后可见度( 默认 ): public(中文(简体) ) |
mediaPath | 字符串 | 没有 | 要附加的媒体文件路径 |
sensitive | 布尔 | 没有 | 将介质标为敏感 |
language | 字符串 | 没有 | 语言代码(如:. en(中文(简体) ) |
mastodonReply
| 参数 | 类型 | 需求 | 说明 |
statusId | 字符串 | 对 | 需要答复的状态 |
text | 字符串 | 对 | 答复文本 |
spoilerText | 字符串 | 没有 | 内容警告/ 破坏者文本 |
mastodonBoost
| 参数 | 类型 | 需求 | 说明 |
statusId | 字符串 | 对 | 推进状态的识别 |
undo | 布尔 | 没有 | 设置为真到未启动; 默认 : false。 。 。 . |
mastodonFavourite
| 参数 | 类型 | 需求 | 说明 |
statusId | 字符串 | 对 | 状态标识 |
undo | 布尔 | 没有 | 设置为真到不爱; 默认 : false。 。 。 . |
mastodonSearch
| 参数 | 类型 | 需求 | 说明 |
query | 字符串 | 对 | 搜索查询 |
type | 字符串, enum : accounts, (中文(简体) ), hashtags, (中文(简体) ), statuses | 没有 | 按类型筛选结果 |
limit | 编号 | 没有 | 返回的最大结果 |
mastodonTrending
| 参数 | 类型 | 需求 | 说明 |
type | 字符串, enum : tags, (中文(简体) ), statuses, (中文(简体) ), links | 没有 | 趋势内容类型( 默认 ): tags(中文(简体) ) |
limit | 编号 | 没有 | 返回的最大结果 |
mastodonFollow
| 参数 | 类型 | 需求 | 说明 |
accountId | 字符串 | 对 | 以下账户的编号 |
undo | 布尔 | 没有 | 设置为对未跟随; 默认 : false。 。 。 . |
mastodonAnalytics
| 参数 | 类型 | 需求 | 说明 |
statusId | 字符串 | 对 | 分析状态的标识 |
频道适配器
适配器注册平台 mastodon 并初始化 REST 客户端,并带有实例 URL 和访问符。 它贴出文本 图像或视频附件,破坏者文本, replyToMessageId 财务报告和审定财务报表 platformOptions.visibility它忽略了 conversationId 当张贴时。 反应成为最爱,打字指标无所作为. 它储存处理器,但没有入境事件传送码.
页:1
帖子、回复、助推、最喜欢和随后更改了配置的Mastodon账户。 媒体上传读取本地文件; 适配器处理媒体块 url 值作为文件路径并跳过上传失败。 邮递工具在媒体上传失败时返回错误 .
如果在信使-存储回落后没有可用的访问令牌,则初始化会丢出. 依赖客户端的呼叫在初始化前失败. 搜索和趋势限制被传递给SDK;计划描述提到了默认和搜索上限,但服务并不提供这些数字默认或执行该上限. 可见度传递给SDK而不是本地默认.
导出 MastodonService 也支持删除状态, 读取时间表和服务器侧预定的发布 scheduledAt;这些不是已注册的工具.
释放
新版本发表于 架设层/剂-外延 由 GitHub Actions 通过 npm 信任的出版, 并附有出处声明 .
许可证
阿帕奇 - 2.0
关于 @framers/agentos-ext-channel-mastodon 的常见问题
@framers/agentos-ext-channel-mastodon 是什么?
AgentOS的Mastodon频道适配器——通过Mastodon API发布状态,回复,助推,喜欢,搜索,趋势,跟随,以及参与分析.
如何安装 @framers/agentos-ext-channel-mastodon?
在项目目录运行 npm install @framers/agentos-ext-channel-mastodon,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@framers/agentos(>=0.10.40)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。
@framers/agentos-ext-channel-mastodon 支持 TypeScript 吗?
支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。
@framers/agentos-ext-channel-mastodon 支持 ESM 还是 CommonJS?
以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。
@framers/agentos-ext-channel-mastodon 需要什么版本的 Node.js?
package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。
@framers/agentos-ext-channel-mastodon 可以商用吗?
@framers/agentos-ext-channel-mastodon 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。
@framers/agentos-ext-channel-mastodon 的下载量有多少?
根据 npm 官方下载统计,@framers/agentos-ext-channel-mastodon 在 2026/10/16 – 2026/11/14 这 30 天内被下载 20,149 次,日均约 672 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。
@framers/agentos-ext-channel-mastodon 还在维护吗?
最新版本 0.2.3 发布于 2026/11/11(4 天前);至今共发布 8 个版本,其中过去 12 个月发布了 8 个;首次发布于 2026/05/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。