[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-L1AD--claude-task-viewer":3,"tool-L1AD--claude-task-viewer":64},[4,23,32,40,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":22},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,2,"2026-04-05T10:45:23",[13,14,15,16,17,18,19,20,21],"图像","数据工具","视频","插件","Agent","其他","语言模型","开发框架","音频","ready",{"id":24,"name":25,"github_repo":26,"description_zh":27,"stars":28,"difficulty_score":29,"last_commit_at":30,"category_tags":31,"status":22},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,3,"2026-04-05T22:51:36",[19,17,20,16],{"id":33,"name":34,"github_repo":35,"description_zh":36,"stars":37,"difficulty_score":10,"last_commit_at":38,"category_tags":39,"status":22},3074,"gpt4free","xtekky\u002Fgpt4free","gpt4free 是一个由社区驱动的开源项目，旨在聚合多种可访问的大型语言模型（LLM）和媒体生成接口，让用户能更灵活、便捷地使用前沿 AI 能力。它解决了直接调用各类模型时面临的接口分散、门槛高或成本昂贵等痛点，通过统一的标准将不同提供商的资源整合在一起。\n\n无论是希望快速集成 AI 功能的开发者、需要多模型对比测试的研究人员，还是想免费体验最新技术的普通用户，都能从中受益。gpt4free 提供了丰富的使用方式：既包含易于上手的 Python 和 JavaScript 客户端库，也支持部署本地图形界面（GUI），更提供了兼容 OpenAI 标准的 REST API，方便无缝替换现有应用后端。\n\n其技术亮点在于强大的多提供商支持架构，能够动态调度包括 Opus、Gemini、DeepSeek 等多种主流模型资源，并支持 Docker 一键部署及本地推理。项目秉持社区优先原则，在降低使用门槛的同时，也为贡献者提供了扩展新接口的便利框架，是探索和利用多样化 AI 资源的实用工具。",65970,"2026-04-04T01:02:03",[16,19,17],{"id":41,"name":42,"github_repo":43,"description_zh":44,"stars":45,"difficulty_score":10,"last_commit_at":46,"category_tags":47,"status":22},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",64604,"2026-04-05T23:10:16",[17,16],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":22},193,"meilisearch","meilisearch\u002Fmeilisearch","Meilisearch 是一个开源的极速搜索服务，专为现代应用和网站打造，开箱即用。它能帮助开发者快速集成高质量的搜索功能，无需复杂的配置或额外的数据预处理。传统搜索方案往往需要大量调优才能实现准确结果，而 Meilisearch 内置了拼写容错、同义词识别、即时响应等实用特性，并支持 AI 驱动的混合搜索（结合关键词与语义理解），显著提升用户查找信息的体验。\n\nMeilisearch 特别适合 Web 开发者、产品团队或初创公司使用，尤其适用于需要快速上线搜索功能的场景，如电商网站、内容平台或 SaaS 应用。它提供简洁的 RESTful API 和多种语言 SDK，部署简单，资源占用低，本地开发或生产环境均可轻松运行。对于希望在不依赖大型云服务的前提下，为用户提供流畅、智能搜索体验的团队来说，Meilisearch 是一个高效且友好的选择。",56972,"2026-04-05T22:34:33",[13,17,14,20,16,18],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":22},4022,"awesome-claude-skills","ComposioHQ\u002Fawesome-claude-skills","awesome-claude-skills 是一个精心整理的开源资源库，旨在帮助用户挖掘和扩展 Claude AI 的潜力。它不仅仅是一份列表，更提供了实用的“技能（Skills）”模块，让 Claude 从单纯的文本生成助手，进化为能执行复杂工作流的智能代理。\n\n许多用户在使用 AI 时，常受限于其无法直接操作外部软件或处理特定格式文件的痛点。awesome-claude-skills 通过预设的工作流解决了这一问题：它不仅能教会 Claude 专业地处理 Word、PDF 等文档，进行代码开发与数据分析，还能借助 Composio 插件连接 Slack、邮箱及数百种常用应用，实现发送邮件、创建任务等自动化操作。这使得重复性任务变得标准化且可复用，极大提升了工作效率。\n\n无论是希望优化日常办公流程的普通用户、需要处理复杂文档的研究人员，还是寻求将 AI 深度集成到开发管线中的开发者，都能从中找到适合的解决方案。其独特的技术亮点在于“技能”的可定制性与强大的应用连接能力，让用户无需编写复杂代码，即可通过简单的配置让 Claude 具备跨平台执行真实任务的能力。如果你希望让 Claude",51312,"2026-04-05T19:04:23",[17,16],{"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":78,"owner_location":78,"owner_email":78,"owner_twitter":78,"owner_website":78,"owner_url":79,"languages":80,"stars":89,"forks":90,"last_commit_at":91,"license":92,"difficulty_score":10,"env_os":93,"env_gpu":94,"env_ram":93,"env_deps":95,"category_tags":98,"github_topics":99,"view_count":108,"oss_zip_url":78,"oss_zip_packed_at":78,"status":22,"created_at":109,"updated_at":110,"faqs":111,"releases":147},751,"L1AD\u002Fclaude-task-viewer","claude-task-viewer","A web-based Kanban board for viewing Claude Code tasks","claude-task-viewer 是一款专为 Claude Code 设计的 Web 端看板界面，旨在将原本隐藏在终端里的任务流程转化为直观的可视化面板。当 AI 助手将复杂工作拆解为多个子任务时，claude-task-viewer 帮助开发者清晰掌握全局进度，追踪任务依赖关系，并管理清理已完成的工作。\n\n它主要解决了 AI 编码过程中任务黑盒化的问题，让用户能实时看到任务从待办到完成的流转状态，甚至通过甘特图形式查看耗时分布。此外，它还具备桌面通知、自动归档闲置会话以及依赖检查等实用功能。\n\nclaude-task-viewer 非常适合依赖 AI 进行编程辅助的开发者，特别是需要处理多步骤、长周期代码生成任务的用户。技术上，它直接监听本地任务目录，利用 Server-Sent Event 实现无感知的实时数据推送，配合简洁的键盘快捷键操作，极大提升了与 AI 协作时的透明度和掌控感。","# Claude Task Viewer\n\nA real-time Kanban board for **observing** Claude Code tasks. See what Claude is working on, track dependencies between tasks, and manage task cleanup and priority.\n\n![Dark mode](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FL1AD_claude-task-viewer_readme_ccf7961a0ede.png)\n\n![Light mode](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FL1AD_claude-task-viewer_readme_e6cfa48bf77b.png)\n\n## Why Use This?\n\nWhen Claude Code breaks down complex work into tasks, you get visibility into its thinking — but only in the terminal. Claude Task Viewer gives you a persistent, visual dashboard to:\n\n- **See the big picture** — All your sessions and tasks in one place\n- **Know what's happening now** — Live Updates show exactly what Claude is doing across all sessions\n- **Understand task dependencies** — See which tasks are blocked and what's holding them up\n- **Get notified** — Desktop notifications and sound chime when tasks complete\n- **Visualise timing** — Timeline view shows task durations as a Gantt-style chart\n- **Stay organised** — Stale sessions auto-archive to keep the sidebar clean\n- **Clean up completed work** — Delete tasks when no longer needed (with dependency checking)\n\n## Key Features\n\n### Observation-Focused Design\nClaude Code controls task state — the viewer shows you what's happening:\n- **Real-time status** — See tasks move through Pending → In Progress → Completed as Claude works\n- **Active session detection** — Indicators show which sessions have in-progress tasks\n- **Task dependencies** — Visualise blockedBy\u002Fblocks relationships to understand the critical path\n- **Live activity feed** — Real-time stream of all in-progress tasks across every session\n\n### Desktop & Sound Notifications\n- **Bell icon** in the header toggles notifications on\u002Foff (persisted across sessions)\n- **Desktop notifications** fire when a task moves from In Progress → Completed — click to jump to it\n- **Audio chime** plays a short two-tone sound (C5→E5) alongside the desktop notification\n- Requires browser notification permission on first enable\n\n### Session Timeline\n- **Kanban\u002FTimeline toggle** in the header switches between the board and a Gantt-style chart\n- Tasks displayed as horizontal bars from creation to last update, colour-coded by status\n- **Time axis auto-scales** — seconds, minutes, hours, or days depending on the session span\n- Hover for exact timestamps and duration; click to open the detail panel\n- View preference persists in localStorage\n\n### Auto-archive Stale Sessions\n- Sessions with no in-progress tasks and unmodified for over 7 days collapse into an **Archived** section\n- Collapsed by default — click to expand. Expand\u002Fcollapse state persists across reloads\n- Archived sessions still appear when searching or using \"Active Only\" filter\n\n### Cleanup Operations\n- **Delete tasks** — Remove tasks with the delete button or press `D` (includes safety checks for dependencies)\n- **Bulk delete** — Delete all tasks in a session at once\n\n### Session Management\nView and organise your Claude Code sessions:\n- **Session discovery** — Automatically finds all sessions in `~\u002F.claude\u002Ftasks\u002F` and `~\u002F.claude\u002Fprojects\u002F`\n- **View project paths** — See the full filesystem path for each project\n- **Fuzzy search** — Search across session names, task descriptions, and project paths with instant filtering\n- **Session limits** — Filter to show only active sessions or a specific number of recent sessions\n\n### Keyboard Shortcuts\n- `?` — Show help with all keyboard shortcuts\n- `D` — Delete the currently selected task (with confirmation and dependency checking)\n- `Esc` — Close detail panel or modals\n\n## Installation\n\n### Quick start\n\n```bash\nnpx claude-task-viewer\n```\n\nOpen http:\u002F\u002Flocalhost:3456\n\n### From source\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer.git\ncd claude-task-viewer\nnpm install\nnpm start\n```\n\n## How It Works\n\nClaude Code stores tasks in `~\u002F.claude\u002Ftasks\u002F`. Each session has its own folder:\n\n```\n~\u002F.claude\u002Ftasks\u002F\n  └── {session-uuid}\u002F\n      ├── 1.json\n      ├── 2.json\n      └── ...\n```\n\nThe viewer watches this directory and pushes updates via Server-Sent Events. Changes appear instantly — no polling, no refresh needed.\n\n## Task Structure\n\n```json\n{\n  \"id\": \"1\",\n  \"subject\": \"Implement user authentication\",\n  \"description\": \"Add JWT-based auth with refresh tokens\",\n  \"activeForm\": \"Setting up auth middleware\",\n  \"status\": \"in_progress\",\n  \"blocks\": [\"2\", \"3\"],\n  \"blockedBy\": []\n}\n```\n\n- `activeForm` — What Claude is doing right now (shown in Live Updates)\n- `blocks` \u002F `blockedBy` — Task dependency relationships\n\n## Configuration\n\n```bash\n# Custom port\nPORT=8080 npx claude-task-viewer\n\n# Open browser automatically\nnpx claude-task-viewer --open\n\n# Use a different Claude config directory (for multiple accounts)\nnpx claude-task-viewer --dir=~\u002F.claude-work\n```\n\n## API\n\n| Endpoint | Method | Description |\n|----------|--------|-------------|\n| `\u002Fapi\u002Fsessions` | GET | List all sessions with task counts |\n| `\u002Fapi\u002Fsessions\u002F:id` | GET | Get all tasks for a session |\n| `\u002Fapi\u002Ftasks\u002Fall` | GET | Get all tasks across all sessions |\n| `\u002Fapi\u002Ftasks\u002F:session\u002F:task` | DELETE | Delete a task (checks dependencies) |\n| `\u002Fapi\u002Ftasks\u002F:session\u002F:task\u002Fnote` | POST | Add a note to a task |\n| `\u002Fapi\u002Fevents` | GET | SSE stream for live updates |\n\n## Design Philosophy\n\n**Observation over Control**: Claude Code owns task state. The task viewer's job is to show you what Claude is doing, not to direct it. This keeps the viewer in sync with reality and prevents confusion about whether a task's status reflects what Claude is actually doing or just human intent.\n\n**Limited interaction:** You can delete tasks and add notes, but task status, subject, and description reflect Claude's actual work and can only be changed by Claude Code itself.\n\n## Roadmap\n\n### ✅ Completed\n- **Real-time observation** — Live updates feed showing what Claude is doing across all sessions\n- **Task dependencies** — Visualise blockedBy\u002Fblocks relationships\n- **Task deletion** — Delete tasks with dependency checking\n- **Keyboard shortcuts** — ?, D, Esc for quick actions\n- **Session discovery** — Automatic detection of all Claude Code sessions\n- **Search** — Search across sessions and tasks\n- **Desktop notifications** — Notifications and audio chime when tasks complete\n- **Task timeline** — Gantt-style view showing task creation and completion times\n- **Session archiving** — Stale sessions auto-collapse into an archived section\n\n### 🚧 Planned\n- **Enhanced search & filter** — Filter by status, dependencies, date ranges\n- **Export** — Export session data for analysis or reporting\n\n[Open an issue](https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues) with ideas or feedback.\n\n## License\n\nMIT\n","# Claude 任务查看器\n\n一个用于**观察** Claude Code 任务的实时看板（Kanban）。查看 Claude 正在处理什么，跟踪任务之间的依赖关系，并管理任务清理和优先级。\n\n![Dark mode](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FL1AD_claude-task-viewer_readme_ccf7961a0ede.png)\n\n![Light mode](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FL1AD_claude-task-viewer_readme_e6cfa48bf77b.png)\n\n## 为什么要使用？\n\n当 Claude Code 将复杂工作分解为任务时，你可以了解其思考过程——但仅限于终端（Terminal）中。Claude 任务查看器为你提供一个持久化的可视化仪表板（Dashboard），用于：\n\n- **一览全局** —— 所有会话和任务集中在一个地方\n- **知晓当前动态** —— 实时更新（Live Updates）显示 Claude 在所有会话中的确切操作\n- **理解任务依赖** —— 查看哪些任务被阻塞以及是什么阻碍了它们\n- **接收通知** —— 任务完成时发送桌面通知（Desktop notifications）和声音提示\n- **可视化时间线** —— 时间线视图以甘特图（Gantt）风格展示任务持续时间\n- **保持整洁** —— 过期会话自动归档以保持侧边栏整洁\n- **清理已完成的工作** —— 不再需要时删除任务（含依赖检查）\n\n## 主要功能\n\n### 以观察为核心的设计\nClaude Code 控制任务状态 —— 查看器向你展示正在发生的事情：\n- **实时状态** —— 查看任务随着 Claude 工作从“待处理（Pending）”到“进行中（In Progress）”再到“已完成（Completed）”的流转\n- **活跃会话检测** —— 指示器显示哪些会话有进行中的任务\n- **任务依赖** —— 可视化 blockedBy\u002Fblocks 关系以理解关键路径\n- **实时活动流** —— 每个会话中所有进行中任务的实时流\n\n### 桌面与声音通知\n- 标题栏中的**铃铛图标**可切换通知开启\u002F关闭（跨会话持久化）\n- **桌面通知**在任务从“进行中”变为“已完成”时触发 —— 点击可跳转至该任务\n- **音频提示音（Audio chime）**伴随桌面通知播放简短的双音调（C5→E5）\n- 首次启用时需要浏览器通知权限\n\n### 会话时间线\n- 标题栏中的**看板\u002F时间线切换**可在看板与甘特图风格图表之间切换\n- 任务以水平条显示，从创建到最后更新，按状态着色\n- **时间轴自动缩放** —— 根据会话跨度显示秒、分钟、小时或天\n- 悬停查看确切时间戳和持续时间；点击打开详情面板\n- 视图偏好保存在 localStorage（本地存储）中\n\n### 自动归档过期会话\n- 没有进行中任务且超过 7 天未修改的会话折叠进**已归档（Archived）**部分\n- 默认折叠 —— 点击展开。展开\u002F折叠状态在重载间持久化\n- 搜索或使用“仅活跃（Active Only）”过滤器时仍会显示已归档会话\n\n### 清理操作\n- **删除任务** —— 使用删除按钮或按 `D` 键移除任务（包含依赖安全检查）\n- **批量删除** —— 一次性删除会话中的所有任务\n\n### 会话管理\n查看并组织你的 Claude Code 会话：\n- **会话发现** —— 自动查找 `~\u002F.claude\u002Ftasks\u002F` 和 `~\u002F.claude\u002Fprojects\u002F` 中的所有会话\n- **查看项目路径** —— 查看每个项目的完整文件系统路径\n- **模糊搜索** —— 跨会话名称、任务描述和项目路径搜索，即时过滤\n- **会话限制** —— 过滤仅显示活跃会话或特定数量的最近会话\n\n### 键盘快捷键\n- `?` —— 显示所有键盘快捷键的帮助\n- `D` —— 删除当前选中的任务（带确认和依赖检查）\n- `Esc` —— 关闭详情面板或模态框（modals）\n\n## 安装\n\n### 快速开始\n\n```bash\nnpx claude-task-viewer\n```\n\n打开 http:\u002F\u002Flocalhost:3456\n\n### 从源码构建\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer.git\ncd claude-task-viewer\nnpm install\nnpm start\n```\n\n## 工作原理\n\nClaude Code 将任务存储在 `~\u002F.claude\u002Ftasks\u002F`。每个会话都有独立的文件夹：\n\n```\n~\u002F.claude\u002Ftasks\u002F\n  └── {session-uuid}\u002F\n      ├── 1.json\n      ├── 2.json\n      └── ...\n```\n\n查看器监视此目录并通过 Server-Sent Events（服务器发送事件）推送更新。更改立即出现 —— 无需轮询，无需刷新。\n\n## 任务结构\n\n```json\n{\n  \"id\": \"1\",\n  \"subject\": \"Implement user authentication\",\n  \"description\": \"Add JWT-based auth with refresh tokens\",\n  \"activeForm\": \"Setting up auth middleware\",\n  \"status\": \"in_progress\",\n  \"blocks\": [\"2\", \"3\"],\n  \"blockedBy\": []\n}\n```\n\n- `activeForm` —— Claude 当前正在做什么（显示在实时更新中）\n- `blocks` \u002F `blockedBy` —— 任务依赖关系\n\n## 配置\n\n```bash\n# Custom port\nPORT=8080 npx claude-task-viewer\n\n# Open browser automatically\nnpx claude-task-viewer --open\n\n# Use a different Claude config directory (for multiple accounts)\nnpx claude-task-viewer --dir=~\u002F.claude-work\n```\n\n## API\n\n| 端点 | 方法 | 描述 |\n|----------|--------|-------------|\n| `\u002Fapi\u002Fsessions` | GET | 列出所有会话及任务计数 |\n| `\u002Fapi\u002Fsessions\u002F:id` | GET | 获取会话的所有任务 |\n| `\u002Fapi\u002Ftasks\u002Fall` | GET | 获取所有会话的所有任务 |\n| `\u002Fapi\u002Ftasks\u002F:session\u002F:task` | DELETE | 删除任务（检查依赖） |\n| `\u002Fapi\u002Ftasks\u002F:session\u002F:task\u002Fnote` | POST | 向任务添加备注 |\n| `\u002Fapi\u002Fevents` | GET | SSE 流用于实时更新 |\n\n## 设计理念\n\n**观察优于控制**：Claude Code 拥有任务状态。任务查看器的作用是向你展示 Claude 正在做什么，而不是指挥它。这确保查看器与现实同步，并防止混淆任务状态是反映 Claude 的实际操作还是仅仅反映人类意图。\n\n**有限的交互**：你可以删除任务和添加备注，但任务状态、主题和描述反映 Claude 的实际工作，只能由 Claude Code 本身更改。\n\n## 路线图\n\n### ✅ 已完成\n- **实时观察** —— 实时更新流显示 Claude 在所有会话中的操作\n- **任务依赖** —— 可视化 blockedBy\u002Fblocks 关系\n- **任务删除** —— 带依赖检查的任务删除\n- **键盘快捷键** —— ?, D, Esc 用于快速操作\n- **会话发现** —— 自动检测所有 Claude Code 会话\n- **搜索** —— 跨会话和任务搜索\n- **桌面通知** —— 任务完成时的通知和音频提示音\n- **任务时间线** —— 显示任务创建和完成时间的甘特图风格视图\n- **会话归档** —— 过期会话自动折叠进归档部分\n\n### 🚧 计划中\n- **增强的搜索与过滤** —— 按状态、依赖、日期范围过滤\n- **导出** —— 导出数据用于分析或报告\n\n[提交问题](https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues) 提出想法或反馈。\n\n## 许可证\n\nMIT","# claude-task-viewer 快速上手指南\n\n**claude-task-viewer** 是一款专为 **Claude Code** 设计的实时看板工具。它允许你在浏览器中直观地观察任务状态、追踪依赖关系并管理任务清理，无需在终端中频繁切换查看。\n\n## 环境准备\n\n在使用本工具前，请确保您的开发环境满足以下要求：\n\n- **操作系统**：支持 macOS、Linux 或 Windows（需支持 Node.js）。\n- **前置依赖**：已安装 **Node.js** 环境。\n- **核心依赖**：本地已安装并配置好 **Claude Code**（工具会自动读取 `~\u002F.claude\u002Ftasks\u002F` 目录下的数据）。\n\n## 安装步骤\n\n推荐使用 `npx` 方式快速启动，无需手动克隆仓库。\n\n### 方式一：快速启动（推荐）\n\n直接通过 npm 运行：\n\n```bash\nnpx claude-task-viewer\n```\n\n### 方式二：从源码安装\n\n如需自定义修改或调试，可克隆项目源码：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer.git\ncd claude-task-viewer\nnpm install\nnpm start\n```\n\n> **注意**：国内用户若 `git clone` 速度较慢，建议使用 Git 镜像源加速。\n\n## 基本使用\n\n安装完成后，工具默认会在本地启动 Web 服务。\n\n### 1. 访问界面\n打开浏览器访问以下地址：\n```text\nhttp:\u002F\u002Flocalhost:3456\n```\n\n### 2. 功能概览\n- **实时看板**：自动发现 `~\u002F.claude\u002Ftasks\u002F` 下的所有会话，展示任务状态流转（Pending → In Progress → Completed）。\n- **依赖可视化**：查看任务间的阻塞关系（blocks\u002FblockedBy）。\n- **通知提醒**：任务完成时触发桌面通知及提示音（需在浏览器授权通知权限）。\n- **时间轴视图**：切换至 Gantt 风格图表查看任务耗时。\n\n### 3. 常用配置\n可通过命令行参数调整运行行为：\n\n```bash\n# 指定端口\nPORT=8080 npx claude-task-viewer\n\n# 启动后自动打开浏览器\nnpx claude-task-viewer --open\n\n# 指定不同的 Claude 配置文件目录\nnpx claude-task-viewer --dir=~\u002F.claude-work\n```\n\n### 4. 键盘快捷键\n在界面中可使用以下快捷键提升效率：\n\n| 快捷键 | 功能 |\n| :--- | :--- |\n| `?` | 显示帮助信息（列出所有快捷键） |\n| `D` | 删除当前选中的任务（含依赖检查） |\n| `Esc` | 关闭详情面板或弹窗 |","某全栈工程师正在利用 Claude Code 重构遗留系统，同时开启了多个任务会话来处理不同的模块，急需全局监控进度。\n\n### 没有 claude-task-viewer 时\n- 终端窗口被大量日志刷屏，难以快速定位当前具体进度和关键信息。\n- 无法直观看到任务之间的依赖关系，容易遗漏导致后续步骤阻塞的环节。\n- 任务完成后缺乏提醒，需要不断切换窗口或手动检查状态是否结束。\n- 历史会话堆积杂乱，旧项目文件占用空间且找不到之前的上下文记录。\n\n### 使用 claude-task-viewer 后\n- claude-task-viewer 提供看板视图，清晰展示所有会话的任务从待办到完成的流转状态。\n- 实时时间轴和甘特图让任务耗时与依赖路径一目了然，快速识别瓶颈。\n- 桌面通知与提示音在任务完成时自动触发，开发者可安心处理其他事务。\n- 自动归档过期会话并支持一键清理，保持工作区整洁有序，避免无效干扰。\n\nclaude-task-viewer 将隐式的命令行任务转化为可视化的管理流程，显著提升复杂开发任务的掌控效率。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FL1AD_claude-task-viewer_ccf7961a.png","L1AD","LIAD","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FL1AD_193d4336.png",null,"https:\u002F\u002Fgithub.com\u002FL1AD",[81,85],{"name":82,"color":83,"percentage":84},"HTML","#e34c26",86,{"name":86,"color":87,"percentage":88},"JavaScript","#f1e05a",14,519,50,"2026-04-05T06:06:25","MIT","未说明","无需 GPU",{"notes":96,"python":93,"dependencies":97},"本工具基于 Node.js 环境运行（通过 npm 安装），非 AI 模型推理工具，因此不需要 GPU 或特定 Python 版本。必须确保运行环境可访问本地 ~\u002F.claude\u002Ftasks\u002F 目录以读取任务数据。首次使用需在浏览器中授权桌面通知权限。",[93],[16],[100,101,102,103,104,105,106,107],"anthropic","claude","claude-code","cli","developer-tools","kanban","nodejs","task-management",4,"2026-03-27T02:49:30.150509","2026-04-06T09:46:59.362319",[112,117,122,127,132,137,142],{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},3201,"如何指定不同的 CLAUDE 配置文件目录以管理多个账号？","从 v1.6.0 版本开始，工具支持通过 `--dir` 参数指定配置文件路径。您可以使用以下命令切换不同账号的任务视图：\n\n```bash\nnpx claude-task-viewer --dir=~\u002F.claude-work\n# 或者使用空格分隔\nnpx claude-task-viewer --dir ~\u002F.claude-work\n```\n\n注意：`~` 会自动展开为您的家目录，且同时支持 `--dir=path` 和 `--dir path` 两种格式。","https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues\u002F1",{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},3202,"如何查看多个会话（Session）中的任务？是否需要启动多个服务？","无需启动多个服务。该工具设计为单服务器模式，支持在一个窗口内查看所有会话。\n\n**使用方法：**\n1. 仅运行一次 `npx claude-task-viewer`。\n2. 左侧边栏会列出所有检测到的会话。\n3. 点击任意会话即可切换查看。\n4. 使用 \"All Tasks\" 按钮可同时查看所有会话的任务。\n\n**注意：** 如果遇到 \"already in use\" 错误，通常是因为第一个实例仍在端口 3456 上运行，只需关闭旧实例或使用侧边栏切换即可。","https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues\u002F3",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},3203,"当默认端口 3456 被占用时，应用是否会报错退出？","不会直接报错退出。从 v1.8.1 版本起，如果默认端口 3456 已被占用，服务器会自动尝试后续端口（最多尝试 10 次）直到找到可用端口。\n\n**例外情况：** 如果您显式设置了 `PORT` 环境变量，则仍会快速失败（fail fast），不会自动查找其他端口。","https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues\u002F10",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},3204,"为什么任务列表没有自动刷新？需要手动设置刷新频率吗？","不需要手动设置刷新频率。之前的版本存在一个 Bug：如果在创建任何任务之前启动查看器，文件监听器可能未正确初始化。\n\n**解决方案：** 新版本已移除对目录存在的检查，底层库 Chokidar 现在能优雅地处理不存在的目录并在其创建后自动开始监听。确保您使用的是最新版本即可实现实时自动更新。","https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues\u002F4",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},3205,"\"进行中\" (IN PROGRESS) 任务的显示颜色太暗，难以阅读怎么办？","这是已知的外观问题，已在 v1.8.1 版本中修复。开发者移除了覆盖在文本上的橙色色调和内阴影（inset box-shadow），使文字更清晰易读。请更新至最新版本。","https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues\u002F6",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},3206,"阻塞任务完成后，被阻塞的任务上的 \"BLOCKED\" 标签为何仍未消失？","这是一个逻辑显示 Bug，已在 v1.8.1 版本中修复。现在的逻辑会检查阻塞任务是否实际上仍处于未完成状态，只有当阻塞任务真正完成时，被阻塞任务上的 \"BLOCKED\" 徽章才会移除。","https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues\u002F5",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},3207,"新版 Claude Code 的子代理（Subagents）任务无法显示在视图中吗？","是的，目前不支持将子代理日志视为标准任务。\n\n**原因：** 子代理生成的文件是 JSONL 对话日志（完整对话转录），而不是工具构建者读取的标准任务 JSON 文件。\n\n**替代方案：** 如果您使用 \"Agent Teams\"（通过 `TeamCreate` + `TaskCreate` 生成），它们会产生标准的任务 JSON 文件并位于 `~\u002F.claude\u002Ftasks\u002F{team-name}\u002F` 目录下，这些是可以正常显示的。","https:\u002F\u002Fgithub.com\u002FL1AD\u002Fclaude-task-viewer\u002Fissues\u002F9",[148],{"id":149,"version":150,"summary_zh":78,"released_at":78},112397,"v1.3.0"]