核心用法
investment-portfolio 是一款基于 Bash + Python3 的纯本地投资组合管理工具，通过命令行脚本实现对股票、加密货币等多元资产的完整生命周期管理。用户通过 add 命令录入持仓（代码、数量、买入价），使用 update 同步最新市价后，即可调用 summary、performance、allocation 等指令生成投资组合的总览、盈亏分析与资产配置图表。工具支持 dca 定投计算、dividend 股息收益率分析、risk 风险评估（标准差与分散度评分）、以及 rebalance 目标仓位再平衡建议，满足从日常记账到深度分析的完整需求。所有数据以 JSONL 格式存储于本地 ~/.investment-portfolio/ 目录，可通过 export 导出 CSV 或查看 history 交易日志。
显著优点
极致隐私安全：零网络通信设计是该技能最大亮点，所有价格数据均需手动输入，彻底杜绝 API 密钥泄露、第三方数据截获或服务端故障风险，适合对财务隐私极度敏感的用户。功能完整闭环：覆盖持仓管理、盈亏追踪、资产配置可视化（ASCII 图表）、风险计量、定投模拟、股息计算、行业分布分析等 15+ 核心功能，无需借助外部工具即可完成专业级分析。轻量零依赖：仅依赖系统原生 Bash 4.0+ 与 Python3，无第三方 pip 包，部署成本极低，甚至可在离线环境运行。透明可控：MIT-0 开源协议允许自由修改，数据结构采用人类可读的 JSONL 与明文日志，便于审计、备份或与自定义脚本集成。
潜在缺点与局限性
手动维护成本高：缺乏实时行情接入意味着用户需自行追踪市场价格并频繁执行 update，对高频交易者或持有大量仓位的用户效率较低。功能深度有限：风险计算仅提供标准差与分散度评分，缺乏 VaR、最大回撤、夏普比率等专业金融指标；行业分类依赖内置映射表，对冷门标的或新兴市场覆盖不足。用户体验门槛：纯命令行交互对非技术背景投资者不够友好，无图形界面或移动端支持，数据可视化仅限 ASCII 字符图表。数据持久化风险：明文 JSONL 存储虽便于调试，但在共享设备或权限配置不当场景下存在敏感信息泄露隐患，且缺乏自动备份机制。
适合的目标群体
- 隐私优先型投资者：不愿将持仓数据托管至券商 App 或第三方金融平台的敏感用户
- 技术型个人理财者：熟悉命令行操作、希望用脚本自动化管理多账户投资组合的开发者或工程师
- 长期定投与再平衡策略执行者：需要定期分析资产配置偏离度并生成调仓建议的被动投资者
- 离线场景使用者：网络受限环境（如企业内部、跨境旅行）下的应急资产管理需求
使用风险
性能瓶颈：大规模持仓（数百条以上）时，JSONL 的逐行解析效率低于专业数据库，历史数据查询与复杂计算可能出现延迟。数据一致性依赖人工：价格更新与交易记录的准确性完全取决于用户输入，无外部校验机制，误操作可能导致分析结果失真。权限管理疏漏：默认数据目录未强制设置 chmod 700 限制，多用户系统下需手动加固文件权限。文档路径不一致：SKILL.md 声明的默认路径 ~/.local/share/investment-portfolio/ 与实际脚本使用的 ~/.investment-portfolio/ 存在差异，配置环境变量 PORTFOLIO_DIR 时需注意确认。无版本回滚能力：remove 与 update 操作直接修改数据文件，误删或错误更新后需依赖手动备份恢复。