logo
OrionDawn/HelloSTAR
Public
0
1
WeChat Login
CodeIssuesPull requestsEventsPackagesInsights
main
HelloSTAR/README.md
星觅
feat: add playwright signin example
bcd7a301
0 commits

Hello STAR

🚀 Hello STAR

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

License: MIT Python 3.12 UV Code-Server Claude Code CodeX CodeBuddy

✨ 这是什么？

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-masterPPT 生成技能 —— 一键生成专业 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 CodeAnthropic 官方 CLI 编程助手（内置汉化）
📝 CodeXOpenAI 官方 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 平台（推荐）

  1. 访问 CNB 平台
  2. 创建新项目，fork Hello STAR 镜像
  3. 环境自动启动，等待服务就绪
  4. 点击 "打开 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

或者通过扩展市场安装：

  1. 按 Ctrl+Shift+X 打开扩展面板
  2. 搜索 Chinese (Simplified) Language Pack 安装
  3. 点击Ctrl+Shift+P → 输入 Configure Display Language → 选择 zh-cn
  4. 刷新 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 Codecode-server 安装 + 扩展
7. CodeX CLIOpenAI CodeX CLI 配置
8. Claude CodeAnthropic Claude Code CLI
9. 环境变量PYTHONPATH, 虚拟环境 PATH 配置
10. 配置文件复制 VS Code settings.json
11. 启动配置WORKDIR 设置 + 容器启动命令

🤝 贡献指南

欢迎提交 Issue 和 PR！

  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 开源协议发布。

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

🙏 致谢

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

⭐ 如果本项目对你有帮助，请点个 Star 支持一下！ ⭐

🚀 Happy Coding with AI! 🤖

© 2026 Tencent, Inc. Supported by Tencent Cloud
About Us
Privacy Policy
Terms of Service
SLA
API
SKILL
Docs
Showcase
Feedback
35/F,Tencent Building,Kejizhongyi Avenue,Nanshan District,Shenzhen
京ICP备11018762号-111
粤公网安备44030002006058号粤公网安备44030002006058号