@forumone/throughline

中文文档
2.7.1发布于 2026/11/11MITTypeScriptES Module构建来源已验证近 30 天下载 2213

通过行:为"活塞CMS"提供编辑平台. 出版、批准、审计、整合、电子邮件和工作,每个功能都可以通过MCP实现.

中文使用文档
文档目录3 节
  1. 里面的东西
  2. throughline()
  3. 安装

@ forumone/ 透线

通过有效载荷内容管理系统:在政策编审、核准、审计日志、编辑 报告、整合、电子邮件和背景工作,每个功能都可以在MCP上达到。 一通电话 登记套房;每个部分还生活在自己的子路径上.

来自0.x? 这个软件包是核心,插件合同,出版,工作流程,审计, 核准、组件、集成和电子邮件. 从 0.x 升级 将一个 0.x 站点移动到它上, 并带有导入的编码器 .

参考: docs/reference/throughline.md,每个插件都有一页.

里面的东西

子路径持有
(基层)assertEnvironment, (中文(简体) ), checkEnvValue, (中文(简体) ), hardenCoreCollections, (中文(简体) ), mcpApiKeyAccess, (中文(简体) ), withMeta, (中文(简体) ), auditContext,日志、公用事业和插件类型
/publishingpublishingPlugin出版部门, isDraftWrite、无障碍检查、重新鉴定和定期出版工作;见 出版
/editorialeditorialPlugin:内容健康,内容日历,"你的工作",命令调色板搜索,及其MCP工具
/approvalsapprovalsPlugin,签名动作链接, expireStaleApprovalsJob; 见 核准数
/auditauditPlugin, (中文(简体) ), getAuditWriter, (中文(简体) ), AUDIT_ACTIONS, (中文(简体) ), auditQueryPlugin 及其工具, auditEventEchoJob; 见 审计
/componentscomponentsPlugin: MCP 上显示的设计系统;见 组件
/integrationsintegrationsPlugin,注册,网页浏览集成,手动同步, healthcheckJob; 见 整合
/emailemailPlugin,重新发送客户端、批准通知及其模板;见 电子邮件
/jobsdefineJob,工作类型,故障处理者,以及 CoreEvents 模块增强;见 任务
/jobs/inngestinngestJobs, (中文(简体) ), createInngestClient, (中文(简体) ), resolveInngestEnv, (中文(简体) ), registrableInngestFunctions
/jobs/payloadpayloadJobs
/mediaBlob 客户端加载硬化和参考跟踪 : referencesPlugin, (中文(简体) ), findReferences,删除和垃圾保护
/fields外地工具包: slugField, (中文(简体) ), publishingFields, (中文(简体) ), revisedAtField, (中文(简体) ), unlistedField, (中文(简体) ), characterCountPlugin, (中文(简体) ), fieldsPlugin
/observabilityjobFailuresPlugin, (中文(简体) ), getJobFailureWriter, (中文(简体) ), createErrorReporter, (中文(简体) ), reportError, (中文(简体) ), buildRequestErrorReport
/testingdescribeAnonymousAccess, (中文(简体) ), checkAnonymousAccess: 测试站点的助手
/cache-tagscreateCacheTags用于前端阅读器
/linksmarkLinkTarget, (中文(简体) ), LINK_TARGET_KEY 财务报告和审定财务报表 linkTargetMarker。这是链接目标标记。 它不进口, 所以一个链接- 域帮助器, 客户端组件也可以进口
/client, (中文(简体) ), /rsc管理员的客户端和服务器组件, 在 Biveload 导入地图中命名
选项throughline migrate-imports,参见 从 0.x 升级· ; throughline-payload,参见 参考文献

throughline()

// payload.config.ts
import { mcpApiKeyAccess, throughline } from '@forumone/throughline'
import { inngestJobs } from '@forumone/throughline/jobs/inngest'

export const suite = throughline({
  jobs: inngestJobs(inngest), // or payloadJobs() from /jobs/payload
  collections: ['pages', 'posts'],
  publishing: { urls: { pages: (slug) => `/${slug}`, posts: (slug) => `/blog/${slug}` } },
  approvals: { groups, groupResolver },
  email: { resolveApprover, resolveRequester },
  integrations: {},
  healthcheck: { checks: [createPayloadReachableCheck()] },
})

export default buildConfig({
  // …
  plugins: [
    suite.plugin,
    mcpPlugin({
      mcp: { tools: suite.mcpTools },
      overrideApiKeyCollection: mcpApiKeyAccess(isAdmin),
    }),
  ],
})
// app/api/inngest/route.ts, on Inngest. On Payload Jobs, suite.plugin registers the jobs itself.
const jobs = inngestJobs(inngest, { onFailure: createTerminalFailureHandler({ payload }), payload })
export const { GET, POST, PUT } = serve({ client: inngest, functions: jobs.functions(suite.jobs) })
  • 它按照每个插件需要的顺序进行注册. 审计、工作失败和 check_slug 总是在。 每个其它插件在键出现时都会打开 .
  • 它让每个插件都有一个MCP收藏器. suite.mcpTools 这是什么 mcpPlugin 服务.
  • 共享值一次给出. approvals.collectionSlug 达到批准采集,电子邮件和到期工作. collections 达到出版,"你的作品"和预定出版. admin 除非插件本身另有说明.
  • suite.jobs 方案要求的每一项工作是: 重新验证( 给定 ) publishing.urls),计划出版及其支持,批准期满,审核回声,健康检查,三个批准电子邮件,以及每个整合的工作. 功能标识是登记在案的 0.x工厂.
  • 它的默认是每个网站手写的. 预定出版的刊物要经过出版程序。 核准链接与 APPROVAL_TOKEN_SECRET 反对 NEXT_PUBLIC_SERVER_URL健康检查失败记录于 job-failures。 。 。 .

理由是 1.0-throughline-call.md。每个插件仍然从它的子路径导出,用于一个用手电线连接它们的站点.

安装

pnpm add @forumone/throughline

payload@^3.89.0 是需要的对等方。 其余的都是可选的,每个只能由使用它的子路径所需要,没有一个被根所加载:

安装网站使用时
inngest/jobs/inngest: Inngest 上的作业
resend, (中文(简体) ), @react-email/components, (中文(简体) ), @react-email/render, (中文(简体) ), react/email,或 email 内 throughline()。发送电子邮件时已装入,所以缺失的邮件会这么说,并命名软件包
next, (中文(简体) ), react, (中文(简体) ), @payloadcms/ui, (中文(简体) ), @payloadcms/next/client 财务报告和审定财务报表 /rsc,该有效载荷的管理进口
@vercel/blob, (中文(简体) ), @payloadcms/plugin-cloud-storage/media客户端加载硬化
vitest/testing

src/peers.test.ts 检查表格: 静态导入, 从其它地方装入可选对等器失败 .

每一个选择,工作 suite.jobs 持有、审计日志、MCP认证、环境检查和 throughline-payload 弹箱在 参考文献。 。 。 .

版本与发布记录

@forumone/throughline 共发布 106 个版本,首次发布于 2026/10/03;过去 12 个月发布了 106 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.7.1latest2026/11/114 天前
2.7.1-next-ffd51b1next2026/11/0213 天前
2.7.1-next-4a4ebd52026/10/2719 天前
2.7.1-next-2fec9f62026/10/2620 天前
2.7.1-next-1eabdf72026/10/2126 天前
2.7.1-pr-332-911b986pr2026/10/2126 天前

关于 @forumone/throughline 的常见问题

@forumone/throughline 是什么?

通过行:为"活塞CMS"提供编辑平台. 出版、批准、审计、整合、电子邮件和工作,每个功能都可以通过MCP实现.

如何安装 @forumone/throughline?

在项目目录运行 npm install @forumone/throughline,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:payload(^3.89.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 throughline、throughline-payload,可以用 npx throughline 直接运行。

@forumone/throughline 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@forumone/throughline 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@forumone/throughline 可以商用吗?

@forumone/throughline 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@forumone/throughline 的下载量有多少?

根据 npm 官方下载统计,@forumone/throughline 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,213 次,日均约 74 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@forumone/throughline 还在维护吗?

最新版本 2.7.1 发布于 2026/11/11(4 天前);至今共发布 106 个版本,其中过去 12 个月发布了 106 个;首次发布于 2026/10/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。