# 在 Claude Code 中连接 Knowledge 这是软件维护的安装说明。先读取 https://knowledge.cyberflo.ai/setup/clients/claude-code.json,复用有效连接并只修复缺少的步骤。 从机器说明下载对应版本的清单与压缩包,先按说明中的 SHA-256 核验清单,再核验压缩包及清单中每个文件。拒绝符号链接、越界路径、重复条目及多余文件。先检查内容,再写入明确的本地目录。不要覆盖同名的其他插件或已修改文件;保留旧版本和现有连接。 1. 将已核验的包解压至独立目录;如已安装同名插件,先检查其来源与版本,避免重复注册。 2. 使用原生 Claude Code 命令验证插件:`claude plugin validate <已核验目录>`。然后添加本地市场:`claude plugin marketplace add <已核验目录>`,再运行 `claude plugin install company-knowledge@cyberflo-knowledge-clients --scope user`。保留宿主的信任与权限确认。 3. 在 Claude Code 的 `/mcp` 中为 `hive-read` 完成本人的浏览器登录与明确同意。已存在的同名手动连接可能覆盖插件配置;先核对地址与权限,不要盲目新建或删除连接。 4. 打开新会话,确认 Knowledge 技能、插件版本和原生上下文钩子已加载。钩子只提供本地指引,不做网络访问或共享保存。 若已安装的检查器因全局权限扩展标记暂停,先核验自有安装与其真实清单,再用检查器返回的 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 范围不同:保留所选不可变适配器的范围要求,仅在原生控制支持时选择最小同意;固定四项范围且员工拒绝的宿主仍需报告部分就绪,不能绕过验证。保留有效的更宽同意、明确窄权限、现有连接、禁用选择和用户修改。不为安装扩大员工资格、创建共享身份或重复登录。 核对同一个已启用插件的 SessionStart 与 UserPromptSubmit 原生上下文钩子,保留个人信任与现有连接。全新会话应收到持久入口并加载完整技能;仅验证插件格式或手工调用技能不代表自动路径通过。不要另加网络分类、停止钩子或隐藏计划。现有包的 OAuth 默认会请求四项完整功能范围;可选业务能力不可用不妨碍保存,但不要声称该包默认只请求两项,也不修改不可变配置。只有当前原生控制支持选择时才调整缺少的范围。 ## 使用时的兼容更新 本次标准安装设置智能体管理的兼容更新。下载并保留当前清单和专用交付目录,阅读新包内 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使用安全任务边界的私有技能维护,不宣称跨账户推送。