Skip to content

deluo/fund-dca-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fund DCA Advisor - 基金定投智能顾问

一个面向中国 A 股指数基金和 ETF 的定投分析工具,提供回撤分析、建仓/补仓/止盈判断、多基金对比等核心功能。设计为 OpenClaw Skill 运行,也可作为独立 CLI 使用。

功能特性

  • 回撤分析 — 历史最大回撤、当前回撤、近期回撤,含下探/收复时间
  • 建仓/补仓判断 — 基于回撤结构和趋势热度给出客观建议
  • 止盈/减仓判断 — 结合估值分位和涨幅给出操作参考
  • 左侧持仓评估 — 根据投资者风险画像评估左侧持有是否可承受
  • 多基金对比 — 在同一时间窗口内横向比较多只基金的回撤和修复能力
  • 投资者画像 — 风险偏好、投资期限、最大回撤容忍度等维度,个性化匹配建议
  • 本地运行 — 数据缓存至本地 SQLite,无需外部服务依赖(净值数据来源于东方财富)

快速开始

环境要求

  • Python 3.11+

安装

git clone https://github.com/deluo/fund-dca-skill.git
cd fund-dca-skill
pip install -e .

基本用法

# 拉取基金数据(支持多只同时拉取)
python3 skill/fund-dca-advisor/scripts/run_advisor.py refresh-asset 510300 159915 --format json

# 设置投资者画像
python3 skill/fund-dca-advisor/scripts/run_advisor.py profile set \
  --risk-preference balanced \
  --investment-horizon-months 36 \
  --max-drawdown-tolerance 0.20 \
  --expected-return-level balanced \
  --can-hold-left-side yes \
  --accepts-theme-volatility yes

# 分析单只基金
python3 skill/fund-dca-advisor/scripts/run_advisor.py analyze-asset 510300 \
  --drawdown-lookback-months 24 --format markdown

# 对比多只基金
python3 skill/fund-dca-advisor/scripts/run_advisor.py compare-assets 510300 159915 512880 \
  --drawdown-lookback-months 24 --format markdown

命令一览

命令 说明
refresh-asset <代码...> 从东方财富拉取并缓存基金净值数据
analyze-asset <代码> 分析单只基金的回撤、趋势及操作建议
compare-assets <代码...> 横向对比多只基金
profile set 设置投资者风险画像
profile show 查看当前投资者画像
profile clear 清除投资者画像
show-coverage 查看本地缓存覆盖情况
reset-data 清空所有本地缓存数据

支持的基金类型

类型 示例代码 说明
宽基指数 510300, 159915 沪深300、创业板等
行业/主题 512880 证券、芯片、新能源等
红利策略 161725 红利低波等
QDII 海外指数基金

作为 OpenClaw Skill 使用

本项目按照 OpenClaw Skill 规范设计,可直接作为 OpenClaw 的技能使用。

将仓库放到本地后,OpenClaw 会自动识别 skill/fund-dca-advisor/SKILL.md 中的技能定义。用户可以直接用自然语言触发:

  • "分析一下 510300 最近两年的最大回撤和当前回撤"
  • "比较 510300 和 159915 的回撤和修复时间"
  • "这个基金现在适合补仓吗"
  • "最近涨太多了,要不要止盈"
  • "我现在左侧拿得很难受,帮我客观评估一下"

详细说明参见 SKILL.mdOpenClaw 使用指南

项目结构

fund-dca-skill/
├── src/fund_dca_advisor/          # 主包(可 pip install -e .)
│   ├── cli/                       # 命令行入口
│   ├── advisor/                   # 输出渲染
│   ├── domain/                    # 领域模型与枚举
│   ├── pipeline/                  # 数据刷新流程
│   ├── providers/                 # 数据源(东方财富)
│   ├── storage/                   # SQLite 存储层
│   └── strategy/                  # 策略引擎与分类
├── skill/fund-dca-advisor/        # Skill 目录
│   ├── lib/fund_dca_advisor/      # 运行时包(与 src 同步)
│   ├── scripts/                   # 各平台启动脚本
│   ├── references/                # 参考文档
│   └── SKILL.md                   # 技能定义文件
├── tests/                         # 测试
├── pyproject.toml
└── .gitignore

数据说明

  • 净值数据来源于东方财富公开接口
  • 数据缓存至本地 SQLite(skill/fund-dca-advisor/data/fund_dca_advisor.db),首次使用后自动创建
  • 回撤计算使用单位净值,排除分红影响,与第三方平台(如东方财富、同花顺)保持一致
  • 本工具不涉及持仓记账、交易下单、资金管理等功能

许可证

MIT

About

Fund DCA Advisor - 基金定投智能顾问,帮助用户制定定投策略、计算投资收益、分析市场估值,提供科学的定期定额投资建议。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages