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