用途：为 Finance Guru 创建本地私有实例，把私密配置与财务文件放在公共引擎仓库之外，并完成首次本地数据读取。
主要能力：从插件根目录运行初始化器，生成实例目录结构；初始化仅本地 git 历史、创建 uv 环境，并把 Claude Code 与 Codex 链接到插件统一的 .claude 技能树。初始化是收敛式的，会保留已有文件。
使用方式：先确认 ${CLAUDE_PLUGIN_ROOT} 已设置并指向已安装的 Finance Guru 插件，否则停止并提示用户先在 Claude Code 中安装并调用 finance-guru@finance-guru。随后选择专用绝对路径作为实例根目录，不要用共享、云同步或引擎仓库目录。运行： ( cd "${CLAUDE_PLUGIN_ROOT}" uv run python -m src.cli.instance_init "<instance-root>" --repo "${CLAUDE_PLUGIN_ROOT}" ) 然后逐项填写 <instance-root>/user-profile.yaml 的空字段，至少确认目标、时间跨度、风险承受度、流动性需求、账户类型与工作流偏好，保留已有键值。接着询问券商导出 CSV 路径，仅查看表头识别导出类型，并复制原文件： cp "<broker-export.csv>" "<instance-root>/imports/" 之后从实例目录启动会话： cd "<instance-root>" claude Codex 使用相同起始目录，并通过 <instance-root>/.agents/skills/ 发现技能。最后在实例目录运行首次读取： uv run python -m src.integrations.refresh_all --show
适用场景：首次搭建私有 Finance Guru 实例、导入券商 CSV、查看本地快照。
限制：CSV 是首小时入门路径且保持本地；SnapTrade 与 SimpleFIN 为可选自带凭据集成，完成入门不要求二者。在受支持 CSV 工作流导入记录或配置可选实时凭据前，空快照属预期。命令失败时应展示确切错误并停止，不得暗示刷新成功。不要回显 CSV 文件名、画像值或 CSV 行。仅用于教育目的，不构成投资建议；财务数据可能不完整或不准确，存在本金损失可能，行动前请咨询持牌财务、税务与法律专业人士。