md3c-knowledge

Maps TikTok 3V datacenter hierarchy and environment detection functions for Go services.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill md3c-knowledge-yuezhen-huang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: md3c-knowledge
Source: https://github.com/yuezhen-huang/my-bytedance-skillhub/tree/main/md3c-knowledge
Command: npx skills add https://github.com/yuezhen-huang/my-bytedance-skillhub --skill md3c-knowledge-yuezhen-huang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? TikTok's infrastructure uses a hierarchical 3V model (VGeo, VRegion, VDC) that is easy to confuse, especially with legacy region names like alisg, i18n, and ttp. This Skill provides the authoritative mapping and the correct Go environment functions so you write region-aware code without guessing. ## Core Features & Use Cases - 3V Hierarchy Reference: Complete mapping of VGeos (VGeo-EU, VGeo-ROW, VGeo-US) to VRegions and physical VDCs, including legacy name aliases and testing (BOE) environments. - Environment Function Guide: Documents env.IDC(), env.GetCurrentVRegion(), region_lib.VGeo(), and BOE detection helpers from gopkg/env and tiktok/region_lib. - Deprecation Guidance: Flags deprecated APIs like env.Region() and points to their modern replacements. - Use Case: When writing a Go service that must behave differently per compliance zone, look up the current VGeo with region_lib.VGeo() and gate EU-specific logic on region_lib.VGEO_EU. ## Quick Start Ask how to detect the current VRegion and VGeo in a TikTok Go service and which constants to compare against.

Frequently Asked Questions about md3c-knowledge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get the current VRegion in TikTok Go code?

Call env.GetCurrentVRegion() from code.byted.org/gopkg/env to get the current VRegion. Compare it against constants like env.VREGION_USEAST, which follow the pattern env.VRegion_${VRegion.replace('-', '').upper()}.

What is the difference between VGeo, VRegion, and VDC?

VGeo represents compliance zones like VGeo-EU, VRegion subdivides a VGeo into logical regions such as EU-TTP, and VDC is the physical datacenter like ie or useast5. The hierarchy runs VGeo containing VRegions containing VDCs.

How do I detect BOE testing environments in Go?

Use env.IsBoe() to detect any BOE environment, env.IsBoeI18N() for US-BOE, and env.IsBoeCN() for China-BOE. env.IsProduct() is equivalent to !env.IsBoe() for production checks.

Is env.Region() deprecated and what replaces it?

Yes, env.Region() is deprecated in favor of env.GetCurrentVRegion(). Old region constants like env.R_MALIVA and env.I18N map to new VRegion constants such as env.VREGION_USEAST and env.VREGION_USEASTRED.

Which VGeo does the Singapore datacenter belong to?

Singapore datacenters (my, my2, my3, sg1) belong to the Singapore-Central VRegion under VGeo-ROW. Singapore-Central was previously referred to as alisg in legacy Region naming.