AI
AI
Holarch 中的每项 AI 功能、预览和审批的工作方式、AI 密钥以及使用哪个密钥、Individual 和 Team 方案包含的 AI、用量和限制、AI 权限,以及发送给提供商的内容。
本页内容
使用 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,也不能使用自己的密钥,但使用学术邮箱地址的账户和活跃班级组织的成员除外。
- 在 AI 服务商的控制台中创建 API 密钥。
- 在 Holarch 中,打开 ✦ AI ▾ → AI 设置…。(或点击您的姓名缩写 → 账户设置,然后滚动到 AI 密钥。)
- 点击+ 添加密钥。
- 提供商显示 AI 服务商 API,这是目前唯一提供的提供商。
- 将密钥粘贴到 API 密钥中。
- 可选:输入至少为 1,000 的每月限额(令牌)。留空表示无限制。
- 点击测试并保存。
- 如果打开了确认您的密码,请输入您的密码。该验证在 10 分钟内有效。
您会看到提示消息“已添加 AI 密钥(AI 服务商 API,…abcd)。”Holarch 会先发送一个简短的测试请求。如果测试失败,密钥不会被保存,消息会说明原因。
- 检查正在使用的密钥。
您会看到您的密钥:AI 服务商 API (…abcd)。
使用 AI 工具
对所选条目运行特定于页面的 AI 工具,审查其提议,然后应用。
- 打开页面并选择条目,例如文档中的一条需求。
- 点击顶栏中 ✦ AI 旁边的 ▾。(或按 ⌘K / Ctrl+K 并输入工具名称。)
- 选择工具,例如添加可度量的标准…。
您会看到一个忙碌对话框“正在询问 <provider>…”,并带有计时器。取消会停止请求。
- 审查预览。
预览的影响列表显示追溯到 AI 将要更改的条目的内容:需求、测试、接口、文档、图以及其他项目中的条目,每项标记为受影响或检查(影响)。点击其标题可将其展开,点击一行可在不关闭预览的情况下查看该条目。
- 在对话框允许的地方编辑建议。
- 取消勾选您不需要的任何内容。
- 点击应用按钮,例如应用、添加所选项、创建测试用例或应用所选项。
您会看到一条简短的提示消息,例如“已应用添加可度量的标准”。一次撤销即可撤回整个更改。
提问
“询问 AI”回答有关已打开项目和 Holarch 的问题。它不更改任何内容。
- 点击顶栏中的 ✦ AI。(或按 ⌘K / Ctrl+K 并选择询问 AI…。)
- 输入问题,或点击其中一个示例。
- 按 Enter 发送。Shift+Enter 则添加新行。
您会在面板中看到回答。条目名称和帮助主题是链接。有些回答包含一个按钮,可打开回答所涉及的页面。回答中的代码显示在可横向滚动的框中。
- 根据需要提出后续问题。最近的对话会随每个问题一起发送。
在 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 中使用开关。
- 打开 ✦ AI ▾ → AI 设置…。
- 在供 AI 使用的项目参考文件下,点击+ 文件并选择一个文件。
您会看到该文件及其大小,并且在 AI 中使用已勾选。列表下方的一行显示有多少文件在使用中以及它们添加了多少文本,例如“使用中:3 个文件中的 2 个,48k 个字符”。
- 对更多文件重复此操作。
- 取消勾选文件上的在 AI 中使用,可将其保留在列表中但不发送;或点击 × 将其移除。
- 点击保存。
参考文件保留在此浏览器中,不与其他成员共享。早期版本保存在包中的文件会出现在这一个列表中;之前处于活动状态的包中的文件处于使用中。有关文件类型和限制,请参见 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 修正它们:
- 创建演示:管理项目 → 项目文件 ▾ → 新建演示项目。
- 打开 EO-1 System Requirements Specification。
- 选择 2.5 Safe Mode Recovery。
- 选择 ✦ AI ▾ → 添加可度量的标准…。
您会看到当前、更改和建议(应用前可编辑)。建议内容例如:“The spacecraft shall exit safe mode and resume imaging within 24 hours of the fault being cleared.”说明中指出 24 小时是一个建议值。
- 如果您的任务分析得出不同的结论,请更改该值。
- 点击应用。
- 选择 6.4 Operator Interface,然后选择拆分复合需求…。
您会看到每条单一需求。第 1 项替换 6.4;其他项添加在其后。
- 点击拆分需求。
- 选择 3.5,然后选择起草理由…。
- 审查理由并点击应用。
- 打开需要与需求 → 质量。
- 选择 ✦ AI ▾ → 用 AI 检查(n 条需求)…。
您会看到针对每条需求判断的 Correct、Feasible、Necessary、Unambiguous 和 Verifiable,并附有原因。判定结果下方的复选框说明应用后会更改什么(“No → Yes”、“添加一个发现项”);“无更改”表示存储的值已经一致。改写和已审批的需求初始为未勾选。按钮上方的一行统计将要应用的内容,例如“将 7 个值和 2 项改写应用到 5 条需求。”
- 点击应用所选项。
- 返回文档,选择 2.5,然后选择生成测试用例…。
- 审查步骤(按顺序)、设置、预期结果和验证方法。
- 点击创建测试用例。
您会看到新的测试用例,已关联到 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 服务商 API | API 密钥 |
| Kimi API | API 密钥、区域(请参阅使用您自己的密钥的 Kimi K3) |
| GLM API | API 密钥(请参阅使用您自己的密钥的 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。”
本月按成员统计的使用情况列出成员、请求、令牌、费用(估算)和限额,并有一行总计,位于每位成员每月限额的控件下方(请参阅成员限额)。
使用哪个密钥
服务器按以下顺序为每个请求选择一个密钥:
- 您自己的密钥,如果您添加了。
- 您组织的密钥。在属于您所在组织的项目中,使用该组织的密钥。在此类项目之外,当您只属于一个组织时,使用该组织的密钥。关闭了 AI 的组织不会将其密钥提供给任何人。
- 包含的 AI:Holarch 自己的密钥,附带本月包含的请求数(见下文)。
- 无: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,方案的每月额度仍然适用。限额可以降低它,但不能提高它。
设置默认值:
- 选择单位:请求(每次用户操作计一次,与包含的 AI 的计数方式相同)、令牌(输入和输出)或US$(成本估算)(根据各提供商的标价)。
- 输入每位成员的默认限额。留空表示无限额。
- 点击保存。提示消息显示“已保存限额。”
更改单位会清除默认限额和所有自定义限额(“将单位更改为…会清除默认限额和所有自定义限额。设为‘无限额’的成员保持不变。”)。
设置某个人的限额:在该人员所在行中点击编辑…,然后选择使用默认值、无限额或自定义限额并输入数字,再点击保存。自定义限额会在限额列中显示自定义;使用默认值会将其移除。限额为 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。