stock-assistant

Polar Sponsor
爱发电 赞助
.NET 9.0

A股交易辅助工具,实现行情查询、交易记录管理、盈亏分析,支持实时行情查看、持仓与盈亏计算、CSV导入导出。代码路径:D:\aicode\stock-assistant(跨平台)。使用示例:from fetcher import get...

A股交易辅助工具,提供行情查询、交易管理、盈亏分析功能

功能概述

A股交易辅助工具,提供行情查询、交易管理、盈亏分析功能是一项面向实际任务的技能,主要用于项目目录 : D:aicodestock-assistant (Linux/Mac 路径相同);跨平台说明;

核心要点

  • 代码已适配 Windows/Linux/Mac:;
  • Windows: D:aicodestock-assistantdatatrades.db;
  • Linux/Mac:自动使用脚本所在目录的 data/trades。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

炒股助手

A股交易辅助工具,提供行情查询、交易管理、盈亏分析功能。

代码位置

项目目录:D:aicodestock-assistant(Linux/Mac 路径相同)

D:aicodestock-assistant/
├── main.py          # CLI 入口
├── fetcher.py       # A股行情获取
├── trader.py        # 交易管理
├── models.py        # 数据模型
├── db.py            # SQLite 操作
├── requirements.txt # 依赖
└── data/            # 数据库目录

跨平台说明

代码已适配 Windows/Linux/Mac:

  • Windows:D:aicodestock-assistantdatatrades.db
  • Linux/Mac:自动使用脚本所在目录的 data/trades.db

Python import 时路径自动适配,无需手动指定。

快速命令

命令 说明
python main.py quote 600016 查询股票行情(完整数据)
python main.py positions 查看当前持仓
python main.py pnl 600016 查看盈亏(自动获取实时价)
python main.py pnl 600016 --price 4.15 查看盈亏(指定价格)
python main.py list 列出所有交易记录
python main.py list --code 600016 列出指定股票交易记录
python main.py import trades.csv 从CSV导入交易记录
python main.py export --output trades.csv 导出交易记录到CSV
python main.py add --code 600016 --type buy --quantity 1000 --price 3.90 添加买入记录
python main.py add --code 600016 --type sell --quantity 500 --price 4.20 添加卖出记录
python main.py delete 删除指定ID的交易记录
python main.py notify 600016 查询并输出行情(飞书卡片格式)
python main.py notify --codes 600016,000001 查询多只股票
python main.py notify --codes 600016 --webhook https://xxx 推送到飞书群机器人
python main.py notify --codes 600016 --app-id xxx --app-secret xxx --receive-id xxx 推送到飞书私聊

行情查询 API

Python 调用方式

import sys
import os

# 自动适配路径(Windows/Linux/Mac)
script_dir = os.path.dirname(os.path.abspath(__file__))
sys.path.insert(0, script_dir)

from fetcher import get_quote
from trader import StockTrader

# 查询行情 - 返回完整字典数据
quote = get_quote('600016')

# 交易管理(无需指定路径,自动使用脚本所在目录)
trader = StockTrader()

# 返回字段说明:
# {
#     '股票代码': '600016',
#     '股票名称': '民生银行',
#     '当前价格': '3.97',
#     '涨跌额': '0.03',
#     '涨跌幅(%)': '0.76',
#     '今开价': '3.93',
#     '昨收价': '3.94',
#     '最高价': '4.05',
#     '最低价': '3.90',
#     '成交量(手)': '1552322',
#     '成交额(元)': '547876',
#     '换手率(%)': '2.35',
#     '市盈率(动态)': '6.52',
#     '市净率': '0.65',
#     '总市值(亿元)': '1825.63',
#     '流通市值(亿元)': '1523.85',
#     '涨停价': '4.35',
#     '跌停价': '3.55',
#     '买一价': '3.97', '买一量(手)': '10000',
#     '卖一价': '3.98', '卖一量(手)': '20000',
#     ... (买二~买五, 卖二~卖五),
#     '日期时间': '2026-03-14 14:30:00',
#     '_股票代码': 'sh600016',
#     '_市场': 'A股'
# }

返回字段完整列表

字段名 类型 说明 示例
基础信息
股票代码 string A股代码 600016
股票名称 string 上市公司名称 民生银行
_市场 string 市场标识 A股
日期时间 string 数据时间 2026-03-14 14:30:00
价格数据
当前价格 string 最新成交价 3.97
涨跌额 string 涨跌金额 +0.03
涨跌幅(%) string 涨跌幅比例 +0.76%
今开价 string 今日开盘价 3.93
昨收价 string 昨日收盘价 3.94
最高价 string 今日最高价 4.05
最低价 string 今日最低价 3.90
成交数据
成交量(手) string 成交数量(手) 1552322
成交额(元) string 成交金额 547876
换手率(%) string 日换手率 2.35%
财务指标
市盈率(动态) string PE TTM 6.52
市净率 string PB 0.65
总市值(亿元) string 总市值 1825.63
流通市值(亿元) string 流通市值 1523.85
涨跌停
涨停价 string 当日涨停价 4.35
跌停价 string 当日跌停价 3.55
盘口数据(5档)
买一价~买五价 string 买入价位 3.97
买一量~买五量(手) string 买入挂单量 10000
卖一价~卖五价 string 卖出价位 3.98
卖一量~卖五量(手) string 卖出挂单量 20000

CLI 输出格式

$ python main.py quote 600016

【A股行情】
==================================================
股票: 民生银行 (600016)
市场: A股

【价格】
当前价: 3.97
涨跌额: 0.03
涨跌幅: 0.76%

【开盘收盘】
今开: 3.93
昨收: 3.94
最高: 4.05
最低: 3.90

【成交】
成交量: 1552322 手
成交额: 547876 元
换手率: 2.35%

【财务指标】
市盈率(动态): 6.52
市净率: 0.65
总市值: 1825.63 亿元
流通市值: 1523.85 亿元

【涨跌停】
涨停价: 4.35
跌停价: 3.55

【盘口】
买一: 3.97 (10000) → 卖一: 3.98 (20000)
买二: 3.96 (15000) → 卖二: 3.99 (18000)
...

更新时间: 2026-03-14 14:30:00

交易管理 API

import sys
sys.path.insert(0, 'D:\aicode\stock-assistant')
from trader import StockTrader

trader = StockTrader('D:\aicode\stock-assistant\data\trades.db')

# 导入CSV
trader.import_csv('trades.csv')

# 获取持仓
positions = trader.get_positions()

# 计算盈亏
pnl = trader.get_pnl_with_live_price('600016')
print(f"盈亏: {pnl.profit:.2f} ({pnl.profit_pct:.2f}%)")

数据格式

CSV 导入/导出格式

日期,时间,股票代码,股票名称,买卖方向,成交数量,成交均价,成交金额,佣金,其他费用,印花税,过户费
2026-03-14,10:30:00,600016,民生银行,买入,1000,3.90,3900.00,2.73,0.30,0.00,0.04
2026-03-14,14:30:00,600016,民生银行,卖出,500,4.10,2050.00,1.44,0.20,2.05,0.02

字段说明

字段 必填 说明
日期 是 交易日期,格式 YYYY-MM-DD
时间 否 交易时间,格式 HH:MM:SS
股票代码 是 A股代码,如 600016
股票名称 否 股票名称,如 民生银行
买卖方向 是 买入/卖出
成交数量 是 股数
成交均价 是 价格
成交金额 是 数量 × 价格
佣金 否 手续费,默认0
其他费用 否 其他费用,默认0
印花税 否 印花税(卖出收),默认0
过户费 否 过户费,默认0

注意事项

  1. 只支持A股 - 不支持港股、美股
  2. 数据来源 - 腾讯财经(免费接口)
  3. 存储 - SQLite 本地数据库 data/trades.db
  4. 路径 - 所有路径使用 Windows 格式,如 D:aicodestock-assistant

后续更新

项目代码更新后,同步更新此 skill 文档。

更新规则

Skill 文件位置:D:aicodestock-assistantSKILL.md

更新时同步修改:

  • 项目代码更新后
  • 新增功能后
  • 参数变化后

直接编辑这个文件即可,格式是 Markdown。

相关专题

更多
Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

0

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

0

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

0

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

0

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

0

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

0

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习