投资组合追踪器技能
一个完全本地运行的投资组合追踪器。所有数据均存储在 ~/.portfolio-tracker/ 中。
架构
- 数据:
~/.portfolio-tracker/data.json(投资组合、资产、价格) - 配置:
~/.portfolio-tracker/config.json(API 密钥、钱包地址、用户资料) - 脚本:
<skill-path>/scripts/中的 TypeScript CLI 工具,通过npx tsx运行
首次设置
在运行任何脚本之前,请确保安装了依赖项:
npm install --prefix <skill-path>/scripts
将 <skill-path> 替换为该技能的实际安装路径。
脚本工作原理
每个脚本都是一个独立的 CLI 工具。通过以下方式运行:
npx tsx <skill-path>/scripts/<script>.ts <command> [args]
脚本在需要时从标准输入读取数据,并将 JSON 输出到标准输出。
data-store.ts
load— 读取投资组合数据(如果缺失则创建默认)save— 写入投资组合数据(从标准输入读取 JSON)load-config— 读取配置save-config— 写入配置(从标准输入读取 JSON)
fetch-prices.ts
crypto <symbol>— 获取加密货币价格(Binance → CoinGecko)stock <symbol>— 获取股票价格(Yahoo Finance)fx— 获取 USD/CNY/HKD 汇率historical <symbol>— 获取 3 年月度历史数据search <query>— 按名称/符号搜索资产refresh— 批量刷新价格(从标准输入读取资产 JSON)
binance-sync.ts
sync <apiKey> <apiSecret>— 获取所有 Binance 余额(6 个账户类型)validate <apiKey> <apiSecret>— 验证 API 凭据
ibkr-sync.ts
sync <token> <queryId>— 通过 Flex Query 获取 IBKR 持仓validate <token> <queryId>— 验证 IBKR 凭据
blockchain-sync.ts
sync <address> [chain]— 获取钱包余额(单链或所有 5 条 EVM 链)validate <address>— 验证 EVM 地址
数据类型
资产
{
"id": "唯一标识",
"type": "CRYPTO | USSTOCK | HKSTOCK | ASHARE | CASH",
"symbol": "BTC",
"name": "Bitcoin",
"quantity": 1.5,
"avgPrice": 40000,
"currentPrice": 50000,
"currency": "USD | CNY | HKD",
"transactions": [],
"source": { "type": "manual | binance | wallet | ibkr" }
}
投资组合
{
"id": "唯一标识",
"name": "主组合",
"assets": [...]
}
工作流模式
查看投资组合
- 通过
data-store.ts load加载数据 - 通过
currentPortfolioId找到当前投资组合 - 使用
quantity * currentPrice计算每个资产的总值 - 使用
exchangeRates转换为显示货币 - 以格式化表格呈现
添加资产
- 加载数据
- 使用
fetch-prices.ts search <query>搜索资产 - 通过
fetch-prices.ts crypto/stock <symbol>获取当前价格 - 使用生成的唯一标识将资产添加到当前投资组合
- 保存数据
刷新价格
- 加载数据
- 将当前投资组合资产通过标准输入传递给
fetch-prices.ts refresh - 同时运行
fetch-prices.ts fx获取汇率 - 更新每个资产的
currentPrice和exchangeRates - 将
lastPriceRefresh设置为当前 ISO 时间戳 - 保存数据
从交易所/钱包同步
- 加载配置以获取凭据
- 运行相应的同步脚本
- 合并结果:更新现有资产(按 symbol+source 匹配),添加新资产
- 保存数据
命令
可用的用户命令:
/portfolio— 查看和管理投资组合/prices— 刷新所有价格/setup— 配置 API 密钥和钱包/sync-binance— 从 Binance 同步/sync-ibkr— 从 Interactive Brokers 同步/sync-wallet— 从区块链钱包同步/advise— 获取 AI 投资建议