[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-context-machine-lab--sleepless-agent":3,"tool-context-machine-lab--sleepless-agent":64},[4,17,27,35,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},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,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"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,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"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",[14,43,44,45,15,46,26,13,47],"数据工具","视频","插件","其他","音频",{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,46],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"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",[26,15,13,45],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":70,"readme_en":71,"readme_zh":72,"quickstart_zh":73,"use_case_zh":74,"hero_image_url":75,"owner_login":76,"owner_name":77,"owner_avatar_url":78,"owner_bio":79,"owner_company":80,"owner_location":80,"owner_email":81,"owner_twitter":80,"owner_website":80,"owner_url":82,"languages":83,"stars":92,"forks":93,"last_commit_at":94,"license":95,"difficulty_score":10,"env_os":96,"env_gpu":97,"env_ram":97,"env_deps":98,"category_tags":106,"github_topics":107,"view_count":23,"oss_zip_url":80,"oss_zip_packed_at":80,"status":16,"created_at":123,"updated_at":124,"faqs":125,"releases":155},2902,"context-machine-lab\u002Fsleepless-agent","sleepless-agent","🤖 24\u002F7 AI agent that maximizes Claude Code Pro usage via Slack. Auto-processes tasks, manages isolated workspaces, creates Git commits\u002FPRs, and optimizes day\u002Fnight usage thresholds.","sleepless-agent 是一款专为开发者打造的\"24\u002F7 全天候智能体操作系统”，旨在让 Claude Code Pro 在你休息时也能持续工作。它通过 Slack 或命令行接收指令，自动处理从灵光一闪的想法到严肃的开发任务，并在隔离的工作空间中并行执行代码编写、Git 提交及 Pull Request 创建等全流程操作。\n\n该工具主要解决了高端 AI 编程资源（如 Claude Code Pro）在夜间或非工作时间闲置浪费的问题，同时消除了多任务并行时的环境冲突风险。通过智能调度策略，它能根据昼夜阈值优化资源使用，确保白天交互流畅、夜间全速运转，将零散的创意自动转化为可落地的代码成果。\n\nsleepless-agent 特别适合需要高效管理开发流程的软件工程师、技术团队及 AI 研究者。其核心技术亮点包括：基于 SQLite 的持久化任务队列、为每个任务分配独立沙箱环境以实现真正的并行处理，以及“混合自主”模式——即对随机想法自动执行，对重要任务保留人工审核环节。无论是想利用碎片时间推进项目，还是构建自动化研发流水线，sleepless-agent 都能成为你不知疲倦的编程伙","sleepless-agent 是一款专为开发者打造的\"24\u002F7 全天候智能体操作系统”，旨在让 Claude Code Pro 在你休息时也能持续工作。它通过 Slack 或命令行接收指令，自动处理从灵光一闪的想法到严肃的开发任务，并在隔离的工作空间中并行执行代码编写、Git 提交及 Pull Request 创建等全流程操作。\n\n该工具主要解决了高端 AI 编程资源（如 Claude Code Pro）在夜间或非工作时间闲置浪费的问题，同时消除了多任务并行时的环境冲突风险。通过智能调度策略，它能根据昼夜阈值优化资源使用，确保白天交互流畅、夜间全速运转，将零散的创意自动转化为可落地的代码成果。\n\nsleepless-agent 特别适合需要高效管理开发流程的软件工程师、技术团队及 AI 研究者。其核心技术亮点包括：基于 SQLite 的持久化任务队列、为每个任务分配独立沙箱环境以实现真正的并行处理，以及“混合自主”模式——即对随机想法自动执行，对重要任务保留人工审核环节。无论是想利用碎片时间推进项目，还是构建自动化研发流水线，sleepless-agent 都能成为你不知疲倦的编程伙伴。","\u003Cdiv align=\"center\">\n\n# Sleepless Agent\n\n**A 24\u002F7 AgentOS that works while you sleep**\n\n[![Documentation](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocumentation-007ACC?style=for-the-badge&logo=markdown&logoColor=white)](https:\u002F\u002Fcontext-machine-lab.github.io\u002Fsleepless-agent\u002F)\n[![DeepWiki](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDeepWiki-582C83?style=for-the-badge&logo=wikipedia&logoColor=white)](https:\u002F\u002Fdeepwiki.com\u002Fcontext-machine-lab\u002Fsleepless-agent)\n[![WeChat](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWeChat-07C160?style=for-the-badge&logo=wechat&logoColor=white)](.\u002Fassets\u002Fwechat.png)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002F74my3Wkn)\n\n\u003C\u002Fdiv>\n\nHave Claude Code Pro but not using it at night? Transform it into an AgentOS that handles your ideas and tasks while you sleep. This is a 24\u002F7 AI assistant daemon powered by Claude Code CLI and Python Agent SDK that processes both random thoughts and serious tasks via Slack with isolated workspaces.\n\n## 📰 News\n\n- **[2025-10-26]** 🎉 Initial release v0.1.0 - Full AgentOS with multi-agent workflow support\n- **[2025-10-25]** 🚀 Added task auto-generation with configurable strategies\n- **[2025-10-24]** 🔧 Integrated Git management with automatic PR creation\n- **[2025-10-23]** 📊 Implemented isolated workspaces for parallel task execution\n- **[2025-10-22]** 💡 Added Claude Code Python Agent SDK integration\n\n## 🎬 Demo\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcontext-machine-lab_sleepless-agent_readme_cde495fca9b0.png\" alt=\"Sleepless Agent System Architecture\" width=\"700\">\n  \u003Cp>\u003Cem>System architecture showing task flow from Slack to workspace execution\u003C\u002Fem>\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcontext-machine-lab_sleepless-agent_readme_dc4ff3369580.png\" alt=\"Sleepless Agent CLI Demo\" width=\"800\">\n  \u003Cp>\u003Cem>Sleepless Agent CLI in action - managing tasks, checking status, and generating reports\u003C\u002Fem>\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n### Quick Example\n\n```bash\n# Start the daemon\n$ sle daemon\n2025-10-26 03:30:12 | INFO | Sleepless Agent starting...\n2025-10-26 03:30:12 | INFO | Slack bot connected\n\n# Submit a task via Slack\n\u002Fthink Implement OAuth2 authentication -p backend\n\n# Check status\n$ sle check\n╭─────────────────── System Status ───────────────────╮\n│ 🟢 Daemon: Running                                  │\n│ 📊 Queue: 3 pending, 1 in_progress                  │\n│ 💻 Usage: 45% (Day threshold: 95%)                  │\n│ 🔄 Last task: \"Implement OAuth2...\" (in progress)   │\n╰─────────────────────────────────────────────────────╯\n\n# View results\n$ sle report 42\nTask #42: ✅ Completed\nBranch: feature\u002Fbackend-42\nPR: https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo\u002Fpull\u002F123\n```\n\n## ✨ Features\n\n- 🤖 **Continuous Operation**: Runs 24\u002F7 daemon, always ready for new tasks\n- 💬 **Slack Integration**: Submit tasks via Slack commands\n- 💭 **Interactive Chat Mode**: Real-time conversational sessions with Claude in Slack threads\n- 🎯 **Hybrid Autonomy**: Auto-applies random thoughts, requires review for serious tasks\n- ⚡ **Smart Scheduling**: Optimizes task execution based on priorities\n- 📊 **Task Queue**: SQLite-backed persistent task management\n- 🔌 **Claude Code SDK**: Uses Python Agent SDK to interface with Claude Code CLI\n- 🏗️ **Isolated Workspaces**: Each task gets its own workspace for true parallelism\n- 📝 **Result Storage**: All outputs saved with metadata for future reference\n\n## ⚙️ Prerequisites\n\n- Python 3.11+\n- Claude Code CLI installed (`npm install -g @anthropic-ai\u002Fclaude-code`)\n- Git (for auto-commits)\n- gh CLI (optional, for PR automation)\n- Slack workspace admin access (**optional** — the `sle` CLI works without Slack)\n\n> 💡 **Slack is optional.** You can run all `sle` CLI commands without configuring Slack. Slack integration adds a convenient real-time interface for submitting tasks and checking status, but every feature is also available via the CLI.\n\n## 🚀 Quick Start\n\n### 1. Install\n\n```bash\npip install sleepless-agent\n```\n\nOr for development:\n```bash\ngit clone \u003Crepo>\ncd sleepless-agent\npython -m venv venv\nsource venv\u002Fbin\u002Factivate  # or venv\\Scripts\\activate on Windows\npip install -e .\n```\n\n> ⚠️ **Windows \u002F WSL tip:** After `pip install`, the `sle` command might not be found if Python's `Scripts` directory is not on your `PATH`. See [Troubleshooting: `sle` not found](#windows--wsl-sle-command-not-found) below.\n\n### 2. Authenticate Claude Code (Required)\n\n```bash\n# Install the Claude Code CLI (requires Node.js)\nnpm install -g @anthropic-ai\u002Fclaude-code\n\n# Log in once (opens a browser)\nclaude login\n\n# Verify\nclaude --version\n```\n\n### 3. (Optional) Start without Slack\n\nSlack integration is **not required**. You can use the `sle` CLI directly:\n\n```bash\n# Start the daemon (no Slack needed)\nsle daemon\n\n# Queue a task\nsle think \"Research async Python patterns\"\n\n# Check status\nsle check\n```\n\nIf you want Slack integration, continue with the setup below.\n\n### 4. Setup Slack App\n\nVisit https:\u002F\u002Fapi.slack.com\u002Fapps and create a new app:\n\n**Basic Information**\n- Choose \"From scratch\"\n- Name: \"Sleepless Agent\"\n- Pick your workspace\n\n**Enable Socket Mode**\n- Settings > Socket Mode > Toggle ON\n- Generate app token (starts with `xapp-`)\n\n**Create Slash Commands**\nSettings > Slash Commands > Create New Command:\n- `\u002Fthink` - Capture thought or task (use `-p project-name` for serious tasks)\n- `\u002Fchat` - Start interactive chat mode with Claude\n- `\u002Fcheck` - Check queue status\n- `\u002Fusage` - Show Claude Code Pro plan usage\n- `\u002Fcancel` - Cancel task or project\n- `\u002Freport` - Show reports or task details\n- `\u002Ftrash` - Manage trash (list, restore, empty)\n\n**OAuth Scopes**\nFeatures > OAuth & Permissions > Bot Token Scopes:\n- `chat:write`\n- `commands`\n- `app_mentions:read`\n- `channels:history` (for chat mode)\n- `groups:history` (for chat mode in private channels)\n- `reactions:write` (for chat mode indicators)\n\n**Event Subscriptions** (for Chat Mode)\nFeatures > Event Subscriptions > Enable Events > Subscribe to bot events:\n- `message.channels`\n- `message.groups`\n\n**Install App**\n- Install to workspace\n- Get bot token (starts with `xoxb-`)\n\n### 5. Configure Environment\n\n```bash\ncp .env.example .env\nnano .env  # Edit with your tokens\n```\n\nSet:\n- `SLACK_BOT_TOKEN` - xoxb-... token\n- `SLACK_APP_TOKEN` - xapp-... token\n\n(Claude API key no longer needed - uses Claude Code CLI)\n\n### 6. Run\n\n```bash\nsle daemon\n```\n\nYou should see startup logs similar to:\n```\n2025-10-24 23:30:12 | INFO     | sleepless_agent.interfaces.bot.start:50 Slack bot started and listening for events\n2025-10-24 23:30:12 | INFO     | sleepless_agent.runtime.daemon.run:178 Sleepless Agent starting...\n```\nLogs are rendered with Rich for readability; set `SLEEPLESS_LOG_LEVEL=DEBUG` to increase verbosity.\n\n## 🖥️ Windows \u002F WSL: `sle` Command Not Found\n\nIf `sle` is not recognised after `pip install` on Windows or WSL, the Python `Scripts` directory is likely not on your `PATH`.\n\n**Windows (PowerShell \u002F CMD)**\n\n```powershell\n# Find where pip installed the script\npython -m site --user-scripts\n\n# Add that directory to PATH permanently (PowerShell)\n$scriptsDir = python -m site --user-scripts\n[Environment]::SetEnvironmentVariable(\"PATH\", \"$env:PATH;$scriptsDir\", \"User\")\n\n# Or run sle directly with python -m\npython -m sleepless_agent.interfaces.cli --help\n```\n\n**WSL (Ubuntu \u002F Debian)**\n\n```bash\n# Add the local bin directory to PATH\necho 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> ~\u002F.bashrc\nsource ~\u002F.bashrc\n\n# Verify\nsle --version\n```\n\n**System-wide pip install (not recommended)**\n\nIf you used `sudo pip install`, the script will be in `\u002Fusr\u002Flocal\u002Fbin` which is normally already in PATH. However, prefer using a virtual environment or `pip install --user`.\n\n**Virtual environment (recommended)**\n\nUsing a virtual environment avoids PATH issues on all platforms:\n\n```bash\npython -m venv venv\n# Windows:\nvenv\\Scripts\\activate\n# macOS \u002F Linux \u002F WSL:\nsource venv\u002Fbin\u002Factivate\n\npip install sleepless-agent\nsle --version  # always works inside the venv\n```\n\n\n## 💬 Slack Commands\n\nAll Slack commands align with the CLI commands for consistency:\n\n### 📋 Task Management\n\n| Command | Purpose | Example |\n|---------|---------|---------|\n| `\u002Fthink` | Capture random thought | `\u002Fthink Explore async ideas` |\n| `\u002Fthink -p \u003Cproject>` | Add serious task to project | `\u002Fthink Add OAuth2 support -p backend` |\n| `\u002Fcheck` | Show system status | `\u002Fcheck` |\n| `\u002Fusage` | Show Claude Code Pro usage | `\u002Fusage` |\n| `\u002Fcancel` | Cancel task or project | `\u002Fcancel 5` or `\u002Fcancel my-app` |\n\n### 💭 Interactive Chat Mode\n\nStart a real-time conversation with Claude in a dedicated Slack thread:\n\n| Command | Purpose | Example |\n|---------|---------|---------|\n| `\u002Fchat \u003Cproject>` | Start chat mode for a project | `\u002Fchat my-backend` |\n| `\u002Fchat end` | End current chat session | `\u002Fchat end` |\n| `\u002Fchat status` | Check active session status | `\u002Fchat status` |\n| `\u002Fchat help` | Show chat mode help | `\u002Fchat help` |\n\n**Chat Mode Features:**\n- 🧵 Dedicated thread for each session\n- 💬 Full conversation history maintained\n- 🔄 Real-time processing indicator\n- 📁 Claude can read\u002Fwrite\u002Fedit files in project workspace\n- ⏱️ Auto-timeout after 30 minutes of inactivity\n- Type `exit` in thread to end session\n\n> 💡 **Note**: When you run `\u002Fchat \u003Cproject>`, a new thread is created. All your prompts must be sent **inside this thread** - Claude only responds to messages within the chat thread, not in the main channel.\n\n### 📊 Reporting & Trash\n\n| Command | Purpose | Example |\n|---------|---------|---------|\n| `\u002Freport` | Today's report, task details, date\u002Fproject report, or list all | `\u002Freport`, `\u002Freport 42`, `\u002Freport 2025-10-22`, `\u002Freport my-app`, `\u002Freport --list` |\n| `\u002Ftrash` | List, restore, or empty trash | `\u002Ftrash list`, `\u002Ftrash restore my-app`, `\u002Ftrash empty` |\n\n## ⌨️ Command Line Interface\n\nInstall the project (or run within the repo) and use the bundled CLI:\n\n```bash\npython -m sleepless_agent.interfaces.cli think \"Ship release checklist\" -p my-app\n# or, after installing the package:\nsle check\n```\n\nThe CLI mirrors the Slack slash commands:\n\n| Command | Purpose | Example |\n|---------|---------|---------|\n| `think \u003Cdescription>` | Capture a random thought | `think \"Explore async patterns\"` |\n| `think \u003Cdescription> -p \u003Cproject>` | Queue a serious task to project | `think \"Build onboarding flow\" -p backend` |\n| `check` | Show system health, queue, and performance metrics | `check` |\n| `usage` | Show Claude Code Pro plan usage | `usage` |\n| `report [identifier]` | Show task details, daily reports, or project summaries (`--list` for all reports) | `report 7` |\n| `cancel \u003Cidentifier>` | Move a task or project to trash | `cancel 9` or `cancel my-app` |\n| `trash [subcommand] [identifier]` | Manage trash (list, restore, empty) | `trash restore my-app` |\n\nOverride storage locations when needed:\n\n```bash\nsle --db-path .\u002Ftmp\u002Ftasks.db --results-path .\u002Ftmp\u002Fresults check\n```\n\n## 🏗️ Architecture\n\n```\nSlack Bot\n    ↓\nSlack Commands → Task Queue (SQLite)\n    ↓\nAgent Daemon (Event Loop)\n    ↓\nClaude Executor (Claude Code CLI)\n    ↓\nResult Manager (Storage + Git)\n```\n\n### Components\n\n- **daemon.py**: Main event loop, task orchestration\n- **bot.py**: Slack interface, command parsing\n- **task_queue.py**: Task CRUD, priority scheduling\n- **claude_code_executor.py**: Python Agent SDK wrapper with isolated workspace management\n- **results.py**: Result storage, file management\n- **models.py**: SQLAlchemy models for Task, Result\n- **config.yaml**: Configuration defaults\n- **git_manager.py**: Git automation (commits, PRs)\n- **monitor.py**: Health checks and metrics\n\n## 📁 File Structure\n\n```\nsleepless-agent\u002F\n├── src\u002Fsleepless_agent\u002F\n│   ├── __init__.py\n│   ├── daemon.py           # Main event loop\n│   ├── bot.py              # Slack interface\n│   ├── task_queue.py       # Task management\n│   ├── claude_code_executor.py  # Claude CLI wrapper\n│   ├── scheduler.py        # Smart scheduling\n│   ├── git_manager.py      # Git automation\n│   ├── monitor.py          # Health & metrics\n│   ├── models.py           # Database models\n│   ├── results.py          # Result storage\n│   └── config.yaml         # Config defaults\n├── workspace\u002F              # All persistent data and task workspaces\n│   ├── data\u002F               # Persistent storage\n│   │   ├── tasks.db        # SQLite database\n│   │   ├── results\u002F        # Task output files\n│   │   ├── reports\u002F        # Daily markdown reports\n│   │   ├── agent.log       # Application logs\n│   │   └── metrics.jsonl   # Performance metrics\n│   ├── tasks\u002F              # Task workspaces (task_1\u002F, task_2\u002F, etc.)\n│   ├── projects\u002F           # Project workspaces\n│   └── trash\u002F              # Soft-deleted projects\n├── .env                    # Secrets (not tracked)\n├── pyproject.toml          # Python package metadata & dependencies\n├── README.md              # This file\n└── docs\u002F                  # Additional documentation\n```\n\n## ⚙️ Configuration\n\nRuntime settings come from environment variables loaded via `.env` (see `.env.example`). Update those values or export them in your shell to tune agent behavior.\n\n### Usage Management\n\nThe agent automatically monitors Claude Code usage and intelligently manages task execution based on configurable thresholds.\n\n**How it works:**\n\n1. **Usage Monitoring** - Every task checks usage via `claude \u002Fusage` command\n2. **Time-based Thresholds** - Different thresholds for day and night operations\n3. **Smart Scheduling** - Automatically pauses task generation when threshold is reached\n4. **Automatic Resume** - Tasks resume when usage resets\n\n**Time-Based Configuration (configurable in `config.yaml`):**\n- **Nighttime (1 AM - 9 AM by default):** 96% threshold - agent works aggressively while you sleep\n- **Daytime (9 AM - 1 AM by default):** 95% threshold - preserves capacity for your manual usage\n- Configure via: `claude_code.threshold_day`, `claude_code.threshold_night`\n- Time ranges via: `claude_code.night_start_hour`, `claude_code.night_end_hour`\n\n**Visibility:**\n- Dashboard: Shows usage percentage in `sle check`\n- Logs: Each usage check logs current usage with applicable threshold\n- Config: All thresholds and time ranges adjustable in `config.yaml`\n\n**Behavior at threshold:**\n- ⏸️ New task generation pauses at threshold\n- ✅ Running tasks complete normally\n- 📋 Pending tasks wait in queue\n- ⏱️ Automatic resume when usage resets\n\n### Git Management\n\nThe agent integrates deeply with Git for automatic version control and collaboration:\n\n**Remote Repository Configuration (`config.yaml`):**\n- `git.use_remote_repo`: Enable\u002Fdisable remote repository integration\n- `git.remote_repo_url`: Your remote repository URL (e.g., `git@github.com:username\u002Frepo.git`)\n- `git.auto_create_repo`: Automatically create repository if it doesn't exist\n\n**Git Workflow:**\n- **Random Thoughts**: Auto-commits to `thought-ideas` branch\n- **Serious Tasks (-p flag)**: Creates feature branches (`feature\u002F\u003Cproject>-\u003Ctask_id>`) and opens PRs\n- **Automatic Commits**: Each task completion triggers a commit with descriptive messages\n- **PR Creation**: Serious tasks automatically create pull requests for review\n\n**Important:** Update `git.remote_repo_url` in `config.yaml` before running the agent!\n\n### Multi-Agent Workflow\n\nThe agent employs a sophisticated multi-agent architecture for complex task processing:\n\n**Agent Types (`config.yaml`):**\n- **Planner Agent**: Analyzes tasks and creates execution plans (max 3 turns by default)\n- **Worker Agent**: Executes the planned tasks (max 3 turns by default)\n- **Evaluator Agent**: Reviews and validates completed work (max 3 turns by default)\n\n**Configuration:**\n```yaml\nmulti_agent_workflow:\n  planner:\n    enabled: true\n    max_turns: 3\n  worker:\n    enabled: true\n    max_turns: 3\n  evaluator:\n    enabled: true\n    max_turns: 3\n```\n\nEach agent can be independently enabled\u002Fdisabled and configured with different turn limits to control execution depth.\n\n### Task Auto-Generation\n\nThe agent can automatically generate tasks to keep itself productive during idle time:\n\n**Generation Strategies (`config.yaml`):**\n- **refine_focused (45% weight)**: Focuses on completing or improving existing work\n- **balanced (35% weight)**: Mix of refinements and new tasks based on workspace state\n- **new_friendly (20% weight)**: Prioritizes creating innovative new projects\n\n**Task Types:**\n- **[NEW]**: Creates a new task in an isolated workspace (`workspace\u002Ftasks\u002F\u003Ctask_id>\u002F`)\n- **[REFINE:#\u003Cid>]**: Improves specific existing task (reuses task workspace)\n- **[REFINE]**: General refinement of workspace projects\n\n**Workspace Constraints:**\n- Each task executes in its own isolated directory\n- Tasks only access their workspace and `workspace\u002Fshared\u002F`\n- System directories (`workspace\u002Fdata\u002F`) are protected\n- REFINE tasks reuse existing workspaces for continuity\n\n\n## 🔧 Environment Variables\n\n```bash\n# Required\nSLACK_BOT_TOKEN=xoxb-...\nSLACK_APP_TOKEN=xapp-...\n```\n\n**Note:** Most configuration is done via `config.yaml`. Environment variables are primarily for secrets and deployment-specific settings.\n\n## 📝 Task Types\n\nThe agent intelligently processes different task types:\n\n1. **Random Thoughts** - Auto-commits to `thought-ideas` branch\n   ```\n   \u002Fthink Research async patterns in Rust\n   \u002Fthink What's the best way to implement caching?\n   ```\n\n2. **Serious Tasks** - Creates feature branch and PR, requires review (use `-p` flag)\n   ```\n   \u002Fthink -p backend Add authentication to user service\n   \u002Fthink -p payments Refactor payment processing module\n   ```\n\n## 📊 Monitoring\n\n### Slack Commands\n```\n\u002Fcheck    # System status and performance stats\n\u002Freport --list  # Available reports\n```\n\n## 🚢 Deployment\n\n### Linux (systemd)\n```bash\nmake install-service\nsudo systemctl start sleepless-agent\n```\n\n### macOS (launchd)\n```bash\nmake install-launchd\nlaunchctl list | grep sleepless\n```\n\n## 💡 Example Workflows\n\n### Daily Brainstorm\n```\n\u002Fthink Research new Rust async libraries\n\u002Fthink Compare Python web frameworks\n\u002Fthink Ideas for improving API performance\n\u002Fcheck\n```\n\n### Production Fix\n```\n\u002Fthink Fix authentication bug in login endpoint -p backend\n\u002Freport \u003Cid>     # Get the PR link\n# Review and merge PR\n```\n\n### Code Audit\n```\n\u002Fthink Security audit of user service -p backend\n\u002Fthink Performance analysis of payment module -p payments\n```\n\n## ⚡ Performance Tips\n\n1. **Use thoughts to fill idle time** - Maximizes usage\n2. **Batch serious tasks** - Reduces context switching\n3. **Monitor usage** - Watch scheduler logs for usage patterns\n4. **Review git history** - Check `thought-ideas` branch regularly\n5. **Check metrics** - Run `sle check` to track performance\n\n## 📦 Releases\n\n- Latest stable: **0.1.0** – published on [PyPI](https:\u002F\u002Fpypi.org\u002Fproject\u002Fsleepless-agent\u002F0.1.0\u002F)\n- Install or upgrade with `pip install -U sleepless-agent`\n- Release notes tracked via GitHub Releases (tag `v0.1.0` onward)\n\n## 📚 Documentation\n\nFor more detailed information and guides:\n\n- **[Full Documentation](https:\u002F\u002Fcontext-machine-lab.github.io\u002Fsleepless-agent\u002F)** - Complete documentation site\n- **[DeepWiki](https:\u002F\u002Fdeepwiki.com\u002Fcontext-machine-lab\u002Fsleepless-agent)** - Interactive knowledge base\n- **[Installation Guide](docs\u002Finstallation.md)** - Detailed setup instructions\n- **[Quick Start](docs\u002Fquickstart.md)** - Get up and running quickly\n- **[FAQ](docs\u002Ffaq.md)** - Frequently asked questions\n- **[Troubleshooting](docs\u002Ftroubleshooting.md)** - Common issues and solutions\n\n## 🗺️ Roadmap\n\n- [ ] **Advanced Scheduling** - Priority queue with time-based and dependency scheduling\n- [ ] **Daily Report** - Daily report of the agent's work\n\n## 🙏 Acknowledgements\n\nWe are deeply grateful to the open-source community and the projects that make Sleepless Agent possible:\n\n- **[Claude Code CLI](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code)** - For providing the powerful foundation for AI-assisted development and the Python Agent SDK that enables seamless integration\n- **[Slack Bolt](https:\u002F\u002Fgithub.com\u002Fslackapi\u002Fbolt-python)** - For reliable real-time messaging and command handling that powers our Slack integration\n- **[SQLAlchemy](https:\u002F\u002Fwww.sqlalchemy.org\u002F)** - For robust data persistence and elegant ORM that manages our task queue\n- **[Rich](https:\u002F\u002Fgithub.com\u002FTextualize\u002Frich)** - For beautiful terminal rendering that makes logs and outputs visually appealing\n- **[GitPython](https:\u002F\u002Fgithub.com\u002Fgitpython-developers\u002FGitPython)** - For comprehensive Git operations that enable our automated version control workflows\n\n## 🤝 Contributing\n\nWe welcome contributions! Sleepless Agent is designed to be a community resource for 24\u002F7 AI development automation.\n\nPlease see our [Contributing Guidelines](CONTRIBUTING.md) for:\n- Development setup and environment configuration\n- Code style and testing requirements\n- How to submit pull requests\n- Community guidelines and code of conduct\n\nFeel free to:\n- 🐛 [Report bugs](https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002Fnew?labels=bug)\n- 💡 [Suggest features](https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002Fnew?labels=enhancement)\n- 💬 [Ask questions](https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fdiscussions)\n- 🔧 [Submit pull requests](https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fpulls)\n\n## 📖 Citation\n\nIf you use Sleepless Agent in your research or projects, please cite:\n\n```bibtex\n@software{sleepless_agent_2025,\n  title = {Sleepless Agent: A 24\u002F7 AgentOS for Continuous Development},\n  author = {Zhimeng Guo, Hangfan Zhang, Siyuan Xu, Huaisheng Zhu, Teng Xiao, Minhao Cheng},\n  year = {2025},\n  publisher = {GitHub},\n  journal = {GitHub repository},\n  url = {https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent}\n}\n```\n\n## 📄 License\n\nReleased under the [MIT License](LICENSE)\n\n## 🔧 Development\n\nTested Sleepless Agent integration on 2025-12-15.\n","\u003Cdiv align=\"center\">\n\n# 无眠智能体\n\n**一个在你睡觉时也能工作的全天候AgentOS**\n\n[![文档](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDocumentation-007ACC?style=for-the-badge&logo=markdown&logoColor=white)](https:\u002F\u002Fcontext-machine-lab.github.io\u002Fsleepless-agent\u002F)\n[![DeepWiki](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDeepWiki-582C83?style=for-the-badge&logo=wikipedia&logoColor=white)](https:\u002F\u002Fdeepwiki.com\u002Fcontext-machine-lab\u002Fsleepless-agent)\n[![微信](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FWeChat-07C160?style=for-the-badge&logo=wechat&logoColor=white)](.\u002Fassets\u002Fwechat.png)\n[![Discord](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDiscord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https:\u002F\u002Fdiscord.gg\u002F74my3Wkn)\n\n\u003C\u002Fdiv>\n\n你有Claude Code Pro却只在白天使用吗？把它变成一个在你睡觉时也能处理你的想法和任务的AgentOS吧！这是一个基于Claude Code CLI和Python Agent SDK的全天候AI助手守护进程，它通过Slack与隔离的工作空间协作，既能处理灵光一现的想法，也能完成严肃的任务。\n\n## 📰 新闻\n\n- **[2025-10-26]** 🎉 初始发布 v0.1.0 - 全功能AgentOS，支持多智能体工作流\n- **[2025-10-25]** 🚀 增加了可配置策略的任务自动生成功能\n- **[2025-10-24]** 🔧 集成了Git管理，并可自动创建Pull Request\n- **[2025-10-23]** 📊 实现了用于并行任务执行的隔离工作空间\n- **[2025-10-22]** 💡 添加了Claude Code Python Agent SDK集成\n\n## 🎬 演示\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcontext-machine-lab_sleepless-agent_readme_cde495fca9b0.png\" alt=\"Sleepless Agent 系统架构\" width=\"700\">\n  \u003Cp>\u003Cem>系统架构展示了从Slack到工作空间执行的任务流程\u003C\u002Fem>\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcontext-machine-lab_sleepless-agent_readme_dc4ff3369580.png\" alt=\"Sleepless Agent CLI演示\" width=\"800\">\n  \u003Cp>\u003Cem>Sleepless Agent CLI的实际操作——管理任务、查看状态以及生成报告\u003C\u002Fem>\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n### 快速示例\n\n```bash\n# 启动守护进程\n$ sle daemon\n2025-10-26 03:30:12 | INFO | Sleepless Agent 正在启动...\n2025-10-26 03:30:12 | INFO | Slack机器人已连接\n\n# 通过Slack提交任务\n\u002Fthink 实现OAuth2认证 -p backend\n\n# 查看状态\n$ sle check\n╭─────────────────── 系统状态 ───────────────────╮\n│ 🟢 守护进程：运行中                                  │\n│ 📊 队列：3个待处理，1个进行中                      │\n│ 💻 使用率：45%（每日阈值：95%）                      │\n│ 🔄 最后一项任务：“实现OAuth2…”（正在进行中）       │\n╰─────────────────────────────────────────────────────╯\n\n# 查看结果\n$ sle report 42\n任务 #42：✅ 已完成\n分支：feature\u002Fbackend-42\nPR：https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo\u002Fpull\u002F123\n```\n\n## ✨ 特性\n\n- 🤖 **持续运行**：24\u002F7守护进程，随时准备接收新任务\n- 💬 **Slack集成**：通过Slack命令提交任务\n- 💭 **交互式聊天模式**：在Slack线程中与Claude进行实时对话\n- 🎯 **混合自主性**：随机想法会自动处理，而重要任务则需要审核\n- ⚡ **智能调度**：根据优先级优化任务执行\n- 📊 **任务队列**：基于SQLite的持久化任务管理\n- 🔌 **Claude Code SDK**：使用Python Agent SDK与Claude Code CLI对接\n- 🏗️ **隔离的工作空间**：每个任务都有自己的独立工作空间，真正实现并行处理\n- 📝 **结果存储**：所有输出连同元数据都会保存下来，方便日后查阅\n\n## ⚙️ 前置条件\n\n- Python 3.11+\n- 已安装Claude Code CLI（`npm install -g @anthropic-ai\u002Fclaude-code`）\n- Git（用于自动提交）\n- gh CLI（可选，用于自动化PR创建）\n- Slack工作区管理员权限（**可选**——`sle` CLI无需Slack即可使用）\n\n> 💡 **Slack并非必需。** 你可以不配置Slack直接运行所有`sle` CLI命令。Slack集成提供了一个便捷的实时界面来提交任务和查看状态，但所有功能同样可以通过CLI访问。\n\n## 🚀 快速开始\n\n### 1. 安装\n\n```bash\npip install sleepless-agent\n```\n\n或者开发环境：\n```bash\ngit clone \u003Crepo>\ncd sleepless-agent\npython -m venv venv\nsource venv\u002Fbin\u002Factivate  # 或者在Windows上使用venv\\Scripts\\activate\npip install -e .\n```\n\n> ⚠️ **Windows \u002F WSL提示：** 在`pip install`之后，如果Python的`Scripts`目录不在你的`PATH`中，可能会导致无法找到`sle`命令。请参阅下方的【故障排除：找不到`sle`命令】部分。\n\n### 2. 认证Claude Code（必选）\n\n```bash\n# 安装Claude Code CLI（需要Node.js）\nnpm install -g @anthropic-ai\u002Fclaude-code\n\n# 登录一次（会打开浏览器）\nclaude login\n\n# 验证\nclaude --version\n```\n\n### 3. （可选）不使用Slack直接启动\n\nSlack集成并不是必需的。你可以直接使用`sle` CLI：\n\n```bash\n# 启动守护进程（无需Slack）\nsle daemon\n\n# 提交任务\nsle think \"研究异步Python模式\"\n\n# 查看状态\nsle check\n```\n\n如果你想使用Slack集成，请继续下面的设置步骤。\n\n### 4. 设置Slack应用\n\n前往https:\u002F\u002Fapi.slack.com\u002Fapps并创建一个新的应用：\n\n**基本信息**\n- 选择“从头开始”\n- 名称：“Sleepless Agent”\n- 选择你的工作区\n\n**启用Socket模式**\n- 设置 > Socket模式 > 打开开关\n- 生成应用令牌（以`xapp-`开头）\n\n**创建Slash命令**\n设置 > Slash命令 > 创建新命令：\n- `\u002Fthink` - 记录想法或任务（对于重要任务可以使用`-p 项目名称`）\n- `\u002Fchat` - 启动与Claude的交互式聊天模式\n- `\u002Fcheck` - 检查任务队列状态\n- `\u002Fusage` - 显示Claude Code Pro套餐的使用情况\n- `\u002Fcancel` - 取消任务或项目\n- `\u002Freport` - 显示报告或任务详情\n- `\u002Ftrash` - 管理回收站（列出、恢复、清空）\n\n**OAuth范围**\n功能 > OAuth与权限 > 机器人令牌范围：\n- `chat:write`\n- `commands`\n- `app_mentions:read`\n- `channels:history`（用于聊天模式）\n- `groups:history`（用于私密频道中的聊天模式）\n- `reactions:write`（用于聊天模式的指示器）\n\n**事件订阅**（用于聊天模式）\n功能 > 事件订阅 > 启用事件 > 订阅机器人事件：\n- `message.channels`\n- `message.groups`\n\n**安装应用**\n- 安装到工作区\n- 获取机器人令牌（以`xoxb-`开头）\n\n### 5. 配置环境\n\n```bash\ncp .env.example .env\nnano .env  # 使用你的令牌进行编辑\n```\n\n设置：\n- `SLACK_BOT_TOKEN` - xoxb-... 令牌\n- `SLACK_APP_TOKEN` - xapp-... 令牌\n\n（不再需要Claude API密钥——改用Claude Code CLI）\n\n### 6. 运行\n\n```bash\nsle daemon\n```\n\n你应该会看到类似如下的启动日志：\n```\n2025-10-24 23:30:12 | INFO     | sleepless_agent.interfaces.bot.start:50 Slack机器人已启动并正在监听事件\n2025-10-24 23:30:12 | INFO     | sleepless_agent.runtime.daemon.run:178 Sleepless Agent 正在启动...\n```\n日志使用Rich库渲染以提高可读性；你可以设置`SLEEPLESS_LOG_LEVEL=DEBUG`来增加日志的详细程度。\n\n## 🖥️ Windows \u002F WSL：找不到`sle`命令\n\n如果你在Windows或WSL上执行`pip install`后仍然无法识别`sle`命令，很可能是因为Python的`Scripts`目录没有添加到你的`PATH`中。\n\n**Windows（PowerShell \u002F CMD）**\n\n```powershell\n# 查找pip安装脚本的位置\npython -m site --user-scripts\n\n# 将该目录永久添加到 PATH（PowerShell）\n$scriptsDir = python -m site --user-scripts\n[Environment]::SetEnvironmentVariable(\"PATH\", \"$env:PATH;$scriptsDir\", \"User\")\n\n# 或者直接使用 python -m 运行 sle\npython -m sleepless_agent.interfaces.cli --help\n```\n\n**WSL（Ubuntu \u002F Debian）**\n\n```bash\n# 将本地 bin 目录添加到 PATH\necho 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> ~\u002F.bashrc\nsource ~\u002F.bashrc\n\n# 验证\nsle --version\n```\n\n**系统级 pip 安装（不推荐）**\n\n如果你使用了 `sudo pip install`，脚本会位于 `\u002Fusr\u002Flocal\u002Fbin`，而该路径通常已经包含在 PATH 中。不过，建议优先使用虚拟环境或 `pip install --user`。\n\n**虚拟环境（推荐）**\n\n使用虚拟环境可以避免所有平台上的 PATH 问题：\n\n```bash\npython -m venv venv\n# Windows:\nvenv\\Scripts\\activate\n# macOS \u002F Linux \u002F WSL:\nsource venv\u002Fbin\u002Factivate\n\npip install sleepless-agent\nsle --version  # 在虚拟环境中始终可用\n```\n\n\n## 💬 Slack 命令\n\n所有 Slack 命令与 CLI 命令保持一致，以确保一致性：\n\n### 📋 任务管理\n\n| 命令 | 用途 | 示例 |\n|---------|---------|---------|\n| `\u002Fthink` | 记录随机想法 | `\u002Fthink 探索异步思路` |\n| `\u002Fthink -p \u003Cproject>` | 将重要任务添加到项目 | `\u002Fthink 添加 OAuth2 支持 -p backend` |\n| `\u002Fcheck` | 显示系统状态 | `\u002Fcheck` |\n| `\u002Fusage` | 显示 Claude Code Pro 使用情况 | `\u002Fusage` |\n| `\u002Fcancel` | 取消任务或项目 | `\u002Fcancel 5` 或 `\u002Fcancel my-app` |\n\n### 💭 交互式聊天模式\n\n在专用的 Slack 线程中与 Claude 展开实时对话：\n\n| 命令 | 用途 | 示例 |\n|---------|---------|---------|\n| `\u002Fchat \u003Cproject>` | 为某个项目开启聊天模式 | `\u002Fchat my-backend` |\n| `\u002Fchat end` | 结束当前聊天会话 | `\u002Fchat end` |\n| `\u002Fchat status` | 检查当前会话状态 | `\u002Fchat status` |\n| `\u002Fchat help` | 显示聊天模式帮助信息 | `\u002Fchat help` |\n\n**聊天模式功能：**\n- 🧵 每个会话都有专属线程\n- 💬 保留完整的对话历史\n- 🔄 实时处理指示器\n- 📁 Claude 可以读取、写入和编辑项目工作区中的文件\n- ⏱️ 30 分钟无操作后自动超时\n- 在线程中输入 `exit` 即可结束会话\n\n> 💡 **注意**：当你运行 `\u002Fchat \u003Cproject>` 时，会创建一个新的线程。你的所有提示都必须发送到 **这个线程内**——Claude 只会对聊天线程内的消息做出回应，而不会回复主频道的消息。\n\n### 📊 报表与回收站\n\n| 命令 | 用途 | 示例 |\n|---------|---------|---------|\n| `\u002Freport` | 今日报表、任务详情、指定日期或项目的报表，或列出所有报表 | `\u002Freport`、`\u002Freport 42`、`\u002Freport 2025-10-22`、`\u002Freport my-app`、`\u002Freport --list` |\n| `\u002Ftrash` | 列出回收站内容、恢复或清空回收站 | `\u002Ftrash list`、`\u002Ftrash restore my-app`、`\u002Ftrash empty` |\n\n## ⌨️ 命令行界面\n\n安装该项目（或在仓库内直接运行），然后使用内置的 CLI：\n\n```bash\npython -m sleepless_agent.interfaces.cli think \"发布清单\" -p my-app\n# 或者，在安装包之后：\nsle check\n```\n\nCLI 与 Slack 斜杠命令完全对应：\n\n| 命令 | 用途 | 示例 |\n|---------|---------|---------|\n| `think \u003Cdescription>` | 记录随机想法 | `think \"探索异步模式\"` |\n| `think \u003Cdescription> -p \u003Cproject>` | 将重要任务加入项目队列 | `think \"构建注册流程\" -p backend` |\n| `check` | 显示系统健康状况、队列状态及性能指标 | `check` |\n| `usage` | 显示 Claude Code Pro 方案使用情况 | `usage` |\n| `report [identifier]` | 显示任务详情、每日报告或项目摘要（使用 `--list` 查看所有报告） | `report 7` |\n| `cancel \u003Cidentifier>` | 将任务或项目移至回收站 | `cancel 9` 或 `cancel my-app` |\n| `trash [subcommand] [identifier]` | 管理回收站（列出、恢复、清空） | `trash restore my-app` |\n\n必要时可以覆盖存储位置：\n\n```bash\nsle --db-path .\u002Ftmp\u002Ftasks.db --results-path .\u002Ftmp\u002Fresults check\n```\n\n## 🏗️ 架构\n\n```\nSlack 机器人\n    ↓\nSlack 命令 → 任务队列（SQLite）\n    ↓\n代理守护进程（事件循环）\n    ↓\nClaude 执行器（Claude Code CLI）\n    ↓\n结果管理器（存储 + Git）\n```\n\n### 组件\n\n- **daemon.py**: 主事件循环，任务编排\n- **bot.py**: Slack 接口，命令解析\n- **task_queue.py**: 任务的 CRUD 操作及优先级调度\n- **claude_code_executor.py**: 包装 Python Agent SDK 的模块，并管理隔离的工作空间\n- **results.py**: 结果存储与文件管理\n- **models.py**: 用于任务和结果的 SQLAlchemy 模型\n- **config.yaml**: 配置默认值\n- **git_manager.py**: Git 自动化（提交、PR）\n- **monitor.py**: 健康检查与指标监控\n\n## 📁 文件结构\n\n```\nsleepless-agent\u002F\n├── src\u002Fsleepless_agent\u002F\n│   ├── __init__.py\n│   ├── daemon.py           # 主事件循环\n│   ├── bot.py              # Slack 接口\n│   ├── task_queue.py       # 任务管理\n│   ├── claude_code_executor.py  # Claude CLI 包装器\n│   ├── scheduler.py        # 智能调度\n│   ├── git_manager.py      # Git 自动化\n│   ├── monitor.py          # 健康与指标监控\n│   ├── models.py           # 数据库模型\n│   ├── results.py          # 结果存储\n│   └── config.yaml         # 配置默认值\n├── workspace\u002F              # 所有持久化数据及任务工作区\n│   ├── data\u002F               # 持久化存储\n│   │   ├── tasks.db        # SQLite 数据库\n│   │   ├── results\u002F        # 任务输出文件\n│   │   ├── reports\u002F        # 每日 Markdown 报告\n│   │   ├── agent.log       # 应用程序日志\n│   │   └── metrics.jsonl   # 性能指标\n│   ├── tasks\u002F              # 任务工作区（task_1\u002F、task_2\u002F 等）\n│   ├── projects\u002F           # 项目工作区\n│   └── trash\u002F              # 软删除的项目\n├── .env                    # 秘密信息（未被跟踪）\n├── pyproject.toml          # Python 包元数据及依赖\n├── README.md              # 当前文件\n└── docs\u002F                  # 其他文档\n```\n\n## ⚙️ 配置\n\n运行时设置来自通过 `.env` 加载的环境变量（参见 `.env.example`）。你可以更新这些值，或者在 shell 中导出它们来调整代理的行为。\n\n### 使用管理\n\n代理会自动监控 Claude Code 的使用情况，并根据可配置的阈值智能管理任务执行。\n\n**工作原理：**\n\n1. **使用情况监控** - 每个任务通过 `claude \u002Fusage` 命令检查使用情况\n2. **基于时间的阈值** - 白天和夜间操作采用不同的阈值\n3. **智能调度** - 当达到阈值时，自动暂停任务生成\n4. **自动恢复** - 当使用量重置后，任务会继续执行\n\n**基于时间的配置（可在 `config.yaml` 中配置）：**\n- **夜间（默认为凌晨1点至上午9点）：** 96% 阈值 - 代理会在您睡眠时积极工作\n- **白天（默认为上午9点至凌晨1点）：** 95% 阈值 - 保留容量供您手动使用\n- 配置方式：`claude_code.threshold_day`、`claude_code.threshold_night`\n- 时间范围：`claude_code.night_start_hour`、`claude_code.night_end_hour`\n\n**可见性：**\n- 仪表盘：在 `sle check` 中显示使用百分比\n- 日志：每次使用情况检查都会记录当前使用量及适用的阈值\n- 配置：所有阈值和时间范围均可在 `config.yaml` 中调整\n\n**达到阈值时的行为：**\n- ⏸️ 新任务生成在达到阈值时暂停\n- ✅ 正在运行的任务会正常完成\n- 📋 待处理的任务会排队等待\n- ⏱️ 当使用量重置后，任务会自动恢复\n\n### Git 管理\n\n代理与 Git 深度集成，实现自动版本控制和协作：\n\n**远程仓库配置 (`config.yaml`)：**\n- `git.use_remote_repo`：启用或禁用远程仓库集成\n- `git.remote_repo_url`：您的远程仓库 URL（例如 `git@github.com:username\u002Frepo.git`）\n- `git.auto_create_repo`：如果仓库不存在，则自动创建\n\n**Git 工作流程：**\n- **随机想法**：自动提交到 `thought-ideas` 分支\n- **严肃任务（-p 标志）**：创建功能分支（`feature\u002F\u003Cproject>-\u003Ctask_id>`），并打开 PR\n- **自动提交**：每个任务完成后都会触发一次带有描述性信息的提交\n- **PR 创建**：严肃任务会自动创建拉取请求以供审查\n\n**重要提示：** 在运行代理之前，请务必在 `config.yaml` 中更新 `git.remote_repo_url`！\n\n### 多代理工作流\n\n代理采用复杂的多代理架构来处理复杂任务：\n\n**代理类型 (`config.yaml`)：**\n- **规划代理**：分析任务并制定执行计划（默认最多3轮）\n- **执行代理**：执行计划中的任务（默认最多3轮）\n- **评估代理**：审查并验证已完成的工作（默认最多3轮）\n\n**配置：**\n```yaml\nmulti_agent_workflow:\n  planner:\n    enabled: true\n    max_turns: 3\n  worker:\n    enabled: true\n    max_turns: 3\n  evaluator:\n    enabled: true\n    max_turns: 3\n```\n\n每个代理可以独立启用或禁用，并配置不同的轮次限制，以控制执行深度。\n\n### 任务自动生成\n\n代理可以在空闲时自动生成功能丰富的任务，以保持其生产力：\n\n**生成策略 (`config.yaml`)：**\n- **refine_focused（权重45%）**：专注于完成或改进现有工作\n- **balanced（权重35%）**：根据工作区状态混合改进和新任务\n- **new_friendly（权重20%）**：优先创建创新性新项目\n\n**任务类型：**\n- **[NEW]**：在隔离的工作区中创建新任务（`workspace\u002Ftasks\u002F\u003Ctask_id>\u002F`）\n- **[REFINE:#\u003Cid>]**：改进特定的现有任务（复用任务工作区）\n- **[REFINE]**：对工作区项目进行一般性的改进\n\n**工作区限制：**\n- 每个任务都在自己的隔离目录中执行\n- 任务仅访问其工作区和 `workspace\u002Fshared\u002F`\n- 系统目录（`workspace\u002Fdata\u002F`）受到保护\n- REFINE 任务会复用现有工作区以保持连续性\n\n\n## 🔧 环境变量\n\n```bash\n# 必需\nSLACK_BOT_TOKEN=xoxb-...\nSLACK_APP_TOKEN=xapp-...\n```\n\n**注意：** 大多数配置是通过 `config.yaml` 进行的。环境变量主要用于存储密钥和部署相关的设置。\n\n## 📝 任务类型\n\n代理会智能地处理不同类型的任务：\n\n1. **随机想法** - 自动提交到 `thought-ideas` 分支\n   ```\n   \u002Fthink 研究 Rust 中的异步模式\n   \u002Fthink 实现缓存的最佳方法是什么？\n   ```\n\n2. **严肃任务** - 创建功能分支和 PR，需要审核（使用 `-p` 标志）\n   ```\n   \u002Fthink -p backend 为用户服务添加身份验证\n   \u002Fthink -p payments 重构支付处理模块\n   ```\n\n## 📊 监控\n\n### Slack 命令\n```\n\u002Fcheck    # 系统状态和性能统计\n\u002Freport --list  # 可用报告\n```\n\n## 🚢 部署\n\n### Linux (systemd)\n```bash\nmake install-service\nsudo systemctl start sleepless-agent\n```\n\n### macOS (launchd)\n```bash\nmake install-launchd\nlaunchctl list | grep sleepless\n```\n\n## 💡 示例工作流程\n\n### 每日头脑风暴\n```\n\u002Fthink 研究新的 Rust 异步库\n\u002Fthink 比较 Python Web 框架\n\u002Fthink 改进 API 性能的想法\n\u002Fcheck\n```\n\n### 生产环境修复\n```\n\u002Fthink 修复登录端点的身份验证 bug -p backend\n\u002Freport \u003Cid>     # 获取 PR 链接\n# 审核并合并 PR\n```\n\n### 代码审计\n```\n\u002Fthink 对用户服务进行安全审计 -p backend\n\u002Fthink 对支付模块进行性能分析 -p payments\n```\n\n## ⚡ 性能提示\n\n1. **利用想法填充空闲时间** - 最大化使用率\n2. **批量处理严肃任务** - 减少上下文切换\n3. **监控使用情况** - 查看调度日志以了解使用模式\n4. **审查 Git 历史** - 定期查看 `thought-ideas` 分支\n5. **检查指标** - 运行 `sle check` 以跟踪性能\n\n## 📦 发布版本\n\n- 最新稳定版：**0.1.0** – 已发布于 [PyPI](https:\u002F\u002Fpypi.org\u002Fproject\u002Fsleepless-agent\u002F0.1.0\u002F)\n- 可通过 `pip install -U sleepless-agent` 安装或升级\n- 发布说明可通过 GitHub Releases 跟踪（从标签 `v0.1.0` 开始）\n\n## 📚 文档\n\n更多详细信息和指南：\n\n- **[完整文档](https:\u002F\u002Fcontext-machine-lab.github.io\u002Fsleepless-agent\u002F)** - 完整的文档网站\n- **[DeepWiki](https:\u002F\u002Fdeepwiki.com\u002Fcontext-machine-lab\u002Fsleepless-agent)** - 交互式知识库\n- **[安装指南](docs\u002Finstallation.md)** - 详细的设置说明\n- **[快速入门](docs\u002Fquickstart.md)** - 快速上手\n- **[常见问题](docs\u002Ffaq.md)** - 常见问题解答\n- **[故障排除](docs\u002Ftroubleshooting.md)** - 常见问题及解决方案\n\n## 🗺️ 路线图\n\n- [ ] **高级调度** - 带有时间依赖和依赖关系的优先级队列\n- [ ] **每日报告** - 代理每日工作的报告\n\n## 🙏 致谢\n\n我们衷心感谢开源社区以及使 Sleepless Agent 成为可能的各个项目：\n\n- **[Claude Code CLI](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code)** - 为我们提供了强大的 AI 辅助开发基础，以及支持无缝集成的 Python Agent SDK。\n- **[Slack Bolt](https:\u002F\u002Fgithub.com\u002Fslackapi\u002Fbolt-python)** - 提供了可靠的实时消息传递和命令处理功能，支撑着我们的 Slack 集成。\n- **[SQLAlchemy](https:\u002F\u002Fwww.sqlalchemy.org\u002F)** - 以其健壮的数据持久化能力和优雅的 ORM，管理着我们的任务队列。\n- **[Rich](https:\u002F\u002Fgithub.com\u002FTextualize\u002Frich)** - 通过其精美的终端渲染，使日志和输出更加美观易读。\n- **[GitPython](https:\u002F\u002Fgithub.com\u002Fgitpython-developers\u002FGitPython)** - 提供了全面的 Git 操作功能，支持我们的自动化版本控制工作流。\n\n## 🤝 贡献\n\n我们欢迎各位的贡献！Sleepless Agent 旨在成为一个面向社区的全天候 AI 开发自动化工具。\n\n请参阅我们的 [贡献指南](CONTRIBUTING.md)，了解：\n- 开发环境搭建与配置\n- 代码风格与测试要求\n- 如何提交 Pull Request\n- 社区准则与行为规范\n\n您也可以：\n- 🐛 [报告问题](https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002Fnew?labels=bug)\n- 💡 [提出功能建议](https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002Fnew?labels=enhancement)\n- 💬 [提问交流](https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fdiscussions)\n- 🔧 [提交 Pull Request](https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fpulls)\n\n## 📖 引用\n\n如果您在研究或项目中使用了 Sleepless Agent，请引用以下内容：\n\n```bibtex\n@software{sleepless_agent_2025,\n  title = {Sleepless Agent: A 24\u002F7 AgentOS for Continuous Development},\n  author = {Zhimeng Guo, Hangfan Zhang, Siyuan Xu, Huaisheng Zhu, Teng Xiao, Minhao Cheng},\n  year = {2025},\n  publisher = {GitHub},\n  journal = {GitHub repository},\n  url = {https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent}\n}\n```\n\n## 📄 许可证\n\n根据 [MIT 许可证](LICENSE) 发布。\n\n## 🔧 开发\n\nSleepless Agent 的集成测试于 2025 年 12 月 15 日完成。","# Sleepless Agent 快速上手指南\n\nSleepless Agent 是一个 24\u002F7 运行的 AI 代理操作系统（AgentOS），旨在利用 Claude Code Pro 在您休息时自动处理想法和任务。它支持通过 Slack 或命令行提交任务，并在隔离的工作空间中并行执行。\n\n## 环境准备\n\n在开始之前，请确保您的系统满足以下要求：\n\n*   **操作系统**：Linux, macOS, Windows (或 WSL)\n*   **Python**: 3.11 或更高版本\n*   **Node.js**: 用于安装 Claude Code CLI\n*   **Git**: 用于自动提交和分支管理\n*   **gh CLI** (可选): 用于自动化创建 Pull Request\n*   **Slack 工作区管理员权限** (可选): 仅当需要使用 Slack 机器人交互时需要；纯命令行模式无需配置 Slack。\n\n## 安装步骤\n\n### 1. 安装 Python 依赖\n\n推荐使用虚拟环境以避免路径问题：\n\n```bash\n# 克隆仓库（开发模式）或直接安装\ngit clone \u003Crepo_url>\ncd sleepless-agent\npython -m venv venv\n\n# 激活虚拟环境\n# Linux\u002FmacOS\u002FWSL:\nsource venv\u002Fbin\u002Factivate\n# Windows PowerShell:\nvenv\\Scripts\\activate\n\n# 安装包\npip install -e .\n# 或者直接安装发布版：\n# pip install sleepless-agent\n```\n\n> **注意 (Windows\u002FWSL 用户)**: 如果安装后提示 `sle` 命令找不到，可能是因为 Python `Scripts` 目录未在环境变量 `PATH` 中。建议在虚拟环境中运行，或使用 `python -m sleepless_agent.interfaces.cli` 代替 `sle`。\n\n### 2. 安装并认证 Claude Code\n\nSleepless Agent 依赖官方的 Claude Code CLI 进行核心推理和执行。\n\n```bash\n# 全局安装 Claude Code CLI\nnpm install -g @anthropic-ai\u002Fclaude-code\n\n# 登录认证（将打开浏览器进行授权）\nclaude login\n\n# 验证安装\nclaude --version\n```\n\n### 3. (可选) 配置 Slack 集成\n\n如果您希望通过 Slack 发送指令，需完成以下配置；若仅使用命令行，可跳过此步。\n\n1.  访问 [Slack API Apps](https:\u002F\u002Fapi.slack.com\u002Fapps) 创建新应用。\n2.  **启用 Socket Mode**: 在 Settings > Socket Mode 中开启，并生成 App Token (`xapp-...`)。\n3.  **创建 Slash Commands**: 添加 `\u002Fthink`, `\u002Fchat`, `\u002Fcheck`, `\u002Fusage`, `\u002Fcancel`, `\u002Freport`, `\u002Ftrash` 等命令。\n4.  **设置权限 scopes**: 添加 `chat:write`, `commands`, `app_mentions:read` 等所需权限。\n5.  **安装应用**: 安装到工作区并获取 Bot Token (`xoxb-...`)。\n6.  **配置环境变量**:\n    ```bash\n    cp .env.example .env\n    # 编辑 .env 文件，填入以下 token\n    # SLACK_BOT_TOKEN=xoxb-...\n    # SLACK_APP_TOKEN=xapp-...\n    ```\n\n## 基本使用\n\n### 启动守护进程\n\n无论是否配置 Slack，首先需要启动后台守护进程以监听任务：\n\n```bash\nsle daemon\n```\n\n启动成功后，您将看到类似日志：\n```text\n2025-10-26 03:30:12 | INFO | Sleepless Agent starting...\n2025-10-26 03:30:12 | INFO | Slack bot connected (如果已配置)\n```\n\n### 提交任务\n\n您可以通过以下方式提交任务：\n\n**方式 A：使用命令行 (无需 Slack)**\n\n```bash\n# 提交一个随机想法\nsle think \"研究 Python 异步编程模式\"\n\n# 提交一个严肃的开发任务（指定项目）\nsle think \"实现 OAuth2 认证功能\" -p backend\n```\n\n**方式 B：使用 Slack (如果已配置)**\n\n在 Slack 频道中输入：\n```text\n\u002Fthink 实现 OAuth2 认证功能 -p backend\n```\n\n### 查看状态与结果\n\n检查系统运行状态及任务队列：\n\n```bash\nsle check\n```\n\n输出示例：\n```text\n╭─────────────────── System Status ───────────────────╮\n│ 🟢 Daemon: Running                                  │\n│ 📊 Queue: 3 pending, 1 in_progress                  │\n│ 💻 Usage: 45% (Day threshold: 95%)                  │\n│ 🔄 Last task: \"Implement OAuth2...\" (in progress)   │\n╰─────────────────────────────────────────────────────╯\n```\n\n查看具体任务的执行结果（包括生成的代码分支和 PR 链接）：\n\n```bash\n# 查看任务 ID 为 42 的报告\nsle report 42\n```\n\n输出示例：\n```text\nTask #42: ✅ Completed\nBranch: feature\u002Fbackend-42\nPR: https:\u002F\u002Fgithub.com\u002Fuser\u002Frepo\u002Fpull\u002F123\n```\n\n### 交互式聊天模式 (Chat Mode)\n\n您可以启动一个与 Claude 的实时会话，直接在上下文中修改代码：\n\n```bash\n# 命令行启动\nsle chat my-backend\n\n# 或在 Slack 中输入\n\u002Fchat my-backend\n```\n\n*提示：在 Slack 聊天模式中，请务必在生成的专属线程（Thread）内回复消息，Claude 只会响应线程内的内容。输入 `exit` 或运行 `\u002Fchat end` 结束会话。*","某后端团队负责人需要在深夜处理突发的 OAuth2 认证重构任务，同时兼顾白天的日常代码评审，希望最大化利用闲置的 Claude Code Pro 算力。\n\n### 没有 sleepless-agent 时\n- **算力闲置浪费**：昂贵的 Claude Code Pro 订阅仅在白天工作时间使用，夜间算力完全空置，造成资源极大浪费。\n- **任务中断频繁**：开发者必须在本地手动运行长耗时任务，一旦关闭电脑或切换上下文，任务即刻中断，无法后台持续运行。\n- **环境冲突风险**：并行处理多个紧急需求时，不同任务在同一本地环境中修改依赖或文件，极易引发冲突导致构建失败。\n- **进度追踪困难**：缺乏统一的任务队列和状态看板，难以在次日清晨快速确认昨晚提交的任务是否完成及生成结果。\n\n### 使用 sleepless-agent 后\n- **全天候自动运转**：配置为守护进程模式，自动在夜间空闲时段接管任务，实现\"人睡机不歇\"，将单日有效产出时间翻倍。\n- **无感异步交付**：通过 Slack 发送 `\u002Fthink` 指令即可提交需求，sleepless-agent 自动在隔离的工作空间中执行代码生成、测试及 Git 提交。\n- **安全并行隔离**：每个任务自动创建独立的沙箱工作区，互不干扰，确保多线程任务（如同时修复 Bug 和开发新功能）稳定运行。\n- **闭环结果反馈**：任务完成后自动生成 Pull Request 链接并通过 Slack 推送报告，开发者醒来即可直接进行代码审查与合并。\n\nsleepless-agent 将原本闲置的夜间时段转化为高效的生产力窗口，让 AI 代理成为真正 24\u002F7 在线的超级结对程序员。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fcontext-machine-lab_sleepless-agent_dc4ff336.png","context-machine-lab","context machine","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fcontext-machine-lab_905295b5.png","Shaping intelligent behavior through structured context.",null,"timelovercc@gmail.com","https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab",[84,88],{"name":85,"color":86,"percentage":87},"Python","#3572A5",99.3,{"name":89,"color":90,"percentage":91},"Makefile","#427819",0.7,814,111,"2026-04-01T17:06:30","MIT","Linux, macOS, Windows","未说明",{"notes":99,"python":100,"dependencies":101},"该工具主要依赖 Claude Code CLI（需通过 npm 安装）和 Python Agent SDK。Slack 集成是可选的，可以直接使用命令行界面 (CLI) 运行。在 Windows 或 WSL 上安装后，若找不到 `sle` 命令，可能需要将 Python Scripts 目录添加到系统 PATH 环境变量中，或使用虚拟环境运行。","3.11+",[102,103,104,105],"@anthropic-ai\u002Fclaude-code (CLI)","Node.js","Git","gh CLI (可选)",[15],[108,109,110,111,112,113,114,115,116,117,118,119,120,121,122],"ai-agent","anthropic","automation","python","slack","autonomous-agents","claude","claude-code","daemon","git-automation","slack-bot","sqlite","task-automation","workflow-automation","workspace-management","2026-03-27T02:49:30.150509","2026-04-06T09:44:30.068091",[126,131,136,141,146,151],{"id":127,"question_zh":128,"answer_zh":129,"source_url":130},13423,"pip 安装成功后 'sle' 命令无法运行，是否必须配置 Slack？","是的，该工具深度集成于 Slack 生态系统。如果在 Windows (CMD\u002FWSL) 或 macOS 上安装后 'sle' 命令无效，请首先确认您是否已正确配置 Slack 环境变量（SLACK_BOT_TOKEN 和 SLACK_APP_TOKEN）。对于新手用户，建议先阅读官方文档中关于 Slack Bot 设置的部分，确保令牌填写无误后再尝试运行守护进程。","https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002F10",{"id":132,"question_zh":133,"answer_zh":134,"source_url":135},13419,"启动 daemon 时出现 'KeyError: slack' 错误怎么办？","这是一个已知的配置解析问题，通常发生在即使 .env 文件中已填写 SLACK_* 变量时。维护者已确认该问题并正在修复中。请确保您的 .env 文件位于正确的工作目录，且包含有效的 SLACK_BOT_TOKEN 和 SLACK_APP_TOKEN。如果问题依旧，请关注项目更新以获取修复版本。","https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002F7",{"id":137,"question_zh":138,"answer_zh":139,"source_url":140},13420,"运行时报错 'No module named requests' 如何解决？","这是因为 pyproject.toml 文件中遗漏了 'requests' 依赖包。维护者已更新项目文件修复了此问题。如果您遇到此错误，请尝试重新安装最新版本的包（pip install -U sleepless-agent），或者手动安装缺失的依赖：pip install requests。","https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002F5",{"id":142,"question_zh":143,"answer_zh":144,"source_url":145},13421,"使用 Claude Code API 计划时出现 'usage.parse_failed' 警告是否正常？","这是正常现象。该警告出现的原因是程序试图通过 'claude \u002Fusage' 命令来检查使用情况以触发新任务，但在 API 模式下不会报告使用量百分比，导致解析失败并回退到默认值。维护者表示这将很快得到更新处理，目前不影响核心功能运行。","https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002F8",{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},13422,"如何加入项目的微信或 Discord 社区群聊？","如果之前的微信群二维码或 Discord 邀请链接过期，请查看项目最新的文档或 README 文件。维护者会定期更新微信群二维码，请以仓库中最新发布的图片为准。","https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fissues\u002F12",{"id":152,"question_zh":153,"answer_zh":154,"source_url":135},13424,"初始化工作区时出现 'pathspec main did not match' Git 错误怎么办？","该错误表明当前工作区目录下的 Git 仓库没有 'main' 分支。请检查您的项目目录，确保已经初始化了 git 仓库并且存在名为 'main' 的主分支。您可以尝试运行 'git branch -M main' 将当前分支重命名为 main，或者在配置文件中指定正确的默认分支名称。",[156,161,166],{"id":157,"version":158,"summary_zh":159,"released_at":160},72167,"v0.1.2","## 变更内容\n\n### 📦 依赖项\n- 在项目依赖中添加了 `requests`，以改进 HTTP 请求的处理\n\n### 🔧 安装\n```bash\npip install sleepless-agent==0.1.2\n```\n\n### 📄 完整变更日志\nhttps:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent\u002Fcompare\u002Fv0.1.1...v0.1.2\n\n---\n*这是一个补丁版本，确保所有必需的依赖项都已正确声明。*","2025-10-27T05:03:04",{"id":162,"version":163,"summary_zh":164,"released_at":165},72168,"v0.1.1","## 🚀 Sleepless Agent v0.1.1\n\n本次发布进行了重大架构重构，提供了全面的文档、提升了稳定性，并增强了功能，以最大化 Claude Code Pro 的使用效率。\n\n### 📊 发布统计\n- 自 v0.1.0 以来共有 **38 次提交**\n- 共计 **87 个文件被修改**：新增 18,473 行，删除 4,282 行\n- 进行了**完全重构**，采用模块化架构\n\n## ✨ 新特性\n\n### 🏗️ 主要改进\n\n#### 架构与结构\n- **项目整体重构**，实现清晰的关注点分离\n- **模块化架构**，将核心、调度、存储、监控和接口等功能分别封装到独立的包中\n- **代码组织优化**，使代码库更易于维护和扩展\n\n#### 📚 文档\n- 建立了包含 15+ 篇新文档的**全面 MkDocs 文档站点**\n- 提供了关于安装、Slack 配置、Git 集成及环境配置的**详细指南**\n- 为所有 CLI 命令提供了**API 参考文档**\n- 包含**故障排除指南**和常见问题解答部分\n- 提供涵盖架构、调度、任务生命周期和工作空间隔离的**概念性文档**\n\n#### 🎯 任务管理\n- 引入了**项目级任务管理**功能\n- 支持**多代理工作流**（规划者、执行者、评估者）\n- 新增已取消任务的**回收站\u002F恢复功能**\n- 改进了任务队列处理机制，增强了错误处理能力\n\n#### 📊 监控与使用情况\n- 提供带有 Rich 控制台输出的**实时使用情况监控仪表盘**\n- 优化了 Pro 方案的使用管理，增加了基于时间的阈值限制\n- 实现了包含详细指标的**全面状态报告**\n- 在任务执行过程中提供**实时状态更新**\n\n#### 🔧 技术改进\n- 为并行任务执行引入了**隔离的工作空间管理**\n- 使用具有昼夜阈值的**高级调度算法**\n- 通过结构化日志和 Rich 格式化提升了**日志记录质量**\n- 改进了 Git 集成，实现了自动提交和 Pull Request 创建\n- 替代子进程调用，集成了**Python Agent SDK**\n\n### 🐛 Bug 修复\n- 修复了 `sle check` 命令中的 `AttributeError`\n- 解决了任务状态同步问题\n- 修复了高负载条件下数据库锁死的问题\n- 处理了长时间运行守护进程中的内存泄漏问题\n- 提升了错误恢复能力和系统鲁棒性\n\n### 📦 依赖项\n- 添加了 `claude-agent-sdk`，以更好地集成 Claude Code\n- 将所有依赖项更新至最新稳定版本\n- 优化了包结构，便于安装\n\n## 📥 安装\n\n### 通过 pip（推荐）\n```bash\npip install sleepless-agent==0.1.1\n```\n\n### 从源码安装\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fcontext-machine-lab\u002Fsleepless-agent.git\ncd sleepless-agent\npip install -e .\n```\n\n## 📖 文档\n\n完整文档现已在项目仓库中发布：\n- [安装指南](docs\u002Finstallation.md)\n- [快速入门](docs\u002Fquickstart.md)\n- [概念与架构](docs\u002Fconcepts\u002Findex.md)\n- [API 参考](docs\u002Freference\u002Fapi\u002Fcli-commands.md)\n\n## 🔄 从 v0.1.0 升级\n本版本保持","2025-10-26T14:14:06",{"id":167,"version":168,"summary_zh":169,"released_at":170},72169,"v0.1.0","无眠智能体 0.1.0\n\n亮点：\n- 将项目作为 `sleepless_agent` 包发布到 PyPI\n- 更新了 CLI、文档和系统脚本，以使用新的模块路径\n- 添加了 MIT 许可证，并更新了分发元数据\n\nPyPI：https:\u002F\u002Fpypi.org\u002Fproject\u002Fsleepless-agent\u002F0.1.0\u002F","2025-10-21T21:59:32"]