🏗️ 架构总览

flowchart TB
    subgraph 接入层["📡 接入层 (AI Agent 驱动)"]
        CLI["dsa CLI<br/>(Python Click)"]
        API["dsa serve — REST API<br/>(FastAPI / port 8000)"]
        Plugin["OpenClaw Plugin<br/>(TypeScript / npm)"]
    end

    subgraph 引擎层["⚙️ 分析引擎"]
        Pipeline["Pipeline 编排<br/>(src/core/pipeline.py)"]
        Agent["Agent 系统<br/>(src/agent/)"]
        Strategies["策略系统<br/>(15+ YAML 策略)"]
        Technical["技术分析<br/>(K线/指标/资金流)"]
    end

    subgraph 数据层["💾 数据层"]
        DataProviders["多源数据抓取<br/>(AkShare/Tushare/YFinance...)"]
        VectorDB["向量搜索<br/>(LM Studio 嵌入)"]
        DB["SQLite 持久化<br/>(分析/股池/历史/信号)"]
    end

    subgraph 外部系统["🔗 外部系统"]
        LLM["本地/云端 LLM<br/>(LM Studio / OpenAI / ...)"]
        News["新闻搜索<br/>(SerpAPI/Tavily/Brave)"]
    end

    CLI -->|HTTP| API
    Plugin -->|HTTP| API
    API --> Pipeline
    Pipeline --> Agent
    Pipeline --> Technical
    Pipeline --> DataProviders
    Agent --> Strategies
    DataProviders --> DB
    DataProviders --> News
    Pipeline --> LLM
    VectorDB --> LLM

    style CLI fill:#4a9eff,color:#fff
    style Plugin fill:#4a9eff,color:#fff
    style API fill:#4a9eff,color:#fff
    style Pipeline fill:#f9a825,color:#000
    style Agent fill:#f9a825,color:#000
    style Strategies fill:#f9a825,color:#000
    style DataProviders fill:#66bb6a,color:#fff
    style VectorDB fill:#66bb6a,color:#fff
    style DB fill:#66bb6a,color:#fff

发布的包

✨ 核心能力

数据来源

🚀 快速开始

方式一：pip 安装（无需克隆）

# 安装后端
pip install dsa-server

# 安装全部依赖（数据源 + LLM + API）
pip install "dsa-server[full]"

# 启动 API 服务
dsa serve

# 另开终端，分析股票
dsa analyze 600519

方式二：克隆仓库（开发模式）

git clone https://github.com/kuaizhongqiang/daily_stock_analysis.git && cd daily_stock_analysis
pip install -r requirements.txt
pip install -e .
cp .env.example .env

# 分析
python main.py

常用命令：

python main.py --debug              # 调试模式
python main.py --dry-run            # 干跑
python main.py --stocks 600519,hk00700,AAPL   # 指定股票
python main.py --market-review      # 仅大盘复盘

CLI 工具（需 pip install -e .）：

# 股票分析
dsa analyze 600519                  # 分析股票
dsa market                          # 大盘复盘
dsa resolve 茅台                     # 股票名称解析

# 股池管理（第二期）
dsa pool create 我的自选              # 创建股池
dsa pool add 1 600519 --market cn   # 添加股票
dsa pool stocks 1                   # 查看池内股票

# 语义搜索（第二期）
dsa vector search "茅台近期走势"      # 自然语言搜索
dsa vector status                    # 索引状态

# 历史管理（第二期）
dsa history search 茅台              # 全文搜索历史
dsa history export --format json     # 导出历史
dsa history stats                    # 统计信息

# REST API 服务
dsa serve                          # 启动 API 服务（FastAPI / port 8000）

🎯 OpenClaw Plugin（v0.1 新）

通过原生 TypeScript Plugin 深度集成 OpenClaw：

# 编译插件
cd extensions/dsa-plugin && pnpm install && pnpm build

21 个结构化工具 — 分析、行情、大盘、股池、搜索、历史、策略问股，全部参数 JSON Schema 校验，内置会话上下文追问、审批流（高危操作需确认）、主动推送（股价预警）。

详见 DSA Plugin 文档 和 Plugin vs Skill 对比。

⚙️ 配置说明

完整环境变量、模型渠道、数据源优先级、交易纪律等见 完整配置指南。

关键配置项：

📄 License

MIT License

• Copyright © 2026 ZhuLinsen（原始作者）
• Copyright © 2026 kuaizhongqiang（Fork 修改）

原始版权声明和许可协议保持完整，详见 LICENSE。

⚠️ 免责声明

本项目仅供学习和研究使用，不构成任何投资建议。股市有风险，投资需谨慎。