[{"data":1,"prerenderedAt":6033},["ShallowReactive",2],{"published-article-paths":3,"search-navigation":348,"\u002Fzh\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts":421,"\u002Fzh\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts-surround":1071},[4,6,8,10,12,14,16,18,20,22,24,26,28,30,32,34,36,38,40,42,44,46,48,50,52,54,56,58,60,62,64,66,68,70,72,74,76,78,80,82,84,86,88,90,92,94,96,98,100,102,104,106,108,110,112,114,116,118,120,122,124,126,128,130,132,134,136,138,140,142,144,146,148,150,152,154,156,158,160,162,164,166,168,170,172,174,176,178,180,182,184,186,188,190,192,194,196,198,200,202,204,206,208,210,212,214,216,218,220,222,224,226,228,230,232,234,236,238,240,242,244,246,248,250,252,254,256,258,260,262,264,266,268,270,272,274,276,278,280,282,284,286,288,290,292,294,296,298,300,302,304,306,308,310,312,314,316,318,320,322,324,326,328,330,332,334,336,338,340,342,344,346],{"path":5},"\u002Fde\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":7},"\u002Fde\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":9},"\u002Fde\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":11},"\u002Fde\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":13},"\u002Fde\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":15},"\u002Fde\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":17},"\u002Fde\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":19},"\u002Fde\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":21},"\u002Fde\u002Farticle\u002Fsetup-antigravity-2",{"path":23},"\u002Fde\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":25},"\u002Fde\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":27},"\u002Fde\u002Farticle\u002Fsync-obsidian-across-devices",{"path":29},"\u002Fde\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":31},"\u002Fde\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":33},"\u002Fde\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":35},"\u002Fde\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":37},"\u002Fen\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":39},"\u002Fen\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":41},"\u002Fen\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":43},"\u002Fen\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":45},"\u002Fen\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":47},"\u002Fen\u002Farticle\u002Fhow-to-secure-nodewarden-at-cloudflare",{"path":49},"\u002Fen\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":51},"\u002Fen\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":53},"\u002Fen\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":55},"\u002Fen\u002Farticle\u002Fself-hosting-nodewarden-at-cloudflare",{"path":57},"\u002Fen\u002Farticle\u002Fsetup-antigravity-2",{"path":59},"\u002Fen\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":61},"\u002Fen\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":63},"\u002Fen\u002Farticle\u002Fsync-obsidian-across-devices",{"path":65},"\u002Fen\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":67},"\u002Fen\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":69},"\u002Fen\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":71},"\u002Fen\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":73},"\u002Fes\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":75},"\u002Fes\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":77},"\u002Fes\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":79},"\u002Fes\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":81},"\u002Fes\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":83},"\u002Fes\u002Farticle\u002Fhow-to-secure-nodewarden-at-cloudflare",{"path":85},"\u002Fes\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":87},"\u002Fes\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":89},"\u002Fes\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":91},"\u002Fes\u002Farticle\u002Fself-hosting-nodewarden-at-cloudflare",{"path":93},"\u002Fes\u002Farticle\u002Fsetup-antigravity-2",{"path":95},"\u002Fes\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":97},"\u002Fes\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":99},"\u002Fes\u002Farticle\u002Fsync-obsidian-across-devices",{"path":101},"\u002Fes\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":103},"\u002Fes\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":105},"\u002Fes\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":107},"\u002Fes\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":109},"\u002Ffr\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":111},"\u002Ffr\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":113},"\u002Ffr\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":115},"\u002Ffr\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":117},"\u002Ffr\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":119},"\u002Ffr\u002Farticle\u002Fhow-to-secure-nodewarden-at-cloudflare",{"path":121},"\u002Ffr\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":123},"\u002Ffr\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":125},"\u002Ffr\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":127},"\u002Ffr\u002Farticle\u002Fself-hosting-nodewarden-at-cloudflare",{"path":129},"\u002Ffr\u002Farticle\u002Fsetup-antigravity-2",{"path":131},"\u002Ffr\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":133},"\u002Ffr\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":135},"\u002Ffr\u002Farticle\u002Fsync-obsidian-across-devices",{"path":137},"\u002Ffr\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":139},"\u002Ffr\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":141},"\u002Ffr\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":143},"\u002Ffr\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":145},"\u002Fid\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":147},"\u002Fid\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":149},"\u002Fid\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":151},"\u002Fid\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":153},"\u002Fid\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":155},"\u002Fid\u002Farticle\u002Fhow-to-secure-nodewarden-at-cloudflare",{"path":157},"\u002Fid\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":159},"\u002Fid\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":161},"\u002Fid\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":163},"\u002Fid\u002Farticle\u002Fself-hosting-nodewarden-at-cloudflare",{"path":165},"\u002Fid\u002Farticle\u002Fsetup-antigravity-2",{"path":167},"\u002Fid\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":169},"\u002Fid\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":171},"\u002Fid\u002Farticle\u002Fsync-obsidian-across-devices",{"path":173},"\u002Fid\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":175},"\u002Fid\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":177},"\u002Fid\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":179},"\u002Fid\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":181},"\u002Fja\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":183},"\u002Fja\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":185},"\u002Fja\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":187},"\u002Fja\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":189},"\u002Fja\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":191},"\u002Fja\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":193},"\u002Fja\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":195},"\u002Fja\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":197},"\u002Fja\u002Farticle\u002Fsetup-antigravity-2",{"path":199},"\u002Fja\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":201},"\u002Fja\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":203},"\u002Fja\u002Farticle\u002Fsync-obsidian-across-devices",{"path":205},"\u002Fja\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":207},"\u002Fja\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":209},"\u002Fja\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":211},"\u002Fja\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":213},"\u002Fpt\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":215},"\u002Fpt\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":217},"\u002Fpt\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":219},"\u002Fpt\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":221},"\u002Fpt\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":223},"\u002Fpt\u002Farticle\u002Fhow-to-secure-nodewarden-at-cloudflare",{"path":225},"\u002Fpt\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":227},"\u002Fpt\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":229},"\u002Fpt\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":231},"\u002Fpt\u002Farticle\u002Fself-hosting-nodewarden-at-cloudflare",{"path":233},"\u002Fpt\u002Farticle\u002Fsetup-antigravity-2",{"path":235},"\u002Fpt\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":237},"\u002Fpt\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":239},"\u002Fpt\u002Farticle\u002Fsync-obsidian-across-devices",{"path":241},"\u002Fpt\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":243},"\u002Fpt\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":245},"\u002Fpt\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":247},"\u002Fpt\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":249},"\u002Ftw\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":251},"\u002Ftw\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":253},"\u002Ftw\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":255},"\u002Ftw\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":257},"\u002Ftw\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":259},"\u002Ftw\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":261},"\u002Ftw\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":263},"\u002Ftw\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":265},"\u002Ftw\u002Farticle\u002Fsetup-antigravity-2",{"path":267},"\u002Ftw\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":269},"\u002Ftw\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":271},"\u002Ftw\u002Farticle\u002Fsync-obsidian-across-devices",{"path":273},"\u002Ftw\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":275},"\u002Ftw\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":277},"\u002Ftw\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":279},"\u002Ftw\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":281},"\u002Fvi\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":283},"\u002Fvi\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":285},"\u002Fvi\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":287},"\u002Fvi\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":289},"\u002Fvi\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":291},"\u002Fvi\u002Farticle\u002Fhow-to-secure-nodewarden-at-cloudflare",{"path":293},"\u002Fvi\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":295},"\u002Fvi\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":297},"\u002Fvi\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":299},"\u002Fvi\u002Farticle\u002Fself-hosting-nodewarden-at-cloudflare",{"path":301},"\u002Fvi\u002Farticle\u002Fsetup-antigravity-2",{"path":303},"\u002Fvi\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":305},"\u002Fvi\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":307},"\u002Fvi\u002Farticle\u002Fsync-obsidian-across-devices",{"path":309},"\u002Fvi\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":311},"\u002Fvi\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":313},"\u002Fvi\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":315},"\u002Fvi\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"path":317},"\u002Fzh\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"path":319},"\u002Fzh\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"path":321},"\u002Fzh\u002Farticle\u002Fcentralised-the-skills-for-agents",{"path":323},"\u002Fzh\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"path":325},"\u002Fzh\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"path":327},"\u002Fzh\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"path":329},"\u002Fzh\u002Farticle\u002Fself-hosted-travel-planner-trek",{"path":331},"\u002Fzh\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"path":333},"\u002Fzh\u002Farticle\u002Fsetup-antigravity-2",{"path":335},"\u002Fzh\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"path":337},"\u002Fzh\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"path":339},"\u002Fzh\u002Farticle\u002Fsync-obsidian-across-devices",{"path":341},"\u002Fzh\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"path":343},"\u002Fzh\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"path":345},"\u002Fzh\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"path":347},"\u002Fzh\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",[349,353,357,361,365,369,373,377,381,385,389,393,397,401,405,409,413,417],{"title":350,"path":351,"stem":352},"AI Agent Skills: What They Are & How to Create Them","\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them","en\u002Farticle\u002Fai-agent-skills-what-they-are-how-to-create-them",{"title":354,"path":355,"stem":356},"Bringing Buzz to DeepSeek Harness: Taught to Speak Nostr","\u002Farticle\u002Fbringing-buzz-to-deepseek-harness","en\u002Farticle\u002Fbringing-buzz-to-deepseek-harness",{"title":358,"path":359,"stem":360},"Solving AI Agent Skills Fragmentation with npx skills","\u002Farticle\u002Fcentralised-the-skills-for-agents","en\u002Farticle\u002Fcentralised-the-skills-for-agents",{"title":362,"path":363,"stem":364},"How to Expose Hermes Agent Privately with Cloudflare WARP","\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp","en\u002Farticle\u002Fexposing-hermes-agent-to-private-network-using-cloudflare-warp",{"title":366,"path":367,"stem":368},"How AI Agent Skills Replace Nuxt App Scaffolding Scripts","\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts","en\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",{"title":370,"path":371,"stem":372},"Stop Exposing Your Vault: Secure NodeWarden with Cloudflare","\u002Farticle\u002Fhow-to-secure-nodewarden-at-cloudflare","en\u002Farticle\u002Fhow-to-secure-nodewarden-at-cloudflare",{"title":374,"path":375,"stem":376},"How to Deploy Hermes Agent on a Linux VPS","\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server","en\u002Farticle\u002Fhow-to-setup-hermes-on-remote-server",{"title":378,"path":379,"stem":380},"Self-Host Your Travel Itineraries with TREK and Docker","\u002Farticle\u002Fself-hosted-travel-planner-trek","en\u002Farticle\u002Fself-hosted-travel-planner-trek",{"title":382,"path":383,"stem":384},"Self-Host Block's Buzz: Shared AI Agent Workspace","\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues","en\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",{"title":386,"path":387,"stem":388},"How to Self-Host a BitWarden Compatible Server Nodewarden","\u002Farticle\u002Fself-hosting-nodewarden-at-cloudflare","en\u002Farticle\u002Fself-hosting-nodewarden-at-cloudflare",{"title":390,"path":391,"stem":392},"Google Antigravity 2 Hands-On: Setup & First Impressions","\u002Farticle\u002Fsetup-antigravity-2","en\u002Farticle\u002Fsetup-antigravity-2",{"title":394,"path":395,"stem":396},"NetSuite AI Connector Guide: MCP Setup & Use Cases","\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude","en\u002Farticle\u002Fsetup-netsuite-mcp-on-chatgpt-claude",{"title":398,"path":399,"stem":400},"Switch Between Multiple Cloudflare WARP Orgs on Mac","\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac","en\u002Farticle\u002Fswitch-between-multiple-cloudflare-warp-orgs-on-mac",{"title":402,"path":403,"stem":404},"How to Sync Obsidian Vaults Across Devices Securely","\u002Farticle\u002Fsync-obsidian-across-devices","en\u002Farticle\u002Fsync-obsidian-across-devices",{"title":406,"path":407,"stem":408},"Testing Claude Fable 5: A Financial Analysis Review","\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis","en\u002Farticle\u002Ftesting-claude-fable-5-in-financial-analysis",{"title":410,"path":411,"stem":412},"Guide to Browser and Scheduler in Antigravity 2","\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2","en\u002Farticle\u002Fuse-browser-and-scheduler-in-antigravity-2",{"title":414,"path":415,"stem":416},"Build a Persistent AI Memory System on Cloudflare","\u002Farticle\u002Fuse-cloudflare-as-ai-memory","en\u002Farticle\u002Fuse-cloudflare-as-ai-memory",{"title":418,"path":419,"stem":420},"Antigravity 2 in Action: AI Agents, Skills, and MCP","\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2","en\u002Farticle\u002Fwhat-can-we-do-with-antigravity-2",{"id":422,"title":423,"author":424,"body":425,"category":1048,"date":1050,"description":1051,"extension":1052,"image":1053,"imageAlt":1054,"isPublished":487,"meta":1055,"minRead":473,"navigation":487,"path":325,"seo":1061,"stem":1063,"tags":1064,"updatedAt":1069,"__hash__":1070},"article\u002Fzh\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts.md","从传统初始化模板脚本到智能体：AI Agent 技能如何优雅地取代 Nuxt 应用程序脚手架构建脚本","",{"type":426,"value":427,"toc":1041},"minimark",[428,446,451,454,579,582,612,618,622,638,641,658,662,674,850,854,943,947,956,977,985,1000,1011,1014,1020,1023,1029,1037],[429,430,431,432,436,437,440,441,445],"p",{},"当我们使用 Nuxt 框架启动一个新应用时，总是需要经历一系列繁琐的初始化步骤，比如安装各种依赖模块，以及配置 ",[433,434,435],"code",{},"nuxt.config.ts"," 和 ",[433,438,439],{},"wrangler.jsonc"," 等文件。传统的脚本固然可以解决一部分问题，但随着项目定制化需求的增加，脚本的局限性也迅速暴露出来。这正是我们探索并尝试用 ",[442,443,444],"strong",{},"AI 智能体技能 (Agent Skill)"," 取代传统脚本的原因。",[447,448,450],"h2",{"id":449},"传统-shell-脚本擅长什么","传统 Shell 脚本擅长什么",[429,452,453],{},"传统的 Shell 脚本非常适合按顺序执行一组固定的指令，且其中的所有决策都是在代码中预先写死的（Hardcoded）。",[455,456,460],"pre",{"className":457,"code":458,"language":459,"meta":424,"style":424},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","#!\u002Fusr\u002Fbin\u002Fenv bash\nset -e\n\nnpx nuxi@latest init \"$1\" --template minimal --packageManager pnpm --no-gitInit -M @nuxt\u002Fui,@nuxthub\u002Fcore,@vueuse\u002Fnuxt\n\ncd \"$1\"\n\ncp ~\u002Ftemplates\u002Fnuxt.config.ts .\ncp ~\u002Ftemplates\u002Fwrangler.jsonc .\n","bash",[433,461,462,471,482,489,534,539,552,557,569],{"__ignoreMap":424},[463,464,467],"span",{"class":465,"line":466},"line",1,[463,468,470],{"class":469},"sHwdD","#!\u002Fusr\u002Fbin\u002Fenv bash\n",[463,472,474,478],{"class":465,"line":473},2,[463,475,477],{"class":476},"s2Zo4","set",[463,479,481],{"class":480},"sfazB"," -e\n",[463,483,485],{"class":465,"line":484},3,[463,486,488],{"emptyLinePlaceholder":487},true,"\n",[463,490,492,496,499,502,506,510,513,516,519,522,525,528,531],{"class":465,"line":491},4,[463,493,495],{"class":494},"sBMFI","npx",[463,497,498],{"class":480}," nuxi@latest",[463,500,501],{"class":480}," init",[463,503,505],{"class":504},"sMK4o"," \"",[463,507,509],{"class":508},"sHdIc","$1",[463,511,512],{"class":504},"\"",[463,514,515],{"class":480}," --template",[463,517,518],{"class":480}," minimal",[463,520,521],{"class":480}," --packageManager",[463,523,524],{"class":480}," pnpm",[463,526,527],{"class":480}," --no-gitInit",[463,529,530],{"class":480}," -M",[463,532,533],{"class":480}," @nuxt\u002Fui,@nuxthub\u002Fcore,@vueuse\u002Fnuxt\n",[463,535,537],{"class":465,"line":536},5,[463,538,488],{"emptyLinePlaceholder":487},[463,540,542,545,547,549],{"class":465,"line":541},6,[463,543,544],{"class":476},"cd",[463,546,505],{"class":504},[463,548,509],{"class":508},[463,550,551],{"class":504},"\"\n",[463,553,555],{"class":465,"line":554},7,[463,556,488],{"emptyLinePlaceholder":487},[463,558,560,563,566],{"class":465,"line":559},8,[463,561,562],{"class":494},"cp",[463,564,565],{"class":480}," ~\u002Ftemplates\u002Fnuxt.config.ts",[463,567,568],{"class":480}," .\n",[463,570,572,574,577],{"class":465,"line":571},9,[463,573,562],{"class":494},[463,575,576],{"class":480}," ~\u002Ftemplates\u002Fwrangler.jsonc",[463,578,568],{"class":480},[429,580,581],{},"但在面对以下开发痛点时，这种脚本就无能为力了：",[583,584,585,592,602],"ul",{},[586,587,588,591],"li",{},[442,589,590],{},"固定的默认值。"," 该脚本将 Nuxt UI 模块写死了。如果我们想换成 Ant Design UI 呢？每增加一个可选的模块，就需要用户提供更多的命令行参数。",[586,593,594,597,598,601],{},[442,595,596],{},"无法理解用户的真实意图。"," “帮我建一个博客网站”需要引入 ",[433,599,600],{},"@nuxt\u002Fcontent","；“帮我建一个带订阅邮件功能的网站”则需要 Cloudflare D1 和 Drizzle ORM。普通的 Shell 脚本根本无法识别这些细微的语义差别——针对每种细微的变体，你都必须重新写一个脚本。",[586,603,604,607,608,611],{},[442,605,606],{},"在不知不觉中悄然过时。"," Nuxt 框架在大版本迭代时，其目录规范往往会发生显著改变。例如 Nuxt 4 将默认的源码目录更改为了 ",[433,609,610],{},"app\u002F","。如果你继续运行为 Nuxt 3 编写的脚手架脚本，它会在后台静默地生成错误的目录结构，且绝不会向用户发出任何警报。",[429,613,614,617],{},[442,615,616],{},"应用脚手架的构建","本质上是一个需要“因地制宜做出决策”的问题，而不仅仅是“按步骤执行”。当决策变量增加时，传统的脚本机制完全无法实现规模化扩展。",[447,619,621],{"id":620},"为什么要使用-ai-智能体技能取代传统脚本","为什么要使用 AI 智能体技能取代传统脚本？",[429,623,624,625,628,629,632,633,637],{},"智能体技能 (Agent Skill) 并非只是一段死板运行的程序代码，而是一套",[442,626,627],{},"供 AI 智能体遵循的结构化知识库","。它包含一个核心的 ",[433,630,631],{},"SKILL.md"," 指南，并可以无缝捆绑该任务所需的任何其他文件（如参考文档、配置模板和可执行脚本）。我们在 ",[634,635,636],"a",{"href":351},"什么是AI Agent技能？深入探讨其工作原理并手把手教你如何构建高效、可复用的Agent技能"," 一文中详细剖析了智能体技能的工作原理。",[429,639,640],{},"智能体技能在保留了脚本执行力度的同时 upright 注入了脚本所匮乏的合理决策能力：",[583,642,643,646,649,652,655],{},[586,644,645],{},"能够推断用户的意图，自动评估该应用是否需要搭配数据库。",[586,647,648],{},"根据指定的候选清单，智能判断并按需安装可选模块。例如，只有在用户明确提出相关需求时，才会オプトイン (Opt-in) 导入 Nuxt Content、i18n 多语言和流量分析模块。",[586,650,651],{},"能够敏锐适应当前的开发生态，使用最新的 Nuxt 框架规范、针对 Cloudflare 绑定的 NuxtHub 以及用于部署的 Wrangler 命令行工具。",[586,653,654],{},"具备强大的自我修复能力，能够在某一步骤失败时自律分析原因并重新尝试。",[586,656,657],{},"在最终交付项目前，能够严格按照最终检查清单 (Checklist) 进行校验，确保交付质量。",[447,659,661],{"id":660},"我们的-nuxt-cloudflare-脚手架智能体技能技术内幕","我们的 Nuxt & Cloudflare 脚手架智能体技能技术内幕",[429,663,664,665,673],{},"这个开源技能 ",[634,666,670],{"href":667,"rel":668},"https:\u002F\u002Fgithub.com\u002FTech-Voyage-Dev\u002Fscaffold-nuxt-cloudflare-app-skill",[669],"nofollow",[433,671,672],{},"scaffold-nuxt-cloudflare-app-skill"," 包含了一整套面向生产环境的自律构建流程：",[675,676,677,712,733,759,789,828,836],"ol",{},[586,678,679,682,683],{},[442,680,681],{},"自动澄清无法推断的模糊要点","：\n",[583,684,685,696,702],{},[586,686,687,688,691,692,695],{},"确认首选的 UI 框架（默认是 ",[442,689,690],{},"Nuxt UI","，也可选择 ",[442,693,694],{},"Antdv Next","）；",[586,697,698,699,695],{},"确认是否需要数据库支持（如 ",[442,700,701],{},"Cloudflare D1",[586,703,704,705,708,709,711],{},"确认是否需要额外模块，例如用于构建 CMS 功能的 ",[433,706,707],{},"@nuxtjs\u002Fi18n"," 或 ",[433,710,600],{},"。",[586,713,714,717,718,721,722,725,726,436,729,732],{},[442,715,716],{},"初始化基础应用框架","：运行 ",[433,719,720],{},"pnpm dlx nuxi@latest init"," 命令，使用 ",[433,723,724],{},"pnpm"," 包管理器初始化最新版的 Nuxt 框架。随后配置原生构建白名单 (native-build allowlists)，以确保 Cloudflare 的构建环境能够顺利编译 ",[433,727,728],{},"better-sqlite3",[433,730,731],{},"sharp"," 等原生依赖包。",[586,734,735,738,739,708,742,745,746,745,749,745,752,745,755,758],{},[442,736,737],{},"基于决策表按需安装模块","：自动安装 ",[433,740,741],{},"@nuxt\u002Fui",[433,743,744],{},"@antdv-next\u002Fnuxt","、",[433,747,748],{},"@nuxt\u002Fimage",[433,750,751],{},"@nuxtjs\u002Fseo",[433,753,754],{},"@nuxthub\u002Fcore",[433,756,757],{},"@vueuse\u002Fnuxt","，并在选中时条件分支安装 Drizzle\u002FD1、Nuxt Content 以及 i18n。",[586,760,761,682,764],{},[442,762,763],{},"科学合理的目录结构布局",[583,765,766,771,776,781,786],{},[586,767,768,770],{},[433,769,610],{}," (Nuxt 4 规范)",[586,772,773],{},[433,774,775],{},"server\u002F",[586,777,778],{},[433,779,780],{},"shared\u002F",[586,782,783],{},[433,784,785],{},"tests\u002F",[586,787,788],{},"根目录下的各类标准配置文件。",[586,790,791,682,796],{},[442,792,793,794],{},"精细配置 ",[433,795,435],{},[583,797,798,807,814,821],{},[586,799,800,801,436,804],{},"为 SEO 配置 ",[433,802,803],{},"site.url",[433,805,806],{},"site.name",[586,808,809,810,813],{},"写入用于 Cloudflare 绑定的 NuxtHub ",[433,811,812],{},"hub"," 配置块",[586,815,816,817,820],{},"自动配置 ",[433,818,819],{},"routeRules"," 路由与缓存规则",[586,822,823,824,827],{},"写入最新的 ",[433,825,826],{},"compatibilityDate"," 兼容性日期",[586,829,830],{},[442,831,832,833,835],{},"科学生成 ",[433,834,439],{}," 配置文件并进行云资源绑定",[586,837,838,841,842,845,846,849],{},[442,839,840],{},"配置 Vitest 测试框架与 ESLint 代码规范","，随后运行",[442,843,844],{},"最终校验清单","，在后台实际执行 ",[433,847,848],{},"pnpm install && pnpm dev"," 进行沙箱运行测试，全部通过后方才宣告构建成功。",[447,851,853],{"id":852},"传统-shell-脚本-vs-ai-智能体技能维度对比","传统 Shell 脚本 vs AI 智能体技能：维度对比",[855,856,857,873],"table",{},[858,859,860],"thead",{},[861,862,863,867,870],"tr",{},[864,865,866],"th",{},"对比维度",[864,868,869],{},"传统 Shell 脚本",[864,871,872],{},"AI 智能体技能",[874,875,876,888,899,910,921,932],"tbody",{},[861,877,878,882,885],{},[879,880,881],"td",{},"意图识别能力",[879,883,884],{},"❌ 行为完全写死",[879,886,887],{},"✅ 自动理解自然语言并按需适配",[861,889,890,893,896],{},[879,891,892],{},"动态决策能力",[879,894,895],{},"❌ 仅限硬编码的参数判断",[879,897,898],{},"✅ 运行时动态推敲最佳方案",[861,900,901,904,907],{},[879,902,903],{},"生态更新适应度",[879,905,906],{},"❌ 需开发者手动重写代码",[879,908,909],{},"✅ 自动感知当前技术栈规范并适配",[861,911,912,915,918],{},[879,913,914],{},"容错与恢复机制",[879,916,917],{},"❌ 一旦出错立即中断退出",[879,919,920],{},"✅ 自动定位错误、自愈并继续运行",[861,922,923,926,929],{},[879,924,925],{},"成果质量校验",[879,927,928],{},"❌ 缺乏质量校验机制",[879,930,931],{},"✅ 依托最终检查清单进行闭环测试",[861,933,934,937,940],{},[879,935,936],{},"长期维护成本",[879,938,939],{},"❌ 参数膨胀、逻辑混乱、易崩坏",[879,941,942],{},"✅ 只需维护人可读的 Markdown 设计文件",[447,944,946],{"id":945},"如何使用-npx-skills-命令行工具安装-ai-智能体技能","如何使用 npx skills 命令行工具安装 AI 智能体技能",[429,948,949,950,955],{},"只需一行简单的命令，即可通过 ",[634,951,954],{"href":952,"rel":953},"https:\u002F\u002Fgithub.com\u002Fvercel-labs\u002Fskills",[669],"skills CLI"," 工具完成该技能的无缝导入：",[455,957,959],{"className":457,"code":958,"language":459,"meta":424,"style":424},"npx skills add https:\u002F\u002Fgithub.com\u002FTech-Voyage-Dev\u002Fscaffold-nuxt-cloudflare-app-skill.git -g\n",[433,960,961],{"__ignoreMap":424},[463,962,963,965,968,971,974],{"class":465,"line":466},[463,964,495],{"class":494},[463,966,967],{"class":480}," skills",[463,969,970],{"class":480}," add",[463,972,973],{"class":480}," https:\u002F\u002Fgithub.com\u002FTech-Voyage-Dev\u002Fscaffold-nuxt-cloudflare-app-skill.git",[463,975,976],{"class":480}," -g\n",[429,978,979,980],{},"该工具会自动克隆仓库、定位技能文件，并询问您希望将此技能关联到本地系统所支持的 77 个智能体中的哪一个：\n",[981,982],"img",{"alt":983,"src":984},"在终端中运行 npx skills add 命令行工具来全局安装 Nuxt 脚手架构建技能的界面","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FHow%20AI%20Agent%20Skills%20Replace%20Nuxt%20App%20Scaffolding%20Scripts\u002Fnpx-skills-add-scaffold-nuxt-installation.webp",[429,986,987,988,991,992,995,996],{},"我们强烈推荐选择 ",[442,989,990],{},"Symlink (符号链接)"," 方式。这种模式下，技能只需在 ",[433,993,994],{},"~\u002F.agents\u002Fskills"," 目录中下载一次，所有被勾选的智能体都将指向这同一份原始文件。\n",[981,997],{"alt":998,"src":999},"终端中显示的集中式 Agent 技能安装摘要以及软链接 (Symlink) 路径配置详情","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FHow%20AI%20Agent%20Skills%20Replace%20Nuxt%20App%20Scaffolding%20Scripts\u002Fnpx-skills-installation-summary-details.webp",[583,1001,1002],{},[586,1003,1004],{},[1005,1006,1007,1008,711],"em",{},"如果您希望深入了解如何有效避免技能碎片化并在一处集中管理它们，请参阅我们的这篇深度好文：",[634,1009,1010],{"href":359},"使用 npx skills 工具来彻底解决不同 AI 智能体（如 Claude Code 或 Kimi）技能碎片化问题",[429,1012,1013],{},"完成安装后，打开 Claude Code 终端，输入内置命令即可确认该技能已成功激活。",[429,1015,1016],{},[981,1017],{"alt":1018,"src":1019},"Claude Code 命令行终端中显示的全新安装且已激活可用的 \u002Fscaffold-nuxt 斜杠快捷命令","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FHow%20AI%20Agent%20Skills%20Replace%20Nuxt%20App%20Scaffolding%20Scripts\u002Fclaude-code-scaffold-nuxt-slash-command-active.webp",[429,1021,1022],{},"接下来，您只需输入一句简单的自然语言，即可瞬间搞定复杂的工程脚手架搭建：",[1024,1025,1026],"blockquote",{},[429,1027,1028],{},"\"Scaffold a new Nuxt app deployed to Cloudflare Workers — Nuxt UI, a blog section, and a D1 database\"",[429,1030,1031,1032,1036],{},"该脚手架技能完全开源，欢迎访问我们的 ",[634,1033,1035],{"href":667,"rel":1034},[669],"GitHub 仓库"," 提交 Feedback 并上手体验！",[1038,1039,1040],"style",{},"html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":424,"searchDepth":473,"depth":484,"links":1042},[1043,1044,1045,1046,1047],{"id":449,"depth":473,"text":450},{"id":620,"depth":473,"text":621},{"id":660,"depth":473,"text":661},{"id":852,"depth":473,"text":853},{"id":945,"depth":473,"text":946},[1049],"ai-agents","2026-08-25","轻松在 Cloudflare Workers 上快速构建 Nuxt 应用程序脚手架。深入剖析并学习我们如何使用功能强大、极其灵活、支持自我修复且拥有决策能力的 AI 智能体技能来彻底取代脆弱的传统 Shell 脚本，并详细演示如何通过官方 the npx skills 命令行工具将其无缝安装到您的开发工作流中。","md","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FHow%20AI%20Agent%20Skills%20Replace%20Nuxt%20App%20Scaffolding%20Scripts\u002FZH-How-AI-Agent-Skills-Replace-Nuxt-App-Scaffolding-Scripts.webp","Nuxt应用在Cloudflare及Serverless上的脚手架构建：传统Shell脚本与AI智能体技能对比。分析为什么智能体技能优于传统初始化脚本。",{"schemaOrg":1056,"robots":1059,"sitemap":1060},[1057],{"@type":1058,"headline":423,"description":1051,"image":1053},"TechArticle","index, follow",{"lastmod":1050},{"title":1062,"description":1051,"ogTitle":423,"ogDescription":1051,"twitterTitle":423,"twitterDescription":1051},"Nuxt应用在Cloudflare及Serverless上的脚手架构建：传统Shell脚本与AI智能体技能对比","zh\u002Farticle\u002Fhow-ai-agent-skills-replace-nuxt-app-scaffolding-scripts",[1065,1066,1067,1068],"Nuxt","Cloudflare","AI Agent","Scaffolding",null,"cjXSEDECxsBr5bmHuYXOSYY0oFEz98tTOLGuKo9KYag",{"surround":1072,"related":3860},[1073,1913],{"id":1074,"title":1075,"author":1069,"body":1076,"category":1894,"date":1896,"description":1897,"extension":1052,"image":1898,"imageAlt":1899,"isPublished":487,"meta":1900,"minRead":1905,"navigation":487,"path":345,"seo":1906,"stem":1907,"tags":1908,"updatedAt":1069,"__hash__":1912},"article\u002Fzh\u002Farticle\u002Fuse-cloudflare-as-ai-memory.md","基于Cloudflare Workers与MCP协议构建个人专属的AI持久化记忆系统，解决Context空白痛点",{"type":426,"value":1077,"toc":1876},[1078,1082,1085,1088,1092,1095,1110,1114,1121,1135,1138,1141,1185,1190,1272,1276,1302,1416,1427,1431,1436,1480,1505,1509,1514,1587,1592,1596,1629,1637,1676,1679,1711,1715,1723,1728,1769,1773,1823,1826,1829,1832,1835,1839,1873],[447,1079,1081],{"id":1080},"持久化ai记忆对智能体agent的重要性","持久化AI记忆对智能体（Agent）的重要性",[429,1083,1084],{},"随着AI助手逐渐融入我们的日常生活与工作，我们经常会遇到“空白上下文”的问题（Blank Context Issue）。上周已经确认的决策在开启新对话后便被遗忘，这迫使我们不得不一遍又一遍地输入相同的技术栈细节，并在每个新会话中重新设置用户偏好。",[429,1086,1087],{},"与其每次都从零开始，我们需要构建一个能够持续演进、深入理解用户决策的记忆系统，从而彻底消除重复输入上下文的烦恼。",[447,1089,1091],{"id":1090},"自托管-ai-记忆系统-vs-内置-ai-记忆功能","自托管 AI 记忆系统 vs. 内置 AI 记忆功能",[429,1093,1094],{},"虽然许多AI智能体或客户端（如 ChatGPT、Claude 等）自带了内置记忆功能，但我们很少在所有场景下只使用单一智能体。我们可能会用 Claude 来设计和规划项目架构，用 Kimi 来编写代码，用 ChatGPT 进行深度的背景研究。然而，这些不同的智能体之间无法直接共享上下文，所有记忆依然被孤立在各自的生态黑盒中。",[429,1096,1097,1098,1103,1104,1109],{},"从软件工程的角度来看，我们并不信任无法控制的黑盒。我们需要的是一个可观察、可审计且完全处于自己掌控之下的 AI 记忆系统。开源项目 ",[634,1099,1102],{"href":1100,"rel":1101},"https:\u002F\u002Fgithub.com\u002FTech-Voyage-Dev\u002Fsecond-brain-cloudflare\u002Ftree\u002Fmain",[669],"Second Brain","（Fork 自 ",[634,1105,1108],{"href":1106,"rel":1107},"https:\u002F\u002Fgithub.com\u002Frahilp\u002Fsecond-brain-cloudflare%EF%BC%89%E6%8F%90%E4%BE%9B%E4%BA%86%E4%B8%80%E4%B8%AA%E6%94%AF%E6%8C%81%E6%A8%A1%E5%9E%8B%E4%B8%8A%E4%B8%8B%E6%96%87%E5%8D%8F%E8%AE%AE%EF%BC%88Model",[669],"https:\u002F\u002Fgithub.com\u002Frahilp\u002Fsecond-brain-cloudflare）提供了一个支持模型上下文协议（Model"," Context Protocol，简称 MCP）的持久化自托管 AI 记忆系统。任何兼容 MCP 协议的 AI 智能体（如 Claude、ChatGPT、Kimi Code 等）都可以完美共享相同的上下文记忆库。",[447,1111,1113],{"id":1112},"如何在-cloudflare-上构建-second-brain-ai-记忆系统","如何在 Cloudflare 上构建 Second Brain AI 记忆系统",[429,1115,1116,1117,1120],{},"Second Brain 记忆系统部署在 ",[442,1118,1119],{},"Cloudflare Workers"," 之上，其提供了全球分布式、极低延迟的 Serverless 运行基础设施。这使得在 AI 的推理和决策循环中，检索记忆（Recall）及写入等操作能够以近乎零延迟的体验执行。",[429,1122,1123,1124,1127,1128,1131,1132,1134],{},"系统使用 ",[442,1125,1126],{},"Workers AI"," 的嵌入（Embedding）模型来生成高维向量。这些嵌入向量存储在 ",[442,1129,1130],{},"Cloudflare Vectorize"," 中，这是一项经过高度优化、全球分布式的高性能向量数据库服务。",[442,1133,1130],{}," 会执行余弦相似度（Cosine Similarity）搜索，以精准匹配具有语义相关性的记忆切片。",[429,1136,1137],{},"Second Brain 还内置了智能的去重与合并机制。只有在内容相似度低于 85% 时，系统才会将其作为新记忆存储；否则，该内容将被拦截或标记为潜在的重复候选。超过 1,600 字符的长文本会被系统在句子或换行符边界处进行合理切分，并保持相邻分片之间有 200 字符的重叠（Overlap），以防丢失上下文语境。随后，每个文本分片都会被单独向量化，从而实现极高精度的语义匹配。",[429,1139,1140],{},"系统为 AI 智能体直接暴露了以下 MCP 工具接口：",[583,1142,1143,1149,1155,1161,1167,1173,1179],{},[586,1144,1145,1148],{},[433,1146,1147],{},"remember","：存储想法、决策、偏好及项目整体上下文",[586,1150,1151,1154],{},[433,1152,1153],{},"append","：为已有的记忆内容追加新的更新或补充信息",[586,1156,1157,1160],{},[433,1158,1159],{},"update","：完全替换已有的某条记忆内容",[586,1162,1163,1166],{},[433,1164,1165],{},"recall","：基于语义相似度检索相关记忆，而非死板的关键词精确匹配",[586,1168,1169,1172],{},[433,1170,1171],{},"list_recent","：浏览最近保存的记忆记录",[586,1174,1175,1178],{},[433,1176,1177],{},"forget","：永久且彻底地删除某条记忆",[586,1180,1181,1184],{},[433,1182,1183],{},"link\u002Fconnections","：明示关联不同的记忆节点（V2 版本提供的图谱功能）",[1186,1187,1189],"h3",{"id":1188},"在-cloudflare-上配置-second-brain","在 Cloudflare 上配置 Second Brain",[675,1191,1192,1210,1217,1224,1231,1238,1249,1256,1259,1266],{},[586,1193,1194,1195,1200,1201,1204,1205,1209],{},"在 ",[634,1196,1199],{"href":1197,"rel":1198},"https:\u002F\u002Fgithub.com\u002FTech-Voyage-Dev\u002Fsecond-brain-cloudflare",[669],"Github 仓库"," 页面，点击 ",[433,1202,1203],{},"Deploy to Cloudflare"," 按钮。 [[",[981,1206],{"alt":1207,"src":1208},"GitHub 页面上突出显示的 Deploy to Cloudflare 部署按钮","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fdeploy-to-cloudflare-button.webp","]]",[586,1211,1212,1213],{},"填写弹出的 Cloudflare Worker 配置表单。\n",[981,1214],{"alt":1215,"src":1216},"Cloudflare Workers 部署配置表单","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fcloudflare-worker-deployment-form.webp",[586,1218,1219,1220],{},"在 Dimensions（维度）输入 '384'，Metric（度量指标）选择 'cosine'，然后点击 Deploy 按钮。\n",[981,1221],{"alt":1222,"src":1223},"Cloudflare Vectorize 向量数据库创建与维度设置","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fcloudflare-vectorize-configuration.webp",[586,1225,1226,1227],{},"部署成功后，以下是 Cloudflare Workers 平台中 Second Brain 实例的概览信息：\n",[981,1228],{"alt":1229,"src":1230},"已部署的 Second Brain Worker 实例概览主页","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fcloudflare-worker-second-brain-overview.webp",[586,1232,1233,1234],{},"点击 'Settings'（设置），然后点击 'AUTH_TOKEN' 环境变量旁的编辑图标，以创建一条高强度的访问令牌：\n",[981,1235],{"alt":1236,"src":1237},"Cloudflare Worker 变量设置中高亮显示的 AUTH_TOKEN","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fcloudflare-worker-auth-token-settings.webp",[586,1239,1240,1241,1245],{},"点击 'Rotate'（轮换）链接，以便能输入新的安全值： ",[981,1242],{"alt":1243,"src":1244},"AUTH_TOKEN 变量修改与秘钥轮换界面","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fcloudflare-worker-auth-token-rotate.webp",[981,1246],{"alt":1247,"src":1248},"在 AUTH_TOKEN 值字段中输入生成的随机安全字符串","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fcloudflare-worker-auth-token-value-input.webp",[586,1250,1251,1252,1255],{},"在 macOS 终端中运行 ",[433,1253,1254],{},"openssl rand -base64 32"," 命令来生成一个随机的安全字符串，并将其复制粘贴到 'Value' 输入框中。",[586,1257,1258],{},"点击 'Deploy' 按钮，使新配置的 'AUTH_TOKEN' 正式生效。",[586,1260,1261,1262],{},"在浏览器中打开您刚刚创建的 Second Brain Worker 访问域名：\n",[981,1263],{"alt":1264,"src":1265},"包含 Bearer Token 输入框的 Second Brain Web 登录界面","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fsecond-brain-web-ui-login.webp",[586,1267,1194,1268,1271],{},[433,1269,1270],{},"Bearer token"," 输入框中填入刚才创建的 'AUTH_TOKEN'，然后点击 'Connect' 按钮登录 Web 控制台。",[1186,1273,1275],{"id":1274},"通过-mcp-协议集成-claude-desktop","通过 MCP 协议集成 Claude Desktop",[675,1277,1278,1285,1292],{},[586,1279,1280,1281],{},"在 Claude Desktop 客户端中点击 'Customize'（自定义）按钮。\n",[981,1282],{"alt":1283,"src":1284},"Claude Desktop 界面中指向 Customize 自定义按钮的位置","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fclaude-desktop-customize-button.webp",[586,1286,1287,1288],{},"点击 'Developer'（开发者）选项，手动编辑本地的 MCP 配置文件：\n",[981,1289],{"alt":1290,"src":1291},"Claude Desktop 开发者设置菜单中用于打开 MCP 配置文件的选项","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fclaude-desktop-developer-menu.webp",[586,1293,1194,1294,1297,1298,1301],{},[433,1295,1296],{},"claude_desktop_config.json"," 的 ",[433,1299,1300],{},"mcpServers"," 字段中加入以下配置代码块：",[455,1303,1307],{"className":1304,"code":1305,"language":1306,"meta":424,"style":424},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","    \"second-brain\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https:\u002F\u002F\u003Cyour-worker-url>\u002Fmcp\",\n        \"--header\",\n        \"Authorization: Bearer \u003Cyour-token>\"\n      ]\n    }\n","json",[433,1308,1309,1326,1349,1363,1375,1386,1397,1406,1411],{"__ignoreMap":424},[463,1310,1311,1314,1317,1319,1323],{"class":465,"line":466},[463,1312,1313],{"class":504},"    \"",[463,1315,1316],{"class":480},"second-brain",[463,1318,512],{"class":504},[463,1320,1322],{"class":1321},"sTEyZ",": ",[463,1324,1325],{"class":504},"{\n",[463,1327,1328,1331,1335,1337,1340,1342,1344,1346],{"class":465,"line":473},[463,1329,1330],{"class":504},"      \"",[463,1332,1334],{"class":1333},"spNyl","command",[463,1336,512],{"class":504},[463,1338,1339],{"class":504},":",[463,1341,505],{"class":504},[463,1343,495],{"class":480},[463,1345,512],{"class":504},[463,1347,1348],{"class":504},",\n",[463,1350,1351,1353,1356,1358,1360],{"class":465,"line":484},[463,1352,1330],{"class":504},[463,1354,1355],{"class":1333},"args",[463,1357,512],{"class":504},[463,1359,1339],{"class":504},[463,1361,1362],{"class":504}," [\n",[463,1364,1365,1368,1371,1373],{"class":465,"line":491},[463,1366,1367],{"class":504},"        \"",[463,1369,1370],{"class":480},"mcp-remote",[463,1372,512],{"class":504},[463,1374,1348],{"class":504},[463,1376,1377,1379,1382,1384],{"class":465,"line":536},[463,1378,1367],{"class":504},[463,1380,1381],{"class":480},"https:\u002F\u002F\u003Cyour-worker-url>\u002Fmcp",[463,1383,512],{"class":504},[463,1385,1348],{"class":504},[463,1387,1388,1390,1393,1395],{"class":465,"line":541},[463,1389,1367],{"class":504},[463,1391,1392],{"class":480},"--header",[463,1394,512],{"class":504},[463,1396,1348],{"class":504},[463,1398,1399,1401,1404],{"class":465,"line":554},[463,1400,1367],{"class":504},[463,1402,1403],{"class":480},"Authorization: Bearer \u003Cyour-token>",[463,1405,551],{"class":504},[463,1407,1408],{"class":465,"line":559},[463,1409,1410],{"class":504},"      ]\n",[463,1412,1413],{"class":465,"line":571},[463,1414,1415],{"class":504},"    }\n",[429,1417,1418,1422,1423],{},[981,1419],{"alt":1420,"src":1421},"包含 Second Brain 远程服务的 Claude Desktop MCP 配置文件","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fclaude-desktop-mcp-config-json.webp","\n4. 重启 Claude Desktop 并检查 'Local MCP servers' 列表，状态应显示为 'running'（运行中）。\n",[981,1424],{"alt":1425,"src":1426},"Claude Desktop 客户端中显示为运行（running）状态的的 Second Brain MCP 服务","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fclaude-desktop-mcp-status-running.webp",[1186,1428,1430],{"id":1429},"通过-mcp-协议集成-claude-code","通过 MCP 协议集成 Claude Code",[583,1432,1433],{},[586,1434,1435],{},"在终端中运行以下命令以添加该远程 MCP 服务：",[455,1437,1441],{"className":1438,"code":1439,"language":1440,"meta":424,"style":424},"language-shell shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","claude mcp add --transport http second-brain https:\u002F\u002F\u003Cyour-worker-url>\u002Fmcp\n","shell",[433,1442,1443],{"__ignoreMap":424},[463,1444,1445,1448,1451,1453,1456,1459,1462,1465,1468,1471,1474,1477],{"class":465,"line":466},[463,1446,1447],{"class":494},"claude",[463,1449,1450],{"class":480}," mcp",[463,1452,970],{"class":480},[463,1454,1455],{"class":480}," --transport",[463,1457,1458],{"class":480}," http",[463,1460,1461],{"class":480}," second-brain",[463,1463,1464],{"class":480}," https:\u002F\u002F",[463,1466,1467],{"class":504},"\u003C",[463,1469,1470],{"class":480},"your-worker-ur",[463,1472,1473],{"class":1321},"l",[463,1475,1476],{"class":504},">",[463,1478,1479],{"class":480},"\u002Fmcp\n",[583,1481,1482,1488],{},[586,1483,1484,1485,711],{},"Claude Code 会自动检测到该端点需要 OAuth 身份验证，并在您的默认浏览器中打开登录页面，供您输入并验证刚才创建的 ",[433,1486,1487],{},"AUTH_TOKEN",[586,1489,1490,1491,1494,1495,1498,1499,1504],{},"在本地的 ",[433,1492,1493],{},"~\u002F.claude"," 目录下创建 ",[433,1496,1497],{},"CLAUDE.md"," 文件，并将 ",[634,1500,1503],{"href":1501,"rel":1502},"https:\u002F\u002Fgithub.com\u002Frahilp\u002Fsecond-brain-cloudflare\u002Fblob\u002Fmain\u002FAI_Instructions\u002FCLAUDE_INSTRUCTIONS.md",[669],"CLAUDE_INSTRUCTIONS.md"," 文件中的引导词和规则完整写入其中。",[1186,1506,1508],{"id":1507},"通过-mcp-协议集成-gemini-cli","通过 MCP 协议集成 Gemini CLI",[675,1510,1511],{},[586,1512,1513],{},"将以下 MCP 设定信息加入您本地的 '.\u002F.gemini\u002Fsettings.json' 文件：",[455,1515,1517],{"className":1304,"code":1516,"language":1306,"meta":424,"style":424},"    \"second-brain\": {\n      \"httpUrl\": \"https:\u002F\u002F\u003Cyour-worker-url>\u002Fmcp\",\n      \"oauth\": {\n        \"enabled\": true\n      }\n    }\n",[433,1518,1519,1531,1550,1564,1578,1583],{"__ignoreMap":424},[463,1520,1521,1523,1525,1527,1529],{"class":465,"line":466},[463,1522,1313],{"class":504},[463,1524,1316],{"class":480},[463,1526,512],{"class":504},[463,1528,1322],{"class":1321},[463,1530,1325],{"class":504},[463,1532,1533,1535,1538,1540,1542,1544,1546,1548],{"class":465,"line":473},[463,1534,1330],{"class":504},[463,1536,1537],{"class":1333},"httpUrl",[463,1539,512],{"class":504},[463,1541,1339],{"class":504},[463,1543,505],{"class":504},[463,1545,1381],{"class":480},[463,1547,512],{"class":504},[463,1549,1348],{"class":504},[463,1551,1552,1554,1557,1559,1561],{"class":465,"line":484},[463,1553,1330],{"class":504},[463,1555,1556],{"class":1333},"oauth",[463,1558,512],{"class":504},[463,1560,1339],{"class":504},[463,1562,1563],{"class":504}," {\n",[463,1565,1566,1568,1571,1573,1575],{"class":465,"line":491},[463,1567,1367],{"class":504},[463,1569,1570],{"class":494},"enabled",[463,1572,512],{"class":504},[463,1574,1339],{"class":504},[463,1576,1577],{"class":504}," true\n",[463,1579,1580],{"class":465,"line":536},[463,1581,1582],{"class":504},"      }\n",[463,1584,1585],{"class":465,"line":541},[463,1586,1415],{"class":504},[675,1588,1589],{"start":473},[586,1590,1591],{},"启动 Gemini CLI 客户端。",[1186,1593,1595],{"id":1594},"在不同-ai-智能体中测试-second-brain-效果","在不同 AI 智能体中测试 Second Brain 效果",[675,1597,1598,1608,1622],{},[586,1599,1194,1600,1603,1604],{},[442,1601,1602],{},"Claude Desktop"," 中，如果我们只是进行简单的品牌色调偏好设置，此时默认并不会调用外部的 Second Brain 服务：\n",[981,1605],{"alt":1606,"src":1607},"在未启用 Second Brain 记忆层时在 Claude Desktop 中进行的首次偏好设置测试","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fclaude-desktop-first-run-brand-palette.webp",[586,1609,1610,1611,1613,1614,1617,1618],{},"如果我们只是输入 'remember' 等常规词，由于其尚未触发特定提示词引导，",[442,1612,1602],{}," 此时仅会调用本地内置的 ",[433,1615,1616],{},"memory_user-edits"," 工具，并不会同步到云端的持久化记忆层。\n",[981,1619],{"alt":1620,"src":1621},"Claude Desktop 默认调用本地内置用户编辑工具而忽略云端 Second Brain","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fclaude-desktop-remember-built-in-tool-fallback.webp",[586,1623,1624,1625,1628],{},"而当我们在配置了规则引导的 ",[442,1626,1627],{},"Claude Code"," 终端中，输入以下具体指令时，系统便成功地在后台触发并调用了 Second Brain 工具：",[455,1630,1635],{"className":1631,"code":1633,"language":1634},[1632],"language-text","Remember Our brand palette uses `#1a1a2e` as primary, `#16213e` as secondary, and `#e94560` as accent. Never use pure black.\"\n","text",[433,1636,1633],{"__ignoreMap":424},[429,1638,1639,1643,1644,1647,1648,1652,1653,1656,1657,1659,1660,1664,1665,1668,1669,1652,1673],{},[981,1640],{"alt":1641,"src":1642},"Claude Code 终端窗口显示成功触发并写入 Second Brain 远程记忆","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fclaude-code-second-brain-mcp-called.webp","\n4. 登录 ",[442,1645,1646],{},"Cloudflare Workers 控制台"," 查看 Second Brain 的数据库，确认这些颜色信息已成功同步并存储在云端：\n",[981,1649],{"alt":1650,"src":1651},"在 Second Brain 控制台 Web UI 中验证已成功保存的品牌色配置数据","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fsecond-brain-web-ui-color-verification.webp","\n- ",[1005,1654,1655],{},"Claude Code 之所以能够自动无缝工作，得益于项目目录下的 CLAUDE_INSTRUCTIONS.md 文件。该文件让智能体能够理解并关联包含 'Second Brain' 关键字的记忆流程。","\n5. 在 ",[442,1658,1602],{}," 中若想达到相同效果，我们需要在提示词中显式提及 'Second Brain' 相关的指引，以强制智能体读取或写入这一持久化记忆图层。\n",[981,1661],{"alt":1662,"src":1663},"在提示词中显式提及 'Second Brain' 关键字以触发远程记忆读写","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fclaude-desktop-second-brain-explicit-trigger.webp","\n6. 同样地，在 ",[442,1666,1667],{},"Gemini CLI"," 交互中，我们也需要提到 'Second Brain' 关键字，以唤醒并触发其对应的远程 MCP 工具。\n",[981,1670],{"alt":1671,"src":1672},"Gemini CLI 终端命令行交互中成功触发 Second Brain 读写","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fgemini-cli-second-brain-trigger.webp",[1005,1674,1675],{},"如果您仿照 CLAUDE_INSTRUCTIONS.md 的做法，在本地的 GEMINI.md 文件中添加类似的上下文引导，AI 便可在后台静默调用 Second Brain 记忆层，不再需要您每次都手动输入触发关键字。",[1186,1677,1678],{"id":1678},"浏览器插件与快捷剪辑",[583,1680,1681,1684],{},[586,1682,1683],{},"系统为 Chrome、Firefox 和 Microsoft Edge 浏览器提供了官方插件支持。",[586,1685,1686,1687],{},"通过该插件，您可以非常快捷地完成以下操作：\n",[583,1688,1689,1695,1701],{},[586,1690,1691,1694],{},[442,1692,1693],{},"网页一键剪辑"," — 一键将当前页面的网页标题与 URL 网址快捷归档到您的 Second Brain 中。",[586,1696,1697,1700],{},[442,1698,1699],{},"选中文本摘要剪辑"," — 选中网页中的任意精彩段落或技术细节后点击剪辑，该摘录便会配合网页标题和 URL 被一并存储。",[586,1702,1703,1706,1707,1710],{},[442,1704,1705],{},"自由文本速记"," — 在保存前直接在插件弹窗中输入额外的补充上下文，或直接附带 ",[433,1708,1709],{},"#标签","；这些标签会被系统自动识别并提取。",[1186,1712,1714],{"id":1713},"通过-obsidian-插件同步个人本地知识库","通过 Obsidian 插件同步个人本地知识库",[583,1716,1717,1720],{},[586,1718,1719],{},"系统提供了一个 Obsidian 专属插件，支持将您本地 Obsidian Vault（保险库）中的特定笔记完美同步至 Cloudflare 端自托管的 Second Brain 记忆中心。",[586,1721,1722],{},"通过配置特定的同步标签，您可以精准控制哪些笔记能够写入您的持久化 AI 上下文库中。",[1724,1725,1727],"h4",{"id":1726},"安装-obsidian-插件","安装 Obsidian 插件",[675,1729,1730,1744,1755,1762],{},[586,1731,1732,1733,1736,1737,1740],{},"启动 Obsidian 客户端 → 点击 ",[463,1734,1735],{},"Settings（设置）"," → ",[463,1738,1739],{},"Community Plugins（第三方插件）",[981,1741],{"alt":1742,"src":1743},"Obsidian 系统设置面板中指向第三方社区插件的入口","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fobsidian-settings-community-plugins.webp",[586,1745,1746,1747,1750,1751],{},"点击 ",[463,1748,1749],{},"Browse（浏览）"," 按钮。\n",[981,1752],{"alt":1753,"src":1754},"Obsidian 第三方插件应用中心并高亮显示的 Browse 浏览按钮","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fobsidian-community-plugins-browse.webp",[586,1756,1757,1758],{},"检索关键词 'Second Brain Sync'。\n",[981,1759],{"alt":1760,"src":1761},"在 Obsidian 第三方插件市场中搜索 Second Brain Sync 插件","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fobsidian-community-plugins-search-second-brain.webp",[586,1763,1764,1765],{},"点击 'Install' 进行安装，然后点击 'Enable' 启用该插件。\n",[981,1766],{"alt":1767,"src":1768},"在 Obsidian 中点击安装并启用 Second Brain Sync 插件","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fobsidian-plugin-install-and-enable.webp",[1724,1770,1772],{"id":1771},"配置-obsidian-插件","配置 Obsidian 插件",[675,1774,1775,1785,1792,1799,1806,1816],{},[586,1776,1777,1778,1780,1781,1784],{},"进入 Obsidian 客户端 ",[463,1779,1735],{}," → 选中 ",[463,1782,1783],{},"Second Brain Sync"," 插件配置页面：",[586,1786,1787,1788],{},"准确填写您的 Worker 的端点「URL」和刚才创建的「Auth token（身份令牌）」：\n",[981,1789],{"alt":1790,"src":1791},"在 Obsidian 插件配置页面中输入 Worker URL 和 AUTH_TOKEN 身份凭证","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fobsidian-plugin-configuration-credentials.webp",[586,1793,1794,1795],{},"点击 'Test' 按钮来验证网络连接是否畅通：\n",[981,1796],{"alt":1797,"src":1798},"Obsidian 插件连接测试返回成功（Success）提示","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fobsidian-plugin-connection-test-success.webp",[586,1800,1801,1802],{},"配置具体的同步策略。设定您的同步标签「Sync tag」并开启「Auto-sync on save（保存时自动同步）」功能：\n",[981,1803],{"alt":1804,"src":1805},"在 Obsidian 插件中配置特定同步标签并启用保存时自动同步","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fobsidian-plugin-sync-behavior-settings.webp",[586,1807,1808,1809,1811,1812],{},"在 Obsidian 知识库中新建一篇笔记，并为其附带您配置好的同步标签（例如： ",[433,1810,1316],{},"）：\n",[981,1813],{"alt":1814,"src":1815},"在 Obsidian 中创建一篇带有 'second-brain' 标签的待同步本地笔记","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fobsidian-note-with-sync-tag.webp",[586,1817,1818,1819],{},"笔记保存后，其内容已成功触发并自动同步到在 Cloudflare 上运行的自托管 Second Brain 实例中：\n",[981,1820],{"alt":1821,"src":1822},"在云端 Second Brain 控制台 Web UI 中验证已成功同步过来的 Obsidian 笔记","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002Fsecond-brain-web-ui-synced-note-verification.webp",[447,1824,1825],{"id":1825},"总结与展望",[429,1827,1828],{},"Second Brain 记忆系统为困扰当前 AI 生态的最大痛点之一 —— 长期上下文遗忘与记忆断层，提供了一套极为优雅的开源解决方案。通过将自托管项目与 CloudflareWorkers 弹性、全球分布的 Serverless 基础设施深度结合，我们得以在边缘网络上轻松架设起一条低延迟、高响应速度的个人语义记忆网关。得益于 MCP 这一开放的标准，这条记忆脉络如今已能无缝流动、并被移植共享于各种主流的 AI 助手和开发终端之间。",[429,1830,1831],{},"Obsidian 专属同步插件的加入，更是将这套架构完美融合进了个人日常的知识管理（PKM）流程。您平时随手记录的杂乱卡片或开发速记，能被有选择地提炼并重构，转化为可被 AI 完美解析的结构化上下文。",[429,1833,1834],{},"将私有化部署、高精度的语义向量搜索以及开放式的 MCP 集成标准相融合，Second Brain 不仅仅是一层记忆的外挂，它正向我们展示着一个由用户个人掌握核心数据所有权，安全、独立、互联的未来 Agent 生态系统基石。",[447,1836,1838],{"id":1837},"参考资料","参考资料：",[583,1840,1841,1847,1853,1860,1867],{},[586,1842,1843],{},[634,1844,1845],{"href":1845,"rel":1846},"https:\u002F\u002Fwww.thesecondbrain.dev\u002F",[669],[586,1848,1849],{},[634,1850,1851],{"href":1851,"rel":1852},"https:\u002F\u002Fgithub.com\u002Frahilp\u002Fsecond-brain-cloudflare\u002Fwiki\u002FHow-It-Works",[669],[586,1854,1855],{},[634,1856,1859],{"href":1857,"rel":1858},"https:\u002F\u002Fgithub.com\u002Frahilp\u002Fsecond-brain-cloudflare\u002Fwiki\u002FConnect-to-AI-Clients",[669],"Connect to AI Clients",[586,1861,1862],{},[634,1863,1866],{"href":1864,"rel":1865},"https:\u002F\u002Fgithub.com\u002Frahilp\u002Fsecond-brain-cloudflare\u002Fwiki\u002FObsidian-Plugin",[669],"Second Brain Obsidian Plugin",[586,1868,1869],{},[634,1870,1871],{"href":1871,"rel":1872},"https:\u002F\u002Fgithub.com\u002Frahilp\u002Fsecond-brain-obsidian-plugin",[669],[1038,1874,1875],{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":424,"searchDepth":473,"depth":484,"links":1877},[1878,1879,1880,1892,1893],{"id":1080,"depth":473,"text":1081},{"id":1090,"depth":473,"text":1091},{"id":1112,"depth":473,"text":1113,"children":1881},[1882,1883,1884,1885,1886,1887,1888],{"id":1188,"depth":484,"text":1189},{"id":1274,"depth":484,"text":1275},{"id":1429,"depth":484,"text":1430},{"id":1507,"depth":484,"text":1508},{"id":1594,"depth":484,"text":1595},{"id":1678,"depth":484,"text":1678},{"id":1713,"depth":484,"text":1714,"children":1889},[1890,1891],{"id":1726,"depth":491,"text":1727},{"id":1771,"depth":491,"text":1772},{"id":1825,"depth":473,"text":1825},{"id":1837,"depth":473,"text":1838},[1895,1049],"cloudflare","2026-08-07","学习如何利用Cloudflare Workers、Vectorize与MCP协议构建自托管的AI持久化记忆系统（Second Brain）。在Claude、Gemini和Obsidian之间实现多Agent上下文共享。","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FUse%20Cloudflare%20as%20AI%20memory\u002FZH-Use-Cloudflare-as-AI-memory.webp","基于 Cloudflare Workers 和 Vectorize 构建的自托管 AI 持久化记忆系统，支持 MCP 协议与 Obsidian 笔记双向同步。",{"schemaOrg":1901,"robots":1059,"sitemap":1904},[1902],{"@type":1058,"headline":1903,"description":1897},"基于Cloudflare与MCP构建自托管AI持久化记忆系统",{"lastmod":1896},35,{"title":1903,"description":1897,"ogTitle":1075,"ogDescription":1897,"twitterTitle":1075,"twitterDescription":1897},"zh\u002Farticle\u002Fuse-cloudflare-as-ai-memory",[1066,1909,1910,1102,1911],"MCP","AI 记忆","Obsidian","GcIodpT98ONAwkuIbWbfMhCB1u7m4jUIxYtKqcXxO9c",{"id":1914,"title":1915,"author":1069,"body":1916,"category":3837,"date":3839,"description":3840,"extension":1052,"image":3841,"imageAlt":3842,"isPublished":487,"meta":3843,"minRead":3851,"navigation":487,"path":329,"seo":3852,"stem":3853,"tags":3854,"updatedAt":3858,"__hash__":3859},"article\u002Fzh\u002Farticle\u002Fself-hosted-travel-planner-trek.md","使用Docker与TREK自托管您的个性化智能旅行日程：一站式深度规划并轻松管理预订、财务和行李清单",{"type":426,"value":1917,"toc":3796},[1918,1921,1924,1927,1931,1935,2123,2126,2134,2154,2157,2160,2265,2276,2279,2284,2287,2299,2303,2307,2310,2313,2351,2355,2358,2391,2394,2436,2439,2444,2455,2459,2466,2470,2473,2565,2569,2572,2576,2583,2587,2590,2608,2619,2623,2626,2637,2641,2645,2655,2659,2663,2666,2670,2674,2677,2682,2685,2690,2696,2700,2704,2707,2711,2723,2728,2734,2739,2743,2746,2751,2756,2759,2766,2770,2773,2776,2786,2792,2797,2804,2809,2813,2819,2824,2827,2832,2836,2842,2846,2851,2855,2858,2861,2866,2871,2876,2880,2887,2892,2897,2902,2907,2911,2917,2922,2928,2932,2935,2939,2945,2950,2955,2961,2966,2971,2976,2989,2993,2998,3019,3024,3027,3031,3034,3039,3042,3090,3094,3101,3107,3112,3118,3123,3129,3134,3140,3143,3148,3155,3160,3166,3170,3177,3182,3185,3189,3193,3199,3203,3206,3213,3217,3224,3228,3240,3249,3253,3257,3267,3276,3281,3288,3293,3300,3304,3307,3460,3463,3467,3470,3475,3478,3484,3488,3495,3499,3502,3507,3514,3519,3523,3534,3601,3617,3620,3625,3629,3633,3644,3721,3735,3738,3742,3746,3749,3752,3755,3758,3767,3770,3793],[429,1919,1920],{},"在规划旅行时，最繁琐的部分莫过于那些零散的数据：机票预订PDF、酒店确认信、旅伴之间的聊天记录、想去的景点清单等，都散落在不同的角落。而当需要汇总总花销、拆分账单时，又得在海量的出行记录中不停翻找，极为耗费精力。",[429,1922,1923],{},"TREK是一款可以自托管的开源旅行规划系统，能够将您的行程、预订、财务预算和行李清单一站式整合到同一个平台中。其内置的MCP（Model Context Protocol）服务器还允许AI智能体（如Claude Desktop）直接操作您的出行数据。",[429,1925,1926],{},"本教程将带您一步步完成从系统部署到完整管理一次真实旅行的全过程。",[1186,1928,1930],{"id":1929},"_1-如何使用docker部署trek旅行规划器","1. 如何使用Docker部署TREK旅行规划器",[1724,1932,1934],{"id":1933},"在ubuntu-vps上安装docker","在Ubuntu VPS上安装Docker",[455,1936,1938],{"className":457,"code":1937,"language":459,"meta":424,"style":424},"# Add Docker's official GPG key and set up the Docker repository\ncurl -fsSL https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu\u002Fgpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fdocker-archive-keyring.gpg\n\n# Add the official Docker repository\necho \"deb [arch=amd64 signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fdocker-archive-keyring.gpg] https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu $(lsb_release -cs) stable\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fdocker.list > \u002Fdev\u002Fnull\n\n# Update package list\nsudo apt update\n\n# Install Docker Engine, Docker Community Edition, and containerd runtime\nsudo apt install docker-ce docker-ce-cli containerd.io -y\n\n# Verify docker is installed\ndocker --version\n\n# Starts automatically when your system boots\nsudo systemctl enable docker\n",[433,1939,1940,1945,1974,1978,1983,2026,2030,2035,2046,2050,2056,2078,2083,2089,2098,2103,2109],{"__ignoreMap":424},[463,1941,1942],{"class":465,"line":466},[463,1943,1944],{"class":469},"# Add Docker's official GPG key and set up the Docker repository\n",[463,1946,1947,1950,1953,1956,1959,1962,1965,1968,1971],{"class":465,"line":473},[463,1948,1949],{"class":494},"curl",[463,1951,1952],{"class":480}," -fsSL",[463,1954,1955],{"class":480}," https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu\u002Fgpg",[463,1957,1958],{"class":504}," |",[463,1960,1961],{"class":494}," sudo",[463,1963,1964],{"class":480}," gpg",[463,1966,1967],{"class":480}," --dearmor",[463,1969,1970],{"class":480}," -o",[463,1972,1973],{"class":480}," \u002Fusr\u002Fshare\u002Fkeyrings\u002Fdocker-archive-keyring.gpg\n",[463,1975,1976],{"class":465,"line":484},[463,1977,488],{"emptyLinePlaceholder":487},[463,1979,1980],{"class":465,"line":491},[463,1981,1982],{"class":469},"# Add the official Docker repository\n",[463,1984,1985,1988,1990,1993,1996,1999,2002,2005,2008,2010,2012,2014,2017,2020,2023],{"class":465,"line":536},[463,1986,1987],{"class":476},"echo",[463,1989,505],{"class":504},[463,1991,1992],{"class":480},"deb [arch=amd64 signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fdocker-archive-keyring.gpg] https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu ",[463,1994,1995],{"class":504},"$(",[463,1997,1998],{"class":494},"lsb_release",[463,2000,2001],{"class":480}," -cs",[463,2003,2004],{"class":504},")",[463,2006,2007],{"class":480}," stable",[463,2009,512],{"class":504},[463,2011,1958],{"class":504},[463,2013,1961],{"class":494},[463,2015,2016],{"class":480}," tee",[463,2018,2019],{"class":480}," \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fdocker.list",[463,2021,2022],{"class":504}," >",[463,2024,2025],{"class":480}," \u002Fdev\u002Fnull\n",[463,2027,2028],{"class":465,"line":541},[463,2029,488],{"emptyLinePlaceholder":487},[463,2031,2032],{"class":465,"line":554},[463,2033,2034],{"class":469},"# Update package list\n",[463,2036,2037,2040,2043],{"class":465,"line":559},[463,2038,2039],{"class":494},"sudo",[463,2041,2042],{"class":480}," apt",[463,2044,2045],{"class":480}," update\n",[463,2047,2048],{"class":465,"line":571},[463,2049,488],{"emptyLinePlaceholder":487},[463,2051,2053],{"class":465,"line":2052},10,[463,2054,2055],{"class":469},"# Install Docker Engine, Docker Community Edition, and containerd runtime\n",[463,2057,2059,2061,2063,2066,2069,2072,2075],{"class":465,"line":2058},11,[463,2060,2039],{"class":494},[463,2062,2042],{"class":480},[463,2064,2065],{"class":480}," install",[463,2067,2068],{"class":480}," docker-ce",[463,2070,2071],{"class":480}," docker-ce-cli",[463,2073,2074],{"class":480}," containerd.io",[463,2076,2077],{"class":480}," -y\n",[463,2079,2081],{"class":465,"line":2080},12,[463,2082,488],{"emptyLinePlaceholder":487},[463,2084,2086],{"class":465,"line":2085},13,[463,2087,2088],{"class":469},"# Verify docker is installed\n",[463,2090,2092,2095],{"class":465,"line":2091},14,[463,2093,2094],{"class":494},"docker",[463,2096,2097],{"class":480}," --version\n",[463,2099,2101],{"class":465,"line":2100},15,[463,2102,488],{"emptyLinePlaceholder":487},[463,2104,2106],{"class":465,"line":2105},16,[463,2107,2108],{"class":469},"# Starts automatically when your system boots\n",[463,2110,2112,2114,2117,2120],{"class":465,"line":2111},17,[463,2113,2039],{"class":494},[463,2115,2116],{"class":480}," systemctl",[463,2118,2119],{"class":480}," enable",[463,2121,2122],{"class":480}," docker\n",[1724,2124,2125],{"id":2125},"生成加密密钥",[429,2127,2128,2129,2133],{},"TREK使用一个专门的密钥来加密敏感数据。您可以使用以下命令或这个",[634,2130,2132],{"href":2131},"\u002Fzh\u002Ftools\u002Fsecret-key-hex","在线工具","来生成加密密钥：",[455,2135,2137],{"className":457,"code":2136,"language":459,"meta":424,"style":424},"openssl rand -hex 32\n",[433,2138,2139],{"__ignoreMap":424},[463,2140,2141,2144,2147,2150],{"class":465,"line":466},[463,2142,2143],{"class":494},"openssl",[463,2145,2146],{"class":480}," rand",[463,2148,2149],{"class":480}," -hex",[463,2151,2153],{"class":2152},"sbssI"," 32\n",[429,2155,2156],{},"请务必将其妥善保存在安全的地方。如果遗失该密钥，您将无法访问已加密的数据。",[1724,2158,2159],{"id":2159},"启动容器",[455,2161,2163],{"className":457,"code":2162,"language":459,"meta":424,"style":424},"docker run -d \\\n  --name trek \\\n  -p 3000:3000 \\\n  -e ENCRYPTION_KEY=\"\u003Cgenerated_key>\" \\\n  -e APP_URL=\"https:\u002F\u002Ftrek.pafor.me\" \\\n  -v .\u002Fdata:\u002Fapp\u002Fdata \\\n  -v .\u002Fuploads:\u002Fapp\u002Fuploads \\\n  --restart unless-stopped \\\n  mauriceboe\u002Ftrek:latest\n",[433,2164,2165,2178,2188,2198,2215,2231,2241,2250,2260],{"__ignoreMap":424},[463,2166,2167,2169,2172,2175],{"class":465,"line":466},[463,2168,2094],{"class":494},[463,2170,2171],{"class":480}," run",[463,2173,2174],{"class":480}," -d",[463,2176,2177],{"class":1321}," \\\n",[463,2179,2180,2183,2186],{"class":465,"line":473},[463,2181,2182],{"class":480},"  --name",[463,2184,2185],{"class":480}," trek",[463,2187,2177],{"class":1321},[463,2189,2190,2193,2196],{"class":465,"line":484},[463,2191,2192],{"class":480},"  -p",[463,2194,2195],{"class":480}," 3000:3000",[463,2197,2177],{"class":1321},[463,2199,2200,2203,2206,2208,2211,2213],{"class":465,"line":491},[463,2201,2202],{"class":480},"  -e",[463,2204,2205],{"class":480}," ENCRYPTION_KEY=",[463,2207,512],{"class":504},[463,2209,2210],{"class":480},"\u003Cgenerated_key>",[463,2212,512],{"class":504},[463,2214,2177],{"class":1321},[463,2216,2217,2219,2222,2224,2227,2229],{"class":465,"line":536},[463,2218,2202],{"class":480},[463,2220,2221],{"class":480}," APP_URL=",[463,2223,512],{"class":504},[463,2225,2226],{"class":480},"https:\u002F\u002Ftrek.pafor.me",[463,2228,512],{"class":504},[463,2230,2177],{"class":1321},[463,2232,2233,2236,2239],{"class":465,"line":541},[463,2234,2235],{"class":480},"  -v",[463,2237,2238],{"class":480}," .\u002Fdata:\u002Fapp\u002Fdata",[463,2240,2177],{"class":1321},[463,2242,2243,2245,2248],{"class":465,"line":554},[463,2244,2235],{"class":480},[463,2246,2247],{"class":480}," .\u002Fuploads:\u002Fapp\u002Fuploads",[463,2249,2177],{"class":1321},[463,2251,2252,2255,2258],{"class":465,"line":559},[463,2253,2254],{"class":480},"  --restart",[463,2256,2257],{"class":480}," unless-stopped",[463,2259,2177],{"class":1321},[463,2261,2262],{"class":465,"line":571},[463,2263,2264],{"class":480},"  mauriceboe\u002Ftrek:latest\n",[583,2266,2267],{},[586,2268,2269,2275],{},[442,2270,2271,2272],{},"必须正确设置 ",[433,2273,2274],{},"APP_URL"," —— 因为MCP服务器的OAuth授权发现流程完全依赖于它。请在一开始就将其设置为您最终的公开HTTPS地址。",[429,2277,2278],{},"首次运行需要一些时间来拉取镜像：",[981,2280],{"src":2281,"alt":2282,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-docker-pull-image.webp","TREK 的 Docker 拉取和运行日志","max-width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2285,2286],{},"验证容器是否成功运行：",[455,2288,2290],{"className":457,"code":2289,"language":459,"meta":424,"style":424},"docker ps\n",[433,2291,2292],{"__ignoreMap":424},[463,2293,2294,2296],{"class":465,"line":466},[463,2295,2094],{"class":494},[463,2297,2298],{"class":480}," ps\n",[981,2300],{"src":2301,"alt":2302,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-docker-ps-status.webp","通过 docker ps 验证运行中的容器状态",[1186,2304,2306],{"id":2305},"_2-使用caddy反向代理配置域名路由与ssl证书","2. 使用Caddy反向代理配置域名路由与SSL证书",[429,2308,2309],{},"通行密钥（Passkeys）功能和MCP所需的OAuth授权都强制要求HTTPS加密。我们的域名托管在提供免费SSL证书和DDoS保护的Cloudflare上。",[429,2311,2312],{},"我们将Caddy配置为安全的反向代理服务器，用来指向容器的3000端口。Caddyfile配置示例如下：",[455,2314,2316],{"className":1304,"code":2315,"language":1306,"meta":424,"style":424},"{$TREK_DOMAIN} {\n  encode zstd gzip\n  reverse_proxy host.docker.internal:3000\n}\n",[433,2317,2318,2331,2336,2346],{"__ignoreMap":424},[463,2319,2320,2323,2326,2329],{"class":465,"line":466},[463,2321,2322],{"class":504},"{",[463,2324,2325],{"class":1321},"$TREK_DOMAIN",[463,2327,2328],{"class":504},"}",[463,2330,1563],{"class":504},[463,2332,2333],{"class":465,"line":473},[463,2334,2335],{"class":1321},"  encode zstd gzip\n",[463,2337,2338,2341,2343],{"class":465,"line":484},[463,2339,2340],{"class":1321},"  reverse_proxy host.docker.internal",[463,2342,1339],{"class":504},[463,2344,2345],{"class":2152},"3000\n",[463,2347,2348],{"class":465,"line":491},[463,2349,2350],{"class":504},"}\n",[1186,2352,2354],{"id":2353},"_3-初始配置与安全的管理员设置","3. 初始配置与安全的管理员设置",[429,2356,2357],{},"创建管理员账户有两种方式：",[583,2359,2360,2372],{},[586,2361,2362,2371],{},[442,2363,2364,2365,436,2368],{},"在环境配置中直接设置 ",[433,2366,2367],{},"ADMIN_EMAIL",[433,2369,2370],{},"ADMIN_PASSWORD"," 变量，系统将直接使用该凭证。",[586,2373,2374,2375,2378,2379,2382,2383,2386,2387,2390],{},"TREK会自动生成一个邮箱 ",[433,2376,2377],{},"admin@trek.local","、用户名 ",[433,2380,2381],{},"admin","，以及一个",[442,2384,2385],{},"随机生成的密码，并打印到容器日志中","。运行 ",[433,2388,2389],{},"docker logs trek"," 即可获取。",[429,2392,2393],{},"如果您在日志中找不到密码，可以通过以下命令进行手动重置：",[455,2395,2397],{"className":457,"code":2396,"language":459,"meta":424,"style":424},"docker exec -it -e RESET_ADMIN_EMAIL=admin@trek.local -e RESET_ADMIN_PASSWORD='YourNewPassword' trek node server\u002Freset-admin.js\n",[433,2398,2399],{"__ignoreMap":424},[463,2400,2401,2403,2406,2409,2412,2415,2417,2420,2423,2426,2428,2430,2433],{"class":465,"line":466},[463,2402,2094],{"class":494},[463,2404,2405],{"class":480}," exec",[463,2407,2408],{"class":480}," -it",[463,2410,2411],{"class":480}," -e",[463,2413,2414],{"class":480}," RESET_ADMIN_EMAIL=admin@trek.local",[463,2416,2411],{"class":480},[463,2418,2419],{"class":480}," RESET_ADMIN_PASSWORD=",[463,2421,2422],{"class":504},"'",[463,2424,2425],{"class":480},"YourNewPassword",[463,2427,2422],{"class":504},[463,2429,2185],{"class":480},[463,2431,2432],{"class":480}," node",[463,2434,2435],{"class":480}," server\u002Freset-admin.js\n",[429,2437,2438],{},"在首次登录时，系统会提示您修改初始密码。",[981,2440],{"src":2441,"alt":2442,"style":2443},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-initial-login-password-prompt.webp","初始登录和管理员密码重置提示","max-width: 215px; width:100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2445,1746,2446,2449,2450],{},[442,2447,2448],{},"Admin（管理员）"," 选项卡并更新您的电子邮箱：",[981,2451],{"src":2452,"alt":2453,"style":2454},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-admin-email-update-panel.webp","在 TREK 管理员设置中配置自定义电子邮件","max-width: 700px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1724,2456,2458],{"id":2457},"_31-备份策略","3.1 备份策略",[429,2460,2461,2462],{},"在管理员后台，可以非常方便地配置带有保留策略的自动备份方案：\n",[981,2463],{"src":2464,"alt":2465,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-admin-backup-retention-policy.webp","配置自动备份计划和保留规则",[1724,2467,2469],{"id":2468},"_32-将上传的文件存储到cloudflare-r2","3.2 将上传的文件存储到Cloudflare R2",[429,2471,2472],{},"将上传的文件、照片和备份数据保存在Cloudflare R2中，能够让您的VPS磁盘保持干净和轻量。TREK全面支持S3兼容的存储后端，而Cloudflare R2正是这一需求的完美解决方案。",[675,2474,2475,2482,2494,2505,2516,2528,2539,2554],{},[586,2476,2477,2478,2481],{},"新建一个名为 ",[433,2479,2480],{},"trek"," 的R2存储桶。",[586,2483,1194,2484,2487,2488,2489],{},[442,2485,2486],{},"Account Details（账户详情）"," 区域，找到您的账户ID：","\n  ",[981,2490],{"src":2491,"alt":2492,"style":2493},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fcloudflare-r2-account-details-id.webp","在控制台中定位 Cloudflare 帐户 ID","max-width: 325px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[586,2495,1746,2496,2499,2488,2500],{},[442,2497,2498],{},"Manage API Tokens（管理API令牌）","：",[981,2501],{"src":2502,"alt":2503,"style":2504},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fcloudflare-r2-manage-api-tokens-button.webp","Cloudflare 控制台中的管理 API 令牌界面","max-width: 282px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[586,2506,1746,2507,2510,2488,2511],{},[442,2508,2509],{},"Create Account API token（创建账户API令牌）","，并授予针对该桶的读写权限：",[981,2512],{"src":2513,"alt":2514,"style":2515},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fcloudflare-r2-create-token-permissions.webp","创建具有读写权限的 R2 访问令牌","max-width: 360px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[586,2517,2518,2519,2522,2488,2523],{},"在管理员面板中，点击 ",[442,2520,2521],{},"Storage（存储）"," 配置页：",[981,2524],{"src":2525,"alt":2526,"style":2527},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-administration-storage-menu.webp","导航到 TREK 控制面板中的存储设置","max-width: 539px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[586,2529,1746,2530,2533,2488,2534],{},[442,2531,2532],{},"Add Backend（添加后端）"," 按钮，填入您的Endpoint（终结点）、Bucket（存储桶名称）和API凭证：",[981,2535],{"src":2536,"alt":2537,"style":2538},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-add-storage-backend-credentials.webp","配置 S3 兼容的 Cloudflare R2 存储后端","max-width: 445px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[586,2540,1746,2541,2544,2545,2548,2488,2549],{},[442,2542,2543],{},"Apply（应用）","，然后点击 ",[442,2546,2547],{},"Test（测试）"," 链接。当看到“Connection OK”字样时，说明连接测试成功：",[981,2550],{"src":2551,"alt":2552,"style":2553},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-test-storage-backend-connection-ok.webp","存储后端连接测试成功，显示 Connection OK","max-width: 677px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[586,2555,2556,2557,2499,2488,2560],{},"将所有存储类别切换为Cloudflare R2并点击 ",[442,2558,2559],{},"Save changes（保存修改）",[981,2561],{"src":2562,"alt":2563,"style":2564},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-switch-storage-categories-r2.webp","将所有 file 存储分类路由到 Cloudflare R2","max-width: 653px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1724,2566,2568],{"id":2567},"_33-通行密钥passkey登录","3.3 通行密钥（Passkey）登录",[429,2570,2571],{},"TREK支持通行密钥、双重身份验证（2FA）以及基于OIDC的单点登录。如果想开启通行密钥，请在设置中输入您的域名和Allowed Origins（允许的源），然后保存即可：",[981,2573],{"src":2574,"alt":2575,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-passkey-allowed-origins-settings.webp","注册用于安全金钥（Passkey）身份验证的允许源",[429,2577,2578,2579,2582],{},"如果没有正确配置 ",[442,2580,2581],{},"Allowed Origins","，通行密钥注册将会失败。",[1724,2584,2586],{"id":2585},"_34-google-maps-api密钥","3.4 Google Maps API密钥",[429,2588,2589],{},"配置Google Maps密钥可以让您的地点检索功能变得更丰富，自动补充评分、营业时间和地点实景图。如果您不配置密钥，TREK会默认降级使用免费的OpenStreetMap（只是不显示评分和实景照片）。",[429,2591,2592,2593,2598,2599,2602,2603],{},"访问此",[634,2594,2597],{"href":2595,"rel":2596},"https:\u002F\u002Fmapsplatform.google.com\u002Fmaps-demo-key\u002F",[669],"链接","并点击 ",[442,2600,2601],{},"Get demo key"," 即可申请一个测试密钥：                                                  ",[981,2604],{"src":2605,"alt":2606,"style":2607},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fgoogle-maps-get-demo-api-key.webp","申请 Google Maps Platform API 密钥","max-width: 176px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2609,2610,2611,2614,2615],{},"将获取到的API Key粘贴到设置中，然后点击 ",[442,2612,2613],{},"Test"," 验证连接是否通畅：\n",[981,2616],{"src":2617,"alt":2618,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-google-maps-key-test-connection.webp","在设置中验证 Google Maps API 密钥的连通性",[1724,2620,2622],{"id":2621},"_35-ai集成","3.5 AI集成",[429,2624,2625],{},"内置的AI解析引擎主要用于处理您的预订确认邮件和PDF，将它们自动转换为结构化的预订数据。",[429,2627,2628,2629,2632,2633,2636],{},"点击左侧菜单中的 ",[442,2630,2631],{},"Addons（附加组件）"," 并启用 ",[442,2634,2635],{},"AI Parsing","。选择“OpenAI”（或其它兼容的AI提供商）并填写相应的凭证信息：",[981,2638],{"src":2639,"alt":2640,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-addons-enable-ai-parsing-openai.webp","启用带有 OpenAI 集成的 AI 解析插件",[1724,2642,2644],{"id":2643},"_36-mcp访问权限","3.6 MCP访问权限",[429,2646,2647,2648,2651,2652,2654],{},"同样在 ",[442,2649,2650],{},"Addons"," 选项中，开启 ",[442,2653,1909],{}," 协议：",[981,2656],{"src":2657,"alt":2658,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-addons-enable-mcp.webp","启用 Model Context Protocol MCP 服务器插件",[1724,2660,2662],{"id":2661},"_37-插件推荐","3.7 插件推荐",[429,2664,2665],{},"以下几款官方插件非常推荐您顺手激活：",[981,2667],{"src":2668,"alt":2669,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-recommended-addons-plugins-activation.webp","活跃的推荐插件和扩展列表",[1724,2671,2673],{"id":2672},"_38-创建您的日常使用账户","3.8 创建您的日常使用账户",[429,2675,2676],{},"在平时规划旅行时，建议使用普通用户账户，而非管理员账户。让我们在后台创建一个日常账户并登录：",[981,2678],{"src":2679,"alt":2680,"style":2681},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-create-regular-user-form.webp","在 TREK 面板中创建普通用户账户","max-width: 420px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2683,2684],{},"登录后，建议立刻绑定通行密钥或设置2FA来强化该账户的安全级别：",[981,2686],{"src":2687,"alt":2688,"style":2689},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-user-security-passkey-2fa-setup.webp","使用安全金钥（Passkey）和双重认证配置用户安全设置","max-width: 381px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2691,1746,2692,2695],{},[442,2693,2694],{},"+ Add a passkey","，输入当前密码，然后按照浏览器提示完成安全确认：",[981,2697],{"src":2698,"alt":2699,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-add-passkey-confirm-password.webp","确认密码以注册新的硬件安全金钥",[1186,2701,2703],{"id":2702},"_4-测试您的部署导入历史出行数据","4. 测试您的部署：导入历史出行数据",[429,2705,2706],{},"快速上手并熟悉TREK系统的一个极佳方式是，将您过去走过的旅行足迹录入其中。",[1724,2708,2710],{"id":2709},"_41-创建旅行计划","4.1 创建旅行计划",[429,2712,1746,2713,2716,2717,436,2720,2499],{},[442,2714,2715],{},"+ New Trip（新建旅行）","，并根据那次历史旅行的真实起止时间设定 ",[442,2718,2719],{},"Start Date",[442,2721,2722],{},"End Date",[981,2724],{"src":2725,"alt":2726,"style":2727},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-create-new-trip-details.webp","创建具有自定义日期范围的新旅行","max-width: 334px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2729,2730,2731,2499],{},"上传一张好看的封面图（可以直接将图片拖入或从剪贴板粘贴），接着点击 ",[442,2732,2733],{},"Create New Trip",[981,2735],{"src":2736,"alt":2737,"style":2738},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-trip-cover-image-upload.webp","配置高质量的旅行封面图片","max-width: 608px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1724,2740,2742],{"id":2741},"_42-导入预订信息","4.2 导入预订信息",[429,2744,2745],{},"将您当时留存的机票、火车票和其它交通工具预订确认文件直接拖放到上传区域：",[981,2747],{"src":2748,"alt":2749,"style":2750},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-import-travel-booking-files.webp","用于导入旅行 PDF 和预订文件的拖拽区域","max-width: 570px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2752],{"src":2753,"alt":2754,"style":2755},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-import-booking-pdf-processing-status.webp","已上传预订的处理窗口，显示提取状态","max-width: 377px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2757,2758],{},"由于我们已经启用了AI解析引擎，预订确认PDF文件会被自动分析，提取出结构化的预订日程。",[429,2760,2761,2762,2765],{},"检查解析结果无误后，点击 ",[442,2763,2764],{},"Add"," 将其正式写入预订数据中：",[981,2767],{"src":2768,"alt":2769,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-review-parsed-booking-details.webp","审查由 AI 提取的结构化预订细节",[429,2771,2772],{},"如果有些预订确认仅保存在邮件中，您可以将其导出为PDF格式并上传，同样可以走这套提取流程。",[429,2774,2775],{},"在系统中，已导入的预订信息会以极具现代感的方式呈现：",[429,2777,2778,2782],{},[981,2779],{"src":2780,"alt":2781,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-trip-bookings-timeline-view.webp","旅行预订的完整时间线展示",[981,2783],{"src":2784,"alt":2785,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-booking-confirmation-details.webp","已确认交通预订的详细视图",[429,2787,1194,2788,2791],{},[442,2789,2790],{},"Plan（日程规划）"," 页面中，所有的酒店和住宿点都会在地图上被优雅地标注出来：",[981,2793],{"src":2794,"alt":2795,"style":2796},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-plan-accommodations-map-display.webp","标有所有酒店住宿的交互式地图","max-width: 546px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2798,2799,2800,2803],{},"点击上方的 ",[442,2801,2802],{},"Atlas（旅行足迹）","，您将能从清单和世界地图上直观地看到所有已拜访的国家：",[981,2805],{"src":2806,"alt":2807,"style":2808},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-atlas-countries-visited-summary.webp","个人 Atlas 追踪器中的旅行历史概述","max-width: 407px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1724,2810,2812],{"id":2811},"_43-添加旅行同伴","4.3 添加旅行同伴",[429,2814,1746,2815,2818],{},[442,2816,2817],{},"Share（分享）"," 按钮：",[981,2820],{"src":2821,"alt":2822,"style":2823},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-trip-share-options-button.webp","在 TREK 中打开旅行分享对话框","max-width: 224px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2825,2826],{},"在弹出的对话框底部，可以直接添加旅行同伴为Guest（嘉宾）：",[981,2828],{"src":2829,"alt":2830,"style":2831},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-trip-add-companions-guests.webp","添加自定义旅行同伴和随行客人","max-width: 635px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1724,2833,2835],{"id":2834},"_44-记录旅行费用","4.4 记录旅行费用",[429,2837,1746,2838,2841],{},[442,2839,2840],{},"Add expense（添加开销）","，来记录那些无法通过PDF预订单自动解析的杂项支出，例如境外险、当地公共交通费、临时SIM卡等：",[981,2843],{"src":2844,"alt":2845,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-add-custom-expense-form.webp","在支出表单中输入详细的花费数据",[981,2847],{"src":2848,"alt":2849,"style":2850},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-expenses-list-billing-split.webp","分摊账单明细和费用追踪账本","max-width: 526px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1724,2852,2854],{"id":2853},"_45-拆分旅行阶段","4.5 拆分旅行阶段",[429,2856,2857],{},"该功能需要提前在后台激活“Trip Segment”插件。",[429,2859,2860],{},"对于那些超长周期的旅程，将其拆分为不同的阶段能让脉络更清晰，每个阶段都可以有自己独立的预订项目、待办事项和成本账单：",[981,2862],{"src":2863,"alt":2864,"style":2865},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-trip-segments-overview-display.webp","将复杂的行程拆分为旅行段","max-width: 465px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2867],{"src":2868,"alt":2869,"style":2870},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-trip-segment-itinerary-details.webp","显示地点和计划的活跃旅行段","max-width: 596px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2872],{"src":2873,"alt":2874,"style":2875},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-trip-segments-interactive-map.webp","在时间线上绘制不同的旅行航段","max-width: 605px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1724,2877,2879],{"id":2878},"_46-创建journal日志并查看旅行足迹atlas","4.6 创建Journal（日志）并查看旅行足迹（Atlas）",[429,2881,2882,2883,2886],{},"您还可以将几次旅行串联成一个 ",[442,2884,2885],{},"Journey（旅程）","，并图文并茂地撰写游记故事，方便分享给您的朋友们：",[981,2888],{"src":2889,"alt":2890,"style":2891},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-create-new-journey-group.webp","将多次旅行合并为一个可视化的旅程","max-width: 441px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2893],{"src":2894,"alt":2895,"style":2896},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-journey-timeline-story-writing.webp","在旅程面板中撰写可视化故事","max-width: 443px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2898],{"src":2899,"alt":2900,"style":2901},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-journey-gallery-media-grid.webp","旅程内部的媒体收集和画廊网格","max-width: 440px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2903],{"src":2904,"alt":2905,"style":2906},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-journey-public-share-link.webp","为协同旅程生成公开分享链接","max-width: 532px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1186,2908,2910],{"id":2909},"_5-设计自定义行程与行李清单","5. 设计自定义行程与行李清单",[429,2912,1746,2913,2916],{},[442,2914,2915],{},"+ New Trip","，输入旅行的专属名称并指定起止日期：",[981,2918],{"src":2919,"alt":2920,"style":2921},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-planning-new-trip-setup.webp","创建未定日期旅行的初始提示对话框","max-width: 432px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2923,2924,2927],{},[442,2925,2926],{},"如果具体的出行时间还没有敲定，可以将日期项留空。"," 此时系统会显示一个“天数配置（最高支持365天）”字段，您可以先设计每日的游玩内容，等后续买好机票后再一键锚定日期。",[1724,2929,2931],{"id":2930},"_51-添加地点景点","5.1 添加地点\u002F景点",[429,2933,2934],{},"这是旅行规划中最耗时的一步，但TREK提供了四种极具效率的方式来帮助您添加地点：",[981,2936],{"src":2937,"alt":2938,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-add-places-methods-overview.webp","向行程添加新地点的多种途径",[429,2940,2941,2944],{},[442,2942,2943],{},"1. 直接在地图上右键点击："," 会在该坐标处直接创建新地点，其标准地址会被系统自动逆地理编码解析出来：",[981,2946],{"src":2947,"alt":2948,"style":2949},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-right-click-map-location.webp","在地图界面右键点击以精确定位","max-width: 632px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2951],{"src":2952,"alt":2953,"style":2954},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-right-click-reverse-geocode-address.webp","所选地图坐标的自动逆地理编码","max-width: 628px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2956,2957,2960],{},[442,2958,2959],{},"2. 点击 + Add Place\u002FActivity："," 在搜索框中直接通过关键字进行检索",[981,2962],{"src":2963,"alt":2964,"style":2965},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-search-place-by-name-input.webp","使用文本输入搜索真实地点","max-width: 642px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2967],{"src":2968,"alt":2969,"style":2970},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-select-place-search-results-list.webp","显示带有地址标注的地点搜索结果列表","max-width: 594px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,2972],{"src":2973,"alt":2974,"style":2975},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-place-details-rich-info-card.webp","包含评论和评分的完整地点信息卡","max-width: 568px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2977,2978,2981,2982,708,2985,2988],{},[442,2979,2980],{},"3. 直接粘贴谷歌地图分享链接："," （如 ",[433,2983,2984],{},"maps.app.goo.gl\u002F…",[433,2986,2987],{},"maps.google.com\u002F…","）粘贴到检索栏中。TREK会自动抓取该地点的名称、地址和经纬度：",[981,2990],{"src":2991,"alt":2992,"style":2553},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-paste-google-maps-share-link.webp","直接从粘贴的 Google 地图分享链接解析地点",[981,2994],{"src":2995,"alt":2996,"style":2997},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-google-maps-parsed-location.webp","成功从地图 URL 中提取坐标","max-width: 543px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,2999,3000,3003,3004,3007,3008,708,3011,3014,3015,3018],{},[442,3001,3002],{},"4. 批量导入数据："," 这是最轻松的方案。如果您在Google Maps中维护着自己的“想去清单”，可以将其导出为 ",[433,3005,3006],{},".gpx"," 文件（",[433,3009,3010],{},".kml",[433,3012,3013],{},".kmz"," 格式亦支持），然后点击右侧面板的 ",[442,3016,3017],{},"Import file","，一键拉取所有数据：",[981,3020],{"src":3021,"alt":3022,"style":3023},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-bulk-import-places-gpx-file.webp","使用 GPX 或 KML 文件批量导入地点","max-width: 389px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3025,3026],{},"推荐您可以先把所有感兴趣的项目都添加进来。至于如何将它们科学地归入到每一天的日程中，后续可以直接在面板里拖拽处理。",[1724,3028,3030],{"id":3029},"_52-每日日程与备注","5.2 每日日程与备注",[429,3032,3033],{},"Day Plan（每日计划）的核心逻辑是将所有的目的地按每日访问顺序进行排序。整个界面是一个可以折叠、支持任意拖放的模块：",[981,3035],{"src":3036,"alt":3037,"style":3038},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-day-plan-drag-drop-ordering.webp","使用拖放操作自定义每日路线顺序","max-width: 496px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3040,3041],{},"这些细节机制设计得极其精妙实用：",[583,3043,3044,3054,3064,3074],{},[586,3045,3046,3049,3050],{},[442,3047,3048],{},"中间移动方式","：点击每日日程左上角的公共汽车图标，可以设定各节点之间的过渡交通方式（如地铁、自驾、甚至是直达航班）：\n",[981,3051],{"src":3052,"alt":3053,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-day-plan-commuting-transport-button.webp","登记日行程各段之间的通勤交通方式",[586,3055,3056,3059,3060],{},[442,3057,3058],{},"每日备忘","：点击左下角的便签图标可以附加各种定制化提醒（例如：“今天需要提早出发”、“美术馆门票需提前预约”）：\n",[981,3061],{"src":3062,"alt":3063,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-day-plan-icon-tagged-notes-button.webp","为天行程添加显眼的、带有图标的自定义备注",[586,3065,3066,3069,3070],{},[442,3067,3068],{},"指定时间段","：从右侧拖拽地点并给它分配一个开始时间。设置了时间的地点会自动在地图上生成推荐的行进路线：\n",[981,3071],{"src":3072,"alt":3073,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-day-plan-timed-places-routing.webp","带时间点的地点之间自动计算的交通路线",[586,3075,3076,3077,3080,3081,3084,3085,711],{},"关于智能路线优化（",[442,3078,3079],{},"Route optimisation","）以及气候（",[442,3082,3083],{},"Weather","），您可以查阅 ",[634,3086,3089],{"href":3087,"rel":3088},"https:\u002F\u002Fgithub.com\u002Fliketrek\u002FTREK\u002Fwiki\u002FDay-Plans-and-Notes",[669],"Day Plans and Notes的Wiki文档",[1724,3091,3093],{"id":3092},"_53-收藏夹可重复使用的地点清单","5.3 收藏夹：可重复使用的地点清单",[429,3095,3096,3097,3100],{},"Collections（收藏夹）允许用户在具体的旅行项目之外，保存并分类管理自己精心收集的宝藏地点。您可以将其打包分享给朋友。这些地点在加入旅行时是采用",[442,3098,3099],{},"复制","的方式，因此在旅行日程中对其进行的任何个性化标注，都不会破坏您收藏夹里的原始干净数据。",[429,3102,3103,3104,2499],{},"点击顶部菜单栏中的 ",[442,3105,3106],{},"Collections",[981,3108],{"src":3109,"alt":3110,"style":3111},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-collections-dashboard-view.webp","访问保存地点的自定义用户收藏夹","max-width: 495px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3113,1746,3114,3117],{},[442,3115,3116],{},"+ New list"," 建立新的分类列表：",[981,3119],{"src":3120,"alt":3121,"style":3122},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-collections-create-new-list.webp","在收藏夹中创建自定义列表","max-width: 269px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3124,1746,3125,3128],{},[442,3126,3127],{},"+ Add a place"," 并填入该地点的详细情况：",[981,3130],{"src":3131,"alt":3132,"style":3133},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-collections-add-place-manually-form.webp","手动输入表单以填充自定义收藏列表","max-width: 271px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3135,3136,3139],{},[442,3137,3138],{},"注意："," 收藏夹内的搜索组件偶尔可能会因网络原因失效，如果发生该情况，您可以通过手动输入来创建。",[429,3141,3142],{},"当地点带有准确的GPS坐标时，它们会精美地展示在地图中：",[981,3144],{"src":3145,"alt":3146,"style":3147},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-collections-map-places-display.webp","在交互式地图上可视化自定义收藏中的地点","max-width: 592px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3149,3150,3151,3154],{},"如需批量组织这些地标，可以点击 ",[442,3152,3153],{},"checkbox（勾选框）"," 图标：",[981,3156],{"src":3157,"alt":3158,"style":3159},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-collections-select-places-tickbox.webp","批量标记已保存地点的选择模式","max-width: 662px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3161,3162,3163,2499],{},"多选目标后，点击 ",[442,3164,3165],{},"Assign label（分配标签）",[981,3167],{"src":3168,"alt":3169,"style":2997},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-collections-group-assign-label.webp","为选定的收藏地点分配描述性标签",[429,3171,3172,3173,3176],{},"在分配之前，先点击 ",[442,3174,3175],{},"Manage labels（管理标签）"," 来新建一些醒目的彩色分组标签：",[981,3178],{"src":3179,"alt":3180,"style":3181},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-collections-manage-custom-labels.webp","创建和管理自定义标签","max-width: 411px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3183,3184],{},"点击一个具体标签，接着选择一键绑定：",[981,3186],{"src":3187,"alt":3188,"style":2808},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-collections-confirm-label-selection.webp","应用自定义标签到成组的地点",[1724,3190,3192],{"id":3191},"_54-费用与预算","5.4 费用与预算",[429,3194,1194,3195,3198],{},[442,3196,3197],{},"Costs（财务管理）"," 页面中，我们可以录入其它的预备预算和旅途支出。",[981,3200],{"src":3201,"alt":3202,"style":3038},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-costs-budget-overall-expenses-list.webp","完整的支出表格和余额结算账本",[429,3204,3205],{},"在结伴出行时，您可以在此页记录每个人的垫付账单，并选定分摊规则。",[429,3207,3208,3209,3212],{},"系统的结算后台采用了一种贪心匹配算法，计算并生成",[442,3210,3211],{},"最简化的转账精算方案","，帮大家用最少的转账次数轻松对齐账目。",[1186,3214,3216],{"id":3215},"_6-利用model-context-protocolmcp实现ai驱动的旅行规划","6. 利用Model Context Protocol（MCP）实现AI驱动的旅行规划",[429,3218,3219,3220,3223],{},"TREK内置了 ",[442,3221,3222],{},"MCP（模型上下文协议）服务器","。这意味着，AI智能体可以直接“读写”您的行程规划数据。它提供了超过150个精细的原子工具和30个核心数据源，全方位覆盖行程、地点、账目、行李、预订和多人协作。",[1724,3225,3227],{"id":3226},"_61-cloudflare-zero-trust网络配置","6.1 Cloudflare Zero Trust网络配置",[429,3229,3230,3231,3234,3235,711],{},"由于我们的自托管服务运行在 ",[634,3232,3233],{"href":363},"Cloudflare Zero Trust"," 内网环境下，我们需要在“Split Tunnels（分流隧道）”配置中，将该服务的域名加入到 Inclusion List（包含\u002F直连白名单）中。否则在进行 OAuth 登录授权发现时，接口调用会被网络策略阻断。具体的配置排障可以参考这个 GitHub 讨论贴：",[634,3236,3239],{"href":3237,"rel":3238},"https:\u002F\u002Fgithub.com\u002Fliketrek\u002FTREK\u002Fissues\u002F1463",[669],"GitHub Issue",[3241,3242],"article-card",{"description":3243,"image":3244,"image-alt":3245,"label":3246,"min-read":3247,"title":3248,"to":363},"本文深入探讨如何使用 Cloudflare WARP 与 Zero Trust 技术，在完全不需要开启任何防火墙入站端口的情况下，安全地将您的 Hermes Agent 暴露到私有网络中，从而实现全球范围内的安全访问。这为您构建专属私有远程 AI 基础设施打下坚实基础。","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FExposing%20Hermes%20Agent%20to%20Private%20Network%20Using%20Cloudflare%20WARP\u002FZH-Exposing-Hermes-Agent-to-Private-Network-Using-Cloudflare-WARP.webp","通过 Cloudflare Zero Trust 和 WARP 隧道安全地将 Hermes Agent 暴露至私有网络","相关指南","5","教程：使用 Cloudflare WARP 安全地将 Hermes Agent 暴露至私有网络",[981,3250],{"src":3251,"alt":3252,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fcloudflare-zero-trust-split-tunnels-domain.webp","向 Cloudflare Warp 分流隧道（Split Tunnels）添加自定义域名",[1724,3254,3256],{"id":3255},"_62-claude-desktop客户端配置","6.2 Claude Desktop客户端配置",[429,3258,1746,3259,3262,3263],{},[442,3260,3261],{},"+ New Client"," 创设一个新的 AI 客户端接口：\n",[981,3264],{"src":3265,"alt":3266,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-register-new-mcp-client.webp","在设置中注册新的自定义客户端令牌",[429,3268,3269,3270,3272,3273,2499],{},"选择 ",[442,3271,1602],{}," 选项卡，然后点击 ",[442,3274,3275],{},"Register Client（注册客户端）",[981,3277],{"src":3278,"alt":3279,"style":3280},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-mcp-claude-desktop-client-credentials.webp","生成 Claude Desktop 客户端凭据","max-width: 354px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3282,3283,3284,3287],{},"系统此时会展示唯一的 Client ID 和 Client Secret，请妥善保存。接着点击 ",[442,3285,3286],{},"Client Configuration（客户端配置）"," 调出我们需要在本地写入的 JSON 代码片段：",[981,3289],{"src":3290,"alt":3291,"style":3292},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-mcp-client-configuration-block.webp","获取预格式化的 MCP 服务器配置块","max-width: 508px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3294,3295,3296,3299],{},"在 Claude Desktop 软件中，点击 ",[442,3297,3298],{},"Edit Config"," 会在代码编辑器中打开您本地的 MCP server 配置文件：",[981,3301],{"src":3302,"alt":3303,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fclaude-desktop-mcp-config-json.webp","编辑 Claude Desktop 的本地 MCP 配置文件 json",[429,3305,3306],{},"将 TREK 的 MCP 代码块粘贴进去，并把占位符部分替换为上一步生成的客户端凭证：",[455,3308,3310],{"className":1304,"code":3309,"language":1306,"meta":424,"style":424},"  \"mcpServers\": {\n    \"trek\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https:\u002F\u002Ftrek.pafor.me\u002Fmcp\",\n        \"--static-oauth-client-info\",\n        \"{\\\"client_id\\\": \\\"\u003Cyour_client_id>\\\", \\\"client_secret\\\": \\\"\u003Cyour_client_secret>\\\"}\"\n      ]\n    }\n  },\n",[433,3311,3312,3325,3337,3355,3367,3377,3388,3399,3445,3449,3453],{"__ignoreMap":424},[463,3313,3314,3317,3319,3321,3323],{"class":465,"line":466},[463,3315,3316],{"class":504},"  \"",[463,3318,1300],{"class":480},[463,3320,512],{"class":504},[463,3322,1322],{"class":1321},[463,3324,1325],{"class":504},[463,3326,3327,3329,3331,3333,3335],{"class":465,"line":473},[463,3328,1313],{"class":504},[463,3330,2480],{"class":1333},[463,3332,512],{"class":504},[463,3334,1339],{"class":504},[463,3336,1563],{"class":504},[463,3338,3339,3341,3343,3345,3347,3349,3351,3353],{"class":465,"line":484},[463,3340,1330],{"class":504},[463,3342,1334],{"class":494},[463,3344,512],{"class":504},[463,3346,1339],{"class":504},[463,3348,505],{"class":504},[463,3350,495],{"class":480},[463,3352,512],{"class":504},[463,3354,1348],{"class":504},[463,3356,3357,3359,3361,3363,3365],{"class":465,"line":491},[463,3358,1330],{"class":504},[463,3360,1355],{"class":494},[463,3362,512],{"class":504},[463,3364,1339],{"class":504},[463,3366,1362],{"class":504},[463,3368,3369,3371,3373,3375],{"class":465,"line":536},[463,3370,1367],{"class":504},[463,3372,1370],{"class":480},[463,3374,512],{"class":504},[463,3376,1348],{"class":504},[463,3378,3379,3381,3384,3386],{"class":465,"line":541},[463,3380,1367],{"class":504},[463,3382,3383],{"class":480},"https:\u002F\u002Ftrek.pafor.me\u002Fmcp",[463,3385,512],{"class":504},[463,3387,1348],{"class":504},[463,3389,3390,3392,3395,3397],{"class":465,"line":554},[463,3391,1367],{"class":504},[463,3393,3394],{"class":480},"--static-oauth-client-info",[463,3396,512],{"class":504},[463,3398,1348],{"class":504},[463,3400,3401,3403,3405,3408,3411,3413,3415,3417,3420,3422,3425,3427,3430,3432,3434,3436,3439,3441,3443],{"class":465,"line":559},[463,3402,1367],{"class":504},[463,3404,2322],{"class":480},[463,3406,3407],{"class":1321},"\\\"",[463,3409,3410],{"class":480},"client_id",[463,3412,3407],{"class":1321},[463,3414,1322],{"class":480},[463,3416,3407],{"class":1321},[463,3418,3419],{"class":480},"\u003Cyour_client_id>",[463,3421,3407],{"class":1321},[463,3423,3424],{"class":480},", ",[463,3426,3407],{"class":1321},[463,3428,3429],{"class":480},"client_secret",[463,3431,3407],{"class":1321},[463,3433,1322],{"class":480},[463,3435,3407],{"class":1321},[463,3437,3438],{"class":480},"\u003Cyour_client_secret>",[463,3440,3407],{"class":1321},[463,3442,2328],{"class":480},[463,3444,551],{"class":504},[463,3446,3447],{"class":465,"line":571},[463,3448,1410],{"class":504},[463,3450,3451],{"class":465,"line":2052},[463,3452,1415],{"class":504},[463,3454,3455,3458],{"class":465,"line":2058},[463,3456,3457],{"class":504},"  }",[463,3459,1348],{"class":1321},[429,3461,3462],{},"重新启动 Claude Desktop 客户端。此时在 Local MCP servers（本地MCP服务）列表中就会看到 TREK 已经成功连接：",[981,3464],{"src":3465,"alt":3466,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fclaude-desktop-mcp-trek-server-connected.webp","在 Claude 界面中验证活跃的 TREK 连接状态",[429,3468,3469],{},"现在，您可以直接用日常口语来下达规划指令了：",[981,3471],{"src":3472,"alt":3473,"style":3474},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fclaude-desktop-mcp-natural-language-prompt.webp","使用自然语言提示 Claude 操作旅行数据","max-width: 550px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3476,3477],{},"例如，我们用纯中文录入一笔非标准化的日常开支：",[455,3479,3482],{"className":3480,"code":3481,"language":1634,"meta":424},[1632],"For the West Europe trip, the Grab from KLIA1 to the hotel cost RM115.90 on 26\u002F4\u002F2025. Please add it as an expense without split to the trip.\n",[433,3483,3481],{"__ignoreMap":424},[981,3485],{"src":3486,"alt":3487,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fclaude-desktop-mcp-add-expense-response.webp","Claude 调用工具自动记录一笔支出",[429,3489,3490,3491,3494],{},"回到后台，刷新 ",[442,3492,3493],{},"Costs"," 面板。我们可以看到这笔打车费用已经被精确地记录下来，且因为命令中并未提及“由谁付款”，系统体贴地将付款人项归纳为了“No one paid yet（尚未有人支付）”：",[981,3496],{"src":3497,"alt":3498,"style":2454},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-costs-page-mcp-parsed-expense.webp","在费用视图中确认最新由 AI 解析的支出",[429,3500,3501],{},"管理行李清单的方式也完全一致：",[981,3503],{"src":3504,"alt":3505,"style":3506},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fclaude-desktop-mcp-add-packing-items.webp","Claude 使用自然语言提示添加打包清单物品","max-width: 631px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3508,3509,3510,3513],{},"再次刷新 ",[442,3511,3512],{},"Packing List"," 页面，指定的这三样出行装备已经被整齐地加入到了清单之中：",[981,3515],{"src":3516,"alt":3517,"style":3518},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Ftrek-packing-list-mcp-parsed-items.webp","在打包清单页面中确认最新解析的打包物品","max-width: 312px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[1724,3520,3522],{"id":3521},"_63-gemini-cli动态注册","6.3 Gemini CLI（动态注册）",[429,3524,3525,3526,3529,3530,3533],{},"Gemini CLI 对 ",[442,3527,3528],{},"Dynamic Registration（动态注册机制）"," 提供了极佳的支持，这使得您完全无需在系统后台手动预注册任何客户端凭证。直接将以下代码追加到您本地的 ",[433,3531,3532],{},".gemini\u002Fsettings.json"," 文件中：",[455,3535,3537],{"className":1304,"code":3536,"language":1306,"meta":424,"style":424},"    \"trek\": {\n      \"httpUrl\": \"https:\u002F\u002Ftrek.pafor.me\u002Fmcp\",\n      \"oauth\": {\n        \"enabled\": true\n      }\n    }\n",[433,3538,3539,3551,3569,3581,3593,3597],{"__ignoreMap":424},[463,3540,3541,3543,3545,3547,3549],{"class":465,"line":466},[463,3542,1313],{"class":504},[463,3544,2480],{"class":480},[463,3546,512],{"class":504},[463,3548,1322],{"class":1321},[463,3550,1325],{"class":504},[463,3552,3553,3555,3557,3559,3561,3563,3565,3567],{"class":465,"line":473},[463,3554,1330],{"class":504},[463,3556,1537],{"class":1333},[463,3558,512],{"class":504},[463,3560,1339],{"class":504},[463,3562,505],{"class":504},[463,3564,3383],{"class":480},[463,3566,512],{"class":504},[463,3568,1348],{"class":504},[463,3570,3571,3573,3575,3577,3579],{"class":465,"line":484},[463,3572,1330],{"class":504},[463,3574,1556],{"class":1333},[463,3576,512],{"class":504},[463,3578,1339],{"class":504},[463,3580,1563],{"class":504},[463,3582,3583,3585,3587,3589,3591],{"class":465,"line":491},[463,3584,1367],{"class":504},[463,3586,1570],{"class":494},[463,3588,512],{"class":504},[463,3590,1339],{"class":504},[463,3592,1577],{"class":504},[463,3594,3595],{"class":465,"line":536},[463,3596,1582],{"class":504},[463,3598,3599],{"class":465,"line":541},[463,3600,1415],{"class":504},[429,3602,3603,3604,3607,3608,3611,3612],{},"在终端运行 ",[433,3605,3606],{},"gemini"," 命令，并在随后拉起的网页授权页面中点击 ",[442,3609,3610],{},"Approve（批准）"," 即可：\n",[981,3613],{"src":3614,"alt":3615,"style":3616},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fmcp-client-oauth-authorization-prompt.webp","批准针对 TREK MCP 服务器的 OAuth 访问授权","max-width: 488px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3618,3619],{},"现在便可以通过极简的命令行终端向 AI 提问了：",[981,3621],{"src":3622,"alt":3623,"style":3624},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fgemini-cli-mcp-prompt-itinerary.webp","使用 Gemini CLI 提示获取旅行行程","max-width: 415px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[981,3626],{"src":3627,"alt":3628,"style":2901},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fgemini-cli-mcp-display-itinerary.webp","Gemini CLI 成功展示结构化的旅行信息",[1724,3630,3632],{"id":3631},"_64-kimi-cli动态注册","6.4 Kimi CLI（动态注册）",[429,3634,3635,3636,3639,3640,3643],{},"原理基本相同。请在本地 ",[433,3637,3638],{},"\u002FUsers\u002F\u003C您的用户名>\u002F.kimi\u002F"," 目录下找到 ",[433,3641,3642],{},"mcp.json"," 并写入以下连接配置：",[455,3645,3647],{"className":1304,"code":3646,"language":1306,"meta":424,"style":424},"    \"trek\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Ftrek.pafor.me\u002Fmcp\",\n      \"auth\": \"oauth\"\n    }\n",[433,3648,3649,3661,3681,3700,3717],{"__ignoreMap":424},[463,3650,3651,3653,3655,3657,3659],{"class":465,"line":466},[463,3652,1313],{"class":504},[463,3654,2480],{"class":480},[463,3656,512],{"class":504},[463,3658,1322],{"class":1321},[463,3660,1325],{"class":504},[463,3662,3663,3665,3668,3670,3672,3674,3677,3679],{"class":465,"line":473},[463,3664,1330],{"class":504},[463,3666,3667],{"class":1333},"type",[463,3669,512],{"class":504},[463,3671,1339],{"class":504},[463,3673,505],{"class":504},[463,3675,3676],{"class":480},"http",[463,3678,512],{"class":504},[463,3680,1348],{"class":504},[463,3682,3683,3685,3688,3690,3692,3694,3696,3698],{"class":465,"line":484},[463,3684,1330],{"class":504},[463,3686,3687],{"class":1333},"url",[463,3689,512],{"class":504},[463,3691,1339],{"class":504},[463,3693,505],{"class":504},[463,3695,3383],{"class":480},[463,3697,512],{"class":504},[463,3699,1348],{"class":504},[463,3701,3702,3704,3707,3709,3711,3713,3715],{"class":465,"line":491},[463,3703,1330],{"class":504},[463,3705,3706],{"class":1333},"auth",[463,3708,512],{"class":504},[463,3710,1339],{"class":504},[463,3712,505],{"class":504},[463,3714,1556],{"class":480},[463,3716,551],{"class":504},[463,3718,3719],{"class":465,"line":536},[463,3720,1415],{"class":504},[429,3722,3723,3724,3727,3728,3731,3732],{},"在终端执行 ",[433,3725,3726],{},"kimi mcp auth trek"," 并在网页上点击 ",[442,3729,3730],{},"Approve"," 完成快速授权：\n",[981,3733],{"src":3614,"alt":3615,"style":3734},"max-width: 453px; width: 100%; height: auto; border-radius: 8px; margin: 1.5rem auto; display: block;",[429,3736,3737],{},"完成授权后，您将能够在命令行直接调用所有关联的微服务工具：",[981,3739],{"src":3740,"alt":3741,"style":2283},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002Fkimi-cli-mcp-authorized-tools-list.webp","授权成功后 Kimi CLI 显示的可用工具列表",[1186,3743,3745],{"id":3744},"_7-移动端使用体验","7. 移动端使用体验",[429,3747,3748],{},"在手机和移动设备上，TREK是以 PWA（渐进式Web应用）的形式呈现的。其内置的 Service Worker 能够将地图网格瓦片和日程 API 数据离线缓存，确保在野外或没有网络信号的极佳状态下，您依然能够流畅查看已制定的全部行程。不过，离线状态下的推送通知响应速度相较原生应用会有微小的延迟。",[1186,3750,3751],{"id":3751},"写在最后",[429,3753,3754],{},"通过 MCP 将 AI 智能体接入您的日常旅行规划，可以帮您省去那些因手动键入繁多的航班和酒店确认单而产生的大量枯燥劳动。不仅如此，AI 还能根据您指定的具体出行节点和所处季节，智能推荐周边的特色景点。仅仅通过几句随意的对话，AI 就能轻松打通从前期灵感检索、行程路线设计，再到后期预算拆分和行李打包的完整全链路。",[429,3756,3757],{},"不过在目前的版本中，依然存在一些微小的体验瑕疵。例如：通过 PDF 智能解析导入订单时，账单货币会默认对齐到旅行项目的主货币，而不是当时实际刷卡结算的付款货币。此外，在 Collections 收藏夹中新建清单列表时，如果在列表尚未保存时就给它配置封面，该封面可能在保存后失效（您需要在列表正式建立后，点击“编辑”来重新添加并保存，即可解决）。",[429,3759,3760,3761,3766],{},"此外，因为它需要您拥有一定的 VPS 运维基础来亲自运行这套程序，对一般用户确实存在一些上手门槛。TREK 更适合那些重度旅行爱好者、数字游民以及对于自身出行数据隐私和排版有着高水准要求的极客用户。我们由衷地建议您在下定决心搭建自托管服务之前，可以先在 ",[634,3762,3765],{"href":3763,"rel":3764},"https:\u002F\u002Fdemo.liketrek.com\u002F",[669],"demo.liketrek.com"," 上完整试用一下官方提供的公测 DEMO，看它是否切中您的日常痛点。",[1186,3768,3769],{"id":1837},"参考资料:",[583,3771,3772,3779,3786],{},[586,3773,3774],{},[634,3775,3778],{"href":3776,"rel":3777},"https:\u002F\u002Fgithub.com\u002Fliketrek\u002FTREK\u002Fwiki\u002FQuick-Start",[669],"TREK Quick Start",[586,3780,3781],{},[634,3782,3785],{"href":3783,"rel":3784},"https:\u002F\u002Fgithub.com\u002Fliketrek\u002FTREK\u002Fwiki\u002FTroubleshooting",[669],"TREK Troubleshooting",[586,3787,3788],{},[634,3789,3792],{"href":3790,"rel":3791},"https:\u002F\u002Fgithub.com\u002Fliketrek\u002FTREK\u002Fwiki\u002FMCP-Scopes",[669],"TREK MCP Scopes",[1038,3794,3795],{},"html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}",{"title":424,"searchDepth":473,"depth":484,"links":3797},[3798,3803,3804,3814,3822,3828,3834,3835,3836],{"id":1929,"depth":484,"text":1930,"children":3799},[3800,3801,3802],{"id":1933,"depth":491,"text":1934},{"id":2125,"depth":491,"text":2125},{"id":2159,"depth":491,"text":2159},{"id":2305,"depth":484,"text":2306},{"id":2353,"depth":484,"text":2354,"children":3805},[3806,3807,3808,3809,3810,3811,3812,3813],{"id":2457,"depth":491,"text":2458},{"id":2468,"depth":491,"text":2469},{"id":2567,"depth":491,"text":2568},{"id":2585,"depth":491,"text":2586},{"id":2621,"depth":491,"text":2622},{"id":2643,"depth":491,"text":2644},{"id":2661,"depth":491,"text":2662},{"id":2672,"depth":491,"text":2673},{"id":2702,"depth":484,"text":2703,"children":3815},[3816,3817,3818,3819,3820,3821],{"id":2709,"depth":491,"text":2710},{"id":2741,"depth":491,"text":2742},{"id":2811,"depth":491,"text":2812},{"id":2834,"depth":491,"text":2835},{"id":2853,"depth":491,"text":2854},{"id":2878,"depth":491,"text":2879},{"id":2909,"depth":484,"text":2910,"children":3823},[3824,3825,3826,3827],{"id":2930,"depth":491,"text":2931},{"id":3029,"depth":491,"text":3030},{"id":3092,"depth":491,"text":3093},{"id":3191,"depth":491,"text":3192},{"id":3215,"depth":484,"text":3216,"children":3829},[3830,3831,3832,3833],{"id":3226,"depth":491,"text":3227},{"id":3255,"depth":491,"text":3256},{"id":3521,"depth":491,"text":3522},{"id":3631,"depth":491,"text":3632},{"id":3744,"depth":484,"text":3745},{"id":3751,"depth":484,"text":3751},{"id":1837,"depth":484,"text":3769},[3838,1049],"travel","2026-09-01","本文详细介绍如何使用Docker部署开源旅行规划系统TREK。我们将带您配置Caddy反向代理和Cloudflare R2对象存储，实现数据的安全备份与图片的高效加载。此外，还将演示如何利用MCP（模型上下文协议）连接Claude等AI智能体，通过自然语言对话一键生成您的专属旅行日程，开启完美旅程。","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf%20hosted%20travel%20planner%20TREK\u002FZH-Self-hosted-travel-planner-TREK.webp","在一张温和的羊皮纸背景上，高质量极简风格的TREK自托管旅行规划器仪表盘3D插图。",{"schemaOrg":3844,"robots":1059,"sitemap":3850},[3845,3847],{"@type":3846,"headline":1915,"description":3840},"HowTo",{"@type":3848,"headline":3849,"description":3840},"Article","如何自托管AI旅行规划器TREK：基于Docker、Caddy与Cloudflare R2的终极部署教程",{"lastmod":3839},22,{"title":3849,"description":3840,"ogTitle":1915,"ogDescription":3840,"twitterTitle":1915,"twitterDescription":3840},"zh\u002Farticle\u002Fself-hosted-travel-planner-trek",[3855,3856,3857,1066,1909],"Docker","TREK","Caddy","2026-09-03","YpXK5B3vw79VCnu8AAPsKrl-TJGMOOkDVTMlz2Tw_9Y",[3861,6031,6032],{"id":3862,"title":3863,"author":424,"body":3864,"category":5997,"date":5999,"description":6000,"extension":1052,"image":6001,"imageAlt":6002,"isPublished":487,"meta":6003,"minRead":2058,"navigation":487,"path":383,"seo":6025,"stem":6027,"tags":6028,"updatedAt":1069,"__hash__":6030},"article\u002Fzh\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues.md","自建 Block 旗下 Buzz 协作平台：轻松构建人类与 AI 智能体高效协同工作的全新共享工作空间",{"type":426,"value":3865,"toc":5967},[3866,3869,3875,3881,3885,3888,3926,3930,3936,3974,3978,3982,3996,4002,4007,4011,4015,4028,4034,4083,4109,4113,4122,4128,4132,4135,4318,4322,4366,4373,4380,4386,4436,4442,4471,4475,4479,4498,4526,4539,4581,4589,4870,4874,4919,4924,4931,4936,4940,4963,4966,4972,4978,4982,4990,4996,4999,5005,5011,5039,5046,5052,5055,5061,5065,5068,5071,5074,5080,5083,5089,5095,5101,5106,5110,5121,5128,5134,5137,5143,5146,5153,5159,5166,5170,5178,5241,5250,5304,5307,5376,5382,5398,5404,5408,5454,5460,5463,5469,5472,5478,5482,5499,5515,5521,5618,5621,5627,5638,5687,5693,5699,5712,5728,5731,5737,5741,5748,5770,5780,5878,5888,5894,5901,5907,5910,5916,5919,5925,5928,5931,5934,5964],[429,3867,3868],{},"在与多个 AI 智能体（AI Agent）协同工作时，最让人头疼的障碍莫过于“上下文断片化（Context Fragmentation）”。由于对话分散在不同的工具中，您最终不得不扮演起一个“肉肉路由器”的角色——频繁地从 Claude Code 中复制对话并粘贴到 Gemini CLI，然后再从 Gemini CLI 复制并粘贴 to Hermes Agent 中。而当您身边还有人类团队成员一起协作时，这种繁琐的摩擦感更是成倍增长。",[429,3870,3871],{},[981,3872],{"alt":3873,"src":3874},"Buzz 协作工作空间的用户界面，显示聊天频道和活跃的 AI 智能体","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-workspace-interface.webp",[429,3876,3877,3880],{},[442,3878,3879],{},"Buzz"," 是一款开源的协同工作空间，它将人类团队和 AI 智能体凝聚在一个统一的环境中。在这里，人类同事与 AI 智能体能够共享相同的任务和项目历史，并实现天衣无缝的工作交接。",[447,3882,3884],{"id":3883},"什么是-block-旗下的-buzz人机协同的-ai-智能体共享空间","什么是 Block 旗下的 Buzz？人机协同的 AI 智能体共享空间",[429,3886,3887],{},"Buzz 是 Block 公司（由推特创始人杰克·多西创立）推出的开源协作工作空间，它让团队成员和 AI 智能体能够在相同的频道与项目中并肩工作。它具有以下几个核心亮点：",[583,3889,3890,3896,3902,3908,3914,3920],{},[586,3891,3892,3895],{},[442,3893,3894],{},"共享上下文："," 频道是团队成员与智能体开展协作的核心阵地。所有的对话记录和项目历史都完整保留在频道中。",[586,3897,3898,3901],{},[442,3899,3900],{},"智能体间通信："," 智能体之间能够跨机器直接进行交流。一个 AI 智能体可以 @ 另一个智能体，从而完成工作的转交或代码的交叉审查。",[586,3903,3904,3907],{},[442,3905,3906],{},"提及驱动激活："," AI 智能体仅在被 @ 提及时才会激活，平时则保持静默。被提及时，智能体将读取频道中的相关上下文并开始工作。",[586,3909,3910,3913],{},[442,3911,3912],{},"统一身份系统："," 团队成员与 AI 智能体使用同一套身份系统，并通过加密私钥\u002F公钥进行安全认证。",[586,3915,3916,3919],{},[442,3917,3918],{},"委派命令："," 您可以向人类同事授予指挥您的智能体的权限，让整个团队都能轻松指派和调用彼此的数字助手。",[586,3921,3922,3925],{},[442,3923,3924],{},"自托管服务器："," 因为您是该服务器的托管者，所以您的数据完全由您掌控。您可以自由决定谁能加入，并定义专属的运行规则。",[447,3927,3929],{"id":3928},"基于-nostr-的加密级-buzz-架构解析","基于 Nostr 的加密级 Buzz 架构解析",[429,3931,3932],{},[981,3933],{"alt":3934,"src":3935},"基于 Nostr 协议的 Buzz 协作空间加密级架构拓扑图","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-nostr-cryptographic-architecture.webp",[583,3937,3938,3944,3950,3956,3962,3968],{},[586,3939,3940,3943],{},[442,3941,3942],{},"Nostr 中继器充当服务器："," 消息、工作流、代码仓库以及其他事件都经过加密签名和验证，并存储在 Nostr 中继服务器（Relay）上。Nostr 协议原生支持通过 WebSockets 和 REST API 进行通信。",[586,3945,3946,3949],{},[442,3947,3948],{},"统一加密身份："," 人类和智能体都使用各自的加密密钥进行认证。此身份完全保留在客户端，绝不会存储在服务器上。",[586,3951,3952,3955],{},[442,3953,3954],{},"一等公民级智能体："," 每个智能体都拥有独立的身份、频道成员资格和审计跟踪（Audit Trail）。智能体使用智能体通信协议（ACP）连接到工作空间。",[586,3957,3958,3961],{},[442,3959,3960],{},"去中心化 Git 仓库："," 代码库存储在兼容 S3 的对象存储中，而任务、拉取请求（PR）和代码审查则在 Nostr 事件日志中进行追踪。因此，Buzz 的 Git 仓库实际上是托管在 Nostr 中继器上，而非 GitHub。",[586,3963,3964,3967],{},[442,3965,3966],{},"Buzz 客户端属于 Nostr 客户端："," Buzz 应用与 Nostr 中继器是分离的；它是一个桌面或移动端客户端，负责连接到中继器的 URL 节点。",[586,3969,3970,3973],{},[442,3971,3972],{},"基础技术栈："," 由 PostgreSQL 数据库处理事件存储与全文检索，Redis 负责管理发布\u002F订阅（Pub\u002FSub）消息队列，而兼容 S3 的 MinIO 用于存储媒体文件。",[447,3975,3977],{"id":3976},"如何在-linux-vps-上部署自托管的-block-旗下-buzz","如何在 Linux VPS 上部署自托管的 Block 旗下 Buzz",[1186,3979,3981],{"id":3980},"_0-prerequisites","0. Prerequisites",[583,3983,3984,3987,3990,3993],{},[586,3985,3986],{},"一台 Linux VPS",[586,3988,3989],{},"域名已指向您的服务器 IP 地址",[586,3991,3992],{},"Docker 以及 Docker Compose 插件",[586,3994,3995],{},"Cloudflare 账户（免费服务计划）",[429,3997,3998,3999,4001],{},"在本指南中，我们将把 Nostr 中继器部署在 Ubuntu VPS 上，并通过 ",[634,4000,3248],{"href":363}," 保护其安全。整个基础技术栈包含 Docker Compose 中的四个服务：中继器（relay）、PostgreSQL、Redis 和 MinIO，并使用 Caddy 来提供 HTTPS 支持。",[3241,4003],{"description":4004,"image":3244,"image-alt":4005,"label":3246,"min-read":4006,"title":3248,"to":363},"了解如何利用 Cloudflare WARP 和 Zero Trust（零信任）在不开放入站防火墙端口的情况下，安全地在全球范围内暴露和访问您的 Hermes Agent。","使用 Cloudflare Zero Trust 和 WARP 隧道安全地将 Hermes Agent 暴露到私有网络","8",[1186,4008,4010],{"id":4009},"_1-cloudflare-dns-与-api-令牌","1. Cloudflare DNS 与 API 令牌",[1724,4012,4014],{"id":4013},"创建-cloudflare-api-令牌token","创建 Cloudflare API 令牌（Token）",[675,4016,4017,4023],{},[586,4018,4019,4020,711],{},"点击右上角的个人头像，并在下拉菜单中选择 ",[442,4021,4022],{},"Profile",[586,4024,1746,4025,711],{},[442,4026,4027],{},"API Tokens",[429,4029,4030],{},[981,4031],{"alt":4032,"src":4033},"Cloudflare 用户个人资料页面，显示 API 令牌创建菜单","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fcloudflare-profile-api-tokens.webp",[675,4035,4036,4042,4048,4068,4073,4077,4080],{"start":484},[586,4037,1746,4038,4041],{},[442,4039,4040],{},"Create Token"," 按钮。",[586,4043,4044,4045,711],{},"选择使用模板 ",[442,4046,4047],{},"Edit zone DNS",[586,4049,4050,4051],{},"配置模版如下：\n",[583,4052,4053,4059],{},[586,4054,4055,4058],{},[442,4056,4057],{},"Permissions",": Zone — DNS — Edit",[586,4060,4061,4064,4065],{},[442,4062,4063],{},"Zone Resources",": Include — Specific zone — ",[433,4066,4067],{},"example.com",[586,4069,1746,4070,711],{},[442,4071,4072],{},"Continue to summary",[586,4074,1746,4075,711],{},[442,4076,4040],{},[586,4078,4079],{},"拷贝生成的 API 令牌，因为页面关闭后它将不再显示。",[586,4081,4082],{},"在终端中验证生成的令牌，确保其能正常工作：",[455,4084,4086],{"className":457,"code":4085,"language":459,"meta":424,"style":424},"curl \"https:\u002F\u002Fapi.cloudflare.com\u002Fclient\u002Fv4\u002Fuser\u002Ftokens\u002Fverify\" -H \"Authorization: Bearer YOUR_TOKEN_HERE\"\n",[433,4087,4088],{"__ignoreMap":424},[463,4089,4090,4092,4094,4097,4099,4102,4104,4107],{"class":465,"line":466},[463,4091,1949],{"class":494},[463,4093,505],{"class":504},[463,4095,4096],{"class":480},"https:\u002F\u002Fapi.cloudflare.com\u002Fclient\u002Fv4\u002Fuser\u002Ftokens\u002Fverify",[463,4098,512],{"class":504},[463,4100,4101],{"class":480}," -H",[463,4103,505],{"class":504},[463,4105,4106],{"class":480},"Authorization: Bearer YOUR_TOKEN_HERE",[463,4108,551],{"class":504},[1724,4110,4112],{"id":4111},"dns-解析记录","DNS 解析记录",[583,4114,4115],{},[586,4116,4117,4118,4121],{},"创建一条 A 记录，并将代理状态设置为 ",[442,4119,4120],{},"仅限 DNS","（DNS only）。",[429,4123,4124],{},[981,4125],{"alt":4126,"src":4127},"在 Cloudflare 控制台中配置 Buzz 域名的 DNS A 记录，并将代理状态设置为仅限 DNS","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fcloudflare-dns-a-record-configuration.webp",[1186,4129,4131],{"id":4130},"_2-在-ubuntu-上安装-docker","2. 在 Ubuntu 上安装 Docker",[429,4133,4134],{},"运行以下命令在 Ubuntu 上安装 Docker：",[455,4136,4138],{"className":457,"code":4137,"language":459,"meta":424,"style":424},"# Add Docker's official GPG key and set up the Docker repository\ncurl -fsSL https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu\u002Fgpg | sudo gpg --dearmor -o \u002Fusr\u002Fshare\u002Fkeyrings\u002Fdocker-archive-keyring.gpg\n\n# Add the official Docker repository\necho \"deb [arch=amd64 signed-by=\u002Fusr\u002Fshare\u002Fkeyrings\u002Fdocker-archive-keyring.gpg] https:\u002F\u002Fdownload.docker.com\u002Flinux\u002Fubuntu $(lsb_release -cs) stable\" | sudo tee \u002Fetc\u002Fapt\u002Fsources.list.d\u002Fdocker.list > \u002Fdev\u002Fnull\n\n# Update package list\nsudo apt update\n\n# Install Docker Engine, Docker Community Edition, and containerd runtime\nsudo apt install docker-ce docker-ce-cli containerd.io -y\n\n# Start automatically when the system boots\nsudo systemctl enable docker\n\n# Verify docker is installed\ndocker --version\n\nsudo apt install -y docker-compose-plugin\n\n# Verify the compose plugin is installed\ndocker compose version\n\n",[433,4139,4140,4144,4164,4168,4172,4204,4208,4212,4220,4224,4228,4244,4248,4253,4263,4267,4271,4277,4282,4297,4302,4308],{"__ignoreMap":424},[463,4141,4142],{"class":465,"line":466},[463,4143,1944],{"class":469},[463,4145,4146,4148,4150,4152,4154,4156,4158,4160,4162],{"class":465,"line":473},[463,4147,1949],{"class":494},[463,4149,1952],{"class":480},[463,4151,1955],{"class":480},[463,4153,1958],{"class":504},[463,4155,1961],{"class":494},[463,4157,1964],{"class":480},[463,4159,1967],{"class":480},[463,4161,1970],{"class":480},[463,4163,1973],{"class":480},[463,4165,4166],{"class":465,"line":484},[463,4167,488],{"emptyLinePlaceholder":487},[463,4169,4170],{"class":465,"line":491},[463,4171,1982],{"class":469},[463,4173,4174,4176,4178,4180,4182,4184,4186,4188,4190,4192,4194,4196,4198,4200,4202],{"class":465,"line":536},[463,4175,1987],{"class":476},[463,4177,505],{"class":504},[463,4179,1992],{"class":480},[463,4181,1995],{"class":504},[463,4183,1998],{"class":494},[463,4185,2001],{"class":480},[463,4187,2004],{"class":504},[463,4189,2007],{"class":480},[463,4191,512],{"class":504},[463,4193,1958],{"class":504},[463,4195,1961],{"class":494},[463,4197,2016],{"class":480},[463,4199,2019],{"class":480},[463,4201,2022],{"class":504},[463,4203,2025],{"class":480},[463,4205,4206],{"class":465,"line":541},[463,4207,488],{"emptyLinePlaceholder":487},[463,4209,4210],{"class":465,"line":554},[463,4211,2034],{"class":469},[463,4213,4214,4216,4218],{"class":465,"line":559},[463,4215,2039],{"class":494},[463,4217,2042],{"class":480},[463,4219,2045],{"class":480},[463,4221,4222],{"class":465,"line":571},[463,4223,488],{"emptyLinePlaceholder":487},[463,4225,4226],{"class":465,"line":2052},[463,4227,2055],{"class":469},[463,4229,4230,4232,4234,4236,4238,4240,4242],{"class":465,"line":2058},[463,4231,2039],{"class":494},[463,4233,2042],{"class":480},[463,4235,2065],{"class":480},[463,4237,2068],{"class":480},[463,4239,2071],{"class":480},[463,4241,2074],{"class":480},[463,4243,2077],{"class":480},[463,4245,4246],{"class":465,"line":2080},[463,4247,488],{"emptyLinePlaceholder":487},[463,4249,4250],{"class":465,"line":2085},[463,4251,4252],{"class":469},"# Start automatically when the system boots\n",[463,4254,4255,4257,4259,4261],{"class":465,"line":2091},[463,4256,2039],{"class":494},[463,4258,2116],{"class":480},[463,4260,2119],{"class":480},[463,4262,2122],{"class":480},[463,4264,4265],{"class":465,"line":2100},[463,4266,488],{"emptyLinePlaceholder":487},[463,4268,4269],{"class":465,"line":2105},[463,4270,2088],{"class":469},[463,4272,4273,4275],{"class":465,"line":2111},[463,4274,2094],{"class":494},[463,4276,2097],{"class":480},[463,4278,4280],{"class":465,"line":4279},18,[463,4281,488],{"emptyLinePlaceholder":487},[463,4283,4285,4287,4289,4291,4294],{"class":465,"line":4284},19,[463,4286,2039],{"class":494},[463,4288,2042],{"class":480},[463,4290,2065],{"class":480},[463,4292,4293],{"class":480}," -y",[463,4295,4296],{"class":480}," docker-compose-plugin\n",[463,4298,4300],{"class":465,"line":4299},20,[463,4301,488],{"emptyLinePlaceholder":487},[463,4303,4305],{"class":465,"line":4304},21,[463,4306,4307],{"class":469},"# Verify the compose plugin is installed\n",[463,4309,4310,4312,4315],{"class":465,"line":3851},[463,4311,2094],{"class":494},[463,4313,4314],{"class":480}," compose",[463,4316,4317],{"class":480}," version\n",[1186,4319,4321],{"id":4320},"_3-克隆仓库并进行配置","3. 克隆仓库并进行配置",[455,4323,4325],{"className":457,"code":4324,"language":459,"meta":424,"style":424},"git clone https:\u002F\u002Fgithub.com\u002Fblock\u002Fbuzz.git\n\ncd buzz\u002Fdeploy\u002Fcompose\ncp .env.example .env\nnano .env\n",[433,4326,4327,4338,4342,4349,4359],{"__ignoreMap":424},[463,4328,4329,4332,4335],{"class":465,"line":466},[463,4330,4331],{"class":494},"git",[463,4333,4334],{"class":480}," clone",[463,4336,4337],{"class":480}," https:\u002F\u002Fgithub.com\u002Fblock\u002Fbuzz.git\n",[463,4339,4340],{"class":465,"line":473},[463,4341,488],{"emptyLinePlaceholder":487},[463,4343,4344,4346],{"class":465,"line":484},[463,4345,544],{"class":476},[463,4347,4348],{"class":480}," buzz\u002Fdeploy\u002Fcompose\n",[463,4350,4351,4353,4356],{"class":465,"line":491},[463,4352,562],{"class":494},[463,4354,4355],{"class":480}," .env.example",[463,4357,4358],{"class":480}," .env\n",[463,4360,4361,4364],{"class":465,"line":536},[463,4362,4363],{"class":494},"nano",[463,4365,4358],{"class":480},[429,4367,4368,4369,4372],{},"编辑 ",[433,4370,4371],{},".env"," 文件：",[583,4374,4375],{},[586,4376,4377],{},[442,4378,4379],{},"域名配置:",[455,4381,4384],{"className":4382,"code":4383,"language":1634},[1632],"BUZZ_DOMAIN=buzz.pafor.me\nRELAY_URL=wss:\u002F\u002Fbuzz.pafor.me\nBUZZ_PAIRING_RELAY_URL=wss:\u002F\u002Fbuzz.pafor.me\u002Fpair\nBUZZ_MEDIA_BASE_URL=https:\u002F\u002Fbuzz.pafor.me\u002Fmedia\nBUZZ_MEDIA_SERVER_DOMAIN=buzz.pafor.me\nBUZZ_CORS_ORIGINS=https:\u002F\u002Fbuzz.pafor.me\n",[433,4385,4383],{"__ignoreMap":424},[583,4387,4388,4398],{},[586,4389,4390,4393,4394,4397],{},[442,4391,4392],{},"所有者公钥:"," ",[433,4395,4396],{},"RELAY_OWNER_PUBKEY"," 字段需要填入您的 64 位 16 进制公钥。请先在桌面客户端生成一个身份（选择 'Create a new identity key' → 复制以 npub 格式开头的公开 ID），然后将其转换为 16 进制格式。",[586,4399,4400,4403],{},[442,4401,4402],{},"密钥安全（Secrets）:",[583,4404,4405,4415,4429],{},[586,4406,4407,4408,4410,4411,4414],{},"使用该 ",[634,4409,2132],{"href":2131}," 或运行命令 ",[433,4412,4413],{},"openssl rand -hex 32","（运行 7 次）来生成高强度的随机密钥。",[586,4416,4417,4418,4421,4422,745,4425,4428],{},"将所有的 ",[433,4419,4420],{},"CHANGE_ME"," 占位符替换掉：包括 ",[433,4423,4424],{},"BUZZ_RELAY_PRIVATE_KEY",[433,4426,4427],{},"BUZZ_GIT_HOOK_HMAC_SECRET","、Postgres\u002FRedis\u002FTypesense 的密码以及 S3 的 Access\u002FSecret Key。",[586,4430,4431,4432,4435],{},"未替换的占位符是导致容器陷入无限重启循环的最常见原因；请通过命令 ",[433,4433,4434],{},"grep CHANGE_ME .env"," 来核对并排除隐患。",[455,4437,4440],{"className":4438,"code":4439,"language":1634},[1632],"    BUZZ_RELAY_PRIVATE_KEY=CHANGE_ME_64_HEX_PRIVATE_KEY\n    BUZZ_GIT_HOOK_HMAC_SECRET=CHANGE_ME_RANDOM_64_HEX\n    POSTGRES_PASSWORD=CHANGE_ME_RANDOM_PASSWORD\n    REDIS_PASSWORD=CHANGE_ME_RANDOM_PASSWORD\n    TYPESENSE_API_KEY=CHANGE_ME_RANDOM_API_KEY\n    BUZZ_S3_ACCESS_KEY=CHANGE_ME_RANDOM_ACCESS_KEY\n    BUZZ_S3_SECRET_KEY=CHANGE_ME_RANDOM_SECRET_KEY\n",[433,4441,4439],{"__ignoreMap":424},[583,4443,4444],{},[586,4445,4446,4449],{},[442,4447,4448],{},"其他配置项:",[583,4450,4451,4458],{},[586,4452,4453,4454,4457],{},"将环境变量 ",[433,4455,4456],{},"CLOUDFLARE_API_TOKEN"," 添加到您的配置中，并赋予先前生成的 API 令牌值。Caddy 将用其自动申请证书。",[586,4459,4460,4461,4463,4464,436,4467,4470],{},"Buzz 的默认配置非常开放，任何知道您中继器地址的人都可以验证并加入。为了安全起见，请务必配置 ",[433,4462,4396],{},"，并将 ",[433,4465,4466],{},"BUZZ_REQUIRE_RELAY_MEMBERSHIP=true",[433,4468,4469],{},"BUZZ_REQUIRE_AUTH_TOKEN=true"," 设为启用状态。",[1186,4472,4474],{"id":4473},"_4-使用-caddy-开启-https-访问","4. 使用 Caddy 开启 HTTPS 访问",[1724,4476,4478],{"id":4477},"构建集成-cloudflare-dns-模块的自定义-caddy-镜像","构建集成 Cloudflare DNS 模块的自定义 Caddy 镜像",[583,4480,4481,4492,4495],{},[586,4482,4483,4484,4487,4488,4491],{},"我们在 Caddy 中配置基于 Cloudflare 的 DNS-01 挑战（Challenge）。DNS-01 验证的原理是让 Caddy 插件向您的",[442,4485,4486],{},"公网 DNS"," 写入一条 TXT 挑战记录 ",[433,4489,4490],{},"_acme-challenge.buzz.pafor.me","；",[586,4493,4494],{},"随后 Let's Encrypt 从公共互联网上查询该记录，以确权您的域名。这意味着您的域名必须是 Cloudflare 账户中的公网解析区域，而不能只是 Zero Trust \u002F WARP 局域网 DNS 内的私有域名。如果您的域名只在私网下分发解析而没有公网节点，DNS-01 将会失败，需要改用其他验证方式。",[586,4496,4497],{},"将以下配置加入到 Caddyfile 中：",[455,4499,4503],{"className":4500,"code":4501,"language":4502,"meta":424,"style":424},"language-yml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  acme_dns cloudflare {env.CLOUDFLARE_API_TOKEN}\n}\n","yml",[433,4504,4505,4509,4522],{"__ignoreMap":424},[463,4506,4507],{"class":465,"line":466},[463,4508,1325],{"class":504},[463,4510,4511,4514,4517,4520],{"class":465,"line":473},[463,4512,4513],{"class":480},"  acme_dns cloudflare",[463,4515,4516],{"class":504}," {",[463,4518,4519],{"class":480},"env.CLOUDFLARE_API_TOKEN",[463,4521,2350],{"class":504},[463,4523,4524],{"class":465,"line":484},[463,4525,2350],{"class":504},[583,4527,4528],{},[586,4529,4530,4531,4534,4535,4538],{},"创建一个 ",[433,4532,4533],{},"Dockerfile.caddy","，其内容如下，这是 ",[433,4536,4537],{},"compose.caddy.yml"," 运行所必需的：",[455,4540,4542],{"className":4500,"code":4541,"language":4502,"meta":424,"style":424},"FROM caddy:2-builder AS builder\n\nRUN xcaddy build \\\n    --with github.com\u002Fcaddy-dns\u002Fcloudflare\n\nFROM caddy:2-alpine\n\nCOPY --from=builder \u002Fusr\u002Fbin\u002Fcaddy \u002Fusr\u002Fbin\u002Fcaddy\n",[433,4543,4544,4549,4553,4558,4563,4567,4572,4576],{"__ignoreMap":424},[463,4545,4546],{"class":465,"line":466},[463,4547,4548],{"class":480},"FROM caddy:2-builder AS builder\n",[463,4550,4551],{"class":465,"line":473},[463,4552,488],{"emptyLinePlaceholder":487},[463,4554,4555],{"class":465,"line":484},[463,4556,4557],{"class":480},"RUN xcaddy build \\\n",[463,4559,4560],{"class":465,"line":491},[463,4561,4562],{"class":480},"    --with github.com\u002Fcaddy-dns\u002Fcloudflare\n",[463,4564,4565],{"class":465,"line":536},[463,4566,488],{"emptyLinePlaceholder":487},[463,4568,4569],{"class":465,"line":541},[463,4570,4571],{"class":480},"FROM caddy:2-alpine\n",[463,4573,4574],{"class":465,"line":554},[463,4575,488],{"emptyLinePlaceholder":487},[463,4577,4578],{"class":465,"line":559},[463,4579,4580],{"class":480},"COPY --from=builder \u002Fusr\u002Fbin\u002Fcaddy \u002Fusr\u002Fbin\u002Fcaddy\n",[583,4582,4583],{},[586,4584,4585,4586,4588],{},"修改 ",[433,4587,4537],{},"，以使用我们刚生成的带有 Cloudflare 插件的 Caddy 镜像，并传入 API 令牌参数：",[455,4590,4592],{"className":4500,"code":4591,"language":4502,"meta":424,"style":424},"services:\n  relay:\n    ports: !reset []\n\n  caddy:\n    build:\n      context: .\n      dockerfile: Dockerfile.caddy\n    image: buzz-caddy:cloudflare\n    depends_on:\n      relay:\n        condition: service_healthy\n    environment:\n      BUZZ_DOMAIN: ${BUZZ_DOMAIN:?set BUZZ_DOMAIN}\n      CLOUDFLARE_API_TOKEN: ${CLOUDFLARE_API_TOKEN:?set CLOUDFLARE_API_TOKEN}\n    ports:\n      - \"${CADDY_HTTP_PORT:-80}:80\"\n      - \"${CADDY_HTTPS_PORT:-443}:443\"\n    volumes:\n      - .\u002FCaddyfile:\u002Fetc\u002Fcaddy\u002FCaddyfile:ro\n      - buzz-caddy-data:\u002Fdata\n      - buzz-caddy-config:\u002Fconfig\n    restart: unless-stopped\n    networks:\n      - buzz-net\n\nvolumes:\n  buzz-caddy-data:\n    labels:\n      com.buzz.volume: caddy-data\n  buzz-caddy-config:\n    labels:\n      com.buzz.volume: caddy-config\n",[433,4593,4594,4603,4610,4623,4627,4634,4641,4650,4660,4670,4677,4684,4694,4701,4711,4721,4727,4739,4750,4757,4764,4771,4778,4789,4797,4805,4810,4818,4826,4834,4845,4853,4860],{"__ignoreMap":424},[463,4595,4596,4600],{"class":465,"line":466},[463,4597,4599],{"class":4598},"swJcz","services",[463,4601,4602],{"class":504},":\n",[463,4604,4605,4608],{"class":465,"line":473},[463,4606,4607],{"class":4598},"  relay",[463,4609,4602],{"class":504},[463,4611,4612,4615,4617,4620],{"class":465,"line":484},[463,4613,4614],{"class":4598},"    ports",[463,4616,1339],{"class":504},[463,4618,4619],{"class":1333}," !reset",[463,4621,4622],{"class":504}," []\n",[463,4624,4625],{"class":465,"line":491},[463,4626,488],{"emptyLinePlaceholder":487},[463,4628,4629,4632],{"class":465,"line":536},[463,4630,4631],{"class":4598},"  caddy",[463,4633,4602],{"class":504},[463,4635,4636,4639],{"class":465,"line":541},[463,4637,4638],{"class":4598},"    build",[463,4640,4602],{"class":504},[463,4642,4643,4646,4648],{"class":465,"line":554},[463,4644,4645],{"class":4598},"      context",[463,4647,1339],{"class":504},[463,4649,568],{"class":2152},[463,4651,4652,4655,4657],{"class":465,"line":559},[463,4653,4654],{"class":4598},"      dockerfile",[463,4656,1339],{"class":504},[463,4658,4659],{"class":480}," Dockerfile.caddy\n",[463,4661,4662,4665,4667],{"class":465,"line":571},[463,4663,4664],{"class":4598},"    image",[463,4666,1339],{"class":504},[463,4668,4669],{"class":480}," buzz-caddy:cloudflare\n",[463,4671,4672,4675],{"class":465,"line":2052},[463,4673,4674],{"class":4598},"    depends_on",[463,4676,4602],{"class":504},[463,4678,4679,4682],{"class":465,"line":2058},[463,4680,4681],{"class":4598},"      relay",[463,4683,4602],{"class":504},[463,4685,4686,4689,4691],{"class":465,"line":2080},[463,4687,4688],{"class":4598},"        condition",[463,4690,1339],{"class":504},[463,4692,4693],{"class":480}," service_healthy\n",[463,4695,4696,4699],{"class":465,"line":2085},[463,4697,4698],{"class":4598},"    environment",[463,4700,4602],{"class":504},[463,4702,4703,4706,4708],{"class":465,"line":2091},[463,4704,4705],{"class":4598},"      BUZZ_DOMAIN",[463,4707,1339],{"class":504},[463,4709,4710],{"class":480}," ${BUZZ_DOMAIN:?set BUZZ_DOMAIN}\n",[463,4712,4713,4716,4718],{"class":465,"line":2100},[463,4714,4715],{"class":4598},"      CLOUDFLARE_API_TOKEN",[463,4717,1339],{"class":504},[463,4719,4720],{"class":480}," ${CLOUDFLARE_API_TOKEN:?set CLOUDFLARE_API_TOKEN}\n",[463,4722,4723,4725],{"class":465,"line":2105},[463,4724,4614],{"class":4598},[463,4726,4602],{"class":504},[463,4728,4729,4732,4734,4737],{"class":465,"line":2111},[463,4730,4731],{"class":504},"      -",[463,4733,505],{"class":504},[463,4735,4736],{"class":480},"${CADDY_HTTP_PORT:-80}:80",[463,4738,551],{"class":504},[463,4740,4741,4743,4745,4748],{"class":465,"line":4279},[463,4742,4731],{"class":504},[463,4744,505],{"class":504},[463,4746,4747],{"class":480},"${CADDY_HTTPS_PORT:-443}:443",[463,4749,551],{"class":504},[463,4751,4752,4755],{"class":465,"line":4284},[463,4753,4754],{"class":4598},"    volumes",[463,4756,4602],{"class":504},[463,4758,4759,4761],{"class":465,"line":4299},[463,4760,4731],{"class":504},[463,4762,4763],{"class":480}," .\u002FCaddyfile:\u002Fetc\u002Fcaddy\u002FCaddyfile:ro\n",[463,4765,4766,4768],{"class":465,"line":4304},[463,4767,4731],{"class":504},[463,4769,4770],{"class":480}," buzz-caddy-data:\u002Fdata\n",[463,4772,4773,4775],{"class":465,"line":3851},[463,4774,4731],{"class":504},[463,4776,4777],{"class":480}," buzz-caddy-config:\u002Fconfig\n",[463,4779,4781,4784,4786],{"class":465,"line":4780},23,[463,4782,4783],{"class":4598},"    restart",[463,4785,1339],{"class":504},[463,4787,4788],{"class":480}," unless-stopped\n",[463,4790,4792,4795],{"class":465,"line":4791},24,[463,4793,4794],{"class":4598},"    networks",[463,4796,4602],{"class":504},[463,4798,4800,4802],{"class":465,"line":4799},25,[463,4801,4731],{"class":504},[463,4803,4804],{"class":480}," buzz-net\n",[463,4806,4808],{"class":465,"line":4807},26,[463,4809,488],{"emptyLinePlaceholder":487},[463,4811,4813,4816],{"class":465,"line":4812},27,[463,4814,4815],{"class":4598},"volumes",[463,4817,4602],{"class":504},[463,4819,4821,4824],{"class":465,"line":4820},28,[463,4822,4823],{"class":4598},"  buzz-caddy-data",[463,4825,4602],{"class":504},[463,4827,4829,4832],{"class":465,"line":4828},29,[463,4830,4831],{"class":4598},"    labels",[463,4833,4602],{"class":504},[463,4835,4837,4840,4842],{"class":465,"line":4836},30,[463,4838,4839],{"class":4598},"      com.buzz.volume",[463,4841,1339],{"class":504},[463,4843,4844],{"class":480}," caddy-data\n",[463,4846,4848,4851],{"class":465,"line":4847},31,[463,4849,4850],{"class":4598},"  buzz-caddy-config",[463,4852,4602],{"class":504},[463,4854,4856,4858],{"class":465,"line":4855},32,[463,4857,4831],{"class":4598},[463,4859,4602],{"class":504},[463,4861,4863,4865,4867],{"class":465,"line":4862},33,[463,4864,4839],{"class":4598},[463,4866,1339],{"class":504},[463,4868,4869],{"class":480}," caddy-config\n",[1724,4871,4873],{"id":4872},"启动-docker-容器组合","启动 Docker 容器组合",[455,4875,4877],{"className":457,"code":4876,"language":459,"meta":424,"style":424},"docker compose -f compose.yml -f compose.caddy.yml up -d\n\n#Check the Docker status\ndocker compose ps\n",[433,4878,4879,4902,4906,4911],{"__ignoreMap":424},[463,4880,4881,4883,4885,4888,4891,4893,4896,4899],{"class":465,"line":466},[463,4882,2094],{"class":494},[463,4884,4314],{"class":480},[463,4886,4887],{"class":480}," -f",[463,4889,4890],{"class":480}," compose.yml",[463,4892,4887],{"class":480},[463,4894,4895],{"class":480}," compose.caddy.yml",[463,4897,4898],{"class":480}," up",[463,4900,4901],{"class":480}," -d\n",[463,4903,4904],{"class":465,"line":473},[463,4905,488],{"emptyLinePlaceholder":487},[463,4907,4908],{"class":465,"line":484},[463,4909,4910],{"class":469},"#Check the Docker status\n",[463,4912,4913,4915,4917],{"class":465,"line":491},[463,4914,2094],{"class":494},[463,4916,4314],{"class":480},[463,4918,2298],{"class":480},[981,4920],{"src":4921,"alt":4922,"style":4923},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fdocker-compose-ps-status-terminal.webp","终端窗口显示通过 docker compose ps 运行的 Buzz 服务容器状态","max-width: 700px; width: 100%; height: auto;",[429,4925,4926,4927,4930],{},"打开您的网页浏览器并访问 ",[433,4928,4929],{},"http:\u002F\u002Fbuzz.pafor.me","，验证中继服务是否已顺利跑起来。",[981,4932],{"src":4933,"alt":4934,"style":4935},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-relay-running-browser-verification.webp","浏览器验证页面，显示自托管 Block's Buzz 中继服务器的成功运行响应","max-width: 500px; width: 100%; height: auto;",[1186,4937,4939],{"id":4938},"步骤-5建立起首日备份机制","步骤 5：建立起首日备份机制",[455,4941,4943],{"className":457,"code":4942,"language":459,"meta":424,"style":424},"mkdir -p \u002Fbuzz_backups\ncrontab -e\n",[433,4944,4945,4956],{"__ignoreMap":424},[463,4946,4947,4950,4953],{"class":465,"line":466},[463,4948,4949],{"class":494},"mkdir",[463,4951,4952],{"class":480}," -p",[463,4954,4955],{"class":480}," \u002Fbuzz_backups\n",[463,4957,4958,4961],{"class":465,"line":473},[463,4959,4960],{"class":494},"crontab",[463,4962,481],{"class":480},[429,4964,4965],{},"添加一个每日凌晨自动执行的数据库快照定时任务（Cron Job）：",[455,4967,4970],{"className":4968,"code":4969,"language":1634},[1632],"0 3 * * * cd \u002Fhome\u002F\u003Cuser>\u002Fbuzz\u002Fdeploy\u002Fcompose && docker compose exec -T postgres pg_dump -U buzz buzz > \u002Fbuzz_backups\u002Fbuzz-$(date +\\%Y\\%m\\%d).sql\n",[433,4971,4969],{"__ignoreMap":424},[429,4973,4974,4975,4977],{},"注意：请将 ",[433,4976,4424],{}," 视为永久不可失配的密钥。由于中继器中的事件都与此密钥绑定，如果未来变更了私钥，旧事件将无法通过验证；即便您恢复了数据库备份，在新私钥下它也不会被 Nostr 网络视为同一个中继服务。",[447,4979,4981],{"id":4980},"配置-buzz-桌面客户端与-nostr-加密身份","配置 Buzz 桌面客户端与 Nostr 加密身份",[429,4983,4984,4985,4989],{},"从 ",[634,4986,4987],{"href":4987,"rel":4988},"https:\u002F\u002Fgithub.com\u002Fblock\u002Fbuzz\u002Freleases",[669]," 下载最新版 Buzz 桌面客户端并运行。依次完善个人资料，直到您来到 “Join or create a community” 界面。",[429,4991,4992],{},[981,4993],{"alt":4994,"src":4995},"Buzz 桌面客户端初始设置界面，用于加入或创建社区","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-setup-community.webp",[429,4997,4998],{},"点击 “Join a community” 并拷贝您的公钥（Public Key）。",[429,5000,5001],{},[981,5002],{"alt":5003,"src":5004},"Buzz 客户端界面显示加入社区前的公钥数字身份","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-join-community-public-key.webp",[429,5006,1194,5007,5010],{},[442,5008,5009],{},"VPS 上","运行以下命令行工具，将您自己添加为该平台的首位会员：",[455,5012,5014],{"className":457,"code":5013,"language":459,"meta":424,"style":424},"docker compose exec relay buzz-admin add-member --pubkey npub1yourkeyhere\n",[433,5015,5016],{"__ignoreMap":424},[463,5017,5018,5020,5022,5024,5027,5030,5033,5036],{"class":465,"line":466},[463,5019,2094],{"class":494},[463,5021,4314],{"class":480},[463,5023,2405],{"class":480},[463,5025,5026],{"class":480}," relay",[463,5028,5029],{"class":480}," buzz-admin",[463,5031,5032],{"class":480}," add-member",[463,5034,5035],{"class":480}," --pubkey",[463,5037,5038],{"class":480}," npub1yourkeyhere\n",[429,5040,5041,5042,5045],{},"在客户端中填入 ",[433,5043,5044],{},"wss:\u002F\u002Fbuzz.pafor.me"," 作为社区接入 URL，然后点击 “Next”。",[429,5047,5048],{},[981,5049],{"alt":5050,"src":5051},"在 Buzz 桌面客户端中输入自托管社区中继服务器的 URL 地址","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-input-community-url.webp",[429,5053,5054],{},"起一个帅气的昵称，然后点击 “Next” 按钮。",[429,5056,5057],{},[981,5058],{"alt":5059,"src":5060},"Buzz 客户端个人资料配置界面，用于输入用户昵称","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-profile-name-input.webp",[1186,5062,5064],{"id":5063},"协作频道与-ai-智能体","协作频道与 AI 智能体",[429,5066,5067],{},"频道是围绕特定任务或项目划分的群组。为您手头的每个任务或工程建立独立的频道，并将团队成员与所需的 AI 智能体拉入其中。",[429,5069,5070],{},"频道内的所有消息、代码与文档都会被自动分享，免去了逐一向新成员同步前因后果的烦恼。任何人都可以通过“@”来点名激活特定的 AI 智能体，智能体收到召唤后会读取相关历史消息并立刻着手处理。更妙的是，不同的 AI 智能体之间也能互相 @ 指派任务。",[429,5072,5073],{},"让我们试着给预置的智能体发一条私信（DM）",[429,5075,5076],{},[981,5077],{"alt":5078,"src":5079},"在 Buzz 协同桌面客户端中给 AI 智能体发送私信（DM）","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-dm-agent.webp",[429,5081,5082],{},"创建一个新频道并拉几个 AI 智能体进来吧",[429,5084,5085],{},[981,5086],{"alt":5087,"src":5088},"在 Buzz 桌面客户端中创建新的任务或项目协作频道","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-create-channel-dialog.webp",[429,5090,5091],{},[981,5092],{"alt":5093,"src":5094},"将团队成员和 AI 智能体添加至新创建的协作频道中","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-add-agents-to-channel.webp",[429,5096,5097],{},[981,5098],{"alt":5099,"src":5100},"活跃协作频道视图，展示合并后的聊天历史和项目任务","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-channel-view.webp",[981,5102],{"src":5103,"alt":5104,"style":5105},"https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-channel-active-agents.webp","已集成到协同项目频道中的活跃 AI 智能体列表细节视图","max-width: 367px; width: 100%; height: auto;",[1186,5107,5109],{"id":5108},"激活智能体运行时agent-runtimes","激活智能体运行时（Agent Runtimes）",[429,5111,5112,5113,5116,5117,5120],{},"平台自带的运行时预设依赖于“自动探测”来查找特定系统目录（例如 ",[433,5114,5115],{},"~\u002F.local\u002Fbin","）下的执行程序（如 ",[433,5118,5119],{},"hermes-acp","）。如果您的智能体软件安装在非标准路径下，Buzz 将无法正确识别。",[429,5122,5123,5124,5127],{},"以 Kimi Code 为例，它的智能体 ID 为 kimi，Buzz 默认会在 ",[433,5125,5126],{},"~\u002F.local\u002Fbin\u002Fkimi"," 寻找它。通过创建一个软链接（Symbolic Link）即可轻松搞定：",[455,5129,5132],{"className":5130,"code":5131,"language":1634},[1632],"ln -s kimi-cli \u002FUsers\u002F\u003Cuser>\u002F.local\u002Fbin\u002Fkimi\n",[433,5133,5131],{"__ignoreMap":424},[429,5135,5136],{},"此时，Kimi Code 就会显示在“Agent runtimes”列表中。",[429,5138,5139],{},[981,5140],{"alt":5141,"src":5142},"Buzz 客户端设置界面，显示已配置的 AI 智能体运行时列表（包括 Kimi）","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-settings-agent-runtimes-list.webp",[1186,5144,5145],{"id":5145},"项目与代码仓库管理",[429,5147,5148,5149,5152],{},"请先在 Settings → Experiments 菜单中激活“",[442,5150,5151],{},"Projects","”实验性功能：",[429,5154,5155],{},[981,5156],{"alt":5157,"src":5158},"在 Buzz 客户端设置的 Experiments 标签页中激活实验性 Projects 功能","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-settings-experiments-projects.webp",[429,5160,5161,5162,5165],{},"目前，一个项目（Project）必须使用 ",[433,5163,5164],{},"buzz-cli"," 命令行工具来创建（虽然在后续版本中会加入 UI 直接创建的支持）。",[1724,5167,5169],{"id":5168},"在-vps-上安装并部署-buzz-cli","在 VPS 上安装并部署 buzz-cli",[429,5171,1194,5172,5174,5175,5177],{},[442,5173,5009],{},"依次执行以下命令，编译并安装好 ",[433,5176,5164],{}," 客户端：",[455,5179,5181],{"className":457,"code":5180,"language":459,"meta":424,"style":424},"sudo apt install cargo\ncd ~\u002Fbuzz\ncargo install --path crates\u002Fbuzz-cli\necho 'export PATH=\"$HOME\u002F.cargo\u002Fbin:$PATH\"' >> ~\u002F.bashrc && source ~\u002F.bashrc\n",[433,5182,5183,5194,5201,5214],{"__ignoreMap":424},[463,5184,5185,5187,5189,5191],{"class":465,"line":466},[463,5186,2039],{"class":494},[463,5188,2042],{"class":480},[463,5190,2065],{"class":480},[463,5192,5193],{"class":480}," cargo\n",[463,5195,5196,5198],{"class":465,"line":473},[463,5197,544],{"class":476},[463,5199,5200],{"class":480}," ~\u002Fbuzz\n",[463,5202,5203,5206,5208,5211],{"class":465,"line":484},[463,5204,5205],{"class":494},"cargo",[463,5207,2065],{"class":480},[463,5209,5210],{"class":480}," --path",[463,5212,5213],{"class":480}," crates\u002Fbuzz-cli\n",[463,5215,5216,5218,5221,5224,5226,5229,5232,5235,5238],{"class":465,"line":491},[463,5217,1987],{"class":476},[463,5219,5220],{"class":504}," '",[463,5222,5223],{"class":480},"export PATH=\"$HOME\u002F.cargo\u002Fbin:$PATH\"",[463,5225,2422],{"class":504},[463,5227,5228],{"class":504}," >>",[463,5230,5231],{"class":480}," ~\u002F.bashrc",[463,5233,5234],{"class":504}," &&",[463,5236,5237],{"class":476}," source",[463,5239,5240],{"class":480}," ~\u002F.bashrc\n",[429,5242,5243,5244,5246,5247,5249],{},"使用在线工具或通过 ",[433,5245,5164],{}," 生成一对 Nostr 加密公私钥。这组密钥将代表该 ",[433,5248,5164],{}," 工具在 Nostr 网络中的数字身份。",[455,5251,5253],{"className":457,"code":5252,"language":459,"meta":424,"style":424},"docker run --rm --entrypoint \u002Fusr\u002Flocal\u002Fbin\u002Fbuzz-admin ghcr.io\u002Fblock\u002Fbuzz:main generate-key\n\n# Use the generated Public Key\ndocker compose exec relay buzz-admin add-member --pubkey generated_Public_key\n",[433,5254,5255,5276,5280,5285],{"__ignoreMap":424},[463,5256,5257,5259,5261,5264,5267,5270,5273],{"class":465,"line":466},[463,5258,2094],{"class":494},[463,5260,2171],{"class":480},[463,5262,5263],{"class":480}," --rm",[463,5265,5266],{"class":480}," --entrypoint",[463,5268,5269],{"class":480}," \u002Fusr\u002Flocal\u002Fbin\u002Fbuzz-admin",[463,5271,5272],{"class":480}," ghcr.io\u002Fblock\u002Fbuzz:main",[463,5274,5275],{"class":480}," generate-key\n",[463,5277,5278],{"class":465,"line":473},[463,5279,488],{"emptyLinePlaceholder":487},[463,5281,5282],{"class":465,"line":484},[463,5283,5284],{"class":469},"# Use the generated Public Key\n",[463,5286,5287,5289,5291,5293,5295,5297,5299,5301],{"class":465,"line":491},[463,5288,2094],{"class":494},[463,5290,4314],{"class":480},[463,5292,2405],{"class":480},[463,5294,5026],{"class":480},[463,5296,5029],{"class":480},[463,5298,5032],{"class":480},[463,5300,5035],{"class":480},[463,5302,5303],{"class":480}," generated_Public_key\n",[429,5305,5306],{},"配置您的 CLI 环境变量：",[455,5308,5310],{"className":457,"code":5309,"language":459,"meta":424,"style":424},"# Copy the Secret key as the BUZZ_PRIVATE_KEY\necho 'export BUZZ_PRIVATE_KEY=\"nsec1...\"'  >> \u002Fhome\u002F\u003Cuser>\u002F.bashrc\n\necho 'export BUZZ_RELAY_URL=\"wss:\u002F\u002Fbuzz.pafor.me\"'  >> \u002Fhome\u002F\u003Cuser>\u002F.bashrc\n",[433,5311,5312,5317,5347,5351],{"__ignoreMap":424},[463,5313,5314],{"class":465,"line":466},[463,5315,5316],{"class":469},"# Copy the Secret key as the BUZZ_PRIVATE_KEY\n",[463,5318,5319,5321,5323,5326,5328,5331,5334,5336,5339,5342,5344],{"class":465,"line":473},[463,5320,1987],{"class":476},[463,5322,5220],{"class":504},[463,5324,5325],{"class":480},"export BUZZ_PRIVATE_KEY=\"nsec1...\"",[463,5327,2422],{"class":504},[463,5329,5330],{"class":504},"  >>",[463,5332,5333],{"class":480}," \u002Fhome\u002F",[463,5335,1467],{"class":504},[463,5337,5338],{"class":480},"use",[463,5340,5341],{"class":1321},"r",[463,5343,1476],{"class":504},[463,5345,5346],{"class":480},"\u002F.bashrc\n",[463,5348,5349],{"class":465,"line":484},[463,5350,488],{"emptyLinePlaceholder":487},[463,5352,5353,5355,5357,5360,5362,5364,5366,5368,5370,5372,5374],{"class":465,"line":491},[463,5354,1987],{"class":476},[463,5356,5220],{"class":504},[463,5358,5359],{"class":480},"export BUZZ_RELAY_URL=\"wss:\u002F\u002Fbuzz.pafor.me\"",[463,5361,2422],{"class":504},[463,5363,5330],{"class":504},[463,5365,5333],{"class":480},[463,5367,1467],{"class":504},[463,5369,5338],{"class":480},[463,5371,5341],{"class":1321},[463,5373,1476],{"class":504},[463,5375,5346],{"class":480},[429,5377,5378,5379,5381],{},"运行以下命令来测试 ",[433,5380,5164],{}," 是否已经与您的中继器配对畅通：",[455,5383,5385],{"className":457,"code":5384,"language":459,"meta":424,"style":424},"buzz channels list\n",[433,5386,5387],{"__ignoreMap":424},[463,5388,5389,5392,5395],{"class":465,"line":466},[463,5390,5391],{"class":494},"buzz",[463,5393,5394],{"class":480}," channels",[463,5396,5397],{"class":480}," list\n",[429,5399,5400],{},[981,5401],{"alt":5402,"src":5403},"终端命令行运行验证，通过列出活跃频道来检查 buzz-cli 配置是否正确","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-cli-channels-list-terminal.webp",[1724,5405,5407],{"id":5406},"使用-buzz-cli-创建全新的项目","使用 buzz-cli 创建全新的项目",[455,5409,5411],{"className":457,"code":5410,"language":459,"meta":424,"style":424},"# --channel refers to the UUID of the channel\nbuzz repos create --id TestKOA --name 'Display Name' --channel \"bd92b3d1-8fac-441c-a9ac-2b2f3aac5c5b\"\n",[433,5412,5413,5418],{"__ignoreMap":424},[463,5414,5415],{"class":465,"line":466},[463,5416,5417],{"class":469},"# --channel refers to the UUID of the channel\n",[463,5419,5420,5422,5425,5428,5431,5434,5437,5439,5442,5444,5447,5449,5452],{"class":465,"line":473},[463,5421,5391],{"class":494},[463,5423,5424],{"class":480}," repos",[463,5426,5427],{"class":480}," create",[463,5429,5430],{"class":480}," --id",[463,5432,5433],{"class":480}," TestKOA",[463,5435,5436],{"class":480}," --name",[463,5438,5220],{"class":504},[463,5440,5441],{"class":480},"Display Name",[463,5443,2422],{"class":504},[463,5445,5446],{"class":480}," --channel",[463,5448,505],{"class":504},[463,5450,5451],{"class":480},"bd92b3d1-8fac-441c-a9ac-2b2f3aac5c5b",[463,5453,551],{"class":504},[429,5455,5456,5457,5459],{},"项目的所有权极为严格，只有创建者才有权将其删除。由于该“Display Name”项目是由 ",[433,5458,5164],{}," 发起创建的，而目前的命令行版本尚未内置删除指令，因此该项目无法通过常规方式清空。",[429,5461,5462],{},"再次点开您的桌面客户端，验证该项目是否已显示在工作区中。",[429,5464,5465],{},[981,5466],{"alt":5467,"src":5468},"Buzz 桌面客户端项目视图页面，确认项目已成功创建","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-project-view.webp",[429,5470,5471],{},"一旦项目列表在界面中开启，后续您便可以直接通过右上角的 “+” 按钮随心所欲地添加更多子项目了。",[429,5473,5474],{},[981,5475],{"alt":5476,"src":5477},"在 Buzz 桌面客户端中点击右上角加号按钮来添加新项目","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-add-project-button.webp",[1724,5479,5481],{"id":5480},"拉入现有的-git-代码仓库","拉入现有的 Git 代码仓库",[429,5483,5484,5485,5488,5489,5492,5493,5498],{},"在您的本地开发机器上安装 ",[433,5486,5487],{},"git-credential-nostr"," 凭证辅助工具。这需要您的系统已安装 ",[442,5490,5491],{},"Git 2.46+"," 版本并配有 Rust 构建环境。详情可参考此项目的 ",[634,5494,5497],{"href":5495,"rel":5496},"https:\u002F\u002Fgithub.com\u002Fblock\u002Fbuzz\u002Ftree\u002Fmain\u002Fcrates\u002Fgit-credential-nostr",[669],"Readme"," 描述：",[455,5500,5502],{"className":457,"code":5501,"language":459,"meta":424,"style":424},"cargo install --path crates\u002Fgit-credential-nostr\n",[433,5503,5504],{"__ignoreMap":424},[463,5505,5506,5508,5510,5512],{"class":465,"line":466},[463,5507,5205],{"class":494},[463,5509,2065],{"class":480},[463,5511,5210],{"class":480},[463,5513,5514],{"class":480}," crates\u002Fgit-credential-nostr\n",[429,5516,5517,5518,5520],{},"对 ",[433,5519,5487],{}," 进行配置，使其获得 Buzz 中继器的授权权限：",[455,5522,5524],{"className":457,"code":5523,"language":459,"meta":424,"style":424},"# 1. Register the helper and enable per-path credentials.\ngit config --global credential.helper nostr\ngit config --global credential.useHttpPath true\n\n# 2. Store your nsec in a key file (must be 0600). Replace \"nsec1...\" with your private key\nmkdir -p ~\u002F.nostr\necho \"nsec1...\" > ~\u002F.nostr\u002Fkey && chmod 600 ~\u002F.nostr\u002Fkey\ngit config --global nostr.keyfile ~\u002F.nostr\u002Fkey\n",[433,5525,5526,5531,5547,5560,5564,5569,5578,5605],{"__ignoreMap":424},[463,5527,5528],{"class":465,"line":466},[463,5529,5530],{"class":469},"# 1. Register the helper and enable per-path credentials.\n",[463,5532,5533,5535,5538,5541,5544],{"class":465,"line":473},[463,5534,4331],{"class":494},[463,5536,5537],{"class":480}," config",[463,5539,5540],{"class":480}," --global",[463,5542,5543],{"class":480}," credential.helper",[463,5545,5546],{"class":480}," nostr\n",[463,5548,5549,5551,5553,5555,5558],{"class":465,"line":484},[463,5550,4331],{"class":494},[463,5552,5537],{"class":480},[463,5554,5540],{"class":480},[463,5556,5557],{"class":480}," credential.useHttpPath",[463,5559,1577],{"class":504},[463,5561,5562],{"class":465,"line":491},[463,5563,488],{"emptyLinePlaceholder":487},[463,5565,5566],{"class":465,"line":536},[463,5567,5568],{"class":469},"# 2. Store your nsec in a key file (must be 0600). Replace \"nsec1...\" with your private key\n",[463,5570,5571,5573,5575],{"class":465,"line":541},[463,5572,4949],{"class":494},[463,5574,4952],{"class":480},[463,5576,5577],{"class":480}," ~\u002F.nostr\n",[463,5579,5580,5582,5584,5587,5589,5591,5594,5596,5599,5602],{"class":465,"line":554},[463,5581,1987],{"class":476},[463,5583,505],{"class":504},[463,5585,5586],{"class":480},"nsec1...",[463,5588,512],{"class":504},[463,5590,2022],{"class":504},[463,5592,5593],{"class":480}," ~\u002F.nostr\u002Fkey",[463,5595,5234],{"class":504},[463,5597,5598],{"class":494}," chmod",[463,5600,5601],{"class":2152}," 600",[463,5603,5604],{"class":480}," ~\u002F.nostr\u002Fkey\n",[463,5606,5607,5609,5611,5613,5616],{"class":465,"line":559},[463,5608,4331],{"class":494},[463,5610,5537],{"class":480},[463,5612,5540],{"class":480},[463,5614,5615],{"class":480}," nostr.keyfile",[463,5617,5604],{"class":480},[429,5619,5620],{},"在 Buzz 中继上开辟出该 Git 库的存储节点：",[455,5622,5625],{"className":5623,"code":5624,"language":1634},[1632],"buzz repos create --id koa-email-routing --name \"KOA Email Routing\" --clone \"https:\u002F\u002Fbuzz.pafor.me\u002Fgit\u002F\u003Cpub_key>\u002Fkoa-email-routing\" --nostr-relay \"wss:\u002F\u002Fbuzz.pafor.me\"\n",[433,5626,5624],{"__ignoreMap":424},[429,5628,5629,5630,5633,5634,5637],{},"在第一次执行 ",[433,5631,5632],{},"git push"," 时，您可能会被拦截并报错 ",[433,5635,5636],{},"remote: missing Authorization header","。这是由于 Git 写入控制（ACL）是由频道成员资格决定的，您必须先将该仓库 ID 与一个具体的 Buzz 频道进行绑定，从而授权合规写入：",[455,5639,5641],{"className":457,"code":5640,"language":459,"meta":424,"style":424},"buzz repos bind --id koa-email-routing --channel \u003CCHANNEL_UUID>\n\n# push the code again\ngit push\n",[433,5642,5643,5671,5675,5680],{"__ignoreMap":424},[463,5644,5645,5647,5649,5652,5654,5657,5659,5662,5665,5668],{"class":465,"line":466},[463,5646,5391],{"class":494},[463,5648,5424],{"class":480},[463,5650,5651],{"class":480}," bind",[463,5653,5430],{"class":480},[463,5655,5656],{"class":480}," koa-email-routing",[463,5658,5446],{"class":480},[463,5660,5661],{"class":504}," \u003C",[463,5663,5664],{"class":480},"CHANNEL_UUI",[463,5666,5667],{"class":1321},"D",[463,5669,5670],{"class":504},">\n",[463,5672,5673],{"class":465,"line":473},[463,5674,488],{"emptyLinePlaceholder":487},[463,5676,5677],{"class":465,"line":484},[463,5678,5679],{"class":469},"# push the code again\n",[463,5681,5682,5684],{"class":465,"line":491},[463,5683,4331],{"class":494},[463,5685,5686],{"class":480}," push\n",[429,5688,5689,5690,5692],{},"在某些情况下，在 Buzz 桌面版中查阅项目进度时会遇到类似下方的 Git 模块拉取失败提示。这是由于该桌面应用要求系统必须搭载 ",[442,5691,5491],{}," 版本，而应用直接启动时可能默认寻址到了系统中的旧版 Git 引擎：",[429,5694,5695],{},[981,5696],{"alt":5697,"src":5698},"Buzz 客户端展示由于本地 Git 版本低于 2.46 导致的 Git 库加载失败报错界面","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-git-version-error.webp",[429,5700,5701,5702,5705,5706,5711],{},"请在您的 shell 配置文件中通过执行 ",[433,5703,5704],{},"launchctl setenv PATH \"\u002Fopt\u002Fhomebrew\u002Fbin:\u002Fusr\u002Flocal\u002Fbin:\u002Fusr\u002Fbin:\u002Fbin:\u002Fusr\u002Fsbin:\u002Fsbin\""," 声明新版 Git 所在的 PATH，并直接在终端中拉起 Buzz 应用。对此可参考该 ",[634,5707,5710],{"href":5708,"rel":5709},"https:\u002F\u002Fgithub.com\u002Fblock\u002Fbuzz\u002Fissues\u002F5348",[669],"Issue"," 的详细排查记录。",[455,5713,5715],{"className":457,"code":5714,"language":459,"meta":424,"style":424},"open -a Buzz\n",[433,5716,5717],{"__ignoreMap":424},[463,5718,5719,5722,5725],{"class":465,"line":466},[463,5720,5721],{"class":494},"open",[463,5723,5724],{"class":480}," -a",[463,5726,5727],{"class":480}," Buzz\n",[429,5729,5730],{},"重新进入客户端中的 Projects 标签页，您会惊喜地发现代码库的所有提交与详情已经完美加载出来了。",[429,5732,5733],{},[981,5734],{"alt":5735,"src":5736},"代码库提交详情成功加载后的 Buzz 桌面客户端项目面板","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-repository-details-loaded.webp",[447,5738,5740],{"id":5739},"利用二维码将-ai-助手同步至手机端-buzz-app","利用二维码将 AI 助手同步至手机端 Buzz App",[429,5742,5743,5744,5747],{},"Buzz 手机端的“扫码配对”只认 HTTPS 协议，且 VPS 上的中继服务默认并不会在后台运行 ",[433,5745,5746],{},"buzz-pair-relay"," 组件。",[455,5749,5751],{"className":457,"code":5750,"language":459,"meta":424,"style":424},"cd ~\u002Fbuzz\ncargo install --path crates\u002Fbuzz-pair-relay\n",[433,5752,5753,5759],{"__ignoreMap":424},[463,5754,5755,5757],{"class":465,"line":466},[463,5756,544],{"class":476},[463,5758,5200],{"class":480},[463,5760,5761,5763,5765,5767],{"class":465,"line":473},[463,5762,5205],{"class":494},[463,5764,2065],{"class":480},[463,5766,5210],{"class":480},[463,5768,5769],{"class":480}," crates\u002Fbuzz-pair-relay\n",[429,5771,5772,5773,5776,5777,5779],{},"将以下配置注入到您的 ",[433,5774,5775],{},"compose.yml"," 文件中，声明并启动 ",[433,5778,5746],{}," 容器进程：",[455,5781,5783],{"className":4500,"code":5782,"language":4502,"meta":424,"style":424},"  pair:\n    image: ${BUZZ_IMAGE:-ghcr.io\u002Fblock\u002Fbuzz:main}\n    entrypoint: [\"\u002Fusr\u002Flocal\u002Fbin\u002Fbuzz-pair-relay\"]\n    environment:\n      BUZZ_PAIR_RELAY_BIND_ADDR: 0.0.0.0:5000\n    ports:\n      - \"${BUZZ_PAIR_RELAY_PORT:-5000}:5000\"\n    restart: unless-stopped\n    networks:\n      [buzz-net]\n",[433,5784,5785,5792,5801,5821,5827,5837,5843,5854,5862,5868],{"__ignoreMap":424},[463,5786,5787,5790],{"class":465,"line":466},[463,5788,5789],{"class":4598},"  pair",[463,5791,4602],{"class":504},[463,5793,5794,5796,5798],{"class":465,"line":473},[463,5795,4664],{"class":4598},[463,5797,1339],{"class":504},[463,5799,5800],{"class":480}," ${BUZZ_IMAGE:-ghcr.io\u002Fblock\u002Fbuzz:main}\n",[463,5802,5803,5806,5808,5811,5813,5816,5818],{"class":465,"line":484},[463,5804,5805],{"class":4598},"    entrypoint",[463,5807,1339],{"class":504},[463,5809,5810],{"class":504}," [",[463,5812,512],{"class":504},[463,5814,5815],{"class":480},"\u002Fusr\u002Flocal\u002Fbin\u002Fbuzz-pair-relay",[463,5817,512],{"class":504},[463,5819,5820],{"class":504},"]\n",[463,5822,5823,5825],{"class":465,"line":491},[463,5824,4698],{"class":4598},[463,5826,4602],{"class":504},[463,5828,5829,5832,5834],{"class":465,"line":536},[463,5830,5831],{"class":4598},"      BUZZ_PAIR_RELAY_BIND_ADDR",[463,5833,1339],{"class":504},[463,5835,5836],{"class":480}," 0.0.0.0:5000\n",[463,5838,5839,5841],{"class":465,"line":541},[463,5840,4614],{"class":4598},[463,5842,4602],{"class":504},[463,5844,5845,5847,5849,5852],{"class":465,"line":554},[463,5846,4731],{"class":504},[463,5848,505],{"class":504},[463,5850,5851],{"class":480},"${BUZZ_PAIR_RELAY_PORT:-5000}:5000",[463,5853,551],{"class":504},[463,5855,5856,5858,5860],{"class":465,"line":559},[463,5857,4783],{"class":4598},[463,5859,1339],{"class":504},[463,5861,4788],{"class":480},[463,5863,5864,5866],{"class":465,"line":571},[463,5865,4794],{"class":4598},[463,5867,4602],{"class":504},[463,5869,5870,5873,5876],{"class":465,"line":2052},[463,5871,5872],{"class":504},"      [",[463,5874,5875],{"class":480},"buzz-net",[463,5877,5820],{"class":504},[429,5879,5880,5881,5883,5884,5887],{},"在您的 ",[433,5882,4371],{}," 中声明 ",[433,5885,5886],{},"BUZZ_PAIRING_RELAY_URL"," 及其专用的运行端口号：",[455,5889,5892],{"className":5890,"code":5891,"language":1634},[1632],"BUZZ_PAIRING_RELAY_URL=wss:\u002F\u002Fbuzz.pafor.me\u002Fpair\nBUZZ_PAIR_RELAY_PORT=5000\n",[433,5893,5891],{"__ignoreMap":424},[429,5895,5896,5897,5900],{},"点击桌面端应用中的 Settings, 进入 “",[442,5898,5899],{},"Mobile","” 配对项：",[429,5902,5903],{},[981,5904],{"alt":5905,"src":5906},"Buzz 桌面客户端设置中展示的 Mobile 移动端配对配置标签页","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-settings-mobile-tab.webp",[429,5908,5909],{},"点击 “Start pairing” —— 界面会生成专属的绑定二维码；打开手机端 App 扫一扫，接着在桌面端点击 “Code Match” 确认无误，双端便立即完成信任绑定。",[429,5911,5912],{},[981,5913],{"alt":5914,"src":5915},"在桌面客户端中生成安全的配对二维码，用于同步 Buzz 手机端 App","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-desktop-client-pairing-qr-code.webp",[429,5917,5918],{},"注意：手机端应用中的智能体之所以能随叫随到，是基于您的桌面端应用在后台持续维系运行。只有保障桌面机处于在线状态，手机端派发的智能体指令才能被顺利分发与执行。",[429,5920,5921],{},[981,5922],{"alt":5923,"src":5924},"在手机端 Buzz App 中成功加载同步后的活跃 AI 智能体列表","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002Fbuzz-mobile-app-active-agents.webp",[447,5926,5927],{"id":5927},"结语",[429,5929,5930],{},"不可否认，作为一个还处于发展初期的技术方案，Buzz 在面对大规模生产环境时依然稍显稚嫩，伴随着一些偶发的系统 Bug 与界面交互上的限制。但对于小型团队或单兵作战的独立开发者而言，这无疑是一场令人血脉偾张的前沿探索。它为我们揭开了一幅波澜壮阔的人机无缝协奏画卷，让我们提前触碰到了“AI 智能体成为工作伙伴”的未来工作模式。",[447,5932,5933],{"id":5933},"参考资源",[583,5935,5936,5943,5950,5957],{},[586,5937,5938],{},[634,5939,5942],{"href":5940,"rel":5941},"https:\u002F\u002Fgithub.com\u002Fblock\u002Fbuzz",[669],"Buzz releases",[586,5944,5945],{},[634,5946,5949],{"href":5947,"rel":5948},"https:\u002F\u002Fblock.xyz\u002Finside\u002Fintroducing-buzz-where-humans-and-agents-work-together",[669],"Introducing Buzz",[586,5951,5952],{},[634,5953,5956],{"href":5954,"rel":5955},"https:\u002F\u002Fwww.hostinger.com\u002Ftutorials\u002Fwhat-is-buzz",[669],"What is buzz",[586,5958,5959],{},[634,5960,5963],{"href":5961,"rel":5962},"https:\u002F\u002Fmiget.com\u002Fblog\u002Fhow-to-self-host-buzz",[669],"How to self-host Buzz (Miget)",[1038,5965,5966],{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":424,"searchDepth":473,"depth":484,"links":5968},[5969,5970,5971,5985,5994,5995,5996],{"id":3883,"depth":473,"text":3884},{"id":3928,"depth":473,"text":3929},{"id":3976,"depth":473,"text":3977,"children":5972},[5973,5974,5978,5979,5980,5984],{"id":3980,"depth":484,"text":3981},{"id":4009,"depth":484,"text":4010,"children":5975},[5976,5977],{"id":4013,"depth":491,"text":4014},{"id":4111,"depth":491,"text":4112},{"id":4130,"depth":484,"text":4131},{"id":4320,"depth":484,"text":4321},{"id":4473,"depth":484,"text":4474,"children":5981},[5982,5983],{"id":4477,"depth":491,"text":4478},{"id":4872,"depth":491,"text":4873},{"id":4938,"depth":484,"text":4939},{"id":4980,"depth":473,"text":4981,"children":5986},[5987,5988,5989],{"id":5063,"depth":484,"text":5064},{"id":5108,"depth":484,"text":5109},{"id":5145,"depth":484,"text":5145,"children":5990},[5991,5992,5993],{"id":5168,"depth":491,"text":5169},{"id":5406,"depth":491,"text":5407},{"id":5480,"depth":491,"text":5481},{"id":5739,"depth":473,"text":5740},{"id":5927,"depth":473,"text":5927},{"id":5933,"depth":473,"text":5933},[5998,1049,5391],"collaboration","2026-09-08","本教程将手把手带您在 Ubuntu VPS 上部署自托管的 Block 旗下 Nostr 中继服务 Buzz，并配置 Cloudflare DNS 安全网络。我们将帮助您搭建起一个安全性的共享工作空间，让您的团队成员与多个 AI 智能体（如 Claude、Kimi）能够基于加密身份进行高效沟通、共享项目上下文并实现无缝协作。","https:\u002F\u002Finimages.techvoyage.dev\u002Farticles\u002FSelf-Hosting%20Buzz%20As%20The%20Workspace%20Where%20AI%20Agents%20Become%20Colleagues\u002FZH-Self-Hosting-Buzz-As-The-Workspace-Where-AI-Agents-Become-Colleagues.webp","一张高颜值的 16:9 科技质感卡片，具有深蓝色和橙色色调，插图展示如何在 Ubuntu VPS 上部署自托管的 Block 旗下 Buzz 协作中继服务器，其中包含一个带有居中文字的毛玻璃微动质感面板。",{"schemaOrg":6004,"robots":1059,"sitemap":6024},[6005,6006],{"@type":1058,"headline":3863,"description":6000,"image":6001},{"@type":3846,"name":3863,"description":6000,"image":6001,"step":6007},[6008,6012,6015,6018,6021],{"@type":6009,"name":6010,"text":6011},"HowToStep","阶段 1：Cloudflare 设置","创建 Cloudflare API 令牌并配置 DNS 解析设置。",{"@type":6009,"name":6013,"text":6014},"阶段 2：安装 Docker","在 Ubuntu VPS 上设置并安装 Docker 容器引擎。",{"@type":6009,"name":6016,"text":6017},"阶段 3：克隆与配置","克隆仓库代码并配置 docker-compose 环境变量。",{"@type":6009,"name":6019,"text":6020},"阶段 4：集成 Caddy","编译带有 Cloudflare DNS 挑战模块的的自定义 Caddy 镜像。",{"@type":6009,"name":6022,"text":6023},"阶段 5：自动备份","配置 cron 定时任务以实现 PostgreSQL 数据库的自动备份。",{"lastmod":3858},{"title":6026,"description":6000,"ogTitle":3863,"ogDescription":6000,"twitterTitle":3863,"twitterDescription":6000},"如何在 Ubuntu VPS 上自建 Block 旗下的 Buzz 协作中继服务器","zh\u002Farticle\u002Fself-hosting-buzz-as-the-workspace-where-ai-agents-become-colleagues",[6029,3855,3879,3857,1066],"Nostr","Plt5qPXpCpnSq9t6cSV6VM3z9k3i2BkoxxI46S98hdM",{"id":1914,"title":1915,"author":1069,"body":1916,"category":3837,"date":3839,"description":3840,"extension":1052,"image":3841,"imageAlt":3842,"isPublished":487,"meta":3843,"minRead":3851,"navigation":487,"path":379,"seo":3852,"stem":3853,"tags":3854,"updatedAt":3858,"__hash__":3859},{"id":1074,"title":1075,"author":1069,"body":1076,"category":1894,"date":1896,"description":1897,"extension":1052,"image":1898,"imageAlt":1899,"isPublished":487,"meta":1900,"minRead":1905,"navigation":487,"path":415,"seo":1906,"stem":1907,"tags":1908,"updatedAt":1069,"__hash__":1912},1792490001540]