[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-specstoryai--getspecstory":3,"tool-specstoryai--getspecstory":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",148568,2,"2026-04-09T23:34:24",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":76,"owner_twitter":76,"owner_website":77,"owner_url":78,"languages":79,"stars":88,"forks":89,"last_commit_at":90,"license":91,"difficulty_score":32,"env_os":92,"env_gpu":93,"env_ram":93,"env_deps":94,"category_tags":105,"github_topics":106,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":120,"updated_at":121,"faqs":122,"releases":152},6107,"specstoryai\u002Fgetspecstory","getspecstory","Install our local first extensions for your favorite AI IDE or Terminal Agent. Sync your conversations to the cloud. File issues and requests.","getspecstory 是一款专为 AI 辅助开发打造的对话管理工具，旨在将开发者与 AI 编程助手（如 Cursor、Copilot、Claude Code 等）的交互记录转化为可搜索、可共享的知识库。在日常开发中，我们常会遗忘那些灵光一现的代码片段或重要的架构决策，而 getspecstory 能自动捕获并索引所有对话历史，确保这些宝贵资产不再丢失。\n\n该工具主要服务于软件开发者和技术研究人员。其核心亮点在于“本地优先”的架构设计：所有对话数据首先安全地存储在本地 `.specstory\u002Fhistory\u002F` 目录中，保障隐私与控制权；仅在用户登录时，才可选同步至云端以实现跨设备搜索与团队协作。此外，getspecstory 还支持通过开源的 Agent Skills 插件，自动从历史记录中生成会话摘要、项目统计及深度洞察，让过往的调试过程成为可复用的经验资产。通过将非结构化的聊天记录转变为结构化的“新源代码”，它帮助团队更高效地沉淀技术智慧，提升研发协作效率。","\n\u003Cimg width=\"1649\" height=\"158\" alt=\"Group 6 (1)\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fspecstoryai_getspecstory_readme_27285ffba65d.png\" \u002F>\n\n\n# Intent is the new source code\n\n**Turn your AI development conversations into searchable, shareable knowledge.**\n\nNever lose a brilliant solution, code snippet, or architectural decision again. SpecStory captures, indexes, and makes searchable every interaction you have with AI coding assistants across all your projects and tools.\n\n\u003Cp align=\"left\">\n  \u003Cstrong>Install SpecStory ──▶ \u003C\u002Fstrong> \n  \u003Ca href=\"https:\u002F\u002Fspecstory.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3Dinstalls&style=flat-square\" alt=\"Installs\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fspecstory.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DactiveUsers&style=flat-square\" alt=\"Active Users\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fspecstory.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DsessionsSaved&style=flat-square\" alt=\"Sessions Saved\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fspecstory.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DrulesGenerated&style=flat-square\" alt=\"Rules Generated\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"left\">\n  \u003Cstrong>Contribute to OSS ──▶\u003C\u002Fstrong> \n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fmain\u002Fspecstory-cli\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCLI-Open%20Source-brightgreen?style=flat-square\" alt=\"CLI Open Source\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSkills-Open%20Source-brightgreen?style=flat-square\" alt=\"Skills Open Source\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"left\">\n  \u003Cstrong>Connect with us ───▶\u003C\u002Fstrong> \n  \u003Ca href=\"https:\u002F\u002Ftwitter.com\u002Fspecstoryai\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FX-000000?style=flat-square&logoColor=white\" alt=\"X\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fspecstory\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinkedIn-0077B5?style=flat-square&logo=linkedin&logoColor=white\" alt=\"LinkedIn\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fspecstory.slack.com\u002Fjoin\u002Fshared_invite\u002Fzt-2vq0274ck-MYS39rgOpDSmgfE1IeK9gg#\u002Fshared-invite\u002Femail\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSlack-4A154B?style=flat-square&logo=slack&logoColor=white\" alt=\"Slack\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FE47yQyEUd3\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-5865F2?style=flat-square&logo=discord&logoColor=white\" alt=\"Discord\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002F@specstory\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FYouTube-FF0000?style=flat-square&logo=youtube&logoColor=white\" alt=\"YouTube\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n> 🔧 **[Agent Skills](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills)** - Install skills to generate session summaries, fetch project stats, organize history, and more\n\n## How It Works\n```\nAI Coding Tools              Local First                  Cloud Platform\n─────────────────           ─────────────                ─────────────────\n                                                          (Login Required)\nCursor IDE         ┐\nCopilot IDE        │\nClaude Code CLI    │\nCursor CLI         ├──────►  .specstory\u002Fhistory\u002F  ──────►  cloud.specstory.com\nCodex CLI          │          (Auto-Saved Locally)        (Search, Ask & Share)\nDroid CLI          │\nGemini CLI         ┘\n```\n\n## Workflow\n\n1. **Capture** - Extensions save every AI interaction locally to `.specstory\u002Fhistory\u002F`\n2. **Process** - Use [Agent Skills](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills) to generate summaries, stats, and insights from your history\n3. **Sync (Optional)** - Only if logged in, sessions sync to cloud\n4. **Search** - Find conversations locally or across all projects in cloud\n5. **Share** - Export and share specific solutions with your team\n\n## Supported Development Tools\n\nSpecStory integrates seamlessly with your favorite AI coding tools, automatically saving all conversations locally to `.specstory\u002Fhistory\u002F` in your project. **Everything is local-first** - your data stays on your machine unless you choose to sync to the cloud.\n\n### Installation\n\n| Product                                                          | Type | Source                                                                                              | Supported Agent                                                               | Min Version  | Installation                                                  | Changelog                                                                                  |\n|------------------------------------------------------------------|------|-----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|--------------|---------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| **[Cursor Extension](https:\u002F\u002Fwww.cursor.com\u002F)**                  | IDE  | Closed                                                                                              | [Cursor AI](https:\u002F\u002Fwww.cursor.com\u002F)                                          | v0.43.6+     | Search \"SpecStory\" in Extensions (Cmd\u002FCtrl+Shift+X) → Install | [📋 View](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems\u002FSpecStory.specstory-vscode\u002Fchangelog) |\n| **[VSC Copilot Extension](https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot)** | IDE  | Closed                                                                                              | [GitHub Copilot](https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot)                         | v1.300.0+    | Search \"SpecStory\" in Extensions (Cmd\u002FCtrl+Shift+X) → Install | [📋 View](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems\u002FSpecStory.specstory-vscode\u002Fchangelog) |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [Open](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fclaudecode) | [Claude Code](https:\u002F\u002Fclaude.ai\u002Fclaude-code)                                  | v1.0.27+     | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 View](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [Open](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fcodexcli)   | [Codex CLI](https:\u002F\u002Fwww.openai.com\u002Fcodex)                                     | v0.42.0+     | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 View](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [Open](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fcursorcli)  | [Cursor CLI](https:\u002F\u002Fcursor.com\u002Fcli)                                          | v2025.09.18+ | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 View](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [Open](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fdroidcli)   | [Droid CLI](https:\u002F\u002Ffactory.ai\u002Fproduct\u002Fcli)                                   | v0.56.3+     | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 View](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [Open](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fgeminicli)  | [Gemini CLI](https:\u002F\u002Fdocs.cloud.google.com\u002Fgemini\u002Fdocs\u002Fcodeassist\u002Fgemini-cli) | 0.15.1+      | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 View](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n\n> [!NOTE]\n> For Cursor users: Install from within Cursor, not from the Visual Studio Marketplace website. [Learn why](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues\u002F8)\n\n### CLI Tools\n\n**One installation works with all CLI tools** - Claude Code, Cursor CLI, and Codex:\n\n```bash\n# Check which agents are installed\nspecstory check\n\n# Launch your preferred agent with auto-save\nspecstory run claude    # Launch Claude Code\nspecstory run cursor    # Launch Cursor CLI\nspecstory run codex     # Launch Codex CLI\nspecstory run droid     # Launch Droid CLI\nspecstory run gemini    # Launch Gemini CLI\nspecstory run           # Launch default agent\n```\n\nAll sessions automatically save to `.specstory\u002Fhistory\u002F` in your current project.\n\n> [!TIP]\n> The SpecStory CLI acts as a wrapper that enhances any of these terminal agents with automatic session saving. You only need the respective agent installed (e.g., Claude Code) for SpecStory to work with it.\n\n## SpecStory Cloud ☁️\n\n[**SpecStory Cloud**](https:\u002F\u002Fcloud.specstory.com) transforms your local AI conversations into a powerful, centralized knowledge system.\n\n### The Problem We Solve\n- **Lost Context**: Critical decisions and solutions scattered across machines and projects\n- **No Global Search**: Finding that perfect solution from last month is impossible\n- **Fragile Sharing**: Passing around Markdown files doesn't scale\n\n### The Solution\nSpecStory Cloud creates your personal AI coding knowledge base:\n- 🔍 **Search Everywhere**: Full-text search across all your projects via web interface. RAG coming soon.\n- 🎯 **Explicit Opt-In**: Nothing syncs to cloud without sign-up and login first\n- 📚 **Organized by Project**: Automatic categorization by repository and time\n- 🚀 **API Access**: Programmatic sync and search for automation\n- 👥 **Team Features**: Coming soon - share knowledge across your organization\n\n[Get Started with SpecStory Cloud →](https:\u002F\u002Fcloud.specstory.com)\n\n### How to Sync to Cloud\n\n| Method | One-Time Setup | Live Sessions | Past Sessions |\n|--------|----------------|---------------|---------------|\n| **SpecStory CLI** | `specstory login` | Auto-pushed when using `specstory run` while logged in | Use `specstory sync` to push existing local sessions |\n| **Cursor Extension** | Command Palette → \"SpecStory: Open Cloud Sync Configuration\" | Configure auto-sync in settings | Use sync command from Command Palette |\n| **VSCode Extension** | Command Palette → \"SpecStory: Open Cloud Sync Configuration\" | Configure auto-sync in settings | Use sync command from Command Palette |\n\n> [!IMPORTANT]\n> **Local-First & Private by Default**: All sessions are saved locally to `.specstory\u002Fhistory\u002F`. Nothing is ever sent to the cloud unless you explicitly login with. Even after logging in, you can control what gets synced.\n\n## Documentation & Support\n\n- 📚 **[Full Documentation](https:\u002F\u002Fdocs.specstory.com\u002Foverview)** - Complete guides and [Cloud API reference](https:\u002F\u002Fdocs.specstory.com\u002Fapi-reference\u002Fintroduction)\n- 🔧 **[Agent Skills](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills)** - Generate summaries, stats, and insights from your `.specstory\u002Fhistory`\n- 🐛 **[Report Issues](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues)** - We actively monitor and respond\n- 📖 **[Contribute to Docs](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fdocs\u002F)** - PRs welcome!\n\n## Reviews & Feedback\n\nLove SpecStory? Help others discover their AI coding memory upgrade by leaving a [review](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=SpecStory.specstory-vscode&ssr=false#review-details)! 🧠\n\n## Star History\n\n![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fspecstoryai_getspecstory_readme_d57ce9500776.png)\n","\u003Cimg width=\"1649\" height=\"158\" alt=\"Group 6 (1)\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fspecstoryai_getspecstory_readme_27285ffba65d.png\" \u002F>\n\n\n# 意图是新的源代码\n\n**将你的 AI 开发对话转化为可搜索、可共享的知识。**\n\n再也不会丢失任何精彩的解决方案、代码片段或架构决策了。SpecStory 会捕获、索引并使你在所有项目和工具中与 AI 编码助手的每一次互动都可被搜索。\n\n\u003Cp align=\"left\">\n  \u003Cstrong>安装 SpecStory ──▶ \u003C\u002Fstrong> \n  \u003Ca href=\"https:\u002F\u002Fspecstory.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3Dinstalls&style=flat-square\" alt=\"安装量\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fspecstory.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DactiveUsers&style=flat-square\" alt=\"活跃用户\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fspecstory.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DsessionsSaved&style=flat-square\" alt=\"已保存会话\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fspecstory.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https%3A%2F%2Fspecstory.com%2Fapi%2Fbadge%3Fstat%3DrulesGenerated&style=flat-square\" alt=\"生成的规则\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"left\">\n  \u003Cstrong>参与开源项目 ──▶\u003C\u002Fstrong> \n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fmain\u002Fspecstory-cli\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCLI-Open%20Source-brightgreen?style=flat-square\" alt=\"CLI 开源\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSkills-Open%20Source-brightgreen?style=flat-square\" alt=\"技能开源\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"left\">\n  \u003Cstrong>联系我们 ───▶\u003C\u002Fstrong> \n  \u003Ca href=\"https:\u002F\u002Ftwitter.com\u002Fspecstoryai\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FX-000000?style=flat-square&logoColor=white\" alt=\"X\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.linkedin.com\u002Fcompany\u002Fspecstory\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLinkedIn-0077B5?style=flat-square&logo=linkedin&logoColor=white\" alt=\"LinkedIn\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fspecstory.slack.com\u002Fjoin\u002Fshared_invite\u002Fzt-2vq0274ck-MYS39rgOpDSmgfE1IeK9gg#\u002Fshared-invite\u002Femail\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FSlack-4A154B?style=flat-square&logo=slack&logoColor=white\" alt=\"Slack\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fdiscord.gg\u002FE47yQyEUd3\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-5865F2?style=flat-square&logo=discord&logoColor=white\" alt=\"Discord\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002F@specstory\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FYouTube-FF0000?style=flat-square&logo=youtube&logoColor=white\" alt=\"YouTube\" style=\"vertical-align: middle;\">\u003C\u002Fa>\n\u003C\u002Fp>\n\n> 🔧 **[Agent Skills](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills)** - 安装技能以生成会话摘要、获取项目统计信息、整理历史记录等\n\n## 工作原理\n```\nAI 编码工具              本地优先                  云平台\n─────────────────           ─────────────                ─────────────────\n                                                          （需登录）\nCursor IDE         ┐\nCopilot IDE        │\nClaude Code CLI    │\nCursor CLI         ├──────►  .specstory\u002Fhistory\u002F  ──────►  cloud.specstory.com\nCodex CLI          │          （自动本地保存）        （搜索、提问与分享）\nDroid CLI          │\nGemini CLI         ┘\n```\n\n## 工作流程\n\n1. **捕获** - 扩展程序会将每次 AI 交互本地保存到 `.specstory\u002Fhistory\u002F`\n2. **处理** - 使用 [Agent Skills](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills) 从你的历史记录中生成摘要、统计数据和见解\n3. **同步（可选）** - 仅在登录状态下，会话才会同步到云端\n4. **搜索** - 在本地或云端跨所有项目查找对话\n5. **分享** - 导出并与团队分享特定的解决方案\n\n## 支持的开发工具\n\nSpecStory 可无缝集成到你喜爱的 AI 编码工具中，自动将所有对话本地保存到项目中的 `.specstory\u002Fhistory\u002F` 文件夹。**一切均采用本地优先策略**——除非你选择同步到云端，否则你的数据始终保留在本地设备上。\n\n### 安装\n\n| 产品                                                          | 类型 | 来源                                                                                              | 支持的代理                                                               | 最低版本  | 安装                                                  | 更改日志                                                                                  |\n|------------------------------------------------------------------|------|-----------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|--------------|---------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| **[Cursor 扩展](https:\u002F\u002Fwww.cursor.com\u002F)**                  | IDE  | 封闭                                                                                              | [Cursor AI](https:\u002F\u002Fwww.cursor.com\u002F)                                          | v0.43.6+     | 在扩展中搜索“SpecStory”（Cmd\u002FCtrl+Shift+X）→ 安装 | [📋 查看](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems\u002FSpecStory.specstory-vscode\u002Fchangelog) |\n| **[VSC Copilot 扩展](https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot)** | IDE  | 封闭                                                                                              | [GitHub Copilot](https:\u002F\u002Fgithub.com\u002Ffeatures\u002Fcopilot)                         | v1.300.0+    | 在扩展中搜索“SpecStory”（Cmd\u002FCtrl+Shift+X）→ 安装 | [📋 查看](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems\u002FSpecStory.specstory-vscode\u002Fchangelog) |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [开放](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fclaudecode) | [Claude Code](https:\u002F\u002Fclaude.ai\u002Fclaude-code)                                  | v1.0.27+     | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 查看](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [开放](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fcodexcli)   | [Codex CLI](https:\u002F\u002Fwww.openai.com\u002Fcodex)                                     | v0.42.0+     | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 查看](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [开放](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fcursorcli)  | [Cursor CLI](https:\u002F\u002Fcursor.com\u002Fcli)                                          | v2025.09.18+ | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 查看](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [开放](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fdroidcli)   | [Droid CLI](https:\u002F\u002Ffactory.ai\u002Fproduct\u002Fcli)                                   | v0.56.3+     | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 查看](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n| **[SpecStory CLI](https:\u002F\u002Fspecstory.com\u002Fspecstory-cli)**         | CLI  | [开放](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fdev\u002Fspecstory-cli\u002Fpkg\u002Fproviders\u002Fgeminicli)  | [Gemini CLI](https:\u002F\u002Fdocs.cloud.google.com\u002Fgemini\u002Fdocs\u002Fcodeassist\u002Fgemini-cli) | 0.15.1+      | `brew tap specstoryai\u002Ftap`\u003Cbr\u002F>`brew install specstory`       | [📋 查看](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases)                            |\n\n> [!注意]\n> 对于 Cursor 用户：请从 Cursor 内部安装，而不是从 Visual Studio Marketplace 网站安装。[了解原因](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues\u002F8)\n\n### CLI 工具\n\n**一次安装即可适用于所有 CLI 工具**——Claude Code、Cursor CLI 和 Codex：\n\n```bash\n# 检查已安装哪些代理\nspecstory check\n\n# 启动您偏好的代理并自动保存\nspecstory run claude    # 启动 Claude Code\nspecstory run cursor    # 启动 Cursor CLI\nspecstory run codex     # 启动 Codex CLI\nspecstory run droid     # 启动 Droid CLI\nspecstory run gemini    # 启动 Gemini CLI\nspecstory run           # 启动默认代理\n```\n\n所有会话都会自动保存到您当前项目的 `.specstory\u002Fhistory\u002F` 目录中。\n\n> [!提示]\n> SpecStory CLI 是一个封装工具，可为任何终端代理提供自动会话保存功能。您只需安装相应的代理（例如 Claude Code），SpecStory 即可与其配合使用。\n\n## SpecStory 云 ☁️\n\n[**SpecStory 云**](https:\u002F\u002Fcloud.specstory.com) 可将您本地的 AI 对话转化为强大的集中式知识系统。\n\n### 我们解决的问题\n- **上下文丢失**：关键决策和解决方案分散在不同设备和项目中\n- **无法全局搜索**：很难找到上个月的那个完美解决方案\n- **分享不便**：传递 Markdown 文件的方式难以扩展\n\n### 解决方案\nSpecStory 云为您打造个人 AI 编程知识库：\n- 🔍 **随处搜索**：通过网页界面实现跨所有项目的全文搜索。RAG 功能即将推出。\n- 🎯 **明确选择加入**：未经注册并登录，不会有任何数据同步到云端。\n- 📚 **按项目组织**：根据仓库和时间自动分类。\n- 🚀 **API 访问**：支持程序化同步和搜索，便于自动化操作。\n- 👥 **团队功能**：即将推出——可在整个组织内共享知识。\n\n[开始使用 SpecStory 云 →](https:\u002F\u002Fcloud.specstory.com)\n\n### 如何同步到云端\n\n| 方法 | 一次性设置 | 实时会话 | 历史会话 |\n|--------|----------------|---------------|---------------|\n| **SpecStory CLI** | `specstory login` | 登录后使用 `specstory run` 时自动推送 | 使用 `specstory sync` 推送现有的本地会话 |\n| **Cursor 扩展** | 命令面板 → “SpecStory: 打开云同步配置” | 在设置中配置自动同步 | 使用命令面板中的同步命令 |\n| **VSCode 扩展** | 命令面板 → “SpecStory: 打开云同步配置” | 在设置中配置自动同步 | 使用命令面板中的同步命令 |\n\n> [!重要]\n> **本地优先且默认私密**：所有会话均会本地保存到 `.specstory\u002Fhistory\u002F` 目录中。除非您明确登录，否则绝不会发送任何数据到云端。即使登录后，您也可以控制要同步的内容。\n\n## 文档与支持\n\n- 📚 **[完整文档](https:\u002F\u002Fdocs.specstory.com\u002Foverview)** - 全面指南和[云 API 参考文档](https:\u002F\u002Fdocs.specstory.com\u002Fapi-reference\u002Fintroduction)\n- 🔧 **[Agent Skills](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills)** - 从你的 `.specstory\u002Fhistory` 中生成摘要、统计数据和洞察\n- 🐛 **[提交问题](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues)** - 我们会积极监控并及时响应\n- 📖 **[参与文档贡献](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fdocs\u002F)** - 欢迎提交 PR！\n\n## 评价与反馈\n\n喜欢 SpecStory 吗？请留下[评价](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=SpecStory.specstory-vscode&ssr=false#review-details)，帮助更多人发现这款能提升 AI 编码记忆的工具吧！🧠\n\n## 星标历史\n\n![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fspecstoryai_getspecstory_readme_d57ce9500776.png)","# SpecStory 快速上手指南\n\nSpecStory 是一款将您与 AI 编程助手（如 Cursor、Claude Code、Copilot 等）的对话转化为可搜索、可共享知识库的工具。它默认采用“本地优先”策略，自动保存所有交互记录。\n\n## 环境准备\n\n*   **操作系统**: macOS, Linux, Windows (通过 WSL 或 PowerShell)\n*   **前置依赖**:\n    *   已安装至少一种支持的 AI 编程工具（见下表）。\n    *   **CLI 用户**: 需安装 `Homebrew` (macOS\u002FLinux) 或直接下载二进制文件 (Windows)。\n    *   **IDE 用户**: 需安装 Cursor IDE 或 VS Code (配合 GitHub Copilot)。\n\n**支持的工具及最低版本要求：**\n\n| 工具类型 | 支持产品 | 最低版本要求 |\n| :--- | :--- | :--- |\n| **IDE 插件** | Cursor | v0.43.6+ |\n| | VS Code (GitHub Copilot) | v1.300.0+ |\n| **命令行 (CLI)** | Claude Code | v1.0.27+ |\n| | Codex CLI | v0.42.0+ |\n| | Cursor CLI | v2025.09.18+ |\n| | Droid CLI | v0.56.3+ |\n| | Gemini CLI | v0.15.1+ |\n\n## 安装步骤\n\n根据您的使用场景选择以下一种安装方式：\n\n### 方案 A：IDE 插件安装 (Cursor \u002F VS Code)\n\n1.  打开 Cursor 或 VS Code。\n2.  按下 `Cmd\u002FCtrl + Shift + X` 打开扩展面板。\n3.  搜索 **`SpecStory`**。\n4.  点击 **Install** 安装。\n    > **注意**: Cursor 用户请务必在编辑器内部安装，不要通过 Visual Studio Marketplace 网页版安装。\n\n### 方案 B：命令行工具安装 (适用于 Claude Code, Codex, Cursor CLI 等)\n\n只需安装一次 SpecStory CLI，即可适配所有支持的终端 AI 代理。\n\n**macOS \u002F Linux (推荐):**\n```bash\nbrew tap specstoryai\u002Ftap\nbrew install specstory\n```\n\n**验证安装:**\n```bash\nspecstory check\n```\n\n## 基本使用\n\n### 1. 开始记录会话 (CLI 用户)\n\n使用 `specstory run` 命令启动您的 AI 代理，所有对话将自动保存到当前项目目录下的 `.specstory\u002Fhistory\u002F` 文件夹中。\n\n```bash\n# 启动 Claude Code\nspecstory run claude\n\n# 启动 Cursor CLI\nspecstory run cursor\n\n# 启动 Codex CLI\nspecstory run codex\n\n# 启动默认配置的代理\nspecstory run\n```\n\n### 2. 开始记录会话 (IDE 用户)\n\n安装插件后无需额外配置。直接在 Cursor 或 VS Code 中与 AI 进行对话，插件会自动在后台捕获并保存历史记录到本地 `.specstory\u002Fhistory\u002F`。\n\n### 3. 查看与管理历史\n\n所有会话均以本地文件形式存储。您可以直接使用 [Agent Skills](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fagent-skills) 生成摘要或统计信息，或者手动浏览 `.specstory\u002Fhistory\u002F` 目录。\n\n### 4. (可选) 同步到云端\n\n如果您需要在多设备间搜索或共享知识，可以登录云端账户。默认情况下**数据仅保存在本地**。\n\n*   **CLI 用户登录:**\n    ```bash\n    specstory login\n    ```\n    登录后，使用 `specstory run` 产生的新会话会自动同步；使用 `specstory sync` 可上传旧会话。\n\n*   **IDE 用户登录:**\n    打开命令面板 (`Cmd\u002FCtrl + Shift + P`) -> 输入 `SpecStory: Open Cloud Sync Configuration` -> 按照指引登录并配置自动同步。","某全栈开发者在同时维护三个微服务项目时，频繁使用 Cursor 和 Claude Code CLI 与 AI 协作解决复杂的架构重构问题。\n\n### 没有 getspecstory 时\n- **知识碎片化严重**：几天前在终端里让 AI 生成的关键数据库迁移脚本，因为关闭了会话窗口就再也找不到，只能凭记忆重新描述需求。\n- **跨项目经验无法复用**：在 A 项目中调试成功的鉴权逻辑方案，到了 B 项目遇到类似问题时，完全想不起当时的具体提示词和代码细节，导致重复造轮子。\n- **协作沟通成本高**：当需要向团队成员解释某个架构决策的由来时，只能截图零散的聊天记录，缺乏系统性的上下文梳理，新人难以理解前因后果。\n- **历史回溯困难**：面对长达数周的迭代记录，无法快速检索特定功能点的讨论过程，排查问题时如同大海捞针。\n\n### 使用 getspecstory 后\n- **自动沉淀本地知识库**：getspectory 自动将所有 IDE 和终端的 AI 对话保存至 `.specstory\u002Fhistory\u002F`，随时可通过关键词秒级检索到之前的数据库迁移脚本和完整上下文。\n- **智能总结与跨项目复用**：利用其 Agent Skills 自动生成会话摘要，开发者能迅速定位并复用 A 项目的鉴权方案，将原本半天的调研时间缩短为几分钟。\n- **可分享的决策链路**：一键将特定的架构讨论同步到云端生成分享链接，团队成员可直接查看完整的推导过程和代码演变，极大降低了沟通门槛。\n- **结构化历史管理**：所有交互被自动索引和分类，开发者可以按项目或话题清晰回溯整个开发周期的思维路径，让“意图”真正成为可查询的源代码。\n\ngetspectory 将转瞬即逝的 AI 对话转化为团队可搜索、可复用的核心资产，彻底解决了智能开发时代的知识流失难题。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fspecstoryai_getspecstory_a9eba4ab.png","specstoryai","SpecStory","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fspecstoryai_c70cecc6.png","",null,"https:\u002F\u002Fspecstory.com","https:\u002F\u002Fgithub.com\u002Fspecstoryai",[80,84],{"name":81,"color":82,"percentage":83},"Go","#00ADD8",99.8,{"name":85,"color":86,"percentage":87},"Shell","#89e051",0.2,1169,71,"2026-04-09T15:20:43","Apache-2.0","macOS, Windows, Linux","未说明",{"notes":95,"python":93,"dependencies":96},"该工具主要为 IDE 扩展和 CLI 包装器，非本地运行的大模型。CLI 版本在 macOS 上推荐使用 Homebrew 安装；Windows 和 Linux 用户需参考文档获取其他安装方式。数据默认本地存储于 .specstory\u002Fhistory\u002F，云端同步需登录且为可选操作。Cursor 用户需在 IDE 内部安装扩展，而非通过 VS Code 市场网页安装。",[97,98,99,100,101,102,103,104],"Homebrew (macOS\u002FLinux CLI 安装)","Cursor IDE (v0.43.6+)","VS Code Copilot (v1.300.0+)","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+)",[14,35,52,15,13],[107,108,109,110,111,112,113,114,115,116,117,118,119],"vscode","vscode-extension","ai","chat-history","copilot","copilot-chat","cursor-ai","cursorai","claude","claude-code","codex","codex-cli","cursor-cli","2026-03-27T02:49:30.150509","2026-04-10T11:24:48.405113",[123,128,133,138,143,148],{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},27659,"为什么在使用 'Save Composer and Chat History' 功能时提示 'No workspace open'（未打开工作区）错误？","这通常是因为扩展无法正确匹配当前的工作区路径。您可以尝试以下步骤获取详细日志以排查问题：\n1. 打开输出视图（在命令面板中搜索并选择 'Output: Focus on Output View'）。\n2. 在右侧下拉菜单中选择 'SpecStory'（默认可能显示为 'Tasks'）。\n3. 点击下拉菜单右侧的按钮清除日志。\n4. 在 SpecStory 设置中，先关闭 'Auto-save' 再重新开启，以触发新的日志记录。\n如果问题依旧，可以提供这些日志给维护者，或预约官方支持时间进行排查。","https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues\u002F4",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},27660,"保存聊天历史时遇到 'TypeError: Cannot read properties of undefined (reading 'map')' 错误怎么办？","这是一个已知的 Bug，特别是在 Windows 系统上使用 GitHub Copilot 时， bundled CLI 可能无法正确匹配 VS Code 的工作区路径。该问题已在后续版本中修复。请确保您将 SpecStory 扩展更新到最新版本（如 v1.0.0 或更高），以避免此错误。如果更新后仍存在问题，可能是工作区路径识别失败，建议检查项目路径是否包含特殊字符或权限问题。","https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues\u002F163",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},27661,"安装 SpecStory 扩展后导致 Cursor 编辑器突然崩溃或无警告关闭，如何解决？","这是由于扩展与 Cursor 的 SQLite 数据库发生锁冲突（SQLITE_BUSY: database is locked）导致的。维护者已在 v0.11.4 版本中解决了此问题。\n解决方法：\n1. 下载预发布版本的安装包 (.vsix)：https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Freleases\u002Fdownload\u002Falpha\u002Fspecstory-vscode-0.11.4-alpha.1.vsix\n2. 在 Cursor\u002FVSCode 中通过命令行或界面手动安装该 VSIX 文件（参考：https:\u002F\u002Fforum.cursor.com\u002Ft\u002Fhow-to-install-vsix-format-extension\u002F1667）。\n如果更新后问题仍存在，尝试在 Cursor 完全加载并扫描完 Git 后再启用该扩展。","https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues\u002F54",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},27662,"扩展导致 Extension Host 频繁崩溃或被 Bisect 工具识别为问题根源，该如何处理？","维护者已发布 v1.0.0 版本旨在解决导致扩展主机崩溃的问题。请务必升级到最新版本。\n如果升级后问题复发，可以尝试以下变通方法：\n1. 卸载并重新安装扩展。\n2. 启动 Cursor 时不加载 SpecStory 扩展，待 Cursor 完全启动且 Git 扫描完成后，再手动启用 SpecStory 扩展。这可以避免在初始化阶段发生冲突。","https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues\u002F128",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},27663,"为什么只有第一次聊天请求被保存，后续的对话内容没有记录到 Markdown 文件中？","这是一个影响部分用户（特别是 GitHub Copilot 用户）的 Bug，表现为仅记录初始提示词，后续交互丢失或生成空文件。该问题通常与会话跟踪逻辑有关。请首先尝试将扩展更新至最新版本，因为维护者正在持续修复此类会话保存不完整的问题。如果更新后无效，可能需要检查是否有多个聊天会话窗口同时打开导致冲突，或者等待官方发布进一步的补丁。","https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues\u002F174",{"id":149,"question_zh":150,"answer_zh":151,"source_url":132},27664,"修复了保存功能的 Bug 后，如何找回在故障期间未自动保存的积压聊天会话？","目前扩展更新后，'Save AI Chat History' 对话框可能不会直接显示故障期间产生的未保存会话。虽然您可以在 Copilot 的会话概览中看到这些记录，但 SpecStory 暂时缺乏一键批量恢复这些特定历史会话的功能。建议您在修复版本稳定后，对于重要的新会话及时手动触发保存，并关注后续版本是否会加入历史数据迁移或恢复工具。",[153,158,163,168,173,178,183,188,193,198,203,208,213,218,223,228,233,238,243,248],{"id":154,"version":155,"summary_zh":156,"released_at":157},180856,"v1.12.0","### ⚙️ 改进\n\n- 通过在生成 slug 时过滤系统注入的额外消息，提高 Claude Code 提供者对 Markdown 文件命名的准确性。\n- 确保所有 Markdown 文件名均为小写，以保持一致性。\n- 在 `specstory watch` 和 `specstory watch droid` 命令中，提升 Factory Droid CLI 提供者的执行效率。","2026-03-19T15:03:45",{"id":159,"version":160,"summary_zh":161,"released_at":162},180857,"v1.11.0","### 📢 通知\n\n- `specstory sync` 现在会在 `.\u002F.specstory\u002Fstatistics.json` 中生成会话统计信息。这些数据可供自定义工具或分析使用，您也可以安全地忽略它。\n\n### 🔧 CLI 配置与命令\n\n- `specstory sync` 现在支持 `--only-stats` 标志，该标志会跳过完整的本地和\u002F或云端同步，仅生成或更新 `.\u002F.specstory\u002Fstatistics.json` 文件。\n\n### ⚙️ 改进\n\n- 更新 Gemini CLI 提供程序的项目目录处理方式。Gemini CLI `v0.30.0+` 更改了其在 `~\u002F.gemini\u002Ftmp\u002F` 下命名项目目录的方式。此前它使用项目绝对路径的 SHA256 哈希值（例如 `c18385f0...`），而现在则使用项目文件夹的基名，并将实际的项目路径存储在该目录下的 `.project_root` 文件中。[问题 #183](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fissues\u002F183)\n- 在 Gemini CLI 提供程序中使用文件系统事件而非轮询，以避免在 `specstory watch` 运行期间每 30 秒产生大量日志输出。\n\n### 🐛 错误修复\n\n- 确保 Claude Code 提供程序在创建 Markdown 文件的 slug 时，不会将会话摘要中的自我消息用作第一条用户消息。[贡献](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fpull\u002F178)来自 @salmonumbrella。","2026-03-02T23:52:54",{"id":164,"version":165,"summary_zh":166,"released_at":167},180858,"v1.10.0","### 📢 通知\n\n- 为代理会话添加了可选的 [OpenTelemetry](https:\u002F\u002Fopentelemetry.io\u002F) 指标。可通过 `run`、`sync` 或 `watch` 命令上的 `--telemetry-endpoint`、`--telemetry-service-name` 和 `--no-telemetry-prompts` [标志](https:\u002F\u002Fdocs.specstory.com\u002Fintegrations\u002Fterminal-coding-agents\u002Fusage#flags)，或通过 `telemetry` [配置选项](https:\u002F\u002Fdocs.specstory.com\u002Fintegrations\u002Fterminal-coding-agents\u002Fusage#configuration)来启用。更多信息请参阅 README 中的 [OpenTelemetry](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fblob\u002Fdev\u002Fspecstory-cli\u002FREADME.md#open-telemetry) 部分。","2026-02-24T01:31:36",{"id":169,"version":170,"summary_zh":171,"released_at":172},180859,"v1.9.0","### ⚙️ 改进\n\n- SpecStory CLI 现在支持在用户级别（`~\u002F.specstory\u002Fcli\u002Fconfig.toml`）和项目级别（`.\u002F.specstory\u002Fcli\u002Fconfig.toml`）使用 TOML 格式的配置文件。更多详情请参阅[使用指南](https:\u002F\u002Fdocs.specstory.com\u002Fintegrations\u002Fterminal-coding-agents\u002Fusage)。\n\n### 🔧 CLI 配置与命令\n\n- 现在，`specstory check` 命令会检查您的用户级和项目级配置文件是否有效。\n- 新增 `--debug-dir` 标志及相应配置项，用于设置调试输出的存放路径，该路径可独立于 `--output-dir` 指定的位置。","2026-02-23T14:53:20",{"id":174,"version":175,"summary_zh":176,"released_at":177},180860,"v1.8.0","### 🔧 CLI 配置与命令\n\n- 在 `specstory watch` 运行时，将活动更新输出到标准输出。\n- 添加了 `specstory watch --json` 标志，以提供易于解析的活动更新输出。\n\n### ✏️ Markdown 增强\n\n- 为 Codex CLI 的新 `exec_command` shell 工具添加了 Markdown 渲染功能。\n\n### 🐛 错误修复\n\n- 更新了 Gemini CLI 提供程序中工具调用结果的处理逻辑，修复了在较新版本的 Gemini CLI 中会话渲染失效的问题。","2026-02-22T14:35:57",{"id":179,"version":180,"summary_zh":181,"released_at":182},180861,"v1.7.0","### 🔧 CLI 配置与命令\n\n- 为 `specstory sync -s {session-ID} --print` 命令新增了 `--print` 标志，用于将 Markdown 内容输出到标准输出，而非同步保存到文件。该标志也支持同时处理多个会话，例如：`specstory sync -s {id1} -s {id2} --print`。\n- 对于 `specstory run claude` 命令，在同时存在 Claude Code 的“原生安装”（`~\u002F.local\u002Fbin\u002Fclaude`）和 npm 安装（`~\u002F.claude\u002Flocal\u002Fclaude`）时，优先使用原生安装。\n\n### 🐛 错误修复\n\n- 修复了在已登录 SpecStory Cloud 但服务不可用时，`specstory run` 启动缓慢的问题。","2026-02-16T15:01:43",{"id":184,"version":185,"summary_zh":186,"released_at":187},180862,"v1.6.0","### 🔧 CLI 配置与命令\n\n- 新增 `specstory list` 命令，用于列出当前项目目录下所有支持的提供商的所有会话。也可用于列出特定提供商的会话，例如 `specstory list claude`。\n- 添加 `specstory list --json` 标志，以提供易于解析的输出。","2026-02-09T23:15:59",{"id":189,"version":190,"summary_zh":191,"released_at":192},180863,"v1.5.0","### ⚙️ 改进\n\n- Claude Code 提供者现在能够优雅地处理 JSONL 会话数据中的损坏 JSON 对象，继续解析有效的条目，而不会导致会话无法渲染。\n\n### 🔧 CLI 配置与命令\n\n- `specstory sync` 在解析会话时会显示进度反馈。\n- `specstory sync` 命令的 `-s` 标志现在支持多个会话 ID：`specstory sync -s {id1} -s {id2}`。\n\n### ✏️ Markdown 增强\n\n- Claude Code 提供者的 `WebFetch` 和 `WebSearch` 工具输出现在会在其结果中包含源 URL 和搜索关键词。\n- 当 `WebFetch` 返回 Markdown 内容时，Claude Code 提供者的 Markdown 格式化得到了改进。","2026-01-31T16:53:08",{"id":194,"version":195,"summary_zh":196,"released_at":197},180864,"v1.4.0","### 📢 通知\n\n- SpecStory CLI 现在支持 Factory 的 [Droid CLI](https:\u002F\u002Ffactory.ai\u002Fproduct\u002Fcli)（即 `droid`），适用于从 Factory Droid 版本 `0.56.3` 或更高版本创建的会话。较早版本的会话也可能可用，但不在官方支持范围内。这提供了与 [Claude Code](https:\u002F\u002Fclaude.ai\u002Fdocs\u002Fapi\u002Fclaude-code)、[Cursor CLI](https:\u002F\u002Fcursor.com\u002Fdocs\u002Fcli)、[Codex CLI](https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fcli\u002F) 和 [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) 相同的功能，包括保存到本地 Markdown 文件和 SpecStory Cloud。","2026-01-29T23:50:32",{"id":199,"version":200,"summary_zh":201,"released_at":202},180865,"v1.3.0","### 🔧 CLI 配置与命令\n\n- 为 `sync`、`run` 和 `watch` 命令新增了 `--local-time-zone` 标志，用于在文件名和内容的时间戳中使用本地时区，而非 UTC 时区。","2026-01-26T00:09:28",{"id":204,"version":205,"summary_zh":206,"released_at":207},180866,"v1.2.0","### 🔧 CLI Configuration & Commands\r\n\r\n- Added a `specstory watch` command to watch a project directory for any coding agent activity from any supported provider and auto-save sessions to local markdown and\u002For the [SpecStory Cloud](https:\u002F\u002Fcloud.specstory.com).\r\n- Handle the case where `.\u002F.specstory\u002Fhistory` dir is deleted while the long running `run` or `watch` commands are still running.","2026-01-25T16:37:14",{"id":209,"version":210,"summary_zh":211,"released_at":212},180867,"v1.1.0","### 🔧 CLI Configuration & Commands\r\n\r\n- Added a `--only-cloud-sync` flag to the `sync` and `run` commands to skip local markdown writes and only sync to the [SpecStory Cloud](https:\u002F\u002Fcloud.specstory.com).","2026-01-23T21:40:51",{"id":214,"version":215,"summary_zh":216,"released_at":217},180868,"v1.0.0","## v1.0.0 2026-01-16\r\n\r\n### 📢 Announcements\r\n\r\n- Now that the SpecStory CLI is open sourced under the [Apache 2.0 license](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fblob\u002Fmain\u002Fspecstory-cli\u002FLICENSE.txt) at [https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fmain\u002Fspecstory-cli](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fmain\u002Fspecstory-cli) it is now also graduating to `v1.0.0` 🎉 \r\n\r\n### ⚙️ Improvements\r\n\r\n- When logged in to [SpecStory Cloud](https:\u002F\u002Fcloud.specstory.com\u002F), show links to your project or session after `sync` or `run`.","2026-01-16T22:59:57",{"id":219,"version":220,"summary_zh":221,"released_at":222},180869,"v0.18.0","## v0.18.0 2026-01-16\r\n\r\n### 📢 Announcements\r\n\r\n- The SpecStory CLI is now open sourced under the [Apache 2.0 license](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fblob\u002Fmain\u002Fspecstory-cli\u002FLICENSE.txt) at [https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fmain\u002Fspecstory-cli](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Ftree\u002Fmain\u002Fspecstory-cli) and [contributions](https:\u002F\u002Fgithub.com\u002Fspecstoryai\u002Fgetspecstory\u002Fblob\u002Fmain\u002Fspecstory-cli\u002FCONTRIBUTING.md) are welcome!\r\n\r\n### ⚙️ Improvements\r\n\r\n- Include the agent's question in the markdown output from `AskUserQuestion` tool use with the Claude Code provider.\r\n","2026-01-16T17:21:05",{"id":224,"version":225,"summary_zh":226,"released_at":227},180870,"v0.17.0","## v0.17.0 2026-01-07\r\n\r\n### ✏️ Markdown Enhancements\r\n\r\n- A major internal refactor was done to move markdown generation from the providers to the CLI layer, and to standardize the markdown output across all providers.\r\n- Updated the markdown version to `v2.1.0` with tool types standardized as ` write`, `read`, `search`, `shell`, `task`, `generic`, `unknown`, and with timestamps on all user and agent messages, where available.\r\n- The Cursor CLI provider now generates SpecStory markdown `v2.1.0` files, which support a significantly enhanced web UI when sessions are viewed in the SpecStory Cloud web app.\r\n- The Cursor CLI provider now preserves model \"thinking\" content in the markdown output.\r\n- The Claude Code provider now provides timestamps for user and agent messages in the markdown output.\r\n- The Claude Code provider no longer includes the `\u003Csystem-reminder>...\u003C\u002Fsystem-reminder>` content about malicious content in the generated markdown on \"Read\" tool results.\r\n- The Codex CLI provider has improved markdown output for the `shell_command` tool.\r\n\r\n### 🐛 Bug Fixes\r\n\r\n- Fixed an issue where the CLI would still initialize the analytics client library when the `--no-usage-analytics` flag was used.","2026-01-07T19:47:31",{"id":229,"version":230,"summary_zh":231,"released_at":232},180871,"v0.16.0","## v0.16.0 2025-11-21\r\n\r\n### 📢 Announcements\r\n\r\n- The SpecStory CLI now supports Google's [Gemini CLI](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli) (i.e. `gemini`) for sessions created from Gemini CLI version `0.15.1` or higher. Sessions from earlier versions may work, but are not officially supported. This provides the same support for saving to local markdown files and to the SpecStory Cloud as for [Claude Code](https:\u002F\u002Fclaude.ai\u002Fdocs\u002Fapi\u002Fclaude-code), [Cursor CLI](https:\u002F\u002Fcursor.com\u002Fdocs\u002Fcli) and [Codex CLI](https:\u002F\u002Fdevelopers.openai.com\u002Fcodex\u002Fcli\u002F).\r\n\r\n### 🐛 Bug Fixes\r\n\r\n- Fixed an issue where the Cursor CLI provider would not find sessions when a symlink was anywhere in the current working directory.","2025-11-21T16:20:31",{"id":234,"version":235,"summary_zh":236,"released_at":237},180872,"v0.15.0","## v0.15.0 2025-11-15\r\n\r\n### ✏️ Markdown Enhancements\r\n\r\n- The Codex CLI provider now generates SpecStory markdown v2.0.0 files, which support a significantly enhanced web UI when sessions are viewed in the SpecStory Cloud web app.\r\n- The Codex CLI provider now supports markdown output for the `apply_patch` tool, which is used to apply a patch to a file.\r\n\r\n","2025-11-15T15:33:57",{"id":239,"version":240,"summary_zh":241,"released_at":242},180873,"v0.14.1","## v0.14.1 2025-11-14\r\n\r\n### 🐛 Bug Fixes\r\n\r\n- `specstory run` with the Claude Code provider no longer creates additional markdown files for \"Warmup\" messages.\r\n- `specstory run` would give SpecStory Cloud sync stats timeout count of n - 1 sessions, where n is the number of incremental syncs attempted. This has been fixed.","2025-11-14T12:41:34",{"id":244,"version":245,"summary_zh":246,"released_at":247},180874,"v0.14.0","## v0.14.0 2025-11-12\r\n\r\n### ⚙️ Improvements\r\n\r\n- Reduced network activity during more efficient bulk SpecStory Cloud syncs.\r\n- Display count of session syncs that timed out during SpecStory Cloud syncs.\r\n- Increased the timeout for SpecStory Cloud syncs to 120 seconds to account for initial syncs of large projects with many sessions.\r\n\r\n### ✏️ Markdown Enhancements\r\n\r\n- The Claude Code provider now skips putting \"Warmup\" messages in the markdown output.\r\n- The Claude Code provider now generates SpecStory markdown v2.0.0 files, which support a significantly enhanced web UI when sessions are viewed in the SpecStory Cloud web app.\r\n- \"Bash\" tool use now supports multi-line commands in the markdown output for the Claude Code provider.\r\n- \"Grep\" tool use now extracts the pattern and path from the tool use arguments and displays them in the markdown output for the Claude Code provider.","2025-11-12T21:18:05",{"id":249,"version":250,"summary_zh":251,"released_at":252},180875,"v0.13.0","## v0.13.0 2025-10-26\r\n\r\n### 🔧 CLI Configuration & Commands\r\n\r\n- Introduced a SpecStory Cloud sync debounce in `specstory run` to reduce the number of network syncs to the SpecStory Cloud.\r\n\r\n### ✏️ Markdown Enhancements\r\n\r\n- Removed the `\u003Cuser_query>` tags around user messages in the markdown file names and markdown content that's output from newer versions of the Cursor CLI.\r\n\r\n\r\n### 🐛 Bug Fixes\r\n\r\n- Fixed the SpecStory cloud counters displayed after `specstory run` to match the actual number of sessions created\u002Fupdated\u002Fskipped.\r\n","2025-10-26T15:00:24"]