核心用法
Portfolio 是一款专为投资者设计的本地化投资组合管理 Skill。用户通过命令行交互完成全流程操作:add 命令记录买入交易,支持自动计算加权平均成本;remove 命令处理卖出,支持部分或全部清仓;list 以表格/JSON/CSV 格式展示持仓;analyze 按标的或行业维度分析配置权重;rebalance 根据目标配比生成买卖建议;performance 计算多周期收益率。所有数据以 JSON 格式存储于 ~/.portfolio/ 目录,首次使用自动初始化。
显著优点
极致隐私安全:完全离线运行,无 API 调用、无第三方依赖、无网络传输,从根本上杜绝数据外泄与供应链攻击。零环境负担:仅依赖 Bash 4.0+ 与 Python 3 标准库,无需 pip/npm 安装,任何 Unix-like 环境即开即用。功能完整闭环:覆盖从交易记录、持仓分析、再平衡到收益计算的投资管理全链路,加权平均成本计算与多格式输出满足专业场景。行为可审计:源码透明,MIT-0 许可证允许自由审查与修改,符合金融监管合规要求下的可解释性需求。
潜在缺点与局限性
无实时行情:缺乏市场价格自动获取能力,当前市值需用户手动维护或外部导入。单用户架构:基于本地文件锁定的存储模式,不支持多用户协作或云端同步。功能深度有限:未覆盖期权、期货等衍生品,不支持分红再投资、税务成本分离等高级会计处理。交互门槛:纯 CLI 界面要求用户具备命令行基础,对非技术投资者不够友好。T3 来源风险:个人开发者维护,长期更新稳定性与商业支持保障弱于企业级产品。
适合的目标群体
- 注重隐私的独立投资者,不愿将持仓数据托管于第三方平台
- 技术背景用户,偏好可脚本化、可版本控制的投资管理流程
- 合规敏感场景(如金融从业者),需要可审计、无外部依赖的工具
- 极简主义者,追求零配置、零维护成本的本地化方案
常规使用风险
数据丢失风险:本地 JSON 存储无自动备份机制,需用户自行制定备份策略。输入错误风险:价格与数量参数无严格数值校验,错误输入可能导致成本计算偏差。版本漂移风险:T3 来源意味着更新节奏不确定,建议锁定版本使用并审查变更。无实时验证:再平衡建议基于用户输入的当前价格,若价格滞后可能导致决策失误。