Build and run agents you can see, understand and trust.
Python agentchatbotlarge-language-modelsllmllm-agentmcpmulti-agentmulti-modalreact-agentrealtime-agentvoice-agentvoice-assistant
docs: replace full-width colons with ASCII colons in CONTRIBUTING_zh.md URLs (#2511)
陈志谦2bbf0c325e2e
diff --git a/CONTRIBUTING_zh.md b/CONTRIBUTING_zh.mdindex 1244b60f1..57dfa7ad0 100644--- a/CONTRIBUTING_zh.md+++ b/CONTRIBUTING_zh.md@@ -8,7 +8,7 @@为了支持 AgentScope 开源社区的长期健康发展,我们将公开、透明地维护 AgentScope 的开发计划。-**路线图公开**。AgentScope 的开发计划会发布在 [GitHub Projects 页面](https://github.com/orgs/agentscope-ai/projects/2),并持续更新。路线图会反映 AgentScope 的技术发展方向,由核心开发团队对 AgentScope 的整体设计与质量负责。+**路线图公开**。AgentScope 的开发计划会发布在 [GitHub Projects 页面](https://github.com/orgs/agentscope-ai/projects/2),并持续更新。路线图会反映 AgentScope 的技术发展方向,由核心开发团队对 AgentScope 的整体设计与质量负责。**社区可认领的任务**。Projects 页面 / Issues 中标有 `help wanted` 的条目对所有人开放。如果你有兴趣参与某一项:@@ -47,17 +47,17 @@ AgentScope 欢迎使用 AI 编码助手的贡献者——Claude Code、Cursor、在写代码之前,先找到或创建对应的 issue。-- **基于已有任务**:浏览 [Projects](https://github.com/orgs/agentscope-ai/projects/2) 与 [Issues](https://github.com/agentscope-ai/agentscope/issues) 中标有 `help wanted` 的条目(参见 [§1](#1-开发路线图与参与方式)),在 issue 下评论认领后再开始。+- **基于已有任务**:浏览 [Projects](https://github.com/orgs/agentscope-ai/projects/2) 与 [Issues](https://github.com/agentscope-ai/agentscope/issues) 中标有 `help wanted` 的条目(参见 [§1](#1-开发路线图与参与方式)),在 issue 下评论认领后再开始。- **提出新想法**:新建 issue 描述问题、方案与设计上的取舍。等待核心开发团队反馈后再开始实现,避免事后大规模返工。### 第 2 步:Fork 仓库并创建开发分支-1. 在 GitHub 上 fork [agentscope-ai/agentscope](https://github.com/agentscope-ai/agentscope)。+1. 在 GitHub 上 fork [agentscope-ai/agentscope](https://github.com/agentscope-ai/agentscope)。2. clone 自己的 fork 并添加 upstream 远端:```bash- git clone https://github.com/<your-username>/agentscope.git+ git clone https://github.com/<your-username>/agentscope.gitcd agentscope- git remote add upstream https://github.com/agentscope-ai/agentscope.git+ git remote add upstream https://github.com/agentscope-ai/agentscope.git```3. 基于最新的 `main` 创建主题分支:```bash@@ -118,13 +118,13 @@ pytest tests**改代码的同时请更新文档**。-- AgentScope 文档放在独立仓库:**[agentscope-ai/docs](https://github.com/agentscope-ai/docs)**。如果改动影响用户可见行为——新模块、新公开 API、行为变化、教程——请在该仓库同步开一个配套 PR。+- AgentScope 文档放在独立仓库:**[agentscope-ai/docs](https://github.com/agentscope-ai/docs)**。如果改动影响用户可见行为——新模块、新公开 API、行为变化、教程——请在该仓库同步开一个配套 PR。- 为新公开 API 更新 docstring 与示例片段。- 如果改动影响新手上手或 AgentScope 的对外宣传内容,更新 `README.md`。### 第 6 步:提交与发起 PR-**Commit 信息格式**。我们遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范,便于阅读历史与自动生成 changelog。+**Commit 信息格式**。我们遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范,便于阅读历史与自动生成 changelog。```<type>(<scope>): <subject>@@ -182,7 +182,7 @@ feat(MyFeature): add feature # scope 必须小写- 关联认领的 issue(`Fixes #123` 或 `Refs #123`)- 概述改了什么、为什么改- 标注任何破坏性改动、废弃项或迁移步骤-- 如果同时开了文档 PR,链接到 [agentscope-ai/docs](https://github.com/agentscope-ai/docs) 的对应 PR+- 如果同时开了文档 PR,链接到 [agentscope-ai/docs](https://github.com/agentscope-ai/docs) 的对应 PR## 4. 重要事项@@ -264,13 +264,13 @@ Workspace 提供 agent 运行所需的运行时上下文(skills、scheduled ta2. **Workspace manager 类**——位于 `agentscope/app/_manager/_workspace_manager.py`,继承 `WorkspaceManagerBase`。把 workspace 接入应用生命周期。_参考:同文件中的 `LocalWorkspaceManager`_-3. **文档**——在 [agentscope-ai/docs](https://github.com/agentscope-ai/docs) 配套发起 PR,说明该 workspace 的配置与使用方式。+3. **文档**——在 [agentscope-ai/docs](https://github.com/agentscope-ai/docs) 配套发起 PR,说明该 workspace 的配置与使用方式。### Examples我们非常欢迎新增展示 AgentScope 能力的 example。-主仓库 `examples/` 目录聚焦于**演示具体特性与能力**——简洁、教学性的参考实现。更完整、贴近生产形态的应用,请贡献到 **[agentscope-samples](https://github.com/agentscope-ai/agentscope-samples)**。+主仓库 `examples/` 目录聚焦于**演示具体特性与能力**——简洁、教学性的参考实现。更完整、贴近生产形态的应用,请贡献到 **[agentscope-samples](https://github.com/agentscope-ai/agentscope-samples)**。新 example 放在自己的子目录下:@@ -288,8 +288,8 @@ examples/需要协助或有问题,可以:-- 发起 [Discussion](https://github.com/agentscope-ai/agentscope/discussions)-- 在 [Issues](https://github.com/agentscope-ai/agentscope/issues) 中报告 bug+- 发起 [Discussion](https://github.com/agentscope-ai/agentscope/discussions)+- 在 [Issues](https://github.com/agentscope-ai/agentscope/issues) 中报告 bug- 通过钉钉或 Discord 联系维护者(链接见 README.md)