zframes-brief 是 zframes 仪表盘体系中的每日分析技能。它的核心作用是让用户的市场终端随着时间推移不断变得更精准:每次运行都会完成一个完整的每日循环。
【用途】 该技能运行用户 zframes 仪表盘上的每日市场简报。它读取仪表盘上的符号(universe),获取这些符号的市场快照,对前一天的预测与实际市场走势进行比对打分,然后写入当天的新分析与几条新的、可核查的预测,最后把所有内容追加到一个日志文件中。仪表盘的 daily-analysis 框架负责渲染最新的一条日志条目。该技能只做分析,不编辑仪表盘本身。
【主要能力】
- 解析要简报的仪表盘:仪表盘存放在全局存储($XDG_CONFIG_HOME/zframes/dashboards,默认 ~/.config/zframes/dashboards);可由用户指定名称,否则使用默认仪表盘;若存在歧义则运行 zframes list 并询问用户,不猜测。每个仪表盘有自己的简报日志,互不共享。
- 获取快照(确定性部分):运行 zframes snapshot [<name>] 输出一个 JSON 对象,包含日期、引擎标记(run)、仪表盘信息(含 logPath)、universe(仪表盘上的全部符号)、featured(特色框架符号)、市场数据(dayStats、topMovers、candles、funding、fearGreed、global、tvl)以及 priorEntry(前一天条目或首次运行为 null)。provider 离线时对应值为 null,按现有数据处理。
- 一次性设置(幂等,已完成则跳过):确保仪表盘有 daily-analysis 框架(若缺失,告知用户并询问是否添加,这是本流程唯一一次改动 dashboard.json,且需用户同意);确保日志文件存在,缺失则创建为 {"entries": []}。
- 给昨天的预测打分:若 priorEntry 非空,逐条评估其 calls 中的 check 条件,针对新快照生成 grades 数组,每条为 { callId, verdict, note },verdict 取 hit | miss | partial,note 用一句话引用决定结果的数字。首次运行时 grades 为 []。
- 撰写今天的分析:基于快照生成 summary(几段真实分析)和 calls(2–4 条明确、可核查的预测),每条 call 含 id、symbol、direction(bullish|bearish|neutral)、claim、horizon 以及关键的 check(下一轮可从快照评分的通俗判据)。
- 追加条目到日志:读取 snapshot.dashboard.logPath 处的日志,将新条目推入 entries(最新在后)并写回。条目含 date、run(从快照原样复制)、universe、summary、calls、grades(上一条目 calls 的评分)。这是本循环唯一的写入操作。
【使用方式】 调用 zframes CLI 获取快照:独立场景用 npx zframes@latest <cmd>;在 zframes monorepo 内用 pnpm --silent zframes <cmd>(若 packages/cli/dist/ 缺失需先运行一次 pnpm build:cli)。CLI 目前尚未发布到 npm,因此在发布前应使用 monorepo 的 pnpm zframes 路径。两种方式步骤相同。每日调度由用户自行使用 Claude Code 的 /schedule 完成,本技能不负责设置调度。运行前提是执行者必须能访问并写入仪表盘分析日志所在位置。
【适用场景】 希望为自己的 zframes 市场仪表盘建立每日分析循环、并通过可核查预测与历史打分逐步提升分析质量的用户。适用于基于仪表盘符号集合的市场跟踪与复盘。
【限制】 仅写入仪表盘的分析日志(snapshot.dashboard.logPath);绝不编辑 dashboard.json、布局或其他框架,唯一例外是第 3 步中经用户批准的可选框架添加。分析范围严格等于仪表盘上的符号,不维护独立自选列表。每条预测必须带有可评分 check。仅使用免费数据,快照使用无密钥 provider,无需索取密钥。只能追加,绝不重写,以保留完整历史。若调度器无法访问日志所在位置,则无法更新任何内容。