portfolio-analysis v3.0.0 优化成果报告

📋技能简介

portfolio-analysis 是一款面向 A 股客户的持仓深度分析工具，用户通过自然语言描述持仓（股票名称、持股数量、成本价格）即可自动从通联 MCP、华泰 MCP、华泰证券技能包、妙想/财联社等多个数据源按优先级采集信息，最终输出双格式报告：深蓝主题的单文件自包含 HTML 仪表板和 A4 纵向 PDF 归档文件。HTML 报告内嵌 Chart.js 四级 CDN 回退图表，覆盖持仓总览、个股深度分析、行业对比、资金面、技术面（自含 EMA/MACD/RSI/BOLL/OBV/ADX 七项指标 + 17 种 K 线形态识别的双引擎系统）、热点板块轮动、可持续性评估、全市场资金面、组合画像、核心持仓九维拆解、风险矩阵和三层决策调仓建议表，最终形成“数据证据 → 交叉验证 → 组合影响 → 调仓动作”的完整分析链。

🎯使用场景

持仓诊断 — “分析我的持仓”，自动拉取全部持仓的行情、财务、估值、技术面数据，一键出完整报告

调仓决策 — “帮我看看要不要调仓”，基于三层决策框架（方向层 + 时点层 + 闸门层）给出逐股建议动作和触发条件

定期复盘 — “更新报告”或“刷新持仓”，沿用已有持仓快速重跑行情数据，对比历史变化

风险排查 — “我的持仓有什么风险”，自动计算行业集中度、估值泡沫、盈利能力分化、资金面异动等风险维度

热点匹配 — “我的持仓跟当前热点关系怎样”，对比市场热点板块涨幅排行，评估持仓覆盖度和可持续性

投顾输出 — 生成 PDF 归档报告，带数据来源声明和风险揭示，可直接交付客户

分析我的持仓生成持仓报告组合分析更新报告刷新持仓投顾风险评估

🚀迭代效果 · v2.5.0 → v3.0.0

自包含

技术引擎（原依赖 2 个不存在技能）

-60%

SKILL.md 体积精简（20KB→8KB）

+22

CSS 类名补齐 + 变量声明

跨平台

Win→macOS 路径 + grep 替代 PowerShell

17 项

K 线形态自含识别

对比维度

v2.5.0

v3.0.0

技术面脚本

依赖 2 个不存在技能，100% 崩溃

自包含实现，端到端验证通过

技术指标

假数据（写死默认值）

EMA/MACD/RSI/BOLL/OBV/ADX 真实计算

K 线形态

空列表（无实际检测）

锤子线/吞没/三白兵等 17 种形态识别

PDF 路径

C:\Users\98322\... (仅 Windows)

~/.workbuddy/skills/ (全平台)

验证命令

Select-String (PowerShell)

grep (跨平台 bash)

CSS 类名覆盖

约 40% 需求类名缺失

22 个类名全部实现

JS 变量声明

0 个占位变量

13 个必存变量预声明

Chart.js 加载

单一 CDN

四级 CDN 回退 + 自恢复

图表 ID

portfolioPie / sectorBar (错误)

pieChart / industryChart (规范)

SKILL.md

20KB，冗长执行说明书

8KB，精炼可执行流程

新增/修复的 CSS 类名（18 个）

badge-veto

alert-major

alert-muted

dim-header

flow-item

tech-grid

tech-item

ranklist-badge

fact-box

view-box

moat-deep

moat-mid

moat-shallow

moat-none

emotion-card

outlook-section

report-ref

capital-flow-box

source-footer

✅测试验证结果

测试项	结果	验证内容
Python 编译	通过	run_technical_signals.py 无语法错误
引擎运行（3 只 × 60 天）	通过	EMA/RSI/ADX/BOLL/OBV/MACD 全部正常
K 线形态识别	通过	17 种形态检测，十字星/三白兵/锤子线等
命令行模式	通过	--input / --output 参数正常
编码完整性	通过	SKILL.md 0 处 U+FFFD 乱码
JS 语法	通过	node --check 24,366 字符无错误
图表 ID（9 个）	通过	pieChart/industryChart/hotChart 等
CSS 类名（22 个）	通过	全部 SKILL.md 要求类名存在
全流程端到端（4 只真实持仓）	通过	数据→分析→计算→建议→模板完整链路

📦交付物清单

40 KB

压缩包大小

11

内含文件数

1

Python 自包含脚本

2

HTML 模板文件

3

元数据文件

压缩包路径：/Users/jintian/WorkBuddy/2026-07-31-09-50-05/portfolio-analysis-v3.0.0.zip
安装方式：解压后将 portfolio-analysis/ 放入 ~/.workbuddy/skills/ 即可