Skip to content

docs: 修 Fumadocs githubUrl/markdownUrl/README 图片 3 个链接问题 #24

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
AgentArcLab merged 1 commit into from
Jul 3, 2026
Merged

docs: 修 Fumadocs githubUrl/markdownUrl/README 图片 3 个链接问题 #24

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0-blue?style=flat" /></a>
</p>

<p align="center"><a href="public-docs/assets/ksadk-runtime-platform-hero.png"><img alt="KsADK 真实 CLI 截图：agentengine -h" src="public-docs/assets/ksadk-runtime-platform-hero-wide.png" width="860" /></a></p>
<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-platform-hero.png"><img alt="KsADK 真实 CLI 截图：agentengine -h" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-platform-hero-wide.png" width="860" /></a></p>

## 30 秒快速体验

Expand All @@ -37,9 +37,9 @@ agentengine run -i
agentengine web . --no-open
```

<p align="center"><a href="public-docs/assets/ksadk-web-ui-screenshot.png"><img alt="KsADK 真实 Web UI 调试截图" src="public-docs/assets/ksadk-web-ui-screenshot.png" width="860" /></a></p>
<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-web-ui-screenshot.png"><img alt="KsADK 真实 Web UI 调试截图" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-web-ui-screenshot.png" width="860" /></a></p>

<p align="center"><a href="public-docs/assets/ksadk-local-debugging-demo.gif"><img alt="KsADK 真实本地 Web UI 演示" src="public-docs/assets/ksadk-local-debugging-demo.gif" width="860" /></a></p>
<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif"><img alt="KsADK 真实本地 Web UI 演示" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif" width="860" /></a></p>

## 为什么需要 KsADK

Expand All @@ -53,7 +53,7 @@ agentengine web . --no-open

## 架构

<p align="center"><a href="public-docs/assets/ksadk-runtime-architecture.png"><img alt="KsADK Agent Runtime Platform 架构" src="public-docs/assets/ksadk-runtime-architecture.png" width="860" /></a></p>
<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-architecture.png"><img alt="KsADK Agent Runtime Platform 架构" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-architecture.png" width="860" /></a></p>

## 文档与样例

Expand Down
2 changes: 1 addition & 1 deletion docs-site/app/[lang]/docs/[[...slug]]/page.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ export default async function Page({
<MarkdownCopyButton markdownUrl={markdownUrl} />
<ViewOptionsPopover
markdownUrl={markdownUrl}
githubUrl={`https://github.com/${gitConfig.user}/${gitConfig.repo}/blob/${gitConfig.branch}/docs-site/content/docs/${page.path}.mdx`}
githubUrl={`https://github.com/${gitConfig.user}/${gitConfig.repo}/blob/${gitConfig.branch}/docs-site/content/docs/${page.path}`}
/>
</div>
</div>
Expand Down
5 changes: 3 additions & 2 deletions docs-site/lib/source.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ import { docs } from 'collections/server';
import { loader } from 'fumadocs-core/source';
import { statusBadgesPlugin } from 'fumadocs-core/source/plugins/status-badges';
import { i18n } from './i18n';
import { docsContentRoute, docsImageRoute, docsRoute } from './shared';
import { docsContentRoute, docsImageRoute, docsRoute, assetPath } from './shared';

// See https://fumadocs.dev/docs/headless/source-api for more info
export const source = loader({
Expand Down Expand Up @@ -47,7 +47,8 @@ export function getPageMarkdownUrl(page: (typeof source)['$inferPage']) {

return {
segments,
url: `${docsContentRoute}/${segments.join('/')}`,
// GitHub Pages 在 /<repo> 子路径,markdown URL 需带 basePath,否则复制出来 404。
url: assetPath(`${docsContentRoute}/${segments.join('/')}`),
};
}

Expand Down
16 changes: 8 additions & 8 deletions tests/test_public_release_positioning.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,10 +26,10 @@ def test_public_readme_positions_ksadk_as_runtime_platform():
"文档与样例",
"相关项目",
"参与贡献",
"public-docs/assets/ksadk-runtime-platform-hero-wide.png",
"public-docs/assets/ksadk-web-ui-screenshot.png",
"public-docs/assets/ksadk-local-debugging-demo.gif",
"public-docs/assets/ksadk-runtime-architecture.png",
"ksadk-runtime-platform-hero-wide.png",
"ksadk-web-ui-screenshot.png",
"ksadk-local-debugging-demo.gif",
"ksadk-runtime-architecture.png",
):
assert expected in readme

Expand All @@ -46,10 +46,10 @@ def test_public_readme_language_variants_keep_homepage_shape():

for text in (zh_readme, en_readme):
assert "Kingsoft Cloud Agent Development Kit" in text
assert "public-docs/assets/ksadk-runtime-platform-hero-wide.png" in text
assert "public-docs/assets/ksadk-web-ui-screenshot.png" in text
assert "public-docs/assets/ksadk-local-debugging-demo.gif" in text
assert "public-docs/assets/ksadk-runtime-architecture.png" in text
assert "ksadk-runtime-platform-hero-wide.png" in text
assert "ksadk-web-ui-screenshot.png" in text
assert "ksadk-local-debugging-demo.gif" in text
assert "ksadk-runtime-architecture.png" in text
assert "发布版本：" not in text
assert "## 0.6." not in text

Expand Down
Loading