[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-lcoutodemos--clui-cc":3,"tool-lcoutodemos--clui-cc":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",152630,2,"2026-04-12T23:33:54",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":76,"owner_twitter":76,"owner_website":77,"owner_url":78,"languages":79,"stars":96,"forks":97,"last_commit_at":98,"license":99,"difficulty_score":100,"env_os":101,"env_gpu":102,"env_ram":103,"env_deps":104,"category_tags":113,"github_topics":76,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":114,"updated_at":115,"faqs":116,"releases":152},7094,"lcoutodemos\u002Fclui-cc","clui-cc","Clui CC — Command Line User Interface for Claude Code","clui-cc 是一款专为 macOS 设计的轻量级桌面悬浮工具，旨在为 Anthropic 的命令行助手 Claude Code 提供直观的图形化操作界面。它巧妙地在保留命令行强大功能的同时，通过一个透明、可穿透的“药丸状”悬浮窗，解决了纯文本交互在权限审批、多任务管理和历史记录回溯上的不便。\n\n这款工具特别适合希望提升效率的开发者和技术研究人员。用户无需离开代码环境，即可通过快捷键随时呼出界面，利用多标签页功能并行处理多个独立的编程会话。其核心亮点在于“人机协同”的安全机制：当 AI 尝试执行文件修改等敏感操作时，clui-cc 会立即拦截并弹出可视化确认窗口，让用户在批准前清晰审查每一步动作。此外，它还集成了本地语音输入（基于 Whisper）、截图与文件拖拽上传、以及一键安装技能插件的市场功能。所有数据均在本地运行，不依赖云端遥测，既保障了隐私安全，又实现了流畅的原生应用体验，让复杂的命令行交互变得简单可控。","# Clui CC — Command Line User Interface for Claude Code\n\nA lightweight, transparent desktop overlay for [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code) on macOS. Clui CC wraps the Claude Code CLI in a floating pill interface with multi-tab sessions, a permission approval UI, voice input, and a skills marketplace.\n\n## Demo\n\n[![Watch the demo](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flcoutodemos_clui-cc_readme_512bc2e1d3c8.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=NqRBIpaA4Fk)\n\n\u003Cp align=\"center\">\u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=NqRBIpaA4Fk\">▶ Watch the full demo on YouTube\u003C\u002Fa>\u003C\u002Fp>\n\n## Features\n\n- **Floating overlay** — transparent, click-through window that stays on top. Toggle with `⌥ + Space` (fallback: `Cmd+Shift+K`).\n- **Multi-tab sessions** — each tab spawns its own `claude -p` process with independent session state.\n- **Permission approval UI** — intercepts tool calls via PreToolUse HTTP hooks so you can review and approve\u002Fdeny from the UI.\n- **Conversation history** — browse and resume past Claude Code sessions.\n- **Skills marketplace** — install plugins from Anthropic's GitHub repos without leaving Clui CC.\n- **Voice input** — local speech-to-text via Whisper (required, installed automatically).\n- **File & screenshot attachments** — paste images or attach files directly.\n- **Dual theme** — dark\u002Flight mode with system-follow option.\n\n## Why Clui CC\n\n- **Claude Code, but visual** — keep CLI power while getting a fast desktop UX for approvals, history, and multitasking.\n- **Human-in-the-loop safety** — tool calls are reviewed and approved in-app before execution.\n- **Session-native workflow** — each tab runs an independent Claude session you can resume later.\n- **Local-first** — everything runs through your local Claude CLI. No telemetry, no cloud dependency.\n\n## How It Works\n\n```\nUI prompt → Main process spawns claude -p → NDJSON stream → live render\n                                         → tool call? → permission UI → approve\u002Fdeny\n```\n\nSee [`docs\u002FARCHITECTURE.md`](docs\u002FARCHITECTURE.md) for the full deep-dive.\n\n## Install App (Recommended)\n\nThe fastest way to get Clui CC running as a regular Mac app. This installs dependencies, voice support (Whisper), builds the app, copies it to `\u002FApplications`, and launches it.\n\n**1) Clone the repo**\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc.git\n```\n\n**2) Double-click `install-app.command`**\n\nOpen the `clui-cc` folder in Finder and double-click `install-app.command`.\n\n> **First launch:** macOS may block the app because it's unsigned. Go to **System Settings → Privacy & Security → Open Anyway**. You only need to do this once.\n> **Folder cleanup:** the installer removes temporary `dist\u002F` and `release\u002F` folders after a successful install to keep the repo tidy.\n\n\u003Cp align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flcoutodemos_clui-cc_readme_a409625df4cd.png\" width=\"520\" alt=\"Press Option + Space to show or hide Clui CC\" \u002F>\u003C\u002Fp>\n\nAfter the initial install, just open **Clui CC** from your Applications folder or Spotlight.\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Terminal \u002F Developer Commands\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nOnly `install-app.command` is kept at root intentionally for non-technical users. Developer scripts live in `commands\u002F`.\n\n### Quick Start (Terminal)\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc.git\n```\n\n```bash\ncd clui-cc\n```\n\n```bash\n.\u002Fcommands\u002Fsetup.command\n```\n\n```bash\n.\u002Fcommands\u002Fstart.command\n```\n\n> Press **⌥ + Space** to show\u002Fhide the overlay. If your macOS input source claims that combo, use **Cmd+Shift+K**.\n\nTo stop:\n\n```bash\n.\u002Fcommands\u002Fstop.command\n```\n\n### Developer Workflow\n\n```bash\nnpm install\n```\n\n```bash\nnpm run dev\n```\n\nRenderer changes update instantly. Main-process changes require restarting `npm run dev`.\n\n### Other Commands\n\n| Command | Purpose |\n|---------|---------|\n| `.\u002Fcommands\u002Fsetup.command` | Environment check + install dependencies |\n| `.\u002Fcommands\u002Fstart.command` | Build and launch from source |\n| `.\u002Fcommands\u002Fstop.command` | Stop all Clui CC processes |\n| `npm run build` | Production build (no packaging) |\n| `npm run dist` | Package as macOS `.app` into `release\u002F` |\n| `npm run doctor` | Run environment diagnostic |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Setup Prerequisites (Detailed)\u003C\u002Fstrong>\u003C\u002Fsummary>\n\nYou need **macOS 13+**. Then install these one at a time — copy each command and paste it into Terminal.\n\n**Step 1.** Install Xcode Command Line Tools (needed to compile native modules):\n\n```bash\nxcode-select --install\n```\n\n**Step 2.** Install Node.js (recommended: current LTS such as 20 or 22; minimum supported: 18). Download from [nodejs.org](https:\u002F\u002Fnodejs.org), or use Homebrew:\n\n```bash\nbrew install node\n```\n\nVerify it's on your PATH:\n\n```bash\nnode --version\n```\n\n**Step 3.** Make sure Python has `setuptools` (needed by the native module compiler). On Python 3.12+ this is missing by default:\n\n```bash\npython3 -m pip install --upgrade pip setuptools\n```\n\n**Step 4.** Install Claude Code CLI:\n\n```bash\nnpm install -g @anthropic-ai\u002Fclaude-code\n```\n\n**Step 5.** Authenticate Claude Code (follow the prompts that appear):\n\n```bash\nclaude\n```\n\n**Step 6.** Install Whisper for voice input:\n\n```bash\n# Apple Silicon (M1\u002FM2\u002FM3\u002FM4) — preferred:\nbrew install whisperkit-cli\n# Apple Silicon fallback, or Intel Mac:\nbrew install whisper-cpp\n```\n\n> **No API keys or `.env` file required.** Clui CC uses your existing Claude Code CLI authentication (Pro\u002FTeam\u002FEnterprise subscription).\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>Architecture and Internals\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### Project Structure\n\n```\nsrc\u002F\n├── main\u002F                   # Electron main process\n│   ├── claude\u002F             # ControlPlane, RunManager, EventNormalizer\n│   ├── hooks\u002F              # PermissionServer (PreToolUse HTTP hooks)\n│   ├── marketplace\u002F        # Plugin catalog fetching + install\n│   ├── skills\u002F             # Skill auto-installer\n│   └── index.ts            # Window creation, IPC handlers, tray\n├── renderer\u002F               # React frontend\n│   ├── components\u002F         # TabStrip, ConversationView, InputBar, etc.\n│   ├── stores\u002F             # Zustand session store\n│   ├── hooks\u002F              # Event listeners, health reconciliation\n│   └── theme.ts            # Dual palette + CSS custom properties\n├── preload\u002F                # Secure IPC bridge (window.clui API)\n└── shared\u002F                 # Canonical types, IPC channel definitions\n```\n\n### How It Works\n\n1. Each tab creates a `claude -p --output-format stream-json` subprocess.\n2. NDJSON events are parsed by `RunManager` and normalized by `EventNormalizer`.\n3. `ControlPlane` manages tab lifecycle (connecting → idle → running → completed\u002Ffailed\u002Fdead).\n4. Tool permission requests arrive via HTTP hooks to `PermissionServer` (localhost only).\n5. The renderer polls backend health every 1.5s and reconciles tab state.\n6. Sessions are resumed with `--resume \u003Csession-id>` for continuity.\n\n### Network Behavior\n\nClui CC operates almost entirely offline. The only outbound network calls are:\n\n| Endpoint | Purpose | Required |\n|----------|---------|----------|\n| `raw.githubusercontent.com\u002Fanthropics\u002F*` | Marketplace catalog (cached 5 min) | No — graceful fallback |\n| `api.github.com\u002Frepos\u002Fanthropics\u002F*\u002Ftarball\u002F*` | Skill auto-install on startup | No — skipped on failure |\n\nNo telemetry, analytics, or auto-update mechanisms. All core Claude Code interaction goes through the local CLI.\n\n\u003C\u002Fdetails>\n\n## Troubleshooting\n\nFor setup issues and recovery commands, see [`docs\u002FTROUBLESHOOTING.md`](docs\u002FTROUBLESHOOTING.md).\n\nQuick self-check:\n\n```bash\nnpm run doctor\n```\n\n## Tested On\n\n| Component | Version |\n|-----------|---------|\n| macOS | 15.x (Sequoia) |\n| Node.js | 20.x LTS, 22.x |\n| Python | 3.12 (with setuptools installed) |\n| Electron | 33.x |\n| Claude Code CLI | 2.1.71 |\n\n## Known Limitations\n\n- **macOS only** — transparent overlay, tray icon, and node-pty are macOS-specific. Windows\u002FLinux support is not currently implemented.\n- **Requires Claude Code CLI** — Clui CC is a UI layer, not a standalone AI client. You need an authenticated `claude` CLI.\n- **Permission mode** — uses `--permission-mode default`. The PTY interactive transport is legacy and disabled by default.\n\n## License\n\n[MIT](LICENSE)\n","# Clui CC — Claude Code 的命令行用户界面\n\n一款轻量级、透明的桌面叠加层，适用于 macOS 上的 [Claude Code](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fclaude-code)。Clui CC 将 Claude Code CLI 包装在一个浮动药丸式界面中，支持多标签会话、权限审批 UI、语音输入以及技能市场。\n\n## 演示\n\n[![观看演示](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flcoutodemos_clui-cc_readme_512bc2e1d3c8.jpg)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=NqRBIpaA4Fk)\n\n\u003Cp align=\"center\">\u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=NqRBIpaA4Fk\">▶ 在 YouTube 上观看完整演示\u003C\u002Fa>\u003C\u002Fp>\n\n## 功能\n\n- **浮动叠加层** — 透明、可穿透的窗口，始终位于最上层。可通过 `⌥ + Space` 切换（备用快捷键：`Cmd+Shift+K`）。\n- **多标签会话** — 每个标签页都会启动一个独立的 `claude -p` 进程，拥有独立的会话状态。\n- **权限审批 UI** — 通过 PreToolUse HTTP 钩子拦截工具调用，以便您可以在界面上审查并批准或拒绝。\n- **对话历史** — 浏览并恢复过去的 Claude Code 会话。\n- **技能市场** — 无需离开 Clui CC 即可从 Anthropic 的 GitHub 仓库安装插件。\n- **语音输入** — 使用 Whisper 进行本地语音转文本（必需，会自动安装）。\n- **文件与截图附件** — 直接粘贴图片或附加文件。\n- **双主题模式** — 暗色\u002F亮色模式，并支持跟随系统设置。\n\n## 为什么选择 Clui CC\n\n- **Claude Code，但更直观** — 保留 CLI 的强大功能，同时获得用于审批、历史记录和多任务处理的快速桌面用户体验。\n- **人机协作安全性** — 工具调用会在执行前于应用内进行审查和批准。\n- **会话原生工作流** — 每个标签页运行一个独立的 Claude 会话，您可以稍后继续使用。\n- **本地优先** — 所有操作都通过您本地的 Claude CLI 运行。无遥测数据，无云端依赖。\n\n## 工作原理\n\n```\nUI 提示 → 主进程启动 claude -p → NDJSON 流 → 实时渲染\n                                         → 是否调用工具？ → 权限 UI → 批准\u002F拒绝\n```\n\n完整的深入解析请参阅 [`docs\u002FARCHITECTURE.md`](docs\u002FARCHITECTURE.md)。\n\n## 安装应用（推荐）\n\n以常规 Mac 应用程序形式运行 Clui CC 的最快方式。此方法会安装依赖项、语音支持（Whisper）、构建应用程序、将其复制到 `\u002FApplications` 并启动它。\n\n**1) 克隆仓库**\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc.git\n```\n\n**2) 双击 `install-app.command`**\n\n在 Finder 中打开 `clui-cc` 文件夹，然后双击 `install-app.command`。\n\n> **首次启动：** macOS 可能会阻止该应用，因为它未签名。请前往 **系统设置 → 隐私与安全性 → 仍要打开**。您只需执行此操作一次。\n> **清理文件夹：** 安装程序会在成功安装后删除临时的 `dist\u002F` 和 `release\u002F` 文件夹，以保持仓库整洁。\n\n\u003Cp align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flcoutodemos_clui-cc_readme_a409625df4cd.png\" width=\"520\" alt=\"按 Option + Space 显示或隐藏 Clui CC\" \u002F>\u003C\u002Fp>\n\n首次安装完成后，只需从“应用程序”文件夹或 Spotlight 中打开 **Clui CC** 即可。\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>终端 \u002F 开发者命令\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n仅将 `install-app.command` 保留在根目录是为了方便非技术人员使用。开发人员脚本位于 `commands\u002F` 目录中。\n\n### 快速开始（终端）\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc.git\n```\n\n```bash\ncd clui-cc\n```\n\n```bash\n.\u002Fcommands\u002Fsetup.command\n```\n\n```bash\n.\u002Fcommands\u002Fstart.command\n```\n\n> 按 **⌥ + Space** 可显示\u002F隐藏叠加层。如果您使用的 macOS 输入源占用了该组合键，请使用 **Cmd+Shift+K**。\n\n停止运行：\n\n```bash\n.\u002Fcommands\u002Fstop.command\n```\n\n### 开发者工作流程\n\n```bash\nnpm install\n```\n\n```bash\nnpm run dev\n```\n\n渲染器的更改会立即更新。主进程的更改则需要重启 `npm run dev`。\n\n### 其他命令\n\n| 命令 | 用途 |\n|------|------|\n| `.\u002Fcommands\u002Fsetup.command` | 环境检查 + 安装依赖 |\n| `.\u002Fcommands\u002Fstart.command` | 从源代码构建并启动 |\n| `.\u002Fcommands\u002Fstop.command` | 停止所有 Clui CC 进程 |\n| `npm run build` | 生产构建（不打包） |\n| `npm run dist` | 打包为 macOS `.app` 文件，存入 `release\u002F` |\n| `npm run doctor` | 运行环境诊断 |\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>设置前提条件（详细）\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n您需要 **macOS 13 或更高版本**。然后依次安装以下内容——将每条命令复制并粘贴到终端中。\n\n**步骤 1.** 安装 Xcode 命令行工具（编译原生模块所需）：\n\n```bash\nxcode-select --install\n```\n\n**步骤 2.** 安装 Node.js（推荐使用当前 LTS 版本，如 20 或 22；最低支持版本为 18）。可从 [nodejs.org](https:\u002F\u002Fnodejs.org) 下载，或使用 Homebrew：\n\n```bash\nbrew install node\n```\n\n确认已添加到 PATH：\n\n```bash\nnode --version\n```\n\n**步骤 3.** 确保 Python 安装了 `setuptools`（原生模块编译器所需）。在 Python 3.12 及以上版本中，默认情况下可能缺少此组件：\n\n```bash\npython3 -m pip install --upgrade pip setuptools\n```\n\n**步骤 4.** 安装 Claude Code CLI：\n\n```bash\nnpm install -g @anthropic-ai\u002Fclaude-code\n```\n\n**步骤 5.** 认证 Claude Code（按照出现的提示操作）：\n\n```bash\nclaude\n```\n\n**步骤 6.** 安装 Whisper 以实现语音输入：\n\n```bash\n# Apple Silicon（M1\u002FM2\u002FM3\u002FM4）— 推荐：\nbrew install whisperkit-cli\n# Apple Silicon 备用方案，或 Intel Mac：\nbrew install whisper-cpp\n```\n\n> **无需 API 密钥或 `.env` 文件。** Clui CC 使用您现有的 Claude Code CLI 认证（Pro\u002FTeam\u002FEnterprise 订阅）。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>架构与内部机制\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n### 项目结构\n\n```\nsrc\u002F\n├── main\u002F                   # Electron 主进程\n│   ├── claude\u002F             # 控制平面、运行管理器、事件归一化器\n│   ├── hooks\u002F              # 权限服务器（PreToolUse HTTP 钩子）\n│   ├── marketplace\u002F        # 插件目录获取 + 安装\n│   ├── skills\u002F             # 技能自动安装程序\n│   └── index.ts            # 窗口创建、IPC 处理程序、系统托盘\n├── renderer\u002F               # React 前端\n│   ├── components\u002F         # 标签栏、对话视图、输入栏等\n│   ├── stores\u002F             # Zustand 会话存储\n│   ├── hooks\u002F              # 事件监听器、健康状态同步\n│   └── theme.ts            # 双色板 + CSS 自定义属性\n├── preload\u002F                # 安全 IPC 桥（window.clui API）\n└── shared\u002F                 # 统一类型、IPC 通道定义\n```\n\n### 工作原理\n\n1. 每个标签页会创建一个 `claude -p --output-format stream-json` 子进程。\n2. NDJSON 事件由 `RunManager` 解析，并由 `EventNormalizer` 归一化。\n3. `ControlPlane` 管理标签页的生命周期（连接 → 空闲 → 运行 → 完成\u002F失败\u002F终止）。\n4. 工具权限请求通过 HTTP 钩子到达 `PermissionServer`（仅限本地）。\n5. 渲染器每 1.5 秒轮询一次后端健康状况，并同步标签页状态。\n6. 会话可通过 `--resume \u003Csession-id>` 恢复，以确保连续性。\n\n### 网络行为\n\nClui CC 几乎完全离线运行。唯一的出站网络请求如下：\n\n| 终端地址 | 用途 | 是否必需 |\n|----------|---------|----------|\n| `raw.githubusercontent.com\u002Fanthropics\u002F*` | 市场目录（缓存 5 分钟） | 否 — 可优雅降级 |\n| `api.github.com\u002Frepos\u002Fanthropics\u002F*\u002Ftarball\u002F*` | 启动时自动安装技能 | 否 — 失败时跳过 |\n\n无遥测、分析或自动更新机制。所有 Claude Code 核心交互均通过本地 CLI 进行。\n\n\u003C\u002Fdetails>\n\n## 故障排除\n\n有关设置问题和恢复命令，请参阅 [`docs\u002FTROUBLESHOOTING.md`](docs\u002FTROUBLESHOOTING.md)。\n\n快速自检命令：\n\n```bash\nnpm run doctor\n```\n\n## 测试环境\n\n| 组件 | 版本 |\n|-----------|---------|\n| macOS | 15.x (Sequoia) |\n| Node.js | 20.x LTS、22.x |\n| Python | 3.12（已安装 setuptools） |\n| Electron | 33.x |\n| Claude Code CLI | 2.1.71 |\n\n## 已知限制\n\n- **仅支持 macOS** — 透明叠加层、系统托盘图标和 node-pty 均为 macOS 特有功能。目前尚未实现 Windows 和 Linux 支持。\n- **需要 Claude Code CLI** — Clui CC 是一个 UI 层，而非独立的 AI 客户端。您需要一个已认证的 `claude` CLI。\n- **权限模式** — 使用 `--permission-mode default`。PTY 交互式传输属于遗留功能，默认已禁用。\n\n## 许可证\n\n[MIT](LICENSE)","# Clui CC 快速上手指南\n\nClui CC 是一款专为 macOS 设计的轻量级桌面悬浮工具，为 Claude Code CLI 提供可视化交互界面。它支持多标签会话、权限审批、语音输入及技能市场，让你在保留命令行强大能力的同时，享受便捷的图形化操作体验。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**：macOS 13.0 (Ventura) 或更高版本（推荐 macOS 15 Sequoia）。\n*   **Node.js**：版本 18+（推荐 LTS 版本 20 或 22）。\n*   **Python**：版本 3.12+（需安装 `setuptools`）。\n*   **Claude Code CLI**：已安装并登录的 Anthropic Claude Code 命令行工具。\n*   **Xcode 命令行工具**：用于编译原生模块。\n\n### 前置依赖安装\n\n请按顺序在终端执行以下命令完成环境配置：\n\n1.  **安装 Xcode 命令行工具**\n    ```bash\n    xcode-select --install\n    ```\n\n2.  **安装 Node.js**\n    推荐使用 Homebrew 安装：\n    ```bash\n    brew install node\n    ```\n    验证安装：\n    ```bash\n    node --version\n    ```\n\n3.  **配置 Python 环境**\n    Python 3.12+ 默认缺少 `setuptools`，需手动安装：\n    ```bash\n    python3 -m pip install --upgrade pip setuptools\n    ```\n\n4.  **安装 Claude Code CLI 并登录**\n    ```bash\n    npm install -g @anthropic-ai\u002Fclaude-code\n    claude\n    ```\n    *执行 `claude` 后按提示完成身份验证（需 Pro\u002FTeam\u002FEnterprise 订阅）。*\n\n5.  **安装语音输入支持 (Whisper)**\n    根据你的芯片架构选择其一：\n    *   **Apple Silicon (M1\u002FM2\u002FM3\u002FM4)** - 推荐：\n        ```bash\n        brew install whisperkit-cli\n        ```\n    *   **Intel Mac 或备用方案**：\n        ```bash\n        brew install whisper-cpp\n        ```\n\n> **注意**：本项目无需配置 API Key 或 `.env` 文件，直接复用本地 Claude CLI 的认证状态。\n\n## 安装步骤\n\n你可以通过图形化脚本一键安装，或通过终端命令进行开发者模式安装。\n\n### 方式一：图形化安装（推荐）\n\n适合大多数用户，会自动构建应用并复制到 `\u002FApplications` 目录。\n\n1.  **克隆仓库**\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc.git\n    ```\n\n2.  **运行安装脚本**\n    在 Finder 中打开 `clui-cc` 文件夹，双击运行 `install-app.command`。\n\n3.  **首次启动授权**\n    如果 macOS 提示“无法打开，因为来自身份不明的开发者”：\n    *   前往 **系统设置** → **隐私与安全性**。\n    *   点击 **仍要打开** (Open Anyway)。\n\n安装完成后，即可在“应用程序”文件夹或通过 Spotlight 搜索 \"Clui CC\" 启动。\n\n### 方式二：终端命令安装（开发者模式）\n\n如果你希望从源码运行或进行开发调试：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc.git\ncd clui-cc\n.\u002Fcommands\u002Fsetup.command\n.\u002Fcommands\u002Fstart.command\n```\n\n停止运行：\n```bash\n.\u002Fcommands\u002Fstop.command\n```\n\n## 基本使用\n\n安装完成后，按照以下步骤开始使用：\n\n1.  **启动\u002F隐藏界面**\n    *   默认快捷键：**`Option (⌥) + Space`**\n    *   备用快捷键（若冲突）：**`Cmd + Shift + K`**\n    *   界面将以透明悬浮胶囊形式出现在屏幕顶层，支持穿透点击。\n\n2.  **创建会话**\n    *   点击界面上的 `+` 号新建标签页。\n    *   每个标签页都会独立启动一个 `claude -p` 进程，拥有独立的会话状态。\n\n3.  **交互与审批**\n    *   **输入**：直接在输入框打字，或使用语音输入（自动调用本地 Whisper）。\n    *   **附件**：支持直接粘贴截图或拖拽文件到输入框。\n    *   **权限审批**：当 Claude 尝试执行工具调用（如写文件、运行命令）时，界面会弹出审批窗口，你需要手动点击 **Approve** (允许) 或 **Deny** (拒绝) 才能继续执行，确保操作安全。\n\n4.  **管理历史**\n    *   通过界面浏览过往会话记录，可随时恢复之前的对话上下文。\n    *   可在内置的 \"Skills Marketplace\" 中安装官方插件扩展功能。\n\n5.  **切换主题**\n    *   支持深色\u002F浅色模式，并可跟随 macOS 系统设置自动切换。","资深后端工程师李明正在 macOS 上利用 Claude Code 重构一个遗留的微服务模块，需要频繁执行文件读取、代码修改及终端命令等高风险操作。\n\n### 没有 clui-cc 时\n- **审批流程割裂**：每次 Claude 提议修改文件或运行命令时，必须在纯文本终端中手动输入\"y\"或\"n\"确认，无法直观预览变更详情，容易误操作。\n- **多任务切换低效**：同时处理“数据库迁移”和\"API 接口优化”两个独立任务时，需在多个终端窗口间反复切换，上下文极易混淆且难以恢复中断的会话。\n- **交互方式单一**：在双手忙于查阅文档或绘制架构图时，无法通过语音快速下达指令或记录思路，必须停下手头工作敲击键盘。\n- **历史回溯困难**：想要找回半小时前某个被否决的代码生成方案，只能在冗长的终端滚屏中费力查找，缺乏可视化的会话历史记录。\n\n### 使用 clui-cc 后\n- **可视化安全管控**：clui-cc 以悬浮胶囊窗形式拦截工具调用，提供清晰的权限审批界面，李明明晰地看到每个文件变更差异后再点击批准，杜绝了盲目执行。\n- **标签页隔离会话**：利用多标签功能，他为不同任务开启独立会话标签，随时在不同上下文间无缝切换，甚至隔天还能直接恢复之前的编程状态。\n- **语音驱动开发**：借助集成的 Whisper 语音输入，李明口述需求即可让 clui-cc 自动转译并发送给 Claude，实现了真正的“眼不离屏、手不离图”流畅开发。\n- **一键追溯历史**：通过内置的会话浏览器，他能像浏览网页标签一样快速定位并重启过去的对话，瞬间找回之前的灵感片段。\n\nclui-cc 将原本枯燥且高风险的命令行交互升级为直观、安全且支持多模态的桌面原生工作流，让人类专家真正掌控 AI 编码的节奏。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Flcoutodemos_clui-cc_512bc2e1.jpg","lcoutodemos","Lucas Couto","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Flcoutodemos_72df4412.jpg","Design Director - Mixed Reality + AI ",null,"https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Flucascouto27","https:\u002F\u002Fgithub.com\u002Flcoutodemos",[80,84,88,92],{"name":81,"color":82,"percentage":83},"TypeScript","#3178c6",94.5,{"name":85,"color":86,"percentage":87},"Shell","#89e051",4.2,{"name":89,"color":90,"percentage":91},"CSS","#663399",1.2,{"name":93,"color":94,"percentage":95},"HTML","#e34c26",0.1,1134,157,"2026-04-13T00:42:41","MIT",4,"macOS","未说明（语音功能依赖本地 Whisper，Apple Silicon 推荐安装 whisperkit-cli，Intel Mac 或备选方案安装 whisper-cpp，无独立 GPU 显存要求）","未说明",{"notes":105,"python":106,"dependencies":107},"该工具仅支持 macOS 13+ 系统，不支持 Windows 和 Linux。必须预先安装并认证 Anthropic 的 Claude Code CLI（需 Pro\u002FTeam\u002FEnterprise 订阅）。首次运行若遇到 macOS 安全拦截，需在“系统设置 -> 隐私与安全性”中点击“仍然打开”。语音输入功能会自动安装本地 Whisper 模型，无需 API 密钥。","3.12+ (需安装 setuptools)",[108,109,110,111,112],"Node.js 18+ (推荐 20.x 或 22.x LTS)","@anthropic-ai\u002Fclaude-code CLI","Electron 33.x","whisperkit-cli (Apple Silicon) 或 whisper-cpp (Intel\u002F备选)","Xcode Command Line Tools",[35,13,52],"2026-03-27T02:49:30.150509","2026-04-13T18:55:44.150156",[117,122,127,132,137,142,147],{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},31882,"如何召唤或关闭 Clui CC 的用户界面？","使用快捷键 Option + Space（Option 键加空格键）来召唤或关闭用户界面。","https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc\u002Fissues\u002F5",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},31883,"为什么无法拖动覆盖窗口（Overlay Window）？","这是由于无框透明面板的鼠标事件忽略机制导致的。当鼠标进入透明区域时，系统会忽略事件以允许点击穿透，这导致原生的拖动逻辑无法启动。解决方案是实施手动拖动逻辑（通过跟踪鼠标位移重新定位窗口），而不是依赖 Electron 的原生拖动功能。相关修复已在 PR #27 中提供。","https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc\u002Fissues\u002F26",{"id":128,"question_zh":129,"answer_zh":130,"source_url":131},31884,"为什么无法关闭或删除旧的对话记录？","这是当前的设计限制。当列表中仅剩一个对话时，系统不允许将其关闭。目前尚未提供右键菜单或关闭按钮来管理对话历史。","https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc\u002Fissues\u002F25",{"id":133,"question_zh":134,"answer_zh":135,"source_url":136},31885,"项目缺少 LICENSE 文件会导致什么问题？","虽然 package.json 和 README 中声明了 MIT 许可证，但缺少实际的 LICENSE 文件会导致开源工具（如 SBOM 生成器、许可证扫描器）无法识别，GitHub 和 npm 也可能无法正确显示许可证信息。解决方法是在仓库根目录添加包含标准 MIT 许可证文本的 `LICENSE` 文件。","https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc\u002Fissues\u002F32",{"id":138,"question_zh":139,"answer_zh":140,"source_url":141},31886,"运行 stop.command 后为什么还有 Electron 进程残留？","stop 脚本默认发送 SIGTERM 信号，但有时无法可靠地终止所有 Electron 子进程，导致孤儿进程残留。如果遇到此问题，可能需要手动使用 `kill -9` 命令强制终止相关进程。","https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc\u002Fissues\u002F1",{"id":143,"question_zh":144,"answer_zh":145,"source_url":146},31887,"应用崩溃或行为异常时如何查看日志进行调试？","当前版本（v0.1.0）不将日志写入磁盘，这使得在不附加调试器的情况下很难诊断问题。检查 `~\u002FLibrary\u002FLogs\u002F` 或 `~\u002FLibrary\u002FApplication Support\u002Fclui\u002F` 通常找不到运行时日志。建议开发者集成日志框架（如 `electron-log`）以便未来版本能记录错误和警告到固定位置（如 `~\u002FLibrary\u002FLogs\u002FClui CC\u002Fmain.log`）。","https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc\u002Fissues\u002F3",{"id":148,"question_zh":149,"answer_zh":150,"source_url":151},31888,"安装依赖时出现大量 npm 漏洞警告怎么办？","这些漏洞主要源于 `electron-builder@25.x` 及其传递依赖（如 glob, tar, rimraf 等）。建议运行 `npm audit fix` 尝试自动修复，或者检查是否有更新版本的 `electron-builder` 可以解决这些废弃依赖和安全漏洞问题。","https:\u002F\u002Fgithub.com\u002Flcoutodemos\u002Fclui-cc\u002Fissues\u002F2",[]]