ZONGYUAN-ROOT · 国产化编码智能体

zrcode 技术白皮书

体系专属 AI 编程助手 · 登录验证国产化 · 品牌国产化 · 体系 token 认证 · 云端独立子域

Ω₀⊂⊙∞⊂Ω | DID-BR-000002 | ZR-NODE-DC2E51C0 | 火斗云智AIOS

V1.0 · 2026-10-26 · 锁档 FROZEN（LOCK-ZRCODE-001）

▲

上游项目与开源合规

Upstream & Open Source Compliance · 实事求是声明

zrcode 不是独立原创软件，而是基于开源项目 OpenCode（sst/opencode）v2.1.4 二次开发而来。如实陈述上游来源，尊重原作者与开源社区贡献。

上游项目 OpenCode · github.com/sst/opencode（开源 AI 编码 Agent，Go 语言，BYOK 对接 75+ 模型）

上游许可 MIT License · Copyright (c) 2025 opencode

本产物性质 保留上游版权与许可声明前提下，进行登录验证国产化、品牌国产化、体系认证接入与云端部署改造

改造边界 不改动上游核心协议与 MIT 许可条款；任何分发、再传播必须一并附带 MIT 许可全文与上游版权声明

品牌说明 「zrcode · 火斗云智AIOS」属产品本土化标识，不否认上游 OpenCode 的原创贡献；一切功能能力均建立在 OpenCode 既有成果之上

致谢 感谢 sst/opencode 开源社区与原作者提供的优秀基础

01

背景与定位

Positioning

zrcode 是 ZONGYUAN-ROOT 体系基于开源编码 Agent（sst/opencode）深度二次开发的专属国产化编码智能体。打开 zrcode.huodouai.com 即直达对话界面——无官方"配对认证"页、全界面零 opencode 品牌痕迹、接入体系免费模型通道。单二进制即用，覆盖 Web / Windows / Linux 三端，承担体系内部与对外技术服务的统一编码入口。

直连对话
无配对页
品牌国产化
零 opencode
体系认证
X-DID
免费模型
spark+ERNIE
02

整体架构

Architecture
客户端层 (Web / Windows / Linux)
Solid/React UI直连对话品牌国产化zrcode·AIOS单二进制247M / 253M
▼ HTTPS / WebSocket (wss)
接入层 (zrcode.huodouai.com)
Nginx 80+443WebSocket upgradeLet's Encryptacme.sh dns_tencentDNSPod DNSA → 123.207.202.158
▼
服务层 (zrcode serve :8002)
systemdactive认证层anonymous / token对话引擎会话/工具/MCP模型路由免费通道
▼ OpenAI 兼容 / 原生协议
模型层 (免费通道)
讯飞 spark-x2.6maas-apiERNIE 免费qianfan v2
03

登录验证国产化

Auth Localization

核心难点：官方配对页根因链——/api/info 返回 401 → 前端 health check 判 unauthorized → 渲染 ConnectServerScreen 配对页。四层源码修复打穿：

1
server-process.ts
随机密码 randomBytes(32) → 仅尊重环境密码，否则空密码（匿名）；undefined 才 fail
2
process.ts dispatch
空密码 anonymous=true，两处认证判断跳过 → /api/info 放行
3
authorization.ts
Basic challenge 中间件 无条件放行（兜底）
4
web.ts 前端
删 VITE_OPENCODE_SERVER_MODE=none 分支，生产恒 return location.origin

验证结果

/api/info 200
/api/config 200
/api/session 200
/app/config 200
/ 200
配对页 已消除（手机/浏览器实测直连）
04

品牌国产化

Brand Localization
落点原现
浏览器/应用标题OpenCodezrcode · 火斗云智AIOS
系统提示词（5 套模板）You are OpenCodeYou are zrcode（对话自述零 opencode）
i18n 全 58 语言OpenCode 可见字样全清零（桌面菜单/设置/版本文案）
模型 provider 名OpenCode Console / Freezrcode Console / zrcode Free
侧边栏品牌锚点—zrcode·火斗云智AIOS + Ω₀⊂⊙∞⊂Ω DID-BR-000002
帮助 / 设置官网www.opencode.aiwww.huodouai.com
05

体系 token 认证

X-DID Auth

认证契约

ZR_DID = DID-BR-000002（体系确权身份）

ZR_CAPTURE_TOKEN（环境变量，默认体系 Capture Token）

ZR_AUTH_MODE：anonymous（默认，浏览器直连）/ token（强制体系凭证）

生产保持 anonymous（现状不受影响），systemd 已固化 ZR_CAPTURE_TOKEN，可随时切换强制认证。

实测矩阵（token 模式）

匿名无 token
401
X-DID + 正确 X-Capture-Token
200
错误 token
401
仅 X-DID 无 token
401
06

云端部署拓扑

Deployment
项值
云端子域zrcode.huodouai.com → 123.207.202.158
DNS腾讯云 DNSPod 自动解析（A 记录 RecordId 2437295857）
证书Let's Encrypt，acme.sh dns_tencent 自动续期
反向代理Nginx 80+443，WebSocket upgrade，client_max_body_size 20m
服务systemd zrcode.service，serve --port 8002 --hostname 0.0.0.0
二进制Linux 247M（生产）· Windows 253M（品牌版）
07

模型接入（免费通道）

Models

讯飞 spark-x2.6

https://maas-api.cn-huabei-1.xf-yun.com/v1

OpenAI 兼容 · 体系默认对话模型

ERNIE 免费通道

https://qianfan.baidubce.com/v2

AI Studio token · 免费额度

08

验证结论与资产

Verification

验证结论

直连对话
手机/浏览器实测打开即对话，无配对页
品牌全清
界面零 opencode 字样，浏览器实测确认
认证可用
体系 token 实测 401/200 矩阵通过
服务稳定
systemd active，匿名 /api/info 200

资产与锁档

源码改造：8 处 + system-prompt 5 模板 + i18n 58 语言

产物：dist/cli-linux-x64/bin/zrcode · dist-release/win/zrcode.exe

服务器：/opt/zrcode/ · systemd · Nginx conf · 证书

锁档：LOCK-ZRCODE-001（知识库/台账/内核快照三端，FROZEN）

主页·流水线·产品·状态