diff --git a/README.md b/README.md index 9055db162a..76fa055fba 100644 --- a/README.md +++ b/README.md @@ -578,41 +578,58 @@ separates shipped foundations from the next end-to-end acceptance milestones. -## Contributing + + -Help make long-horizon Agent work easier to run, inspect and trust. -Contributions can start with a host integration, a reproducible bug, a -documented workflow or a carefully bounded evidence study. +## Community & Contributing + +Help shape how long-horizon Agent teams work. Share a workflow, reproduce a +bug, build an integration, or show what your Agents accomplished. Code, +documentation, examples, reviews and carefully bounded evidence studies are +all welcome. + +- **Learn:** [Documentation](https://loopx-project.github.io/loopx/docs/) · + [Blog](https://loopx-project.github.io/loopx/blog/) · + [Technical directions](docs/project/technical-directions.md). +- **Discuss and share:** ask questions, compare workflows and share projects in + [GitHub Discussions](https://github.com/loopx-project/loopx/discussions). +- **Report a bug or suggest a feature:** open a + [GitHub Issue](https://github.com/loopx-project/loopx/issues/new/choose) with + your version, host/runtime, expected behavior and a public-safe reproduction. +- **Make your first contribution:** pick a public task from + [Contributor Tasks](docs/development/contributor-tasks.md), or bring a + self-contained fix. The [contribution guide](CONTRIBUTING.md) covers setup, + validation and the PR process; larger changes start with a discussion. +- **Join the conversation:** [Discord](https://discord.gg/XmGgQyCFZd) · + [Lark](docs/assets/loopx-lark-developer-group.png) · + [WeChat](docs/assets/loopx-wechat-contact.png). + +See [Support](.github/SUPPORT.md) for channel routing and official sources, and +our [Code of Conduct](CODE_OF_CONDUCT.md) for community participation. -External contributors should start with -[Contributor Tasks](docs/development/contributor-tasks.md) for public, claimable work and -[Contributing](CONTRIBUTING.md) for setup, validation, and boundary rules. -Project roles and public history are recorded in -[Governance](.github/GOVERNANCE.md), -[Authors and Contributors](docs/project/authors.md), and -[Project History](docs/project/history.md). +
+Before sharing code, logs or examples -LoopX keeps local active state separate from the public repository. Do not -commit `.loopx/`, legacy `.codex/goals/`, live `ACTIVE_GOAL_STATE.md`, raw benchmark -traces, credentials, private logs, or operator artifacts. +Keep `.loopx/`, legacy `.codex/goals/`, live `ACTIVE_GOAL_STATE.md`, raw Agent +sessions and benchmark traces, credentials, private logs, internal links, +sensitive user/team data and operator artifacts out of public contributions. - +
+ +### Contributors -## Community and Feedback +Thank you to everyone contributing code, documentation, bug reports, reviews +and real-world feedback. You help make long-horizon Agent work easier to run, +inspect and trust. -LoopX is already running real long-running agent goals and is under active -development. The most useful feedback comes from real long-running agent -projects: where the control plane helped, where it felt heavy, and which gates -or handoffs disappeared from view. +[![LoopX GitHub contributors](https://contrib.rocks/image?repo=loopx-project/loopx&columns=12&max=120)](https://github.com/loopx-project/loopx/graphs/contributors) -- Use [GitHub Issues](https://github.com/loopx-project/loopx/issues) for - reproducible bugs, install problems, and feature requests. -- Open PRs for docs fixes, showcase writeups, and small public-safe examples. -- Join the [Discord community](https://discord.gg/XmGgQyCFZd), or use Lark or - WeChat below. +[All GitHub contributors](https://github.com/loopx-project/loopx/graphs/contributors) · +[Authors and contribution records](docs/project/authors.md) · +[Governance](.github/GOVERNANCE.md) · [Project history](docs/project/history.md) · +[Name and marks](docs/project/trademarks.md). -See [Support](.github/SUPPORT.md) for channel routing, service boundaries, and -official publication sources. +### Community chats

LoopX Lark developer group QR code diff --git a/README.zh-CN.md b/README.zh-CN.md index a9702162de..ce9ff077f2 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -516,37 +516,54 @@ provider 的打包和生命周期,不是另一个控制面 owner。详见 -## 贡献 + + + +## 社区与贡献 + +一起探索长程 Agent 团队的工作方式。分享你的工作流、复现一个问题、接入新的宿主, +或展示 Agent 做出的成果。代码、文档、示例、评审和边界清楚的证据研究,都欢迎参与。 + +- **了解项目:**[使用文档](https://loopx-project.github.io/loopx/docs/) · + [技术博客](https://loopx-project.github.io/loopx/blog/zh/) · + [技术方向](docs/project/technical-directions.md)。 +- **提问与分享:** 在 [GitHub Discussions](https://github.com/loopx-project/loopx/discussions) + 交流使用问题、比较工作流、展示你的项目。 +- **报告问题或建议功能:** 提交 + [GitHub Issue](https://github.com/loopx-project/loopx/issues/new/choose),说明版本、 + 宿主/运行时、预期行为,并附上可公开的复现步骤。 +- **开始第一次贡献:** 从 [Contributor Tasks](docs/development/contributor-tasks.md) + 选择公开任务,也可以直接提交独立完整的修复。 + [贡献指南](CONTRIBUTING.md)介绍环境搭建、验证与 PR 流程;较大改动请先讨论。 +- **加入交流:**[Discord](https://discord.gg/XmGgQyCFZd) · + [飞书开发群](docs/assets/loopx-lark-developer-group.png) · + [微信](docs/assets/loopx-wechat-contact.png)。 + +渠道分工、支持边界和官方发布源见 [Support](.github/SUPPORT.md), +社区参与约定见[行为准则](CODE_OF_CONDUCT.md)。 -一起让长程 Agent 工作更容易运行、检查和信任。可以从宿主集成、可复现问题、 -工作流文档或边界清楚的证据研究开始。 +

+分享代码、日志或示例之前 -公开、可认领的任务见 [Contributor Tasks](docs/development/contributor-tasks.md)。贡献前请读 -[Contributing](CONTRIBUTING.md),尤其是 public/private 边界、smoke 保留规则和 -benchmark 证据边界。 +不要提交 `.loopx/`、`.codex/goals/`、live `ACTIVE_GOAL_STATE.md`、内部链接、 +原始 Agent 会话、raw benchmark task/log/trajectory/verifier output、credentials、 +token、私有日志、私有路径、操作员产物或未脱敏的用户与团队信息。 -项目角色与维护权限见 [Governance](.github/GOVERNANCE.md),创建者与贡献者归属见 -[Authors and Contributors](docs/project/authors.md),关键公开演进见 -[Project History](docs/project/history.md),名称与标识使用见 -[Name and Marks](docs/project/trademarks.md)。 +
-不要提交 `.loopx/`、`.codex/goals/`、live `ACTIVE_GOAL_STATE.md`、内部链接、 -raw benchmark task/log/trajectory/verifier output、credentials、token、私有路径或 -未脱敏的用户与团队信息。 +### 贡献者 -## 用户群与反馈 +感谢每一位贡献代码、文档、问题报告、评审和真实使用反馈的朋友。 +你们让长程 Agent 工作更容易运行、检查和信任。 -LoopX 已在真实长程 agent 目标上持续运行,并处于活跃迭代期。最需要真实长程 -agent 项目里的反馈:控制面帮到了哪里、哪里太重,哪些 gate、handoff 或 scope -仍然不够清楚。 +[![LoopX GitHub 贡献者](https://contrib.rocks/image?repo=loopx-project/loopx&columns=12&max=120)](https://github.com/loopx-project/loopx/graphs/contributors) -- 可复现 bug、安装问题、功能建议:请提 - [GitHub Issue](https://github.com/loopx-project/loopx/issues)。 -- 文档修正、showcase 补充、小型 public-safe 示例:欢迎开 PR。 -- 参与社区讨论:可加入 [Discord 社区](https://discord.gg/XmGgQyCFZd),也可在 - 下方直接加入飞书群或通过微信申请入群。 +[全部 GitHub 贡献者](https://github.com/loopx-project/loopx/graphs/contributors) · +[创建者与贡献记录](docs/project/authors.md) · +[项目治理](.github/GOVERNANCE.md) · [项目历史](docs/project/history.md) · +[名称与标识](docs/project/trademarks.md)。 -渠道分工、支持边界和官方发布源见 [Support](.github/SUPPORT.md)。 +### 社区群聊

LoopX 飞书开发群二维码