SuperAPI AI 工具集

page-actions

智能体与模型

查看项目

更新于 10-15 21:41

技能介绍

用途:页面操作是渲染在页面标题上方或下方的按钮,让用户把当前页复制为 Markdown,或在 LLM(ChatGPT、Claude、Cursor 等)中打开该页。适用于配置 @farming-labs/docs 文档站点的内容操作按钮。

主要能力与用法:所有选项放在 docs.config.ts 的 pageActions 对象中。快速开始:pageActions: { copyMarkdown: { enabled: true }, openDocs: { enabled: true }, connectMcp: true, installSkills: true }。

position 控制按钮相对标题的位置,取值 "above-title" | "below-title",默认 "below-title";alignment 控制左对齐或右对齐,取值 "left" | "right",默认 "left"。

copyMarkdown 显示“Copy Markdown”按钮,把当前页内容以 Markdown 复制到剪贴板,类型为 boolean | { enabled: boolean },默认 false。

一键智能体设置:connectMcp 可复制原始端点、Claude Code、Cursor、VS Code 或 Codex 的设置;installSkills 会发现 /.well-known/agent-skills/index.json 并复制 Skills CLI 命令。两者均为可选启用,需保持对应的 mcp 与 agent.skills 界面开启。

openDocs 启用“Open in...”下拉,可为布尔或对象,默认 false;为 true 时内置提供方为 ChatGPT 和 Claude。providers 可自定义并覆盖默认列表,内置 id 有 "chatgpt"、"claude"、"cursor"、"gemini"、"copilot"、"github"。target 控制填入 {url} 的地址,取值 "markdown"(默认,公开 .md 路由)、"page"(渲染页 URL)、"source"(源 .mdx URL)、"github"(需 github 配置)。prompt 默认 "Read this documentation: {url}"。

URL 模板占位符:{prompt}、{url}、{pageUrl}、{markdownUrl}、{sourceUrl}、{mdxUrl}、{githubUrl};urlTemplate 仅用于自定义提供方或旧配置。{githubUrl} 需顶层 github 配置(如 github: { url: "https://github.com/owner/repo", directory: "website" })。

限制与边界:无 github 配置时 {githubUrl} 可能为空或回退,“Open in GitHub”可能不可用;自定义图标可传入 React 节点或 SVG 组件;旧式带 name 与 urlTemplate 的提供方仍可用,其 {url} 保持原页面 URL 行为,除非显式设置 target。资料未提供收费、价格与平台支持等更多信息。