仓库地址: Beruto 发布日期: 2025-12-09

概要

• 首个可运行的端到端版本：支持加载任务、拉取历史行情、运行策略回测、生成资金曲线，并通过 CLI 与绘图工具交互。
• 核心数据链路打通：适配 akshare / yfinance / 本地 CSV，附带缓存读写与错误分类。
• 提供示例策略与指标工具，便于快速扩展与验证。
• 完善文档，涵盖快速入门、命令行使用、接口设计与技术指标指南。

主要特性

• 回测引擎：src/backtest/engine.run_task 读取任务 JSON，动态加载策略，调用数据层并驱动组合回测。
• 数据层：统一 fetch 接口，适配 akshare、yfinance、本地 CSV；带 parquet 缓存读写、按需刷新。
• 策略与指标：内置 SMA 金叉/死叉示例策略，提供 MA/EMA/RSI/MACD/BOLL/ATR 等指标及触发器 DSL（crossabove/crossbelow）。
• 绘图：plot_kline 支持日/周 K 线、MA/EMA/BOLL/RSI/MACD/ATR 叠加，CLI 参数解析 plot SYMBOL ...。
• 日志与 CLI：日志落盘到 logs/，CLI 支持 help / backtest / plot / config (占位)。

文档

• 新增 Manual 子目录，按子模块列出函数/类签名与用途，便于二次开发。
• 保留快速入门、命令行使用、接口设计与技术指标指南等主线文档。
• 添加了相关知识的文档，为后续复习与扩展提供参考。

已知限制 / 待办

• common.config, common.utils, risk.RiskManager 仍为占位，需要完善实现。
• CLI 的 config 命令未实现；GUI main_window.py 为空。
• 缺少自动化测试覆盖数据适配器、策略决策与回测边界场景。
• 策略库较为单一，需丰富多样化策略与参数调优示例。
• 代码注释不够充分，未完全贯彻自文档化写作模板。
• Portfolio 设计需增强：交易成本/滑点模型细化，多资产与现金管理、持仓轮转等能力。

后续展望

• 实现 UI 界面，打通交互与可视化入口。
• 落地基础风控（最大仓位/回撤）并在下单前校验。
• 为数据层与回测核心补充单元测试与集成测试；考虑加入 CI。
• 丰富策略库（多因子/均值回归/动量）与可视化报表；补充参数调优示例。

吾尝终日而思矣，不如须臾之所学也。

Docker核心概念与实战

1. Docker - 基础概念

• Docker概述: Docker是一种高效的软件部署技术，利用容器化技术为应用程序封装独立的运行环境。每个运行环境即为一个容器，承载容器运行的计算机称为宿主机。
• 容器与虚拟机的区别: Docker容器共享同一系统内核，轻量、启动快；虚拟机包含完整内核，占用资源多。
• 镜像 (Image): 容器的模板，类似软件安装包。
• 容器 (Container): 基于镜像运行的应用实例。
• Docker仓库 (Registry): 存放和分享镜像的场所，Docker Hub为官方公共仓库。

2. Docker - 安装

• 运行环境: Docker基于Linux容器化技术，Windows/Mac通过虚拟化运行。
• 安装步骤:
  • Linux: 通过getdocker.com获取并执行安装脚本。
  • Windows: 启用WSL，安装Docker Desktop。
  • Mac: 根据芯片类型下载Docker Desktop。
• 验证安装: 运行docker --version。

3. Docker - 镜像管理命令

• docker pull: 下载镜像，格式为[registry_address/][namespace/]image_name[:tag]。
• docker images: 列出本地镜像。
• docker rmi: 删除镜像。
• 镜像架构: 默认选择适合宿主机的架构，可指定--platform。

4. Docker - 容器管理命令

• docker run: 创建并运行容器，支持参数：
  • -d: 后台运行。
  • -p: 端口映射。
  • -v: 数据持久化。
  • -e: 设置环境变量。
  • --name: 自定义容器名称。
  • -it: 交互式终端。
  • --rm: 运行结束后自动删除。
• 容器管理:
  • docker ps: 查看运行中的容器。
  • docker stop/start: 停止/启动容器。
  • docker logs: 查看日志。
  • docker exec: 在容器内执行命令。

5. Dockerfile - 构建镜像的蓝图

• 基本指令:
  • FROM: 指定基础镜像。
  • WORKDIR: 设置工作目录。
  • COPY: 拷贝文件。
  • RUN: 执行命令。
  • CMD/ENTRYPOINT: 容器启动命令。
• 构建镜像: docker build -t <镜像名称> .。
• 推送镜像: 登录Docker Hub后使用docker push。

6. Docker - 网络模式

• Bridge: 默认模式，容器通过内部IP互通。
• Host: 容器共享宿主机网络。
• None: 无网络模式。
• 网络管理命令:
  • docker network ls: 列出网络。
  • docker network create: 创建自定义网络。

7. DockerCompose - 多容器编排

• 定义: 使用docker-compose.yml文件管理多容器应用。
• 核心元素:
  • services: 定义服务。
  • volumes: 数据持久化。
  • ports: 端口映射。
  • depends_on: 启动顺序。
• 常用命令:
  • docker compose up: 启动服务。
  • docker compose down: 停止并删除服务。

8. Docker的核心原理

容器镜像的技术实现基于多个Linux内核特性的协同工作。在存储层面，镜像采用分层架构，每个镜像层本质上是文件系统差异的只读快照。联合文件系统（如OverlayFS、AUFS）将这些只读层与一个可写层进行目录级合并，通过写时复制机制确保底层数据的不可变性。当容器修改文件时，联合文件系统会将目标文件复制到可写层进行操作，保持基础层不变。这种设计使得镜像构建具有可追溯性，且相同基础层可在多个容器间共享。

A naive app to process download files from BiliBili app and turns them into available mp4 or mp3 automatically. Link: https://github.com/HangYaHan/BiliBili_DownloadFileProcessor

Features

• Automatically scans and processes BiliBili app download folders
• Converts .m4s files to .mp4
• Extracts audio and converts .mp4 to .mp3 using FFmpeg
• Results are named by its video title
• Supports Chinese filenames
• Simple command-line interface

Dependencies

• FFmpeg (for media conversion)
• nlohmann/json (for JSON parsing)
• C++17 or later
• CMake 3.10 or later

Only Windows is supported currently, older versions of dependencies might work but are not tested.

]]>/posts/gewu/%E6%A0%BC%E7%89%A9%E8%87%B4%E9%9B%85--a-simple-clickscript/Thu, 21 Aug 2025 00:00:00 +0000HangYaHan/posts/gewu/%E6%A0%BC%E7%89%A9%E8%87%B4%E9%9B%85--a-simple-clickscript/ClickScript

前言

ClickScript 最初是在实验室中为方便测试而编写的一个点击脚本工具。经过多次迭代，它逐渐发展为一个功能相对完善的自动化工具。虽然它非常朴素、简单，无法与其他成熟的自动化工具相比——没有图形界面，需要手动测量坐标——但它是我从零开始独立开发的第一个完整应用项目。尽管不够完美，但我在开发过程中收获了许多宝贵的经验。因此，我决定将测试脚本独立出来，打磨成一个成熟的项目。也许它会默默无闻，但对我而言意义非凡：这是我独立完成的第一个面向实际应用的完整项目，具备实际应用价值，而不仅仅是自娱自乐的产物。

]]>