编辑器设置分为四个部分：
外观 和聊天 仅对你生效。发布 对部署中的所有人都生效，并控制提交变更及将其转换为 pull request 时的处理方式。危险区域 包含可能丢弃未发布变更的操作。
你可以在设置面板中配置这些选项。打开编辑器工具栏中的
外观设置控制你工作时编辑器的显示方式。这些偏好仅对你生效。
当你需要更多水平空间来编辑宽内容或源文件时，启用 Fit editor to full width 。编辑器会将编辑画布扩展到整个宽度，而不是使用默认的 768px 列宽。
当你希望保持编辑器打开，同时在独立的浏览器标签页中查看渲染后的页面时，启用 Open live preview in new tab 。预览网站时，Mintlify 会在新标签页中打开渲染后的页面。
启用 Show all files 可显示点文件、代码、PDF 以及默认隐藏的其他文件。Mintlify 会在导航侧边栏中显示这些文件。你也可以在 macOS 上按 ⌘⇧. ，或在其他平台上按 Ctrl+Shift+. 来切换此偏好设置。
配置外观偏好设置：
点击编辑器工具栏中的
找到 Appearance 部分，或滚动到该部分。
打开或关闭偏好设置。
AI 指令是编辑器随你的请求一起发送给 AI 的持续生效指令。用它来固定你不想在每次提示中都重复的风格和语气规则，例如语气、术语或格式约定。
你的指令适用于：
对选中文本的 Edit with AI 操作，如改写、扩写或修正。
从编辑器中启动的 agent 会话 。
指令的作用范围是你的用户账号，因此每位团队成员维护各自的指令。
当你发现自己在提示中反复给出相同的指引时，就应该添加 AI 指令，例如：
强制使用第二人称或句首大写式的标题。
优先使用特定的产品名称或术语。
禁用营销用语或填充性短语。
要求使用特定组件，例如始终使用 <Note> 表示提示。
保持指令简短而具体。AI 会在每次请求时遵循它们，模糊或相互矛盾的规则会降低效果。
点击编辑器工具栏中的
在 AI instructions 字段中输入希望 AI 遵循的指令。
保存更改。
示例：
将该字段留空以移除你的指令。
发布设置按部署进行配置，对所有从编辑器发布的人都生效。它们控制 pull request 和提交的生成、打开和合并方式。
你需要拥有 Mintlify 部署的管理员权限才能更改发布设置。
启用此选项可将你的部署分支（通常是 main）在编辑器中设为只读。分支被锁定后：
对于查看部署分支的所有人，编辑器和源代码视图都变为只读。
docs.json 配置面板停止保存更改。导航编辑（添加页面、重新排序和拖放）会被隐藏。
横幅会提示贡献者先创建草稿分支再进行编辑。
你的部署分支仍与 Git 保持同步，因此从仓库推送仍会更新线上站点。锁定只影响在编辑器中所做的更改。
开启锁定会丢弃部署分支上所有未发布的编辑器更改，并强制将编辑器与你的 Git 仓库重新同步。在开启锁定之前，请先发布待处理的编辑，或将其移动到草稿分支。
在锁定开启期间，向部署分支推送的 Git 提交会覆盖编辑器的实时状态，因此该分支上任何进行中的编辑都会被最新的提交替换。
当你的团队希望 Git 继续作为线上站点的唯一可信来源，并让所有编辑器更改都通过从功能分支发起的 pull request 提交时，可使用此设置。
在部署分支被锁定时进行编辑，请使用顶栏中的分支选择器创建或切换到草稿分支。像其他编辑器分支一样，从你的草稿分支发起 pull request 即可发布这些更改。
Pull request 指令用于在 AI 生成 pull request 标题和描述时进行引导。每当编辑器代你打开 pull request 时都会应用，包括 Create pull request 和 Merge and publish 流程。
使用 pull request 指令来标准化审阅者看到的内容，例如：
必需的小节，如 Summary 和 Changes 。
链接到跟踪系统的描述模板。
对标题的语气或长度要求。
示例：
开启该选项后，编辑器会以草稿状态打开每个新的 pull request。在将草稿 pull request 标记为可审阅之前，无法将其合并。该功能在以下场景中很有用：
你的团队要求在 pull request 开放审批前先进行一次人工审阅。
你希望分享预览 URL，但不希望传递”已准备好合并”的信号。
你仍然可以在 Git 提供商中将 pull request 标记为可审阅。
选择在你点击 Merge and publish 时编辑器使用的合并方式：
Merge ：创建一个合并提交，保留分支的完整历史。Squash ：将分支上的所有提交合并为部署分支上的单个提交。Rebase ：将分支上的每个提交逐个重放到部署分支，不产生合并提交。
所选方式将作为默认值。如果你通过 API 或 Git 提供商的界面显式传入合并方式，那种方式将优先生效。
请让默认合并方式与 Git 提供商的分支保护设置一致。如果你的部署分支只允许 squash 合并，请将默认值设为 Squash ，以避免从编辑器合并失败。
编辑器设置面板中的 Danger zone 区域包含无法撤销的操作。点击编辑器工具栏中的 Danger zone 。
Reset editor 会强制编辑器丢弃其本地状态并从你的 Git 仓库重新同步。当编辑器与仓库出现同步问题时使用它 —— 例如，文件树为空，或者即使文件确实存在于你的部署分支上、线上站点也在正常构建，编辑器仍显示类似 Unable to find docs.json or mint.json 的错误。重置编辑器会丢弃任何尚未提交到 Git 的未发布更改。如果你有想要保留的待处理编辑，请先发布它们。
重置编辑器的步骤：
点击编辑器工具栏中的
滚动到 Danger zone 。
点击 Reset editor 并确认。
编辑器会重新加载并从你的仓库拉取最新状态。
Reset editor 操作位于编辑器的设置面板中，而不是控制台设置的 Danger zone 中。控制台的 Danger zone 仅用于删除部署 。
