Holarch

AI

AI

Holarch 中的每项 AI 功能、预览和审批的工作方式、AI 密钥以及使用哪个密钥、Individual 和 Team 方案包含的 AI、用量和限制、AI 权限,以及发送给提供商的内容。

使用方法 →

本页内容
  1. 概念
  2. 如何使用
    1. 何时使用及原因
    2. 设置 AI
    3. 使用 AI 工具
    4. 提问
    5. 附加参考文件
    6. 实例:收紧 EO-1 需求
    7. 提示和良好做法
    8. 与其他功能的关联方式
  3. ✦ AI 控件
    1. 在右键菜单中
    2. 针对多个所选条目
  4. 每项 AI 功能
  5. 预览和审批
  6. AI 密钥
    1. 提供商
    2. 您的密钥
    3. 组织密钥
    4. 使用哪个密钥
  7. 包含的 AI
  8. AI 设置
    1. AI 参考文件
  9. 使用情况和限制
    1. 成员限额
  10. AI 权限
  11. 通过云平台托管的 AI 使用 Holarch 的 AI 模型
  12. 使用您自己的密钥的 Kimi K3
  13. 使用您自己的密钥的 GLM 5.3
  14. 组织中的 Kimi K3 和 GLM 5.3
  15. 由 Kimi K3 为您的组织提供 AI
  16. 为某个安装关闭 AI
  17. 隐私:发送哪些内容
  18. 快捷键
  19. 消息
  20. 限制
  21. 相关页面

使用 AI 加快日常系统工程工作。它可以:

  • 回答有关已打开项目的问题;
  • 改写和生成需求;
  • 提出功能和流程;
  • 建议追溯关联;
  • 起草风险、测试用例、权衡研究准则和决策理由;
  • 绘制剪贴画。

AI 是可选的。Holarch 中的其他所有功能无需 AI 即可使用。

每项 AI 更改都会先以预览形式显示。在您确认之前,模型中不会有任何更改。一次撤销(⌘Z / Ctrl+Z)即可撤回整个更改。

概念

词项含义
✦ AI 控件顶栏中唯一的 AI 控件。✦ AI 打开“询问 AI”;其 ▾ 列出当前页面的 AI 工具,然后是 AI 设置…。
询问 AI一个聊天面板,回答有关已打开项目和 Holarch 的问题。
AI 工具特定于页面的操作,例如添加可度量的标准…或评审关联。
预览在应用任何内容之前显示 AI 提议的对话框:当前文本、建议的文本和逐词更改,或可勾选的条目列表。
AI 密钥来自 AI 服务商的 API 密钥。Holarch 将其加密存储在服务器上,并且不会再次显示。目前不支持其他提供商;参见 Holarch 如何选择 AI 模型。
正在使用的密钥服务器用于处理您的请求的密钥:您自己的、您组织的,或包含的 AI(Holarch 的密钥)。
令牌AI 提供商计数的单位。一个令牌约为四分之三个英文单词。每个请求都会统计发送的令牌和返回的令牌。
每月限额由密钥所有者为该密钥设置的每月令牌上限。
成员限额由组织(或自托管服务器)的管理员设置的、对其付费的 AI 的每人每月上限:包括适用于所有人的默认值和针对个人的自定义限额。
AI 参考文件您附加到项目的文件,其文本会添加到某些 AI 提示中。

如何使用

何时使用及原因

AI 在生命周期的每个阶段都能提供帮助,但它永远不能替代评审:

  • 需求:将含糊的陈述变为单一、可度量的“shall”陈述;拆分复合需求;起草理由;生成子需求;判断 Correct、Feasible 和 Necessary,并找出规则遗漏的含糊或不可验证的措辞(Unambiguous、Verifiable)。
  • 行为:从需求集中提取功能并建议功能流(在需求之后、分配之前)。
  • 可追溯性:在可追溯性矩阵中建议缺失的关联并标记可疑的关联。
  • 验证:为需求起草测试用例。
  • 风险和决策:为条目起草风险,根据需求和 MOE 建议权衡研究准则,并起草决策理由。
  • 文档和白板:汇总或翻译文档、改写富文本,以及将便笺转换为需求。
  • 问题:询问有关项目的问题(“哪些需求没有验证它们的测试用例?”)或有关 Holarch 的问题(“如何从 CSV 文件导入需求?”)。

设置 AI

在 Individual 和 Team 方案上,AI 功能无需密钥即可使用,这些方案每月包含一定数量的 AI 请求(参见包含的 AI)。如需更多用量,请添加您自己的 AI 服务商的 API 密钥,或使用您组织的密钥。Free 方案没有包含的 AI,也不能使用自己的密钥,但使用学术邮箱地址的账户和活跃班级组织的成员除外。

  1. 在 AI 服务商的控制台中创建 API 密钥。
  2. 在 Holarch 中,打开 ✦ AI ▾ → AI 设置…。(或点击您的姓名缩写 → 账户设置,然后滚动到 AI 密钥。)
  3. 点击+ 添加密钥。
  4. 提供商显示 AI 服务商 API,这是目前唯一提供的提供商。
  5. 将密钥粘贴到 API 密钥中。
  6. 可选:输入至少为 1,000 的每月限额(令牌)。留空表示无限制。
  7. 点击测试并保存。
  8. 如果打开了确认您的密码,请输入您的密码。该验证在 10 分钟内有效。

    您会看到提示消息“已添加 AI 密钥(AI 服务商 API,…abcd)。”Holarch 会先发送一个简短的测试请求。如果测试失败,密钥不会被保存,消息会说明原因。

  9. 检查正在使用的密钥。

    您会看到您的密钥:AI 服务商 API (…abcd)。

使用 AI 工具

对所选条目运行特定于页面的 AI 工具,审查其提议,然后应用。

  1. 打开页面并选择条目,例如文档中的一条需求。
  2. 点击顶栏中 ✦ AI 旁边的 ▾。(或按 ⌘K / Ctrl+K 并输入工具名称。)
  3. 选择工具,例如添加可度量的标准…。

    您会看到一个忙碌对话框“正在询问 <provider>…”,并带有计时器。取消会停止请求。

  4. 审查预览。

    预览的影响列表显示追溯到 AI 将要更改的条目的内容:需求、测试、接口、文档、图以及其他项目中的条目,每项标记为受影响或检查(影响)。点击其标题可将其展开,点击一行可在不关闭预览的情况下查看该条目。

  5. 在对话框允许的地方编辑建议。
  6. 取消勾选您不需要的任何内容。
  7. 点击应用按钮,例如应用、添加所选项、创建测试用例或应用所选项。

    您会看到一条简短的提示消息,例如“已应用添加可度量的标准”。一次撤销即可撤回整个更改。

提问

“询问 AI”回答有关已打开项目和 Holarch 的问题。它不更改任何内容。

  1. 点击顶栏中的 ✦ AI。(或按 ⌘K / Ctrl+K 并选择询问 AI…。)
  2. 输入问题,或点击其中一个示例。
  3. 按 Enter 发送。Shift+Enter 则添加新行。

    您会在面板中看到回答。条目名称和帮助主题是链接。有些回答包含一个按钮,可打开回答所涉及的页面。回答中的代码显示在可横向滚动的框中。

  4. 根据需要提出后续问题。最近的对话会随每个问题一起发送。

在 app.holarch.app 上,操作类问题还会根据 holarch.app 上的指南、文章、培训、视频文字稿和更新日志来回答。指向这些页面的链接会在新标签页中打开。

“询问 AI”使用您书写时所用的语言回答。帮助和文档为英文,因此回答中的菜单、按钮和字段名称会按英文界面显示。“询问 AI”能为任何语言的问题找到帮助主题和文档章节;当回答不是英文时,它会用回答的语言将每个帮助和文档链接标注为英文页面,例如 (auf Englisch) 或 (英語)。

“询问 AI”从项目中读取的内容:

  • 操作和功能类问题(“如何导入 CSV 文件?”、“Holarch 能导出到 Word 吗?”):不读取项目数据。“询问 AI”根据帮助、文档和 Holarch 功能列表回答。
  • 小型项目:每个条目和关系,随每个问题完整发送。
  • 较大的项目:整个项目的摘要(按类统计的条目、其 Status、Priority 和其他列表值、标签、按类型统计的关系,以及文档和图的名称)。之后“询问 AI”只分步读取问题所需的内容:按词语搜索条目(纯文本匹配,与搜索相同),读取单个条目及其关系,并按类、属性值、标签、文本或具有或缺少的关系(例如没有 verified by 的需求)对条目进行计数或列出。使用 Holarch 的默认模型时,可能会先用快速模型进行一个快速的分类步骤;它属于同一个问题。当列表被截断时,回答下方的一行会说明其依据,例如“Based on 200 of 9,812 items with class Requirement, without verified by (of 100,000 items) plus the project summary.”需要过多文本的问题会停止并说明原因;请提出范围更窄的问题。
  • 要在大型项目中缩小问题范围,请使用条目中出现的词语或编号,先打开该条目,或选择这些条目并右键点击 → ✦ 就这些条目询问 AI。

面板按钮:

  • 展开按钮使面板占满窗口的大部分。再次按下可恢复大小。
  • ⚙ 打开 AI 设置。
  • ⟲ 清除对话。
  • × 关闭面板。

更改面板的大小:

  • 拖动面板的左边缘可使其变宽或变窄。
  • 使用键盘:按 Tab 移到边缘,然后按 ←(变宽)或 →(变窄)。按住 Shift 可加大步长。Home 设为最小尺寸,End 设为最大尺寸。
  • 双击边缘可恢复默认大小。

此浏览器会保留您选择的大小。在窄窗口中,面板会占满宽度。

附加参考文件

参考文件可向 AI 提示添加背景材料,例如标准或工作说明书。每个项目有一个文件列表,每个文件都有自己的在 AI 中使用开关。

  1. 打开 ✦ AI ▾ → AI 设置…。
  2. 在供 AI 使用的项目参考文件下,点击+ 文件并选择一个文件。

    您会看到该文件及其大小,并且在 AI 中使用已勾选。列表下方的一行显示有多少文件在使用中以及它们添加了多少文本,例如“使用中:3 个文件中的 2 个,48k 个字符”。

  3. 对更多文件重复此操作。
  4. 取消勾选文件上的在 AI 中使用,可将其保留在列表中但不发送;或点击 × 将其移除。
  5. 点击保存。

参考文件保留在此浏览器中,不与其他成员共享。早期版本保存在包中的文件会出现在这一个列表中;之前处于活动状态的包中的文件处于使用中。有关文件类型和限制,请参见 AI 参考文件。

实例:收紧 EO-1 需求

CubeSat EO-1 演示中有三条评审者会拒绝的 Draft 需求:

  • 2.5 Safe Mode Recovery:“The spacecraft should recover from safe mode quickly and resume imaging as appropriate”
  • 3.5 Battery Thermal Control:“The thermal design shall keep the battery warm enough (TBD).”
  • 6.4 Operator Interface:“The operator interface shall be user friendly and/or easy to use.”

用 AI 修正它们:

  1. 创建演示:管理项目 → 项目文件 ▾ → 新建演示项目。
  2. 打开 EO-1 System Requirements Specification。
  3. 选择 2.5 Safe Mode Recovery。
  4. 选择 ✦ AI ▾ → 添加可度量的标准…。

    您会看到当前、更改和建议(应用前可编辑)。建议内容例如:“The spacecraft shall exit safe mode and resume imaging within 24 hours of the fault being cleared.”说明中指出 24 小时是一个建议值。

  5. 如果您的任务分析得出不同的结论,请更改该值。
  6. 点击应用。
  7. 选择 6.4 Operator Interface,然后选择拆分复合需求…。

    您会看到每条单一需求。第 1 项替换 6.4;其他项添加在其后。

  8. 点击拆分需求。
  9. 选择 3.5,然后选择起草理由…。
  10. 审查理由并点击应用。
  11. 打开需要与需求 → 质量。
  12. 选择 ✦ AI ▾ → 用 AI 检查(n 条需求)…。

    您会看到针对每条需求判断的 Correct、Feasible、Necessary、Unambiguous 和 Verifiable,并附有原因。判定结果下方的复选框说明应用后会更改什么(“No → Yes”、“添加一个发现项”);“无更改”表示存储的值已经一致。改写和已审批的需求初始为未勾选。按钮上方的一行统计将要应用的内容,例如“将 7 个值和 2 项改写应用到 5 条需求。”

  13. 点击应用所选项。
  14. 返回文档,选择 2.5,然后选择生成测试用例…。
  15. 审查步骤(按顺序)、设置、预期结果和验证方法。
  16. 点击创建测试用例。

    您会看到新的测试用例,已关联到 2.5。

每项已应用的更改都可通过一次撤销撤回。按 ⌘Z / Ctrl+Z 可撤回其中任何一项。

提示和良好做法

  • 将 AI 输出视为草稿。在应用之前,对照您的分析检查数字、单位和假设。AI 提议的值会在其说明中标出。
  • 先选择。只有选中需求(或其他陈述)时,需求工具才会出现在 ▾ 中。
  • 勾选即表示应用。阅读每个预览行。对 Approved、已纳入基线或已锁定条目的更改、关联移除以及包含网址的建议,初始为未勾选并突出显示;请检查后再勾选。
  • 留意输入横幅。当输入包含来自导入文件的文本、其他人的更改、AI 参考文件或隐藏文本时,预览会显示一个横幅。请仔细检查这些建议。
  • 使使用中的文件保持精简。参考文件会添加到许多提示中,并消耗更多令牌。对当前任务不需要的文件,请取消勾选在 AI 中使用。
  • 为您与组织共享的密钥设置每月限额。

常见错误:

  • ✦ AI 打开“没有 AI 密钥”。没有可用的密钥。点击打开 AI 密钥并添加一个,或请组织管理员提供组织密钥。
  • ✦ AI 显示为灰色。指向它可查看原因:
    • “仅查看:AI 工具需要编辑权限”:您只有查看权限。
    • “此组织的管理员已关闭 AI。”:组织关闭了 AI。
  • ▾ 中缺少页面的工具。请选择该工具所针对的条目,或打开提供该工具的页面。参见每项 AI 功能。
  • “勾选该框以将更改应用到此条目。”目标为 Approved、已纳入基线或已锁定。如果您确实要进行该更改,请勾选确认框。
  • 密钥测试失败。请检查密钥是否完整、有效且有余额。

与其他功能的关联方式

  • AI 更改通过正常的模型进行:它们可撤销、会被保存、与协作者实时共享,并记录在版本历史中。
  • 需求工具为其他功能提供输入:
    • 质量页面:带有“AI:…”原因的手动 Yes/No 值;
    • 可追溯性:生成的需求追溯到其目标;
    • 验证:带有验证方法标签的生成测试用例;
    • 风险登记册:与其原因相关的生成风险。
  • “询问 AI”使用帮助主题和正在运行的应用的功能列表,因此会说明某项功能何时不可用。
  • 组织管理员控制其项目的 AI(参见管理)。

✦ AI 控件

该控件位于每个项目页面的顶栏中。

  • ✦ AI 打开“询问 AI”。
  • ▾ 列出当前页面的 AI 工具,然后是 AI 设置…。

没有 AI 工具的页面只显示 ✦ AI。在窄窗口中,该控件显示为闪光图标和 ▾。相同的工具也位于 ⌘K / Ctrl+K 中的此页面的 AI 工具下。

出现以下任一情况时,该控件处于关闭状态。其工具提示会说明原因。

  • 您只有查看权限:“仅查看:AI 工具需要编辑权限”;
  • 项目所在的组织关闭了 AI:“此组织的管理员已关闭 AI。”
  • 安装的管理员关闭了 AI:“此安装已关闭 AI。”(参见为某个安装关闭 AI)。

没有密钥时,该控件保持开启:✦ AI 会打开没有 AI 密钥(“请在账户 → AI 密钥中添加 AI 服务商的 API 密钥。”)并带有打开 AI 密钥,▾ 中的 AI 工具也会打开同一个对话框。

在右键菜单中

数据库行、文档条目或大纲条目,以及质量、TBD/TBR 或待审查的关联行的右键菜单,开头最多有三个建议操作(先列出非 AI 操作,例如检查链接…或解决 TBD…),每个操作的原因显示在右侧。它们来自实体的状态,无需调用 AI,因此菜单会立即打开:修正未通过的质量准则的改写(例如✦ 添加可度量的标准…,“未通过:Unambiguous”)、对没有 verified by 关系的需求的✦ 生成测试用例…、对没有子需求的需求的✦ 生成子需求…,以及对子 Action 没有流程的 Action 的✦ 建议流程…。没有适用的操作时,菜单会建议✦ 用 AI 检查…(需求)和✦ 就此询问 AI…,后者会以该实体为上下文打开“询问 AI”并预先填好问题开头。✦ 更多 AI ▸列出该实体的所有 AI 操作。当 ✦ AI 控件关闭时,AI 部分为一个变暗的行:✦ AI 操作:后跟相同的原因。规则和完整列表见模型和数据库。

针对多个所选条目

选择多行或多个文档条目(⌘ / Ctrl-点击或 ⇧ / Shift-点击;在 Windows 和 Linux 上为 Ctrl-点击),然后右键点击其中一个,或使用数据库批量操作栏开头的 ✦ AI ▾。菜单的 ✦ 组作用于整个所选内容;每个标签显示其适用的条目数,不适用于任何所选条目的操作会变暗并显示原因(例如“未选择需求”)。

Action功能预览
✦ 用 AI 检查(n 条需求)…审查所选需求,每个请求 20 条。每项 AI 功能中所述的审查表。
✦ 改写 (n) ▸对所选需求和陈述运行一个改写工具(每个工具都标有计数:改写得更清晰、添加可度量的标准(仅限需求)、简化、拆分复合需求、起草理由、建议名称),每个请求 10 条(拆分为 5 条)。一个列表,每个条目一个复选框,并显示每项更改的逐词差异。拆分会在条目下显示其各部分;第 1 部分替换该条目,其他部分添加在其后。没有建议更改的条目显示“未建议更改”。
✦ 生成测试用例 (n)…为每条所选需求编写一个测试用例,每个请求 10 条。一个列表,每条需求一个复选框:测试用例名称(可编辑)、方法、步骤、设置和预期结果。已有 verified by 测试用例的需求会被排除,除非您勾选包括已验证的 (n)。每个创建的测试用例状态为 Not Run,并 verifies 其需求;其方法会作为标签添加到需求上(锁定、已审批或已纳入基线的需求除外)。
✦ 就这些条目询问 AI (n)…以所选条目为上下文打开“询问 AI”,问题以“About these n items: ”开头。仅回答。最多发送 50 个条目;面板会说明发送了多少个。
✦ 建议追溯 (n)…在所选条目之间提出缺失的关系,只使用架构允许在其类之间存在的关系(satisfied by、verified by、traced to、decomposed by、specified by、performed by)。最多 150 个条目。一个建议关系列表,每项附有原因。指向锁定、已审批或已纳入基线的条目的关联初始为未勾选。

应用所选项会将勾选的行作为一个撤销步骤应用。锁定、已审批和已纳入基线的条目,以及包含网址的建议,初始为未勾选。

最多同时运行 3 个请求,因此 50 条需求大约只需三分之一的时间。超过 50 个条目时会先请求确认,因为运行需要多个请求。进度对话框显示已完成的条目数和批次数;取消会停止所有请求,预览会显示目前为止的结果。如果某个请求失败,预览会显示其他结果,并列出未处理的条目(例如“第 21–40 项未审查”)。

每项 AI 功能

位置功能应用前您需要审查的内容
顶栏,每个项目页面询问 AI仅回答;不更改任何内容。
文档、数据库和条目视图,选中需求时(▾)改写得更清晰…、添加可度量的标准…、简化…、起草理由…、建议名称…当前、更改(逐词差异)、建议(应用前可编辑)以及 AI 的说明。应用。
同上,选中需求或陈述时拆分复合需求…每个部分带名称和文本;第 1 项替换原始条目,其余项添加在其后。拆分需求。不需要拆分的陈述显示无可拆分内容。
同上,选中需求时用 AI 检查(此需求)…Correct、Feasible、Necessary、Unambiguous 和 Verifiable,附原因和可选的改写。Unambiguous 和 Verifiable 只报告规则检查遗漏的内容;被接受的 No 会作为 AI 发现项列在质量页面上。只有在值会更改的地方才有复选框,每个都标明其效果;改写初始为未勾选。应用所选项。
同上,选中陈述或需求时生成子需求…模式(子项(向下一级)或同级项(同一级))、数量(1–20)、上下文;然后是可编辑的卡片。添加所选项。
同上,选中需求时生成测试用例…编号、名称、步骤(按顺序)、设置、预期结果、验证方法(为需求添加标签)。创建测试用例。
同上,选中任意条目时生成风险…最多选择 3 个候选风险(下一步:详细信息),然后编辑编号、名称、类别(项目的风险类别)、描述、后果描述、后果 % 和概率 %。添加所选风险;每个风险都与该条目相关(caused by)。
文档和条目视图(▾)生成需求…使用目标条目、上下文、父需求(1–20)、每个父项的子项数(0–10)、需求类型(Environmental、Functional、Interface、Performance、Reliability、Safety、Verification)、指导、将新需求与目标建立关系 (traced to);然后是可编辑的卡片。添加所选项(创建为 Draft)。
文档(▾)汇总文档…部分、详细程度(低、中或高,约 1–3 段)、语言;然后是评审要点,再然后是摘要预览。保存为文档开头的陈述 Document Summary(S.0)。
文档(▾)翻译文档…语言(18 种语言或自定义…)、新的编号、名称和描述;然后是并排预览。另存为新文档会创建一个副本;原文档保持不变。
文档(▾)用 AI 检查(n 条需求)…同上,针对文档中的每条需求。
文档编写 ▾✦ 生成子需求…、✦ 生成需求…、✦ 生成风险…、✦ 生成测试用例…、✦ 摘要…、✦ 翻译…同上。
文档拆分对话框✦ 提出拆分方案填写拆分行;由您编辑并应用。
质量(▾)用 AI 检查(n 条需求)…同上,针对列表中的需求。
主页(▾)✦ 撰写项目摘要在项目摘要中显示摘要(自最新基线以来的更改、面临风险的内容、接下来的三项行动,均带链接)。保留在主页上会将其保留在项目摘要面板中,在那里重新撰写会替换它。
导入,映射步骤(▾)建议映射建议的映射:每个更改的列一个已勾选的行,并附原因。应用已勾选项。
贡献(▾)✦ 汇总此小组的工作…、✦ 汇总此成员的工作…已记录活动的摘要;模型中不会有任何更改。参见贡献。
功能分析(▾,当集合中有功能时)使用 AI 评审和扩展功能…✦ 评审和扩展功能:先是发现项,然后是现有功能(保留、已更改)以及新功能(新增,编号接在最大编号之后);建议的重命名、拆分、合并和移动(建议)只有勾选后才会应用。一次撤销即可全部撤回。
功能分析(▾)使用 AI 提取功能…✦ AI 提出的功能:每条需求对应的功能,应用前可编辑。
功能分析(▾)使用 AI 建议流程…✦ AI 建议的流程:提议的流程和理由。替换受保护的流程需要明确确认。
可追溯性矩阵(▾)评审关联关联评审列表:缺失的关联(单元格中的 +)和可疑的现有关联(单元格中的 ?),每项附有置信度和原因。在列表中勾选或点击已标记的单元格;应用 N 项更改会建立和解除关联,一次撤销即可全部撤回。置信度低于 50 % 的提议以及涉及受保护条目的提议初始为未勾选。
权衡研究(▾)根据需求和 MOE 建议准则…、起草决策理由…提议的准则;记录对话框中的理由草稿(那里也有起草按钮)。
Risk 图工具栏(也在 ▾ 中),以及矩阵单元格面板中的✦ 生成风险✦ 生成风险目标实体、上下文以及项目风险类别中的风险数量(1–10,默认为 5),针对根或所选单元格;然后是查看建议的风险,再然后是创建所选项。
白板(▾,或选中便笺时的选择工具栏)收集需求…勾选使用 AI 起草“shall”陈述,添加可选的指导,点击起草陈述;编辑每个名称和陈述。创建需求。
白板剪贴画面板✦ 使用 AI 生成…描述、样式、配色方案、视图、变体(1–8);选择一个变体,然后选择添加到库或添加并插入。还可使用重新生成、优化…和停止。
富文本编辑器 ✦ 按钮改进措辞、简化、修正拼写和语法、缩短、添加详细信息、补全句子、以某种语气改写…、翻译…、翻译全文…、使用 AI 写作…当前、建议、更改;重试、放弃或替换。使用 AI 写作…会要求输入提示词和语气,然后是创建预览和插入。

以某种语气改写…和使用 AI 写作…的语气:学术、果断、随意、自信、建设性、共情、激动人心、流畅、正式、友好、鼓舞人心、专业。

有关特定页面的详细信息,请参见帮助:功能分析、可追溯性矩阵、权衡研究、风险登记册、白板和白板剪贴画。

预览和审批

  • 在您确认之前不会应用任何内容。关闭或取消预览不会更改任何内容。
  • 一次撤销即可全部撤回。每项已应用的 AI 更改无论涉及多少条目,都可通过一次撤销撤回。
  • 受保护条目需要明确确认。某些更改会突出显示且初始为未勾选:
    • 对 Approved、已纳入基线(在文档基线中)或已锁定条目的更改;
    • 关联移除(功能分析中的重新分配);
    • 包含网址的建议。

      单个此类更改会显示一个框,例如“仍然应用此更改(…)”。

  • 输入横幅。当输入包含来自导入文件的文本、其他人的更改、AI 参考文件或隐藏文本时,预览会显示一个横幅。
  • 经过检查的回复。每个回复在您看到之前都会经过检查。格式错误、文本过多或包含请求中没有的 id 的回复会被拒绝(“The AI response was rejected…”)。不会有任何更改。文本会根据其去向进行清理:不含脚本、图像、框架或指向其他网站的链接。
  • 需求文本遵循质量检查。编写需求文本的请求(改写得更清晰、添加可度量的标准、简化、拆分、生成需求和生成子需求、AI 需求检查中的改写、文档中的 AI 拆分以及白板上的收集需求)会列出质量检查的措辞规则及其词表。仍违反规则的建议会连同检查器的发现项一起退回一次,并显示更好的回复。在每条建议的陈述下方,预览会显示检查器的结果:“✔ 通过质量检查器的措辞规则。”或带有发现项的“质量检查器:…”;它会随您的编辑而更新。需要关联或评审者的规则(验证测试用例、重复项、Correct、Feasible)不属于此检查。
  • “询问 AI”显示文本。只有指向 Holarch 页面和帮助主题的链接可点击;网址保持为纯文本。

有关如何将项目文本与指令分开,请参见AI 如何处理不受信任的内容。

AI 密钥

提供商

提供商字段
AI 服务商 APIAPI 密钥
Kimi APIAPI 密钥、区域(请参阅使用您自己的密钥的 Kimi K3)
GLM APIAPI 密钥(请参阅使用您自己的密钥的 GLM 5.3)

Holarch 的 AI 使用 Holarch 测试选定的模型;在托管服务上,来自中国大陆、香港、澳门和台湾的请求使用 GLM 5.3(中国大陆的 AI)。Kimi K3 和 GLM 5.3 是可以开启的选项。在组织中,它们保持关闭,直到组织管理员分别开启(请参阅组织中的 Kimi K3 和 GLM 5.3)。

自托管安装还可以提供 云平台托管的 AI(您的 AWS 账户)(参见通过云平台托管的 AI 使用 Holarch 的 AI 模型)。app.holarch.app 上的托管服务不提供。

多个密钥:标记为首选的密钥响应每个请求。另一个密钥旁的使用此密钥会切换到该密钥;当列表中已有密钥时,添加密钥会询问新密钥是否用于 AI 请求(将此密钥用于 AI 请求,默认开启)。

目前不支持 OpenAI、Gemini 和 Azure OpenAI 密钥(原因)。之前为其中某一个添加的密钥会保留在列表中,并标记为“目前不支持 Name 密钥。您的密钥已保留;如果不再需要,请将其删除。”它不会被使用;移除会将其删除。

每个密钥表单都有每月限额(令牌)(留空表示无限制;最少 1,000,最多 10,000,000,000)。

您的密钥

您的密钥在账户设置 → AI 密钥和 AI 设置中列出您的密钥。每个密钥显示:

  • 提供商,当您有多个提供商的密钥时标记为首选。
  • 密钥:最后 4 个字符。当提供商拒绝该密钥时,显示上次使用时被拒绝。
  • 添加者和上次使用。
  • 本月:已用令牌数、限额(“共”)以及已达到限额。

按钮:

  • 测试会发送一个简短请求:“✓ 可用(1.2 秒)”或“✕”及原因。
  • 移除会询问“要移除尾号为 … 的 … 密钥吗?之后您的请求将使用您组织的密钥(如果有),或您方案中包含的 AI。”并需要最近的密码验证。提示消息:“已移除 AI 密钥。”

每个提供商只能有一个密钥。为已有密钥的提供商添加密钥会替换原密钥。您的第一个密钥为首选密钥。

没有密钥时:“您没有自己的密钥。”

组织密钥

组织密钥使成员无需自己的密钥即可使用 AI。组织管理员在账户页面的组织 → 组织密钥下添加、测试和移除这些密钥。表单与您自己的密钥相同。页面注明:“… 中没有自己密钥的成员使用此密钥。”

成员只能看到存在哪些组织密钥:“组织密钥:AI 服务商 API (…abcd)。在您没有自己的密钥时使用。”没有组织密钥时,他们会看到“没有组织密钥。没有自己密钥的成员使用其方案中包含的 AI。”

本月按成员统计的使用情况列出成员、请求、令牌、费用(估算)和限额,并有一行总计,位于每位成员每月限额的控件下方(请参阅成员限额)。

使用哪个密钥

服务器按以下顺序为每个请求选择一个密钥:

  1. 您自己的密钥,如果您添加了。
  2. 您组织的密钥。在属于您所在组织的项目中,使用该组织的密钥。在此类项目之外,当您只属于一个组织时,使用该组织的密钥。关闭了 AI 的组织不会将其密钥提供给任何人。
  3. 包含的 AI:Holarch 自己的密钥,附带本月包含的请求数(见下文)。
  4. 无:AI 功能关闭。

在 Free 方案上,第 1 步和第 3 步只适用于使用学术邮箱地址的账户和活跃班级组织的成员。其他 Free 账户不能添加自己的密钥,AI 功能会要求他们选择方案(参见包含的 AI)。正在使用的密钥显示“无。添加密钥之前,AI 功能处于关闭状态。”

AI 设置和账户页面中的正在使用的密钥会显示结果,例如您的密钥:AI 服务商 API (…abcd)、SYSE 682 的组织密钥:AI 服务商 API (…wxyz) 或包含的 AI:快速模型。

包含的 AI

Individual 和 Team 方案每月包含一定数量的 AI 请求,由 Holarch 的 AI 通过 Holarch 自己的 AI 服务商密钥回答。无需密钥。来自中国大陆、香港、澳门和台湾的请求则由 GLM 5.3 通过 Holarch 自己的 Z.ai 密钥回答,请求数量相同(中国大陆的 AI)。

方案包含的 AI
Free无;也不能使用您自己的密钥
使用学术邮箱地址的 Free,或作为活跃班级组织的成员每月最多 75 个 AI 请求,快速模型;可以添加您自己的密钥
Individual每月最多 150 个 AI 请求,标准模型
Team每个席位每月最多 300 个 AI 请求,标准模型;繁重任务使用高级模型(一个请求计为 2 个)
  • Free 方案上的 AI:AI 功能会显示“AI 随 Individual 和 Team 方案提供。开始 30 天免费 Individual 试用,或选择方案。”,并带有开始试用和选择方案…。如果您已经用过试用:“AI 随 Individual 和 Team 方案提供。请在账户设置 → 方案和账单中选择方案。”在 Individual 试用期间,适用 Individual 方案包含的 AI。
  • 学术邮箱地址:Free 账户如果拥有已验证的、以 .edu、.edu.国家或 .ac.国家 结尾的地址,或属于所列大学的地址,即可保留包含的 AI 及其自己的密钥。通过其组织的单点登录登录的账户则遵循其组织的设置。账户设置 → 方案与账单显示“学术邮箱:在 Free 上每个项目包含 AI,以及所有者外加最多 6 名受邀编辑者”。
  • MCP 客户端和 REST API 随 Individual 和 Team 方案提供,在 Free 上则需拥有学术邮箱地址或属于活跃的班级组织(即保留 AI 的那些账户):它们使用您自己客户端的 AI,而不是 Holarch 的。请参阅API 和 MCP。
  • 一次请求是对某项 AI 功能的一次使用:一个询问 AI 问题、起草需求、一个建议的流程、对所选条目执行的一次批量操作。一个问题算一次请求,即使询问 AI 分多步读取项目也是如此;分成多个部分发送的批量操作,以及 Holarch 因回复格式错误而再次询问,也只算一次。失败的请求不计数。
  • PDF 规范导入:按文件长度计数,在每个方案上都用标准模型回答,包括带有包含 AI 的 Free 账户,因为遗漏一条需求的代价高于这一差价。Holarch 每次读取文件的 5 页,并且每个部分都会重新读取整个文件,因此文件越长计数越多:约 30 页以内每 5 页一次请求(10 页:2 次请求;25 页:5 次),之后每 5 页计数更多(100 页:30 次请求;200 页:90 次)。运行之前,Holarch 会显示其用量,例如“此次导入将使用本月剩余的 140 次包含的 AI 请求中的 30 次(文件越长,每 5 页计数越多)。”所需请求超过剩余次数的 PDF 不会开始;请将其拆分为较短的文件。请参阅导入 PDF 规范。
  • AI 需求检查:每 100 条需求一次请求(向上取整)。在检查超过 100 条需求之前,Holarch 会显示其用量,例如“此次评审将使用本月剩余的 52 次包含的 AI 请求中的 3 次(每 100 条需求 1 次请求)。”所需请求超过剩余次数的检查不会开始。
  • 使用 AI 生成剪贴画:每个变体一次请求(4 个变体:4 次请求),在所有方案中都由快速模型绘制。
  • SysML v2 模型问题(Individual 和 Team):每个问题一次请求,用您选择的模型回答(标准模型,或 Team 方案上的高级模型,后者计为 2 次)。
  • 在哪里查看:账户设置 → AI 密钥和 AI 设置显示包含的 AI:快速模型 · 本月剩余 52/75 次请求 · 11 月 1 日重置。
  • 用完时:“您已用完本月 75 次包含的 AI 请求。它们将于 11 月 1 日重置。如需更多,请在“账户设置 → AI 密钥”中添加您自己的 AI 服务商的 API 密钥。”付费方案开售后,Free 方案的消息为“… 它们将于 11 月 1 日重置。Individual 每月包含最多 150 次使用标准模型的 AI 请求。请在“账户设置 → AI 密钥”中添加您自己的 AI 服务商的 API 密钥,或在“账户设置 → 方案与账单”中选择付费方案。”,并提供选择方案…。请求在每月 1 日(UTC)重置,不会结转。
  • 来自 Holarch 的额外请求:当 Holarch 为您的账户(或您的组织)提供额外的 AI 请求时,它们在每月请求之后使用,最早到期的先用,在 Free 方案上也是如此。AI 设置随后会加上它们,例如… 11 月 1 日重置 · 40 次额外请求,账户设置 → 方案与账单会列出它们及其到期日期。未使用的请求到期前 7 天会有电子邮件提醒您。
  • Team:高级模型。在模型下,在此浏览器中选择高级模型,用于繁重任务(2 次请求);标准模型为默认值。
  • 仅限 Holarch 的功能。包含的 AI 回答 Holarch 的 AI 功能发出的请求。询问 AI 回答有关 Holarch 和您的模型的问题,对其他问题则以提问所用的语言,用一句简短的话婉拒,说明它回答的是有关 Holarch 和您的模型的问题。其他 AI 功能只完成各自的任务。如有其他用途,请添加您自己的密钥。数据量超过功能允许范围的请求会被拒绝,并显示“此 AI 请求过大,无法由包含的 AI 处理。请一次处理更少的条目,或使用您自己的 AI 服务商的 API 密钥。”
  • 限制。每项功能都有最大回复长度,询问 AI 的问题限制为 2,000 个字符。
  • 付费方案不会暂停。Individual 和 Team 在其每月请求数以内保留包含的 AI。在 Free 方案上以及 Individual 试用期间,包含的 AI 可能会暂停:当本月用于 Free 的预算用完时(直到 1 日),或当 Holarch 暂停它时。此时请求会显示“Free 账户的包含 AI 已暂停至 11 月 1 日:本月用于 Free 的预算已用完。请在“账户设置 → 方案与账单”中选择付费方案,或在“账户设置 → AI 密钥”中添加您自己的 AI 服务商的 API 密钥。”或“Free 账户的包含 AI 已暂停。请选择付费方案 …”。在付费方案开售之前,该消息只提及您自己的密钥。班级组织的成员按其自己的方案计数。
  • 组织:关闭了 AI 的组织也会关闭其项目中的包含 AI。

使用您自己的密钥或您组织的密钥发出的请求不计入包含的请求;AI 服务商会向该密钥的账户收取费用。Holarch 为何选用这些模型:Holarch 如何选择 AI 模型。

AI 设置

通过 ✦ AI ▾ → AI 设置…、询问 AI 中的 ⚙、⌘K / Ctrl+K → AI 设置…,或您的姓名首字母 → AI 设置… 打开。

组成部分内容
AI 密钥正在使用的密钥;包含的 AI:模型和本月剩余的请求(Team:模型,标准模型(1 次请求)或高级模型,用于繁重任务(2 次请求));本月:使用您自己的密钥时,显示其令牌数(占每月限额)、请求数以及按标价估算的费用;使用您组织的密钥时,显示请求数,以及在密钥有每月限额时已用的比例;并带有一个计量条(从 80 % 起变为琥珀色)。当项目所在的组织关闭了 AI 时,此项目会如此说明。
您的密钥提供商列表和您的密钥(见上文)。
在会话之间保留询问 AI 的历史记录在此浏览器中保留询问 AI 的对话。清除它会删除已保存的对话。
用于 AI 的项目参考文件一个列表:每个文件及其大小、在 AI 中使用和 ×;+ 文件;正在使用的文件和字符数。
链接使用哪个 AI 密钥、AI 用量和限额、组织密钥位于“账户 → AI 密钥”

保存会保留设置(“AI 设置已保存”)。

AI 参考文件

参考文件会向 AI 提示中添加背景资料,例如标准或工作说明书。要设置它们,请参阅附加参考文件。

  • 文件类型:.txt .md .csv .json .xml .html .docx .reqif。每个文件最多保留 200,000 个字符。
  • 开启了在 AI 中使用的文件会添加到询问 AI 以及生成、扩展、测试用例、风险、摘要、插入内容和富文本工具中。它们合计最多发送 100,000 个字符;当正在使用的文件更长时,列表下方的那一行会说明。
  • 参考文件按项目保存在此浏览器中。它们不会与其他成员共享。
  • “参考文件超出浏览器存储空间。请移除一个文件或附加较小的文件。”表示浏览器拒绝存储它们。请移除文件。

使用情况和限制

限制值留言
每人每分钟的请求数30“AI 请求过多。请一分钟后重试。”
每人同时运行的请求数3“已有三个 AI 请求正在运行。请 5 秒后重试。”
服务器上运行的请求数共享容量“AI 服务繁忙。请 10 秒后重试。”
每月包含的 AI您方案的请求数(请参阅方案和限制)“您已用完本月包含的 75 个 AI 请求。它们将于 11 月 1 日重置。如需更多请求,请在账户设置 → AI 密钥中添加您自己的 AI 服务商的 API 密钥。”(数量取决于您的方案)
每个密钥的每月令牌数由密钥的所有者设置“已达到此密钥的每月 AI 限额。在“账户 → AI 密钥”中提高该密钥的限额,或等到下个月。”
每位成员的每月限额由组织的管理员设置(请参阅成员限额)“您在 Acme 的每月 AI 限额已用完(40 次请求 / 40 次请求)。Acme 的管理员可在‘组织设置 → AI’中提高限额。限额将于 12 月 1 日重置。”
提示大小600,000 个字符—
回复大小400,000 个字符“AI 回复过长(超过 400,000 个字符)。”

月份按 UTC 的日历月计算。组织管理员在账户页面上查看按成员统计的使用情况。当多个限额同时适用时,最先达到的限额会停止请求:密钥的每月限额、成员限额,以及(对于包含的 AI)方案的额度。

成员限额

管理员为由其支付 AI 费用的人员设置每月 AI 限额:适用于所有人的默认值,以及为需要更多、更少或完全不需要 AI 的人设置的自定义限额。

位置:组织管理员:组织设置 → AI → 本月按成员统计的使用情况,或账户页面组织下该组织的卡片。在自托管服务器上,站点管理员还可以在管理 → AI 支出与用量 → 每位用户的每月 AI 限额中为组织之外的人员设置限额。

限额涵盖的范围:

  • 组织的限额:通过其组织密钥支付的 AI(任何提供商:Holarch 的默认 AI 服务商、Kimi、GLM、云平台托管的 AI),以及在托管服务上持有其 Team 席位的成员所包含的 AI;在自托管服务器上,还包括为组织工作而使用的服务器自有 AI 密钥(在其项目中;对于只属于该组织的人员,则在任何地方);
  • 自托管服务器自身的限额:在组织之外使用的服务器 AI;
  • 绝不包括个人自己的密钥:这些由其本人付费。

对于包含的 AI,方案的每月额度仍然适用。限额可以降低它,但不能提高它。

设置默认值:

  1. 选择单位:请求(每次用户操作计一次,与包含的 AI 的计数方式相同)、令牌(输入和输出)或US$(成本估算)(根据各提供商的标价)。
  2. 输入每位成员的默认限额。留空表示无限额。
  3. 点击保存。提示消息显示“已保存限额。”

更改单位会清除默认限额和所有自定义限额(“将单位更改为…会清除默认限额和所有自定义限额。设为‘无限额’的成员保持不变。”)。

设置某个人的限额:在该人员所在行中点击编辑…,然后选择使用默认值、无限额或自定义限额并输入数字,再点击保存。自定义限额会在限额列中显示自定义;使用默认值会将其移除。限额为 0 会停止此人使用由组织付费的 AI。

查找人员:按姓名或邮箱筛选,并通过显示选择所有人、已用 80% 及以上、已达限额或有自定义限额的人员。限额列以进度条显示“已用量 / 限额”(从 80% 起为琥珀色,达到限额时为红色)。

成员在账户设置 → AI 与 API(以及AI 设置)中查看自己的使用量:每月限额(Acme):“12 / 40 次请求 · 将于 12 月 1 日重置”,并带有进度条;用完后显示“已达限额。Acme 的管理员可以提高限额。”

通知:在达到限额的 80% 和 100% 时,此人会在铃铛(您的账户下)中收到通知,除非其电子邮件通知设为关闭,否则会立即通过电子邮件发送;当有人达到限额时,组织的管理员(对于自托管服务器自身的限额,则为站点管理员)会收到一条指明此人的通知。每人每月每种通知各一次。

站点管理员不受限额限制。每次更改都会记录在审计日志中(org.ai-limit;对于自托管服务器自身的限额为 admin.ai-limit),包括更改前后的值。

AI 用量记录(时间、功能、模型、令牌数和估算费用;从不包括提示或回复)在 13 个月后删除。

AI 权限

AI 权限决定 AI 可以做什么,每类请求一个开关:

开关允许的内容发送项目数据
帮助和操作指南询问 AI 根据帮助、文档和功能列表回答有关使用 Holarch 的问题。否
有关项目的提问摘要、解释、质量和缺口检查,以及关于项目的询问 AI。不做任何更改。是
建议和更改每个提议编辑的工具:改写、生成、翻译、建议关联、功能和流程、风险、测试用例。每项更改仍会先预览。需要有关项目的提问。是
AI 中的参考文件项目的 AI 参考文件会添加到使用它们的提示中。这些文件

预设:关闭(无 AI)、仅帮助、只读(帮助和有关项目的提问)、完整(全部四项),以及用于其他任意组合的自定义。

只读仍会将项目内容发送给 AI 提供商。它只是阻止 AI 提议更改。仅帮助不发送任何项目数据。

由谁设置:

  • 组织设置 → AI(组织管理员):组织的每个项目。请参阅管理。
  • 管理 → AI 设置 → AI 权限(自托管安装的管理员):该安装上的所有人。
  • 账户 → AI 和 API → AI 权限(账户持有人):您自己的 AI 请求,以及不属于任何组织的您的项目。
  • 共享 → AI 权限(项目所有者):一个项目。所有者只能关闭更多项。

一个请求需要在每个适用的层级上都开启其开关,因此任何层级都无法重新开启另一层级已关闭的内容。编辑器会将这样的开关显示为关闭且已禁用,并注明由谁关闭。

当某个开关关闭时:

  • 其在 ✦ AI ▾、右键菜单和批量操作栏中的工具会变灰并显示原因,例如“此组织的管理员已关闭 AI 更改。”;
  • 当被要求更改某些内容时,询问 AI 会回答“此处已关闭 AI 更改。”;
  • 仅开启帮助和操作指南时,询问 AI 回答有关使用 Holarch 的问题,不发送任何项目内容;
  • 服务器也会拒绝此类请求,无论它使用哪个密钥。

无论开关如何设置,受限的密级标识仍会对带有标识的项目关闭 AI。通过 MCP 连接的 AI 工具(例如 AI 应用)遵循相同的开关:其读取工具需要有关项目的提问,其写入和提议工具需要建议和更改。被拒绝的工具调用返回相同的消息,例如“此组织的管理员已关闭 AI 更改。”普通的 API 调用(脚本和集成)不是 AI 请求,不受 AI 权限限制;它们由组织的 API 访问开关控制。对 AI 权限的每次更改都会记录在审计日志中。

当组织设置为关闭时,任何人都不会使用该组织的密钥,其项目中的 ✦ AI 控件为关闭状态,并显示“此组织的 AI 已被其管理员关闭。”当项目的某位所有者在共享 → 组织下选择一个组织时,该项目即属于该组织。

通过云平台托管的 AI 使用 Holarch 的 AI 模型

云平台托管的 AI 在您自己的 AWS 账户中运行 Holarch 的 AI 模型,包括 AWS GovCloud (US)。自托管安装在其管理员开启后提供该选项。托管服务不提供该选项。

添加云平台托管的 AI 密钥:账户 → AI 密钥 → 添加密钥,提供商选择 云平台托管的 AI(您的 AWS 账户):AWS 区域、访问密钥 ID、秘密访问密钥以及可选的模型 ID。Holarch 会在保存密钥之前对其进行测试。密钥列表显示区域和访问密钥 ID 的最后 4 个字符。管理员也可以为整个安装提供其自己的云平台托管的 AI 访问;此时正在使用的密钥显示此安装:云平台托管的 AI (us-gov-west-1)。您自己的密钥和您组织的密钥仍然优先。

在 AWS GovCloud 中,模型 ID 与商业区域不同:请输入您的 AWS 账户为 Holarch 的 AI 模型列出的模型 ID 或推理配置文件 ID。

每项 AI 功能都可以通过云平台托管的 AI 使用,包括 PDF 规范导入。有一项不可用:当模型拒绝某个请求时,Holarch 无法将其转给同系列的另一个模型,工具会显示“AI 模型已拒绝”。

留言含义和解决方法
“云平台托管的 AI:访问被拒绝(…)”该 AWS 凭证无法调用此模型。请检查 IAM 权限,以及该模型是否已在该区域为该账户启用。
“云平台托管的 AI:… 在此区域中对此 AWS 账户不可用。”输入该账户在该区域中列出的模型 ID 或推理配置文件 ID。
“云平台托管的 AI:未找到 AWS 凭证。…”设置访问密钥或 AWS 配置文件。
“输入 AWS 区域,例如 us-east-1 或 us-gov-west-1。”更正区域。

使用您自己的密钥的 Kimi K3

Holarch 使用其测试选定的 AI 模型,包含的 AI 也使用该模型;在托管服务上,来自中国大陆、香港、澳门和台湾的请求则使用 GLM 5.3(中国大陆的 AI)。Kimi K3(Moonshot AI)是一个经过验证的选项,可使用您自己或组织的 Moonshot 密钥,例如在无法使用 Holarch 默认模型的地方。与所有自己的密钥适用相同的方案规则。使用 Kimi 密钥期间,请求会通过该密钥发送到 Moonshot,绝不会发送到 Holarch 的默认 AI 服务商;询问 AI 面板显示Kimi K3(您的密钥)或Kimi K3(组织密钥)。使用 Kimi 密钥的请求会发送到 Moonshot AI:您的提示词及其中包含的项目内容会发送给 Moonshot AI,并受您或您组织与 Moonshot AI 之间自身协议的约束。密钥表单会显示此说明,在 Kimi 密钥上点击使用此密钥时会要求您确认一次。在自托管安装中,只有管理员开启后才能使用 Kimi。

添加 Kimi 密钥:账户 → AI 密钥 → 添加密钥(或 AI 设置…),提供商选择 Kimi API:API 密钥和区域:

  • 国际 (api.moonshot.ai):用于在 platform.moonshot.ai 上创建的密钥;
  • 中国大陆 (api.moonshot.cn):用于在 platform.moonshot.cn 上创建的密钥。

密钥只能在其创建所在的区域使用。Holarch 会在保存前测试密钥;密钥列表显示区域和最后 4 个字符。组织的密钥在组织设置 → AI下以相同方式使用。在自托管安装中,管理员还可以为整个安装提供自己的 Kimi 密钥;此时正在使用的密钥显示此安装 · Kimi API (api.moonshot.cn)。您自己的密钥和组织的密钥仍然优先。要改回默认模型,请点击您的 AI 服务商的 API 密钥旁的使用此密钥,或移除 Kimi 密钥。

AI 权限、受限密级标识、预览和一次撤销在 Kimi 上的效果相同,其用量计入本月用量。

模型为 Kimi K3。Kimi 会先推理再回答。Kimi 编写新内容(新需求、测试用例、风险、功能和流程)时,Holarch 会要求更多推理;在询问 AI、AI 需求检查、可追溯性评审、改写、翻译和摘要中则要求较少推理。回答比 Holarch 的默认模型慢:通常需要 10 到 60 秒。

新需求、改写、测试用例和风险会以项目需求所用的语言编写,并使用该语言表示约束的情态动词(例如中文中的“应”)。

PDF 规范导入需要 Holarch 的默认模型(通过 AI 服务商 API 或云平台托管的 AI)。

留言含义和解决方法
“Kimi API:API 密钥被拒绝(HTTP 401)。”密钥来自另一个区域,或已被吊销。请检查区域,或在该区域的平台上创建密钥。
“请选择 Kimi 区域:国际或中国大陆。”选择一个区域。
“AI 响应时间过长。”选择更少的需求,然后再次运行检查。

使用您自己的密钥的 GLM 5.3

GLM 5.3(Z.ai)是继 Kimi K3 之后的第二个经过验证的选项,可使用您自己或组织的密钥。包含的 AI 仍使用 Holarch 的默认模型(来自中国大陆、香港、澳门和台湾的请求,包含的 AI 也是 GLM 5.3:中国大陆的 AI),与所有自己的密钥适用相同的方案规则。使用 GLM 密钥期间,请求会通过该密钥发送到 Z.ai,绝不会发送到 Holarch 的默认 AI 服务商;询问 AI 面板显示GLM 5.3(您的密钥)或GLM 5.3(组织密钥)。您的请求会根据您与 Z.ai 的协议发送到 Z.ai(新加坡):您的提示词及其中包含的项目内容会发送给 Z.ai 并在新加坡处理。密钥表单会显示此说明,在 GLM 密钥上点击使用此密钥时会要求您确认一次。在自托管安装中,只有管理员开启后才能使用 GLM。

添加 GLM 密钥:账户 → AI 密钥 → 添加密钥(或 AI 设置…),提供商选择 GLM API,然后粘贴来自 Z.ai 国际平台(z.ai)的 API 密钥。请求发送到 api.z.ai。来自中国大陆服务(open.bigmodel.cn)的密钥属于另一项服务,无法使用。Holarch 会在保存前测试密钥;密钥列表显示最后 4 个字符。组织的密钥在组织设置 → AI下以相同方式使用。在自托管安装中,管理员还可以为整个安装提供自己的 GLM 密钥;此时正在使用的密钥显示此安装 · GLM API (api.z.ai)。要改回默认模型,请点击您的 AI 服务商的 API 密钥旁的使用此密钥,或移除 GLM 密钥。

AI 权限、受限密级标识、预览和一次撤销在 GLM 上的效果相同,其用量计入本月用量。

模型为 GLM 5.3。它总是先推理再回答;编写新内容(新需求、测试用例、风险、功能和流程)时,Holarch 会要求更多推理,在询问 AI、AI 需求检查、可追溯性评审、改写、翻译和摘要中则要求较少推理。回答速度与 Holarch 的默认模型大致相同。默认模型能将需求更深入地分解为子需求。新内容以项目需求所用的语言编写,TBD 和 TBR 在所有语言中都保持原样。

PDF 规范导入需要 Holarch 的默认模型(通过 AI 服务商 API 或云平台托管的 AI)。

留言含义和解决方法
“GLM API:API 密钥被拒绝(HTTP 401)。”密钥已被吊销,或是来自 open.bigmodel.cn 的密钥。请在 z.ai 上创建密钥。

组织中的 Kimi K3 和 GLM 5.3

Holarch 的 AI 使用 Holarch 测试选定的模型;在托管服务上,来自中国大陆、香港、澳门和台湾的请求使用 GLM 5.3。Kimi K3 和 GLM 5.3 是可以开启的选项。在组织中,两者都保持关闭,直到组织管理员在组织设置 → AI → 可选 AI 提供商下分别开启(请参阅在组织中允许 Kimi K3 或 GLM 5.3)。没有组织时,在阅读数据说明后由您自行决定。

  • 为组织工作(其项目和密钥):无论使用谁的密钥,都由该组织的设置决定。
  • 您自己的工作(个人项目、您自己的密钥):您所属的每个组织都必须已开启该提供商。
  • 添加密钥仍会列出已关闭的提供商,并标记(已被您的组织关闭)。选择它会显示“组织已关闭提供商,因此无法为其添加密钥。组织的管理员可以在组织设置 → AI 中将其开启。”,并且测试并保存保持禁用。
  • 提供商关闭期间,之前添加的密钥会被保留,并标记“未使用:组织已关闭此提供商。…”,没有测试或使用此密钥。提供商一开启,它就会重新生效。

当 Holarch 为组织设置 AI 时(请参阅下一节),则改由该设置决定。

由 Kimi K3 为您的组织提供 AI

对于某些组织,Holarch 会自行设置 AI,例如公司无法使用 Holarch 默认模型的情况。此时,AI 设置和账户页面中的正在使用的密钥以及询问 AI 面板会显示您组织的 AI 由 Kimi K3 提供。组织管理员可在组织设置 → AI下查看该设置及其原因。

只要您属于这样的组织,您发出的每个 AI 请求都会使用 Kimi K3,在您的个人项目和其他组织的项目中也是如此:

  • 通过 Holarch 使用 Kimi K3:由 Holarch 自己的 Kimi 密钥响应。与包含的 AI 一样,请求计入您方案包含的 AI 请求和 AI 请求包,并且只运行 Holarch 的 AI 功能。
  • 组织自己的 Kimi 或 GLM 密钥:组织管理员在组织设置 → AI下添加 Kimi(Moonshot AI)或 GLM(Z.ai)密钥(请参阅使用您自己的密钥的 Kimi K3和使用您自己的密钥的 GLM 5.3)。只有此选项时,正在使用的密钥显示您组织的 AI 使用其自己的 Kimi(Moonshot AI)或 GLM(Z.ai)密钥。在添加密钥之前,AI 功能会提示您联系组织管理员。
  • 关闭:AI 功能显示“Holarch 已为您的组织关闭 AI。”其他一切照常工作。

不使用 Holarch 的默认模型:个人和组织的默认 AI 服务商密钥及云平台托管的 AI 密钥不会被使用,也无法添加;添加密钥只在设置允许时提供 Kimi(Moonshot AI)和 GLM(Z.ai)密钥;PDF 规范导入(需要默认模型)不可用;通过 MCP 连接的 AI 应用会被拒绝。AI 权限、受限密级标识、预览和一次撤销照常工作。

只有 Holarch 可以更改此设置;组织管理员仍可在 AI 权限下关闭更多功能。具有此设置的组织不能由其管理员删除。如有疑问,请写信至 [email protected]。

为某个安装关闭 AI

自托管安装的管理员可以为所有人关闭 AI,例如在封闭网络中:在管理 → AI 设置下将 AI 权限设为关闭,或在服务器设置中使用 HOLARCH_AI=off。HOLARCH_AI 也接受 help、read 或诸如 help,read,refs 的列表。关闭期间:

  • ✦ AI 为关闭状态,并显示“此安装的 AI 已关闭。”;
  • AI 工具、AI 设置…和询问 AI 会打开AI 已关闭,其中说明相同内容;
  • 账户 → AI 密钥显示相同的说明,且没有添加密钥;
  • 不会向 AI 提供商发送任何内容,服务器会拒绝 AI 请求。

Holarch 的其他所有功能照常工作。

隐私:发送哪些内容

  • 仅在请求时。除非您启动某项 AI 功能,否则不会向 AI 提供商发送任何内容。
  • 只发送功能所需的内容。
    • 需求工具发送该需求、其父项、其验证者和项目名称。
    • 询问 AI 发送问题、Holarch 功能的说明、最多三个帮助主题、项目的实体和关系(在较大的项目上:一份摘要加上问题所需的条目;操作类问题不发送项目数据)、当前页面以及最近的对话。
    • 正在使用的 AI 参考文件会添加到AI 参考文件下列出的位置。
  • 隐藏文本会被排除。零尺寸、不可见或白底白字的文本不会发送。
  • 发送到哪里。请求从 Holarch 服务器发送到 AI 服务商;使用 Kimi 密钥时发送到 Moonshot AI;使用 GLM 密钥时,以及来自中国大陆、香港、澳门和台湾的包含 AI 请求,发送到 Z.ai(新加坡)。适用该服务商的条款。请查看这些条款,包括提供商是否保留 API 数据或用其进行训练。Holarch 不会使用您的内容训练 AI 模型。
  • Holarch 保留什么。不保留提示文本,也不保留回复。为了用量和限额,它按请求记录时间、密钥、任务、令牌数、估算费用和结果。只有当在会话之间保留询问 AI 的历史记录开启时,询问 AI 的对话才会保留在您的浏览器中。
  • 密钥。密钥在服务器上加密存储,从不发回浏览器,保存后也不会再次显示。

快捷键

按键Action
⌘K / Ctrl+K → 询问 AI…打开询问 AI
⌘K / Ctrl+K → 工具名称运行当前页面的 AI 工具
Enter在询问 AI 中发送问题
Shift+Enter在询问 AI 中换行
⌘Z / Ctrl+Z撤销上一次应用的 AI 更改

消息

留言含义和解决方法
“未设置 AI 密钥。在“账户 → AI 密钥”中添加 AI 服务商的 API 密钥。”以及没有 AI 密钥对话框没有可用的密钥。点击打开 AI 密钥并添加一个,或请您的组织管理员提供组织密钥。
“粘贴 API 密钥。” / “粘贴完整的 API 密钥。”密钥字段为空或不完整。
“输入至少 1,000 个令牌的月度限额,或留空表示不限。”更正限额。
“您在 … 的每月 AI 限额已用完(… / …)。… 的管理员可在‘组织设置 → AI’中提高限额。限额将于 … 重置。”您的组织为您设置的每月限额已用完。请组织管理员提高限额、使用您自己的密钥,或等到本月结束。请参阅成员限额。
“您在此服务器上的每月 AI 限额已用完(… / …)。站点管理员可在‘管理 → AI 支出与用量’中提高限额。限额将于 … 重置。”自托管服务器为您设置的限额已用完。请联系站点管理员。
“限额须为大于或等于 0 的数字。” / “请输入整数的请求数或令牌数。” / “请输入最多两位小数的美元限额。”更正成员限额。
“… 密钥未保存。请检查密钥,然后重试。”测试请求失败;原因显示在最前面。
“输入您的密码以更改 AI 密钥。”更改密钥需要在最近 10 分钟内通过密码检查。
“密码错误。请重试。”确认您的密码中的密码不匹配。
“只有此组织的管理员才能更改其 AI 密钥。”请联系组织管理员。
“无法在此服务器上读取已存储的密钥。请将其移除后重新添加。”移除该密钥,然后重新添加。
“提供商拒绝了 API 密钥。在“账户 → AI 密钥”中添加新密钥。”该密钥无效、已被吊销或没有余额。
“AI 提供商出错。请重试,或在“账户 → AI 密钥”中测试密钥。” / “无法连接 AI 提供商。”提供商错误或服务中断。请稍后重试。
“AI 响应时间过长。”请求超时。请重试,或减少输入。
“AI 回复与预期格式不符:…” / “AI 响应被拒绝…”回复未通过检查;未做任何更改。请重试。
“此组织的 AI 已被其管理员关闭。”请联系组织管理员,或在组织之外使用该项目。
“此安装的 AI 已关闭。”此安装的管理员关闭了 AI。其他所有功能均可正常使用。
“Holarch 已为您的组织关闭 AI。”Holarch 已将您组织的 AI 设为关闭。请参阅由 Kimi K3 为您的组织提供 AI。
“您的组织无法使用 Holarch 的默认模型,因此不能使用默认 AI 服务商的密钥。请改为添加 Kimi(Moonshot AI)或 GLM(Z.ai)密钥。”您的组织不使用 Holarch 的默认模型。请在设置允许时添加 Kimi 或 GLM 密钥。
“您组织的 AI 使用其自己的 Kimi(Moonshot AI)或 GLM(Z.ai)密钥。请让组织管理员添加一个。”组织尚无 Kimi 或 GLM 密钥。请联系组织管理员。
“您的组织已关闭 Kimi (Moonshot AI) ……。… 的管理员可以在组织设置 → AI 中将其开启。”(或 GLM (Z.ai))组织未允许此提供商。请联系组织管理员,或使用默认 AI 服务商的 API 密钥。请参阅组织中的 Kimi K3 和 GLM 5.3。
“您的组织无法使用通过 MCP 连接的 AI 应用。请改用 Holarch 中的 AI。”当您组织的 AI 由 Holarch 设置时,MCP 工具会被拒绝。
“此组织的管理员已关闭 AI 更改。”(或“有关项目的提问已 …”、“AI 帮助已 …”、“AI 中的参考文件已 …”;“… 被此项目的所有者关闭。”、“… 在您的账户设置中关闭。”)该类 AI 请求已在AI 权限下关闭。请联系消息中提到的人,或使用已开启类型的工具。
“此处已关闭 AI 更改。”在建议和更改关闭时,询问 AI 被要求更改某些内容。在允许的情况下,它仍会回答问题。
此项目的 AI 已关闭项目包含服务视为受限的密级标识:分类字段或标题栏中的密级或 CUI 标识、文档名称或文本中诸如 SECRET//NOFORN 的横幅,或文档、项目或组织标识中的出口管制声明(ITAR/EAR)。Company Proprietary、Company Confidential 和分发声明不会关闭 AI。请移除这些标识或联系支持人员。未发送任何内容。在其 AI 提供商已获准处理此类数据的自托管安装上,站点管理员可以允许对这些项目使用 AI(管理 → AI → 受限密级标识);托管服务始终保持 AI 关闭。
“仅查看:AI 工具需要编辑权限”请所有者授予您编辑者角色。
“您的会话已结束。请重新登录。”重新登录,然后重复该请求。
“无法连接服务器。请检查连接,然后重试。”网络问题。
“没有可评审的需求。请先选择或打开需求。” / “请选择一条需求。”选择该工具要处理的条目。
“<provider> 未返回任何需求。” / “… 未建议任何风险。”添加上下文后重试。
“已取消翻译;未做任何更改。”您取消了一次翻译。

限制

  • 每个账户和每个组织的每个提供商各一个密钥。
  • 每月密钥限额:1,000 到 10,000,000,000 个令牌。
  • 成员限额:以组织的单位计,0 到 100,000,000,000(美元限额以美分计);每个组织一个单位。
  • 每人每分钟 30 次请求,同时 3 次。
  • 提示最多 600,000 个字符;回复最多 400,000 个字符。
  • 参考文件:每个最多 200,000 个字符,存储在此浏览器中。
  • 生成需求:1–20 个父项,每个父项 0–10 个子项。生成子需求:1–20。生成风险:每次运行最多 3 个(Risk 图:1–10)。剪贴画:1–8 个变体。
  • 查看者不能使用 AI。