Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
31 changes: 28 additions & 3 deletions docs/_static/homepage.css
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,12 @@
All colors via Furo CSS variables for automatic light/dark mode
================================================================ */

/* Hide the Sphinx-rendered heading on landing pages (needed for <title> only) */
body.agentscope-home .md h1,
body.agentscope-home h1:first-of-type {
display: none;
}

/* ----- Full-width layout on home page ----- */
body.agentscope-home .sidebar-drawer {
display: none !important;
Expand Down Expand Up @@ -251,6 +257,14 @@ body.agentscope-home .content-icon-container {
border: 1px solid var(--hs-border);
}

.hs-install__tabs {
display: flex;
gap: 2px;
}

.hs-tab--build {
}

/* ----- Code panels ----- */
.hs-code-panel {
padding: 20px 22px;
Expand Down Expand Up @@ -294,13 +308,17 @@ body.agentscope-home .content-icon-container {
/* ----- Install bar ----- */
.hs-install {
display: flex;
align-items: center;
gap: 10px;
padding: 10px 16px;
flex-direction: column;
background: var(--hs-surface);
border-top: 1px solid var(--hs-border);
}

.hs-install__tabs {
display: flex;
gap: 2px;
padding: 4px 16px 0;
}

.hs-install code {
font-family: var(--font-mono) !important;
font-size: 0.78rem !important;
Expand All @@ -311,6 +329,13 @@ body.agentscope-home .content-icon-container {
padding: 4px 10px !important;
}

.hs-install__row {
display: flex;
align-items: center;
gap: 10px;
padding: 10px 16px;
}

.hs-copy-btn {
background: none;
border: 1px solid var(--hs-border);
Expand Down
7 changes: 5 additions & 2 deletions docs/_toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -137,10 +137,13 @@ parts:
- file: en/community/contributors
title: Contributors

- caption: 快速开始
- caption: 首页
chapters:
- file: zh/intro
title: 简介
title: 首页

- caption: 快速开始
chapters:
- file: zh/quickstart/installation
title: 安装
- file: zh/quickstart/key-concepts
Expand Down
21 changes: 11 additions & 10 deletions docs/en/community/contributors.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,15 +6,16 @@ See the full history on [GitHub Contributors](https://github.com/agentscope-ai/a

| Avatar | GitHub ID | Profile | Notes |
|:---:|:---|:---|:---|
| ![AlbumenJ](https://avatars.githubusercontent.com/u/9292748?s=64&v=4) | [AlbumenJ](https://github.com/AlbumenJ) | [github.com/AlbumenJ](https://github.com/AlbumenJ) | Core contributor · engineering & architecture |
| ![LearningGp](https://avatars.githubusercontent.com/u/38268859?s=64&v=4) | [LearningGp](https://github.com/LearningGp) | [github.com/LearningGp](https://github.com/LearningGp) | Core contributor · features & docs |
| ![fang-tech](https://avatars.githubusercontent.com/u/141339556?s=64&v=4) | [fang-tech](https://github.com/fang-tech) | [github.com/fang-tech](https://github.com/fang-tech) | Active contributor |
| ![guanxuc](https://avatars.githubusercontent.com/u/86234262?s=64&v=4) | [guanxuc](https://github.com/guanxuc) | [github.com/guanxuc](https://github.com/guanxuc) | Active contributor |
| ![JGoP-L](https://avatars.githubusercontent.com/u/52067013?s=64&v=4) | [JGoP-L](https://github.com/JGoP-L) | [github.com/JGoP-L](https://github.com/JGoP-L) | Active contributor |
| ![shiyiyue1102](https://avatars.githubusercontent.com/u/20452676?s=64&v=4) | [shiyiyue1102](https://github.com/shiyiyue1102) | [github.com/shiyiyue1102](https://github.com/shiyiyue1102) | Active contributor |
| ![jujn](https://avatars.githubusercontent.com/u/109072362?s=64&v=4) | [jujn](https://github.com/jujn) | [github.com/jujn](https://github.com/jujn) | Active contributor |
| ![KomachiSion](https://avatars.githubusercontent.com/u/37170243?s=64&v=4) | [KomachiSion](https://github.com/KomachiSion) | [github.com/KomachiSion](https://github.com/KomachiSion) | Active contributor |
| <img src="https://avatars.githubusercontent.com/u/18097545?s=64&v=4" width="64" height="64"> | [Chickenlj](https://github.com/chickenlj) | [github.com/chickenlj](https://github.com/chickenlj) | Core contributor · engineering & architecture |
| <img src="https://avatars.githubusercontent.com/u/9292748?s=64&v=4" width="64" height="64"> | [AlbumenJ](https://github.com/AlbumenJ) | [github.com/AlbumenJ](https://github.com/AlbumenJ) | Core contributor · engineering & architecture |
| <img src="https://avatars.githubusercontent.com/u/38268859?s=64&v=4" width="64" height="64"> | [LearningGp](https://github.com/LearningGp) | [github.com/LearningGp](https://github.com/LearningGp) | Core contributor · features & docs |
| <img src="https://avatars.githubusercontent.com/u/141339556?s=64&v=4" width="64" height="64"> | [fang-tech](https://github.com/fang-tech) | [github.com/fang-tech](https://github.com/fang-tech) | Active contributor |
| <img src="https://avatars.githubusercontent.com/u/86234262?s=64&v=4" width="64" height="64"> | [guanxuc](https://github.com/guanxuc) | [github.com/guanxuc](https://github.com/guanxuc) | Active contributor |
| <img src="https://avatars.githubusercontent.com/u/52067013?s=64&v=4" width="64" height="64"> | [JGoP-L](https://github.com/JGoP-L) | [github.com/JGoP-L](https://github.com/JGoP-L) | Active contributor |
| <img src="https://avatars.githubusercontent.com/u/20452676?s=64&v=4" width="64" height="64"> | [shiyiyue1102](https://github.com/shiyiyue1102) | [github.com/shiyiyue1102](https://github.com/shiyiyue1102) | Active contributor |
| <img src="https://avatars.githubusercontent.com/u/109072362?s=64&v=4" width="64" height="64"> | [jujn](https://github.com/jujn) | [github.com/jujn](https://github.com/jujn) | Active contributor |
| <img src="https://avatars.githubusercontent.com/u/37170243?s=64&v=4" width="64" height="64"> | [KomachiSion](https://github.com/KomachiSion) | [github.com/KomachiSion](https://github.com/KomachiSion) | Active contributor |

```{note}
Rows are curated from public contribution activity and **do not** represent official HR titles at Tongyi Lab or Alibaba. The Notes column is a short community-facing label—wording can be adjusted with maintainer agreement in a PR.
```
Rows are curated from public contribution activity and **do not** represent official HR titles at Tongyi Lab or Alibaba. The "Notes" column is a short community-facing label—wording can be adjusted with maintainer agreement in a PR.
```
96 changes: 77 additions & 19 deletions docs/en/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,8 @@
hide-toc: true
---

# Home

```{raw} html
<script>document.body.classList.add('agentscope-home');</script>

Expand Down Expand Up @@ -57,8 +59,14 @@ agent.call(messages).block();</pre></div>
agent.call(messages, <span class="ty">RuntimeContext</span>.builder()
.sessionId(<span class="str">"user-123"</span>).build()).block();</pre></div>
<div class="hs-install">
<code>io.agentscope:agentscope-harness</code>
<button class="hs-copy-btn" data-copy="io.agentscope:agentscope-harness">Copy Maven</button>
<div class="hs-install__tabs">
<div class="hs-tab hs-tab--build active" id="en-tab-maven">Maven</div>
<div class="hs-tab hs-tab--build" id="en-tab-gradle">Gradle</div>
</div>
<div class="hs-install__row">
<code id="en-install-code">&lt;dependency&gt;<br>&nbsp;&nbsp;&lt;groupId&gt;io.agentscope&lt;/groupId&gt;<br>&nbsp;&nbsp;&lt;artifactId&gt;agentscope-core&lt;/artifactId&gt;<br>&lt;/dependency&gt;</code>
<button class="hs-copy-btn" id="en-install-btn" data-copy="&lt;dependency&gt;&#10; &lt;groupId&gt;io.agentscope&lt;/groupId&gt;&#10; &lt;artifactId&gt;agentscope-core&lt;/artifactId&gt;&#10;&lt;/dependency&gt;">Copy</button>
</div>
</div>
</div>
</div>
Expand Down Expand Up @@ -258,28 +266,78 @@ agent.call(messages, <span class="ty">RuntimeContext</span>.builder()

<script>
(function () {
var buildFormat = 'maven';
var mavenMap = {
'en-react': '<dependency>\n <groupId>io.agentscope</groupId>\n <artifactId>agentscope-core</artifactId>\n</dependency>',
'en-harness': '<dependency>\n <groupId>io.agentscope</groupId>\n <artifactId>agentscope-harness</artifactId>\n</dependency>'
};
var gradleMap = {
'en-react': "implementation 'io.agentscope:agentscope-core'",
'en-harness': "implementation 'io.agentscope:agentscope-harness'"
};
var currentPanel = 'en-harness';

function renderInstall() {
var installCode = document.getElementById('en-install-code');
var installBtn = document.getElementById('en-install-btn');
if (!installCode || !installBtn) return;
var map = buildFormat === 'maven' ? mavenMap : gradleMap;
var text = map[currentPanel];
if (buildFormat === 'maven') {
installCode.innerHTML = text.replace(/</g, '&lt;').replace(/\n/g, '<br>').replace(/ {4}/g, '&nbsp;&nbsp;');
} else {
installCode.textContent = text;
}
installBtn.setAttribute('data-copy', text);
}

function updateBuildTabs() {
var mavenTab = document.getElementById('en-tab-maven');
var gradleTab = document.getElementById('en-tab-gradle');
if (!mavenTab || !gradleTab) return;
mavenTab.classList.toggle('active', buildFormat === 'maven');
gradleTab.classList.toggle('active', buildFormat === 'gradle');
}

document.addEventListener('click', function (e) {
var tab = e.target.closest('.hs-tab');
if (!tab) return;
var win = tab.closest('.hs-window');
if (!win) return;
var panelId = tab.getAttribute('data-panel');
win.querySelectorAll('.hs-tab').forEach(function (t) { t.classList.remove('active'); });
win.querySelectorAll('.hs-code-panel').forEach(function (p) { p.style.display = 'none'; });
tab.classList.add('active');
var panel = document.getElementById(panelId);
if (panel) panel.style.display = 'block';
});
document.querySelectorAll('.hs-copy-btn').forEach(function (btn) {
btn.addEventListener('click', function () {
var text = btn.getAttribute('data-copy');
if (tab) {
var panelId = tab.getAttribute('data-panel');
var mavenTab = document.getElementById('en-tab-maven');
var gradleTab = document.getElementById('en-tab-gradle');
if (tab === mavenTab) {
buildFormat = 'maven';
updateBuildTabs();
renderInstall();
return;
}
if (tab === gradleTab) {
buildFormat = 'gradle';
updateBuildTabs();
renderInstall();
return;
}
var win = tab.closest('.hs-window');
if (!win) return;
win.querySelectorAll('.hs-tab:not(.hs-tab--build)').forEach(function (t) { t.classList.remove('active'); });
win.querySelectorAll('.hs-code-panel').forEach(function (p) { p.style.display = 'none'; });
tab.classList.add('active');
var panel = document.getElementById(panelId);
if (panel) panel.style.display = 'block';
currentPanel = panelId;
renderInstall();
return;
}
var copy = e.target.closest('.hs-copy-btn');
if (copy && copy.id === 'en-install-btn') {
var text = copy.getAttribute('data-copy');
if (!text || !navigator.clipboard) return;
navigator.clipboard.writeText(text).then(function () {
var orig = btn.textContent;
btn.textContent = '✓ Copied';
setTimeout(function () { btn.textContent = orig; }, 1800);
var orig = copy.textContent;
copy.textContent = '✓ Copied';
setTimeout(function () { copy.textContent = orig; }, 1800);
});
});
}
});
})();
</script>
Expand Down
23 changes: 12 additions & 11 deletions docs/zh/community/contributors.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,18 @@

完整提交历史见 [GitHub Contributors](https://github.com/agentscope-ai/agentscope-java/graphs/contributors)。若你希望出现在本表或更新身份信息,欢迎提交 Pull Request 修改 `docs/zh/community/contributors.md`。

| 头像 | GitHub ID | 主页 | 身份说明 |
|:--------------------------------------------------------------------------:|:------------------------------------------------|:-----------------------------------------------------------|:--------------|
| ![Chickenlj](https://github.com/chickenlj.png) | [Chickenlj](https://github.com/chickenlj) | [github.com/chickenlj](https://github.com/chickenlj) | 核心贡献者 |
| ![LearningGp](https://avatars.githubusercontent.com/u/38268859?s=64&v=4) | [LearningGp](https://github.com/LearningGp) | [github.com/LearningGp](https://github.com/LearningGp) | 核心贡献者 |
| ![fang-tech](https://avatars.githubusercontent.com/u/141339556?s=64&v=4) | [fang-tech](https://github.com/fang-tech) | [github.com/fang-tech](https://github.com/fang-tech) | 活跃贡献者 |
| ![guanxuc](https://avatars.githubusercontent.com/u/86234262?s=64&v=4) | [guanxuc](https://github.com/guanxuc) | [github.com/guanxuc](https://github.com/guanxuc) | 活跃贡献者 |
| ![JGoP-L](https://avatars.githubusercontent.com/u/52067013?s=64&v=4) | [JGoP-L](https://github.com/JGoP-L) | [github.com/JGoP-L](https://github.com/JGoP-L) | 活跃贡献者 |
| ![shiyiyue1102](https://avatars.githubusercontent.com/u/20452676?s=64&v=4) | [shiyiyue1102](https://github.com/shiyiyue1102) | [github.com/shiyiyue1102](https://github.com/shiyiyue1102) | 活跃贡献者 |
| ![jujn](https://avatars.githubusercontent.com/u/109072362?s=64&v=4) | [jujn](https://github.com/jujn) | [github.com/jujn](https://github.com/jujn) | 活跃贡献者 |
| ![KomachiSion](https://avatars.githubusercontent.com/u/37170243?s=64&v=4) | [KomachiSion](https://github.com/KomachiSion) | [github.com/KomachiSion](https://github.com/KomachiSion) | 活跃贡献者 |
| 头像 | GitHub ID | 主页 | 身份说明 |
|:---:|:---|:---|:---|
| <img src="https://avatars.githubusercontent.com/u/18097545?s=64&v=4" width="64" height="64"> | [Chickenlj](https://github.com/chickenlj) | [github.com/chickenlj](https://github.com/chickenlj) | 核心贡献者 |
| <img src="https://avatars.githubusercontent.com/u/9292748?s=64&v=4" width="64" height="64"> | [AlbumenJ](https://github.com/AlbumenJ) | [github.com/AlbumenJ](https://github.com/AlbumenJ) | 核心贡献者 |
| <img src="https://avatars.githubusercontent.com/u/38268859?s=64&v=4" width="64" height="64"> | [LearningGp](https://github.com/LearningGp) | [github.com/LearningGp](https://github.com/LearningGp) | 核心贡献者 |
| <img src="https://avatars.githubusercontent.com/u/141339556?s=64&v=4" width="64" height="64"> | [fang-tech](https://github.com/fang-tech) | [github.com/fang-tech](https://github.com/fang-tech) | 活跃贡献者 |
| <img src="https://avatars.githubusercontent.com/u/86234262?s=64&v=4" width="64" height="64"> | [guanxuc](https://github.com/guanxuc) | [github.com/guanxuc](https://github.com/guanxuc) | 活跃贡献者 |
| <img src="https://avatars.githubusercontent.com/u/52067013?s=64&v=4" width="64" height="64"> | [JGoP-L](https://github.com/JGoP-L) | [github.com/JGoP-L](https://github.com/JGoP-L) | 活跃贡献者 |
| <img src="https://avatars.githubusercontent.com/u/20452676?s=64&v=4" width="64" height="64"> | [shiyiyue1102](https://github.com/shiyiyue1102) | [github.com/shiyiyue1102](https://github.com/shiyiyue1102) | 活跃贡献者 |
| <img src="https://avatars.githubusercontent.com/u/109072362?s=64&v=4" width="64" height="64"> | [jujn](https://github.com/jujn) | [github.com/jujn](https://github.com/jujn) | 活跃贡献者 |
| <img src="https://avatars.githubusercontent.com/u/37170243?s=64&v=4" width="64" height="64"> | [KomachiSion](https://github.com/KomachiSion) | [github.com/KomachiSion](https://github.com/KomachiSion) | 活跃贡献者 |

```{note}
上表依据公开仓库贡献度整理,**不代表**通义实验室或阿里巴巴的官方人事与职级认定;「身份说明」为便于读者理解的社区标签,可在 PR 中与维护者协商后调整措辞。
```
```
Loading
Loading