# 由 Codex 完成安装与更新

员工只需从 https://knowledge.cyberflo.ai/setup 复制一段说明交给 Codex。以下全部技术步骤由智能体执行；不要将其转交为员工检查清单。新用户与已有用户使用同一流程。

## 智能体负责的工作

先检查当前状态，再核验并安装准确的兼容版本。选择真实的桌面内置程序，保留有效连接、用户修改、禁用插件、恢复版本固定、暂停计划和明确退出选择。只完成缺少的工作；不要为重复检查重新登录或请求一般性安装批准。按所选包能力使用核对器，仅在该包支持时维护有效用户级 AGENTS 入口；旧版不支持时标为不适用，不手工添加新版入口。维护原有更新任务。可选数据连接不阻塞 Knowledge。安装、已加载、实际权限、自动检查和业务自动保存分别核验，缺少证据保持未验证。

## 本人确认：先准备，再给一个准确动作

只在当前证据表明确有需要时，处理本人登录、缺少的同意、新增或变化的自动检查信任，以及实质含糊的团队选择。智能体先准备或打开受支持的界面；需要终端核对时，使用已验证的同一个桌面内置 Codex。必须观察实际界面后，再用普通语言说明用途、涉及的数据、准确按钮或选项及成功后的可见结果，一次只给一个必要动作。支持的原生技术入口是 Review hooks 或 `/hooks`，供智能体准备界面使用，不是让员工学习的步骤。本人作出信任选择；智能体不能键入批准或信任按键、修改信任存储、信任全部插件或绕过保护。无法打开或观察时，仅给当前安装所需的一个准确动作，不罗列替代命令。确认自动相关性检查时，说明当前提示词的有限片段可能通过现有 Knowledge 连接发送给 OpenAI，包括后来被判断为个人内容的片段；服务不将它保存为知识或诊断正文。提供方保留取决于实际账户配置，不得声称未经核实的零保留。

用户返回后继续原流程，只复查受影响的步骤。拒绝或尚未完成时保留真实待办；不反复询问相同问题。最终只展示简短就绪结果和一个必要的下一步，技术详情留在私有安装回执中。

## 首次真实业务观察

技术就绪并不证明已经自动记录。引导员工在全新对话直接处理正常业务，开场不加入插件、知识库或记录提醒。无需为核验编造业务或执行外部操作。业务完成后再只读核对实际记录、回执和保存时间，确认其早于任何后续提醒。首次漏记应保留为失败观察，不能先补记再宣称自动成功。存在工作归属或共享授权的实质含糊时，仍按正常规则确认。未进行真实业务时报告“业务自动记录待观察”，不阻塞已完成的安装。安装诊断、个人和软件开发工作不得写入共享知识。

## 供智能体执行的技术参考



## 标准自动业务保存

读取 https://knowledge.cyberflo.ai/setup/workflow.json 及当前宿主的 automatic_workflow。此软件维护的实时安装说明补充历史不可变包内 SETUP，不修改其字节、完整业务方法或原生信任。由智能体完成持久入口配置与核对，而不是让员工每次提醒保存。

普通 Knowledge 保存必需 read 与 work_append（hive.read hive.work.append）。guidance_propose、source_import 为可选能力，MySQL、Snowflake、CCO 的 Access 也为独立可选连接；这些可选业务能力不阻塞普通保存。权限资格与宿主实际请求的 OAuth 范围不同：保留所选不可变适配器的范围要求，仅在原生控制支持时选择最小同意；固定四项范围且员工拒绝的宿主仍需报告部分就绪，不能绕过验证。保留有效的更宽同意、明确窄权限、现有连接、禁用选择和用户修改。不为安装扩大员工资格、创建共享身份或重复登录。

核对已验证安装包的 scripts/bootstrap.sh status（macOS）或 scripts/bootstrap.ps1 -Command status（Windows）以及真实有效用户级指引；保留 CODEX_HOME、非空覆盖、用户修改与禁用选择。仅在该版本支持时用原有安装器修复自身入口。核对当前版本的真实原生钩子事件和完整技能；旧核对器的 knowledge_capture=ready 仅证明权限，不代替这些检查。未变化的钩子不重复核对信任。

分别核对：持久入口已配置、完整指引在新会话加载、同一连接具备读取和追加权限、该宿主原生入口实际执行、真实业务自动保存已观察。技术核对器、安装成功、技能可见或 work_append 为真，都不能合并为最后一项。没有真实任务时标为 awaiting_business_task，安装技术工作可以完成；安装检查不读取业务正文、不创建共享记录。

技术就绪后，用首次正常业务的新对话观察，开场不加入插件、Knowledge、技能或保存提醒。遵循既有共享授权与工作归属，个人、软件开发与无变化例行检查排除，没有记录配额。业务结束后再只读核对原请求的回执、准确记录、哈希和保存时间，确认早于任何后续审核提示；漏记保留为失败，不能先补记再报告自动成功。含糊归属只问一个有选项的问题，未回答不保存；未知或未同意权限保持部分就绪。详细结果保存在私有本地回执，最后只给简短就绪结果和一个必要下一步。# 连接团队知识库

将此说明交给你的 Codex 智能体，协助安装与核对。Autopilot 插件版本 1.7.4，工作流 1.5.0，保留此前已发布版本。

员工请使用[安装与升级页面](https://knowledge.cyberflo.ai/setup/install)，无需在浏览器直接打开脚本。浏览器拒绝下载时，保留安全设置并让智能体排查。以下下载地址供智能体核对与下载；先校验版本清单中的 SHA-256，再检查脚本内容，最后执行安装。

1. 下载适用于电脑的安装程序，检查后在本地运行。不要把网络下载直接传给 shell。
   - [macOS](https://knowledge.cyberflo.ai/client/1.7.4/install-macos.sh)
   - [Windows](https://knowledge.cyberflo.ai/client/1.7.4/install-windows.ps1)
   - [版本与校验值](https://knowledge.cyberflo.ai/client/1.7.4/manifest.json)
2. 安装程序使用经过验证的 Codex 桌面内置程序，保留已有 `hive-read` 连接和其他设置。遇到同名冲突时会停止。Windows 可用 `-CodexPath` 指定签名有效的桌面程序。macOS 自动查找当前或旧版桌面安装位置，也可用 `--codex` 明确选择。
3. 复用现有有效连接，仅对缺失或已失效的权限在浏览器完成飞书登录与单独的智能体授权。支持的权限为 `hive.read,hive.work.append,hive.guidance.propose,hive.sources.import`；管理员资格仍单独校验。网站登录与智能体授权是两件事，旧连接不会自动获得导入权限。
4. 智能体使用同一个已验证的桌面内置 Codex 准备原生核对界面，观察实际内容后，解释 Company Knowledge 自动检查及涉及数据，给出一个准确的本人操作。本人决定是否信任；智能体不得代按信任键、修改信任存储或绕过保护。
5. 打开新的桌面任务，读取插件内的 `skills/company-knowledge/references/local-workflow.md`，运行本地安装核对器，用 `tools/list` 读取当前工具定义，结合实际 `access_info` 与每日计划回读、当前版本和本地自动检查记录保存核对结果。重启或登录后接续未完成步骤；普通任务不重复完整核对。旧版远程钩子才使用 `workflow_status`。安装完成或手工发送事件不代表实际自动检查通过。

业务数据连接：[Autopilot Access](https://access.cyberflo.ai/setup)。需要另外完成本人的只读授权，安装插件不会自动开通数据库访问。已有有效授权无需重复登录。升级用 `--upgrade`（Windows：`-Upgrade`），如需回退可指定原版本；保留其他插件与连接。

MCP：`https://knowledge.cyberflo.ai/mcp`。机器说明：`https://knowledge.cyberflo.ai/setup.json`。版本目录：`https://knowledge.cyberflo.ai/releases.json`。

智能体先自动检查系统、已有插件、连接和当前权限，只在确需本人操作时准备准确入口，一次说明一个必要动作。只在有多个可用团队或业务目标不明确时提问。使用现有安装程序升级准确的插件，保留其他配置；不要把“已下载”当成“已加载”。当前任务结束后，在新任务核对实际插件版本、读取和导入权限，并在重启后再次确认。已有授权但当前连接未使用时，先重新加载连接，不能反复要求授权。

添加资料：`https://knowledge.cyberflo.ai/sources/new`；本地文件可直接到 `https://knowledge.cyberflo.ai/sources/new?kind=local`。选定文件的浏览器文件选择不能自动预填。遇到需人工操作的步骤，智能体先准备内容、提供准确链接、解释一个剩余动作，并在返回后核对原提交结果。排查入口：`https://knowledge.cyberflo.ai/setup/help`。

管理行动背景：`https://knowledge.cyberflo.ai/records` → 我的记录，可从列表直接展开“删除”并确认，也可进入详情编辑。删除无法在应用中撤销。个人及编程、开发、测试、部署相关任务不写入团队行动记录；其他业务工作自动保留有用的发现、实质结果、阻碍、理由和交接；不因业务相关性的小幅不确定而遗漏有用背景。重复或没有变化的操作可不留共享记录。

团队技能从中央目录按平台与市场发现，再加载完整批准版本并检查账号、产品和品类限制。未声明范围不等于全部适用；平台步骤应核对参考来源和实际验证日期。资料检索先返回带工作归属及日期的精简片段，必要时展开。工作归属不明确时，先让用户从具体已有工作或独立工作中确认；未回答则不共享保存。日常操作无需逐条记录；有用的普通业务结果、发现与阻碍也值得交接，无需属于罕见例外。中央方法更新无需重装插件。

自动更新：每次获准安装或更新时，读取新安装包的 `autopilot-update` 技能，通过受支持的 Codex 计划工具维护每天电脑当地时间 09:00 检查一次。复用现有任务，保留标识、暂停状态、设备明确退出选择、本人选择的其他每日时间和通知偏好；计划运行中不得创建新任务。回读计划的状态和时间，并测试一次；工具不可用时明确保留待办。计划任务和实际使用共享同一当地自然日的成功检查缓存；当天已有成功检查时不重复联网。明确要求立即检查时可强制刷新；失败不会记为成功，之后可重试。遵循所选包的兼容版本安装与自动检查核对规则；变化的自动检查仍须本人单独确认；不自动增加权限、改信任或重启。保留连接，分别说明下载、安装和实际加载状态。电脑与 Codex 必须运行并联网；启动、唤醒或恢复网络不是专门触发器。私有诊断最多每天同步一次。没有变化时保持安静；只在更新、失败或需要本人操作时说明。不得轮询公司数据或使用隐藏系统计划。

创建职能请直接交给 Codex：先检查已有职能，仅补充缺少的业务目的、职责边界、预期产出和典型任务。智能体通过 `function_authoring_context`、`create_function` 直接创建，再用 `function_status` 验证结果；无需网页确认或发布，不会产生待确认职能。职能创建不会授予权限，技能通过一次明确的发布操作生效。

完成时分别报告知识检索、导入、中央技能、MySQL、Snowflake 与 CCO 的实际能力和缺口，并给出“找决策依据”“添加指定资料”“接续同事工作”“准备库存分析”等适用示例。

检索结果不完整或没有匹配，并不证明资料不存在。登录尚未配置时，请等待管理员完成配置后再连接。

新网站登录最长保持 30 天，浏览不会延长期限。智能体导入仅限用户明确指定的文档和团队范围；不会自动扫描资料库。飞书文档仍需授予 Knowledge 应用查看权限。本地文件通过插件内的 Mac/Windows 上传助手直接发送，文件内容不经过模型消息，上传凭证不放进网址或日志。传输不确定时先查询原请求状态。

证据接受、决策确认与指引发布保持独立的人工作用。本地诊断事件仅包含标识；相关性辅助检查的数据说明见下文。不要将密码、令牌或登录回调链接粘贴到聊天中。

创建与维护技能：先读取插件的 `skill-builder` 技能（`skills/skill-builder/SKILL.md`），按任务复杂度补充关键问题，比较已有方法，判断复用、修订或新建，并明确重叠及冲突。随后按以下共同作者指南接续。

创建与维护技能：先读取插件的 `skills/company-knowledge/references/skill-authoring.md`。从用户目标出发，复用已有技能与回答；分步询问并质疑含糊范围、矛盾规则、缺少输入、例外、负责人及成功标准。准备完整方法与示例，保留未解决的问题，不编造公司规则。保存草稿后核对结果，提供准确链接，引导核对草稿后一次发布，最后验证当前已发布版本。

指定资料访问恢复：仅在相关访问问题发生时，用只读 `source_access_info(url)` 从 Knowledge 服务核对实际应用身份，必须匹配 `cli_aa3ae108ec78dbe2`；不能假设当前飞书 CLI 使用同一应用。明确添加或共享请求可复用已确认的文档和团队范围，通过当前已授权的提供方 API，或受支持的浏览器流程，仅向该应用授予查看权限；遵守宿主在执行时的确认要求。普通阅读问题不授权持久访问或导入。不得扩大链接共享、授予编辑权限、提取凭证或自动通知所有者。用户没有共享权限时，明确列出原文档链接、应用 ID 和所有者需完成的“可查看”操作，保持待处理。服务或身份验证失败不能当作缺少文档权限。随后再用同一只读工具核对应用可读，并继续原有且具备资格与单独同意的 `prepare_source` / `connect_source` 请求，保留原请求 ID 和当前代次。元数据可读不代表完整提取或导入完成；仍需核对导入结果。工具缺失时说明限制，通过受支持的升级或准确人工步骤恢复，不能创建准备记录来代替诊断。普通任务不重复完整设置检查。

权限修复边界：失败检查本身不授权修改权限。先独立核实应用确实没有所选资料的有效访问权限，且当前用户有权共享；仅缺少直接授权不代表没有继承权限。已有应用授权或身份验证不确定时，保留所有权限并等待服务排查。按当前提供方工具定义将受信任的应用 ID 用作 `member_type=appid` / `member_id`；核实资源 token 与类型匹配。单个知识库页面必须限定 `perm_type=single_page`，不能使用包含子页面的 `container`；浏览器操作遵守相同边界。保留已有更高权限，不降级、不重写，关闭可选通知。

## 自动更新与钩子核对

已授权此设备自动更新时，验证通过且兼容的插件在任务结束时自动安装；钩子变化不再阻止安装。本人在桌面内置 Codex 的“Review hooks”或 `/hooks` 中核对新定义后才能运行。代理不得代为信任、绕过核对、重新登录或中断任务。先报告已下载、已安装、待核对和已加载的真实状态。

旧版更新器迁移：用户要求安装或更新此设备时，可对仅含 `hooks_review` 的旧版结果继续执行已验证的精确安装；必须独立核实权限、连接和主版本兼容性。随后在同一次维护中通过受支持的 Codex 计划工具更新原计划的说明，明确授权后续兼容软件自动安装、变化钩子单独核对，保留原计划身份、目标、暂停状态和通知偏好。不能改写旧安装包，也不能从服务器发布推断所有员工已更新。

## 自动记录与相关性辅助检查

安装程序为已启用的插件维护一段简短的有效用户级 AGENTS 入口，保留既有内容与覆盖规则；若用户修改过该入口，明确报告冲突而不覆盖。请在新任务核对加载。员工无需每次提醒使用插件或记录。业务结果与阻碍有用即可记录，无需罕见或特殊；个人及软件开发仍排除。沿用已确认的团队共享范围与工作归属，归属存在实质含糊时只问一次。

新的 UserPromptSubmit 钩子使用已有的本人 Knowledge 连接，把当前提示词的有限片段发送给 OpenAI Decisions 做一次低成本相关性判断；这可能包括最终被判断为个人内容的片段。服务不把片段保存为知识或写入诊断正文，也不读取完整对话。分类不授予共享权限，不会直接创建记录。连接、分类或超时失败时，继续由本地智能体判断，不因失败丢弃可能有用的业务背景。现有诊断仍仅含元数据；OpenAI 的数据保留由实际账户配置决定，不能仅凭接口支持就宣称零保留。新的联网钩子需要本人通过受支持入口核对信任；不会自动修改信任。

日常工作保持安静：复用有效背景及已确认的范围，只在重要行动或共享含糊之处提出一次具体问题。每个对话保留一份不含正文的精简诊断，最多 4 KB、每台设备 100 份、保留 30 天；仅每日维护时尽力同步，不因诊断失败中断工作。需要说明的是已验证能力、实质性限制或一个必要的下一步。


## 同一个 Autopilot

先读取 https://knowledge.cyberflo.ai/autopilot.json。所有适配器使用同一个产品版本及 Knowledge、Autopilot、skill-builder、autopilot-update 四个完整技能；组件只负责宿主安装、连接和自动入口。按清单核验本机已安装和当前会话实际加载的版本，不能用下载或网页发布代替。

保留已有 hive-read 和 autopilot-access 连接；两者分别使用本人 OAuth 权限，不转发令牌。只有需要业务数据且缺少连接时，先读取 https://access.cyberflo.ai/setup.json；登录未就绪或宿主回调不支持时报告服务缺口，不反复要求同意，继续可用的 Knowledge 工作。客户端看到同一工具能力范围，实际权限、资料范围及服务是否启用由服务器决定。

旧版1.0.0、1.0.1和Grok私有引导1.0.2通过同一连接/更新流程迁移：校验已知自身文件及用户修改，只替换完整匹配的软件；缺少的新连接由本人单独同意，不阻止原有Knowledge使用。保留暂停、停用、退出、有效连接和原生信任。Codex使用已授权的每日更新；其他本机适配器使用每日实际使用时检查；Grok使用安全任务边界的私有技能维护，不宣称跨账户推送。
