# zy_home_vibe_coding_driver

**Repository Path**: juning-code/zy_home_vibe_coding_driver

## Basic Information

- **Project Name**: zy_home_vibe_coding_driver
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 知言家 Vibe Coding Driver

这是知言家 Vibe Coding 伴侣的本地驱动发布包。

## 安装

Windows 用户优先双击运行随发布产出的漂亮安装包：

```text
zy-vibe-coding-driver-*-setup.exe
```

如果只有 zip，也可以双击运行兜底安装入口：

```text
zy_home_vibe_coding_driver_installer.exe
```

安装器会让你选择安装目录，并可选择是否创建桌面图标、是否加入开始菜单。默认安装目录：

```text
%LOCALAPPDATA%\zy_home_vibe_coding_driver
```

如果检测到已经安装的版本，Windows 安装包会在用户确认安装后精确关闭该安装目录中的
旧驱动进程，再由 Go installer 以可回滚事务原位更新；不会先删除旧安装标记，也不会
启动旧版卸载器。
安装事务失败时 Setup 会立即中止，不会继续登记新版本或重复启动托盘。
zip 中的兜底 installer 不会覆盖旧安装，需要先手动运行原安装目录中的 uninstaller。

安装完成后会自动启动系统托盘程序。日常使用时，从系统托盘菜单打开配置页面、查看设备状态、电量和更新状态。
macOS 使用系统对话框显示安装/卸载确认；Linux 桌面环境优先使用 `zenity` 或 `kdialog`，
缺少桌面对话工具时退回终端确认。

安装目录中的核心程序文件为：

```text
zy_home_vibe_coding_driver_tray.exe
zy_home_vibe_coding_driver_updater.exe
zy_home_vibe_coding_driver_uninstaller.exe
zy_home_vibe_coding_driver_hookbridge.exe
```

这四个文件应位于同一个目录。安装器还会把 hookbridge 同步到
`%LOCALAPPDATA%\zy_home_vibe_coding_driver\bin`，让 Codex、Claude Code Hook 和 MCP stdio
在主安装目录被用户自定义后仍能共用同一个低延迟入口。安装器 `zy_home_vibe_coding_driver_installer.exe`
只属于安装包介质，不会复制进安装目录。
如果使用 Windows `*-setup.exe` 安装，安装包自己的 `unins*.exe/.dat` 也会放在这个安装目录，
作为系统“应用和功能”的卸载入口；旧版外置卸载目录会在安装/卸载时清理。

安装目录里的 `plugins` 目录是插件修复模板资源，不属于核心程序文件。
`release.json` 是本次驱动发布的元数据，供安装、排查和后续自更新流程识别版本边界。

## 日志

日志默认写入：

```text
%LOCALAPPDATA%\zy_home_vibe_coding_driver
```

常用日志：

```text
installer.log  安装器日志
service.log    驱动运行日志
update.log     驱动自更新日志
```

日志会按天归档，仅保留最近 7 天。Windows 安装包还会把 Go 安装事务的逐阶段输出写入
Setup 日志，并同步刷新安装进度条。

## 卸载

运行：

```text
zy_home_vibe_coding_driver_uninstaller.exe
```

卸载器会显示中文确认界面，移除驱动程序文件、快捷方式和本程序管理的开机启动项。
如果通过 Windows“应用和功能”或安装包生成的卸载入口执行，也会使用中文卸载提示。
Windows 卸载会清除 Go installer 写入的核心程序、插件模板和安装目录内的运行数据。
Codex、Claude Code、OpenCode、TRAE 等 AI 工具的用户级脚本和 Hook 配置不会自动修改
或删除；卸载完成后会提醒用户按需手动清理。
macOS 会移除本安装器创建的桌面符号链接；Linux 会移除本安装器创建的桌面和应用菜单
`.desktop` 文件。

## 插件配置

驱动会随包提供 Codex、OpenCode、Claude Code 和 TRAE 的插件模板，并通过 HookBridge 提供统一 MCP stdio 入口。TRAE P0 实现与验收
范围仅限 Windows 10/11 的“本地自动运行”；安装器或托盘修复只负责写入用户级模板，
用户仍需在 TRAE 的 Agent Hooks 设置中启用。正式发布还要求完成自动化测试与 Windows
实机验收；macOS/Linux TRAE Hook 当前不作支持承诺。

TRAE 用户级路径为：

```text
%USERPROFILE%\.trae-cn\hooks.json
%USERPROFILE%\.trae-cn\zy-vibe-coding-driver.ps1
```

TRAE 转发脚本使用独立 `source=trae`，只向本机 loopback Driver 发送裁剪后的事件元数据，
不会发送 Prompt、模型回答、完整工具输入/输出或 Notification 正文。详细的启用、Dry Run、
日志、状态验证与卸载清理请查看 `plugins\trae\README.md`。

人工安装和排查请查看：

```text
docs\插件配置指南.md
```

如果让 AI 工具协助安装插件，可以让它阅读：

```text
docs\AI插件安装指南.md
```

## 控制台版

发布 zip 会带有控制台入口：

```text
zy_home_vibe_coding_driver.exe
```

它只用于开发和排障，普通用户日常使用托盘版或 `*-setup.exe` 安装后的系统托盘即可。
安装到用户目录时不会复制控制台入口。