跳至指南

Mind 与审核

Mind 与审核是 onemind 对团队 AI 指导进行版本管理和同行审核的地方。打开 Mind 浏览最近使用的 Mind 或选择 Project；提出变更前，先阅读生效内容、版本、关联 Project、文件和历史。

  1. Team 管理员可选择添加 Mind，按需选择 Project，并输入名称和内容。文件名会自动设为 [name].md。点击创建以创建 Mind；创建须经服务器确认，是管理操作。
  2. 修改已有 Mind 时，选择更新，会直接打开拉取请求页面：填写必填标题、可选详情，并通过侧面板编辑器查看文件列表。选择取消可放弃，选择保存可保留草稿，选择发送可提交审核。
  3. 提交不会改变已批准的 Mind。
  4. 当前管理员在通知中审核精确变更和检查结果。点击批准并发布会发布下一个不可变版本；拒绝保持生效版本不变。具有权限的管理员可以审核自己的提案。
  5. 查看历史，然后同步已批准版本。

Mind 更新支持的文件类型为 Markdown、JSON、YAML、TOML 和纯文本（仅限 UTF-8）。新 Mind 的内容上限为 8,000 个字符；更新附带的每个文件上限为 512 KiB。把文件上传到草稿不会批准或应用它。

若基础版本变化或检查失败，请保留草稿、阅读当前 Mind 并解决冲突后重新提交。删除 Mind 会发送审核请求，在批准前它仍然可见。已保存的草稿或待处理请求不等于已发布变更。团队任务进度和 AI 工具交互记录在 Matrix 任务中。

浏览和整理 Mind

侧边栏中的 Mind 区域是进入每个 Mind 的入口。最近使用的 Mind 显示在列表顶部；选择显示全部可查看团队中的所有 Mind，或选择收起折叠列表。在项目下选择一个 Project 可查看其中的 Mind；点击 Mind 名称即可打开其详情视图。

所有已登录的团队成员均可自定义侧边栏中 Project 和 Mind 的排列顺序。拖动行至目标位置，或聚焦到某行后按上下方向键进行移动。该顺序是每位用户的个人设置，已保存至服务器，不影响其他团队成员的视图。顺序保存成功后会显示确认提示；若打开时无法加载顺序，则显示服务器默认顺序。

在 Mind 详情视图中，可使用上一个 Mind 和下一个 Mind 箭头在各 Mind 之间切换，无需返回列表。

详情视图中的关于面板显示 Mind 的当前版本、状态（启用或等待提案）、最近更新日期、创建者和最后更新者、关联 Project 以及附件。文件预览仅支持文本（UTF-8）；二进制文件和过大的文件会显示备用提示。可使用区域切换按钮展开或折叠关于面板。在创建时设置的 Mind 目标也会显示在此处。

Team 套餐变更进行期间，所有 Mind 将暂时进入只读状态。关于面板会显示提示；更新和发送在套餐变更完成前不可用。

草稿与拉取请求

在已有 Mind 上选择更新会直接打开拉取请求页面。页面列出基础 Mind 文件及所有附件，显示基础版本，并提供必填标题和可选详情字段。可通过侧面板编辑器添加或删除 AI 工具链文件（技能、钩子、提示词、规则——JSON、YAML、TOML、Markdown 或纯文本，每个文件上限 512 KiB）。草稿不会自动保存；请主动选择保存以在不提交的情况下保留在本设备上。

若有草稿未完成就离开，会弹出离开此 Mind 提案？对话框——选择保存并离开可将草稿保留在本设备，或选择继续处理返回编辑器。返回同一 Mind 时，会弹出加载已保存的提案草稿？对话框，可从已保存的草稿中恢复文本和文件。选择加载提案可从上次中断处继续，或关闭对话框重新开始。

在发送前可以重命名 Markdown 文件（文件名必须保留 .md 或 .markdown 扩展名）。选择发送即可提交提案进行安全检查和审核。

若 Mind 处于只读状态、暂时不可用，或会话已过期，则无法发送；页面会针对每种情况显示具体提示。

更改 Mind 标题

更改 Mind 的显示标题与更改其内容是两个独立的审批流程。所有已登录的团队成员均可提出标题更改请求：在 Mind 详情视图中点击标题，输入新标题（1–160 个字符，不含控制字符），然后选择请求审批。系统会自动创建一个标题固定为更新 Mind 标题的拉取请求。

在管理员批准提案之前，当前标题保持不变。如果在编辑标题期间 Mind 发生了变化，会出现数据过期提示；请关闭并重新打开编辑器，使用最新版本后再重新提交。Mind 处于只读状态时，无法提交标题更改。

安全检查与冲突检查

提交拉取请求时，服务器会自动运行安全检查——这是一项 AI 驱动的审核，会在提案到达人工审核者之前生成发现项。安全检查在每次提交时自动运行，无需用户手动触发。

冲突检查是安全检查的结构性组件，将提案 Mind 与所有其他活跃 Mind 进行比对，并按三个严重等级报告发现项：

  • 阻断项 — 确定性冲突，会阻止批准。必须编辑或拒绝提案，审核才能继续。
  • 需审核 — 建议性发现，批准前需人员明确确认。
  • 重叠项 — 较低严重等级的发现，供参考。

每个发现项具有置信类型：确定（确定性）、启发式或语义。11 种发现类型为：重复身份、过期版本引用、权限或范围违规、无效分配、重复分配、受保护声明冲突、缺少版本引用、依赖循环、资源所有权冲突、矛盾指令和重复指导。每个发现项会向审核者显示稳定指纹、精确来源版本和受影响的组合上下文。

如存在建议性（需审核等级）发现，审核者必须勾选审核确认复选框——确认已审核所有建议性发现，并了解不会自动解决或更改任何 Mind 权限——之后批准并发布操作才可使用。

如需在提交前本地运行冲突检查，可使用 Mind Check CLI 命令。使用 onemind mind-check member 命令并带 --harness 参数检查工具链文件（每个最多 256 KiB）；使用 onemind mind-check manager 命令并带 --subject 参数检查主题 Mind 或包文件。当前版本中 Mind Check 仅产生警告，不会自行阻止同步。使用 --json 可以程序方式解析输出。完整参数列表请参阅 CLI 命令参考。

在通知中审核

管理员在通知中审核传入的拉取请求。每个请求显示精确的提案差异、安全检查发现项和冲突检查发现项。审批或拒绝步骤如下：

  1. 在侧边栏打开通知。
  2. 选择传入的 Mind 审核请求。
  3. 查看提案差异和所有冲突检查发现项。
  4. 如存在建议性（需审核等级）发现项，请勾选审核确认复选框以进行确认。
  5. 选择批准并发布以发布下一个不可变版本，或选择拒绝以保持生效版本不变。

具有权限的管理员可以审核并批准自己的提案。阻断等级的冲突检查发现项会阻止批准并发布操作；必须编辑提案或拒绝该拉取请求，才能提交一个干净的新版本。

如果提案经检查后已批准的 Mind 又发生了变化，批准并发布将无法再发布该提案。审核页面会说明提案已过期，提案作者或任意管理员可以选择在当前版本上重新提出。onemind 会在当前版本上创建一个新提案，保留相同的标题、详情、文件和作者，重新运行安全检查，并将旧提案标记为已被取代，附上指向新提案的链接。如果提案的修改与当前版本中的变更重叠，则不会替换任何内容：审核页面会将当前版本与提案对比显示，以便作者提交修正后的提案。如果当前版本已包含这些变更，请拒绝旧提案将其关闭。

通知中还会处理删除审核请求。删除请求的决策与内容变更请求是独立的；详见下方删除和恢复 Mind。

移动或复制 Mind

任何已登录的团队成员均可通过在侧边栏中将 Mind 行拖到目标 Project，将 Mind 移动或复制到另一个 Project。

  1. 在侧边栏中将 Mind 行拖到目标 Project。
  2. 选择复制以将 Mind 保留在源 Project，或选择移动以将其从源 Project 中移除。
  3. Mind Checker 会在请求发送前自动运行；完成注记会显示已检查的版本和哈希值。
  4. 若 Mind Checker 无法完成，则不会创建审批请求。
  5. 请求进入通知中的管理员审批队列。
  6. 管理员批准或拒绝变更；Mind 仅在批准后才会出现在目标 Project 中。

任何成员均可发起移动或复制请求，但只有管理员可以批准。移动 Mind 操作不会自动回滚；如需移回，需再次提交移动请求。

删除和恢复 Mind

删除 Mind 会向团队管理员发送审核请求；在管理员批准删除之前，Mind 仍然可见。如需提交删除请求，请在 Mind 操作菜单中选择删除并确认对话框。

管理员在通知中审核删除请求，选择批准删除或拒绝删除。批准后会隐藏该 Mind，但不会永久删除；其受治理的历史记录会保留以便恢复。

删除获批后，通知中会显示恢复选项。如需还原 Mind，选择恢复 Mind。若该 Mind 所属的 Project 也已删除，则必须先恢复 Project，再恢复 Mind。选择恢复项目可将 Project 及其 Mind 还原至 Mind 面板，同时不更改受治理的历史记录。恢复失败时会显示具体错误提示；请检查当前删除状态后重试。