Xinyuan 0.21.7 便携版（合并上游 v0.21.7，修复键盘事件崩溃）

Xinyuan 0.21.7 便携版

基于 Hermes Agent 改造的本地桌面 AI 助手。
解压即用 —— 不需要安装 Python、Node，也不需要配任何开发环境。

本版把上游代码更新到 2026-10-12 的 main（紧随上游 release v0.21.7 之后），
窗口内约 1,737 个上游提交全部并入。

下载

文件	说明
Xinyuan-Portable-0.21.7.zip	Windows x64 便携包（约 272 MB）
SHA256SUMS.txt	SHA256 校验和，下载后可自行比对

使用步骤

1. 解压到任意位置（路径可以带中文和空格）

2. 双击文件夹里的 Start-Xinyuan.bat

3. 首次启动会弹出配置窗口，只需要填两样东西：

   字段	填什么
   API 密钥	你自己的 API Key
   模型名称	例如 gpt-4o-mini、claude-sonnet-4

   接口地址已经预填好了（https://yuangeluyou.com/v1，OpenAI 兼容格式），
   点地址右边的「修改」可以换成你自己的中转地址。

4. 点「保存并使用」，就能开始对话了

首次启动会比之后慢一些（要初始化后端，通常 20~40 秒，视磁盘速度而定），之后会更快。

系统要求

• Windows 10 / 11 64 位
• 需要能访问你配置的接口地址所在的网络

本版改动（相对上游 v0.21.7）

1. 修复用户反馈的偶发崩溃（本版重点）

有用户反馈应用偶发闪退。定位到的崩溃栈是：

Uncaught TypeError: Cannot read properties of undefined (reading 'startsWith')
  (app.asar.unpacked/dist/assets/combo-*.js)

根因在 apps/desktop/src/lib/keybinds/combo.ts 的 baseKeyFromCode()：它假定
KeyboardEvent.code 一定是字符串，但 IME / 合成键盘事件会给出 undefined，
于是 code.startsWith(...) 抛错、渲染进程崩溃。上游已在 #91611 修复，
本次合并把这个修复带了回来。

2. 上游重构了后端启动链路（旧包做法在新版会失效）

上游把依赖加载从「随包 venv 挂 PYTHONPATH」改成了「解释器自带 site-packages」，
并要求 Python 3.14（上游 50 个核心依赖里 45 个带 python_version >= '3.14' 标记，
在 3.11 上解析出来的依赖集是空的）。本版相应重建了运行时：

	旧版 0.17.3	本版 0.21.7
内置 Python	3.11	3.14.8
依赖位置	backend/venv/Lib/site-packages	runtime/python/Lib/site-packages
启动 PYTHONPATH	backend + venv site-packages	只有 backend

YAML 库也随上游从 PyYAML 换成了 ruamel.yaml。

3. 其余改动（沿用上一版，并随上游新增内容同步覆盖）

#	改动
1	品牌更名 Hermes → Xinyuan —— 界面文案、源码里用户可见的字符串、exe 版本元数据、页面标题，以及后端发给模型的系统提示与人格文件；本版额外覆盖上游新增的 locales/*.yaml、plugin-catalog/*.yaml 与桌面外壳 JS/TS。代码标识符一律未动
2	修复界面图标全部变成方块 —— 图标字体 codicon.ttf 缺失导致 Vite 保留了解析不到的 url()，所有图标渲染成豆腐块
3	API 配置精简为唯一入口 —— 删除全部供应商目录，只保留一个表单，接口地址预填且可改
4	替换上游品牌 logo —— 上游图标由 assets/nous-girl-*.svg 生成，本版换成中性标记后用上游自己的生成器重出全部图标
5	修复首次启动必然超时失败 —— 内置技能播种在慢盘上要 85~109 秒，超过桌面端 90 秒启动超时；改为预置技能后降到数秒
6	便携打包与启动器 —— 启动器纯 ASCII（避免 CP936 解析错位）、四个 %~dp0 环境变量，支持任意路径解压

改动逐项的现象、根因、修法与验证记录见
CHANGES.zh-CN.md。

⚠️ 安全提示（请务必阅读）

本版本为了让「解压即用」不打扰用户，默认放宽了上游的几项安全限制：

配置项	上游默认	本版本
approvals.mode	'smart'（需人工审批）	'off'
security.redact_secrets	true	false
security.allow_private_urls	false	true
security.protected_instruction_files	true	false

这意味着 AI 可以在你的电脑上直接执行命令、读写文件，而不再弹窗征求同意。
以上都写在 data/config.yaml 里，每项都有中文注释，随时可以改回去。

仍然保留、且无法通过配置绕过的硬性底线：rm -rf / 之类的灾难性删除、
sudo -S 明文喂密码、以及你自己在 approvals.deny 里加的规则 ——
这几项在进入「无审批」分支之前就会拦截。

上游与协议

• 上游：NousResearch/hermes-agent
• 上游基线：main @ 3569e846（2026-10-12），紧随上游 release v0.21.7
• 协议：MIT License —— Copyright (c) 2025 Nous Research（LICENSE 未做任何修改）
• 本项目仅为本地化定制与打包分发，核心能力全部来自上游，
  不对上游代码的正确性与安全性做额外担保