OrionDawn/HelloSTAR

Public

WeChat Login

Code Issues Pull requests Events Packages Insights

main

feat: finish PPT

.claude
.codebuddy
files
khazix-skills
ppt-master
projects
scripts
.cnb.yml
CLAUDE.md
Dockerfile
LICENSE
README.md
settings.json

Hello STAR

🚀 Hello STAR

🤖 AI-Native Cloud IDE —— 开箱即用的智能编程环境

✨ 这是什么？

Hello STAR 是一个专为 AI 时代打造的云原生开发基座 🏗️

🎯 定位: 开箱即用的 云端 Python 开发环境 + AI 编程助手 一体化方案
🌐 架构: 基于 Docker 的云原生架构，一键部署到 CNB/任意云平台
🔄 理念: Fork → 定制 → 部署 —— 打造你的专属 AI 开发环境
🌟 特色:
- 预装 Claude Code + CodeX + CodeBuddy 三大 AI 助手
- 集成 Playwright 浏览器自动化 + Karpathy Coding Guidelines 编码规范
- 完整中文支持（VS Code 界面 + Claude Code 汉化）
- ⚡ UV 极速包管理，比 pip 快 10-100 倍
- 浏览器即可访问，无需本地配置

💡 适合谁用？

🚀 想 5 分钟 内拥有云端开发环境的开发者

🤖 追求 AI 驱动编程 效率的工程师

🇨🇳 需要 中文友好 开发体验的用户

🏢 希望团队 开发环境标准化 的技术负责人

🔥 内置爆火技能

技能	Stars	功能
📐 Karpathy Guidelines		编码规范插件 —— 遵循 Andrej Karpathy 的 LLM 编程最佳实践
🖥️ Playwright		浏览器自动化 —— 支持现代前端框架（React/Vue），登录、填表、测试
📊 ppt-master		PPT 生成技能 —— 一键生成专业 PPT，支持 Markdown 转换

💡 这些技能需要需要./srcipts文件夹中的脚本进行配置。

使用示例

🖥️ Playwright 浏览器自动化

使用示例：

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    browser = p.chromium.launch()
    page = browser.new_page()
    page.goto("https://github.com")
    page.screenshot(path="github.png")
    browser.close()

📐 Karpathy 编码规范

自动生效于 Claude Code 会话中，遵循四大原则：

Think Before Coding —— 不要假设，先思考
Simplicity First —— 简洁优先，不过度工程化
Surgical Changes —— 精准修改，只改需要改的
Goal-Driven Execution —— 目标驱动，通过测试验证

🎁 功能特性

🤖 AI 编程助手

助手	功能
🎯 Claude Code	Anthropic 官方 CLI 编程助手（内置汉化）
📝 CodeX	OpenAI 官方 CLI 编程助手
☁️ CodeBuddy	腾讯云 AI 代码补全

🛠️ 预装工具包

📦 开发工具: pipenv, ipython, jupyter
🌐 Web 框架: fastapi, uvicorn
🤖 AI 开发: langchain-openai, pydantic
🔧 系统工具: git, curl, wget, build-essential

🐍 Python 生态

组件	说明
Python 3.12	最新稳定版解释器
UV 包管理器	⚡ 比 pip 快 10-100 倍
虚拟环境	预配置 `/opt/venv`，开箱即用

🚀 快速开始

1️⃣ 一键启动开发环境

通过 CNB 平台（推荐）

访问 CNB 平台
创建新项目，fork Hello STAR 镜像
环境自动启动，等待服务就绪
点击 "打开 IDE" 进入 Web 编辑器

2️⃣ 配置 AI 助手（可选）

🎯 Claude Code 配置

export ANTHROPIC_API_KEY="tp-"
export ANTHROPIC_BASE_URL=""
export ANTHROPIC_MODEL=""
bash scripts/init-claude.sh

📄 详细配置说明（手动配置、VS Code 插件、常见问题等）请参考 Claude Code 配置指南

📝 CodeX 配置

export CODEX_API_KEY="sk-"
export CODEX_BASE_URL=""
export CODEX_MODEL=""
bash scripts/init-codex.sh

3️⃣ 测试 API 连接

cd /workspace/scripts
python3 test-api.py

📁 项目结构

🗂️ Hello STAR
├── 📖 README.md                          # 本文件
├── 📄 CLAUDE.md                          # Claude Code 工作指导文件
├── 📄 .cnb.yml                           # CNB 云原生构建配置
├── 🐳 Dockerfile                         # 镜像构建文件
├── ⚙️  settings.json                     # VS Code 编辑器配置
├── 📜 LICENSE                            # MIT 开源协议
├── 📂 scripts/
│   ├── 🎯 init-claude.sh                 # Claude Code 配置初始化脚本
│   ├── 📝 init-codex.sh                  # CodeX CLI 配置初始化脚本
│   ├── 📊 init-ppt-master.sh             # PPT 生成工具初始化脚本
│   └── 🧪 test-api.py                    # 大模型 API 测试程序
├── 📂 files/
│   └── 📄 ClaudeCode.md                  # Claude Code 配置文档
├── 📂 projects/                          # 🗂️ 用户项目空间
│   ├── 📂 ai-tools-report_ppt/           # PPT Master 示例：AI 工具报告
│   └── 📂 playwright-signin/             # Playwright 示例：自动登录签到
│       ├── 📄 README.md                  # 使用说明与技术总结
│       └── 🖥️  signin.py                # 自动登录签到脚本
├── 📂 ppt-master/                        # 📊 PPT 生成工具（10K+ Stars）
├── 📂 .claude/                           # Claude Code 插件配置
│   └── settings.json                     # 插件启用状态配置
└── 📂 .codebuddy/
    └── 📂 rules/
        └── 📋 git-commit-message.mdc     # CodeBuddy Git 提交规范规则

🌏 界面汉化

1️⃣ VS Code 官方中文语言包

安装步骤：

# 在终端中运行
code-server --install-extension MS-CEINTL.vscode-language-pack-zh-hans

或者通过扩展市场安装：

按 Ctrl+Shift+X 打开扩展面板
搜索 Chinese (Simplified) Language Pack 安装
点击Ctrl+Shift+P → 输入 Configure Display Language → 选择 zh-cn
刷新 code-server（按 Ctrl+Shift+P → Reload Window）

2️⃣ Claude Code 汉化包

本项目内置 Claude Code 专用汉化包，将 Claude Code 扩展的界面翻译为中文。

使用方式：

开箱即用：汉化包已在 Docker 镜像构建时安装完成，无需额外操作
手动触发：按 Ctrl+Shift+P → 输入 Claude Code汉化 → 点击应用汉化

💡 提示：Claude Code 汉化包由社区提供，感谢 zstings/claude-code-zh-cn 项目

🎯 二次开发指南

🍴 Fork 本仓库

# 点击 CNB 右上角 Fork 按钮
git clone https://cnb.cool/OrionDawn/HelloSTAR.git

🔨 定制你的镜像环境

编辑🐳 Dockerfile 文件

# 本地构建
docker build -t my-hellostar:latest .
# 推送到镜像仓库
docker push docker.cnb.cool/用户名/镜像名:latest

🚀 部署到 CNB

通过 CNB 平台 部署，修改 .cnb.yml 中的配置：

# 修改制品推送配置
docker.cnb.cool/你的用户名/你的镜像名:latest
# 修改云原生环境配置
image: docker.cnb.cool/你的用户名/你的镜像名:latest

推送到 main 分支后，CI/CD 自动构建并部署。

🏗️ Dockerfile 构建阶段

阶段	说明
1. 基础镜像	Ubuntu 24.04 LTS + 环境变量配置
2. 系统源	配置腾讯云 APT 镜像源（中国优化）
3. 系统工具	git, curl, python3-full, nodejs, build-essential
4. UV 安装	极速 Python 包管理器 + 虚拟环境配置
5. Python 依赖	预装 pipenv, ipython, jupyter, fastapi 等
6. VS Code	code-server 安装 + 扩展
7. CodeX CLI	OpenAI CodeX CLI 配置
8. Claude Code	Anthropic Claude Code CLI
9. 环境变量	PYTHONPATH, 虚拟环境 PATH 配置
10. 配置文件	复制 VS Code settings.json
11. 启动配置	WORKDIR 设置 + 容器启动命令

🤝 贡献指南

欢迎提交 Issue 和 PR！

🍴 Fork 本仓库
🌿 创建特性分支 (git checkout -b feature/AmazingFeature)
💾 提交更改 (git commit -m 'Add some AmazingFeature')
📤 推送到分支 (git push origin feature/AmazingFeature)
🔀 打开 Pull Request

📜 开源协议

本项目基于 MIT License 开源协议发布。

🎉 这意味着你可以：✅ 自由使用和修改

🙏 致谢

项目	说明
UV	极速 Python 包管理器
code-server	浏览器版 VS Code
CNB	云原生构建平台
Claude Code	Anthropic AI 编程助手
CodeX	OpenAI CLI 编程助手
Tencent Cloud	腾讯云（CodeBuddy 支持）
Playwright	微软浏览器自动化框架
andrej-karpathy-skills	Karpathy 编码规范指南
ppt-master	PPT 生成工具