Skip to content

CubeLoop — a Pythonic, async-native agent harness core designed for high performance, readability, and production-grade persistence.

fix(seo): make canonical URLs trailing-slash-free and consistent

xf gong8317839f1646
diff --git a/website/docs/intro.mdx b/website/docs/intro.mdx
index ff9b2ed..575fe51 100644
--- a/website/docs/intro.mdx
+++ b/website/docs/intro.mdx
@@ -19,7 +19,7 @@ a linear `while` loop that developers can easily trace and debug.
pip install cubepi
```
-Then jump to the [Quick Start](./getting-started/quick-start) to ship a
+Then jump to the [Quick Start](./getting-started/quick-start.md) to ship a
working tool-using agent in under five minutes.
## What you get
@@ -55,14 +55,14 @@ working tool-using agent in under five minutes.
| If you want to… | Start here |
|---|---|
-| Install and run your first agent | [Getting Started → Installation](./getting-started/installation) |
-| Understand the building blocks | [Getting Started → Core Concepts](./getting-started/core-concepts) |
-| Wire a real tool-using agent | [Guides → Building Your First Agent](./guides/agents/first-agent) |
-| Persist a conversation across restarts | [Guides → SQLite Checkpointing](./guides/checkpointing/sqlite) |
-| Ship traces to Jaeger / Tempo / Honeycomb | [Guides → Tracing](./guides/tracing/overview) |
-| Look up a specific symbol | [API Reference](./api/) |
-| See full working examples | [Recipes](./recipes/weather-agent) |
-| Port an existing langgraph agent | [Migration → From langgraph](./migration/from-langgraph) |
+| Install and run your first agent | [Getting Started → Installation](./getting-started/installation.md) |
+| Understand the building blocks | [Getting Started → Core Concepts](./getting-started/core-concepts.md) |
+| Wire a real tool-using agent | [Guides → Building Your First Agent](./guides/agents/first-agent.md) |
+| Persist a conversation across restarts | [Guides → SQLite Checkpointing](./guides/checkpointing/sqlite.md) |
+| Ship traces to Jaeger / Tempo / Honeycomb | [Guides → Tracing](./guides/tracing/overview.md) |
+| Look up a specific symbol | [API Reference](./api/index.mdx) |
+| See full working examples | [Recipes](./recipes/weather-agent.md) |
+| Port an existing langgraph agent | [Migration → From langgraph](./migration/from-langgraph.md) |
## Status
diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts
index 4e913af..217487e 100644
--- a/website/docusaurus.config.ts
+++ b/website/docusaurus.config.ts
@@ -73,7 +73,7 @@ const config: Config = {
url: 'https://cubepi.ai',
baseUrl: '/',
- trailingSlash: true,
+ trailingSlash: false,
organizationName: 'cubeplexai',
projectName: 'cubepi',
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.mdx
index 2095769..d604267 100644
--- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.mdx
+++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/current/intro.mdx
@@ -19,7 +19,7 @@ import PackageVersion from '@site/src/components/PackageVersion';
pip install cubepi
```
-然后跳到 [快速开始](./getting-started/quick-start),五分钟内跑通一个
+然后跳到 [快速开始](./getting-started/quick-start.md),五分钟内跑通一个
能调用工具的 Agent。
## 你能拿到什么
@@ -54,13 +54,13 @@ pip install cubepi
| 如果你想… | 从这里开始 |
|---|---|
-| 安装并跑通第一个 Agent | [入门 → 安装](./getting-started/installation) |
-| 理解骨架 | [入门 → 核心概念](./getting-started/core-concepts) |
-| 接入一个真实的工具 Agent | [指南 → 构建第一个 Agent](./guides/agents/first-agent) |
-| 跨重启保留对话 | [指南 → SQLite 检查点](./guides/checkpointing/sqlite) |
-| 查找某个具体符号 | [API 参考](./api/) |
-| 看完整的可运行示例 | [Recipes](./recipes/weather-agent) |
-| 从 langgraph Agent 迁移 | [迁移 → 来自 langgraph](./migration/from-langgraph) |
+| 安装并跑通第一个 Agent | [入门 → 安装](./getting-started/installation.md) |
+| 理解骨架 | [入门 → 核心概念](./getting-started/core-concepts.md) |
+| 接入一个真实的工具 Agent | [指南 → 构建第一个 Agent](./guides/agents/first-agent.md) |
+| 跨重启保留对话 | [指南 → SQLite 检查点](./guides/checkpointing/sqlite.md) |
+| 查找某个具体符号 | [API 参考](pathname:///zh-Hans/docs/next/api) |
+| 看完整的可运行示例 | [Recipes](./recipes/weather-agent.md) |
+| 从 langgraph Agent 迁移 | [迁移 → 来自 langgraph](./migration/from-langgraph.md) |
## 状态
diff --git a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.12/intro.mdx b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.12/intro.mdx
index 79ecffa..99511f3 100644
--- a/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.12/intro.mdx
+++ b/website/i18n/zh-Hans/docusaurus-plugin-content-docs/version-0.12/intro.mdx
@@ -17,7 +17,7 @@ sidebar_position: 0
pip install cubepi
```
-然后跳到 [快速开始](./getting-started/quick-start),五分钟内跑通一个
+然后跳到 [快速开始](./getting-started/quick-start.md),五分钟内跑通一个
能调用工具的 Agent。
## 你能拿到什么
@@ -52,13 +52,13 @@ pip install cubepi
| 如果你想… | 从这里开始 |
|---|---|
-| 安装并跑通第一个 Agent | [入门 → 安装](./getting-started/installation) |
-| 理解骨架 | [入门 → 核心概念](./getting-started/core-concepts) |
-| 接入一个真实的工具 Agent | [指南 → 构建第一个 Agent](./guides/agents/first-agent) |
-| 跨重启保留对话 | [指南 → SQLite 检查点](./guides/checkpointing/sqlite) |
-| 查找某个具体符号 | [API 参考](./api/) |
-| 看完整的可运行示例 | [Recipes](./recipes/weather-agent) |
-| 从 langgraph Agent 迁移 | [迁移 → 来自 langgraph](./migration/from-langgraph) |
+| 安装并跑通第一个 Agent | [入门 → 安装](./getting-started/installation.md) |
+| 理解骨架 | [入门 → 核心概念](./getting-started/core-concepts.md) |
+| 接入一个真实的工具 Agent | [指南 → 构建第一个 Agent](./guides/agents/first-agent.md) |
+| 跨重启保留对话 | [指南 → SQLite 检查点](./guides/checkpointing/sqlite.md) |
+| 查找某个具体符号 | [API 参考](pathname:///zh-Hans/docs/api) |
+| 看完整的可运行示例 | [Recipes](./recipes/weather-agent.md) |
+| 从 langgraph Agent 迁移 | [迁移 → 来自 langgraph](./migration/from-langgraph.md) |
## 状态
diff --git a/website/package.json b/website/package.json
index 55f7139..4ffdc44 100644
--- a/website/package.json
+++ b/website/package.json
@@ -6,7 +6,6 @@
"docusaurus": "docusaurus",
"start": "docusaurus start",
"build": "docusaurus build",
- "postbuild": "node scripts/add-trailing-slashes.js",
"swizzle": "docusaurus swizzle",
"deploy": "docusaurus deploy",
"clear": "docusaurus clear",
diff --git a/website/scripts/add-trailing-slashes.js b/website/scripts/add-trailing-slashes.js
deleted file mode 100644
index 388fddf..0000000
--- a/website/scripts/add-trailing-slashes.js
+++ /dev/null
@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-/**
- * Add trailing slashes to URLs in sitemap files.
- * Prevents Google from deindexing due to redirect chains.
- * Runs after docusaurus build.
- */
-
-const fs = require('fs');
-const path = require('path');
-
-const sitemapFiles = [
- 'build/sitemap.xml',
- 'build/zh-Hans/sitemap.xml',
-];
-
-const buildDir = path.join(__dirname, '..');
-
-for (const file of sitemapFiles) {
- const filePath = path.join(buildDir, file);
- if (!fs.existsSync(filePath)) {
- console.log(`Skipping ${file} (not found)`);
- continue;
- }
-
- let content = fs.readFileSync(filePath, 'utf-8');
-
- // Match URLs in <loc> tags and add trailing slash if not present
- // Don't add slash if URL already ends with .xml or has a hash
- const updated = content.replace(
- /<loc>([^<]+)<\/loc>/g,
- (match, url) => {
- // Skip if already has trailing slash, has a file extension, or is the root
- if (url.endsWith('/') || url.match(/\.\w+$/) || url === 'https://cubepi.ai') {
- return match;
- }
- return `<loc>${url}/<\/loc>`;
- }
- );
-
- fs.writeFileSync(filePath, updated, 'utf-8');
- console.log(`✓ Added trailing slashes to ${file}`);
-}
diff --git a/website/versioned_docs/version-0.12/intro.mdx b/website/versioned_docs/version-0.12/intro.mdx
index 090db4d..64445e2 100644
--- a/website/versioned_docs/version-0.12/intro.mdx
+++ b/website/versioned_docs/version-0.12/intro.mdx
@@ -17,7 +17,7 @@ a linear `while` loop that developers can easily trace and debug.
pip install cubepi
```
-Then jump to the [Quick Start](./getting-started/quick-start) to ship a
+Then jump to the [Quick Start](./getting-started/quick-start.md) to ship a
working tool-using agent in under five minutes.
## What you get
@@ -53,14 +53,14 @@ working tool-using agent in under five minutes.
| If you want to… | Start here |
|---|---|
-| Install and run your first agent | [Getting Started → Installation](./getting-started/installation) |
-| Understand the building blocks | [Getting Started → Core Concepts](./getting-started/core-concepts) |
-| Wire a real tool-using agent | [Guides → Building Your First Agent](./guides/agents/first-agent) |
-| Persist a conversation across restarts | [Guides → SQLite Checkpointing](./guides/checkpointing/sqlite) |
-| Ship traces to Jaeger / Tempo / Honeycomb | [Guides → Tracing](./guides/tracing/overview) |
-| Look up a specific symbol | [API Reference](./api/) |
-| See full working examples | [Recipes](./recipes/weather-agent) |
-| Port an existing langgraph agent | [Migration → From langgraph](./migration/from-langgraph) |
+| Install and run your first agent | [Getting Started → Installation](./getting-started/installation.md) |
+| Understand the building blocks | [Getting Started → Core Concepts](./getting-started/core-concepts.md) |
+| Wire a real tool-using agent | [Guides → Building Your First Agent](./guides/agents/first-agent.md) |
+| Persist a conversation across restarts | [Guides → SQLite Checkpointing](./guides/checkpointing/sqlite.md) |
+| Ship traces to Jaeger / Tempo / Honeycomb | [Guides → Tracing](./guides/tracing/overview.md) |
+| Look up a specific symbol | [API Reference](./api/index.mdx) |
+| See full working examples | [Recipes](./recipes/weather-agent.md) |
+| Port an existing langgraph agent | [Migration → From langgraph](./migration/from-langgraph.md) |
## Status