[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-iannuttall--claude-sessions":3,"tool-iannuttall--claude-sessions":64},[4,17,25,39,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},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 真正成长为懂上",140436,2,"2026-04-05T23:32:43",[13,14,15],"开发框架","Agent","语言模型","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":10,"last_commit_at":23,"category_tags":24,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,15],{"id":26,"name":27,"github_repo":28,"description_zh":29,"stars":30,"difficulty_score":10,"last_commit_at":31,"category_tags":32,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[33,34,35,36,14,37,15,13,38],"图像","数据工具","视频","插件","其他","音频",{"id":40,"name":41,"github_repo":42,"description_zh":43,"stars":44,"difficulty_score":45,"last_commit_at":46,"category_tags":47,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,3,"2026-04-04T04:44:48",[14,33,13,15,37],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":45,"last_commit_at":54,"category_tags":55,"status":16},519,"PaddleOCR","PaddlePaddle\u002FPaddleOCR","PaddleOCR 是一款基于百度飞桨框架开发的高性能开源光学字符识别工具包。它的核心能力是将图片、PDF 等文档中的文字提取出来，转换成计算机可读取的结构化数据，让机器真正“看懂”图文内容。\n\n面对海量纸质或电子文档，PaddleOCR 解决了人工录入效率低、数字化成本高的问题。尤其在人工智能领域，它扮演着连接图像与大型语言模型（LLM）的桥梁角色，能将视觉信息直接转化为文本输入，助力智能问答、文档分析等应用场景落地。\n\nPaddleOCR 适合开发者、算法研究人员以及有文档自动化需求的普通用户。其技术优势十分明显：不仅支持全球 100 多种语言的识别，还能在 Windows、Linux、macOS 等多个系统上运行，并灵活适配 CPU、GPU、NPU 等各类硬件。作为一个轻量级且社区活跃的开源项目，PaddleOCR 既能满足快速集成的需求，也能支撑前沿的视觉语言研究，是处理文字识别任务的理想选择。",74939,"2026-04-05T23:16:38",[15,33,13,37],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":45,"last_commit_at":62,"category_tags":63,"status":16},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70626,"2026-04-05T22:51:36",[15,14,13,36],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":80,"owner_email":79,"owner_twitter":75,"owner_website":81,"owner_url":82,"languages":79,"stars":83,"forks":84,"last_commit_at":85,"license":86,"difficulty_score":10,"env_os":87,"env_gpu":88,"env_ram":88,"env_deps":89,"category_tags":93,"github_topics":79,"view_count":10,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":94,"updated_at":95,"faqs":96,"releases":123},4109,"iannuttall\u002Fclaude-sessions","claude-sessions","Custom slash commands for Claude Code that provide comprehensive development session tracking and documentation","claude-sessions 是专为 Claude Code 设计的一套自定义斜杠命令工具，旨在帮助开发者高效管理跨多次对话的编程会话。在复杂的开发任务中，AI 助手往往难以记住之前的上下文，导致每次重新开始时都需要重复分析代码库。claude-sessions 通过自动记录开发进度、决策原因、Git 变更及待办事项，完美解决了这一“记忆断层”痛点，确保后续会话能无缝衔接过往工作。\n\n该工具特别适合使用 Claude Code 进行持续开发的软件工程师和技术团队。其核心亮点在于将非结构化的对话转化为标准化的 Markdown 文档：用户只需输入如 `\u002Fproject:session-start` 开启新任务，或用 `\u002Fproject:session-update` 同步进展，系统便会自动生成带时间戳的会话文件，并维护当前状态索引。这种机制不仅实现了知识的有序沉淀，还为团队协作和问题回溯提供了清晰的文档依据。通过简单的文件目录结构和直观的命令行交互，claude-sessions 让 AI 辅助编程变得更加连贯、透明且易于管理，是提升长周期开发效率的实用助手。","# Claude Code Session Management Commands\n\nCustom slash commands for Claude Code that provide comprehensive development session tracking and documentation. Based on [Claude Code's custom slash command system](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fslash-commands).\n\n## 🎯 Overview\n\nThis is a set of custom slash commands for Claude Code that helps developers maintain continuity across multiple coding sessions with Claude by:\n\n- **Documenting Progress**: Capture what was done, how it was done, and why decisions were made\n- **Tracking Changes**: Monitor git changes, todo items, and implementation details  \n- **Knowledge Transfer**: Enable future sessions to understand past work without re-analyzing the entire codebase\n- **Issue Resolution**: Document problems encountered and their solutions for future reference\n\nThese commands extend Claude Code's built-in functionality with project-specific session management capabilities.\n\n## 🚀 Quick Start\n\n```bash\n# Start a new session (with optional name)\n\u002Fproject:session-start authentication-refactor\n# Or without a name\n\u002Fproject:session-start\n\n# Update progress during development (with optional notes)\n\u002Fproject:session-update Implemented OAuth with Google\n# Or without notes (auto-summarizes recent activity)\n\u002Fproject:session-update\n\n# End session with comprehensive summary\n\u002Fproject:session-end\n\n# View current session status\n\u002Fproject:session-current\n\n# List all past sessions\n\u002Fproject:session-list\n```\n\n## 📁 File Structure\n\n```\ncommands\u002F                       # Custom command directory\n├── session-start.md           # Command for starting a new session\n├── session-update.md          # Command for updating current session\n├── session-end.md             # Command for ending and summarizing\n├── session-current.md         # Command for viewing current status\n├── session-list.md            # Command for listing all sessions\n└── session-help.md            # Command for showing help\n\nsessions\u002F                      # Session storage directory\n├── .current-session          # Tracks the active session filename\n├── 2025-01-16-1347.md       # Example session file\n└── [YYYY-MM-DD-HHMM-name].md  # Session naming format\n```\n\n## 🛠️ Installation\n\n1. Clone this repository or copy the folders to your project:\n   ```bash\n   git clone git@github.com:iannuttall\u002Fclaude-sessions.git\n   # Or copy the commands and sessions folders to your project root\n   ```\n\n2. Create the sessions tracking file:\n   ```bash\n   mkdir -p sessions\n   touch sessions\u002F.current-session\n   ```\n\n3. Add to `.gitignore` if you don't want to track sessions:\n   ```\n   sessions\u002F\n   ```\n\n## 📝 How It Works\n\nThis system provides custom slash commands inspired by [Claude Code's custom slash commands](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fslash-commands#custom-slash-commands) feature. While Claude Code typically looks for commands in `.claude\u002Fcommands\u002F`, this repository provides a standalone implementation with commands in the `commands\u002F` directory.\n\n- **Prefix**: All commands use the `\u002Fproject:` prefix (for project-specific commands)\n- **Arguments**: Commands support arguments using the `$ARGUMENTS` placeholder\n- **Execution**: Claude reads the command file and executes the instructions within\n- **Note**: These commands are designed to work with Claude but can be adapted for other AI coding assistants\n\n## 📋 Command Reference\n\n### `\u002Fproject:session-start [name]`\nStarts a new development session with an optional descriptive name.\n\n**Parameters:**\n- `[name]` (optional) - A descriptive name for the session. If omitted, creates a session with just the timestamp.\n\n**What it does:**\n- Creates a new markdown file with timestamp (format: `YYYY-MM-DD-HHMM.md` or `YYYY-MM-DD-HHMM-name.md`)\n- Sets up session structure with goals and progress sections\n- Updates `.current-session` to track active session\n- Prompts for session goals if not clear from context\n\n**Examples:**\n```\n# With a descriptive name\n\u002Fproject:session-start refactor-auth-system\n\n# Without a name (just timestamp)\n\u002Fproject:session-start\n```\n\n### `\u002Fproject:session-update [notes]`\nAdds timestamped updates to the current session.\n\n**Parameters:**\n- `[notes]` (optional) - Custom notes about the update. If omitted, automatically summarizes recent activities.\n\n**What it does:**\n- Appends progress notes with timestamp\n- Captures git status and changes\n- Tracks todo list progress\n- Documents issues and solutions\n- Records implementation details\n- Auto-generates summary if no notes provided\n\n**Examples:**\n```\n# With custom notes\n\u002Fproject:session-update Fixed Next.js 15 params Promise issue\n\n# Without notes (auto-summarizes)\n\u002Fproject:session-update\n```\n\n### `\u002Fproject:session-end`\nEnds the current session with a comprehensive summary.\n\n**What it does:**\n- Generates complete session summary including:\n  - Duration and timing\n  - Git changes summary\n  - Todo items completed\u002Fremaining\n  - Key accomplishments\n  - Problems and solutions\n  - Dependencies and configuration changes\n  - Lessons learned\n  - Tips for future developers\n- Clears `.current-session` file\n\n### `\u002Fproject:session-current`\nShows the status of the current active session.\n\n**What it does:**\n- Displays session name and duration\n- Shows recent updates\n- Lists current goals and tasks\n- Reminds of available commands\n\n### `\u002Fproject:session-list`\nLists all session files with summaries.\n\n**What it does:**\n- Shows all session files sorted by date\n- Displays session titles and timestamps\n- Highlights currently active session\n- Shows brief overview of each session\n\n### `\u002Fproject:session-help`\nDisplays help information about the session system.\n\n## 🎯 Best Practices for Claude Code\n\n### Command Usage\n- These commands work only within Claude Code interactive sessions\n- Commands are project-specific and available to all team members\n- Arguments are passed directly after the command name\n\n### Session Management  \n- Sessions help Claude maintain context across conversations\n- Review past sessions before starting related work\n- Session files serve as documentation for your development process\n\n## 🔧 Customization\n\n### Adapting for Standard Claude Code Setup\nIf you want to use these with Claude Code's standard directory structure:\n1. Copy the `commands` folder to `.claude\u002Fcommands\u002F` in your project\n2. Update paths in command files from `sessions\u002F` to `.claude\u002Fsessions\u002F`\n\n### Creating Your Own Commands\n- Modify command files to change behavior\n- Create additional session-related commands\n- Organize commands in subdirectories for namespacing (e.g., `\u002Fproject:session:feature:start`)\n- Create personal versions in `~\u002F.claude\u002Fcommands\u002F` with `\u002Fuser:` prefix\n\n## 📚 References\n\n- [Claude Code Slash Commands Documentation](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fslash-commands)\n- [Claude Code Memory Management](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fmemory-management)\n- [Claude Code Overview](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Foverview)\n\n## 🎯 Best Practices\n\n### Starting Sessions\n- Use descriptive names that indicate the main focus\n- Start sessions for significant features or bug fixes\n- Define clear goals at the beginning\n\n### During Development\n- Update regularly when completing significant tasks\n- Document unexpected issues and their solutions\n- Track breaking changes or important discoveries\n- Note any dependencies added or configuration changes\n\n### Ending Sessions\n- Always end sessions with `\u002Fproject:session-end`\n- Review the generated summary for completeness\n- Add any missing context before closing\n\n### Knowledge Transfer\n- Review relevant past sessions before starting similar work\n- Reference session files in commit messages for context\n- Use session summaries for standup updates or reports\n\n## 💡 Use Cases\n\n### 1. Feature Development\n```\n\u002Fproject:session-start user-authentication\n# Implement auth logic\n\u002Fproject:session-update Added middleware and login page\n# Fix issues\n\u002Fproject:session-update Resolved Next.js 15 async cookie issue\n\u002Fproject:session-end\n```\n\n### 2. Bug Fixing\n```\n\u002Fproject:session-start fix-email-bounce-handling\n# Investigate issue\n\u002Fproject:session-update Found AWS SNS webhook misconfiguration\n# Implement fix\n\u002Fproject:session-update Updated webhook handler and added logging\n\u002Fproject:session-end\n```\n\n### 3. Refactoring\n```\n\u002Fproject:session-start database-service-refactor\n# Plan refactoring\n\u002Fproject:session-update Created new DB service class architecture\n# Execute changes\n\u002Fproject:session-update Migrated all queries to new service\n\u002Fproject:session-end\n```\n\n## 🤖 Benefits for AI Agents\n\n1. **Context Preservation**: Sessions provide rich context about past work\n2. **Decision History**: Understand why certain approaches were taken\n3. **Issue Awareness**: Know about problems already encountered and solved\n4. **Code Evolution**: Track how the codebase has changed over time\n5. **Dependency Tracking**: Awareness of what packages and tools are used\n\n## 🔍 Tips and Tricks\n\n1. **Searchable Sessions**: Use consistent terminology in updates for easy searching\n2. **Link Issues**: Reference ticket numbers or GitHub issues in updates\n3. **Code Snippets**: Include important code changes in session updates\n4. **Screenshots**: Reference screenshot paths for UI changes\n5. **Testing Notes**: Document test scenarios and results\n\n## ⚙️ Configuration\n\n### Customizing Commands\nEdit the command files in `commands\u002F` to:\n- Change session file format\n- Add custom sections\n- Modify summary generation\n- Adjust git tracking details\n\n### Session Storage\n- Default: `sessions\u002F`\n- Can be changed by updating command files\n- Consider version control needs\n\n## 🚨 Troubleshooting\n\n**No active session found**\n- Start a new session with `\u002Fproject:session-start`\n- Check `sessions\u002F.current-session` exists\n\n**Session updates not working**\n- Ensure a session is active\n- Check file permissions in `sessions\u002F`\n\n**Missing git information**\n- Verify you're in a git repository\n- Check git is properly initialized\n\n## 📚 Examples\n\n### Complete Feature Implementation Session\n```markdown\n# Development Session - 2025-01-16 13:47 - campaign-editor\n\n## Goals\n- [x] Create dedicated campaign editor\n- [x] Add markdown support\n- [x] Implement auto-save\n\n## Progress\n[Multiple detailed updates documenting the implementation]\n\n## Session Summary\nSuccessfully implemented a full-featured campaign editor with markdown support,\nlive preview, and auto-save functionality. Resolved Next.js 15 compatibility\nissues and added proper error handling.\n```\n\n## 🤝 Contributing\n\nTo improve this system:\n1. Enhance command instructions for better AI comprehension\n2. Add new commands for specific workflows\n3. Improve session file formatting\n4. Create utilities for session analysis\n\n## 📄 License\n\nThis session management system is open source and available for use in any project.\n\n---\n\n*Remember: Good documentation today saves hours of debugging tomorrow!*","# Claude Code 会话管理命令\n\n适用于 Claude Code 的自定义斜杠命令，提供全面的开发会话跟踪和文档记录功能。基于 [Claude Code 的自定义斜杠命令系统](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fslash-commands)。\n\n## 🎯 概述\n\n这是一组专为 Claude Code 设计的自定义斜杠命令，旨在帮助开发者在与 Claude 的多次编码会话之间保持连贯性，具体功能包括：\n\n- **记录进展**：捕捉已完成的工作、实现方式以及决策背后的理由\n- **跟踪变更**：监控 Git 变更、待办事项及实现细节\n- **知识传递**：使后续会话无需重新分析整个代码库即可理解之前的工作\n- **问题解决**：记录遇到的问题及其解决方案，以供未来参考\n\n这些命令通过项目特定的会话管理功能扩展了 Claude Code 的内置功能。\n\n## 🚀 快速入门\n\n```bash\n# 开始新会话（可选名称）\n\u002Fproject:session-start authentication-refactor\n# 或不指定名称\n\u002Fproject:session-start\n\n# 在开发过程中更新进展（可选备注）\n\u002Fproject:session-update Implemented OAuth with Google\n# 或不带备注（自动总结最近活动）\n\u002Fproject:session-update\n\n# 结束会话并生成综合摘要\n\u002Fproject:session-end\n\n# 查看当前会话状态\n\u002Fproject:session-current\n\n# 列出所有过往会话\n\u002Fproject:session-list\n```\n\n## 📁 文件结构\n\n```\ncommands\u002F                       # 自定义命令目录\n├── session-start.md           # 用于开始新会话的命令\n├── session-update.md          # 用于更新当前会话的命令\n├── session-end.md             # 用于结束并总结会话的命令\n├── session-current.md         # 用于查看当前会话状态的命令\n├── session-list.md            # 用于列出所有会话的命令\n└── session-help.md            # 用于显示帮助信息的命令\n\nsessions\u002F                      # 会话存储目录\n├── .current-session          # 跟踪当前活动会话的文件名\n├── 2025-01-16-1347.md       # 示例会话文件\n└── [YYYY-MM-DD-HHMM-name].md  # 会话命名格式\n```\n\n## 🛠️ 安装\n\n1. 克隆此仓库或将文件夹复制到您的项目中：\n   ```bash\n   git clone git@github.com\u002Fiannuttall\u002Fclaude-sessions.git\n   # 或将 commands 和 sessions 文件夹复制到您的项目根目录\n   ```\n\n2. 创建会话跟踪文件：\n   ```bash\n   mkdir -p sessions\n   touch sessions\u002F.current-session\n   ```\n\n3. 如果您不想跟踪会话，请将其添加到 `.gitignore` 中：\n   ```\n   sessions\u002F\n   ```\n\n## 📝 工作原理\n\n本系统提供了受 [Claude Code 的自定义斜杠命令](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fslash-commands#custom-slash-commands) 功能启发的自定义斜杠命令。虽然 Claude Code 通常会在 `.claude\u002Fcommands\u002F` 目录下查找命令，但本仓库提供了一个独立的实现，命令位于 `commands\u002F` 目录中。\n\n- **前缀**：所有命令均使用 `\u002Fproject:` 前缀（用于项目特定命令）\n- **参数**：命令支持使用 `$ARGUMENTS` 占位符传递参数\n- **执行**：Claude 会读取命令文件并执行其中的指令\n- **注意**：这些命令专为 Claude 设计，但也可适配于其他 AI 编码助手。\n\n## 📋 命令参考\n\n### `\u002Fproject:session-start [name]`\n开始一个新的开发会话，可选指定描述性名称。\n\n**参数：**\n- `[name]`（可选）—— 会话的描述性名称。若省略，则仅按时间戳创建会话。\n\n**作用：**\n- 创建一个带有时间戳的新 Markdown 文件（格式为 `YYYY-MM-DD-HHMM.md` 或 `YYYY-MM-DD-HHMM-name.md`）\n- 设置包含目标和进展部分的会话结构\n- 更新 `.current-session` 文件以跟踪当前活动会话\n- 若上下文不明确，则提示输入会话目标\n\n**示例：**\n```\n# 带有描述性名称\n\u002Fproject:session-start refactor-auth-system\n\n# 不带名称（仅时间戳）\n\u002Fproject:session-start\n```\n\n### `\u002Fproject:session-update [notes]`\n向当前会话添加带时间戳的更新内容。\n\n**参数：**\n- `[notes]`（可选）—— 关于此次更新的自定义备注。若省略，则自动总结最近的活动。\n\n**作用：**\n- 追加带有时间戳的进展笔记\n- 记录 Git 状态和变更\n- 跟踪待办事项的进展\n- 记录问题及解决方案\n- 记录实现细节\n- 若未提供备注，则自动生成摘要\n\n**示例：**\n```\n# 带自定义备注\n\u002Fproject:session-update Fixed Next.js 15 params Promise issue\n\n# 不带备注（自动汇总）\n\u002Fproject:session-update\n```\n\n### `\u002Fproject:session-end`\n以综合摘要结束当前会话。\n\n**作用：**\n- 生成完整的会话摘要，包括：\n  - 会话时长及时间安排\n  - Git 变更摘要\n  - 已完成和剩余的待办事项\n  - 主要成就\n  - 遇到的问题及解决方案\n  - 依赖项和配置变更\n  - 经验教训\n  - 对未来开发者的建议\n- 清除 `.current-session` 文件。\n\n### `\u002Fproject:session-current`\n显示当前活动会话的状态。\n\n**作用：**\n- 显示会话名称和持续时间\n- 展示最近的更新\n- 列出当前的目标和任务\n- 提醒可用的命令\n\n### `\u002Fproject:session-list`\n列出所有会话文件及其摘要。\n\n**作用：**\n- 按日期排序显示所有会话文件\n- 显示会话标题和时间戳\n- 标明当前活动会话\n- 提供每个会话的简要概述\n\n### `\u002Fproject:session-help`\n显示关于会话系统的帮助信息。\n\n## 🎯 Claude Code 最佳实践\n\n### 命令使用\n- 这些命令仅在 Claude Code 的交互式会话中有效\n- 命令是项目特定的，对所有团队成员可见\n- 参数直接跟在命令名称后传递\n\n### 会话管理\n- 会话有助于 Claude 在多次对话中保持上下文连贯性\n- 在开始相关工作之前，回顾过去的会话\n- 会话文件可作为开发过程的文档记录\n\n## 🔧 自定义\n\n### 适配标准 Claude Code 设置\n如果您希望将这些命令与 Claude Code 的标准目录结构一起使用：\n1. 将 `commands` 文件夹复制到项目的 `.claude\u002Fcommands\u002F` 目录中\n2. 将命令文件中的路径从 `sessions\u002F` 更新为 `.claude\u002Fsessions\u002F`\n\n### 创建您自己的命令\n- 修改命令文件以改变行为\n- 创建额外的会话相关命令\n- 将命令组织到子目录中以进行命名空间管理（例如 `\u002Fproject:session:feature:start`）\n- 在 `~\u002F.claude\u002Fcommands\u002F` 中创建个人版本，并使用 `\u002Fuser:` 前缀\n\n## 📚 参考资料\n\n- [Claude Code 斜杠命令文档](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fslash-commands)\n- [Claude Code 内存管理](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Fmemory-management)\n- [Claude Code 概述](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code\u002Foverview)\n\n## 🎯 最佳实践\n\n### 开始会话\n- 使用能表明主要关注点的描述性名称\n- 为重要功能或 bug 修复启动会话\n- 在开始时明确设定目标\n\n### 开发过程中\n- 完成重要任务时定期更新\n- 记录意外问题及其解决方案\n- 跟踪破坏性变更或重要发现\n- 记录新增的依赖项或配置更改\n\n### 结束会话\n- 始终以 `\u002Fproject:session-end` 结束会话\n- 检查生成的摘要是否完整\n- 在关闭前补充任何缺失的上下文\n\n### 知识传递\n- 在开始类似工作之前回顾相关的过往会话\n- 在提交信息中引用会话文件以提供上下文\n- 使用会话摘要进行站会更新或报告\n\n## 💡 使用场景\n\n### 1. 功能开发\n```\n\u002Fproject:session-start 用户认证\n# 实现认证逻辑\n\u002Fproject:session-update 添加了中间件和登录页面\n# 修复问题\n\u002Fproject:session-update 解决了 Next.js 15 的异步 Cookie 问题\n\u002Fproject:session-end\n```\n\n### 2. Bug 修复\n```\n\u002Fproject:session-start 修复邮件退回处理\n# 调查问题\n\u002Fproject:session-update 发现 AWS SNS Webhook 配置错误\n# 实施修复\n\u002Fproject:session-update 更新了 Webhook 处理程序并添加了日志记录\n\u002Fproject:session-end\n```\n\n### 3. 代码重构\n```\n\u002Fproject:session-start 数据库服务重构\n# 制定重构计划\n\u002Fproject:session-update 创建了新的数据库服务类架构\n# 执行更改\n\u002Fproject:session-update 将所有查询迁移到新服务\n\u002Fproject:session-end\n```\n\n## 🤖 对 AI 代理的好处\n\n1. **上下文保留**：会话提供了关于过往工作的丰富上下文\n2. **决策历史**：了解为何采用某些方法\n3. **问题意识**：知晓已遇到并解决的问题\n4. **代码演进**：跟踪代码库随时间的变化\n5. **依赖管理**：了解所使用的包和工具\n\n## 🔍 技巧与提示\n\n1. **可搜索的会话**：在更新中使用一致的术语以便于搜索\n2. **关联问题**：在更新中引用工单编号或 GitHub 问题\n3. **代码片段**：将重要的代码更改包含在会话更新中\n4. **截图**：引用 UI 更改的截图路径\n5. **测试说明**：记录测试场景和结果\n\n## ⚙️ 配置\n\n### 自定义命令\n编辑 `commands\u002F` 中的命令文件以：\n- 更改会话文件格式\n- 添加自定义章节\n- 修改摘要生成方式\n- 调整 Git 跟踪细节\n\n### 会话存储\n- 默认：`sessions\u002F`\n- 可通过更新命令文件更改\n- 应考虑版本控制需求\n\n## 🚨 故障排除\n\n**未找到活动会话**\n- 使用 `\u002Fproject:session-start` 启动新会话\n- 检查 `sessions\u002F.current-session` 是否存在\n\n**会话更新不生效**\n- 确保会话处于活动状态\n- 检查 `sessions\u002F` 中的文件权限\n\n**缺少 Git 信息**\n- 确认当前位于 Git 仓库中\n- 检查 Git 是否已正确初始化\n\n## 📚 示例\n\n### 完整功能实现会话\n```markdown\n# 开发会话 - 2025-01-16 13:47 - 活动编辑器\n\n## 目标\n- [x] 创建专用的活动编辑器\n- [x] 添加 Markdown 支持\n- [x] 实现自动保存\n\n## 进展\n[多条详细更新，记录了实现过程]\n\n## 会话摘要\n成功实现了具有 Markdown 支持、实时预览和自动保存功能的完整活动编辑器。解决了 Next.js 15 的兼容性问题，并添加了适当的错误处理。\n```\n\n## 🤝 贡献\n\n要改进此系统：\n1. 提升命令说明以增强 AI 的理解能力\n2. 添加针对特定工作流的新命令\n3. 改进会话文件格式\n4. 创建用于会话分析的实用工具\n\n## 📄 许可证\n\n本会话管理系统为开源，可在任何项目中使用。\n\n---\n\n*请记住：今天的良好文档能节省明天的调试时间！*","# Claude Sessions 快速上手指南\n\n`claude-sessions` 是一套专为 **Claude Code** 设计的自定义斜杠命令（Slash Commands），旨在帮助开发者在多次编码会话中保持上下文连续性。它能自动记录开发进度、追踪 Git 变更、归档决策逻辑，并生成详细的会话文档，避免每次重新分析整个代码库。\n\n## 环境准备\n\n在使用本工具前，请确保满足以下条件：\n\n*   **运行环境**：已安装并配置好 **Claude Code** CLI 工具。\n*   **版本控制**：项目需初始化 **Git** 仓库（用于自动追踪变更状态）。\n*   **文件系统**：拥有项目根目录的读写权限，用于创建 `commands\u002F` 和 `sessions\u002F` 目录。\n*   **网络要求**：需能正常访问 GitHub 以克隆仓库（如遇网络问题，建议配置代理或使用国内镜像源下载后手动复制文件）。\n\n## 安装步骤\n\n### 1. 获取工具文件\n将仓库克隆到本地，或直接复制核心文件夹到你的项目根目录。\n\n```bash\n# 方式一：克隆仓库（推荐）\ngit clone git@github.com:iannuttall\u002Fclaude-sessions.git\n# 进入项目目录并将必要文件夹移动到你的目标项目根目录\nmv claude-sessions\u002Fcommands claude-sessions\u002Fsessions \u002Fpath\u002Fto\u002Fyour\u002Fproject\u002F\n\n# 方式二：手动复制\n# 直接从源码中复制 commands\u002F 和 sessions\u002F 文件夹到你的项目根目录\n```\n\n### 2. 初始化会话存储\n确保会话记录目录及追踪文件已创建。\n\n```bash\ncd \u002Fpath\u002Fto\u002Fyour\u002Fproject\nmkdir -p sessions\ntouch sessions\u002F.current-session\n```\n\n### 3. 配置忽略规则（可选）\n如果你不希望将会话记录文件提交到版本控制系统，请将以下内容添加到 `.gitignore`：\n\n```text\nsessions\u002F\n```\n\n> **注意**：默认情况下，命令查找路径为项目根目录下的 `commands\u002F`。若需适配 Claude Code 标准结构 (`.claude\u002Fcommands\u002F`)，可将 `commands` 文件夹移动至 `.claude\u002F` 目录下，并修改命令文件内的路径引用。\n\n## 基本使用\n\n安装完成后，在 **Claude Code** 的交互式会话中即可使用 `\u002Fproject:` 前缀的命令。\n\n### 1. 开始新会话\n启动一个带有描述性名称的新开发会话（名称可选）。\n\n```bash\n\u002Fproject:session-start authentication-refactor\n# 或者不带名称，仅使用时间戳\n\u002Fproject:session-start\n```\n*执行效果：创建一个新的 Markdown 会话文件，记录开始时间与目标。*\n\n### 2. 更新进度\n在开发过程中记录关键进展、解决的问题或 Git 变更。\n\n```bash\n# 添加自定义备注\n\u002Fproject:session-update Implemented OAuth with Google\n# 不带备注时，系统将自动总结近期的活动与变更\n\u002Fproject:session-update\n```\n\n### 3. 结束会话\n完成当前任务后，生成包含完整摘要、待办事项状态和经验总结的最终报告。\n\n```bash\n\u002Fproject:session-end\n```\n\n### 4. 查看状态与历史\n随时检查当前会话详情或浏览过往记录。\n\n```bash\n# 查看当前活跃会话的状态\n\u002Fproject:session-current\n\n# 列出所有历史会话及其摘要\n\u002Fproject:session-list\n```\n\n通过上述流程，你可以轻松实现开发过程的自动化文档化，让 AI 助手在后续会话中快速理解之前的工作背景。","某全栈开发者正在利用 Claude Code 重构一个遗留系统的认证模块，该任务复杂且需分多天断续完成。\n\n### 没有 claude-sessions 时\n- **上下文断裂**：每次重新开启对话，AI 都会“失忆”，开发者不得不重复粘贴之前的代码片段和决策逻辑，浪费大量时间重建上下文。\n- **进度黑盒**：缺乏统一记录，难以清晰追踪哪些功能已实现、哪些待办事项被搁置，导致开发节奏混乱。\n- **决策丢失**：中途遇到的技术坑点及解决方案仅存在于临时对话中，几天后回顾时完全忘记当初为何选择特定方案，增加维护风险。\n- **交接困难**：若需团队成员介入，必须人工整理冗长的聊天记录才能说明当前状态，沟通成本极高。\n\n### 使用 claude-sessions 后\n- **无缝续接**：通过 `\u002Fproject:session-start` 和 `\u002Fproject:session-update`，系统自动将每日进展写入 Markdown 文件，新会话能瞬间读取历史背景，无需重复解释。\n- **透明追踪**：所有 Git 变更、待办列表和实施细节被结构化记录，随时运行 `\u002Fproject:session-current` 即可一目了然掌握项目全景。\n- **知识沉淀**：遇到的报错与解决思路被自动归档至会话文档，形成可检索的项目知识库，避免重复踩坑。\n- **高效协作**：新成员只需查看 `sessions\u002F` 目录下的时间线文档，即可快速理解演进脉络并接手工作，实现平滑的知识转移。\n\nclaude-sessions 将碎片化的 AI 对话转化为结构化的项目资产，让长周期开发任务拥有连续的记忆与清晰的轨迹。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fiannuttall_claude-sessions_74225342.png","iannuttall","Ian Nuttall","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fiannuttall_fc7f8590.jpg","TLDR; I make software with AI and talk about it.  Serial internet biz builder with multiple 6 & 7 figure exits. Always learning.",null,"Nottingham","https:\u002F\u002Fian.is","https:\u002F\u002Fgithub.com\u002Fiannuttall",1179,140,"2026-04-05T07:35:36","MIT","Linux, macOS, Windows","未说明",{"notes":90,"python":88,"dependencies":91},"该工具并非独立的 AI 模型，而是专为 Anthropic 的 Claude Code 命令行工具设计的自定义斜杠命令集。运行前提是本地已安装并配置好 Claude Code。它通过读写项目目录下的 Markdown 文件（commands\u002F 和 sessions\u002F）来管理会话状态，需要 Git 环境以获取代码变更状态。无需 GPU、特定 Python 版本或额外的深度学习库依赖。",[92],"Claude Code",[15,36],"2026-03-27T02:49:30.150509","2026-04-06T09:25:37.976021",[97,102,106,111,115,119],{"id":98,"question_zh":99,"answer_zh":100,"source_url":101},18737,"这个仓库还在维护吗？为什么很久没有更新了？","该仓库目前基本不再活跃维护。维护者承认之前的 README 文档导致了混淆，并表示现在有更简单的 `\u002Fend-session` 和 `\u002Fstart-session` 命令可供使用。此外，随着 Claude Code 升级到 Opus 4.5 模型，其内置了自动计划管理功能（自动更新主目录中的 plan MD 文件），能够处理高达 200k 的上下文窗口，因此手动会话管理已不再必要（YAGNI 原则）。建议用户直接使用 Claude Code 的原生功能。","https:\u002F\u002Fgithub.com\u002Fiannuttall\u002Fclaude-sessions\u002Fissues\u002F13",{"id":103,"question_zh":104,"answer_zh":105,"source_url":101},18738,"这里的斜杠命令（slash-commands）是真正的自定义实现吗？","不是真正的自定义实现。这些命令之所以能工作，主要依赖于 Claude 的意图识别能力，而非实际的代码逻辑。如果你开启 `--verbose --debug` 模式，会发现 Claude 是在通过推理猜测用户意图并搜索代码库，而不是执行预定义的脚本。即使将命令放在顶层目录而非 `.claude\u002Fcommands\u002F` 下也能“生效”，是因为 Claude 根据上下文线索自行完成了任务，甚至可以根据用户的描述即时“创造”出新命令。",{"id":107,"question_zh":108,"answer_zh":109,"source_url":110},18739,"这个会话系统与 Claude Code 原生的会话系统有关联吗？","没有关联。该系统与 Claude Code 自身的会话系统（即存储在 `~\u002F.claude\u002Fprojects\u002F...` 中的会话和上下文数据）是完全独立的。","https:\u002F\u002Fgithub.com\u002Fiannuttall\u002Fclaude-sessions\u002Fissues\u002F11",{"id":112,"question_zh":113,"answer_zh":114,"source_url":101},18740,"既然 Claude Code 已经有 Plan Mode（计划模式），这个仓库还有什么存在的必要吗？","在旧版本中，该仓库用于记录决策背后的原因以及修复的错误，这是简单的计划列表所不具备的。但在当前版本中，由于 Anthropic 引入了更强大的内置计划管理功能（自动压缩上下文、自动创建新计划文件），手动管理会话的需求已基本消失。对于大多数用户来说，保持自动压缩开启并依赖原生功能即可处理大型任务。",{"id":116,"question_zh":117,"answer_zh":118,"source_url":101},18741,"如果我想在现在的 Claude Code 中管理会话，推荐的做法是什么？","推荐使用维护者提到的更简单的原生命令 `\u002Fend-session` 和 `\u002Fstart-session`。同时，利用新版模型（如 Opus 4.5）的自动计划管理功能：只需保持上下文压缩设置为“自动”，Claude Code 会自动在主目录更新计划文件；当任务范围变化或清除上下文时，它会自动创建新的计划文件，无需人工干预。",{"id":120,"question_zh":121,"answer_zh":122,"source_url":101},18742,"为什么我把命令放在顶层目录而不是 `.claude\u002Fcommands\u002F` 下也能运行？","这并非因为系统支持顶层目录配置，而是因为 Claude 的意图识别机制在起作用。当找不到明确的命令定义时，Claude 会阅读整个代码库和上下文，推测用户想要执行的操作并直接执行。这是一种基于上下文的“魔法”，而非标准化的命令加载流程。官方推荐的命令存放位置仍然是 `.claude\u002Fcommands\u002F`。",[]]