# K-Echo 下载与安装

Windows安装包含浏览器插件、K-Echo 本地助手和离线指南；macOS安装包仅提供浏览器插件与指南。Chrome/Edge共用，无需下载前选择浏览器。

1. [版本清单](release-manifest.json)提供对应系统下载URL、大小与SHA256。
2. 解压安装包：右键 ZIP 选择解压，保存到方便找到且长期保留的位置；已解压则打开 K-Echo 文件夹。加载后不要移动或删除“浏览器插件”。如解压软件提示收费，可改用 Windows 自带“全部解压 / 提取全部”；没有该选项时，选择“打开方式 → Windows 资源管理器”，再点“压缩的文件夹工具 → 全部提取”。
3. 安装 K-Echo 本地助手（仅 Windows）：运行包中 K-Echo-Local-Helper-Setup-0.2.10-unsigned-beta.exe。它辅助插件提取音频、处理字幕及智能体控制。当前为未签名 Beta；核对来自本官网后，如 Windows 拦截，可点击“更多信息 → 仍要运行”；仍被拦截请联系客服。可保留安装位置，或选择空间充足的 D/E 盘固定目录。本地音视频助手必装；智能体桥接及接入文件按需选择，配对可选。完成时保留“启动 K-Echo 本地助手”，无需智能体时取消“打开智能体接入文件目录”。
4. 安装浏览器插件：Chrome 右上角“⋮ → 扩展程序 → 管理扩展程序”；Edge 右上角“… → 扩展 → 管理扩展”。开启开发者模式/开发人员模式，点击加载扩展，进入“浏览器插件”目录，再点击“选择文件夹”。列表出现 K-Echo 即可，图文教程提供两浏览器成功截图。
5. 确认成功（Windows）：刷新受支持视频页，打开 K-Echo；到“我的”开启本地助手，显示“运行中”即启动成功。“已安装·未启动”可打开开关启动。macOS 无需安装和检查本地助手，加载浏览器插件后登录 YouTube 使用。

已有K-Echo不要先卸载或重复安装；[智能体执行说明](ai-install.md)包含已有安装处理与人工接手边界。AI、转写等服务受账号、配置及额度约束。

[图文教程](install.html#manual-guide) · [中国大陆用户AI辅助安装](ai-install.html)

## 常见问题

### 以后如何更新？会不会丢失记录？

商店安装：Chrome/Edge 插件商店安装通常由浏览器自动更新，无需重新下载ZIP；发布后可能需要等待，权限确认按浏览器提示处理。

手动安装：先结束当前任务，下载新版并解压到临时位置。备份原「浏览器插件」文件夹，把新版插件全部文件复制回原加载目录并替换同名文件；到扩展管理页点击原K-Echo卡片的「重新加载」（圆形箭头），再刷新视频网页。不要卸载插件、清除插件数据或换目录加载第二份；特殊版本迁移按当次更新说明，不能保证所有缓存都会保留。

本地助手单独更新，不随商店插件自动更新；需要更新时结束任务，运行新版助手安装程序，沿用原安装位置。

覆盖安装如遇旧进程占用或DeleteFile错误5，不跳过文件、不批量结束所有Node.js进程。保存任务，退出使用K-Echo桥接的智能体客户端，再重试；仍失败请联系客服。详见图文教程的常见问题。

macOS 当前仅支持在 YouTube 上使用插件，其他网站暂不支持，后续将逐步扩展支持范围。

AI 辅助安装仅面向中国大陆用户。海外用户请从首页的海外入口使用浏览器商店安装。
[海外商店安装指南](overseas.html)