ChatGPT Windows 桌面端的统一助手框架。目前内置 分支 和 书签 两个功能模块，后续功能继续在这个框架内开发，共用启动、客户端连接和模块生命周期。
沿用本机原分支助手的连接架构。它是依赖客户端内部组件的本地原型，未修改客户端安装文件，不调用额外模型 API，也不会自动发送聊天消息。
安装 Node.js 22 或更新版本，双击 打开GPT助手.cmd。已连接的旧助手会先保存记录，再连接新版；客户端没有启动时，启动器尝试启动已安装的正常版客户端。
仓库地址：Tetro02/gpt-assistant。也可使用英文入口 launch.cmd。
聊天客户端须提供本机调试连接；默认端口 19347。外部书签链接服务使用 19348，仅监听 127.0.0.1。助手关闭时，链接不可用。
| 功能 | 用途 |
|---|---|
| 对话分支 | 选中文字后开启分支聊天，保留此前上下文；用树形列表管理分支、子分支和原文跳转。 |
| 原文书签 | 保存某条消息中的一行或一段文字，跨聊天跳回原文；支持搜索、重命名和移除。 |
| 格式预览 | 书签预览保留加粗、上下标与公式，减少重复的公式辅助文本。 |
| 外部跳转 | 复制本机书签链接，放进笔记或浏览器收藏夹，保持助手运行即可打开定位。 |
| 模块扩展 | 新功能注册到同一框架，共用客户端连接、热更新及资源清理机制。 |
分支工作方式可参考历史使用示例；其中截图为 0.3.3 界面。
统一名称、版本和模块清单由 assistant.config.cjs 与 package.json 管理。inject.cjs 按模块清单加载代码、管理热更新，并通过 window.__gptAssistant 提供统一模块入口。当前模块为 branches（分支）与 bookmarks（书签）。
新功能作为模块加入同一清单，无需另起一套连接程序。开发约定见 模块扩展指南。历史源码文件名、存储键和目录名保留兼容，现有记录与链接可以继续使用。
Release 中的 Windows ZIP 只包含 打开GPT助手.cmd、功能简介与使用说明.md、LICENSE 和 app/ 程序目录。测试、开发约定和历史截图保留在源码仓库，不随运行包分发。私人分支与书签记录、备份、日志及本机调试资料均不会打包。
- 统一产品名称为“GPT助手”，新增统一启动入口和模块注册清单。
- 在原生划词菜单添加书签；拖选过程中隐藏操作按钮，兼容分数和带方框的公式选区。
- 书签面板保留加粗、上下标和数学结构，过滤重复的公式辅助文本。
- 分支与书签上下排列，从入口位置展开；文件预览中避开“打开”、下载和分享工具栏。
- 定位高亮约 1 秒后消失，用户点击、滚动或键盘操作时立即清除。
- 独立文件保存、旧助手状态迁移和本机外部链接跳转。
没有第三方运行依赖，也不需要安装依赖包。
npm run check
npm test
运行 powershell -ExecutionPolicy Bypass -File tools/build-release.ps1 可生成精简 Windows 下载包和 SHA-256 校验文件。
自动测试覆盖记录校验、文件保存与恢复、请求来源校验和链接分发；真实客户端交互验证另见验证记录。
branch-state*.json*、bookmark-state*.json* 和备份包含私人聊天片段、位置标识及书签链接编号，已由 .gitignore 排除，不进入版本控制。
采用 MIT 许可证，安全说明见 SECURITY.md。这是非官方项目，与 OpenAI 无隶属或认可关系。