01 · 快速开始
安装、启动,并让第一个状态信号出现。
初始设置遵循实际 App 流程。
下载 DMG
从 Melora Releases 页面打开已签名、公证的发行包。
将 Melora 拖入 Applications
打开 DMG,将 App 拖入 Applications,然后从 Applications 启动。
开启 Agent 活动并安装 Hook
打开“设置 → Agent”,开启你使用的活动来源,并安装对应 Hook。
确认订阅用量访问
打开“设置 → 模型与订阅”;如需订阅窗口数据,请按首次钥匙串授权流程操作。
回到主面板
点击菜单栏图标,查看订阅窗口、每日用量、项目用量与当前 Agent 活动。
预期结果:菜单栏显示活动状态信号,面板展示本地用量或清晰的空状态。
02 · 主面板
从活动到用量,读懂主面板。
面板以 AI 用量为第一视角,Agent 活动为它补充即时上下文。
| 区域 | 展示内容 | 适合回答 |
|---|---|---|
| Agent 活动 | Claude Code、Codex、Pi、Grok、Cursor 与 Devin 的活动信号 | 现在有什么需要处理? |
| 订阅窗口 | 5H / 7D 用量和重置时间 | 还剩多少可用空间? |
| 每日用量 | 35 天热力图或折线视图 | 哪天使用密度最高? |
| 项目用量 | 按工作目录归组的用量 | 哪个项目用了最多? |
| 估算金额 | 模型单价与汇率估算 | 本地估算是多少? |
| 工具栏 | 设置、刷新和入口 | 在哪里配置? |
App 综合 Hook、日志与进程信号进行感知。单个 Agent 状态反映的是 App 在当时能够感知的本地上下文。
Cursor 通过只读本机登录态查询官方面板的周期金额;iPhone 配套 App 会同步展示这些数字。
DSH:Melora 只读 ~/.dsh/sessions 下的会话记录,计入每日用量(筛选项显示为 DeepseekHarness)、日用量详情与项目用量。DeepSeek 余额默认开启:在“设置 → 模型与订阅”填写 API Key,或由 DSH 的 ~/.dsh/.credentials.yaml 提供 DEEPSEEK_API_KEY,面板即出现 DeepseekHarness 余额分组。DSH 暂无活动信号与完成通知;没有会话记录或 Key 时,面板不显示 DSH 内容。
Z.ai 与 Devin:Melora 只读查询供应方回报的套餐窗口与重置时间。Z.ai 在“设置 → 模型与订阅”填写 API Key(或设置 ZAI_API_KEY)即启用,另显示 Z.ai 自报的近 24 小时 / 近 7 天用量,与本机用量分开展示、不相加。Devin 复用 devin auth login 的本机登录,显示日 / 周配额、ACU 上限与超额余额;Devin CLI 会话同时计入本地用量与活动。
03 · 用量说明
先读懂数字,再据此行动。
订阅窗口
App 展示对应工具可提供的订阅窗口信息和重置时间,帮助你做本地判断;服务商记录保持权威性。
每日用量
每日用量卡可在“设置”中选择 35 天热力图或 30 天折线。悬停热力图单元显示日用量预览;点击有数据的日期打开日用量详情。
项目用量与估算金额
项目用量按会话工作目录归组。估算金额使用公开模型单价与用户配置汇率,在本机计算;它用于估算而非账单。
估算说明:未收录公开单价的模型不计入估算金额,页面也不会把它当作零成本。
04 · 用量设置
设置你信任的时间、展示与计算口径。
通用设置
控制刷新行为及其他 App 级选择。
显示设置
选择菜单栏与侧栏呈现方式,以及每日用量图表样式。
| 设置项 | 默认值 | 用途 |
|---|---|---|
| 每日用量图表样式 | 热力图 | 提供每日强度概览、预览与详情入口 |
| 估算金额汇率 | 用户配置汇率 | 将公开模型价格换算为本地估算 |
| 时区 | 系统设置 | 确定每日聚合边界 |
05 · 通知与声音
无需盯住每个终端,也能及时收到完成与审批事件。
完成、审批与额度通知可独立配置。支持的终端环境中,点击通知会回到原始上下文。
06 · Agent 与 Hook
把本地 Agent 事件,变成你的行动。
Melora 按事件来源区分用户 Hook,使每条命令获得清晰且相关的环境变量。
Agent 接入与自定义命令是两回事:先在 Agent 设置安装对应接入,再到自定义 Hook 配置命令。Claude Code 使用原生 Hook,Codex 需要提供相应事件的版本,Pi 0.84.4+ 使用扩展,安装后需 /reload;Codex 安装后需在 /hooks 审核信任。Cursor 使用原生 Hook,Grok 复用 Claude 接入,Devin 无需安装接入,活动来自本机会话记录。各工具事件覆盖不同;支持本地用量不代表支持所有生命周期或审批事件。
agent.*Agent 生命周期:完成、权限请求和会话事件。
quota.*扩展模块提供该能力时的额度变化。
app.*应用生命周期事件,例如退出时清理。
用户命令在本机、由你掌控地执行。Melora 不会通过远程执行服务转发它们。
07 · 手机联动
把同一份状态带到 iPhone。
需要 iOS 17+ 与 Mac 端 Melora。在 Mac 开启手机联动后,于手机选择并信任该 Mac。手机只读展示会话、订阅窗口与今日用量,审批与任务修改仍在 Mac 完成。
通过局域网或受支持的近场直连连接。竖屏用于速览,横屏充电时可作为桌面显示。
默认直连,出门在外用远程连接
局域网或蓝牙直连不经服务器,并始终免费。离开这个网络后,可免费开启端到端加密的远程连接:内容在离开设备前加密,服务端只保存密文。
08 · 更新与诊断
保持 App 最新,并让本地诊断可操作。
| 状态 | 含义 | 处理 |
|---|---|---|
| 无 Agent 活动 | 当前没有可用 Hook 或进程信号 | 确认 Hook 已安装且会话正在活动 |
| 用量为空 | 尚无兼容的本地用量记录可聚合 | 正常使用相关工具,记录出现后刷新 |
| 账号需要处理 | 订阅窗口访问需要确认 | 打开账号设置并按授权状态处理 |
| 通知未回跳 | 终端上下文无法解析 | 确认终端 App 在支持列表中并保持开启 |
存在活动中的本地 Agent 事件或进程信号。
会话仍可用,但没有当前活动。
任务需要你的显式决定。
任务刚到达完成事件。