用途
本技能用于解答与 Char(原 Hyprnote)平台相关的问题。Char 是一款开源、无机器人、本地优先的 AI 会议记事本,具备系统音频采集、Markdown 输出、插件 SDK 与自动化钩子等能力。技能会先收集上下文,再根据问题类型直接回答或路由到相关技能。
主要能力与覆盖范围
技能可处理以下主题:
- 在 macOS 上安装 Char 或进行首次设置
- 转录提供商选择(本地 Cactus 与 10 家云端 STT 提供商)
- LLM 配置(OpenRouter、BYOK、Ollama/LM Studio 用于离线)
- 群组会议中说话人识别不工作的问题
- 构建插件或使用自动化钩子
- CLI 使用(模板管理、数据库操作)
- 将 Char 与其他记事本进行对比
- 隐私、遥测或 GPL 许可问题
使用方式
技能按步骤引导:
- 收集上下文:若存在 references/learnings.md 则先读取;询问用户需要哪类帮助以及所用套餐(Free、Lite、Pro、Team 或不确定)。若用户提示已含足够上下文,则跳过此步。
- 路由或直接回答:对比其他记事本路由到 /sales-note-taker;审查具体通话路由到 /sales-call-review;构建教练计划路由到 /sales-coaching;通用工具集成模式路由到 /sales-integration。路由时提供确切命令。
- 平台参考:读取 references/platform-guide.md 获取完整平台参考(模块、定价、STT/LLM 提供商、插件 SDK、钩子、CLI、集成),仅用相关章节回答,不倾倒完整参考。
- 可操作指导:聚焦用户具体情况。
首次设置优先级:从 char.com 下载 → 授予 macOS 音频权限 → 选择音频设备 → 测试短录音 → 选择 STT 提供商(本地用 Cactus,云端用 Deepgram/AssemblyAI)→ 配置 LLM(离线用 Ollama,云端用 OpenRouter)。
完全离线设置:Free 套餐 + Cactus 本地 STT + Ollama 本地 LLM,无需云调用与 API 密钥。
说话人识别需要 Lite 及以上套餐,Free 套餐不包含。若群组会议归属重要,至少需 Lite($8/月)。
适用场景
- 需要 100% 离线会议转录与摘要(Free 套餐 + Cactus + Ollama)
- 群组会议说话人识别问题排查
- 构建自定义插件或使用钩子实现集成(如将会议摘要发送到 Slack)
- 评估 Char 与其他记事本(Fathom、Fireflies、Avoma、Gong 等)
- 了解隐私、遥测与 GPL 许可影响
限制与注意事项
- 说话人识别仅限 Lite 及以上,且仍在成熟中,多位 HN 用户报告群组会议中失败。团队承认营销信息过时。承诺前请按会议规模测试。
- “本地优先”默认包含遥测:Char 内置 PostHog 分析与 Sentry 错误跟踪。可退出但未在引导中提示,需检查设置 → 隐私。
- GPL-3.0 许可有 copyleft 影响:与 MIT 许可的 Meetily 不同,企业法务可能标记 GPL。自托管企业使用没问题;分发修改后的二进制会触发 copyleft。
- 截至 2026 年第二季度仅支持 macOS:Windows 与 Linux 构建进行中但尚未公开,目前不要规划跨平台部署。
- 公共 REST API“即将推出”:除 CLI char db 命令外,无程序化访问会议/转录的途径。钩子系统(beforeListeningStarted、afterListeningStopped)是唯一的自动化接口。
- 部分 Mac 上 AudioTap API 问题:M4 Pro Mini 用户报告应用在 Dock 上弹跳但无法打开,除等待修复外无变通方法。
- CRM 集成是计划而非已发布:HubSpot、Salesforce、Slack、Notion 在路线图上但尚不可用。
故障排除
- 应用在 Dock 弹跳但无法打开:AudioTap API 与某些 Mac 型号不兼容(尤其 M4 Pro Mini)。检查 GitHub Issues,尝试从终端运行 /Applications/Char.app/Contents/MacOS/Char 查看错误输出,更新到最新版本。
- 群组会议说话人识别失败:所有语音归为一人或随机交换。确保在 Lite+ 套餐(Free 无说话人 ID)。关键会议可考虑基于机器人的工具(Fathom、Fireflies)以获取每位参与者音频流。
- 转录质量差或漏词:本地 Cactus 引擎以准确性换隐私,云端提供商质量各异。从 Cactus 切换到云端 STT(推荐 Deepgram 或 AssemblyAI)。若保持本地,确保良好麦克风输入与最小背景噪音,检查设置中选择了正确的音频设备。
相关技能
/sales-note-taker、/sales-meetily、/sales-granola、/sales-call-review、/sales-coaching、/sales-integration、/sales-do(路由器,安装:npx skills add sales-skills/sales --skill sales-do)。