人工智能AI AgentAI 应用前端后端即时通讯交互助手工具调用【免费下载链接】holaOSOpen-source agentic workspace enterprises can make their own. Connect the systems you already run — 100 integrations, MCP, chat tools, apps, browser, local files — with shared memory. Any agent (Claude Code, Codex), any model, or BYOK. Set up in clicks, not months. Local-first: your data never leaves your machines.项目地址https://gitcode.com/GitHub_Trending/ho/holaOS点击查看免费下载本文基于 holaOS 仓库内设计文档 docs/plans/2026-06-04-first-launch-onboarding-design.md系统拆解桌面端首次启动引导First-Launch Onboarding的完整重设计方案从名称 → 文件夹 → 布局三步模态向导收敛为登录后一个屏幕直达首条聊天消息同时给出模型提供商透明化、上下文集成提示、一次性 Coachmarks、模板与起始芯片等配套机制的设计细节与分阶段落地路线并结合当前仓库源码说明现状与演进方向。读完本文你可以完整复现该方案的交互流程、视觉规范、触发规则与度量口径并理解它如何与 holaOS 的应用Apps、队友Teammates、技能Skills、集成Integrations四层能力相互咬合。一、问题背景为什么现有的三步向导需要重做设计文档指出现有首次启动体验由两部分组成一个名称 → 文件夹 → 布局的三步模态向导对应仓库中apps/desktoprenderer 侧的旧FirstWorkspacePane流程以及向导之后一个带两张抽象操作卡Build an app / Hire a teammate的空工作区。这套体验存在四个核心问题价值交付前先加摩擦用户在获得任何价值之前就被迫完成三步表单输入落地页过于泛化向导后的空工作区无法传达 holaOS 的差异化能力侧边栏里一排空的 Apps / Skills / Cronjobs 区块反而构成认知负担模型提供商不可见用户不知道当前在用什么模型、经由什么代理只能去 Settings 里找无产品内引导没有 in-product tour也没有上下文相关的集成提示新用户需要自己摸索一切。文档还点出行业背景主流 AI SaaSChatGPT、Claude.ai、Cursor、v0、Bolt、Lovable、Replit Agent、Perplexity的 onboarding 都跳过了角色/行业采集第一屏就把用户放在一个可产出的输入框前。holaOS 的现状与这一趋势脱节。二、设计目标与非目标Goals一屏一动作登录与首条聊天消息之间只有一个屏幕60 秒内让差异化可见apps、teammates、skills、integrations 应作为用户首个任务的副作用自然出现而不是一份待勾选的清单模型提供商透明不藏在 Settings 里集成提示上下文化按需出现而非前置的集成网格高级功能一次性 Coachmark在用户即将使用某功能时给出单次引导。Non-goals强制 API-key 配置默认 Holaboss Proxy 开箱即用角色 / 行业 / tell us about yourself 调查问卷模态视频导览、启动轮播、自动播放教程首次启动的文件夹位置 / 布局选择器默认值即可二者之后都可改。三、总体流程工作区在入口选择之后才创建Sign in ──→ Welcome Screen (one screen) ──→ Workspace Chat │ ↑ ├─ Type a prompt ───────────────┤ ├─ Click a starter chip ────────┤ ├─ Click a template card ───────┤ (template seeds apps teammates) └─ Skip start blank ────────┘流程的核心变更在于时序工作区是在用户从四个入口中做出选择之后才创建的而不是在之前。工作区名称由动作推导而来如 Inbox summary、Content creator workspace文件夹使用 Holaboss 管理的默认路径布局默认split——三者均可事后修改。这一设计与当前仓库代码的实现方向一致apps/desktop/src/components/panes/ChatPane/onboarding/OnboardingFlow.tsx中明确指出在单工作区世界里遗留的 name your workspace 阶段已经移除服务器在首次登录时惰性预置一个工作区见 runtime 侧GET /api/v1/workspaces用户看到 onboarding 时工作区已经存在因此不再需要命名/选目录这类前置输入。同时electron/main.ts中已出现template_modetemplate | empty | empty_onboarding、workspace_onboarding_modestart | skip、workspace_onboarding_enginedeterministic | agentic等运行时字段表明模板播种工作区与start/skip 二选一的执行语义已进入主进程侧的建模范围。四、Screen 1 — Welcome唯一的 onboarding 屏幕该屏幕取代现有的FirstWorkspacePane向导是登录后唯一的 onboarding 屏幕。设计文档给出了完整的线框╭──────────────────────────────────────────────────────────────╮ │ ● ● ● │ │ │ │ holaOS │ │ your AI workspace │ │ │ │ ╭──────────────────────────────────────────────╮ │ │ │ ✦ What would you like to get done? ↵ │ │ │ ╰──────────────────────────────────────────────╯ │ │ │ │ Try one of these │ │ ╭──────────────────╮ ╭──────────────────╮ │ │ │ ✉️ Summarize my │ │ Research the │ │ │ │ inbox today │ │ best CRM tools │ │ │ ╰──────────────────╯ ╰──────────────────╯ │ │ ╭──────────────────╮ ╭──────────────────╮ │ │ │ ✍️ Draft a cold │ │ Plan my week │ │ │ │ email to … │ │ from my cal. │ │ │ ╰──────────────────╯ ╰──────────────────╯ │ │ │ │ ───────── or start from a template ───────── │ │ │ │ ╭──────────────╮ ╭──────────────╮ ╭──────────────╮ │ │ │ │ │ ✍️ │ │ │ │ │ │ Personal │ │ Content │ │ Researcher │ │ │ │ Assistant │ │ Creator │ │ │ │ │ │ ───────── │ │ ───────── │ │ ───────── │ │ │ │ Gmail · Cal │ │ Twitter · │ │ Browser · │ │ │ │ · memory │ │ LinkedIn │ │ summarizer │ │ │ ╰──────────────╯ ╰──────────────╯ ╰──────────────╯ │ │ │ │ Skip start blank │ ╰──────────────────────────────────────────────────────────────╯屏幕结构自上而下依次为品牌区holaOS tagline your AI workspace、作为视觉锚点的中央 Composer 输入框、四张起始芯片starter chips、三张模板卡片template cards、以及弱化视觉的 Skip start blank 逃生通道。交互规则输入框自动聚焦键盘路径是最快路径起始芯片点击即发送不把用户丢回 Composer 编辑而是立即发送消息——置信度优先于编辑焦虑Confidence over edit-anxiety模板卡片创建预载工作区使用该模板的 apps teammates skills 预装的工作区然后带一条模板专属 prefill 进入聊天如Help me get started with my Researcher workspaceSkip start blank 视觉上刻意做小它是逃生通道而不是推荐项。视觉基调Linear 风格空状态垂直留白充足H1 与 chips 使用 Inter仅 taglineyour AI workspace使用 Newsreader 以增加工艺感卡片无渐变纯色背景 1px 细边框Composer 输入框是视觉锚点比屏幕上其他元素更大、对比更强。当前仓库的apps/desktop/src/components/onboarding/OnboardingShell.tsx提供了可复用的全屏 onboarding 画布品牌行 发丝分隔线 可选 Back 链接 居中内容槽 底部版权栏并保留了 macOS 拖拽区titlebar-drag-region。新 Welcome 屏可以直接套用这一外壳只替换中间的内容槽。五、Screen 2 — 首条消息之后工作区壳 进行中的对话用户通过任一入口发出首条消息后直接落入常规工作区壳workspace shell聊天已经在进行中╭────────────╮ ╭──────────────────────────────────────────────╮ │ ▾ Personal │ │ ◀ Home Inbox Artifacts ⊕ │ ├────────────┤ ├──────────────────────────────────────────────┤ │ │ │ You │ │ (sidebar │ │ Summarize my inbox today │ │ fades in │ │ │ │ AFTER │ │ ● Connecting to Gmail… │ │ first │ │ │ │ reply) │ │ Assistant │ │ │ │ Heres whats in your inbox today… │ │ │ │ … │ │ │ │ ╭──────────────────────────────────────╮ │ │ │ │ │ Want this on your real inbox? │ │ │ │ │ │ Connect Gmail to make this live. │ │ │ │ │ │ [Connect] [Maybe later] │ │ │ │ │ ╰──────────────────────────────────────╯ │ │ │ ├──────────────────────────────────────────────┤ │ │ │ ▷ Reply… Claude Sonnet 4.6 │ │ │ ╰──────────────────────────────────────────────╯ ╰────────────╯三个刻意设计的细节1. 侧边栏在首个回复流式完成前淡出。空白的Apps/Skills/Cronjobs区块对新用户是认知税先让用户看到价值再让侧边栏出现。这对应apps/desktop/src/components/layout/shell/AppShell.tsx中的侧边栏挂载路径Sidebar、Center等均在 AppShell 内组装实现时只需在首个回复完成前对侧边栏施加透明度动画与交互降级。2. Composer 铬条始终展示当前模型。如 Claude Sonnet 4.6、via Holaboss Proxy可点击进入 Settings → Providers。透明 信任。这与 holaOS任何模型Claude Code、Codex、任何模型或 BYOK的定位一致——用户应随时知道自己在用什么模型、经由什么代理。3. 集成提示卡上下文化出现。仅当消息实际用到了需要真实集成的工具时才出现例如 agent 调用了 Gmail 工具但当前未绑定 Gmail 账户。规则是每个缺失集成、每个会话最多一条提示。文档将其明确列为 P1 阶段的独立工作项将现有connect integration流程接到 agent 的 tool-call 站点上使得提示在该出现时出现仅在该出现时出现。仓库中已有的集成连接能力可直接支撑该提示卡apps/desktop/src/lib/listAllIntegrationConnections.ts枚举所有已建立的集成连接apps/desktop/src/components/layout/shell/IntegrationCredentialDialog.tsx提供凭据绑定对话框而apps/desktop/src/lib/workspaceDesktop.tsx中的composioToolkitSlugForProvider等函数负责 provider 与 Composio toolkit slug 的映射。这些是Connect / Maybe later按钮的现成接线点。六、Coachmarks一次性、可关闭、按需触发Coachmark 系统负责在不打断用户的前提下恰好在用户即将用到某功能的时机出现╭──────────────────────╮ │ Press ⌘T to open more│ │ tabs anywhere. │ │ [ Got it ]│ ╰─────────┬────────────╯ │ ╭──────────────────────────────────────────▾──╮ │ ◀ Home Inbox Artifacts ⊕ │ ╰──────────────────────────────────────────────╯触发条件表CoachmarkTriggered when⌘Topens tabsUser opens the second tab manually⌘Kglobal searchUser hovers the sidebar search 3s without typing/slash commandsFirst time composer is focused with 0 characters typedmentionsAfter the user has sent 3 messages规则同一时刻至多显示一个 Coachmark每个 Coachmark 对同一用户终生最多显示一次通过 electron settings 持久化Settings 中提供全局 Reset onboarding tips 入口供用户重新开启。文档建议实现为通用 hookuseCoachmark(id, trigger, anchor)配合 electron-settings 支撑的 dismissal 状态。四个初始 Coachmark 的触发时机分别覆盖了标签页系统、全局搜索、斜杠命令与 提及这四类高阶但高频的能力。仓库中⌘K全局搜索对应apps/desktop/src/components/layout/shell/SearchDialog.tsx⌘T标签页系统对应apps/desktop/src/components/layout/shell/state/internalTabs.ts中的internalTabsAtom/activeInternalTabIdAtom这些模块即为 Coachmark 的锚点anchor候选。七、模板初始集三模板 空白每个模板都足够具体能在首个会话中就展示 holaOS 的 apps teammates 层。TemplatePre-installed appsPre-hired teammatePrefill messagePersonal AssistantGmail, Calendar, NotesAlex (assistant persona)Help me organize my dayContent CreatorTwitter, LinkedIn, BrowserSam (content strategist)Draft a post about [topic]ResearcherBrowser, NotesMaya (research lead)Help me research [topic]Blank——(empty composer)文档明确三个模板足够覆盖大多数 I dont know what I want 的用户更多模板可等看到点击分布后再补充。这与仓库中 teammate/employee 机制的现状吻合apps/desktop/src/features/employees/下的EmployeeChatPane、EmployeeChatStreamManager以及AppShell.tsx中的useHostEmployeesChanged说明预雇用队友pre-hired teammate在运行时侧有真实的宿主通信与聊天流支持。八、起始芯片初始集六个各有使命的提示六条具体提示每一条都会解析为一条至少动用一款 app 或 skill 的聊天消息Summarize my inbox today(gmail)Research the best CRM tools for product designers(browser summarize)Draft a cold email to investors(writing skill)Plan my week from my calendar(calendar)Build me a personal CRM with contacts and notes(app builder)Hire me a teammate who helps me review code(teammates)它们并非随机选取——每一条都用于揭示产品的一个不同表面集成integrations、浏览器browser、写作技能writing skills、应用构建器app builder、队友teammates。这一设计在仓库中已有同构的前身apps/desktop/src/components/panes/ChatPane/PersonalizedSuggestions.tsx维护了一张按集成 slug 的单条起始提示表SUGGESTION_TEMPLATES含 gmail、github、notion、slack、linear、googledrive、googlecalendar、googlesheets、jira、zoom以及一组能力示例CAPABILITY_SUGGESTIONS如写简报、做对比表格、起草幻灯片提纲、vibe-code 落地页其注释给出的原则与本文档高度一致每个提示必须产出用户能展示给他人的有形产物every prompt must produce a tangible artifact the user can show someone且每个 slug 只保留一条提示以保持列表可扫读。首次启动的六颗起始芯片可以视为这一机制在登录后第一屏上的前置化部署。九、明确不做什么Explicitly NOT doing角色 / 行业 / 人设下拉框首次启动的工作区名称输入框首次启动的文件夹选择器首次启动的布局选择器How did you hear about us 调查首次聊天前强制 API-key 配置模态视频导览自动播放的启动轮播。这份不做清单本质上是约束设计边界的护栏所有会延迟第一条消息的动作全部排除所有会打断沉浸感的营销/教学形式全部排除。与 Goals 一一对应确保演进过程不回归。十、分阶段上线Phased rollout阶段内容说明P0Welcome 屏幕取代向导影响最大、独立性强上线前后对比首条消息转化率P0起始芯片 模板与 Welcome 同屏一起上线v1 三个模板足够P1Composer 铬条展示模型聊天 composer 头部的小范围独立改动P1上下文集成提示将现有connect integration流程接到 agent 的 tool-call 站点P2Coachmarks 系统构建通用useCoachmark(id, trigger, anchor)hook用 electron-settings 持久化 dismissal 状态接入四个初始 CoachmarkP2侧边栏首条消息后淡入打磨项不阻塞 P0 / P1值得注意的工程约束P0 两个工作项相互独立且同屏共发P1 两项都是小范围改动composer 头部、tool-call 站点接线P2 是通用机制Coachmark hook加打磨明确不要因为打磨项阻塞核心路径。这种依赖分级让团队可以先拿到最大收益首条消息转化率再逐步叠加透明化与引导层。十一、开放问题Open questions起始芯片是否也应出现在任意新聊天会话的空 Composer 中而非仅首次启动作为常态化的 what next 提示模板是否应支持创建后转换如将此工作区转换为 Researcher 模板文档倾向 v1 不做用户已完成首次启动 onboarding 的标志存在哪里electron settings、runtime DB 还是后端用户档案文档认为后端最佳重装后仍保留但 electron settings 最快上线自动推导的工作区名称来自本地启发式还是快速 LLM 调用LLM 名称更佳但引入延迟。这些问题的取舍直接决定了后续实现的技术选型尤其是持久化位置本地 electron settings vs 后端 profile与命名延迟本地启发式 vs LLM 调用两处属于典型的产品/工程权衡点。十二、成功指标Success metrics从登录到发出首条消息的时间目标中位数 30 秒注册当会话内发出首条消息的新用户占比目标 80%入口分布输入提示 vs 起始芯片 vs 模板 vs 跳过用于持续优化芯片与模板列表7 天内至少连接一个集成的新用户占比作为上下文提示是否奏效的间接信号。度量体系与设计目标一一对应前两项直接度量一屏一动作的转化效率入口分布驱动芯片/模板的迭代集成连接率验证上下文提示优于前置网格的假设。仓库apps/desktop/src/main.tsx中recordLaunch()与trackUmamiEvent(desktop_launched, { is_first_launch: launch.isFirstLaunch })已提供首次启动事件埋点的基础设施后续可在其基础上补充首条消息时间、入口类型等自定义事件用于支撑上述指标的量化对比。结语这份设计文档的价值在于把首次启动从一次表单填写重新定义为一次用户带着真实意图进入工作区的机会一个屏幕、四个入口、60 秒内让 holaOS 的应用/队友/技能/集成层自然浮现模型透明化建立信任上下文集成提示在需要时出现一次性 Coachmark 在用户即将使用高阶功能时轻推一把。P0→P2 的分阶段路线与明确的度量指标使这套方案既能快速验证核心假设首条消息转化又能持续演进Coachmark、侧边栏淡入。配合仓库中已有的 OnboardingFlow 三阶段流程、PersonalizedSuggestions 起始提示机制、集成连接与凭据对话框、employee 队友聊天流等现成模块落地路径清晰且大多有可复用的接线点。赞分享人工智能AI AgentAI 应用前端后端即时通讯交互助手工具调用【免费下载链接】holaOSOpen-source agentic workspace enterprises can make their own. Connect the systems you already run — 100 integrations, MCP, chat tools, apps, browser, local files — with shared memory. Any agent (Claude Code, Codex), any model, or BYOK. Set up in clicks, not months. Local-first: your data never leaves your machines.项目地址https://gitcode.com/GitHub_Trending/ho/holaOS点击查看免费下载相关推荐B站视频下载革命用BiliTools解锁你的离线学习宝库B站视频下载革命用BiliTools解锁你的离线学习宝库 还在为无法保存B站优质内容而烦恼吗想要随时随地重温那些精彩教程和番剧吗今天我要向你介绍一款改变桌面应用音视频SuperPlane 首次运行引导Onboarding First RunUX 与文案规格解析从登录到工作台看板的五屏流程设计SuperPlane 首次运行引导Onboarding First RunUX 与文案规格解析从登录到工作台看板的五屏流程设计 导读本文基于 docs/如何通过OasisDEX API进行链上交易MakerDAO生态必备技能如何通过OasisDEX API进行链上交易MakerDAO生态必备技能 OasisDEX作为MakerDAO生态系统中的核心去中心化交易所提供了完全链上的上一篇s4cmd S3多线程传输与同步实战50GB镜像从2小时到10分钟下一篇保姆级CyberStrikeAIAI安全测试平台三步搞定CTF解题创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
