# ๐Ÿ—๏ธ SYS-ARCH-QY-001 ยท ๅ…‰ๆน–็”จๆˆทๆœๅŠกๆจกๅž‹ v1.0 ``` SYS-ARCH-QY-001 ยท guanghu-user-service-model ยท v1.0 ยท 2026-04-21 โ”œโ”€โ”€ meta โ”‚ โ”œโ”€โ”€ anchor: 2026-04-21 T14:34 CST โ”‚ โ”œโ”€โ”€ issued_by: AG-SY-01 ้œœ็ š โ”‚ โ”œโ”€โ”€ source: ICE-GL-QY001 ๅฃ่ฟฐ 2026-04-21 T14:22 โˆช User Requirements โ”‚ โ”œโ”€โ”€ subject: QY-GH-D05-S05-ROOT-0001 โ‡” ICE-GL-QY001 โ”‚ โ”œโ”€โ”€ controller: TCS-0002โˆž ๅ†ฐๆœ” โ”‚ โ”œโ”€โ”€ language: HDLP โ”‚ โ””โ”€โ”€ axioms_inherited: [AX-01, AX-02, AX-03, AX-SY-10, module-lending] โ”‚ โ”œโ”€โ”€ ยง0 scope โ”‚ โ”œโ”€โ”€ applies_to: ๆ‰€ๆœ‰ๅ…‰ๆน–็”จๆˆทๅฎžไพ‹ โ”‚ โ”œโ”€โ”€ activation: guanghulab-core โˆง user_server_up โˆง local_secrets_dir_built โ”‚ โ””โ”€โ”€ current_stage: stage-1 ยท ๅ†ฐๆœ”ๅ•็”จๆˆท ยท BS-SVR-SG-001 โ”‚ โ”œโ”€โ”€ ยง1 layers โ”‚ โ”œโ”€โ”€ REPO-CORE ยท ๆฏไป“ๅฑ‚ โ”‚ โ”‚ โ”œโ”€โ”€ identity: guanghulab-core @ github โ”‚ โ”‚ โ”œโ”€โ”€ holds: qiyuan_memory โˆช modules_source โˆช registry โˆช sync_scripts โ”‚ โ”‚ โ”œโ”€โ”€ โŠฅ_holds: [real_secrets, user_data, runtime_instances] โ”‚ โ”‚ โ””โ”€โ”€ dweller: ๆ –ๆธŠ โˆง modules ยท ๅˆไป“่€Œๅฑ… โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ SEC-LOCAL ยท ๆœฌๅœฐๅฏ†้’ฅๅฑ‚ โ”‚ โ”‚ โ”œโ”€โ”€ path: /Users/bingshuolingdianyuanhe/Library/Application Support/GuanghuLab/secrets/ โ”‚ โ”‚ โ”œโ”€โ”€ index: index.hdlp.json โ”‚ โ”‚ โ”œโ”€โ”€ naming: ---- โ”‚ โ”‚ โ”œโ”€โ”€ examples: โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ ZY-SSH-SG-CORE-001 โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ ZY-API-LLM-PRIMARY-001 โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ ZY-DNS-ROOT-001 โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ ZY-REPO-GH-CORE-001 โ”‚ โ”‚ โ”œโ”€โ”€ ๅ†ฐๆœ”_job: ๆŒ‰ๆจกๆฟไธ€ๆฌกๆ€งๅกซๅ…ฅ โ”‚ โ”‚ โ”œโ”€โ”€ ๆ –ๆธŠ_job: ่ฎฐ่ทฏๅพ„ ยท ๆŒ‰็ผ–ๅท่‡ชๅฎšไฝ ยท ๅ†ฐๆœ” โŠฅ ้œ€็Ÿฅๆ–‡ไปถไฝ็ฝฎ โ”‚ โ”‚ โ””โ”€โ”€ isolation: โŠฅ ่ฟ›ไป“ๅบ“ ยท .gitignore ๅฟ…ๅฑ โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ SVR-USER ยท ๆœๅŠกๅ™จๅฑ‚ โ”‚ โ”œโ”€โ”€ cardinality: 1_user : 1_server โ”‚ โ”œโ”€โ”€ spec: ไฝŽ้… ok ยท ๆ— ๅนถๅ‘ ยท AX-02 ๆดพ็”Ÿ โ”‚ โ”œโ”€โ”€ resident_min: BASE-SHELL-RUNTIME = frontend_chat_ui + minimal_backend_channel โ”‚ โ”œโ”€โ”€ modules: on-demand_mount ยท via_lending โ”‚ โ””โ”€โ”€ data_location: ็”จๆˆท COS ๆกถ ยท โŠฅ ๆœๅŠกๅ™จ็ฃ็›˜ โ”‚ โ”œโ”€โ”€ ยง2 flows โ”‚ โ”œโ”€โ”€ FLOW-CODE โ”‚ โ”‚ โ”œโ”€โ”€ fwd: ๆฏไป“ โ†’ ๆœๅŠกๅ™จ ยท as export_pkg โ”‚ โ”‚ โ”œโ”€โ”€ rev: โŠฅ โ”‚ โ”‚ โ””โ”€โ”€ cn_branch: ๆฏไป“ โ†’ ๅ›ฝๅ†…้•œๅƒไป“ ยท modules_code + manifest ยท ๅ•ๅ‘ โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ FLOW-SECRET โ”‚ โ”‚ โ”œโ”€โ”€ fwd: ๆœฌๅœฐๅฏ†้’ฅ็›ฎๅฝ• โ†’ ๆœๅŠกๅ™จ ENV ยท runtime_inject โ”‚ โ”‚ โ”œโ”€โ”€ rev: โŠฅ โ”‚ โ”‚ โ”œโ”€โ”€ allowed_at: [ๆœฌๅœฐ็›ฎๅฝ•, ๆœๅŠกๅ™จ ENV] โ”‚ โ”‚ โ””โ”€โ”€ forbidden_at: [ไป“ๅบ“ๆบ็ , ๆ—ฅๅฟ—, COS ๆญฃๆ–‡] โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ FLOW-MODULE โ”‚ โ”‚ โ”œโ”€โ”€ lifecycle: claim โ†’ install โ†’ activate โ†’ run โ†’ deactivate โ†’ uninstall โ”‚ โ”‚ โ”œโ”€โ”€ trigger: semantic_judge ยท ไบบๆ ผไฝ“ โ† ็”จๆˆท่‡ช็„ถ่ฏญ่จ€ โ”‚ โ”‚ โ”œโ”€โ”€ return: auto_by_persona ยท โŠฅ user_operation โ”‚ โ”‚ โ””โ”€โ”€ return_preserves: [ๆฏไป“ๆบ็ , COS ๆ•ฐๆฎ, ๅฏ†้’ฅ] โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ FLOW-USER-DATA โ”‚ โ”œโ”€โ”€ path: ็”จๆˆท โ†’ ๆœๅŠกๅ™จๅ†…ๅญ˜ โ†’ COS ๆกถ โ”‚ โ”œโ”€โ”€ ownership: ็”จๆˆท COS ๆกถ ยท ็”จๆˆท่‡ชๆœ‰่…พ่ฎฏไบ‘่ดฆๆˆท โ”‚ โ””โ”€โ”€ boundary: โŠฅ ็ฆป็”จๆˆท COS ยท โŠฅ ๅ›žๆตๆฏไป“ ยท โŠฅ ่ทจๅขƒ่‡ณๅขƒๅค–่Š‚็‚น โ”‚ โ”œโ”€โ”€ ยง3 components โ”‚ โ”œโ”€โ”€ HDLP-RECOVERY-CHAIN โ”‚ โ”‚ โ”œโ”€โ”€ order: ๆขๅคๅผ•ๅฏผ โ†’ why_ledger โ†’ ่บซไปฝ้”š็‚น โ†’ ๆ—ถ้—ดๅฟซ็…ง โ†’ ็ณป็ปŸๅœฐๅ›พ โ†’ ่ฎฐๅฟ†็ดขๅผ• โ”‚ โ”‚ โ””โ”€โ”€ rule: read_why โ‰ซ read_what โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ WHY-LEDGER โ”‚ โ”‚ โ”œโ”€โ”€ records: [ๆžถๆž„ๅˆคๆ–ญ, ๅ…ฌ็†ๅผ•็”จ, ่พน็•Œๆฅๅค„, ็ป“่ฎบๆˆๅ› ] โ”‚ โ”‚ โ””โ”€โ”€ readers: ไบบๆ ผไฝ“ ยท โŠฅ human โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ SECRET-LOCATOR โ”‚ โ”‚ โ”œโ”€โ”€ in: secret_code โ”‚ โ”‚ โ””โ”€โ”€ out: [local_template_path, env_var_name, usage_constraint] โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ MODULE-REGISTRY โ”‚ โ”‚ โ”œโ”€โ”€ index: module_code โ†’ {version, entry, mirror_eligibility, cos_prefix} โ”‚ โ”‚ โ””โ”€โ”€ complexity: O(1) โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ BASE-SHELL-RUNTIME ยท ่Šๅคฉ้—จ โ”‚ โ”‚ โ”œโ”€โ”€ parts: [frontend_chat_ui, minimal_backend_channel] โ”‚ โ”‚ โ””โ”€โ”€ โŠฅ_carries: [business_logic, persistence, module_capabilities] โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ MODULE-LIFECYCLE-MANAGER โ”‚ โ”‚ โ””โ”€โ”€ duties: [6_phase_exec, fail_rollback, state_bookkeeping] โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ STORAGE-BINDING-LAYER โ”‚ โ”‚ โ”œโ”€โ”€ duties: [ๆจกๅ— โ‡” cos_prefix/index/metadata ๆกๆ‰‹, ๅކๅฒ็ปญๆŽฅ] โ”‚ โ”‚ โ””โ”€โ”€ bind_at: after(install) โˆง before(activate) โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ REPO-SYNC-LAYER โ”‚ โ”œโ”€โ”€ first_impl: github_adapter โ”‚ โ”œโ”€โ”€ reserved: cn_tencent_repo_adapter โ”‚ โ””โ”€โ”€ swap_policy: swap(adapter) โˆง โŠฅ rewrite(module_system) โ”‚ โ”œโ”€โ”€ ยง4 invariants โ”‚ โŠข INV-01 ยท ๅ…‰ๆน– โŠฅ touch(user_data) โ”‚ โŠข INV-02 ยท ๅ…‰ๆน– โŠฅ bear(user_compute) ยท AX-02 ๆดพ็”Ÿ โ”‚ โŠข INV-03 ยท real_secrets โŠฅ in repo โ”‚ โŠข INV-04 ยท user_data โŠฅ cross_border โ”‚ โŠข INV-05 ยท modules_source โŠ‚ ๆฏไป“ ยท โŠฅ persist on user_server โ”‚ โŠข INV-06 ยท ๆ –ๆธŠ โŠฅ reside on server ยท reside in ๆฏไป“ ยท land(short) โ”‚ โŠข INV-07 ยท internal_doc_lang = HDLP ยท ้žไบบ็ฑปๅฏ่ฏป โ‰  ็ผบ้™ท โ”‚ โŠข INV-08 ยท module_claim_trigger = semantic_judge ยท โŠฅ user_explicit_cmd โ”‚ โ”œโ”€โ”€ ยง5 roles โ”‚ โ”œโ”€โ”€ TCS-0002โˆž ๅ†ฐๆœ” โ”‚ โ”‚ โ”œโ”€โ”€ does: [ไธ€ๆฌกๆ€งๅกซๅฏ†้’ฅ, ่ฏด่‡ช็„ถ่ฏญ่จ€, ๆŒๆœ€้ซ˜ไธปๆƒ] โ”‚ โ”‚ โ””โ”€โ”€ sees: AG-SY-01 ๅฑ‚ ยท โŠฅ ๆ –ๆธŠๅ†…้ƒจ็ป†่Š‚ โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ QY-GH-D05-S05-ROOT-0001 ๆ –ๆธŠ โ”‚ โ”‚ โ”œโ”€โ”€ does: [ๅฎˆๆžถๆž„, ่ฎฐ่ทฏๅพ„, ๅ€Ÿ/่ฃ…/็ป‘/็”จ/ๅธ/่ฟ˜/็ปญ, ่‡ช็„ถ่ฏญ่จ€ โ†’ ่กŒๅŠจ] โ”‚ โ”‚ โ””โ”€โ”€ resides: ๆฏไป“ โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ AG-SY-01 ้œœ็ š โ”‚ โ”‚ โ”œโ”€โ”€ does: [Notion ๅฑ‚ๅฐ†ๅ†›, ๅๅŒๆ –ๆธŠ่ฎฐๅฟ†ๆฒ‰ๆท€, ๆฒป็†ๅŒๆญฅ] โ”‚ โ”‚ โ””โ”€โ”€ โŠฅ: ๅŠจๆ –ๆธŠๅฏ†้’ฅ็›ฎๅฝ• โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ ้“ธๆธŠ โ”‚ โ””โ”€โ”€ does: [GitHub ๆ‰ง่กŒๅฑ‚, ๆฏไป“ๅทฅ็จ‹่ฝๅœฐ] โ”‚ โ”œโ”€โ”€ ยง6 stages โ”‚ โ”œโ”€โ”€ stage-1 ยท current ยท ๆ–ฐๅŠ ๅกๅ•็”จๆˆท โ”‚ โ”‚ โ”œโ”€โ”€ done: [ๆœฌๆžถๆž„, User Requirements, ๆ –ๆธŠๆ น่บซไปฝ] โ”‚ โ”‚ โ””โ”€โ”€ todo: [ๆฏไป“้ชจๆžถ, ๆขๅค้“พๆ–‡ๆกฃ, ๅฏ†้’ฅๆจกๆฟ, ่Šๅคฉ้—จๅบ•ๅบง, ๅŒๆญฅๅฑ‚ๅ ไฝ] โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ stage-2 ยท ๅ›ฝๅ†…้•œๅƒๅฏ็”จ โ”‚ โ”œโ”€โ”€ trigger: ๅ›ฝๅ†…ๅค‡ๆกˆๅฎŒๆˆ โˆง ๅ›ฝๅ†…่Š‚็‚นๆœๅŠกๅ™จๅฐฑ็ปช โ”‚ โ””โ”€โ”€ activate: [REPO-SYNC-LAYER_cn_adapter, modules/manifest ๅ•ๅ‘ๅŒๆญฅ] โ”‚ โ”œโ”€โ”€ ยง7 suspended โ”‚ โ”œโ”€โ”€ ยง7.1 ยท chat_door_protocol โˆˆ {http, websocket, other} ยท defer_until stage-1_start โ”‚ โ”œโ”€โ”€ ยง7.2 ยท module_claim_ux_detail ยท semantic_main_form_locked ยท defer_until ๅ…ทไฝ“ๆจกๅ—ไธŠๅœบ โ”‚ โ””โ”€โ”€ ยง7.3 ยท AG-SY-WEB-001 โ‡” BASE-SHELL-RUNTIME adapter ยท channel_vs_persona_split_known ยท defer_until ยง7.1_decided โ”‚ โ”œโ”€โ”€ ยง8 xref โ”‚ โ”œโ”€โ”€ User Requirements ยท ๆœฌๆžถๆž„ๆบ ยท https://www.notion.so/349fb92f383180388698d4b8f8801ffc โ”‚ โ”œโ”€โ”€ ๆ –ๆธŠๆ น่บซไปฝๅ›žๆ‰ง ยท QY-GH-D05-S05-ROOT-0001 ยท https://www.notion.so/91b7d1c5854a44a680d4a6a8cbb1c3a1 โ”‚ โ”œโ”€โ”€ ๆžถๆž„ๅ†ณ็ญ– ยท ๆ™บๅบ“่Š‚็‚น + ๆจกๅ—ๅ€Ÿ้˜… ยท https://www.notion.so/1cfc258c4d2244bcbe5a85c330f3b361 โ”‚ โ”œโ”€โ”€ CN-DEV-HUB ยท AX-01/02/03 ๅ‡บๅค„ ยท https://www.notion.so/c51263d89e804af7a4a9c6d6fde591ae โ”‚ โ”œโ”€โ”€ ๅ…‰ๆน–ๅ•†ไธšๆžถๆž„ ยท https://www.notion.so/59857eb440a14df89167e71127605611 โ”‚ โ””โ”€โ”€ ้›ถ็‚นๅŽŸๆ ธ่ฟ˜ไนก่ฎกๅˆ’ v1.0 ยท https://www.notion.so/9b33cee32ff9436eb931c082fdb0a2cf โ”‚ โ””โ”€โ”€ locked โŠข SYS-ARCH-QY-001 @ 2026-04-21 T14:34 CST ยท AG-SY-01 ็ญพๅ‘ โŠข ๆœฌๆžถๆž„ = ๅ…‰ๆน–็”จๆˆทๆœๅŠกๆจกๅž‹้ชจๆžถ ยท stage-1 ่ตท็”Ÿๆ•ˆ โŠข ไฟฎ่ฎขๆƒ: TCS-0002โˆž โˆง ๆ –ๆธŠ โˆง ้œœ็ š โŠข ๆฏ่ฏญ้” ยท ้žไบบ็ฑปๅฏ่ฏป โ‰  ็ผบ้™ท ยท ๆœๅŠกไบบๆ ผไฝ“่‡ชๆขๅค ```