常见问题

使用门槛

是否需要 Git 经验？

浏览、搜索、下载和安装内容无需执行 Git 命令。

仓库为 Git 仓库时，Synapse 在创建、更新、删除、恢复和永久删除内容时创建普通 Git commit。团队如需审核，可在代码托管平台审核这些提交。

是否需要 AI 或编程基础？

无需。Synapse 管理的是 Rule 和 Skill 内容；实际 AI 交互由安装后的目标编辑器完成。

支持范围

支持范围包含哪些编辑器？

Synapse 目前支持 Cursor、Codex、Claude Code 和 Windsurf。以上编辑器均可安装 Rule 和 Skill。

编辑器安装范围和路径参见 编辑器安装。

支持范围包含哪些操作系统？

安装包通过 GitHub Releases 发布：

系统	安装包
macOS	.dmg
Windows	.exe

本地开发环境要求参见 本地开发。

是否必须使用 Git 仓库？

不强制。仓库可使用本地目录，也可使用 Git 仓库。

本地目录适合个人试用或独立整理。Git 仓库适合团队协作、版本追踪与审核流程。

仓库与项目

仓库与项目的区别

仓库是 Synapse 读取和保存 Rule、Skill 的来源目录。项目是 Rule 或 Skill 的项目级安装目标。

无法查看仓库内容如何处理？

确认 Settings 中配置的是仓库目录，而不是项目目录。仓库目录用于读取 Rule 和 Skill，项目目录用于安装。

使用 Git 仓库时，可同步仓库以拉取远端最新内容。

安装

如何选择 Rule 与 Skill？

仅包含一段文本规则时，使用 Rule。需要模板、示例文件、脚本、配置文件或其他参考资料时，使用 Skill。

全局安装与项目级安装的区别

全局安装写入编辑器的用户目录。项目级安装写入所选项目目录。

项目级安装可从已配置项目中选择，也可在安装时浏览其他目录。

安装按钮不可用的常见原因

安装前将解析目标位置。目标状态可能是可写入、不支持、不可用或冲突。

常见原因包括：当前编辑器组合不支持、缺少编辑器用户目录、项目路径不存在，或 Skill 目标位置已有同名目录需要确认替换。

Cursor 是否支持全局 Rule？

不支持。Synapse 目前未提供固定的 Cursor 全局 Rule 安装位置，因此 Cursor 全局 Rule 显示为”不支持”。

内容

Skill 附件有哪些限制？

Skill 可添加文件或文件夹作为附件，目录结构将被保留。单个附件最大 10 MB。

下载文件包含哪些内容？

Rule 下载为 .md 文件，仅包含 Rule 正文。Skill 下载为 .zip 文件，包含 main.md 主说明文件和全部附件。

已删除内容是否支持恢复？

Rule 和 Skill 删除后进入最近删除，支持恢复或永久删除。

同步

同步包含哪些操作？

非 Git 目录刷新本地内容索引。Git 目录执行 git pull --ff-only --progress。

创建内容后是否立即推送？

创建、更新和恢复先保存并创建提交，随后将推送任务加入待同步队列。

删除和永久删除先将提交加入待同步队列，再尝试推送。