From 636efd79ff5d3f64a8a407452f1f81052674cfb3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=AD=9F=E5=AE=81?= Date: Thu, 13 Nov 2025 02:58:03 +0000 Subject: [PATCH] =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E7=9A=84=E7=9B=AE=E5=BD=95?= =?UTF-8?q?=E7=BB=93=E6=9E=84=E5=92=8C=E5=91=BD=E5=90=8D=E5=81=9A=E4=BA=86?= =?UTF-8?q?=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/.vitepress/config.mts | 146 ++++++++++++++++-- docs/{cloudbuild => compiling}/index.md | 26 ++-- docs/devstar/index.md | 12 +- docs/index.md | 6 +- docs/{components => }/index.vue | 8 +- .../CPU-utilization-16.png | Bin .../CPU-utilization-4.png | Bin .../CPU-utilization-8.png | Bin .../architecture.png | Bin .../cloudbuild-distributed-compilation.png | Bin .../cloudbuild-installation.png | Bin .../compiler-principles.png | Bin .../layered-system-architecture.png | Bin .../promotional-graphic-cloudbuild.jpg | Bin .../system-diagram.png | Bin .../{cloudbuild => compiling}/table1.png | Bin .../{cloudbuild => compiling}/table2.png | Bin package-lock.json | 10 +- package.json | 2 +- 19 files changed, 163 insertions(+), 47 deletions(-) rename docs/{cloudbuild => compiling}/index.md (81%) rename docs/{components => }/index.vue (97%) rename docs/public/{cloudbuild => compiling}/CPU-utilization-16.png (100%) rename docs/public/{cloudbuild => compiling}/CPU-utilization-4.png (100%) rename docs/public/{cloudbuild => compiling}/CPU-utilization-8.png (100%) rename docs/public/{cloudbuild => compiling}/architecture.png (100%) rename docs/public/{cloudbuild => compiling}/cloudbuild-distributed-compilation.png (100%) rename docs/public/{cloudbuild => compiling}/cloudbuild-installation.png (100%) rename docs/public/{cloudbuild => compiling}/compiler-principles.png (100%) rename docs/public/{cloudbuild => compiling}/layered-system-architecture.png (100%) rename docs/public/{cloudbuild => compiling}/promotional-graphic-cloudbuild.jpg (100%) rename docs/public/{cloudbuild => compiling}/system-diagram.png (100%) rename docs/public/{cloudbuild => compiling}/table1.png (100%) rename docs/public/{cloudbuild => compiling}/table2.png (100%) diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 5250d87..c05b30d 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -20,13 +20,15 @@ export default defineConfig({ nav: [ // { text: '文档', link: '/document/index' }, // - { text: 'Devstar', link: '/devstar' }, - { text: 'Cloudbuild', link: '/cloudbuild' }, - { text: 'Simulator', link: '/simulator' }, + { text: 'DevStar Studio', link: '/devstar' }, + { text: '编译加速', link: '/compiling' }, + { text: '虚拟仿真', link: '/simulator' }, { text: 'Enterprise', link: '/enterprise' }, ], sidebar: { - '/devstar/': sidebarDocument(), // 直接返回 SidebarItem[] + '/devstar/': sidebarDevStar(), // 直接返回 SidebarItem[] + '/compiling/': sidebarCompiling(), + '/simulator/': sidebarSimulator(), '/enterprise/': sidebarEnterprise() }, socialLinks: [ @@ -34,7 +36,7 @@ export default defineConfig({ ], // footer: [ // copyright: 'Copyright © 2025-present devstar contributors', - // [Copyright © 2025-present Devstar Contributors](https://github.com/mengning/DevStar) + // [Copyright © 2025-present DevStar Contributors](https://github.com/mengning/DevStar) // { copyright: 'Copyright © 2025-present devstar contributors', link: 'https://github.com/mengning/DevStar' } // ] as any, // footer: { @@ -64,10 +66,10 @@ export default defineConfig({ } }) -function sidebarDocument(): DefaultTheme.SidebarItem[] { +function sidebarDevStar(): DefaultTheme.SidebarItem[] { return [ { - text: 'Devstar是什么', + text: 'DevStar是什么', link: '/devstar/index', items: [] } as any, @@ -229,6 +231,128 @@ function sidebarDocument(): DefaultTheme.SidebarItem[] { ] } +function sidebarSimulator(): DefaultTheme.SidebarItem[] { + return [ + { + text: 'Gitea Enterprise 是什么', + link: '/enterprise/index', + items: [ + + ] + }, + { + text: '特征', + collapsible: true, // 使整个组可折叠 + collapsed: true, // 默认展开 + items: [ + { + text: '可继承分支保护', + link: 'https://docs.gitea.com/enterprise/features/inheritable-branch-protection' + }, + { + text: '依赖关系扫描', + link: 'https://docs.gitea.com/enterprise/features/dependency-scan' + }, + { + text: 'IP 允许列表', + link: 'https://docs.gitea.com/enterprise/features/ip-allowlist' + }, + { + text: '企业主题', + link: 'https://docs.gitea.com/enterprise/features/enterprise-theme' + }, + { + text: '强制2FA身份验证', + link: 'https://docs.gitea.com/enterprise/features/mandatory-2fa' + }, + { + text: '审计日志', + link: 'https://docs.gitea.com/enterprise/features/audit-log' + }, + { + text: 'SAML', + link: 'https://docs.gitea.com/enterprise/features/saml-auth' + }, + { + text: '发布节奏和版本控制', + link: 'https://docs.gitea.com/enterprise/features/release-cadence' + } + ] + } as any, + { + text: '安装', + link: 'https://docs.gitea.com/enterprise/installation', + items: [] + }, + { + text: '常见问题', + link: 'https://docs.gitea.com/enterprise/faq', + items: [] + }, + ] +} + +function sidebarCompiling(): DefaultTheme.SidebarItem[] { + return [ + { + text: 'Gitea Enterprise 是什么', + link: '/enterprise/index', + items: [ + + ] + }, + { + text: '特征', + collapsible: true, // 使整个组可折叠 + collapsed: true, // 默认展开 + items: [ + { + text: '可继承分支保护', + link: 'https://docs.gitea.com/enterprise/features/inheritable-branch-protection' + }, + { + text: '依赖关系扫描', + link: 'https://docs.gitea.com/enterprise/features/dependency-scan' + }, + { + text: 'IP 允许列表', + link: 'https://docs.gitea.com/enterprise/features/ip-allowlist' + }, + { + text: '企业主题', + link: 'https://docs.gitea.com/enterprise/features/enterprise-theme' + }, + { + text: '强制2FA身份验证', + link: 'https://docs.gitea.com/enterprise/features/mandatory-2fa' + }, + { + text: '审计日志', + link: 'https://docs.gitea.com/enterprise/features/audit-log' + }, + { + text: 'SAML', + link: 'https://docs.gitea.com/enterprise/features/saml-auth' + }, + { + text: '发布节奏和版本控制', + link: 'https://docs.gitea.com/enterprise/features/release-cadence' + } + ] + } as any, + { + text: '安装', + link: 'https://docs.gitea.com/enterprise/installation', + items: [] + }, + { + text: '常见问题', + link: 'https://docs.gitea.com/enterprise/faq', + items: [] + }, + ] +} + function sidebarEnterprise(): DefaultTheme.SidebarItem[] { return [ { @@ -290,11 +414,3 @@ function sidebarEnterprise(): DefaultTheme.SidebarItem[] { ] } -function sidebarRunner(): DefaultTheme.SidebarItem[] { - return [ - { - link: '/runner/index', - }, - ] -} - diff --git a/docs/cloudbuild/index.md b/docs/compiling/index.md similarity index 81% rename from docs/cloudbuild/index.md rename to docs/compiling/index.md index 10da1b0..5740494 100644 --- a/docs/cloudbuild/index.md +++ b/docs/compiling/index.md @@ -1,5 +1,5 @@ # 分布式编译系统CloudBuild -![alt text](/public/cloudbuild/promotional-graphic-cloudbuild.jpg) +![alt text](/public/compiling/promotional-graphic-cloudbuild.jpg) ## 为什么需要分布式编译技术 - 大型项目过长的编译耗时将会给开发、测试和调试都带来延迟，所以缩短大型项目的编译时间的分布式编译系统有重要意义 - 使用分布式编译系统编译项目可以利用计算机集群提高编译效率，缩短项目编译时间 @@ -7,7 +7,7 @@ ## 总体架构 ### 系统总体架构 -![alt text](/public/cloudbuild/architecture.png) +![alt text](/public/compiling/architecture.png) - Ninja：客户端，该机器上需要保存有完整的待编译项目源代码。 - Action Cache：服务端缓存，主要保存编译任务的执行结果。 - CAS Cache：服务端缓存，主要保存客户端上传的依赖文件，编译结果文件。 @@ -17,19 +17,19 @@ - Executor：各个编译节点 ### 部署示意图 -![alt text](/public/cloudbuild/system-diagram.png) +![alt text](/public/compiling/system-diagram.png) CloudBuild主程序分为三个部分：Client、Server、Executor。 - Client：运行在客户端，和用户对接，用于生成待执行的远程编译任务， 同时也作为本地编译节点执行本地任务。 - Server：运行在主服务器，主要用于连接各个编译节点，以及 将客户端上传的编译任务调度到与其连接的各个编译节点上。 - Executor：运行在编译节点，负责接收并执行编译任务，是编译任务真正执行的地方。 ### 系统分层结构 -![alt text](/public/cloudbuild/layered-system-architecture.png) +![alt text](/public/compiling/layered-system-architecture.png) ## 运行原理与流程 ### 分布式编译原理 -![alt text](/public/cloudbuild/compiler-principles.png) +![alt text](/public/compiling/compiler-principles.png) ### CloudBuild客户端 CloudBuild客户端基于Ninja改造，有下面这些优势 @@ -54,23 +54,23 @@ CloudBuild客户端基于Ninja改造，有下面这些优势 ## AOSP和LLVM上的应用 ### LLVM上的应用效果 -![alt text](/public/cloudbuild/table1.png) +![alt text](/public/compiling/table1.png) ### AOSP上的应用效果 -![alt text](/public/cloudbuild/table2.png) +![alt text](/public/compiling/table2.png) ### CloudBuild硬件资源利用率 4核CPU利用率: -![alt text](/public/cloudbuild/CPU-utilization-4.png) +![alt text](/public/compiling/CPU-utilization-4.png) 8核CPU利用率: -![alt text](/public/cloudbuild/CPU-utilization-8.png) +![alt text](/public/compiling/CPU-utilization-8.png) 16核CPU利用率: -![alt text](/public/cloudbuild/CPU-utilization-16.png) +![alt text](/public/compiling/CPU-utilization-16.png) ## CloudBuild使用方法 ### CloudBuild安装 -![alt text](/public/cloudbuild/cloudbuild-installation.png) -CloudBuild项目地址：https://gitee.com/cloudbuild888/cloudbuild.git +![alt text](/public/compiling/cloudbuild-installation.png) +CloudBuild项目地址：https://gitee.com/cloudbuild888/compiling.git ### CloudBuild分布式编译 -![alt text](/public/cloudbuild/cloudbuild-distributed-compilation.png) +![alt text](/public/compiling/cloudbuild-distributed-compilation.png) LLVM项目地址：https://gitee.com/mirrors/LLVM.git diff --git a/docs/devstar/index.md b/docs/devstar/index.md index 3b86ecb..aac443d 100644 --- a/docs/devstar/index.md +++ b/docs/devstar/index.md @@ -3,7 +3,7 @@ outline: deep weight: 1 --- -# 关于Devstar +# 关于DevStar DevStar一站式智能研发平台采用分层架构设计，核心提供DevEnv容器化开发引擎、CI/CD流水线（原生支持Actions和Runners）、Git代码仓库和制品管理功能，上层全面兼容主流IDE（如VSCode、Cursor）和开发工具链，支持C/C++/Go/Rust等语言及ARM/RISC-V/AI芯片开发。平台集成了代码大模型（如DeepSeek、Claude）、MCP服务器集群（包括Github-MCP和DevStar-MCP）、分布式编译服务（CloudBuild/BuildFarm）以及虚拟化平台（QEMU/Renode）等增强功能，底层基于Docker/Kubernetes云原生平台构建，形成从编码、测试到部署的完整研发生态，并通过项目模板生态和应用商店实现开箱即用的开发体验。 @@ -18,11 +18,11 @@ DevStar Studio是一个通用的一站式软件研发平台，它最初的目标 - Git代码托管、镜像仓库等制品管理Releases/Packages、项目管理Projects/Issues、知识管理Wiki等 ## 优势 -- 验证与开发同步：传统开发流程验证阶段滞后于开发，而Devstar开发流程可以实现“边开发边验证”的并行模式 -- 集成测试前置：传统开发流程集成测试集中在后期，而Devstar开发流程将集成测试拆解到开发各阶段 -- 测试条件与实际高度一致：传统开发流程测试环境与真实场景存在差异，而Devstar开发流程可以构建高保真测试环境 -- 失效迭代前置：传统开发流程失效迭代出现在后期，而Devstar开发流程将失效识别和处理提前到了开发早期 -- 兼容不容层级的虚拟化：传统开发流程只能保证单一流程的虚拟化，而而Devstar开发流程可同时兼容硬件级虚拟化、系统级虚拟化、进程级虚拟化 +- 验证与开发同步：传统开发流程验证阶段滞后于开发，而DevStar开发流程可以实现“边开发边验证”的并行模式 +- 集成测试前置：传统开发流程集成测试集中在后期，而DevStar开发流程将集成测试拆解到开发各阶段 +- 测试条件与实际高度一致：传统开发流程测试环境与真实场景存在差异，而DevStar开发流程可以构建高保真测试环境 +- 失效迭代前置：传统开发流程失效迭代出现在后期，而DevStar开发流程将失效识别和处理提前到了开发早期 +- 兼容不容层级的虚拟化：传统开发流程只能保证单一流程的虚拟化，而而DevStar开发流程可同时兼容硬件级虚拟化、系统级虚拟化、进程级虚拟化 ## 在线演示 diff --git a/docs/index.md b/docs/index.md index 3f755ed..983c881 100644 --- a/docs/index.md +++ b/docs/index.md @@ -5,7 +5,7 @@ layout: home hero: # name: "             通用的" # text: "              为中小型公司提供IT服务" - text: "DevStar Studio: The Last Mile of Al for R&D" + text: "DevStar: The Last Mile of Al for R&D" tagline: 为AI时代打造的新一代智能研发平台，面向人类开发者和AI开发者的融合团队，专注于产品质量和团队效能，为研发部门赋能提效的一站式解决方案 image: src: /slider1.png @@ -16,7 +16,7 @@ hero: # link: /devstar/index # - theme: alt # text: CloudBuild - # link: /cloudbuild/index + # link: /compiling/index # - theme: alt # text: Simulator # link: /simulator/index @@ -30,7 +30,7 @@ hero: # details: 安装和使用体验良好的详细描述 --- diff --git a/docs/components/index.vue b/docs/index.vue similarity index 97% rename from docs/components/index.vue rename to docs/index.vue index b973dad..a40ba82 100644 --- a/docs/components/index.vue +++ b/docs/index.vue @@ -15,12 +15,12 @@ :class="{ 'image-hover': hoverItem === 'about' }" >
-

Devstar Studio

+

AI+ DevOps

-

Cloudbuild

+

编译加速

 @@ -49,7 +49,7 @@ :class="{ 'image-hover': hoverItem === 'office' }" >
-

Simulator

+

虚拟仿真

diff --git a/docs/public/cloudbuild/CPU-utilization-16.png b/docs/public/compiling/CPU-utilization-16.png similarity index 100% rename from docs/public/cloudbuild/CPU-utilization-16.png rename to docs/public/compiling/CPU-utilization-16.png diff --git a/docs/public/cloudbuild/CPU-utilization-4.png b/docs/public/compiling/CPU-utilization-4.png similarity index 100% rename from docs/public/cloudbuild/CPU-utilization-4.png rename to docs/public/compiling/CPU-utilization-4.png diff --git a/docs/public/cloudbuild/CPU-utilization-8.png b/docs/public/compiling/CPU-utilization-8.png similarity index 100% rename from docs/public/cloudbuild/CPU-utilization-8.png rename to docs/public/compiling/CPU-utilization-8.png diff --git a/docs/public/cloudbuild/architecture.png b/docs/public/compiling/architecture.png similarity index 100% rename from docs/public/cloudbuild/architecture.png rename to docs/public/compiling/architecture.png diff --git a/docs/public/cloudbuild/cloudbuild-distributed-compilation.png b/docs/public/compiling/cloudbuild-distributed-compilation.png similarity index 100% rename from docs/public/cloudbuild/cloudbuild-distributed-compilation.png rename to docs/public/compiling/cloudbuild-distributed-compilation.png diff --git a/docs/public/cloudbuild/cloudbuild-installation.png b/docs/public/compiling/cloudbuild-installation.png similarity index 100% rename from docs/public/cloudbuild/cloudbuild-installation.png rename to docs/public/compiling/cloudbuild-installation.png diff --git a/docs/public/cloudbuild/compiler-principles.png b/docs/public/compiling/compiler-principles.png similarity index 100% rename from docs/public/cloudbuild/compiler-principles.png rename to docs/public/compiling/compiler-principles.png diff --git a/docs/public/cloudbuild/layered-system-architecture.png b/docs/public/compiling/layered-system-architecture.png similarity index 100% rename from docs/public/cloudbuild/layered-system-architecture.png rename to docs/public/compiling/layered-system-architecture.png diff --git a/docs/public/cloudbuild/promotional-graphic-cloudbuild.jpg b/docs/public/compiling/promotional-graphic-cloudbuild.jpg similarity index 100% rename from docs/public/cloudbuild/promotional-graphic-cloudbuild.jpg rename to docs/public/compiling/promotional-graphic-cloudbuild.jpg diff --git a/docs/public/cloudbuild/system-diagram.png b/docs/public/compiling/system-diagram.png similarity index 100% rename from docs/public/cloudbuild/system-diagram.png rename to docs/public/compiling/system-diagram.png diff --git a/docs/public/cloudbuild/table1.png b/docs/public/compiling/table1.png similarity index 100% rename from docs/public/cloudbuild/table1.png rename to docs/public/compiling/table1.png diff --git a/docs/public/cloudbuild/table2.png b/docs/public/compiling/table2.png similarity index 100% rename from docs/public/cloudbuild/table2.png rename to docs/public/compiling/table2.png diff --git a/package-lock.json b/package-lock.json index c4032e5..abe9350 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,5 +1,5 @@ { - "name": "devstar介绍文档", + "name": "docs", "lockfileVersion": 3, "requires": true, "packages": { @@ -9,7 +9,7 @@ "prismjs": "^1.30.0" }, "devDependencies": { - "vitepress": "^1.6.3" + "vitepress": "^1.6.4" } }, "node_modules/@algolia/autocomplete-core": { @@ -2291,9 +2291,9 @@ } }, "node_modules/vitepress": { - "version": "1.6.3", - "resolved": "https://registry.npmmirror.com/vitepress/-/vitepress-1.6.3.tgz", - "integrity": "sha512-fCkfdOk8yRZT8GD9BFqusW3+GggWYZ/rYncOfmgcDtP3ualNHCAg+Robxp2/6xfH1WwPHtGpPwv7mbA3qomtBw==", + "version": "1.6.4", + "resolved": "https://registry.npmjs.org/vitepress/-/vitepress-1.6.4.tgz", + "integrity": "sha512-+2ym1/+0VVrbhNyRoFFesVvBvHAVMZMK0rw60E3X/5349M1GuVdKeazuksqopEdvkKwKGs21Q729jX81/bkBJg==", "dev": true, "license": "MIT", "dependencies": { diff --git a/package.json b/package.json index a45b63f..0fc19b8 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "devDependencies": { - "vitepress": "^1.6.3" + "vitepress": "^1.6.4" }, "scripts": { "docs:dev": "vitepress dev docs",