Orkas 使用指南
先从一个任务开始，再按桌面应用中看得见的入口逐项了解核心功能。隐私与安全、常见问题单独归类。
# 直接说出你想完成的任务
新建任务，用一两句话说明你想要的结果。有多项任务时，可以每行列一项。Orkas 会帮你拆解，并在缺少关键信息时再向你确认。
例如：
- 总结这份报告，并列出需要我决定的事项。
- 比较这三个方案，按我的预算推荐一个。
- 把这些笔记整理成下周评审用的演示文稿。
任何 Orkas 使用问题也可以直接问指挥官。对于支持的请求，它会提供点击后打开的快捷入口，或通过专用流程直接完成；凭证、授权和重要确认仍由你在对应页面处理。
# 完成第一个任务
有效的请求应说明想要的结果、使用的资料、受众或用途，以及重要的格式、期限或审批边界。
打开新任务
在主对话区域新建一个任务。
说明结果
说清什么算成功，以及哪些限制必须满足。
只添加相关资料
任务需要时，再添加文件或选择智能体、技能、连接器或资料库内容。
选择运行方式
使用任务输入框显示的模型。要添加外接命令行智能体，可在“AI 团队”页点“接入编程智能体”，或在输入框的 @ 选择器里接入。
跟进进度
回答决策、缺失信息、权限或表单请求。Codex 可以在继续执行时，在输入框上方显示问题浮窗：选择或填写每个答案，再点击“发送回答”。切换任务会保留草稿。只要当前 CLI 轮次仍接受输入，未回答的卡片就可以提交。也可以点击“取消”，关闭未回答的问题，不发送答案、不停止任务。取消后切换任务或重新加载都不会再次弹出；取消失败会保留草稿，方便重试。回答后或本轮结束时浮窗也会收起，已提交的回答会保留在对话中。本轮结束后如需继续，请发送新消息。Claude Code 的问题通过弹窗回答，可选择选项或填写自定义答案，多选后需要确认。
检查结果
打开或下载结果；若现有上下文仍适用，就在同一任务里提出明确修改。
排队消息依次提供“立即发送”（可用时）、“编辑”和“取消”。点击“编辑”，消息连同附件、引用和资源标签回到主输入框。编辑期间后续排队消息暂缓发送，正在生成的回复继续。点击勾选按钮保存到原队列位置，按 Esc 保留原消息，或点击该消息队列行的“取消”来取消发送；完成后恢复输入框原有草稿。切换任务或刷新窗口会保留编辑内容，保存失败时也可继续修改并重试。
通过 @ 或“给”面板选择智能体，选中的对象集中显示在顶部，方便取消；面板按光标位置插入 @。正文开头的 @ 覆盖当前指派，首个 @ 前的正文交给当前对象，后续 @ 开始新的指令；相邻的多个 @ 共用后面的描述。发送成功后，单个对象保持选中，多个对象则将下一条消息切回指挥官。指挥官交接任务时会选中接管的智能体；临时委派保持当前对象，直到智能体请求你输入，出现输入表单时会选中表单所属智能体。直接追问表单不会提交表单。智能体明确交回指挥官时会切回指挥官；你之后的手动选择优先。
# 模型配置
Orkas 支持两种聊天模型使用方式：直接选择账号可用的 Orkas 官方模型，或接入你自己使用的模型提供商。不同选择会影响模型能力、速度、成本、计费方和请求路径。
自定义服务支持 Responses 时，请在“协议”中选择 OpenAI Responses。填写 API 基础地址，末尾的 /responses 会自动移除。已有配置保留原协议。
主要能力
- Orkas 内置模型包括 Orkas-1.5 和 Orkas-1.5 Pro。当前前沿模型阵容涵盖 DeepSeek V4.1 Flash、GPT-6 系列、Claude 5 系列、Gemini 3.8 Flash 和 Kimi K3；最新阵容始终以 Orkas 内显示的列表为准。
- “自带 API Key”支持通过 OAuth 或 API 密钥接入自己的提供商，也可以填写准确模型 ID，添加支持 OpenAI 或 Anthropic 协议的自定义服务。如需使用 ChatGPT 会员，请选择 OpenAI Codex 并授权登录；OpenAI 选项使用 API Key，与会员分开计费。如需使用 Claude 会员，请选择 Anthropic 并授权登录；其 API Key 方式单独计费。
- 聊天模型共用任务输入框中的模型选择器；搜索、图片、视频和文字转语音需要分别配置，外接命令行智能体则使用各自的命令行模型设置。 全部收件对象都是外接命令行智能体时，共用的模型选择入口保持显示，但置灰且不可用。
适合这些场景
- 不想配置提供商密钥，希望直接使用 Orkas 管理的前沿模型。
- 希望沿用自己的模型账号、计费、服务地址，或指定某个具体模型。
- 任务对推理、编程、视觉、速度或成本有不同要求，需要切换模型。
从这里开始
- 打开“账号设置”>“模型”。启用可用的“Orkas 内置模型”，或在“自带 API Key”中添加并测试自己的提供商。
- 回到任务，打开输入框中的模型控件，选择要使用的官方模型或已保存的提供商配置。
- 只有任务需要搜索、图片、视频或文字转语音时，才在对应的独立分组中完成配置。
# 项目
项目为长期目标提供一个共享工作空间，让相关任务从相同背景开始，不必在每次对话中重新补齐上下文。
主要能力
- 集中保存目标、长期说明、交付偏好和项目记忆。
- 复用这项工作经常需要的智能体、资料库内容和其他资源。
- 统一整理相关任务、对话、待办和项目自动化。
适合这些场景
- 一个目标需要多个任务逐步完成，例如产品发布、长期调研或持续内容生产。
- 后续任务都要沿用相同背景、规则、交付偏好、智能体或参考资料。
- 任务、待办和定时自动化都属于同一项长期工作。
从这里开始
新建或打开项目，先说明持续目标，再只添加需要影响多个项目任务的说明和资源。
- 需要影响未来所有项目任务的规则写入“目标与规则”，最多 4000 个字符。
- 临时方向放在当前任务中。
- 只添加这个项目经常需要的智能体和资料，并随着工作变化检查项目记忆和待办。
- 在 Orkas 1.7.0 中，可以让指挥官管理已有项目的待办。在普通聊天中说明项目名称；名称有歧义时，先确认目标再保存修改。这不会把当前对话移入项目。
- 创建或编辑待办不会关联任务对话。成功发起执行后，可点击卡片上的“任务对话”返回最近一次执行；再次成功发起执行会更新关联，启动失败或仅修改状态不会改变关联。
将已有任务添加到项目
对尚未属于项目的任务，打开三点菜单，选择“添加到项目”。选择已有项目并点击“移入”，或选择“新建项目”并确认名称。任务执行期间该入口不可用，需等待结束，或停止任务并等待收尾完成。历史消息和附件随任务保留。
任务关联的 Agent 默认勾选，可取消不需要添加的 Agent；仅有指挥官时不显示 Agent 区域。取消勾选不会移除项目已有成员。
若部分 Agent 添加失败，任务仍保留在项目中，成功添加的成员也会保留。界面会提示失败数量，可进入项目检查成员。
指挥官也会在交付结果的那条回复里自己完成：会重复的请求变成自动化，服务于更长期目标的工作会新建一个项目、写入头几条待办，并把当前对话移入该项目。想撤回，在同一对话里说一声，或使用“移出项目”——已在项目里的任务，菜单中显示的正是这一项，而不是“添加到项目”。
与成员共享项目
拥有者打开“项目成员 > 邀请项目成员”，确认共享范围后创建并复制邀请链接。请查看页面显示的成员名额和有效期。受邀者通过链接打开 Orkas，确认使用正确的账号加入。
目标与规则、记忆、资料、待办及其附件会共享；任务和自动化保持私有。自定义智能体需点击“共享”，CLI 智能体保持私有。共享项目中，锁头表示私有内容。成员可编辑任意待办；自动推进只处理本人负责的待办。 在待办页，使用看板工具栏右侧的“全部 / 我的”筛选共享项目待办，个人待办照常显示。“按项目”在选中共享项目时显示开关；“按状态”在存在共享项目时显示开关。
内容先保存在本地，再后台上传；保存成功不代表其他成员已收到更新。个人云同步与项目协作相互独立。点击右上角“刷新”获取更新并重试待上传内容；出现“项目冲突”时，先比较两份内容再选择。 邀请链接无需等待上传。上传支持中断或重启后接续；可在项目成员区暂停同步或重试。 内容正在同步，可先使用本地 Agent 工作。
退出或被移除后保留个人副本，移除其他成员的智能体及非本人负责的待办，并暂停项目自动化。再次加入会创建独立的共享项目。拥有者“结束共享”会停止所有成员的协作并删除共享云端数据，已下载的副本会保留。
# 自动化
自动化会把明确的指令变成未来执行一次或按周期重复执行的工作，不必每次手动新建同一个任务。
主要能力
- 设置单次执行，或每隔若干小时、每天、每周、每月重复，并可选截止日期或计划执行次数。
- 关联项目，让每次运行都能使用稳定的项目上下文和资源。
- 运行时使用已配置的模型和连接器，查看历史结果，并在不删除记录的情况下暂停后续运行。
适合这些场景
- 需要每隔若干小时、每天、每周或每月生成报告、摘要、收集结果或进行复盘。
- 同一项定期检查每次都要使用固定项目上下文或连接器。
- 某个一次性任务要在指定时间执行，不希望依靠人工记住。
从这里开始
打开“自动化”，按实际运行时的语境写好指令，选择时间、可选截止条件和可选项目，选择运行设备，然后保存并启用。先检查第一次运行结果，再依赖后续自动执行。
# 智能体
智能体是可重复使用的专业成员，按照明确角色、工作方法、质量标准、可用能力和角色记忆负责一类工作。
主要能力
- 把经常重复的专业要求沉淀成可直接选择的专业成员，不必每次重新说明。
- 为专业成员设置工作流程、必要输入、交付标准、记忆和相关能力。
- 使用由 Orkas 运行的智能体，或接入 Codex、Claude Code、OpenCode 等受支持的本地命令行智能体。
适合这些场景
- 经常需要同一种专业视角，例如调研、产品设计、数据分析或内容审核。
- 工作需要长期遵循固定质量标准、使用特定能力或保留角色相关背景。
- 希望让 Codex、Claude Code、OpenCode 等本地外接命令行工具负责一个任务。
从这里开始
- 打开“AI 团队”并选择“创建智能体”来定义 Orkas 智能体，然后检查其工作流程、输入、交付标准和记忆。
- 需要某个专业成员负责工作时，在任务输入框中选择它。只添加确实能帮助任务达成结果的智能体。
- 要使用 Codex、Claude Code、OpenCode 等受支持的命令行工具，先安装并登录，再在“AI 团队”页选择“接入编程智能体”。
- 在外接智能体详情的“运行设置”中选择 CLI 支持的模型、思考和权限等级。“需要确认”会把 CLI 原生审批透传到 Orkas 确认弹窗，显示 CLI 动作或所选路径，并把决定回传给 CLI。OpenCode 固定为“完全访问”，不显示权限选择。
- Claude Code、Codex 和 OpenCode 可在智能体详情中使用工作区默认值或选择项目目录；任务中需要切换项目时，直接提出切换要求并选择另一个已存在的文件夹。
- 在任务中，Claude Code、Codex、OpenCode、Hermes 和 OpenClaw 只能使用当前会话的内置浏览器。你可以切换到 Orkas 的其他页面，智能体仍可操作自己任务的网页，无法访问其他会话或外部浏览器窗口。在“任务详情 > 浏览器”中直接操作网页即可。你操作时 AI 会暂时让行；停止操作满 10 秒，且按键、拖拽或输入法组合输入结束后，AI 可自动继续操作。智能体可以读回普通表单值，填写并提交包括密码、验证码和银行卡资料在内的字段，上传任务工作区或附件中的文件。敏感字段的值不会回传给模型。任务下载无需另行逐站授权。网页要求人机验证或其他检查时，请按提示完成；自动恢复控制权不会重启已停止的任务。 上传和下载没有浏览器额外设置的数量或大小配额，网站自身限制仍然适用。操作完毕后可点“交还给 AI”立即交还控制权。网站请求权限或屏幕共享时按提示授权或选择。浏览器工具栏的“重置网站权限”会清除该网站的选择，不会重新加载表单。 AI 通过文件路径上传，普通下载自动保存到任务附件，无需文件选择框。外部文件请先添加为会话附件。AI 操作时会取消网站原生文件系统选择框；若网站没有普通上传或下载入口，请手动操作网站。 AI 可以允许或拒绝当前请求保持屏幕亮起；其他网站权限仍需你决定。
CLI 低于最低支持版本时，可在接入面板、智能体详情或任务错误气泡底部点击升级按钮；气泡内会标明具体 CLI。升级进度显示在按钮中，结果显示在右侧。升级成功后请重试任务。支持范围内的版本自动适配；显式选择的模型不可用时，请在运行设置中修改。
对于由 Orkas 运行的智能体，可以请 Commander 或在该智能体的编辑对话中，保存它默认使用的可用技能。编辑成功后，这份列表在新任务和重启后仍保留。默认技能按需读取和使用，不会自动执行、一次性加载全部说明，也不会阻止发现其他符合条件的共享技能。只在某次任务中选择技能，不会修改这份列表。外接 CLI 智能体使用各自的技能配置。
只制作音频时，在 AI 团队中选择 VoiceStudio，提供文稿或录音，要求配音、转写、剪辑，或混入你提供的音乐。配音使用已配置的语音合成服务，并联网发送文稿；转写和编辑使用内置组件，无需首次下载依赖。保留项目及音频文件，后续可单独修改段落或混音。必要组件缺失时，请修复或更新 Orkas。
# 技能
技能封装一项重复工作的做法，包括步骤、检查项、参考资料和预期结果，让不同任务和智能体都能复用同一套方法。
主要能力
- 把成熟的方法、清单、模板和输出规则保存成一个可复用流程。
- 让多个任务和智能体使用相同做法，而不必再创建一个专业角色。
- 可手动创建、从网址或文件夹生成、导入本地技能压缩包，或从市场安装现有技能。
适合这些场景
- 同一套步骤、模板、检查项或输出格式需要频繁复用。
- 多个智能体或任务都应遵循同一种工作方法。
- 希望把现有指南、网页或本地文件夹整理成可复用流程。
从这里开始
- 打开“技能库”并选择“创建技能”，可以从手动、网址或文件夹开始；完成编辑对话后再正式使用。
- 在任务中选择技能，照常说明想要的结果，并提供该工作流程需要的输入。
- 希望直接使用现有工作流程时，可浏览市场，不必从头创建。
- 要暂停某个技能，在技能库中打开它卡片上的 ⋯ 菜单并选择“停用”；选择“删除”可移除你自己创建的技能，从市场安装的技能请在市场中卸载。
# 连接器
连接器会在授权范围内让 Orkas 访问外部服务，使任务能够使用服务中的最新数据或执行允许的操作，不必反复导出文件。
主要能力
- 在任务需要时读取已连接账号或工作区中的实时信息。
- 在你授权的访问范围内创建、更新、发送或执行其他受支持的操作。
- 通过授权流程连接目录中的服务，或添加你信任的自定义 MCP 服务器。
适合这些场景
- 任务需要读取外部服务中会持续变化的最新信息。
- 希望 Orkas 在授权后创建、更新、发送或执行其他外部操作。
- 重复工作每次都要使用同一个外部工作区或账号，不想反复导出文件。
从这里开始
- 打开“连接器”，或在当前任务中请指挥官连接、重新连接某个服务。简单授权只需打开连接入口并由你完成授权；额外配置则由指挥官结合指南和浏览器协助处理。配置面板中的“指挥官协助”会发起独立协助任务，请求不包含保护字段中的值。完成后确认连接状态。飞书/Lark、钉钉、企业微信或 Xero 连接后，可随时在卡片三点菜单中选择“重新授权”。无需先断开，现有连接和所选能力会保留；完成后回到任务重试。
- 未连接不代表不支持，请先查看可用目录。对于目录外的可信服务器，使用“添加 MCP 服务器”，连接前检查远程地址或本地命令。
- 只在需要的任务中选择连接器，并清楚说明 Orkas 可以读取什么或执行什么操作。
在 Orkas 1.7.0 中，连接器操作统一使用“账号设置 > 通用 > 本机操作权限”，外部 CLI 智能体调用也一样。已识别的读取和常规编辑无需确认；“谨慎”和“常规”会在敏感或未分类操作前询问；“信任”下可用的连接器操作无需确认。禁止开放的操作始终不可用。 可展开“查看详情”检查操作和参数。“允许一次”仅批准本次操作；“本次任务内允许”批准此连接器账号的后续所有操作，包括删除，直到任务结束或停止。重新连接会清除这项授权，全局权限保持不变。
# 资料库
资料库会把参考文档和稳定资料变成可重复使用的知识。处理完成后，Orkas 可以为问题或任务检索最相关的内容片段，不必反复上传和人工查找同一批文件。
主要能力
- 基于已处理的制度、手册、研究、笔记或产品资料进行快速问答，并让回答有资料依据。
- 从所选资料中比较、总结、提取或撰写内容，不必手动定位每一处原文。
- 在后续任务、项目和受支持的已同步设备中复用同一批资料。
适合这些场景
- 想基于制度、手册、研究报告、产品资料、会议记录等内容进行知识检索和快速问答。
- 多个任务需要反复比较、总结、提取或引用同一批资料。
- 资料需要供后续任务或其他已同步设备继续使用，而不是只做一次性附件。
从这里开始
- 打开“资料库”，添加受支持的资料，使用容易识别的名称，并等待处理完成。
- 在新任务或项目任务中，只选择与当前问题有关的资料库内容。
- 直接提问或说明想要的结果。需要严格依据资料回答时，明确要求 Orkas 只使用所选资料。
# 应用
“应用”会把符合条件的交互式任务结果保存为可重复使用的工具，以后无需先找到并打开原始对话就能直接使用。
主要能力
- 打开“应用 > 创建”，描述想法，再创建、检查并保存。
- 生成任务结束后，仍可从“我的应用”直接打开并继续使用。
- 在“应用”选择“编辑”，在新任务中修改。选择“更新原应用”保留原应用，或“保存新应用”创建独立副本。更新会覆盖代码并保留兼容数据；原应用已删除则保存为新应用。保存新应用后，该结果的后续更新指向副本。
适合这些场景
- Orkas 生成了交互式看板、计算器、表单、跟踪工具或其他可复用工具。
- 任务结束后，仍希望可以方便地再次打开这个结果。
- 在“应用”选择“编辑”，在新任务中修改。选择“更新原应用”保留原应用，或“保存新应用”创建独立副本。更新会覆盖代码并保留兼容数据；原应用已删除则保存为新应用。保存新应用后，该结果的后续更新指向副本。
从这里开始
在“应用”选择“编辑”，在新任务中修改。选择“更新原应用”保留原应用，或“保存新应用”创建独立副本。更新会覆盖代码并保留兼容数据；原应用已删除则保存为新应用。保存新应用后，该结果的后续更新指向副本。
以下宿主能力仅本地应用可用：为 Orkas 构建的应用可按需并经许可使用已配置模型、所选文件、应用存储、全局知识库和已启用连接器。模型调用可能收费，不再单独询问应用授权。敏感连接器操作沿用操作权限，“信任”模式不再询问。“本次使用允许”对当前连接器账号的同类操作有效，关闭应用后失效；重新打开后按需再次申请。文件导出会创建新文件。每个应用有独立的数据和文件沙盒。应用使用云端存储且同一账户在各设备启用同步时，可以同步业务数据；缓存仅留在本机。保存成功不代表上传完成。旧应用数据不会自动迁移，不同保存副本的数据仍独立。切换账户或配置模型后请关闭并重新打开应用。旧应用及独立 HTML 导出不会自动获得这些能力。
在“应用”菜单中发布，页面会显示发布额度。依赖桌面专属能力时会阻止发布；选择“修改应用以支持网页发布”打开编辑任务，检查预填内容后自行发送。 已发布应用的菜单提供“更新发布”（需要本机有源码）和“下线”。下线完成前隐藏“删除”，已暂停应用也需先下线。下线会永久删除线上数据，本地代码和数据保留。 发布文件和线上数据与云端同步、项目协作共享账号云端存储。发布详情显示文件、数据库及总占用；删除记录后，空间在实际回收时才释放。
应用可以加载外部脚本和资源，并直接调用外部服务。外部服务会收到应用发送的数据；直接调用不会经过连接器权限对话框。外部脚本拥有该应用的能力。服务鉴权和浏览器跨域规则仍然适用。
# 云端同步
云端同步会让受支持的 Orkas 数据出现在登录同一账号的电脑上，让长期工作无需手动导出和导入就能继续。
主要能力
- 让受支持的任务、项目、智能体、技能和资料库内容随账号出现在其他设备。
- 改动同步完成后，可在另一台电脑继续同一项工作。
- 模型 API 密钥和任务附件等本地数据不会进入云同步。
适合这些场景
- 在多台电脑上使用 Orkas，希望受支持的工作内容随账号切换。
- 在一台设备创建的任务、项目、智能体、技能或资料库内容，需要在另一台设备使用。
- 希望在其他已登录设备继续长期工作，不想手动导出再导入。
从这里开始
打开“账号设置”>“数据”，在每台需要参与的设备上启用云端同步。首次上传期间保持 Orkas 打开，并等同步完成后再到其他设备编辑同一内容。
会员到期后同步暂停。在“账号设置”>“数据”查看云端删除日期，并点击“续费恢复同步”。本地数据仍保留；若云端已清理，续费后需重新开启同步。
使用前需要知道
- 较大的改动同步完成前，保持 Orkas 打开并联网；完成前不要在另一台设备编辑同一内容。
- 任务附件不会随任务同步。需要在其他已同步设备复用时，把受支持的文件添加到资料库。
- 模型 API 密钥只保留在配置它的设备上，不会同步到云端。
- 在一台设备上关闭同步只会停止该设备后续同步，不等于删除云端数据。
清理历史任务
打开“账号设置 > 数据 > 清理历史任务”，选择 7、14、30、60、90 或 180 天（默认 30 天）。点击“查看”，按项目或逐项勾选，再在当前页面确认清理。默认不勾选任务；确认清理后，会先自动停止运行中或排队中的任务。 可从清理列表查看任务对话，再返回继续清理。
按时间筛选所有历史任务，支持按项目或逐项清理。
任务历史、附件和内嵌结果会移入本地回收站，可在下方点击“恢复”。开启云同步时，删除也会同步到其他设备；清空回收站后才会释放空间。 置顶、未读、有草稿的任务和自动化运行记录均可勾选。未发送的草稿一并删除，自动化配置保留。
# 隐私与安全
Orkas 本地优先，但模型、连接器、外接命令行智能体、可选同步和分享会发送或保存这些功能所需的数据。模型 API 密钥保留在配置它的设备上，任务附件也不会随任务同步。进行敏感工作前，检查当前账号、所选服务、权限模式和确认文本。当前存储、加密、网络和分享边界见安全与信任。
# 常见问题
如何在 Orkas 中开始一个任务？
新建任务，直接说明你想要的结果；有多项任务时，可以每行列一项。只添加工作需要的文件或资源，再按页面状态跟进到结果完成。
什么时候使用任务附件、资料库或项目？
只在一次对话中使用的文件放到任务附件；需要复用的资料放到资料库；多个任务要共享说明、资料、记忆或自动化时使用项目。
任务无法运行时应该检查什么？
先看任务的当前状态。你可以让指挥官检查受支持的脱敏应用状态，并提供前往相关页面的快捷入口。回答等待中的问题，恢复不可用的资源；涉及外部操作时，先确认是否已经成功，再重试。
模型、权限、记忆、同步和账号数据在哪里管理？
打开侧栏底部的账号入口并选择“账号设置”。“账号”管理套餐与剩余积分，“数据”管理记忆与同步，“模型”管理聊天模型和服务设置，“通用”管理权限、通知、语言与更新。