# 安装与更新吉+、吉听使用助手

本文供车友的 AI 阅读并执行。根据用户选择，安装 jiplus-guide（吉+）或 jilisten-guide（吉听）；两者分别安装。工具只处理公开技能文件，不连接车辆、不处理 App 激活、不读取聊天记录或账号信息。

## 确认环境和目录

需要 Python 3.8 或更新版本，只用标准库，不需要安装依赖。先检查当前 AI 是否能读写文件和执行 Python；普通聊天不具备这些能力时明确说明，不以“已学会”代替成功安装。

使用当前 Agent 已配置的技能目录。Codex 本地环境通常为 `~/.agents/skills/`，Claude Code 本地环境通常为 `~/.claude/skills/`；如果当前产品已明确配置其他目录，遵循该配置，不自行更改其他 AI 的设置。云端环境以该环境提供的技能导入方式为准。目标目录必须包含末级技能名，如 `~/.agents/skills/jiplus-guide`。

先阅读 [公开安装器](https://help.bobodisplaydiy.cc/skills/install.py)。下载保存到当前环境的临时目录后执行，不把它当作吉+或吉听的 App 源码。这是仅用于分发使用资料的独立工具。

## 下载并安装

以下为 macOS/Linux 示例，目标是 Codex 的默认本地目录；将目录改为当前 Agent 的实际技能目录。使用单独的临时文件，不覆盖已有同名下载。

```sh
installer_file=$(mktemp "${TMPDIR:-/tmp}/jiplus-skill-installer.XXXXXXXX")
curl --fail --location --proto '=https' --proto-redir '=https' https://help.bobodisplaydiy.cc/skills/install.py -o "$installer_file"
python3 "$installer_file" install --skill jiplus-guide --dir "$HOME/.agents/skills/jiplus-guide"
rm -- "$installer_file"
```

吉听把最后一行 Python 命令中的两处 `jiplus-guide` 改成 `jilisten-guide`；同时安装两款时，在删除临时安装器前分别执行两条安装命令。Claude Code 将 `.agents` 改成 `.claude`。

Windows PowerShell 可先下载到临时文件，再用已安装的 Python 启动器运行：

```powershell
$installerFile = Join-Path ([System.IO.Path]::GetTempPath()) ([System.IO.Path]::GetRandomFileName())
Invoke-WebRequest -Uri 'https://help.bobodisplaydiy.cc/skills/install.py' -OutFile $installerFile
py -3 $installerFile install --skill jiplus-guide --dir (Join-Path $env:USERPROFILE '.agents/skills/jiplus-guide')
Remove-Item $installerFile
```

若只有 `python` 而没有 `python3` 或 `py -3`，先确认其为 Python 3.8+ 再替换命令名称。网络失败时停止并说明原因，不关闭 TLS 验证，不从其他站点下载替代文件。

安装器只从官网 HTTPS 技能目录读取版本清单，核对 ZIP 大小、SHA-256、固定文件名单和逐文件摘要，再替换目标。不会运行下载包内的新脚本或改动其他技能。它拒绝路径越界、符号链接、未识别的原目录和降级。技能同版本却内容不同会保留原文件并提示核对，不静默覆盖本地修改。

原 1.0.0 资料包可直接升级。升级前会将原技能完整备份为 ZIP，放在技能目录旁的 `.jiplus-skill-backups` 中，并在结果中给出路径；备份不会被识别成另一个技能。更新失败时保留或恢复原目录；安装锁表示可能有另一个任务，先确认任务已结束再处理，不并发覆盖。

## 检查结果

仅在命令成功且返回 `installed`、`updated` 或 `up-to-date` 后报告对应结果；读取安装目录内的 `SKILL.md`，告知技能名、版本、目录及备份位置。必要时提示重新加载技能或开启新对话。`local-newer` 表示本地更高，不要降级；失败或网络不可用不能报告“已是最新”。

## 以后检查与更新

从已安装技能目录运行，或使用脚本的完整路径；下列脚本会根据所在目录识别自己的技能，不必填写账户或密钥：

```sh
python3 scripts/skill_manager.py check-update
python3 scripts/skill_manager.py update
```

每个新对话第一次使用本技能时执行一次 `check-update`；长对话超过 24 小时或用户主动要求时再查，不常驻后台，不逐条消息检查。检查只读官网清单，不上传对话。若用户已要求安装或更新，直接完成相应操作；仅咨询使用问题时，说明有更新并按用户意愿执行，不以更新为回答普通问题的前提。更新成功后重新读取新的 `SKILL.md`。

检查失败时说明暂时无法检查，仍可使用现有资料，并注明资料日期。技能更新不会更新车机 App，也不会改变激活、权益、配置或车型能力。

需要回退时，使用结果中列出的旧版备份 ZIP，先检查其内容与目标技能名，保留当前目录后再恢复原目录；不要把其他技能或 AI 配置一起覆盖。安装器不会自动删除历史备份。

## 无法运行 Python

可从[官网技能页](https://help.bobodisplaydiy.cc/ai-skills.html)下载 ZIP，通过当前 AI 的技能导入入口安装；完整保留技能文件夹。手动校验可读取 [吉+版本清单](https://help.bobodisplaydiy.cc/skills/jiplus-guide/latest.json) 或 [吉听版本清单](https://help.bobodisplaydiy.cc/skills/jilisten-guide/latest.json)，核对其指定 ZIP 和摘要。不支持执行脚本时不声称已完成自动版本检查。

不支持技能但能读文档时，使用[吉+完整资料](https://help.bobodisplaydiy.cc/skills/jiplus-guide.md)或[吉听完整资料](https://help.bobodisplaydiy.cc/skills/jilisten-guide.md)作为当前对话参考。普通聊天读取资料不等于已安装长期技能。
