Halo

中文

English

中文

English

Appearance

Halo 用户手册 · 写作进度 ​

当前状态 ​

章节完成度最后更新备注
第一章：企微机器人配置100%2026-04-291.1-1.6 全部完成
第二章：创建和使用数字人100%2026-04-292.1-2.6 + 常见问题全部完成
第三章：用 Halo 发邮件100%2026-04-293.1-3.9 + 常见问题全部完成
第零章：安装与第一次打开100%2026-04-290.1-0.12 + 常见问题全部完成
第四章：和 AI 对话基础100%2026-04-294.1-4.10 + 常见问题全部完成
第五章：空间管理100%2026-04-295.1-5.12 + 常见问题全部完成
第六章：AI 浏览器100%2026-04-296.1-6.13 + 常见问题全部完成
第七章：远程访问100%2026-04-297.1-7.15 + 常见问题全部完成
第八章：设置、应用商店与排障100%2026-04-298.1-8.9 + 常见问题全部完成
其余功能全覆盖90%2026-04-29第八章覆盖了设置各页面、App Store、个人微信、排障。剩余：DHP 协议/生产级指南（开发者向，非目标读者必读）

写作原则（每次运行必须遵守） ​

  • 读者：完全不懂软件的普通人（律师、会计师等）
  • 每步三要素：看哪里 → 做什么 → 做完后看到什么
  • 用 ASCII 图示界面布局
  • 绝不跳步，绝不假设读者有任何前置知识
  • 每次聚焦 1-2 个小节写透，不铺开

最近工作记录 ​

2026-04-29 第十一次运行 ​

  • 完成：第八章全部 8.1-8.9 + 常见问题（约 6000 字）
  • 8.1 设置页面在哪里（导航入口、左侧菜单列表、ASCII 全景图）
  • 8.2 外观设置（Theme 三选一、Language 下拉、Send Key 两选一）
  • 8.3 系统设置（Permissions 说明、Auto Launch、Task Notifications、Proxy 代理含 Save 按钮、Browser Proxy 子开关、Log Files、System Diagnostics 含 ASCII 图示和四步排障流程）
  • 8.4 管理 AI 模型源（切换/新增/编辑/删除来源，串联第零章）
  • 8.5 应用商店（概念引入、浏览搜索、安装流程、Registry 说明）
  • 8.6 个人微信连接（对比企微表格、扫码四步流程、断开方法）
  • 8.7 进阶设置（System Prompt Profile、MCP Extensions 六项表格、Max Turns、Developer Mode）
  • 8.8 关于和推荐（版本检查、GitHub Star）
  • 8.9 常见错误与排障指南（六类问题：AI 停止/Prompt too long/图片报错/Windows命令失败/错误码/AI 无响应完整 Check 清单）
  • 常见问题 7 个（生效方式/微信连不上/商店没找到/诊断安全性/代理填错/MCP 该开哪些/Registry 是什么）
  • 关键决策：
    • 将设置各页面、App Store、个人微信、排障合并为一章，因为它们都是「配置和维护」类操作
    • 排障部分整合了官方 troubleshooting 文档的所有场景，用更通俗的语言重写
    • Advanced 设置标注为「可跳过」，避免零基础用户被吓到
    • Proxy 设置特别强调「需手动 Save」（与其他自动保存设置不同）
    • 诊断功能用 ASCII 图示 + 四步递进排障流程
  • 第八章 100% 完成
  • 覆盖分析结论：DHP 协议和生产级指南面向开发者，非目标读者必读内容
  • 下次建议：进入阶段三维护模式，或可考虑写一个简短附录覆盖 DHP/Skills 概念

2026-04-29 第十次运行 ​

  • 完成：第七章全部 7.1-7.15 + 常见问题（约 6000 字）
  • 7.1 远程访问能做什么（功能概览、设备场景表）
  • 7.2 两种访问模式（局域网 vs 互联网、一问判断法）
  • 7.3 打开远程访问设置页面（导航栏→Settings→Remote Access，双 ASCII 图示）
  • 7.4 开启远程访问（安全警告阅读、总开关操作、展开确认）
  • 7.5 认识展开后的信息面板（三区域完整 ASCII 图示、四项信息表格）
  • 7.6 用手机通过局域网访问（二维码扫码 + 手动输入两种方法、密码查看/复制）
  • 7.7 开启互联网访问/公网隧道（Start Tunnel 操作、等待 10 秒、绿色公网地址框）
  • 7.8 修改访问密码（Edit 按钮→输入框→Save、4-32 字符限制）
  • 7.9 查看当前连接设备（Connected Devices 显示逻辑）
  • 7.10 关闭互联网访问（Stop Tunnel 操作、旧地址失效说明）
  • 7.11 完全关闭远程访问（总开关关闭、密码重置说明）
  • 7.12 手机上的使用体验（功能对比表、三种设备类型）
  • 7.13 实用场景（四个金融行业场景：下班/开会/演示/出差）
  • 7.14 安全注意事项（五条安全规则：密码/隧道/地址变更/去中心化/多机独立）
  • 7.15 连接出了问题怎么办（6 项 Check 排查清单）
  • 常见问题 7 个（资源消耗/关窗口/多人访问/地址变更/手机AI浏览器/与企微区别/防火墙）
  • 关键决策：
    • 用「办公室远程门铃+门锁」类比引入远程访问概念
    • 两种模式用「同一栋楼走廊 vs 电话拨号」类比帮助选择
    • 完整 ASCII 图示展示信息面板三区域布局
    • 安全提醒贯穿全章（黄色警告框 + 独立安全注意事项节）
    • FAQ 对比表区分远程访问和企微机器人的使用场景
  • 第七章 100% 完成
  • 下次建议：检查「其余功能全覆盖」，可能涉及 MCP、设置其他选项等

2026-04-29 第九次运行 ​

  • 完成：第六章全部 6.1-6.13 + 常见问题（约 6500 字）
  • 6.1 AI 浏览器概念（助手代替操作类比、与普通浏览器对比、桌面端独有说明）
  • 6.2 在哪里开启（输入框下方工具栏 ASCII 图示、Web Control 按钮位置、开关状态说明）
  • 6.3 第一个网页任务（百度搜索示例、自然语言下达指令）
  • 6.4 浏览器操作卡片（完整 ASCII 图示、步骤状态符号含义、10 种操作类型表格）
  • 6.5 View Live Feed（画布弹出说明、左右布局 ASCII 图示、工具栏按钮表格、AI 操作指示条）
  • 6.6 人机协作（4 种操作方式、设备模式切换 PC/H5 详解）
  • 6.7 实用场景（5 个金融行业场景：信息搜索/表单填写/数据采集/市场调研/辅助操作 + 限制说明）
  • 6.8 AI 模型要求（截图识别 vs 结构分析、多模态概念、模型对比表）
  • 6.9 给数字人开启 AI Browser（Settings 标签页、开关位置 ASCII 图示、黄色警告说明）
  • 6.10 Browser Login（Required Logins 区域 ASCII 图示、登录操作步骤、过期提醒）
  • 6.11 地址栏功能（网址 vs 搜索自动判断、图标变化说明、自动补全 https）
  • 6.12 更多选项菜单（截图/缩放/开发者工具）
  • 6.13 页面被限制访问（Access Restricted 页面说明、策略阻止处理方式）
  • 常见问题 8 个（功能未开启/卡住处理/登录安全/与Chrome区别/数据安全/两个开关区别/自动签到/步骤失败）
  • 关键决策：
    • 用「助手代替你操作电脑」类比引入 AI 浏览器概念
    • 操作卡片详解 10 种操作类型，用表格而非段落，方便查阅
    • View Live Feed 完整画布布局 ASCII 图示，包含左右分栏
    • 人机协作单独成节，强调验证码等 AI 无法完成的步骤
    • 数字人 AI Browser 开关与聊天 Web Control 在常见问题中明确区分
    • Browser Login 场景独立成节（6.10），因为涉及 Cookie 管理和登录过期
  • 第六章 100% 完成
  • 下次建议：开始第七章「远程访问」

2026-04-29 第八次运行 ​

  • 完成：第五章全部 5.1-5.12 + 常见问题（约 6000 字）
  • 5.1 空间概念（办公桌文件盒类比、四行对比表）
  • 5.2 两种空间对比（公共会议室 vs 私人办公室、一问判断法）
  • 5.3 认识主页上的空间区域（主页 ASCII 全景图、上下两大区域拆解）
  • 5.4 空间指南条（展开/收起操作、三个教育小节 + AI 删除权限警告）
  • 5.5 创建专属空间（五步操作：+ New → 图标 → 存储位置双选项 → 命名 → Create）
  • 5.6 进入空间（Halo 空间 vs 专属空间两种入口）
  • 5.7 在空间之间切换（空间选择器 ASCII 图示、下拉列表、Manage Spaces 回主页）
  • 5.8 编辑空间（悬停显示图标、Edit Space 对话框、Save 保存）
  • 5.9 删除空间（两种确认信息、Custom Folder vs Default Location 区别、不可撤销警告）
  • 5.10 并行工作（经理-助手类比、实际操作示例、限制说明）
  • 5.11 数字人与空间的关系（工作区 vs 记忆区、清空记忆不影响工作区）
  • 5.12 实用建议（金融行业场景对照表、一项目一空间原则）
  • 常见问题 6 个（换文件夹/重复关联/恢复记录/active 含义/性能/能力区别）
  • 关键决策：
    • 用「办公桌文件盒」和「公共会议室 vs 私人办公室」双类比贯穿全章
    • 创建空间的 Default vs Custom 两种选项详细说明，因为这是用户最困惑的选择
    • 并行工作用「经理-多助手」类比，让非技术用户秒懂
    • 数字人空间关系单独成节，串联第二章的知识
    • 删除操作重点区分两种情况的数据影响，避免用户误操作
  • 第五章 100% 完成
  • 下次建议：开始第六章「AI 浏览器」

2026-04-29 第七次运行 ​

  • 完成：第四章全部 4.1-4.10 + 常见问题（约 7500 字）
  • 4.1 发消息的三种方式（回车/按钮/Ctrl+Enter，含切换设置说明）
  • 4.2 上传图片给 AI 看（多模态概念、三种上传方法、图片限制表、删除预览、实用场景）
  • 4.3 切换 AI 模型（模型概念类比、模型选择下拉面板 ASCII 图示、刷新模型列表）
  • 4.4 管理多个对话（新建/侧边栏/切换/右键菜单 Pin/Rename/Delete、收起侧边栏、手机端差异）
  • 4.5 搜索历史对话（打开搜索、三种范围、搜索结果跳转、导航条 2/5 上下箭头）
  • 4.6 用 @ 引用文件（@ 触发文件列表、过滤选择、拖拽引用、使用场景）
  • 4.7 深度思考模式（概念类比、开关位置 ASCII 图示、场景建议表）
  • 4.8 AI 回复过程中的操作（停止回复两种方法、追加补充消息队列）
  • 4.9 斜杠命令（命令菜单 ASCII 图示、Skill vs Built-in 分类、常用命令表、Token 指示器详解）
  • 4.10 切换空间（空间下拉列表 ASCII 图示、并行工作概念）
  • 常见问题 6 个（红色报错/切换模型/判断 AI 状态/整理对话/Deep Thinking 费用/compact 原理）
  • 关键决策：
    • 第零章已涵盖界面入门（0.11-0.12），本章定位为「进阶技巧」，不重复基础介绍
    • 图片上传特别强调「非多模态模型报错后必须新开对话」这个高频坑
    • 模型概念用「不同级别助手」类比（高配/中配/轻量）
    • Token 指示器详解放在斜杠命令节内（/compact 与 Token 密切相关）
    • 并行工作概念在空间切换节引出（而非单独成章）
  • 第四章 100% 完成
  • 下次建议：开始第五章「空间管理」

2026-04-29 第六次运行 ​

  • 完成：第零章全部 0.1-0.12 + 常见问题（约 8000 字）
  • 0.1 Halo 是什么（ChatGPT 对比表、核心词汇初次介绍、AI 密钥类比出租车卡）
  • 0.2 下载安装包（官网 + GitHub 两个下载入口、Windows/Mac 版本选择、Mac 芯片判断方法）
  • 0.3 安装（Windows .exe 安装 + Git Bash 提示、Mac .dmg 拖拽安装 + 安全提示解决）
  • 0.4 第一次打开：选择 AI 登录方式（三种卡片 ASCII 图示、语言切换说明）
  • 0.5 三种登录方式对比（对比表 + 三问判断法）
  • 0.6 Claude OAuth 登录（双模式：直接登录 vs 手动授权码，ASCII 图示）
  • 0.7 GitHub Copilot 登录（设备码流程详解）
  • 0.8 自定义 API 登录（逐格填写 4 格详解：服务商/Key/URL/模型 + 测试连接 + 保存）
  • 0.9 认识主页面（顶部栏/Halo 空间卡片/Apps 卡片/专属空间区域，全部 ASCII 图示）
  • 0.10 跟着引导教程走一遍（三步 Onboarding 完整演练）
  • 0.11 认识聊天界面（顶部栏/侧边栏/对话区/输入框，ASCII 图示）
  • 0.12 发出第一条消息（3 个金融行业实用示例）
  • 常见问题 6 个（重新登录/多提供商/Key 安全/图标缺失/测试失败/换密钥）
  • 关键决策：
    • 用「ChatGPT vs Halo」对比让读者快速理解定位差异
    • AI 密钥用「出租车卡」类比贯穿全章
    • 三种登录方式用「三问判断法」（按顺序问自己 3 个是/否问题）引导选择
    • API 配置用「逐格填写」方式逐一教学，模型选择附带高配/中配/低配类比
    • Onboarding 三步教程完整跟随，帮助零基础用户建立基本操作信心
  • 第零章 100% 完成
  • 下次建议：开始第四章「和 AI 对话基础」

2026-04-29 第五次运行 ​

  • 完成：第三章全部 3.1-3.9 + 常见问题（约 6000 字）
  • 3.1 邮件功能概念（秘书类比、两个前提、功能清单）
  • 3.2 在设置里填写邮箱账号（逐字段详解 6 个字段，含常见邮箱对照表）
  • 3.3 邮箱配置失败排查清单（6 项 Check，覆盖 SMTP/密码/SSL/端口/IMAP 权限/防火墙）
  • 3.4 给数字人打开邮件开关（三步导航 + Runtime 区域 ASCII 图示）
  • 3.5 进阶设置：CalDAV 日历（展开 Advanced、填 URL、TLS Ciphers 不要动）
  • 3.6 测试数字人收发邮件（三步实测：查邮件/发邮件/验证）
  • 3.7 企微机器人使用邮件（Permission Control 中 Email 权限、Halo Capabilities 图示）
  • 3.8 实用场景：三个提示词模板（邮件摘要/搜索/批量回复）
  • 3.9 定时处理邮件（与第二章模板 B 串联）
  • 常见问题 6 个（聊天 vs 数字人、tools not available、Test 通过但发送失败、多邮箱、日历、AI 乱发邮件）
  • 关键决策：
    • 用「秘书+钥匙」类比贯穿全章，统一邮件功能的心智模型
    • 邮箱密码特别强调「应用专用密码/授权码」而非登录密码——这是实际使用中最高频的错误
    • 排查清单按出错概率排序（密码 > 地址 > SSL > 端口 > IMAP 权限 > 防火墙）
    • 企微机器人邮件权限单独成节（3.7），因为 Permission Control 的 Email 开关容易被忽略
    • 明确警告「AI 发出去的邮件不能撤回」，避免用户在批量回复场景踩坑
  • 第三章 100% 完成
  • 下次建议：开始第零章「安装与第一次打开」或第四章「和 AI 对话基础」

2026-04-29 第四次运行 ​

  • 完成：第二章全部 2.1-2.6 + 常见问题（约 6500 字）
  • 2.1 数字人概念（临时工 vs 全职员工类比、聊天 vs 数字人对比表、典型场景）
  • 2.2 打开数字人管理页面（导航栏 → 主页 → Digital Humans 标签，含 ASCII 图示）
  • 2.3 手工创建 Visual 模式逐字段详解（7 个字段 + 最后一步确认）
  • 2.4 三个提示词模板（企微问答/邮件摘要/每日早报）含完整可复制的 System Prompt
  • 2.5 运行计划详解（By interval + By time 两种模式、重复方式三选一、时间选择器、速查表）
  • 2.6 创建后管理（身份卡片、三个操作按钮、三个标签页 Chat/Activity/Settings）
  • 关键决策：
    • 用「临时工 vs 全职员工」替代官方文档的抽象对比，更贴近金融行业读者
    • Visual 模式逐字段说明，每个字段严格三要素
    • 三个模板都附带「创建后还需要做的事」清单，避免读者漏操作
    • Schedule 详解单独成节，配速查表覆盖常见时间设置需求
    • Settings 里区分「自动保存」（开关类）和「需手动点 Save」（文本类），避免读者踩坑
    • 常见问题覆盖 6 个高频场景（无空间、不运行、删除、Escalation、发送渠道、AI 自动创建）
  • 第二章 100% 完成
  • 下次建议：开始第三章「用 Halo 发邮件」或第零章「安装与第一次打开」

2026-04-29 第三次运行 ​

  • 完成：第一章 1.5（在企业微信里测试机器人——私聊 / 群聊 @ / 首次联系）
  • 完成：第一章 1.6（进阶设置：Reply Scope 三选项 / Streaming 开关 / Permission Control 完整四步流程）
  • 完成：第一章常见问题 + 总结更新
  • 字数新增：约 5000 字
  • 关键决策：
    • 1.5 分电脑端和手机端两种入口说明，避免读者找不到机器人
    • 强调群聊「必须 @ 才看得见」这条核心规则
    • 增加「首次 @ 建立联系」概念，为后续数字人主动推送做铺垫
    • 1.6 Permission Control 用四步递进结构：总开关 → 填 Owner → 开 Guest Access → 勾工具
    • 重点警告两个反直觉陷阱：「开了权限但没填 Owner = 所有人变访客」和「开了 Guest Access 但不勾工具 = 访客还是什么都用不了」
    • 用 ASCII 图示展示设置面板布局
  • 第一章 100% 完成
  • 下次建议：开始第二章「创建和使用数字人」

2026-04-28 第二次运行 ​

  • 完成：第一章 1.3（在 Halo 内填凭据 · 9 步详解）
  • 完成：第一章 1.4（连接失败 5 项排查清单）
  • 字数新增：约 4000 字
  • 关键决策：
    • 1.3 第三步用 ASCII 对比图把三张相似卡片画出来（WeCom Intelligent Bot vs WeChat Bot vs WeCom 单向通知）
    • 强调「Halo 自动保存，没有保存按钮」（避免读者找不到按钮）
    • 强调一个 Bot ID 不能在多张卡片重复填（黄色警告）
    • 数字人下拉为空时引导跳第二章
    • 1.4 提供「错就重粘」的 Secret 排查策略，避免读者一上来就重置
  • 下次建议：
    • 写 1.5：在企业微信里加机器人为好友 → 发消息 → 看到回复（注意区分 PC/手机端入口）
    • 写 1.6：进阶选项三个开关含义（Reply Scope / Streaming / Permission Control）
    • 1.5+1.6 完成后第一章可标 100%，进入第二章

2026-04-28 运行记录（首次） ​

  • 完成：第一章 1.1（机器人 vs 数字人概念，律师事务所类比）
  • 完成：第一章 1.2（企微后台申请 API 模式机器人 6 步详解）
  • 关键决策：强调「大模板 vs API 模式小字」易错点；强调 Secret 只显示一次

已使用的核心素材 ​

  • digital-humans/wecom-bot.md（官方文档）
  • src/main/services/notify-channels/wecom.ts（通知端代码，仅扫名字）
  • src/renderer/components/settings/MessageChannelsSection.tsx（UI 入口确认）