fund-assistant

📁 xer97/fund-assistant 📅 6 days ago
12
总安装量
5
周安装量
#26179
全站排名
安装命令
npx skills add https://github.com/xer97/fund-assistant --skill fund-assistant

Agent 安装分布

openclaw 5
kimi-cli 5

Skill 文档

基金投资助手

脚本命令

基金 API(scripts/fund_api.py)

python scripts/fund_api.py query 001618,000001   # 查询实时估值
python scripts/fund_api.py search 白酒           # 搜索基金
python scripts/fund_api.py detail 001618         # 基金详情
python scripts/fund_api.py history 001618 y      # 历史净值 (y/3y/6y/n/3n/5n)
python scripts/fund_api.py position 001618       # 持仓明细
python scripts/fund_api.py manager 001618        # 基金经理
python scripts/fund_api.py index                 # 大盘指数
python scripts/fund_api.py flow                  # 资金流向
python scripts/fund_api.py north                 # 北向资金

持仓管理(scripts/portfolio.py)

python scripts/portfolio.py init                 # 初始化数据目录
python scripts/portfolio.py list                 # 查看持仓
python scripts/portfolio.py add 001618 1000 1.5  # 添加持仓(代码 份额 成本)
python scripts/portfolio.py update 001618 shares=1500  # 更新持仓
python scripts/portfolio.py remove 001618        # 删除持仓
python scripts/portfolio.py user 老婆            # 切换用户
python scripts/portfolio.py users                # 列出所有用户
python scripts/portfolio.py export portfolio.json  # 导出持仓
python scripts/portfolio.py import portfolio.json  # 导入持仓

数据存储

位置:.fund-assistant/users/{用户名}/portfolio.json(项目本地目录)

{"funds": [{"code": "001618", "name": "天弘中证食品饮料", "shares": 1000, "cost": 1.5}]}

详细结构:references/storage.md

收益计算

// 当日收益:has_replace=true 时用 nav,否则用 gsz
dailyGains = hasReplace ? (nav - nav / (1 + change * 0.01)) * shares : (gsz - nav) * shares;
// 持仓收益
costGains = (nav - cost) * shares;
costGainsRate = ((nav - cost) / cost) * 100;

操作流程

用户意图 执行步骤
查询基金 fund_api.py query {代码} → 解析 JSON 输出
添加持仓 portfolio.py add {代码} {份额} {成本}
查看持仓收益 portfolio.py list → fund_api.py query {代码列表} → 计算收益
切换用户 portfolio.py user {用户名}
查看行情 fund_api.py index

API 响应字段

详见 references/api.md

注意事项

  1. 首次使用需运行 portfolio.py init 初始化数据目录
  2. has_replace=true 表示净值已公布,使用 nav 而非 gsz
  3. 交易时段:9:30-11:30, 13:00-15:00(排除节假日)