使用指南
Eclipse 星语使用教程：第一次对话、审批模式、隔离脚本环境与全局记忆
使用指南
欢迎使用 Eclipse 星语，一款专为 Xiaomi Vela 手表 / 手环设计的 AI 对话客户端。本指南将帮助您完成第一次对话，并了解审批模式、隔离脚本环境等安全机制。
系统要求
- 网络连接（小米运动健康后台连接或 eSIM网络）
如果您不喜欢由我们官方中转站提供的模型,您也可以自备兼容OpenAI协议的中转站使用
设备适配
| 设备型号 | 适配情况(或原因) |
|---|---|
| 小米 S1 Pro 运动健康手表 | ✓ |
| 小米手环 8 Pro | ✕（框架版本过低） |
| 小米手环 9 Pro | ✓ |
| 小米手环 10 Pro | ✓ |
| Xiaomi Watch S3 | ✓ |
| Redmi Watch 4 | ✕（框架版本过低） |
| 小米腕部心电血压记录仪 | ✕（框架版本过低） |
| 小米手环 10 | ✓（界面未经过专门适配） |
| Xiaomi Watch S4 | ✓ |
| Redmi Watch 5 | ✓ |
| Redmi Watch 6 | ✓ |
| Xiaomi Watch S5 | ✓ |
请注意！由于本应用涉及prompt.showDialog的调用,针对于小米手环9Pro/10Pro有全屏提示按钮错位问题!请谨慎使用
关于小米手环 10 Pro 的网络连接
请注意！小米手环 10 Pro 被识别为硬件层面无法直接联网，需要配合 SimpleFetch（AstroBox 网络桥接插件）激活网络后才能正常对话。手环 10（非 Pro）同样依赖 SimpleFetch 提供联网。
遇到"网络连接失败 / 无网络"时，按此排查：
- 确认您的设备型号是否需要 SimpleFetch 桥接（见上表）
- 若需要，先完成 AstroBox + SimpleFetch 的安装与激活
- 若仍失败，检查手环是否保持在小米运动健康 App 的连接范围内
- 最后确认服务商地址可访问、登录凭据有效（仅在自备服务商时需检查密钥是否填写正确）
激活应用
首次启动
安装并打开 Eclipse 星语。首次使用会先阅读并同意隐私政策，然后进入激活步骤：
- 页面会显示一个购买二维码，用手机扫码进入爱发电完成购买
- 购买后回到手表，点击"下一步"，应用会自动完成激活
使用官方中转不需要你自己填写任何密钥。激活时应用会携带设备标识向官方服务校验，通过后自动获取并保存登录凭据（不会以明文落盘）。激活完成后选好模型即可开始对话。
如果你想改用自备服务商，在设置 → 服务商中点击"新增供应商"，填写以下信息：
| 字段 | 说明 |
|---|---|
baseUrl | OpenAI 兼容的服务地址，例如 https://api.example.com/v1，末尾到 /v1 为止 |
apiKey | 服务商后台生成的登录密钥（保存在设备本地） |
自备服务商需要支持 OpenAI 的 POST /v1/chat/completions 接口与函数调用（tools / tool_calls），否则 AI 的工具能力无法使用。
选择供应商时，官方中转在任何会话中都可以随时点选；若你既配了自备服务商又切回官方，两条路线互不冲突。
选择模型
回到对话页，点击"获取模型"拉取该服务商可用模型列表，选择一个模型。官方中转目前提供 deepseek-v4.1-flash、glm-5.3-flash、gpt-6.1-sol、grok-4.7、gpt-6-astra、Qwen3.5-4B，价格见模型列表。
每次获取都会把本地列表完整同步为服务端当前可用的模型：已经下线的旧模型会被自动清掉；如果你原先选中的模型已下线，应用会自动切换到列表中的第一个可用模型。
如果"获取模型"无响应或为空，请检查网络连接与服务商地址是否可达（部分型号需先激活 SimpleFetch 桥接）。
发送第一条消息
在输入框输入内容，按下发送。
正常的话，几秒内 AI 就会开始回复。如果很久也没有返回内容，请检查供应商配置或重新尝试。
如果这一轮最终失败（网络异常、额度不足、服务商报错等），AI 气泡下方会出现"重新生成"按钮。点击即可原地重试：不会新增提问，重新生成的回复会直接覆盖刚才失败的那条气泡。
小技巧：如果希望 AI 长期记住你的偏好（比如"我喜欢简洁的回答"），直接对它说"记住我喜欢简洁"即可，它会自动写入全局记忆，今后所有会话都生效。
审批模式（工具调用授权）
AI 需要操作设备 / 文件时，会调用"工具"（如读写文件、调节亮度、震动、查询位置等）。审批模式决定每次调用是否征求你的确认。
在对话设置中可以切换三种模式：
| 模式 | 行为 | 适用场景 |
|---|---|---|
| 手动 | 每一次工具调用都弹出"申请调用"，需点允许 / 拒绝 | 对 AI 行为不放心，希望完全掌控 |
| 智能（默认） | 只读类工具自动放行，其余工具需确认 | 日常使用推荐 |
| 绕过（橙色） | 所有工具直接放行，不逐次询问 | 与 AI 深度协作、信任度高时 |
选择"绕过"时，界面会弹出橙色确认框提醒您：AI 将可自动读写文件、控制震动 / 亮度 / 音量 / 定位等设备能力。该模式仅对当前会话生效，退出对话后自动恢复默认。
智能模式下自动放行的只读操作
| 工具 | 说明 |
|---|---|
read_file | 读取本地文件 |
list_files | 列出文件 |
search_file | 搜索文件 |
get_brightness / get_volume | 读取亮度、音量 |
get_device_info / get_battery | 设备信息、电量 |
get_network / get_location / get_time | 网络、定位、时间 |
其余工具（create_file、delete_file、run_js、vibrate、set_brightness、set_volume、show_toast、set_session_title 等）在智能模式下仍需逐次确认。
记忆工具（read_memory / update_memory）与任何审批模式无关，始终直接放行（详见全局记忆）。
全局记忆
Eclipse 星语内置跨会话生效的长期记忆：
- AI 可将值得长期记住的用户偏好、重要事项记入记忆
- 每个新会话的第一条消息，AI 会自动先读取一次记忆，因此开场就知道你的偏好与历史约定
- 除自动预读外，AI 也可以自行判断——当它觉得需要了解你的偏好或历史约定时，会主动读取，无需你开口要求
- 记忆内容受保护、无法被 AI 删除，但其中记录的信息可随时由 AI 更新
当 AI 读取或更新记忆时，聊天界面会显示绿色状态文本（"正在读取记忆" / "已读取记忆" / "正在更新记忆" / "记忆已更新"），且该状态会持续保留在消息上，方便您查看 AI 做了什么。
记忆开关
| 位置 | 设置项 | 作用 |
|---|---|---|
| 设置 → 记忆 | 记忆功能 | 全局总开关。关闭后 AI 完全无法读写记忆 |
| 设置 → 记忆 | 新会话默认启用记忆 | 决定新建会话的初始状态，已有会话保持各自设置 |
| 对话页 → 本对话设置 | 记忆功能 | 单独控制当前这一个会话，随会话保存 |
说明：
- 全局总开关关闭时，对话页的开关会失效（打开对话页会提示已在设置中关闭）
- 记忆关闭后，应用不会向模型下发记忆工具，系统提示中也不再提及记忆
- 清除当前记忆位于设置 → 记忆，需要连续点击两次确认；清除只是清空内容，记忆本身依然保留
如果不想让某条信息被长期记住，可以直接对 AI 说"忘掉这条"让它更新记忆，或到设置 → 记忆清空全部内容。
联网搜索
Eclipse 星语支持为任意模型开启联网搜索，无论是平台提供的官方中转模型，还是你自行接入的自定义供应商模型，均可直接使用。
借助实时检索结果作答，模型在处理时效性强、信息更新快的问题时，回答准确度显著提升，有效减少因知识截止造成的偏差。
如果要启用联网搜索功能,请在第二页控制区开启联网搜索功能，AI遇到实时性问题将自动调用联网搜索工具进行搜索
请注意，联网搜索为付费功能，每次联网搜索的价格为0.01-0.05额度，请确保额度充足，具体价格见下表
真的有人会在意这点钱吗
| 搜索引擎 | 特性 | 价格 |
|---|---|---|
| search_std | 满足日常查询需求，性价比极高 | 0.01 元/次 |
| search_pro | 多引擎协作显著降低空结果率，召回率和准确率大幅提升 | 0.03 元/次 |
| search_pro_sogou | 搜狗：覆盖腾讯生态（新闻/企鹅号）和知乎内容，在百科、医疗等垂直领域权威性强 | 0.05 元/次 |
| search_pro_quark | 夸克：精准触达垂直内容 | 0.05 元/次 |
文件工作区
每个会话拥有一个独立的工作区，AI 对文件的读写默认被限制在自己的工作区内，不同会话之间互不干扰。
- AI 使用纯文件名（如
note.txt）时，操作的是自己的工作区文件 - AI 以
../开头访问时（如../note.txt），表示要访问工作区之外的文件，例如设备根目录或其他会话的文件 - AI 仍然可以看到所有文件的名字（
list_files会分两段列出"工作区文件"与"工作区外文件"），但看到不等于能改
跨工作区访问需要审批
一旦 AI 想读写工作区外的文件，应用会弹出全屏确认框，列出具体文件名，由你决定是否放行。这项审批在任何审批模式下都会弹出，包括"绕过"模式——工作区边界独立于审批模式。
- 点"允许本次访问"：仅本次放行，不会永久授权
- 点"拒绝"：AI 会收到拒绝结果并继续对话，不会反复重试
应用数据目录（如供应商密钥、会话数据）属于受保护区域，无论是否审批都不允许 AI 访问；全局记忆也只能通过记忆工具读写。
"本次对话更改的文件"列表会记录 AI 在本会话创建 / 删除的文件，点击即可查看或编辑，工作区文件同样支持。
隔离脚本环境（代码执行）
除了结构化工具，AI 还能编写并运行脚本（run_js 工具）。为了避免恶意或失控代码损坏设备，脚本在一个隔离环境中执行：
受限模式（默认）
静态扫描会拦截以下危险代码：
| 拦截规则 | 说明 |
|---|---|
| 死循环写法 | 疑似无限循环 |
| 超大一次性内存申请 | 可能耗尽内存 |
| 无法自行结束的定时器 | 定时器可能造成资源占用 |
| 调试语句 | 禁止调试干预 |
此外隔离环境还强制限制：
- 定时器最多 20 个、单次延迟不超过 10 秒
- 只向脚本注入白名单能力（日志输出、提问输入、延时等待等少数能力），脚本无法访问文件系统、网络、系统能力与界面
- 工具调用有 8 秒超时兜底，超时不会导致对话中断
完全模式（高风险）
在对话设置中将脚本权限切到"完全"，将跳过上述静态扫描，可运行含定时器 / 循环的脚本。
选择"完全"同样会弹出橙色确认框，且该模式仅对当前会话生效，重新进入对话后自动恢复为"受限"。
拦截后的处理
当脚本命中危险代码时（run_js 触发），会弹出全屏拦截框。你可以：
- 点击"仍要运行（本会话）"：仅在当前会话放行该风险代码，新会话自动恢复保护
- 点击"取消"：放弃本次运行，对话正常继续
文件管理
AI 通过 create_file、read_file、list_files、search_file、delete_file 等工具管理文本文件，默认都在本会话的工作区内进行。您在对话中可让 AI "帮我写一个待办清单存成 note.txt"，它就会在自己的工作区里创建。
AI 在本次对话中创建 / 删除的文件会记录在"本次对话更改的文件"列表中，点开即可查看内容。你也可以在设置 → 文件管理里浏览设备上的全部文件（各会话工作区的文件会一并列出），并打开、编辑或删除。
文件列表与查看页只显示文件名、不显示所在路径，便于在手表小屏上阅读。
会话自动命名
会话标题会跟随聊天内容自动更新，你不需要手动整理：
- 自动命名：第一条消息回复完成后，应用会在后台请 AI 起一个会话标题；之后每完成 5 轮对话再更新一次
- 更新成功时，顶部标题栏会先短暂显示"已自动命名"，随后切换为新的名称
- 主动命名：你也可以直接对 AI 说"给这个会话起个名字"，它会立即按要求命名（这类请求会按当前"审批模式"逐次征求确认）
自动命名在后台静默完成，不会打断对话，也不会在聊天记录中留下多余内容。会话标题保存在设备本地，稍后在会话列表中可以按标题找到它。
如果你看到顶部标题忽然变了，那就是自动命名生效了——它只改变会话的标题，不会影响聊天内容。
如何续费
我们虽然有免费模型可用，但部分付费模型仍需要消耗应用内额度，具体的模型价格请见 模型列表
当额度过低时可能无法正常发起对话，您可以按照以下几种方案进行续费操作
1.常规方案
您可以在快应用内的 设置 -> 授权管理 -> 充值 中扫描二维码进行充值
2.特殊方案
您需要保证您的爱发电账号只买了一份 Eclipse 星语 快应用才可以无备注快捷入账
您可以在https://afdian.com/item/345f3c90b2fe11f1a6905254001e7c00 中直接购买您需要的金额，后台会自动充值入账
常见问题
为什么 AI 回复很慢或一直"思考中"？
通常是网络原因（桥接未激活 / 信号弱）或所选模型响应慢。可尝试切换模型，或检查网络连接。
为什么调用工具前会弹"申请调用"？
这是审批模式在生效。默认"智能"模式会放行只读操作，但创建 / 删除文件、运行脚本、控制设备等操作仍需确认。可在对话设置中改为"手动"或"绕过"。
"绕过"和"完全"同时开启会怎样？
等于把设备完全交给 AI：可任意读写文件、控制震动 / 亮度 / 音量、读取定位等。切换时橙色确认框就是为提醒这一点，请谨慎使用。
为什么 AI 能"记住"我之前说过的事？
那是全局记忆在起作用。每个新会话的第一条消息，AI 会自动先读一次记忆，所以开场就知道你的偏好；它也可以在后续自行判断主动读取。如果不想让某条信息被记住，直接告诉 AI 更新记忆即可，或到设置 → 记忆清空全部内容。
为什么 AI 读文件时会弹出"访问工作区外文件"？
因为那个文件不属于当前会话的工作区（可能在其他会话里，或在设备根目录）。应用会拦住这类访问并让你确认，即使是"绕过"模式也会拦截。点"允许本次访问"只对本次生效。
我不想让 AI 使用记忆，怎么彻底关掉？
到设置 → 记忆把"记忆功能"关掉即可。关闭后应用不会再向模型下发记忆工具，AI 也无法读写记忆；对话页的会话开关会同步失效。
我的会话名字怎么自己变了？
那是会话自动命名在起作用：第一条消息回复完成后会自动起一个标题，之后每完成 5 轮对话更新一次，顶部标题栏会短暂提示"已自动命名"后显示新名称。它只改标题，不影响聊天内容。
回复失败或内容为空怎么办？
AI 气泡下方会出现"重新生成"按钮，点击即可原地重试，不会新增提问，新回复会直接覆盖失败的那条气泡。若反复失败，请检查网络连接与账户额度，或换一个模型再试。
技术支持
如果您在使用过程中遇到问题，可以通过以下方式获取帮助：
- QQ群： 点击加入
感谢您使用 Eclipse 星语！