← 返回目录
k2.3概念⏱ 约 7 分钟

同一个工具的中国版和国际版,差的不只是界面

用包内证据看清两种构建的真实差异:代码发去哪台服务器、读哪个配置文件

🔎 最后验证 2026-08📚 来源:Qoder CLI 中国版包内编译期开关静态取证(2026-08-25)、本课 K1.4 数据外送红线
为什么学这个

上一节查了底细,这一节查一件更隐蔽的事:很多国内工具同时有“中国版”和“国际版”,而它们不是同一套服务

大多数人以为区别只是界面语言和支付方式。真正的区别在你看不见的地方:你的代码被发往哪台服务器、工具读哪个配置文件、日志写在哪。前者关系到 K1.4 那条数据红线,后两者决定了你照着网上教程做为什么不生效。

好消息是,这些不用装、不用注册就能看清楚——K2.1 那套 npm pack 的静态取证,把答案直接写在包里。

💡 打个比方

同一个品牌的连锁店,国内店和海外店可能共用招牌、共用菜单设计,但供应链、结账系统和后厨完全是两套

你在海外店办的会员卡,在国内店刷不出来;国内店的小票抬头也是另一家公司。“同一个牌子”是真的,“同一套系统”是假的。 软件的中国版和国际版,差不多就是这个关系。

差异写在代码里,一读就知道

还是 K2.1 那个中国版命令行工具的包,主文件里有一个中国版/国际版的编译期开关,成对写着两套常量,一共 49 组。挑最要紧的几组:

类别中国版国际版
服务端地址gateway.qoder.com.cnapi1~3.qoder.sh
官网域名qoder.com.cnqoder.sh
命令名qoderclicn / qodercnqodercli / qoder
配置文件.qoder-cn.json.qoder.json
忽略文件.qoder-cnignore.qoderignore
应用标识com.aliyun.lingma.idecom.qoder.ide
日志文件qoderclicn.logqodercli.log

第一行最重要:你的代码发去哪

服务端地址不同,意味着你的代码、你的报错、你贴进去的那段配置,发往的是完全不同的一组服务器。

这条直接接上 K1.4 的红线。合规同事真正会问的问题从来不是“这个工具好不好用”,而是:

  • 数据发到哪个域名、由哪家公司运营?(上一节查过了)
  • 有没有跨境?
  • 出事了找谁?

用中国版还是国际版,会给出三个完全不同的答案。 而这件事在产品界面上通常一个字都不会提——它藏在编译开关里。

第二组差异解释了一个日常困惑

配置文件名和忽略文件名不同,直接导致一件小而烦的事:你照着网上的教程建了 .qoder.json,中国版根本不读它,因为它找的是 .qoder-cn.json

这类问题最难查,因为它不报错——工具照常启动,只是你写的规矩一条都没生效。这和 K3.1 讲项目记忆时那个判据是同一件事:别问它“记住了吗”,去看那个文件到底叫什么、在哪。

怎么确认自己装的是哪个构建

三个不用联网就能看的地方:

  1. 命令名:你敲的是 qodercli 还是 qoderclicn?
  2. 配置目录/文件:home 目录下生成的是 .qoder 还是 .qoder-cn?
  3. 日志文件名:qodercli.log 还是 qoderclicn.log?

三个对得上,才说明你以为的和实际装的是同一个东西。

🔧 动手做:把差异表变成你自己的检查项(5 分钟)

不要背这张表——表会过期,方法不会。对你手上任何一个“有国内版”的工具做这三步:

  1. 找到它的配置目录(通常在 home 下,以点开头),看名字里有没有 cn 之类的地区标记
  2. 翻一下它的文档或包内文本,apigateway.com,把出现的服务端域名抄下来
  3. 把这两条写进你 K1.4 那份红线笔记:这个工具会把我的代码发到 ___,运营方是 ___。

你会看到:大部分工具的服务端域名并不难找,难的是没人想到去找。而这一行恰恰是合规审查唯一真正关心的。

为什么:选工具时你关心“好不好用”,过审时别人关心“数据去哪”。这两个问题的答案要一起准备好,否则工具用了三个月才被叫停,损失的是你的时间。

❓ 测验
同一个工具的中国版与国际版,下面哪一项差异对合规审查最要紧?
❓ 测验
照网上教程建了配置文件却发现规矩没生效,最可能的原因是什么?
⚠️ 避坑别把这张表背下来当结论

这张对照表是 2026 年 8 月从某个具体版本的包里读出来的。版本会变,常量会改,产品甚至会合并改名。

要带走的是方法:装完之后自己确认命令名、配置文件名和服务端域名。三条命令的事,而且换任何工具都成立——这比记住某一版的文件名有用得多。

✅ 小结

中国版和国际版不是同一套服务。包内的编译期开关成对写着两套常量:服务端从 gateway.qoder.com.cn 换成 api1~3.qoder.sh、配置文件从 .qoder-cn.json 换成 .qoder.json、命令名和日志名也各是一套。第一行最要紧——它决定你的代码发往哪家公司的服务器,正是 K1.4 那条红线要回答的问题;第二组差异则解释了一个不报错的日常困惑:照国际教程建的配置文件,中国版根本不读。确认方法只有三条:看命令名、看配置目录、看日志文件名。到这里,“该不该装、装的是什么、装完发去哪”都清楚了。最后一节回答那个我一直没回答的问题:这几个工具到底哪个好用?

下一节 → 横评只能你自己跑:一套 80 分钟的方案
🔎 来源与核验· 4 条,点开核对
本节每个关键论断都对应一个可追溯的来源 —— 这是本课程"靠谱、不过时"的底线。
「中国版与国际版在同一处编译期开关中成对定义了 49 组常量,含命令名、配置文件、日志文件与应用标识」
📚 Qoder CLI 中国版 npm 包 bundle 静态阅读(未执行,2026-08-25)✓ 已核验 2026-08
「服务端地址中国版为 gateway.qoder.com.cn,国际版为 api1~3.qoder.sh;官网域名分别为 qoder.com.cn 与 qoder.sh」
📚 同上编译期开关表✓ 已核验 2026-08
「中国版读取 .qoder-cn.json 与 .qoder-cnignore,国际版读取 .qoder.json 与 .qoderignore」
📚 同上编译期开关表✓ 已核验 2026-08
「数据外送的判断依据应包含服务端域名与运营主体」
📚 本课 K1.4 数据外送红线与 K2.2 底细核查方法✓ 已核验 2026-08
智图软件的赞赏码
都看到这了,打个赏呗!
接下来 · k2.4
横评只能你自己跑:一套 80 分钟的方案
继续读下一节 →