portfolio-manager

核心用法

Portfolio Manager 是一款专为 Alpaca 经纪账户用户设计的投资组合分析技能。它通过 MCP（Model Context Protocol）协议连接 Alpaca API，自动获取用户的实时持仓数据、账户资产和历史交易记录，随后执行六大维度的深度分析：资产配置评估、多元化风险检测、风险指标计算（包括 Beta 系数和最大回撤）、个股头寸深度剖析、业绩归因分析以及再平衡策略生成。

使用该技能时，用户只需授权 Alpaca API 访问权限，系统便会自动拉取完整的投资组合快照。分析引擎会依据现代投资组合理论，对比用户当前持仓与保守型、稳健型、成长型、激进型四类标准资产配置模型，识别超配板块和集中度过高的个股风险。最终输出一份结构化的 Markdown 分析报告，包含具体的买卖建议、税务损失收割机会以及分优先级的行动清单。

显著优点

该技能的最大优势在于数据实时性与分析框架的专业性结合。不同于需要手动录入持仓的传统分析工具，它直接对接 Alpaca 官方 API，确保所有分析基于最新市场数据。其内置的多元化评估体系采用赫芬达尔-赫希曼指数（HHI）量化集中度风险，并提供针对个股、板块、市值、地域四个维度的穿透式分析。

另一个突出特点是可执行的建议输出。系统不仅指出"科技板块占比过高"这类问题，更会给出具体的调仓方案，例如"减持 AAPL 50 股，将科技板块占比从 45% 降至 30%，释放资金增持 XLF 以提升金融板块配置"。同时支持税损收割机会识别、股息收入预测和情景压力测试（牛市/熊市/加息环境）等高级功能。

潜在缺点与局限性

首先，平台依赖性较强。该技能仅支持 Alpaca 经纪商用户，无法直接接入盈透证券、富途、老虎等其他券商账户，非 Alpaca 用户只能通过手动 CSV 导入方式使用，体验大打折扣。

其次，数据来源受限。虽然 Alpaca 提供免费的实盘交易 API，但其市场数据覆盖范围、实时性（部分为延迟报价）以及历史数据深度可能不及专业金融终端。对于期权、加密货币或场外市场交易品种的支撑也存在局限。

此外，分析建议的普适性限制。系统基于标准资产配置理论生成建议，但无法充分考虑用户的个性化税务状况、流动性需求、ESG 偏好或特殊投资限制（如禁投名单）。对于需要复杂衍生品对冲策略或跨账户统一视图（如同时管理 IRA 和 taxable account）的用户，功能尚显不足。

适合的目标群体

本技能最适合使用 Alpaca 平台的 DIY 个人投资者，尤其是持仓数量在 10-50 只之间、希望获得机构级组合分析但不愿支付高昂投顾费用的中高级投资者。对于刚完成初始建仓、需要验证资产配置合理性的新手，以及面临再平衡决策、担心单一股票集中风险的长线价值投资者，该工具能提供清晰的数据支持。

教育场景下，投资学学生或 CFA 考生也可利用该技能将现代投资组合理论（MPT）、资本资产定价模型（CAPM）等抽象概念与实际持仓数据结合，加深对风险分散、Beta 系数、夏普比率等指标的理解。

使用风险与注意事项

API 安全风险是首要考量。用户需要在环境变量中配置 Alpaca API 密钥，尽管该技能采用只读权限设计（仅查询持仓，不执行交易），但若用户设备被植入恶意软件，API 密钥仍存在泄露风险。建议用户定期轮换密钥，并仅授予 "view" 权限而非 "trade" 权限。

数据隐私方面，虽然代码审查确认无数据上报行为，但用户仍需信任 Alpaca 平台的隐私政策。持仓数据、账户净值等敏感信息在传输过程中虽经 HTTPS 加密，但理论上 Alpaca 服务器会留存 API 调用日志。

市场风险提示方面，该工具提供的再平衡建议基于历史数据和当前估值指标，无法预测黑天鹅事件或突发市场崩盘。用户应理解所有建议均为信息参考，不构成投资建议，特别是在高波动市场环境中，机械遵循再平衡信号可能导致频繁交易和摩擦成本上升。