意图是新的源代码

将你的 AI 开发对话转化为可搜索、可共享的知识。

再也不会丢失任何精彩的解决方案、代码片段或架构决策了。SpecStory 会捕获、索引并使你在所有项目和工具中与 AI 编码助手的每一次互动都可被搜索。

安装 SpecStory ──▶  

参与开源项目 ──▶ 

联系我们 ───▶ 

🔧 Agent Skills - 安装技能以生成会话摘要、获取项目统计信息、整理历史记录等

工作原理

AI 编码工具              本地优先                  云平台
─────────────────           ─────────────                ─────────────────
                                                          （需登录）
Cursor IDE         ┐
Copilot IDE        │
Claude Code CLI    │
Cursor CLI         ├──────►  .specstory/history/  ──────►  cloud.specstory.com
Codex CLI          │          （自动本地保存）        （搜索、提问与分享）
Droid CLI          │
Gemini CLI         ┘

工作流程

1. 捕获 - 扩展程序会将每次 AI 交互本地保存到 .specstory/history/
2. 处理 - 使用 Agent Skills 从你的历史记录中生成摘要、统计数据和见解
3. 同步（可选） - 仅在登录状态下，会话才会同步到云端
4. 搜索 - 在本地或云端跨所有项目查找对话
5. 分享 - 导出并与团队分享特定的解决方案

支持的开发工具

SpecStory 可无缝集成到你喜爱的 AI 编码工具中，自动将所有对话本地保存到项目中的 .specstory/history/ 文件夹。一切均采用本地优先策略——除非你选择同步到云端，否则你的数据始终保留在本地设备上。

安装

产品	类型	来源	支持的代理	最低版本	安装	更改日志
Cursor 扩展	IDE	封闭	Cursor AI	v0.43.6+	在扩展中搜索“SpecStory”（Cmd/Ctrl+Shift+X）→ 安装	📋 查看
VSC Copilot 扩展	IDE	封闭	GitHub Copilot	v1.300.0+	在扩展中搜索“SpecStory”（Cmd/Ctrl+Shift+X）→ 安装	📋 查看
SpecStory CLI	CLI	开放	Claude Code	v1.0.27+	brew tap specstoryai/tap brew install specstory	📋 查看
SpecStory CLI	CLI	开放	Codex CLI	v0.42.0+	brew tap specstoryai/tap brew install specstory	📋 查看
SpecStory CLI	CLI	开放	Cursor CLI	v2025.09.18+	brew tap specstoryai/tap brew install specstory	📋 查看
SpecStory CLI	CLI	开放	Droid CLI	v0.56.3+	brew tap specstoryai/tap brew install specstory	📋 查看
SpecStory CLI	CLI	开放	Gemini CLI	0.15.1+	brew tap specstoryai/tap brew install specstory	📋 查看

[!注意] 对于 Cursor 用户：请从 Cursor 内部安装，而不是从 Visual Studio Marketplace 网站安装。了解原因

CLI 工具

一次安装即可适用于所有 CLI 工具——Claude Code、Cursor CLI 和 Codex：

# 检查已安装哪些代理
specstory check

# 启动您偏好的代理并自动保存
specstory run claude    # 启动 Claude Code
specstory run cursor    # 启动 Cursor CLI
specstory run codex     # 启动 Codex CLI
specstory run droid     # 启动 Droid CLI
specstory run gemini    # 启动 Gemini CLI
specstory run           # 启动默认代理

所有会话都会自动保存到您当前项目的 .specstory/history/ 目录中。

[!提示] SpecStory CLI 是一个封装工具，可为任何终端代理提供自动会话保存功能。您只需安装相应的代理（例如 Claude Code），SpecStory 即可与其配合使用。

SpecStory 云 ☁️

SpecStory 云 可将您本地的 AI 对话转化为强大的集中式知识系统。

我们解决的问题

• 上下文丢失：关键决策和解决方案分散在不同设备和项目中
• 无法全局搜索：很难找到上个月的那个完美解决方案
• 分享不便：传递 Markdown 文件的方式难以扩展

解决方案

SpecStory 云为您打造个人 AI 编程知识库：

• 🔍 随处搜索：通过网页界面实现跨所有项目的全文搜索。RAG 功能即将推出。
• 🎯 明确选择加入：未经注册并登录，不会有任何数据同步到云端。
• 📚 按项目组织：根据仓库和时间自动分类。
• 🚀 API 访问：支持程序化同步和搜索，便于自动化操作。
• 👥 团队功能：即将推出——可在整个组织内共享知识。

开始使用 SpecStory 云 →

如何同步到云端

方法	一次性设置	实时会话	历史会话
SpecStory CLI	specstory login	登录后使用 specstory run 时自动推送	使用 specstory sync 推送现有的本地会话
Cursor 扩展	命令面板 → “SpecStory: 打开云同步配置”	在设置中配置自动同步	使用命令面板中的同步命令
VSCode 扩展	命令面板 → “SpecStory: 打开云同步配置”	在设置中配置自动同步	使用命令面板中的同步命令

[!重要] 本地优先且默认私密：所有会话均会本地保存到 .specstory/history/ 目录中。除非您明确登录，否则绝不会发送任何数据到云端。即使登录后，您也可以控制要同步的内容。

文档与支持

• 📚 完整文档 - 全面指南和云 API 参考文档
• 🔧 Agent Skills - 从你的 .specstory/history 中生成摘要、统计数据和洞察
• 🐛 提交问题 - 我们会积极监控并及时响应
• 📖 参与文档贡献 - 欢迎提交 PR！

评价与反馈

喜欢 SpecStory 吗？请留下评价，帮助更多人发现这款能提升 AI 编码记忆的工具吧！🧠

星标历史

SpecStory 快速上手指南

SpecStory 是一款将您与 AI 编程助手（如 Cursor、Claude Code、Copilot 等）的对话转化为可搜索、可共享知识库的工具。它默认采用“本地优先”策略，自动保存所有交互记录。

环境准备

• 操作系统: macOS, Linux, Windows (通过 WSL 或 PowerShell)
• 前置依赖:
  • 已安装至少一种支持的 AI 编程工具（见下表）。
  • CLI 用户: 需安装 Homebrew (macOS/Linux) 或直接下载二进制文件 (Windows)。
  • IDE 用户: 需安装 Cursor IDE 或 VS Code (配合 GitHub Copilot)。

支持的工具及最低版本要求：

工具类型	支持产品	最低版本要求
IDE 插件	Cursor	v0.43.6+
	VS Code (GitHub Copilot)	v1.300.0+
命令行 (CLI)	Claude Code	v1.0.27+
	Codex CLI	v0.42.0+
	Cursor CLI	v2025.09.18+
	Droid CLI	v0.56.3+
	Gemini CLI	v0.15.1+

安装步骤

根据您的使用场景选择以下一种安装方式：

方案 A：IDE 插件安装 (Cursor / VS Code)

1. 打开 Cursor 或 VS Code。
2. 按下 Cmd/Ctrl + Shift + X 打开扩展面板。
3. 搜索 SpecStory。
4. 点击 Install 安装。

   注意: Cursor 用户请务必在编辑器内部安装，不要通过 Visual Studio Marketplace 网页版安装。

方案 B：命令行工具安装 (适用于 Claude Code, Codex, Cursor CLI 等)

只需安装一次 SpecStory CLI，即可适配所有支持的终端 AI 代理。

macOS / Linux (推荐):

brew tap specstoryai/tap
brew install specstory

验证安装:

specstory check

基本使用

1. 开始记录会话 (CLI 用户)

使用 specstory run 命令启动您的 AI 代理，所有对话将自动保存到当前项目目录下的 .specstory/history/ 文件夹中。

# 启动 Claude Code
specstory run claude

# 启动 Cursor CLI
specstory run cursor

# 启动 Codex CLI
specstory run codex

# 启动默认配置的代理
specstory run

2. 开始记录会话 (IDE 用户)

安装插件后无需额外配置。直接在 Cursor 或 VS Code 中与 AI 进行对话，插件会自动在后台捕获并保存历史记录到本地 .specstory/history/。

3. 查看与管理历史

所有会话均以本地文件形式存储。您可以直接使用 Agent Skills 生成摘要或统计信息，或者手动浏览 .specstory/history/ 目录。

4. (可选) 同步到云端

如果您需要在多设备间搜索或共享知识，可以登录云端账户。默认情况下数据仅保存在本地。

• CLI 用户登录:

  specstory login
  

  登录后，使用 specstory run 产生的新会话会自动同步；使用 specstory sync 可上传旧会话。

• IDE 用户登录: 打开命令面板 (Cmd/Ctrl + Shift + P) -> 输入 SpecStory: Open Cloud Sync Configuration -> 按照指引登录并配置自动同步。