@kamuira/stock-analyzer 1.0.3 → 1.0.5

package/README.md

@@ -1,156 +1,240 @@
-# A股/台股综合分析工具
+# @kamuira/stock-analyzer
 
-## 启动方式
+A股/台股综合技术分析工具 — 支持实时分析、历史回测、智能买卖建议
+
+## 功能特性
+
+- 15+ 技术指标综合评分（MA、MACD、RSI、KDJ、布林带、ADX、ATR...）
+- 动态加权评分：根据趋势/震荡市自动调整指标权重
+- 多重信号确认：金叉/死叉需要量能+趋势方向确认，减少假信号
+- 信号连续性判断：区分新信号和已持续信号，避免追高杀低
+- MACD/RSI 顶底背离检测
+- 缺口分析、斐波那契回撤位、动量衰竭检测
+- 形态识别（缩量回踩、放量突破、假突破、锤子线等）
+- 大盘环境过滤（获取上证指数趋势，弱势时降低做多权重）
+- 基于实际支撑/压力位的风险收益比计算
+- 可操作的买入/卖出建议（具体价位、仓位比例、持仓周期）
+- 历史回测验证（500个交易日，统计胜率和平均收益）
+- 支持 A股 + 台股
+- 端口自动重试 + 自动打开浏览器
+
+## 安装
+
+```bash
+# 全局安装
+npm install -g @kamuira/stock-analyzer
+
+# 或直接使用 npx
+npx @kamuira/stock-analyzer
+```
+
+## 使用方式
+
+### Web 界面（推荐）
 
 ```bash
-# 开发模式（自动重启）
+# 启动服务（自动打开浏览器）
+stock-server
+
+# 开发模式（文件变化自动重启）
 node dev.js
+```
 
-# 直接启动
-node server.js
+启动后自动打开浏览器访问 `http://127.0.0.1:3000`，端口被占用会自动 +1 重试。
 
-# CLI 分析
-node analyze.js [股票代码|all]
+### 命令行分析
 
-# 回测
-node backtest.js [股票代码|all]
+```bash
+# 分析单只股票
+stock-analyze sz002049
+stock-analyze 2330        # 台股（4位数字自动识别）
+stock-analyze 紫光国微     # 支持中文名搜索
+
+# 分析所有关注列表
+stock-analyze all
 ```
 
-浏览器访问: http://127.0.0.1:3000
+### 回测验证
+
+```bash
+# 回测单只股票
+stock-backtest sh601138
+
+# 回测所有
+stock-backtest all
+```
 
 ## 支持的输入格式
 
 | 格式 | 示例 | 说明 |
 |------|------|------|
-| 6位数字 | `002049` | 自动识别A股 |
+| 6位数字 | `002049` | 自动识别A股（6开头=上海，其他=深圳） |
 | sh/sz前缀 | `sz002049` | 明确指定A股 |
 | 4位数字 | `2330` | 自动识别台股 |
 | tw前缀 | `tw2330` | 明确指定台股 |
 | 中文名称 | `紫光国微` | 搜索A股 |
 | 拼音缩写 | `zggw` | 搜索A股 |
 
----
+## 技术指标一览
 
-## 常见问题
+| 指标 | 用途 | 参数 |
+|------|------|------|
+| MA (5/10/20/60) | 趋势方向、支撑压力 | 多头/空头排列、金叉死叉 |
+| MACD (12,26,9) | 趋势动能、买卖时机 | 金叉死叉、零轴位置、柱状线 |
+| RSI (14) | 超买超卖 | <30超卖、>70超买 |
+| KDJ (9,3,3) | 短期超买超卖 | J值极端、金叉死叉 |
+| 布林带 (20,2) | 波动区间、变盘信号 | 触轨、带宽收窄 |
+| ADX (14) | 趋势强度 | >25趋势市、<20震荡市 |
+| ATR (14) | 波动率、仓位管理 | 止损距离、仓位建议 |
+| VWAP (20) | 量价均衡位 | 支撑/压力参考 |
 
-### 胜率是如何计算的？
+## 高级分析功能
 
-**触发条件：**
-- 当日综合评分 >= 5 → 记为"买入信号"
-- 当日综合评分 <= -5 → 记为"卖出信号"
-- 中间区域 → "观望"，不计入统计
+### 信号确认机制
 
-**计算公式：**
+每个金叉/死叉信号需要多重确认才给满分：
 
 ```
-买入胜率 = 买入信号发出后N天价格上涨的次数 / 买入信号总次数 × 100%
-平均收益 = 所有买入信号N天后涨跌幅之和 / 买入信号总次数
+确认因素：量能放大 + 趋势方向一致 + 价格位置合理
+- 3项确认 → 满分（强信号）
+- 2项确认 → 7折
+- 1项确认 → 5折
+- 0项确认 → 仅给基础分（可能是假信号）
 ```
 
-**具体流程：**
-1. 取500个交易日（约2年）历史数据
-2. 从第60天开始，逐日计算综合评分
-3. 某天评分>=5，记录当天收盘价为"入场价"
-4. 分别看 3天、5天、10天 后的收盘价
-5. 后续收盘价 > 入场价 → 算"赢"，否则算"输"
-
-**举例：**
-紫光国微在250个交易日中，有75次触发买入信号（评分>=5），其中5天后价格上涨的有41次：
-- 胜率 = 41/75 = 55.4%
-- 平均收益 = 所有75次的5日涨跌幅平均值 = +0.46%
-
-**当前局限性：**
-- 每天独立判断，连续信号不去重（如连续5天都是买入信号，会算5次独立交易）
-- 未模拟实际仓位管理和交易手续费
-- 未考虑止损提前退出的情况
-- 固定持有N天后退出，不考虑中途信号变化
-
----
+### 动态加权评分
 
-### 综合评分是怎么算的？
+根据 ADX 判断市场状态，自动切换权重：
 
-评分由多个技术指标加权求和，根据市场状态（趋势/震荡）动态调整权重：
+- **趋势市 (ADX>=25)**：加大 MA、MACD、ADX 权重，降低 RSI、KDJ 权重
+- **震荡市 (ADX<20)**：加大 RSI、KDJ、布林带权重，降低趋势指标权重
+- **ADX<15 极度震荡**：所有信号打 4 折（几乎无效）
 
-**趋势市（ADX>=25）权重：**
-- 均线(×1.5) + MACD(×1.3) + ADX(×1.5) + RSI(×0.7) + KDJ(×0.7) + 布林(×0.8) + 量价(×1.0) + 趋势(×1.3) + 背离(×1.2) + 形态(×1.0) + 动量(×1.2) + 缺口(×0.8)
+### 趋势一致性检查
 
-**震荡市（ADX<25）权重：**
-- 均线(×0.8) + MACD(×0.8) + ADX(×0.8) + RSI(×1.5) + KDJ(×1.5) + 布林(×1.5) + 量价(×1.0) + 趋势(×0.8) + 背离(×1.3) + 形态(×1.2) + 动量(×1.0) + 缺口(×1.0)
+```
+短期(5日) + 中期(20日) + 长期(60日) 方向一致 → +3分
+短期和中期方向矛盾 → 信号打8折
+```
 
-**额外修正：**
-- 趋势一致性：短/中/长期方向一致 +3分，矛盾则打8折
-- ADX<20 震荡市：所有信号打6折
-- 低波动股（ATR<1.5%）：信号打7折
-- 量能确认：放量看多加成15%，缩量看多打8折
-- 大盘环境：上证偏强+1.5，偏弱-1.5且正分打7折
+### 大盘环境过滤
 
-**信号分级：**
-| 评分 | 信号 |
-|------|------|
-| >= 10 | 强烈买入 |
-| >= 5 | 建议买入 |
-| >= 1 | 谨慎买入 |
-| >= -4 | 观望 |
-| >= -9 | 建议卖出 |
-| < -9 | 强烈卖出 |
+自动获取上证指数趋势：
+- 大盘偏强 → 整体 +1.5 分
+- 大盘偏弱 → 整体 -1.5 分，且正分打 7 折
 
 ---
 
-### 风险收益比怎么算的？
+## 评分体系
+
+### 信号分级
+
+| 评分 | 信号 | 建议操作 |
+|------|------|----------|
+| >= 10 | 强烈买入 | 积极建仓，持仓5-10天 |
+| >= 5 | 建议买入 | 适量买入，持仓3-5天 |
+| >= 1 | 谨慎买入 | 小仓位试探，持仓1-3天 |
+| >= -4 | 观望 | 不操作，等待方向 |
+| >= -9 | 建议卖出 | 减仓或观望 |
+| < -9 | 强烈卖出 | 清仓回避 |
+
+### 买入条件逻辑
 
-不是机械地用ATR倍数，而是基于实际支撑/压力位：
+根据评分高低给出不同激进程度的入场建议：
+
+| 评分区间 | 入场策略 |
+|----------|----------|
+| >= 5（强势） | 当前价附近或日内回调半个ATR入场 + 分批建仓方案 |
+| 1-4（偏多） | 等回调2-3%后出现止跌信号再买 |
+| < 1（中性/偏空） | 等布林下轨抄底或站回MA20 |
+
+### 风险收益比
 
-**止损位（取最近的下方支撑）：**
+基于实际支撑/压力位计算（非机械ATR倍数）：
+
+**止损位选取（最近的下方支撑）：**
 - MA20（如果在下方）
 - 布林下轨
 - 近20日最低价
 - ATR止损（兜底）
 
-**止盈位（取上方有意义的压力位，排除<2%的）：**
+**止盈位选取（上方有意义的压力位，排除距离<2%的）：**
 - 近20日最高价
 - 布林上轨
 - 斐波那契回撤位
 - ATR目标（补充）
 
-**公式：**
 ```
 风险收益比 = (止盈位 - 当前价) / (当前价 - 止损位)
-```
 
-- 比值 >= 2.0 → 提示"入场性价比高"
-- 比值 < 1.0 → 提示"建议等回调再入场"
+>= 2.0 → "入场性价比高"
+< 1.0  → "建议等回调再入场"
+```
 
 ---
 
-### 什么类型的股票适合本系统？
+## 回测验证
+
+### 胜率计算方法
+
+**触发条件：**
+- 当日综合评分 >= 5 → 记为"买入信号"
+- 当日综合评分 <= -5 → 记为"卖出信号"
+- 中间区域 → "观望"，不计入统计
 
-基于26只股票的回测验证：
+**计算公式：**
+```
+买入胜率 = 信号发出后N天价格上涨的次数 / 买入信号总次数 × 100%
+平均收益 = 所有买入信号N天后涨跌幅之和 / 买入信号总次数
+```
 
-**适合（胜率55%+）：**
-- 科技成长股（兆易创新、台积电、中芯国际、立讯精密）
-- 有色金属/新材料（湖南白银、宏和科技、紫金矿业）
-- 高弹性趋势股（阳光电源、联发科、德明利）
-- 共同特征：波动率适中(ATR 2-6%)、趋势性强(ADX经常>25)、成交活跃
+**流程：**
+1. 取500个交易日（约2年）历史数据
+2. 从第60天开始逐日计算综合评分
+3. 评分>=5时记录收盘价为入场价
+4. 分别统计 3天、5天、10天 后的涨跌
 
-**不适合（胜率<45%）：**
+**评级标准（取3/5/10日最佳表现）：**
+| 评级 | 条件 |
+|------|------|
+| 优秀 | 最佳胜率 >= 65% 且均收益 > 2% |
+| 良好 | 最佳胜率 >= 58% 且均收益 > 1% |
+| 一般 | 最佳胜率 >= 55%，或胜率>=50%且均收益>0.5% |
+| 较差 | 以上都不满足 |
+
+### 回测结果（26只股票验证）
+
+**适合本系统（胜率55%+）：**
+| 股票 | 5日胜率 | 5日均收益 | 类型 |
+|------|---------|-----------|------|
+| 兆易创新 | 68.5% | +5.50% | 半导体 |
+| 台积电 | 66.1% | +1.93% | 半导体 |
+| 阳光电源 | 64.5% | +4.82% | 新能源 |
+| 立讯精密 | 64.1% | +4.03% | 消费电子 |
+| 湖南白银 | 64.1% | +6.82% | 有色金属 |
+| 宏和科技 | 63.1% | +7.61% | 新材料 |
+| 工业富联 | 60.0% | +3.83% | AI/科技 |
+| 中芯国际 | 59.7% | +3.27% | 半导体 |
+| 紫金矿业 | 59.6% | +2.14% | 资源 |
+
+**不适合本系统（胜率<45%）：**
 - 银行股（招商银行、平安银行）— 低波动，政策驱动
 - 白酒消费（茅台、五粮液）— 基本面下行时技术面失效
 - 公用事业（核电、长江电力）— 波动太小
 - 券商（中信建投）— 脉冲式行情，趋势不持续
 
----
-
-### 买入条件的逻辑？
+**结论：** 本系统最适合波动率适中(ATR 2-6%)、趋势性强(ADX经常>25)、成交活跃的科技/成长/有色金属类股票。
 
-根据评分高低给出不同激进程度的入场建议：
+### 当前局限性
 
-- **评分>=5（强势）**：给出当前价附近或日内回调半个ATR的入场价 + 分批建仓方案
-- **评分1-4（偏多）**：建议等回调2-3%后出现止跌信号再买
-- **评分<1（中性/偏空）**：给出布林下轨抄底或等站回MA20的条件
+- 每天独立判断，连续信号不去重
+- 未模拟实际仓位管理和交易手续费
+- 未考虑止损提前退出
+- 固定持有N天后退出，不考虑中途信号变化
 
 ---
 
-### 数据来源
+## 数据来源
 
 | 数据 | A股来源 | 台股来源 |
 |------|---------|---------|
@@ -159,8 +243,57 @@ node backtest.js [股票代码|all]
 | 股票搜索 | 腾讯智能搜索 (smartbox.gtimg.cn) | — |
 | 大盘指数 | 腾讯财经 (上证000001) | — |
 
+## 项目结构
+
+```
+├── server.js        # Web 服务主程序（含所有分析逻辑）
+├── analyze.js       # CLI 分析工具
+├── backtest.js      # 回测验证工具
+├── dev.js           # 开发模式（文件变化自动重启）
+├── stock.js         # 数据获取工具
+├── index.html       # 前端页面
+├── package.json     # npm 包配置
+├── README.md        # 本文件
+└── bin/
+    ├── analyze.js   # CLI 入口: stock-analyze
+    ├── server.js    # 服务入口: stock-server
+    └── backtest.js  # 回测入口: stock-backtest
+```
+
+## 环境要求
+
+- Node.js >= 14.0.0
+- 无需安装任何第三方依赖（纯原生 Node.js 实现）
+- 需要网络连接（获取实时/历史数据）
+
+## 更新日志
+
+### v1.0.3
+- 修复 README 在 npm 页面不显示的问题
+
+### v1.0.2
+- 修复 ADX 阈值逻辑 bug
+- 修复 yesterdayClose 除零风险
+- 修复前端 XSS 和 null guard
+- 修复 localStorage 异常处理
+
+### v1.0.1
+- 修复 bin 脚本路径
+
+### v1.0.0
+- 初始发布
+- 15+ 技术指标综合分析
+- 动态加权评分 + 多重信号确认
+- 历史回测验证
+- A股 + 台股支持
+- Web 界面 + CLI 工具
+
 ---
 
 ## 免责声明
 
-本工具仅基于技术面指标进行分析，不构成任何投资建议。投资有风险，入市需谨慎。
+本工具仅基于技术面指标进行分析，不构成任何投资建议。技术分析有其固有局限性，无法预测突发事件、政策变化、基本面恶化等因素。投资有风险，入市需谨慎。使用本工具产生的任何投资损失，作者不承担任何责任。
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kamuira/stock-analyzer",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "A股/台股综合技术分析工具 - 支持实时分析、回测验证、买卖建议",
   "main": "server.js",
   "bin": {

package/server.js

@@ -1691,9 +1691,32 @@ const server = http.createServer(async (req, res) => {
   res.end('Not Found');
 });
 
-server.listen(PORT, () => {
-  console.log(`\n${'='.repeat(50)}`);
-  console.log(`  A股综合分析工具`);
-  console.log(`  打开浏览器访问: http://127.0.0.1:${PORT}`);
-  console.log(`${'='.repeat(50)}\n`);
-});
+// 自动打开浏览器
+function openBrowser(url) {
+  const { exec } = require('child_process');
+  const platform = process.platform;
+  if (platform === 'win32') exec(`start ${url}`);
+  else if (platform === 'darwin') exec(`open ${url}`);
+  else exec(`xdg-open ${url}`);
+}
+
+// 端口占用自动重试
+function startServer(port) {
+  server.listen(port, () => {
+    console.log(`\n${'='.repeat(50)}`);
+    console.log(`  A股综合分析工具`);
+    console.log(`  打开浏览器访问: http://127.0.0.1:${port}`);
+    console.log(`${'='.repeat(50)}\n`);
+    openBrowser(`http://127.0.0.1:${port}`);
+  });
+  server.on('error', (err) => {
+    if (err.code === 'EADDRINUSE') {
+      console.log(`端口 ${port} 被占用，尝试 ${port + 1}...`);
+      startServer(port + 1);
+    } else {
+      console.error('服务启动失败:', err.message);
+    }
+  });
+}
+
+startServer(PORT);