人工智能AI 应用可观测性链路追踪数据可视化AI 评测前端后端【免费下载链接】agentscope-studioA development-oriented visualization toolkit项目地址https://gitcode.com/gh_mirrors/ag/agentscope-studio点击查看免费下载AgentScope Studio 是一个面向 AgentScope 智能体开发的本地可视化开发工具提供项目管理、运行实时可视化、基于 OpenTelemetry 的追踪和内置 CopilotFriday等能力。想为它做开源贡献这份指南将带你从认领 Issue、一键搭建本地开发环境到遵循Conventional Commits提交规范与项目代码风格完整走通从新手到贡献者的每一步。为什么值得为 AgentScope Studio 贡献AgentScope Studio 于 2025 年 8 月正式开源Apache-2.0 许可证正处于快速演进阶段社区非常欢迎任何形态的贡献修 bug、加功能、补文档、优化体验。项目采用 TypeScript React 前端、Node.js Express 后端、SQLite 数据库的轻量架构上手门槛低、模块边界清晰非常适合新手切入。官方贡献指南contributing.md明确写道无论是修复 bug、添加新功能、改进文档还是分享想法你的贡献都能让 AgentScope Studio 变得更好。贡献前必做先认领 Issue 再动手社区协作的核心是避免重复劳动。在写第一行代码之前请先确认任务来源优先认领已有 Issue查看项目 Roadmap 中带roadmap标签的开放 Issues若某条 Issue 尚未被分配请在该 Issue 下评论留言表达认领意愿便于维护者协调排期。没有合适 Issue那就新建一个描述你建议的功能或修复方案维护者会及时回复、给出反馈与方向帮助你把想法落成可执行的任务。小贴士重大改动请务必先开 Issue 讨论再提交 PR。突然冒出的大型 PR 是贡献清单里最典型的反面案例。一键搭建本地开发环境3 步跑起来本地跑通项目是你提交第一个 PR 的前提。整个流程只需 3 步。第 1 步准备前置依赖依赖版本要求说明Node.js≥ 20.0.0使用 nvm 时可nvm use切换npm≥ 10.0.0包管理器Docker可选用于容器化部署调试版本检查node --version # 应显示 v20.x.x 或更高 npm --version # 应显示 10.x.x 或更高第 2 步克隆仓库并安装依赖git clone https://gitcode.com/gh_mirrors/ag/agentscope-studio cd agentscope-studio npm install第 3 步以开发模式启动npm run dev该命令会并行拉起前端与后端对应 package.json 中的dev:client与dev:server默认监听3000端口、OTel gRPC 端口4317配置项见 server.ts。浏览器访问http://localhost:3000即可看到界面需要容器化调试时可参考 docker/README.md 中提供的docker-compose方案。熟悉仓库结构packages 目录快速地图AgentScope Studio 是一个npm workspaces 单体仓库核心代码全部位于packages/下理解这张地图能帮你快速定位要改哪个文件。目录职责技术栈packages/client/前端 UIReact TypeScript Vite TailwindCSSpackages/server/后端服务API、数据库、追踪接收器Node.js Express tRPC TypeORM SQLitepackages/shared/前后端共享的常量、类型、工具函数TypeScriptpackages/app/friday/内置 Copilot「Friday」的 Python 智能体实现Pythondocs/基于 VitePress 的教程文档中/英双版本Markdown关键子目录速查更完整说明见 contributing.md前端components/ 负责 UI、context/ 负责状态管理与数据获取、pages/ 负责路由页面。后端dao/ 是数据库访问层、models/ 是 ORM 模型、trpc/ 是 tRPC 路由、otel/ 是 OpenTelemetry gRPC 接收器。共享层config/ 定义前后端共用的端口、常量与默认配置。经验法则想改 UI → 找client/src/pagesclient/src/components想加接口 → 找server/src/trpc想改数据库 → 找server/src/daoserver/src/modelsserver/src/migrations。前端与后端贡献规范写代码前必读1. 提交前必跑格式化命令项目使用Prettier ESLint统一代码风格提交前必须执行npm run format该命令会自动格式化所有 TS/JS/TSX 文件并修复 ESLint 报告的问题脚本定义见 package.json。跳过这一步的 PR 大概率会被打回。2. 前端架构原则关注点分离前端React/TypeScript贡献时必须遵守两条硬性原则状态管理与 UI 组件分离数据获取和状态逻辑放到 context/ 中的 Context ProviderUI 组件只负责渲染与交互。例如 ProjectRoomContext.tsx 就是典型的状态 Provider。样式一律使用 Tailwind CSS 工具类避免内联style和组件级单独 CSS 文件。3. 后端与数据库新增字段或表结构变更时记得同步更新 models/ 并在 migrations/ 下新增迁移脚本保证 SQLite 数据库database.ts平滑升级。Conventional Commits 提交规范速查表项目严格遵循 Conventional Commits 规范提交信息格式为type(scope): subject。规范化的提交历史能让 CHANGELOG 自动生成更整洁。Type用途示例feat新增功能feat(trpc): add run export endpointfix修复 bugfix(tracing): resolve token count overflowdocs仅文档变更docs(readme): update installation stepsstyle不影响逻辑的样式/格式调整style(client): prettier reformatrefactor既不加功能也不修 bug 的重构refactor(context): extract socket helperperf性能优化perf(trace): batch span writestest补充或修复测试test(dao): add Reply DAO unit testschore构建、CI 与辅助工具变更chore(ci): bump node to 20scope建议填写受影响的模块名例如trpc、tracing、client、server、friday、docs。该做 vs 不该做贡献清单✅ 该做❌ 不该做从小任务切入逐步熟悉代码库突然提交大型、无预沟通的 PR重大改动先在 Issue 讨论忽略 CI 失败为改动补充测试一个 PR 混杂多种关注点为复杂逻辑补充文档破坏现有 API 兼容性使用规范的 Conventional Commit 信息引入不必要的第三方依赖对社区保持尊重不懂就问绕过 Issue 直接提交卡住了快速求助渠道 想聊设计思路开一条Discussion或直接在对应 Issue 下评论。 发现 bug按模板新建Issue附上复现步骤与日志。 文档类问题可查阅 docs/tutorial/zh_CN/tutorial/overview.md 与 Friday 文档 了解项目全貌。结语从认领一条good first issue、跑通本地npm run dev、到以feat:/fix:规范提交第一条 commit——你的第一步就是 AgentScope Studio 社区欢迎你加入的开始。保持小步快跑、先沟通后动手你会发现自己很快就能在这个可视化开发工具的核心代码里留下名字。赞分享人工智能AI 应用可观测性链路追踪数据可视化AI 评测前端后端【免费下载链接】agentscope-studioA development-oriented visualization toolkit项目地址https://gitcode.com/gh_mirrors/ag/agentscope-studio点击查看免费下载相关推荐AgentScope 开源贡献指南从 issue 认领、Conventional Commits 到 Chat Model 模块扩展的完整实操手册AgentScope 开源贡献指南从 issue 认领、Conventional Commits 到 Chat Model 模块扩展的完整实操手册 Agent人工智能大模型AI Agent多智能体Agent 框架工具调用RAGMCP ClientsAgentScope 贡献指南从认领 Issue 到合入 Chat Model 的完整开发流程AgentScope 贡献指南从认领 Issue 到合入 Chat Model 的完整开发流程 AgentScope 是一个面向多智能体Multi Agen人工智能大模型AI Agent多智能体Agent 框架工具调用RAGMCP Clients如何成为OBS Studio贡献者从Issue到PR的完整指南如何成为OBS Studio贡献者从Issue到PR的完整指南 OBS Studio是一款广受欢迎的开源直播和录屏软件为全球数百万创作者提供强大的音视频处理音视频直播屏幕录制视频处理桌面应用上一篇初识MioTTS-1.7B轻量快速LLM文本转语音开源模型的完整概览下一篇Llama-3.2-1B-Instruct-FP8-Dynamic 128K 超长上下文实战1B 小模型如何消化十万字长文本创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/11/5 6:44:18 · 阅读 1.2k 如何参与 AgentScope Studio 开源贡献？从 Issue 认领到 Conventional Commits 的开发者完整指南
人工智能AI 应用可观测性链路追踪数据可视化AI 评测前端后端【免费下载链接】agentscope-studioA development-oriented visualization toolkit项目地址https://gitcode.com/gh_mirrors/ag/agentscope-studio点击查看免费下载AgentScope Studio 是一个面向 AgentScope 智能体开发的本地可视化开发工具提供项目管理、运行实时可视化、基于 OpenTelemetry 的追踪和内置 CopilotFriday等能力。想为它做开源贡献这份指南将带你从认领 Issue、一键搭建本地开发环境到遵循Conventional Commits提交规范与项目代码风格完整走通从新手到贡献者的每一步。为什么值得为 AgentScope Studio 贡献AgentScope Studio 于 2025 年 8 月正式开源Apache-2.0 许可证正处于快速演进阶段社区非常欢迎任何形态的贡献修 bug、加功能、补文档、优化体验。项目采用 TypeScript React 前端、Node.js Express 后端、SQLite 数据库的轻量架构上手门槛低、模块边界清晰非常适合新手切入。官方贡献指南contributing.md明确写道无论是修复 bug、添加新功能、改进文档还是分享想法你的贡献都能让 AgentScope Studio 变得更好。贡献前必做先认领 Issue 再动手社区协作的核心是避免重复劳动。在写第一行代码之前请先确认任务来源优先认领已有 Issue查看项目 Roadmap 中带roadmap标签的开放 Issues若某条 Issue 尚未被分配请在该 Issue 下评论留言表达认领意愿便于维护者协调排期。没有合适 Issue那就新建一个描述你建议的功能或修复方案维护者会及时回复、给出反馈与方向帮助你把想法落成可执行的任务。小贴士重大改动请务必先开 Issue 讨论再提交 PR。突然冒出的大型 PR 是贡献清单里最典型的反面案例。一键搭建本地开发环境3 步跑起来本地跑通项目是你提交第一个 PR 的前提。整个流程只需 3 步。第 1 步准备前置依赖依赖版本要求说明Node.js≥ 20.0.0使用 nvm 时可nvm use切换npm≥ 10.0.0包管理器Docker可选用于容器化部署调试版本检查node --version # 应显示 v20.x.x 或更高 npm --version # 应显示 10.x.x 或更高第 2 步克隆仓库并安装依赖git clone https://gitcode.com/gh_mirrors/ag/agentscope-studio cd agentscope-studio npm install第 3 步以开发模式启动npm run dev该命令会并行拉起前端与后端对应 package.json 中的dev:client与dev:server默认监听3000端口、OTel gRPC 端口4317配置项见 server.ts。浏览器访问http://localhost:3000即可看到界面需要容器化调试时可参考 docker/README.md 中提供的docker-compose方案。熟悉仓库结构packages 目录快速地图AgentScope Studio 是一个npm workspaces 单体仓库核心代码全部位于packages/下理解这张地图能帮你快速定位要改哪个文件。目录职责技术栈packages/client/前端 UIReact TypeScript Vite TailwindCSSpackages/server/后端服务API、数据库、追踪接收器Node.js Express tRPC TypeORM SQLitepackages/shared/前后端共享的常量、类型、工具函数TypeScriptpackages/app/friday/内置 Copilot「Friday」的 Python 智能体实现Pythondocs/基于 VitePress 的教程文档中/英双版本Markdown关键子目录速查更完整说明见 contributing.md前端components/ 负责 UI、context/ 负责状态管理与数据获取、pages/ 负责路由页面。后端dao/ 是数据库访问层、models/ 是 ORM 模型、trpc/ 是 tRPC 路由、otel/ 是 OpenTelemetry gRPC 接收器。共享层config/ 定义前后端共用的端口、常量与默认配置。经验法则想改 UI → 找client/src/pagesclient/src/components想加接口 → 找server/src/trpc想改数据库 → 找server/src/daoserver/src/modelsserver/src/migrations。前端与后端贡献规范写代码前必读1. 提交前必跑格式化命令项目使用Prettier ESLint统一代码风格提交前必须执行npm run format该命令会自动格式化所有 TS/JS/TSX 文件并修复 ESLint 报告的问题脚本定义见 package.json。跳过这一步的 PR 大概率会被打回。2. 前端架构原则关注点分离前端React/TypeScript贡献时必须遵守两条硬性原则状态管理与 UI 组件分离数据获取和状态逻辑放到 context/ 中的 Context ProviderUI 组件只负责渲染与交互。例如 ProjectRoomContext.tsx 就是典型的状态 Provider。样式一律使用 Tailwind CSS 工具类避免内联style和组件级单独 CSS 文件。3. 后端与数据库新增字段或表结构变更时记得同步更新 models/ 并在 migrations/ 下新增迁移脚本保证 SQLite 数据库database.ts平滑升级。Conventional Commits 提交规范速查表项目严格遵循 Conventional Commits 规范提交信息格式为type(scope): subject。规范化的提交历史能让 CHANGELOG 自动生成更整洁。Type用途示例feat新增功能feat(trpc): add run export endpointfix修复 bugfix(tracing): resolve token count overflowdocs仅文档变更docs(readme): update installation stepsstyle不影响逻辑的样式/格式调整style(client): prettier reformatrefactor既不加功能也不修 bug 的重构refactor(context): extract socket helperperf性能优化perf(trace): batch span writestest补充或修复测试test(dao): add Reply DAO unit testschore构建、CI 与辅助工具变更chore(ci): bump node to 20scope建议填写受影响的模块名例如trpc、tracing、client、server、friday、docs。该做 vs 不该做贡献清单✅ 该做❌ 不该做从小任务切入逐步熟悉代码库突然提交大型、无预沟通的 PR重大改动先在 Issue 讨论忽略 CI 失败为改动补充测试一个 PR 混杂多种关注点为复杂逻辑补充文档破坏现有 API 兼容性使用规范的 Conventional Commit 信息引入不必要的第三方依赖对社区保持尊重不懂就问绕过 Issue 直接提交卡住了快速求助渠道 想聊设计思路开一条Discussion或直接在对应 Issue 下评论。 发现 bug按模板新建Issue附上复现步骤与日志。 文档类问题可查阅 docs/tutorial/zh_CN/tutorial/overview.md 与 Friday 文档 了解项目全貌。结语从认领一条good first issue、跑通本地npm run dev、到以feat:/fix:规范提交第一条 commit——你的第一步就是 AgentScope Studio 社区欢迎你加入的开始。保持小步快跑、先沟通后动手你会发现自己很快就能在这个可视化开发工具的核心代码里留下名字。赞分享人工智能AI 应用可观测性链路追踪数据可视化AI 评测前端后端【免费下载链接】agentscope-studioA development-oriented visualization toolkit项目地址https://gitcode.com/gh_mirrors/ag/agentscope-studio点击查看免费下载相关推荐AgentScope 开源贡献指南从 issue 认领、Conventional Commits 到 Chat Model 模块扩展的完整实操手册AgentScope 开源贡献指南从 issue 认领、Conventional Commits 到 Chat Model 模块扩展的完整实操手册 Agent人工智能大模型AI Agent多智能体Agent 框架工具调用RAGMCP ClientsAgentScope 贡献指南从认领 Issue 到合入 Chat Model 的完整开发流程AgentScope 贡献指南从认领 Issue 到合入 Chat Model 的完整开发流程 AgentScope 是一个面向多智能体Multi Agen人工智能大模型AI Agent多智能体Agent 框架工具调用RAGMCP Clients如何成为OBS Studio贡献者从Issue到PR的完整指南如何成为OBS Studio贡献者从Issue到PR的完整指南 OBS Studio是一款广受欢迎的开源直播和录屏软件为全球数百万创作者提供强大的音视频处理音视频直播屏幕录制视频处理桌面应用上一篇初识MioTTS-1.7B轻量快速LLM文本转语音开源模型的完整概览下一篇Llama-3.2-1B-Instruct-FP8-Dynamic 128K 超长上下文实战1B 小模型如何消化十万字长文本创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考