README file from
GithubThought Synapse (Mobile)
(思维突触 - 移动版)
An exclusive, mobile-first ambient decorative plugin for Obsidian. 专为 Obsidian 移动端定制的伴随式艺术组件。
🚨 DESKTOP USERS PLEASE NOTE: Due to UI constraints and performance considerations, the Mobile and Desktop versions use completely different underlying architectures. If you primarily use Obsidian on a PC/Mac, DO NOT download this version. 👉 Please visit and install the exclusive desktop version: Obsidian-Thought-Synapse-Desktop
⚖️ Mobile vs. Desktop: What's the Difference?
- Mobile Version (This Repo): Positioned as an "Ambient Aesthetic Artpiece". Designed exclusively for small screens. Features zero-touch interaction (event penetration to prevent accidental touches), pure Chinese semantic extraction, and silently embeds itself at the bottom of your file tree as a fluid decoration.
- Desktop Version (Thought Synapse): Positioned as a "Hardcore Retrieval Hub". Designed for large screens. Features mouse-hover co-occurrence analysis, click-through contextual tracing, and adaptive split-pane rendering. It's a powerful analytical tool.
✨ Core Aesthetics & Tech
An exclusive, mobile-first ambient decorative plugin designed specifically for Obsidian Mobile (Android & iOS). By bypassing rigid desktop-oriented UI panels, it seamlessly embeds itself at the bottom of your native mobile file explorer, serving as a fluid, auto-rotating visual metaphor for your knowledge vault.
- Native Mobile Embedding: Engineered exclusively for mobile UI constraints. Utilizing a microtask-level Mutation Observer, the galaxy instantly reinstates itself whenever the mobile sidebar re-renders, ensuring a permanent, zero-flicker residence.
- Pure Typographic Extraction: Automatically filters out raw English code variables, digits, and noise symbols. It extracts high-quality, continuous Chinese phrases from your most substantial notes, empowering the compact mobile screen with a pure Eastern typographic aesthetic.
- Shallow DoF & Fluid Auto-Rotation: Replaces manual dragging with natural, constant-velocity auto-rotation to avoid mobile gesture conflicts. The rendering pipeline implements a tight Shallow Depth of Field algorithm—blurring and fading the background sphere to ensure a relaxed and breathable visual experience.
- Perfect Event Penetration: Encapsulated with a native CSS
pointer-events: noneproperty. Your thumb gestures penetrate the galaxy seamlessly, allowing you to scroll the mobile folder list with flawless responsiveness and zero accidental triggers.
📦 Installation Guide
Method 1: Install via BRAT (Recommended)
- Install and enable the Obsidian42 - BRAT plugin from the Community Plugins.
- Open BRAT settings, click
Add Beta plugin. - Paste this repository's URL:
liyaomingme/thought-synapse-mobile. - Enable the plugin in your Community Plugins list.
Method 2: Manual Local Installation
- Go to the Releases page of this repository and download the latest
main.js,manifest.json, andstyles.css. - Inside your vault, navigate to
.obsidian/plugins/and create a new folder namedthought-synapse-mobile. - Move the downloaded files into this new folder.
- Restart Obsidian and enable the plugin in Settings > Community Plugins.
🚨 桌面端用户请注意: 由于移动端的交互限制与性能考量,手机版与桌面版采用了完全不同的底层架构。如果你主要在电脑端(PC/Mac)使用 Obsidian,请勿下载本仓库版本。 👉 请直接点击跳转并安装桌面端专属版本: Obsidian-Thought-Synapse-Desktop
⚖️ 手机版 vs 桌面版:有何区别?
- 移动端 (本仓库): 定位为**“伴随式纯粹美学”**。专为小屏极简设计,摒弃所有手动交互(幽灵触控防误触),纯正中文提纯,以绝对居中的姿态静默悬浮在文件树最下方,作为知识库的呼吸底色。
- 桌面版 (思维突触): 定位为**“硬核知识检索中枢”**。专为大屏设计,支持鼠标悬停共现分析、点击穿透上下文溯源、以及自适应面板切分,是一款强悍的可视化生产力工具。
✨ 核心美学与技术特性
这是一件专为 Obsidian 移动端 (Android & iOS) 深度定制的伴随式艺术组件。它摒弃了传统桌面端插件在手机上水土不服的面板设计,独创性地采用底层 DOM 寄生技术。无需任何点击唤醒,它会像呼吸一样,安静地悬浮在你手机文件列表的最下方,化作一团缓缓流转的“思维星云”。
- 零延时自愈挂载: 彻底解决传统插件在手机端的排版冲突与滚动断层。采用微任务级自愈架构 (Mutation Observer),无论你如何反复呼出手机侧边栏,星系都会 0 延迟、0 闪烁地完美驻留在屏幕左下方。
- 纯净中文提纯: 告别杂乱的英文字母、代码变量与特殊符号。底层扫描引擎会智能锁定你库中体积最大的核心笔记,提纯出极具东方排版美学的纯中文词汇,并以典雅的宋体错落呈现。
- 极浅景深与流体自转: 移除所有手机端滑动阻尼冲突,星系保持绝对匀速的自然流转。引入移动端视觉重心下移矩阵与极浅景深(Shallow Depth of Field)算法,后半球文字深度失焦,四周留白等宽,视觉极度松弛。
- 绝对穿透防误触: 专为小屏幕优化的幽灵触控设计。你的手指可以 100% 完美穿透这片星系,流畅滚动后方冗长的文件列表,绝不产生任何手势粘滞与误触。
📦 安装指南
方法一:通过 BRAT 安装 (强烈推荐)
- 在 Obsidian 的“第三方插件”市场中搜索并安装
Obsidian42 - BRAT,并启用它。 - 打开 BRAT 插件设置,点击
Add Beta plugin按钮。 - 复制并粘贴本仓库的 Github 地址:
liyaomingme/thought-synapse-mobile。 - 添加完成后,回到 Obsidian 的第三方插件列表,找到本插件并开启。
方法二:本地手动安装
- 前往本仓库的 Releases 页面,下载最新版本的
main.js,manifest.json以及styles.css。 - 在你的 Obsidian 笔记库底层目录下,找到
.obsidian/plugins/文件夹。 - 在该目录下新建一个文件夹,命名为
thought-synapse-mobile。 - 将下载好的 3 个文件放入刚才新建的文件夹中。
- 重启 Obsidian 移动端应用,进入设置 -> 第三方插件,找到并开启它。