使用指南

从这里开始,让 AI Agent 一目了然。

安装 Melora,读懂主面板,设置你的用量口径,并连接适合自己工作方式的本地工作流。

01 · 快速开始

安装、启动,并让第一个状态信号出现。

初始设置遵循实际 App 流程。

1

下载 DMG

从 Melora Releases 页面打开已签名、公证的发行包。

2

将 Melora 拖入 Applications

打开 DMG,将 App 拖入 Applications,然后从 Applications 启动。

3

开启 Agent 活动并安装 Hook

打开“设置 → Agent”,开启你使用的活动来源,并安装对应 Hook。

G15 · Agent 活动设置
4

确认订阅用量访问

打开“设置 → 模型与订阅”;如需订阅窗口数据,请按首次钥匙串授权流程操作。

G03 · 模型与订阅
5

回到主面板

点击菜单栏图标,查看订阅窗口、每日用量、项目用量与当前 Agent 活动。

预期结果:菜单栏显示活动状态信号,面板展示本地用量或清晰的空状态。

02 · 主面板

从活动到用量,读懂主面板。

面板以 AI 用量为第一视角,Agent 活动为它补充即时上下文。

P02 · 主面板会话区
区域展示内容适合回答
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 展示对应工具可提供的订阅窗口信息和重置时间,帮助你做本地判断;服务商记录保持权威性。

已用62%
剩余38%

每日用量

每日用量卡可在“设置”中选择 35 天热力图或 30 天折线。悬停热力图单元显示日用量预览;点击有数据的日期打开日用量详情。

项目用量与估算金额

项目用量按会话工作目录归组。估算金额使用公开模型单价与用户配置汇率,在本机计算;它用于估算而非账单。

估算说明:未收录公开单价的模型不计入估算金额,页面也不会把它当作零成本。

04 · 用量设置

设置你信任的时间、展示与计算口径。

通用设置

控制刷新行为及其他 App 级选择。

G10 · 通用设置

显示设置

选择菜单栏与侧栏呈现方式,以及每日用量图表样式。

G12 · 显示设置
设置项默认值用途
每日用量图表样式热力图提供每日强度概览、预览与详情入口
估算金额汇率用户配置汇率将公开模型价格换算为本地估算
时区系统设置确定每日聚合边界

05 · 通知与声音

无需盯住每个终端,也能及时收到完成与审批事件。

完成、审批与额度通知可独立配置。支持的终端环境中,点击通知会回到原始上下文。

G14a · 通知设置
G14b · 声音设置

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.*

应用生命周期事件,例如退出时清理。

G16 · 自定义 Hook 设置

用户命令在本机、由你掌控地执行。Melora 不会通过远程执行服务转发它们。

07 · 手机联动

把同一份状态带到 iPhone。

需要 iOS 17+ 与 Mac 端 Melora。在 Mac 开启手机联动后,于手机选择并信任该 Mac。手机只读展示会话、订阅窗口与今日用量,审批与任务修改仍在 Mac 完成。

通过局域网或受支持的近场直连连接。竖屏用于速览,横屏充电时可作为桌面显示。

默认直连,出门在外用远程连接

局域网或蓝牙直连不经服务器,并始终免费。离开这个网络后,可免费开启端到端加密的远程连接:内容在离开设备前加密,服务端只保存密文。

08 · 更新与诊断

保持 App 最新,并让本地诊断可操作。

G18 · 更新设置
状态含义处理
无 Agent 活动当前没有可用 Hook 或进程信号确认 Hook 已安装且会话正在活动
用量为空尚无兼容的本地用量记录可聚合正常使用相关工具,记录出现后刷新
账号需要处理订阅窗口访问需要确认打开账号设置并按授权状态处理
通知未回跳终端上下文无法解析确认终端 App 在支持列表中并保持开启
正在工作

存在活动中的本地 Agent 事件或进程信号。

待命

会话仍可用,但没有当前活动。

等待审批

任务需要你的显式决定。

已完成

任务刚到达完成事件。