Skip to main content
Glama
Antigravity Soul.md Studio

Antigravity Soul.md Studio

by A16Nights

Soul.md 人设工坊(Antigravity Soul.md Studio)

简体中文 | English

Multi-persona card switcher, workspace persona binding, and layered Markdown file memory (core.md + topics/*.md) for Google Antigravity.

为 Google Antigravity 提供可切换的多人设卡管理、工作区专属人设覆盖、按人设隔离的分层文件记忆,以及内置的 Soul.md 人设工坊 可视化侧栏面板。零外部依赖,纯 Node.js 原生运行。


✨ 核心特性

  • 多人设卡管理与热切换:随时新建、编辑、删除人设卡,一键切换全局默认人设,自动同步到生效规则并在下一轮对话起生效。

  • 工作区专属人设:支持为特定项目目录绑定独立人设卡(写入 <workspace>/.agents/rules/soul-md.md),覆盖全局默认人设;解绑时自动清理管理文件。

  • 分层文件记忆(core.md + topics/*.md):

    • core.md 常驻随当前人设注入上下文(支持字符预算保护);

    • topics/*.md 按主题拆分存放,按需读取全文与关键词搜索;

    • 支持 persona(按人设隔离)与 global(全局共享)两种作用域,并且可为单张人设卡独立关闭记忆开关。

  • 10 个 MCP 工具:让 Agent 在对话中主动读取/演化人设卡与记忆。

  • 可视化人设工坊(Sidecar UI):右侧辅助栏或浏览器全屏直观编辑人设卡、配置工作区绑定和检索分层记忆,支持暗色/亮色主题切换。


Related MCP server: memex

🚀 快速安装

前置要求:Node.js >= 22.0.0。

  1. 克隆仓库到 Antigravity 全局插件目录:

    # macOS / Linux
    git clone https://github.com/A16Nights/antigravity-soul-md.git ~/.gemini/config/plugins/soul-md
    
    # Windows PowerShell
    git clone https://github.com/A16Nights/antigravity-soul-md.git "$env:USERPROFILE\.gemini\config\plugins\soul-md"
  2. 重启 Antigravity(彻底退出托盘后重开)。

  3. 在 Customizations 页面启用 Soul.md 人设工坊,或在对话中点击 [Soul.md 人设工坊](sidecar://soul-md/studio/) 打开面板。


🧭 规则生效优先级

  1. 工作区绑定(<workspace>/.agents/rules/soul-md.md)

  2. 全局默认人设卡(同步自 ~/.gemini/soul-md/cards/<default>.md)

  3. 无默认卡或禁用:自动回退为简洁的专业助手模式


🧰 MCP 工具一览(10 个)

工具名

作用

soul_list

列出所有人设卡、默认卡、工作区绑定与记忆开关状态

soul_read

读取指定或当前默认人设卡的完整 Markdown

soul_update

创建或更新人设卡内容并自动同步生效规则

soul_delete

删除人设卡(保留其历史记忆文件)

soul_switch

切换全局默认卡,或绑定/解绑工作区专属卡

soul_memory_toggle

按人设卡单独开启或关闭长期记忆

memory_read

读取 core.md 或 topics/<topic>.md(留空返回 core + 主题索引)

memory_append

追加带时间戳小节到 core 或指定主题

memory_rewrite

整理并重写记忆文件正文

memory_search

跨 core.md 与所有 topics/*.md 检索关键词


🔒 隐私与自检

  • 人设卡与分层记忆全部以纯文本 Markdown 存储在本地 ~/.gemini/soul-md/,不联网、无遥测。

  • 自检命令:npm test(使用隔离临时目录验证全部功能)。


💡 灵感致谢

本项目为基于 Antigravity 插件协议独立设计与编写的原生实现,功能设计灵感源自:

  • dsh-soul-md —— 多人设卡、工作区覆盖及 core.md + topics/*.md 分层记忆设计

MIT License © 2026 A16Nights

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Provides persistent, searchable structured memory management for AI agents, with keyword matching, bidirectional Zettelkasten sync, and six MCP tools.
      6
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI coding agents to keep persistent, Zettelkasten-style memory by saving and recalling atomic markdown knowledge cards with bidirectional links across sessions. Supports searching, reading, writing, linking, organizing, and git-syncing those cards through a set of MCP tools, with no vector database required.
      9 npm
      ISC
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to search, read, and update persistent workspace knowledge through 22 focused tools, prompts, and resources, using either a hosted endpoint or a self-hosted stdio bridge.
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI coding agents to persistently store, recall, and manage atomic markdown knowledge cards with bidirectional links across sessions. It provides MCP tools for searching, reading, writing, linking, archiving, organizing, and syncing memory via git without a vector database.
      9 npm
      ISC