binance-us-briefing-engine

Binance.US 简报引擎

生成结合账户情况的 Binance.US 简报。只有将市场动态与用户自己的账户联系起来，这项技能才有价值。

此仓库是 Binance.US 技能系列：

• 根目录中的 SKILL.md：旗舰市场简报技能
• 嵌套的 SKILL.md 文件：可安装的配套技能，用于研究、资金管理、交易和账户状态

如果要从仓库中发现完整技能系列，请使用：

npx skills add cmeiliu/binance-us-skills --list --full-depth

如果要安装嵌套的配套技能，请使用 --full-depth --skill <name>。

不适用场景

• 明确的资金管理工作流
• 现货交易执行审核
• 账户状态故障排查
• 用户已选定某种代币后，对单一资产进行深入尽调

随附脚本应优先：

• 使用锚定价格的输出，而非只给出百分比
• 采用 24h 和 7 天的视角，而非只评论单一时间窗口
• 先提供市场背景，再得出针对具体投资组合的结论
• 关注即将到来的催化因素，而不只是回顾过往新闻
• 对与持有或关注资产相关的新闻进行排序并去重
• 提供具体的下一步，而非泛泛的投资组合行动号召
• 采用对话式顾问语气，而非合规报告措辞
• 在明确关注清单缺口和闲置现金有助于促使行动时，将其明确指出

使用此技能的场景

• “给我一份个性化市场摘要”
• “今天我的 Binance.US 账户有哪些要点？”
• “总结一下我的关注清单”
• “给我一份投资组合简报”
• “我有闲置现金或集中度风险吗？”
• “自我最近交易以来有什么变化？”
• “检查一下我的资金准备情况”
• “给我一份每周回顾”

核心规则

优先提供结合账户情况的内容，而非泛泛的市场评论。

有凭证时，请使用：

• 当前余额
• 近期交易历史
• 关注清单或已配置的优先资产
• 有用时查看存款历史
• 与持有、关注或近期交易的资产相关的近期新闻标题

如果没有凭证，脚本仍可生成有限的纯市场简报，但应明确说明这一点。

如何运行

运行随附脚本：

python3 scripts/binance_us_brief.py --mode daily_brief --format both

常见变体：

python3 scripts/binance_us_brief.py --mode portfolio_brief --format text
python3 scripts/binance_us_brief.py --mode watchlist_brief --watchlist BTC,ETH,SOL
python3 scripts/binance_us_brief.py --mode opportunity_alert --alert-threshold-pct 5
python3 scripts/binance_us_brief.py --mode capital_readiness --format text
python3 scripts/binance_us_brief.py --mode asset_research --asset BTC --format text
python3 scripts/binance_us_brief.py init-config

安装行为

• 本地开发时，优先使用默认安装方式，不加 --copy，这样 OpenClaw 会使用符号链接，并立即获取本地仓库的更改。
• 对于 GitHub 安装或复制安装，请使用 npx skills update 获取最新发布版本。
• 对于复制安装，生成的简报会提示版本和更新信息，以便更容易发现过时的副本。

凭证

脚本会按以下顺序查找 Binance.US 凭证：

1. 环境变量：
   • BINANCE_US_API_KEY
   • BINANCE_US_SECRET_KEY
2. ~/.openclaw/secrets.env
3. ~/.env
4. 当前工作区中的 .env

脚本只读取特定键，不会打印原始密钥。

可选配置

脚本支持以下位置的简易 JSON 配置：

~/.openclaw/binance-us-briefing-engine.json

使用以下内容创建配置：

python3 scripts/binance_us_brief.py init-config

可用字段：

• watchlist
• quote_assets
• quiet_hours
• recent_days
• portfolio_currency
• alert_threshold_pct

推荐工作流

1. 运行 daily_brief，生成结合余额和近期交易的概览。
2. 用户想了解账户影响、集中度或闲置现金情况时，运行 portfolio_brief。
3. 用户询问追踪资产时，运行 watchlist_brief。
4. 使用近期新闻标题解释这些资产为何在今天值得关注。
5. 运行 capital_readiness，将市场情况与账户准备情况联系起来，同时避免听起来像是在推销产品。
6. 运行 opportunity_alert，检查持有、关注或近期交易资产是否触发条件。
7. 运行 weekly_reset，生成更全面、结合投资组合情况的回顾。
8. 简报发现需要进一步分析的机会时，运行 asset_research 进行深入、结构化的跟进。
9. 如果用户已不再需要简报，而是需要操作流程，请转交给 binance-us-fund-account、binance-us-spot-trade 或 binance-us-account-status。

输出约定

脚本返回：

• 仅 JSON
• 仅文本
• 或两者兼有

JSON 输出是事实来源。文本输出是可直接交付的呈现内容。

防护措施

• 将简报视为信息内容，而非财务建议。
• 绝不声称结果确定或收益有保障。
• 不自动下单。
• 如果用户在阅读简报后要求执行操作，应将其作为单独的明确步骤处理。
• 此技能为只读，不会下单、转移资金或更改账户设置。
• 允许访问的外部域名仅限：
  • api.binance.us
  • news.google.com