【免费下载链接】marvin-templateMARVIN is your personal AI assistant that can help you connect to the apps you need and handle your day.项目地址https://gitcode.com/gh_mirrors/mar/marvin-template点击查看免费下载MARVIN 是一个基于 Claude Code 的个人 AI 助手AI Chief of Staff它会记住你的目标、日程与会话上下文。它的核心设计亮点是工作区分离你的个人数据目标、会话记录、周报存放在独立工作区而模板仓库只负责提供命令与功能更新。通过/sync命令拉取模板新功能配合migrate.sh脚本完成数据迁移就能在升级过程中 100% 保护你的数据不被覆盖。本文带你完整走一遍这套机制。为什么要把工作区和模板分开如果你直接用 MARVIN 一段时间很容易遇到这些痛点更新即风险模板仓库不断加入新命令、新 Agent、新集成但模板里也混着你的state/、sessions/、个人配置——直接git pull可能覆盖你的目标文件和密钥备份困难个人数据和模板代码混在一起没法单独把工作区提交到自己的仓库迁移复杂换电脑或升级架构时分不清哪些文件是我的、哪些是官方的。MARVIN 的解法是两个目录各司其职~/marvin/ # 你的工作区个人数据全在这里 ├── CLAUDE.md # 你的个人档案与偏好 ├── .marvin-source # 指回模板目录的指针文件 ├── state/ # 目标与当前优先级 ├── sessions/ # 每日会话日志 └── ... ~/marvin-template/ # 模板在这里获取更新 ├── .marvin/ # 安装脚本与集成 ├── .claude/ # 命令、Agent、技能模板 └── ...一句话总结工作区存放所有个人数据模板只提供更新能力。工作区细节可以在 CLAUDE.md 的 Your Workspace 章节查阅。核心机制.marvin-source 指针文件分离设计的胶水是一个极简的指针文件.marvin-source它只有一行内容——模板目录的绝对路径。安装脚本 .marvin/setup.sh 在创建工作区时写入这个文件迁移脚本 .marvin/migrate.sh 在迁移完成后同样会生成它每次执行/sync时MARVIN 先cat .marvin-source定位模板目录找不到就会提示你手动告知模板位置。这样设计的好处是模板目录放哪里都无所谓哪怕在另一台机器的备份盘里工作区始终能指回模板取更新。/sync 模板更新实战只加新文件永不覆盖你的数据在 MARVIN 里输入/sync它会按.claude/commands/sync.md定义的流程执行一次安全增量同步。第 1 步定位模板读取.marvin-source获取模板路径。如果文件缺失比如你是手动搭建的 MARVINMARVIN 会主动询问你的模板文件夹位置。第 2 步白名单 黑名单双保险同步只针对能力文件个人数据在黑名单中受到绝对保护✅ 允许同步模板能力 永不触碰你的数据.claude/commands/斜杠命令state/目标与当前状态.claude/agents/子 Agentsessions/会话日志.claude/skills/可复用技能reports/周报docs/patterns/架构模式文档content/、meetings/、personal/CLAUDE.md含个人配置.env你的密钥这个黑名单逻辑写在 sync.md 的 Files to NEVER sync 部分值得逐条过一遍确认。第 3 步三态比对NEW / CONFLICT / UNCHANGED对每个命令、Agent、技能与模板版本比对NEW工作区没有 → 待同步的新文件CONFLICT两边都有但内容不同 →保留你的版本因为你可能改过定制逻辑UNCHANGED完全一致 → 跳过。第 4 步确认后应用MARVIN 会先列出可用更新清单例如## Updates Available **New commands:** - /newcommand - Description **Conflicts (your version kept):** - /existingcommand - Template has updates, but keeping yours No changes to your data (goals, sessions, etc.) - those are always safe.你确认后它只复制 NEW 文件从不覆盖已有文件。若某条冲突命令你其实想要模板新版本直接告诉 MARVIN 文件名即可。完成后输入/help就能看到新增的能力。 小技巧日常节奏是/start开场 → 工作中/update打点存档 → 收工/end持久化上下文。会话连续性的真相来源是 state/current.md每次/end和/update都会刷新它——所以/sync之前养成定期存档的习惯数据更安全。数据迁移实战用 migrate.sh 把旧版 MARVIN 搬进新架构如果你是在工作区分离之前安装的 MARVIN个人数据和模板代码混在一起仓库自带迁移脚本 .marvin/migrate.sh无需手动搬文件。一键启动迁移cd marvin-template ./.marvin/migrate.sh脚本全程交互式关键步骤如下确认旧安装位置默认把当前模板目录当作旧 MARVIN 安装可修改路径并校验其中是否存在CLAUDE.md自动盘点你的数据列出发现的state/几个文件、sessions/几条日志、reports/、content/、.env等让你心里有数选择新工作区位置默认~/start可按需指定其他路径若目标已存在会要求你明确确认是否合并执行复制只做拷贝不删除任何旧文件先铺最新的模板文件.claude/命令、Agent、技能与.env.example再覆盖你的个人数据CLAUDE.md、state/、sessions/、reports/、content/、.env自定义扩展不丢遍历你旧有的.claude/commands/、agents/、skills/凡是模板里不存在的即你自己写的全部拷贝过去见 migrate.sh生成.marvin-source指向模板目录新工作区从此可以/sync自动初始化 git 仓库并打上首个提交 Migrate to MARVIN workspace architecture你的工作区从这一刻起有完整版本历史。迁移后验证cd ~/start claude进入后依次检查检查项方法预期目标文件完整让 MARVIN 复述你的年度目标或查看 state/goals.md与旧版一致会话可续接输入/start简报中能看到你的优先级与未完结事项同步通道正常输入/sync能读取.marvin-source并报告无更新集成健康输入/status工作区与集成状态正常一切正常后旧安装目录即可自行清理脚本在结尾也会提醒你Verify everything works, then clean up the old one。常见问题与最佳实践.marvin-source丢了怎么办手动创建该文件并写入模板目录的绝对路径即可/sync依赖它定位模板CLAUDE.md 也建议通过它查找模板路径。我改过的命令会被模板新版本覆盖吗不会。/sync对 CONFLICT 一律保留你的版本想要模板新版明确告诉 MARVIN 即可。换电脑怎么带 MARVIN 走只需迁移两处新工作区目录含.marvin-source 重新 clone 模板仓库git clone https://gitcode.com/gh_mirrors/mar/marvin-template再把.marvin-source里的路径改为新机上的模板位置。想让工作区完全可版本化迁移脚本已帮你git init配合/commit命令可以定期审阅并提交工作区变更.env已被.gitignore排除密钥不会入库。总结MARVIN 的工作区分离设计可以浓缩为三个词分离——工作区存数据、模板存能力用.marvin-source指针关联安全同步——/sync白名单同步 冲突保留你的版本升级零风险无损迁移——migrate.sh只拷贝不删除个人数据与自定义扩展完整搬迁并自带 git 历史。这套数据与能力解耦的思路对任何长期维护的个人知识库或 AI 工作区都有很强的参考价值。建议从 docs/patterns/ 的架构模式文档继续深入 MARVIN 的其他设计细节。赞分享【免费下载链接】marvin-templateMARVIN is your personal AI assistant that can help you connect to the apps you need and handle your day.项目地址https://gitcode.com/gh_mirrors/mar/marvin-template点击查看免费下载相关推荐Warcraft III 增强助手让经典RTS焕发新生的开源工具Warcraft III 增强助手让经典RTS焕发新生的开源工具 还在为《魔兽争霸III》在现代设备上的兼容性问题烦恼吗想让这款经典RTS游戏支持宽屏显示、存储分布式文件系统对象存储云原生Marvin 数据库迁移实战指南基于 Alembic 的 Schema 版本管理与 CLI 操作Marvin 数据库迁移实战指南基于 Alembic 的 Schema 版本管理与 CLI 操作 本文以仓库 migrations/README.md httAI AgentAgent 框架AI 应用StarRocks 跨集群数据迁移工具starrocks-cluster-sync实战指南StarRocks 跨集群数据迁移工具starrocks cluster sync实战指南 StarRocks 社区提供了跨集群数据迁移工具Cross c数据库OLAP数据仓库大数据湖仓一体数据分析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考