Skip to content

Optima-Chat/cc-chat

Repository files navigation

🤖 CC Chat

Claude Code 用户的中文聊天社区

让 Claude 帮你发帖交流,无需离开终端

npm version License: MIT GitHub stars

网站 · 安装 · 文档 · 贡献


✨ 亮点特性

  • 🎯 零配置集成 - 一行命令安装,Claude 自动识别
  • 💬 自然语言交互 - 用人话发帖,不用记命令
  • 🚀 全功能 CLI - 浏览、搜索、评论、投票、收藏、通知
  • 🌐 Web + CLI 双端 - 终端和浏览器都能用
  • 🔄 自动内容同步 - 从 Reddit 自动抓取翻译优质内容
  • 🏷️ 智能标签系统 - MCP、技巧、项目、问题等分类
  • 🔔 实时通知 - @提及、回复通知
  • 收藏功能 - 保存喜欢的帖子
  • 📊 用户主页 - 查看用户的帖子、评论、统计数据
  • 🎨 代码高亮 - Markdown 渲染,语法高亮

🎬 演示

# 自然语言发帖
$ "帮我发个帖子分享我的 MCP 配置"

# Claude 自动执行
✓ 已发布帖子
  ID: 42
  标题: 我的 MCP 配置分享
  查看: https://www.cc-chat.dev/posts/42

🚀 快速开始

安装

npm install -g @optima-chat/cc-chat@latest

使用

方式一:自然语言(推荐)

直接对 Claude 说:

  • "帮我登录 CC Chat,用户名是 yourname"
  • "帮我发个帖子分享我的 MCP 配置"
  • "看看论坛有什么新帖子"
  • "搜索关于 MCP 的帖子"
  • "查看用户 xxx 的主页"

Claude 会自动调用命令完成操作 ✨

方式二:直接使用命令

# 登录
cc-chat login --username "你的用户名"

# 发帖
cc-chat post --title "标题" --content "内容" --tags "技巧,MCP"

# 浏览帖子(支持热度排序)
cc-chat browse --sort hot --limit 20

# 搜索
cc-chat search "MCP" --limit 10

# 查看用户主页
cc-chat user <username> --comments

# 评论和回复
cc-chat comment <post-id> --text "评论内容"
cc-chat reply <comment-id> --post-id <post-id> --text "回复内容"

# 投票
cc-chat upvote <post-id>
cc-chat downvote <post-id>

# 收藏
cc-chat save <post-id>
cc-chat saved

# 通知
cc-chat notifications --unread
cc-chat mark-read <notification-id>

📋 完整命令列表

命令 说明 示例
login 登录(GitHub OAuth) cc-chat login --username "用户名"
post 发帖 cc-chat post --title "标题" --content "内容" --tags "技巧,MCP"
browse 浏览帖子 cc-chat browse --sort hot --tag MCP --limit 20
search 搜索帖子 cc-chat search "关键词" --limit 10
tags 查看所有标签 cc-chat tags
user 查看用户主页 cc-chat user <username> --comments
comment 评论帖子 cc-chat comment <post-id> --text "评论"
reply 回复评论 cc-chat reply <comment-id> --post-id <post-id> --text "回复"
upvote 点赞帖子 cc-chat upvote <post-id>
downvote 踩帖子 cc-chat downvote <post-id>
upvote-comment 点赞评论 cc-chat upvote-comment <comment-id>
downvote-comment 踩评论 cc-chat downvote-comment <comment-id>
save 收藏帖子 cc-chat save <post-id>
unsave 取消收藏 cc-chat unsave <post-id>
saved 查看收藏列表 cc-chat saved --limit 20
notifications 查看通知 cc-chat notifications --unread
mark-read 标记已读 cc-chat mark-read <notification-id>
mark-read-all 全部标记已读 cc-chat mark-read-all
delete-post 删除帖子 cc-chat delete-post <post-id>
delete-comment 删除评论 cc-chat delete-comment <comment-id>

💡 适合分享什么?

  • 💡 使用技巧 - Claude Code 的使用心得和技巧
  • 🔧 MCP 配置 - Model Context Protocol 插件和配置
  • 🎉 项目展示 - 用 Claude Code 做的有趣项目
  • 问题求助 - 遇到的问题和 bug
  • 📖 教程文章 - 深度教程和最佳实践
  • 🐛 Bug 报告 - Claude Code 的问题反馈
  • 💭 想法建议 - 功能建议和讨论

🏗️ 技术架构

graph TB
    subgraph Client["🖥️ 客户端"]
        Claude["🤖 Claude<br/>(自然语言)"]
        Web["🌐 Web<br/>(Next.js 15)"]
        CLI["💻 CLI<br/>(Commander.js)"]
    end

    subgraph Backend["⚡ 后端服务"]
        API["Fastify API<br/>(TypeScript)"]
        DB[(PostgreSQL<br/>数据存储)]
    end

    subgraph Automation["🤖 内容同步 (GitHub Actions)"]
        Sync["Python 脚本<br/>(每 6 小时)"]
        Reddit[Reddit API<br/>内容抓取]
        OpenAI[OpenAI API<br/>智能翻译]
    end

    subgraph Auth["🔐 认证"]
        GitHub[GitHub OAuth]
    end

    subgraph Deploy["☁️ 部署平台"]
        Railway[Railway<br/>API 托管]
        Vercel[Vercel<br/>Web 托管]
    end

    Claude --> CLI
    CLI --> API
    Web --> API

    API --> DB
    API --> GitHub

    Sync --> Reddit
    Reddit --> OpenAI
    OpenAI --> Sync
    Sync --> API

    API --> Railway
    Web --> Vercel

    style Claude fill:#8b5cf6,stroke:#7c3aed,color:#fff
    style Web fill:#3b82f6,stroke:#2563eb,color:#fff
    style CLI fill:#10b981,stroke:#059669,color:#fff
    style API fill:#f59e0b,stroke:#d97706,color:#fff
    style DB fill:#ef4444,stroke:#dc2626,color:#fff
    style Sync fill:#ec4899,stroke:#db2777,color:#fff
    style Reddit fill:#f97316,stroke:#ea580c,color:#fff
    style OpenAI fill:#06b6d4,stroke:#0891b2,color:#fff
    style GitHub fill:#6366f1,stroke:#4f46e5,color:#fff
    style Railway fill:#0f172a,stroke:#1e293b,color:#fff
    style Vercel fill:#000000,stroke:#171717,color:#fff
Loading

技术栈:

  • CLI: TypeScript + Commander.js + Chalk
  • Web: Next.js 15 + React 19 + TailwindCSS
  • API: Fastify + PostgreSQL + Redis
  • 认证: GitHub OAuth
  • 部署: Railway (API) + Vercel (Web)
  • 自动化: GitHub Actions

🌐 在线访问

🛠️ 本地开发

克隆仓库

git clone https://github.com/Optima-Chat/cc-chat.git
cd cc-chat

启动后端(Docker Compose)

docker compose up -d

开发 CLI

cd cli
npm install
npm run dev

开发 Web

cd web
npm install
npm run dev

详见:

📦 部署

后端 API

  • Railway(推荐)- 一键部署,$5/月免费额度
  • Render - 免费部署
  • VPS - 自托管部署

详见 部署指南

Web 前端

  • Vercel(推荐)- Next.js 官方平台,自动部署
  • 推送到 main 分支即可自动部署

详见 Web 部署文档

🗺️ 开发路线图

  • Phase 1: 核心功能

    • CLI 工具
    • 发帖、评论、回复
    • 投票系统
    • 热度排序(Hot/New/Top/Comments)
    • 标签系统
    • 搜索功能
  • Phase 2: 社区功能

    • 用户主页
    • 收藏功能
    • 通知系统(@提及、回复)
    • 嵌套评论
    • 代码高亮
  • Phase 3: 内容生态

    • Reddit 自动同步
    • 智能翻译(OpenAI API)
    • 去重机制
  • Phase 4: 增强功能(规划中)

    • 用户设置(头像、简介)
    • 举报机制
    • 管理后台
    • 邮件通知
    • RSS 订阅

详见 产品路线图

🤝 贡献指南

我们欢迎所有形式的贡献!

参与方式

  • 🐛 报告 Bug - 提交 Issue
  • 💡 功能建议 - 发起讨论
  • 📝 改进文档 - 完善 README 和文档
  • 💻 贡献代码 - 提交 Pull Request

开发流程

  1. Fork 本仓库
  2. 创建功能分支 (git checkout -b feature/AmazingFeature)
  3. 提交代码 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

详见 贡献指南

📄 开源协议

MIT License

🙏 致谢

  • Claude Code - 强大的 AI 编程助手
  • Anthropic - Claude 背后的公司
  • 所有贡献者和社区成员

📮 联系我们


🌟 如果觉得有用,欢迎 Star!

Made with ❤️ by the CC Chat community