参与贡献

September 6, 2026 · View on GitHub

感谢你帮助改进 NekroNXT。当前项目处于早期预览阶段，优先接受能补齐用户流程、修复可靠性问题、改善文档或扩展兼容性的改动。

提交问题前

  • 使用最新预览版或当前 main 复现；
  • 搜索现有 Issue；
  • 删除 API Key、真实聊天、账号、群标识、平台临时 URL、文件哈希和本机路径；
  • 安全漏洞不要创建公开 Issue，按安全策略私密报告。

开发

pnpm install --frozen-lockfile
pnpm dev

遵循 AGENTS.md 的项目边界；已知局部问题直接进入相关源码、测试和契约，未知来源通过文档入口定位相关章节。面向用户只使用“智能体”；内部类型可以保留 AgentDefinition 等 DSH/TypeScript 术语。

修改原则

  • 一个事实只有一个权威文档，行为变化与文档在同一改动中更新；
  • 不复制 DSH 内核，优先使用公开 API、Plugin、Service、Tool、Provider、Settings、Scope、Bundle 和 Preset；
  • 状态只在真实提交点发布，注册可撤销，dispose 等待资源静止；
  • 测试和截图只使用虚构样本；
  • 用户可见操作必须有真实结果，未开放能力明确禁用并标注；
  • 品牌资产只通过 assets/brand/ 母版和导出器修改，角色不作为默认智能体或消息发送者。

验证

按检查阶梯选择与改动相关且足够的验证。局部 Web 改动运行生产构建下受影响的旅程并查看真实画面；共享壳层和全局状态变更扩大覆盖。独立历史问题单独报告，不自动扩展修改范围。

pnpm verify:product 用于完整产品交付复核，CI 保留全量门禁。pnpm test:coverage 不包含在 check 或 test 中，推送前的适用范围和阈值见覆盖率门禁。平台安装资源还需运行 pnpm brand:check 并检查真实安装器画面。

Pull Request

仓库会自动加载 Pull Request 模板；请保留其中的变更、验证和公开边界检查项。

  • 标题和提交说明使用英文类型前缀和中文主题，格式为 type(scope): 中文动词短语；类型使用 feat、fix、refactor、docs、test、merge；
  • 说明用户可观察到的结果、验证命令和文档更新；
  • UI 改动说明实际查看的画面与状态；颜色、表面或对比变化附浅色/深色截图，其他改动附受影响的代表画面；
  • 不混入无关格式化、重命名或生成文件；
  • 外部贡献通过 PR 和 CI，维护者在合并前可能要求拆分范围。

提交代码表示你确认有权按项目采用的 AGPL-3.0-only 许可证贡献该内容。仓库可见性由维护者另行决定。