Cindy 版本选择指南：cn 还是 global
【免费下载链接】cindyConsider it done. The open-source AI agent that works out of the box · 想到，就能做到。开源、开箱即用的 AI Agent。项目地址: https://gitcode.com/GitHub_Trending/cind/cindy
一屏速览：两个区域构建的关键差异
Cindy 是一个开源、开箱即用的 AI Agent（能在你电脑上替你干完真实活的数字伙伴）。它提供两个区域构建，版本选择速览如下：中国大陆版（cn）连接cindy.com.cn云服务，Global 版（global）连接cindy.app云服务。关键差异见下表：
| 维度 | 中国大陆版（cn） | Global 版（global） |
|---|---|---|
| 官网域名 | cindy.com.cn | cindy.app |
| 服务域名 | auth / device-link / oss / voice / plugin / cdn 均走*.cindy.com.cn | 对应服务均走*.cindy.app |
| 端点配置路径 | config/endpoint.json | config/endpoint.global.json |
| 桌面数据目录 | Cindy | CindyGlobal |
| 系统 appId | com.xd.cindycn | com.xd.cindy |
| 界面标注 | 登录页与侧栏显示CN徽标 | 无任何版本标签 |
| 定价渠道 | 大陆官网独立定价 | 国际官网独立定价 |
区域是构建期决策，装完不可切换。
端点配置就是客户端要连接的全部云服务地址清单，路径不同，里面的域名整套不同。
为什么拆成两个构建：region 是打包时注入的
区域（region）是个构建期维度：打包时把对应的端点清单和系统身份（appId，可理解为应用在操作系统里的"身份证号"，用来区分不同应用）一起烘焙进安装包。装完以后运行期没有任何切换入口，产品里也不存在"请选择你的地区"这类页面。
所以两个版本的差异不是功能缩水，代码基线是同一份——差异来自构建参数（打包时注入的区域取值）。中国大陆版是为当地法规、网络与服务依赖单独构建的版本，产品规则还要求中国大陆特有的服务不作为全球默认项。两份端点清单分别位于 config/endpoint.json（中国大陆版）与config/endpoint.global.json（Global 版）；界面标不标徽标、标什么，固化在 apps/desktop/src/shared/regionCode.ts：中国大陆版拿CN徽标，Global 版不加标签——默认形态不需要向谁自证是全球版。
三步锁定你的版本
如果你已经在某个官网注册过账号，这一条直接定生死：两个版本的账号体系相互独立，中国大陆账号必须在 cn 构建上用，国际版账号必须在 global 构建上用，登录态不互通。
如果你是第一次安装、准备注册账号，看日常网络环境。常年在大陆网络里，选中国大陆版，*.cindy.com.cn的服务在国内访问更稳；长期在海外、或主要依赖海外网络，选 Global 版。网络情况拿不准的，按账号和支付渠道反推也行。
如果你要付费，看支付渠道。两个版本各自官网都有独立的定价与订阅渠道，选和支付渠道一致的那个，别给自己留下跨区续费的麻烦。
💡 只是想先体验的话，还有"跳过登录"路径：不登录 Cindy 账号，两个版本都能直接用本机 agent 能力（应用内显示"未登录"），只有依赖云端的能力不可用；用本地模型开箱即用。
装完之后能改吗
直接回答：不能。区域烘焙在安装包里——端点清单、系统身份、更新渠道，都在打包时定死。设置里没有"切换地区"，切换的唯一做法是：卸载，重装另一区域的安装包，再用对应区域的账号登录。
自动更新渠道也各自独立：cn 走大陆官方 CDN，global 走国际官方 CDN，互不交叉，也不存在跨区更新。
再提醒一句：会话、定时任务这类云端数据不会跨版本自动迁移。装错的成本不高（重装即可），但想长期使用、尤其是已经积累了会话和定时任务的使用者，装之前想清楚。
两个版本能同机共存吗
系统层面看似能共存：两个版本的 appId 不同（com.xd.cindycn对com.xd.cindy），桌面端数据目录也分开（Cindy对CindyGlobal），登录态、数据库、会话彼此隔离。
⚠️ 但实际文件层已经在互抢。2026-07-26 起两个版本的程序名统一为Cindy，同机双装的安装目录与快捷方式同名互抢：后一个安装会覆盖前一个的文件，更新器按程序名杀进程也可能波及另一个区域。该场景官方已明确放弃支持。
一句话建议：一台机器只装一个区域版本，用哪个装哪个；确需双版本运行，把另一份放进虚拟机或另一台机器。
从源码构建：指定区域参数
如果你是贡献者，或需要从源码构建，区域通过构建参数显式指定，默认值是global：
# 中国大陆版（必须显式传参） pnpm restart:desktop:remote --region=cn # 国际版（省略参数时等价于它） pnpm restart:desktop:remote --region=global--region=cn时客户端读取config/endpoint.json，--region=global时读取config/endpoint.global.json；中国大陆版必须显式传--region=cn，别依赖默认值。- 区域解析逻辑（
cn/global/dev三值、默认global、非法值直接报错，防止打出身份错误的包）集中在 packages/maker-shared/src/brandIdentity.ts，是构建期单点，不是运行时开关。 - 还有第三个取值
dev：它是内部开发构建身份（独立程序名CindyDev），不是面向用户发行的版本，普通用户不会遇到。 - 完整的桌面端开发启动流程见 docs/dev-rules/desktop-development.md。
快速答疑 + 决策口诀
Q：装错版本，登录后能在应用里切吗？不能。区域是构建期维度，应用内没有切换入口。切换等于卸载、重装对应区域安装包、再用对应区域的账号登录。
Q：两个版本功能有差别吗？客户端功能基线相同，差异只在连接的云服务域名、账号体系与定价渠道；中国大陆特有的第三方入口只出现在 cn 构建里。
Q：怎么确认自己装的是哪个版本？登录页与侧栏显示CN徽标的是中国大陆版，完全没有标签的是 Global 版；也可以看下载来源域名，cindy.com.cn是大陆版，cindy.app是国际版。
📦 对号入座：
| 你的情况 | 推荐选择 |
|---|---|
| 大陆网络环境 + 国内支付渠道 | 中国大陆版（cn） |
| 海外环境 + 国际支付渠道 | Global 版（global） |
| 已有某区域账号 | 必须装对应区域版本 |
| 只是体验、用本地模型 | 任一版本 + 跳过登录 |
带走的口诀就一句：账号在哪边、网络在哪边，就装哪一边——区域在安装那一刻定终身，之后的服务、数据与更新都围绕它展开。
【免费下载链接】cindyConsider it done. The open-source AI agent that works out of the box · 想到，就能做到。开源、开箱即用的 AI Agent。项目地址: https://gitcode.com/GitHub_Trending/cind/cindy
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
 到 longAccumulate() 源码解析)
