Go to file
Haitao Pan f784561801
Merge pull request #48 from cloud-neutral-toolkit/scripts
chore(setup): align setup.sh with unified template
2026-02-09 10:37:16 +08:00
.agent feat: add security scrubbing skill documentation. 2026-02-06 12:26:57 +08:00
.github ci: default GHCR namespace to github.repository_owner 2025-12-24 12:43:53 +08:00
config 2026-01-30 11:18:28 +08:00
docs docs(i18n): add zh docs stubs 2026-02-09 10:00:07 +08:00
mcp Update MFA UI flags and lint guidance 2026-01-25 19:07:57 +08:00
public feat: add comprehensive SEO metadata, structured data, a custom 404 page, and SEO audit tooling. 2026-01-29 12:57:22 +08:00
Runbook feat: update homepage tagline and tech stack 2026-01-26 15:49:56 +08:00
scripts chore(setup): align setup.sh with unified template 2026-02-09 10:35:39 +08:00
skills feat: refactor navigation and sidebar structure, implement AI Assistant layout modes 2026-01-30 18:02:11 +08:00
src fix(demo): show all nodes for sandbox guest 2026-02-07 03:01:50 +08:00
tests fix(build): restore lint/test compatibility for agent module 2026-02-05 17:12:41 +08:00
types git commit -m "chore: split dashboard into standalone repository from XControl" 2025-12-14 22:33:14 +08:00
.config_summary.txt git commit -m "chore: split dashboard into standalone repository from XControl" 2025-12-14 22:33:14 +08:00
.cursorrules style: fix user menu alignment and spacing, and codify UI standards in skill 2026-02-02 13:06:09 +08:00
.env.example feat: Identify root users by configurable email instead of hardcoded username for privileged actions. 2026-02-05 13:53:22 +08:00
.eslintrc.json git commit -m "chore: split dashboard into standalone repository from XControl" 2025-12-14 22:33:14 +08:00
.gitignore feat: Add Gitleaks integration with pre-commit and pre-push hooks for automated secret detection, including configuration and related documentation. 2026-01-30 09:55:16 +08:00
.mcp.json Add Dev MCP setup 2026-01-13 23:40:34 +08:00
.nvmrc git commit -m "chore: split dashboard into standalone repository from XControl" 2025-12-14 22:33:14 +08:00
.yarnrc.yml docs: update privacy policy and terms of service with bilingual content 2026-02-02 15:31:50 +08:00
agent.md feat: Introduce agent operating rules and internal documentation, and refactor UI styling with design tokens. 2026-01-25 17:41:02 +08:00
AGENTS.md Update MFA UI flags and lint guidance 2026-01-25 19:07:57 +08:00
contentlayer.config.ts chore: commit all local changes after local verification 2026-02-05 17:05:43 +08:00
dev.log feat: Implement Material 3 Layout with Theme Switcher 2026-01-25 11:29:03 +00:00
Dockerfile Preserve blog content during builds 2026-01-01 18:25:12 +08:00
frontend.log feat: refine registration UX and migrate middleware CORS 2026-01-25 12:02:06 +08:00
LICENSE Update project license from GPLv3 to MIT and remove package-lock.json. 2026-02-01 23:33:50 +08:00
Makefile Update blog CTA and blog content handling 2025-12-22 19:55:50 +08:00
next-env.d.ts feat: Implement global acceleration guide wizard 2026-02-06 23:36:42 +08:00
next.config.mjs feat: refine registration UX and migrate middleware CORS 2026-01-25 12:02:06 +08:00
package.json fix(build): restore lint/test compatibility for agent module 2026-02-05 17:12:41 +08:00
postcss.config.mjs git commit -m "chore: split dashboard into standalone repository from XControl" 2025-12-14 22:33:14 +08:00
README.md docs(setup): add curl-based setup script 2026-02-09 10:00:12 +08:00
run-api-test.sh chore: add E2E registration tests and helper scripts 2026-01-25 12:07:00 +08:00
run-ui-test.sh chore: add E2E registration tests and helper scripts 2026-01-25 12:07:00 +08:00
start.sh git commit -m "chore: split dashboard into standalone repository from XControl" 2025-12-14 22:33:14 +08:00
tailwind.config.js feat: fine-tune user account dropdown menu with Radix UI and custom animations 2026-02-02 12:39:17 +08:00
test-esm.js git commit -m "chore: split dashboard into standalone repository from XControl" 2025-12-14 22:33:14 +08:00
tsconfig.json Ensure contentlayer build artifacts and fix blog rendering 2025-12-22 12:56:21 +08:00
X_ANNOUNCEMENT_DRAFT.md chore: checkpoint current branch changes 2026-02-04 19:56:11 +08:00
yarn.lock chore: Disable custom npm registry server configuration in .yarnrc.yml. 2026-02-02 15:17:28 +08:00

console.svc.plus

工程师 · 开源 · 云中立

关注 Ops / Infra / AI技术自由🏗️ 热衷于构建“逃生舱”,防止基础设施被厂商锁定。

Accountable Engineer · Open Source · Cloud Neutral

Focus on Ops / Infra / AI and Technical Freedom. 🏗️ Passionate about building "escape pods" to prevent infrastructure vendor lock-in.


console.svc.plus 是 Cloud Neutral Toolkit 的开放云控制面板

console.svc.plus is the Open Cloud Control Panel for the Cloud Neutral Toolkit.

项目简介 (About The Project)

本项目是 Cloud Neutral 生态系统的核心可视化界面(前端仪表盘)。它连接各个微服务,为管理云中立基础设施提供统一的控制平面。

This repository serves as the central visual interface (Frontend Dashboard) for the Cloud Neutral ecosystem. It connects various micro-services to provide a unified control plane for managing your cloud-neutral infrastructure.

该生态系统目前包含多个专用的微后端和服务:

  • console.svc.plus: (本项目) 主前端仪表盘。
  • accounts.svc.plus: 身份与账户管理服务。
  • rag-server.svc.plus: 检索增强生成 (RAG) 后端。
  • postgresql.svc.plus: 带有专用扩展的 PostgreSQL 数据库服务。
  • page-reading-agent-backend: 页面阅读智能体后端逻辑。
  • page-reading-agent-dashboard: 页面阅读智能体专用仪表盘。
  • wechat-to-markdown.svc.plus: 微信内容转 Markdown 工具服务 (开源引用项目)

技术栈 (Tech Stack)

本仪表盘使用现代 Web 技术构建:

This dashboard is built using modern web technologies:

快速开始 (Getting Started)

前置要求 (Prerequisites)

  • Node.js (>=18.17 <25)
  • Yarn (推荐) 或 npm

一键初始化 (Setup Script)

支持使用 curl | bash 在本地快速拉取仓库并完成依赖安装(不写入任何 secrets若本地不存在 .env,会从 .env.example 生成占位 .env

curl -fsSL "https://raw.githubusercontent.com/cloud-neutral-toolkit/console.svc.plus/main/scripts/setup.sh?$(date +%s)" | bash -s -- console.svc.plus

Notes: If cloud-neutral-toolkit/console.svc.plus is private, you'll need access/auth (e.g. gh auth login) before cloning works.

安装 (Installation)

yarn install

本地运行 (Running Locally)

启动开发服务器:

To start the development server:

yarn dev

此命令会运行设置脚本 (scripts/Dev-MCP-Server.sh) 并启动带有 TurboPack 的 Next.js 开发服务器。

This command runs the setup script (scripts/Dev-MCP-Server.sh) and starts the Next.js development server with TurboPack.

构建生产版本 (Building for Production)

yarn build

认证配置 (Authentication Configuration)

有关如何配置 GitHub 和 Google OIDC 认证的详细步骤,请参阅 OIDC 认证指南

For detailed steps on configuring GitHub and Google OIDC authentication, please refer to the OIDC Authentication Guide.

统计配置 (Homepage Stats Configuration)

首页“注册用户数 / 访问量”所需 Cloudflare 变量说明,请参阅 Cloudflare Web Analytics 集成配置

For Cloudflare variables used by homepage stats, see the Cloudflare Web Analytics integration guide.

开发指南 (Development Guidelines)

有关详细的编码标准、架构规则和 Agent 特定说明,请参阅 AGENTS.md

For detailed coding standards, architecture rules, and agent-specific instructions, please refer to AGENTS.md.

文档 (Docs)

  • EN: docs/ (see docs/README.md)
  • ZH: docs/zh/ (see docs/zh/README.md)

脚本 (Scripts)

  • dev: 启动开发服务器。
  • build: 构建生产版本应用。
  • test: 使用 Vitest 运行单元测试。
  • test:e2e: 使用 Playwright 运行端到端测试。
  • lint: 运行代码检查 (Linter)。