Keyboard shortcuts

Press or to navigate between chapters

Press ? to show this help

Press Esc to hide this help

通信

在哪里提问、提交错误报告、提议功能,以及如何联系团队。

如果您只是想与我们交流,请使用 Discord。 对于需要持久记录的内容(如 bug、功能请求、设计讨论、RFC),请使用 GitHub。

Discord:联系团队的最佳途径

实时聊天。这是维护者日常交流的地方;获得人工回复的最快途径。

频道:

  • #general:默认房间
  • #help:“我没法让 X 正常工作”类讨论帖;最快的解决问题方式
  • #dev:进行中的开发讨论
  • #releases:公告、发行说明、重大变更预警

仓库 README 中的邀请链接。

Discord 是临时性的:如果对话引出了某个 bug 或功能创意,请随后将其记录为 GitHub issue,以便记录得以留存。Discord 用于交流;GitHub 用于留存记录。

当 Discord 产生项目必须记录的内容时,使用 GitHub 进行交接。当讨论串产生可复现的 bug、具体的功能范围、架构或治理决策、维护者承诺、负责人分配、里程碑决策、阻塞项、临时解决方案、验证证据、发布影响说明或过期豁免原因时,创建或更新 issue、discussion、PR 评论或维护者文档。交接内容只需包含决策、证据、负责人(如有),以及足够的上下文,使另一位维护者无需重读聊天记录即可继续工作。

GitHub 问题

用于跟踪错误、功能请求以及任何需要记录的事项。

  • 错误报告:使用错误报告模板(.github/ISSUE_TEMPLATE/bug_report.yml)。请附上 zeroclaw --version、操作系统信息,以及 zeroclaw doctor 的输出。
  • 功能请求:使用功能模板(.github/ISSUE_TEMPLATE/feature_request.yml)。重点说明用户价值和约束条件;实现细节应放在 RFC 或 PR 讨论中。
  • RFCs:参见 RFC 流程

在提交之前请先搜索。重复的问题会被合并;搜索框是你的好帮手。

GitHub 讨论

对于面向社区的讨论帖,如果它们比 Discord 需要更强的持久性,但又尚未成为已跟踪的工作项,可以使用此功能。Discussions 非常适合用于问答、创意、项目展示、投票、维护者公告,以及那些在 Discord 中容易被刷屏淹没的“还有其他人遇到这个问题吗?“之类的讨论帖。

将讨论(Discussions)视为非紧急的社区交流。仅当有专人负责或记录了审查节奏时,它们才属于维护者处理范围。维护者日常工作和默认节奏请参阅 审查者操作手册:讨论管理

Discussions 是 GitHub 交接系统的一部分,而非 issues、RFC、PR 评论或维护者文档的替代品。一旦某个 Discussion 产生了具体的 bug、功能范围、负责人、阻塞项、验证证据、策略决策或文档需求,就应将其转入受跟踪的处理流程中。

在选择平面时使用此分割:

Surface用于移动时机
Discord快速帮助、实时协调以及早期的“这是个问题吗?“讨论项目需要一份持久记录、决策、负责人、验证说明、阻碍因素或发布影响说明
讨论可搜索的问答、想法、展示分享、演示、投票、公告、广泛反馈,以及尚未准备好正式跟踪的探索性架构问题该讨论串可产生具体的缺陷、功能范围、架构提案、策略决策、文档缺口、负责人、阻塞项或验证证据
问题缺陷、功能请求、支持/配置报告、贡献者任务、路线图跟踪以及其他需要分类或跟踪的工作该议题将转化为 RFC、PR、追踪项、重复项、支持重定向或关闭决定
RFC 问题需要正式评审的架构、治理、生命周期、兼容性或流程决策该 RFC 被接受、拒绝、取代,或拆分为多个实现问题
PR 评论审查活动变更的反馈和实现细节细节会转化为持久的策略、可复用的文档、后续的 issue 或发布说明

讨论分类应当让预期结果一目了然。Q&A 用于可解答的问题,Ideas 用于需要社区共同打磨的提案,Show and tell 用于人们想要分享的项目相关演示、集成或下游分支,Polls 用于社区投票,Announcements 用于维护者更新,General 则用于宽泛的可检索对话、早期架构探索,或尚未纳入工作追踪的下游/分支/企业协作。如果下游协作变得足够频繁,需要专门的管理通道,维护者后续可以添加一个专属分类。

当讨论转移时,请闭环跟进。添加简短的总结,并链接到现在负责该结果的 issue、RFC、PR 或文档。如果该分类支持采纳答案,且能准确反映结果,请将总结或跟踪工作的链接标记为答案。

github.com/zeroclaw-labs/zeroclaw/discussions

维护者联系方式

以下所有人员均为核心团队成员,即 FND-003 §5 中定义的 Tier 3 角色。成员资格来自邀请及公开公告,详见 §5.1;本表为上述决策的已发布摘要,而非确立成员资格的记录。请注意,本表可能与 core-contributors GitHub 团队及协作者列表存在差异——后两者为访问控制机制而非成员资格记录:其中包含自动化账号,且访问权限可能为直接授予、继承或待处理状态。有关各记录所回答问题的说明,请参阅 §5.3

Focus 列描述的是每位成员的工作重点,而非其所持有的权限级别:Core Team 采用扁平化结构。日常决策通过惰性共识机制运行,而 CODEOWNERS 变更、发布、RFC 结果、治理编辑以及 Core Team 成员新增,均需经过 Core Team 的明确投票,与角色无关。“项目负责人“是 Core Team 内部的协调与上报角色,而非凌驾于其上的层级。

处理角色焦点
@JordanTheJet核心团队,项目负责人Web、插件和技能、桌面应用、测试和仓库工具、Cargo 和许可证管理
@Audacity88核心团队运行时、代理、工具、网关、内存、配置、提供商、构建和发布工具
@Nillth核心团队Git 代码托管渠道(GitHub、Gitea、Forgejo)
@tidux核心团队提供商、API、基础设施、硬件、固件、频道(Matrix、ACP)、身份验证以及旧版 src/ 目录树、国际化、文档
@IftekharUddin核心团队Web 图形界面、维护者流程文档、标签和 issue 模板
@vyahhi核心团队仓库自动化和 ZeroClaw-Bot
@Stalesamy核心团队市场营销和社区,以及偶尔的 PR
@perlowja核心团队市场营销和社区,以及偶尔的 PR

并非列出的所有人都会审查代码。请根据 Focus 列和 CODEOWNERS 来分配代码审查,而非根据层级。

关注领域遵循 .github/CODEOWNERS,后者是权威的路由记录。此表是便于人工阅读的摘要;如果两者不一致,以 CODEOWNERS 为准。

谨慎使用 @ 提及,只有当问题确实需要维护者关注时才抄送他们。默认情况下让团队进行分类处理。

安全问题

请勿为安全漏洞提交公开问题。

通过 GitHub 的私密漏洞报告(Security Advisories)私下报告。

包含:

  • 受影响的版本
  • 复现(请提供最小示例)
  • 影响评估

我们的目标是在 48 小时内确认、在 1 周内评估,并在 2 周内针对严重问题发布修复。我们感谢您进行协调披露。

有关完整策略,请参阅仓库根目录下的 SECURITY.md

发布说明

订阅 GitHub 版本更新源,以便在新版本发布时收到通知:

https://github.com/zeroclaw-labs/zeroclaw/releases.atom

或在 GitHub 上关注该仓库(Watch → Custom → Releases)。

发行说明会同步发布到 Discord 的 #releases 频道以及社区 Twitter 账号。

商业支持

未提供。ZeroClaw 由社区维护。如果您需要大规模部署并希望获得 SLA 支持,可以直接赞助维护者,或通过核心团队资助专门的支援方案。请通过 hello@zeroclaw.dev 联系我们。

反馈

开放式反馈,例如“我尝试做 X,但感觉不对“、UX 观察、方向性想法,当需要快速实时交流时,最适合作为 Discord #general#dev 中的话题发布。当反馈需要保持可搜索性以便社区异步参与时,请使用 GitHub Discussions 的 GeneralIdeas。如果讨论逐渐形成具体内容,请将其转移到 issue、RFC、PR 评论或文档中。

贡献者认可

每个有 PR 被合并的人都会出现在仓库的贡献者列表中。对于重大贡献、功能、RFC 以及重要的错误修复,你的用户名会出现在发布说明中。

另见