跳转到内容
Strata
登录

文档地图

所有文档页面和章节汇于一页:全部指南、每个 CLI 命令、每个 MCP 工具和每个 frontmatter 模式,均可直接跳转。

需要机器可读的格式?同一份地图已发布为 docs-map.json。

页面

  • Strata 文档Strata 是一个 AI 驱动的文档编辑平台。上传 Markdown 或 HTML 文档，进行查看、评论和编辑，采用基于段落的文档模型，通过 MCP（模型上下文协议）实现精细的 AI 编辑。
  • 快速开始最快的方式是使用 Claude Code 插件。添加一次 Strata 市场，然后安装所需的插件即可。MCP 服务器和 Spaces 技能都会一并附带。
  • Claude Code 插件Strata 插件是连接 Claude Code 的最快方式。安装后会自动注册 Strata MCP 服务器并添加 Spaces 技能，研究、发布和审阅功能在安装完成的瞬间即可使用。CLI 为可选项，仅在需要将 Spaces 挂载为本地文件时使用。
  • 演示文稿在 Strata 中创建、编辑和演示幻灯片。你可以从空白演示文稿开始，让 Strata Agent 根据源文档起草，或导入 Markdown。
  • MCP 工具参考Strata 通过模型上下文协议提供 18 个工具，按组进行分类。默认情况下，仅启用核心工具。通过 X-Strata-Tool-Groups 头启用其他组。
  • CLI 安装Strata CLI 让你在 macOS 和 Linux 上以 Markdown 文件的形式将 Spaces 保存到本地磁盘。最简便的方式是 下载页面，它会自动识别你的操作系统；下方命令可从终端完成同样的安装。
  • CLI 命令参考全部 55 个 strata 命令的完整参考,直接从 CLI 本身生成。此处内容与 --help 的输出完全一致。
  • REST APIStrata 基于 OpenAPI 3.1 规范描述的 REST API 构建。大多数集成使用 MCP 服务器，而非直接调用 REST，但完整规范可供工具和自定义客户端使用。
  • 文档地图所有文档页面和章节汇于一页:全部指南、每个 CLI 命令、每个 MCP 工具和每个 frontmatter 模式,均可直接跳转。
  • 在 Strata 中高效完成任务逐步指导，帮助您编辑文档、审阅更改、制作演示文稿以及发布您的工作。
  • 使用代理编辑文档连接您的代理，将其指向 Strata 文档，并选择是直接编辑还是提出修改建议供您审阅。
  • 提出并审查建议的编辑选择文本，提出替换，并在Strata中接受或拒绝合作者和代理的建议。
  • 审阅带有评论的文档在Strata中为选定的文本附加反馈，通过线程回复，并在更改确定后解决讨论。
  • 检查并恢复文档历史比较过去的编辑，恢复以前的版本，或在Strata中撤销特定更改。
  • 与协作者共享文档邀请人员加入 Strata 文档，选择其访问级别，并区分协作与公开发布。
  • 为您的代理创建一个专注的 Space在 Space 中收集 Strata 文档，关联文件夹，并使该集合对您的代理可发现。
  • 将文档导入 Strata将 Markdown、HTML、DOCX、PDF 或 PPTX 导入为可编辑的 Strata 块，并检查转换备注。
  • 使用您的代理创建演示文稿使用 Strata 的代理交接功能创建演示文稿，然后在演示文稿视图中打开以查看和修订。
  • 编辑幻灯片和发言者笔记了解演示文稿和文档视图，选择幻灯片布局，并将发言者笔记与可见幻灯片内容分开。
  • 以演讲者笔记演示文稿打开 Strata 的演讲者视图，跟随您的笔记，并在演示期间显示观众窗口。
  • 更改演示文稿的主题在 Strata 中选择内置或公司主题，并了解导入主题副本和验证的工作原理。
  • 在幻灯片中添加可交互的可视化元素在 Strata 中使用 HTML 幻灯片，将其绑定到文档数据，并在共享或导出前检查其静态状态。
  • 导出或分享演示文稿发布 Strata 演示文稿，或将其导出为 PDF 或独立 HTML，然后检查受众将看到的内容。
  • 发布到主页使您的 Strata 主页公开，选择文档 URL，然后发布阅读版。
  • 更新或取消发布公共文档了解有待发布的更改，发布修订版，并从您的 Strata 个人资料中移除帖子。
  • 样式化已发布的文档使用 Strata 的博客设置来控制已发布页面的外观、摘要和目录。

指南章节

  • 从对话到幻灯片使用 strata-presentation，从对话中整理受众、目的以及一系列有依据的论点。设置样式前，先阅读原始资料和公司的设计系统。每张幻灯片使用一个标题，在视觉内容中展示证据，在章节普通正文中编写讲稿。通过 edit_document 保存后重新读取结果；检查可用的 HTML 预览，并说明渲染限制。
  • 文档语法在开头的 YAML 块中设置 presentation: true 即可启用默认值。presentation 映射仅接受 aspect（16:9、16:10、4:3）、transition（fade、none、slide）、form（slides、whole-deck）和 notes（presenter、none）。默认值为 16:9、fade、slides、presenter。YAML 上限为 16 KiB。主题不属于 frontmatter 设置。
  • 设计系统与公司主题查找并阅读公司设计系统，然后将其 CSS 复制到唯一的 css name=theme 围栏块中。若已知真实的文档 ULID 和十进制版本号，请同时记录 source 和 sourceVersion；来源信息必须包含两者。保留已有的 locked=true。复制内容保存在本地，解析时不会获取或刷新源文档。没有可用的公司主题时，从 strata-light 开始。
  • 共享与导出所有者和编辑者可以读取完整文档。查看者、评论者和仅能提出建议的用户收到的版本包含已接受的幻灯片标题和视觉内容，但移除了普通备注。请将私人讲稿放在视觉围栏块之外。notes: none 表示面板可见性，并非隐私设置。移除或禁用 presentation 设置会使文档恢复为普通文档，读者可能收到完整正文。
  • 导入现有演示文稿保留现有文件并检查格式。对于 UTF-8 Markdown，先测量字节数，再调用 edit_document，传入 action=presignUpload、contentLength，以及 documentId 或 title/folderId；使用返回的全部 requiredHeaders，通过 PUT 上传原始字节，然后以 uploadId 调用 finalizeUpload。完成后重新读取。将 HTML 演示文稿改编为 whole-deck Markdown 副本，并检查沙盒依赖及内部备注。Office 文件上传会将 PPTX/PDF/DOCX 转换为普通文档，不保证原始幻灯片的还原效果。不要通过 Markdown 上传流程发送这些二进制文件。 使用现有 documentId 会在 finalizeUpload 时替换全部内容；PUT 仅暂存字节。finalizeUpload 和 action=write 都不接受预期版本，因此替换可能覆盖协作者的更改，且不会报告版本冲突错误。优先使用小范围、唯一锚定的 edit 调用，并设置 replaceAll=false；它们只检查处理请求的任务所持有的副本，块级编辑还可能回退到结构重写。任何 MCP 正文写入路径都不保证在并发编辑时安全。如果演示文稿似乎正在被编辑，请告知用户，并协调暂停编辑或准备单独的副本。如果无法避免替换，请在最终确认前立即重新读取，将 documentVersion 与准备文件时使用的版本比较，若已变化则中止。版本未变只能缩小竞态窗口，不能消除它。
  • 验证与修复演示或导出前请运行验证。validate_presentation 检查布局、对比度、数据绑定、结构和主题，并保存截图。每次调用最多检查一种视口尺寸下的两张幻灯片；当 status 为 more 时，保持选择不变并使用 next 继续。每张幻灯片的每种视口尺寸消耗一次截图，同一计费周期内相同渲染键不会重复计费。查看结果，修正源内容，然后再次检查。
  • 保持演示文稿更新演示文稿自动刷新尚不可用。list_company_themes、get_company_theme 和演示刷新例程的 target/sourceRef/baseVersion 契约尚未实现。通过 find 和 read_document 复制主题，记录已验证的来源，并说明主题及复制的数据都是快照。本章节的存在并不意味着刷新例程已启用。仅在明确请求并审查修改后更新副本。
  • 博客设计在第一个 YAML 前置信息块中使用 blog: 映射来设计已发布的文章。外观面板编辑同一份文本，并保留其他键和注释。
  • 制作演示文稿打开工作区中的“演示文稿”。选择“新建演示文稿”并输入标题，或请 Strata Agent 创建。使用 AI 起草时，描述主题、受众和目的，选择篇幅、主题样式及源文档。开始前请确认预计点数和点数上限。
  • 代理 frontmatter代理定义是位于 /Agents 文件夹中的 Markdown 文档。YAML frontmatter 声明代理的身份、允许使用的工具列表以及对编排器的可见性；frontmatter 下方的正文是编排器原样转交给代理的系统提示。所有字段在保存时都会在服务器端进行校验。
  • 交互式 HTML 块标记为 html 的代码块会在 Strata 编辑器和导出的 PDF 中渲染为实时的沙箱预览——图表、示意图、3D 场景以及小型交互式组件，都以普通的围栏代码形式编写。
  • 提示词 frontmatter提示词模板是位于 /Prompts 文件夹中的 Markdown 文档。YAML frontmatter 声明名称、描述、参数以及对编排器的可见性；frontmatter 下方的正文即提示词模板——{{argument}} 占位符会在渲染时被替换。参数值由聊天输入栏的斜杠面板或 MCP prompts/get 请求收集。
  • 模板 frontmatter文档模板是模板文件夹中的 Markdown 文档。YAML frontmatter 声明模板的名称、带类型的变量和章节结构；frontmatter 下方的正文是可复用的内容。当通过模板库、MCP 的 createFromTemplate 操作或代理的 create_document_from_template 工具基于模板创建文档时，{{key}} 占位符会被替换。

CLI 命令

MCP 工具