@framers/agentos-ext-channel-mastodon

中文文档
0.2.3发布于 2026/11/11Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 2万

AgentOS的Mastodon频道适配器——通过Mastodon API发布状态,回复,助推,喜欢,搜索,趋势,跟随,以及参与分析.

中文使用文档
文档目录16 节
  1. 安装
  2. 使用量
  3. 配置
  4. 工具
  5. mastodonPost
  6. mastodonReply
  7. mastodonBoost
  8. mastodonFavourite
  9. mastodonSearch
  10. mastodonTrending
  11. mastodonFollow
  12. mastodonAnalytics
  13. 频道适配器
  14. 页:1
  15. 释放
  16. 许可证

马斯多登频道

此包通过 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,
        },
      },
    ],
  },
});

配置

选项秘密编号环境变量需求默认
accessTokenmastodon.accessTokenMASTODON_ACCESS_TOKEN对空字符串
instanceUrlmastodon.instanceUrlMASTODON_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 共发布 8 个版本,首次发布于 2026/05/02;过去 12 个月发布了 8 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.3latest2026/11/114 天前
0.2.22026/11/0114 天前
0.2.12026/11/0115 天前
0.2.02026/10/121 个月前
0.1.32026/10/121 个月前
0.1.22026/10/111 个月前

关于 @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 和提交记录判断。