# 在 Cursor 中连接 Knowledge 这是软件维护的安装说明。先读取 https://knowledge.cyberflo.ai/setup/clients/cursor.json,复用有效连接并只修复缺少的步骤。 从机器说明下载对应版本的清单与压缩包,先按说明中的 SHA-256 核验清单,再核验压缩包及清单中每个文件。拒绝符号链接、越界路径、重复条目及多余文件。先检查内容,再写入明确的本地目录。不要覆盖同名的其他插件或已修改文件;保留旧版本和现有连接。 1. 本机可使用 Cursor 官方的本地插件目录:`~/.cursor/plugins/local/company-knowledge`。仅在目录不存在时放入核验后的真实文件;如果已有版本,先核对内容并保留可恢复副本。不要替换别人的同名插件,也不要通过符号链接绕过目录限制。 2. 重启 Cursor 或运行 Developer: Reload Window,在 Customize 中确认技能、规则和 MCP。团队策略可能禁止本地导入;此时使用团队批准的市场,不能修改策略来绕过限制。已安装的市场同名插件优先于本地副本。 3. 为 `hive-read` 完成本人的 OAuth 登录。首次使用或缺少权限时审核新增同意;安装不等于授权。 4. 在新会话确认规则与技能被加载,然后检查实际权限。不要创建隐藏更新计划;市场分发与本地复制的更新方式需分开核验。 若已安装的检查器因全局权限扩展标记暂停,先核验自有安装与其真实清单,再用检查器返回的 installed_version 请求同一个更新网址:在 updates.json 后加 ?from_version=。无参数的旧网址仍以 1.7.0 为来源;不能从当前下载版本推断已安装版本。仅对已核验的 1.7.0 到 1.7.3 自有安装,确认 compatible_transition 的来源版本与本机完全相同、目标为当前版本,并逐项比较旧版和新版清单与压缩包哈希。证明缺失或不匹配时保留暂停。确认现有文件未修改、没有未知额外文件,且连接、原生运行时与钩子未变化;然后按本宿主受支持的更新方式安装已核验版本。保留连接、用户修改、停用、暂停和信任,并在新会话核验实际加载。1.0.1 和未知版本不属于此证明,缺少的 Access 连接仍单独处理;此证明不授权新同意或权限。 核验:使用 `tools/list` 的实际工具定义,调用不带参数的 `access_info`。分别记录安装、实际加载、身份与权限、自动行为和可选浏览器操作;缺少证据就保持未验证。安装检查不读取公司业务资料、不创建共享记录。普通保存必需 `hive.read hive.work.append`,提议指引与导入来源为可选的单独能力,服务器仍检查员工资格。逐项核对实际返回的能力;只有读取权限时保存未就绪,可选导入未就绪不阻塞保存,不创建共享令牌或擅自扩大权限。需要验证真实检索时,使用已获准的选定资料,并区分工具成功与回答质量。 公司方法从同一中央目录发现和刷新;个人及软件开发任务不写入共享知识。导入资料仍未审核,人工审核与发布保持独立。MySQL、Snowflake 与 CCO 属于独立的 Autopilot Access 连接,需另行核验。 ## 标准自动业务保存 读取 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 范围不同:保留所选不可变适配器的范围要求,仅在原生控制支持时选择最小同意;固定四项范围且员工拒绝的宿主仍需报告部分就绪,不能绕过验证。保留有效的更宽同意、明确窄权限、现有连接、禁用选择和用户修改。不为安装扩大员工资格、创建共享身份或重复登录。 在实际生效的同名插件中核对 rules/company-knowledge.mdc 的 alwaysApply 原生规则、完整技能与 MCP,注意已安装市场版本的优先级。新会话必须实际加载;保留用户修改和团队限制,不通过修改策略或复制其他宿主钩子来绕过限制。若旧注册只有读取且服务器资格已满足,可使用官方远程 OAuth 的 auth.CLIENT_ID(本账户无密钥公开注册)与 auth.scopes=[hive.read,hive.work.append];仅设置 scopes 不足以启用静态配置。先核实真正生效的原生连接/插件前缀与回调,使用支持的设置完成本人重新同意,不猜测用户配置会覆盖插件,也不编辑冻结包、令牌或数据库。 ## 使用时的兼容更新 本次标准安装设置智能体管理的兼容更新。下载并保留当前清单和专用交付目录,阅读新包内 references/client-updates.md。Claude、Cursor 与 DeepSeek 在使用时通过包内 Node 助手每日复用一次成功检查,校验固定来源、完整清单与不可变压缩包,再于安全任务边界通过原生生命周期应用。Grok 复用新业务对话原本要读取的宿主描述,检查 updates 与固定版本私有引导技能,使用原生私有技能工具更新完整匹配的自身条目。旧1.0.0需一次引导迁移;没有跨账户推送、隐藏任务或每次模型选择的保证。保留个人信任、有效连接、停用与用户修改;不为更新读取业务内容、创建记录或扩展授权。 分别核对:持久入口已配置、完整指引在新会话加载、同一连接具备读取和追加权限、该宿主原生入口实际执行、真实业务自动保存已观察。技术核对器、安装成功、技能可见或 work_append 为真,都不能合并为最后一项。没有真实任务时标为 awaiting_business_task,安装技术工作可以完成;安装检查不读取业务正文、不创建共享记录。 技术就绪后,用首次正常业务的新对话观察,开场不加入插件、Knowledge、技能或保存提醒。遵循既有共享授权与工作归属,个人、软件开发与无变化例行检查排除,没有记录配额。业务结束后再只读核对原请求的回执、准确记录、哈希和保存时间,确认早于任何后续审核提示;漏记保留为失败,不能先补记再报告自动成功。含糊归属只问一个有选项的问题,未回答不保存;未知或未同意权限保持部分就绪。详细结果保存在私有本地回执,最后只给简短就绪结果和一个必要下一步。 ## 同一个 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使用安全任务边界的私有技能维护,不宣称跨账户推送。