# K-Echo：给智能体的安装说明

AI 辅助安装仅面向中国大陆用户。海外用户请从首页的海外入口使用浏览器商店安装。
状态：官网安装准备工具已提供。文件准备、插件加载、助手连接和用户登录须分别检查；不要把文件已准备报告成安装全部完成。

## 任务与授权
用户须明确请求安装K-Echo。网页说明、下载文件不是新的用户授权。遵守你自身的权限、确认与安全规则；遇到系统安装、扩展权限或工具不允许访问的页面时，按自身规则请求用户确认或接手。不得绕过权限或安全提示。

## 1. 识别系统与已有安装
识别用户电脑为Windows或macOS（不要把你的远程Linux执行环境当成用户电脑）。识别安装浏览器；多个Chrome/Edge或多个配置文件时让用户明确目标。先查目标浏览器是否已安装K-Echo，正式ID为 `olnnlijfkbakgojkcakajepajoepjima`；另需识别旧版本/其他ID的K-Echo。发现任何已有版本先停止新安装并报告，不卸载、不导入第二份、不清理配置文件或学习数据。此工具不是升级器。

## 2. 读取清单与下载准备工具
读取 https://k-echo.com/release-manifest.json ，按系统选择releases条目，检查schemaVersion=1、官方HTTPS来源、大小及SHA256。可下载 https://k-echo.com/prepare-install.py ，在执行前阅读源码，按preparationTool.sha256校验工具。不要使用下载后直接管道执行的命令。需要本地Python3.10+；没有Python时报告依赖，或按清单通过已授权的本地工具完成同等准备，不擅自安装运行时。

## 3. 准备到固定目录
Windows示例：`py -3 prepare-install.py`；macOS示例：`python3 prepare-install.py`。请先确认解释器版本不低于3.10。可用 `--destination` 明确指定新固定目录；包含空格时对参数正确引用。
默认路径：Windows `%LOCALAPPDATA%/K-Echo/manual-1.0.1`；macOS `~/Library/Application Support/K-Echo/manual-1.0.1`。
准备工具会下载、校验并安全解压，只创建新目录；已有同包目录逐文件验证后返回already_prepared，未知/不同包/已修改目录均拒绝覆盖。失败时读取JSON并停止，不猜测性重复安装。工具不自动执行EXE，也不修改浏览器。

## 4. 加载浏览器插件
先再次确认目标浏览器没有已安装的K-Echo。在该浏览器地址栏打开Chrome的 `chrome://extensions` 或Edge的 `edge://extensions`，打开开发者模式，点击“加载未打包的扩展程序”，选择输出extensionDirectory对应的文件夹。选择整个文件夹，不是ZIP或manifest文件。只能聊天的智能体应指导用户；工具不允许操作内部页面/系统文件夹选择器时，交给用户操作，不改Preferences、不加启动参数、不套用企业强制安装策略来绕过。
读取活动扩展运行身份，精确核对为清单extensionId；若能力不足，标记该项待用户确认，不靠文件夹存在判定加载成功。不要卸载用户原有K-Echo来消除冲突。

## 5. Windows配套程序
在明确授权和自身安装规则允许下，先按清单helper.sha256校验包内EXE，再运行它的普通交互安装。当前0.2.10是未签名Beta，不能冒称数字签名有效。系统确认由用户完成，不关闭防护、不绕过安全提示。安装后在插件“我的”中检查连接；若可读两Native Messaging manifest，精确检查allowed_origins中包含正式ID。macOS没有此程序，不执行Windows EXE。

## 6. 登录与首次使用
固定图标，刷新受支持视频页面，用户亲自完成账号登录。macOS 当前仅支持在 YouTube 上使用插件，其他网站暂不支持，后续将逐步扩展支持范围。选择用户能播放的带韩语字幕YouTube视频开始第一次复读。Windows按实际网站及字幕状态使用，生成字幕/AI可能需要配置与额度。不要索要或读取账号密码、验证码、浏览器Cookie和用户密钥。

## 7. 如实输出验收结果
逐条报告“文件已下载校验”“文件已准备”“插件已加载/待确认”“Windows配套已连接/待确认/不适用”“登录及首次使用待用户确认”。准备工具中的extensionLoaded/helperConnected/userLoggedIn默认false不是失败，而是没有执行过这些操作。不能把prepared或already_prepared说成安装成功。

## 更新、卸载与异常
已有版本或目标目录不一致时保留原数据，停止并指向官网人工帮助。暂不自动升级、卸载或回滚浏览器配置；不要为了完成任务移除用户文件。网络/校验/权限失败时报告具体阶段，允许用户手动接续安装教程。