Skip to content
Closed

Fix/bug #1102

Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 2 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,9 @@
# 参与贡献

感谢你关注 Yuxi。欢迎提交 Issue、修复 Bug、补充测试、改进文档或贡献新功能。
感谢你关注 Yuxi。欢迎提交 Bug 修复、补充测试、改进文档或贡献新功能。

## 开始前

- 先搜索 [Issues](https://github.com/xerrors/Yuxi/issues),避免重复工作。
- 较大的功能、公开接口、权限或架构变化,先在 Issue 或 [Discussions](https://github.com/xerrors/Yuxi/discussions) 讨论范围和方案。
- 一个 PR 只解决一个明确问题,不混入无关重构、格式化或顺手优化。
- 修改不熟悉的模块前,先阅读 [ARCHITECTURE.md](ARCHITECTURE.md)。

完整的 Fork、开发、测试、Review 和 PR 说明见[开发贡献指南](docs/develop-guides/contributing.md)。文档改动请同时阅读[文档编写与维护规范](docs/develop-guides/documentation-guidelines.md)。
Expand Down Expand Up @@ -50,5 +47,4 @@ git push -u origin docs/improve-guides

## 问题反馈

- Bug 和功能建议:[GitHub Issues](https://github.com/xerrors/Yuxi/issues)
- 方案讨论:[GitHub Discussions](https://github.com/xerrors/Yuxi/discussions)
请通过仓库维护者公开的反馈渠道提交 Bug 与功能建议,或在团队内部通讯中讨论方案。仓库 `docs/develop-guides/contributing.md` 中维护了最新的反馈与协作入口。
30 changes: 9 additions & 21 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,9 @@

Yuxi is a self-hosted, multi-tenant knowledge agent platform. It brings knowledge base retrieval, knowledge graphs, LangGraph multi-agent orchestration, MCP/Skills, sandbox tools, and access control into one workspace.

[![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat&logo=docker&logoColor=ffffff)](https://github.com/xerrors/Yuxi/blob/main/docker-compose.yml)
[![Release](https://img.shields.io/github/v/release/xerrors/Yuxi?color=046A82)](https://github.com/xerrors/Yuxi/releases/latest)
[![License](https://img.shields.io/github/license/xerrors/Yuxi.svg?logo=github)](https://github.com/xerrors/Yuxi/blob/main/LICENSE)
[![DeepWiki](https://img.shields.io/badge/DeepWiki-blue.svg)](https://deepwiki.com/xerrors/Yuxi)
[![Bilibili](https://img.shields.io/badge/Knowledge_Base_Demo-00A1D6?logo=bilibili&logoColor=fff)](https://www.bilibili.com/video/BV1erE26iEgv/)

<a href="https://trendshift.io/repositories/24335" target="_blank"><img src="https://trendshift.io/api/badge/repositories/24335" alt="xerrors%2FYuxi | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>

[Project home](https://xerrors.github.io/Yuxi/) · [Quick start](https://xerrors.github.io/Yuxi/intro/quick-start) · [Demo video](https://www.bilibili.com/video/BV1erE26iEgv/) · [Releases](https://github.com/xerrors/Yuxi/releases) · [中文](README.md)
[Demo video](https://www.bilibili.com/video/BV1erE26iEgv/) · [中文](README.md)

## What Yuxi Can Do

Expand Down Expand Up @@ -41,7 +35,7 @@ Install [Docker Engine](https://docs.docker.com/get-docker/) and Docker Compose,
### 1. Get the Code and Initialize

```bash
git clone --branch v0.7.3 --depth 1 https://github.com/xerrors/Yuxi.git
git clone --branch v0.7.3 --depth 1 https://example.com/your-fork/Yuxi.git
cd Yuxi

# Linux/macOS
Expand Down Expand Up @@ -72,13 +66,13 @@ When upgrading from v0.7.1 or v0.7.2 to the current version, do not run `docker

## Documentation

- [Project overview](https://xerrors.github.io/Yuxi/intro/project-overview): Capabilities, concepts, and system boundaries.
- [Quick start](https://xerrors.github.io/Yuxi/intro/quick-start): Set up a local environment from scratch.
- [Model configuration](https://xerrors.github.io/Yuxi/intro/model-config): Connect chat, embedding, and rerank models.
- [Knowledge base tutorial](https://xerrors.github.io/Yuxi/intro/knowledge-base): Create knowledge bases and verify retrieval.
- [Agent development](https://xerrors.github.io/Yuxi/agents/agents-config): Configure agents, tools, and extensions.
- [Production deployment](https://xerrors.github.io/Yuxi/advanced/deployment): Deployment, upgrades, backups, and troubleshooting.
- [Changelog](https://xerrors.github.io/Yuxi/develop-guides/changelog): Published changes.
- [Project overview](docs/intro/project-overview.md): Capabilities, concepts, and system boundaries.
- [Quick start](docs/intro/quick-start.md): Set up a local environment from scratch.
- [Model configuration](docs/intro/model-config.md): Connect chat, embedding, and rerank models.
- [Knowledge base tutorial](docs/intro/knowledge-base.md): Create knowledge bases and verify retrieval.
- [Agent development](docs/agents/agents-config.md): Configure agents, tools, and extensions.
- [Production deployment](docs/advanced/deployment.md): Deployment, upgrades, backups, and troubleshooting.
- [Changelog](docs/develop-guides/changelog.md): Published changes.

## Feature Showcase

Expand Down Expand Up @@ -313,10 +307,6 @@ Issues, documentation improvements, bug fixes, and new features are welcome. See

Thanks to all contributors for supporting this project!

<a href="https://github.com/xerrors/Yuxi/contributors">
<img src="https://contrib.rocks/image?repo=xerrors/Yuxi&max=100&columns=10" />
</a>

---

Yuxi's implementation and documentation draw on the following excellent open-source projects:
Expand All @@ -331,5 +321,3 @@ Yuxi's implementation and documentation draw on the following excellent open-sou
## License

Yuxi itself is licensed under the MIT License. See [LICENSE](LICENSE) for details. Third-party components included through Docker Compose retain their own licenses. Before redistribution or commercial deployment, check the upstream licenses and source-code obligations for the actual image versions you use; see the [production deployment guide](docs/advanced/deployment.md) for the relevant boundaries.

[![Give Yuxi a Star](https://xerrors.oss-cn-shanghai.aliyuncs.com/posts/2026/08/20260818-184409-image-da91658b.png)](https://github.com/xerrors/Yuxi)
4 changes: 2 additions & 2 deletions backend/package/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -101,8 +101,8 @@ constraint-dependencies = [
]

[[tool.uv.index]]
name = "tsinghua"
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
name = "aliyun"
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

[tool.uv.sources]
Expand Down
6 changes: 3 additions & 3 deletions backend/package/yuxi/config/static/info.template.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@

# 组织信息
organization:
name: "语析" # 完整组织名称
name: "睿狐" # 完整组织名称
logo: "/favicon.svg" # Logo文件路径(放在 web/public 目录下)
avatar: "/favicon.svg" # 头像文件路径(放在 web/public 目录下)
login_bg: "/login-bg.jpg" # 登录背景图片路径(放在 web/public 目录下)

# 项目信息
branding:
name: "Yuxi"
name: "Smartfox"
title: "让团队知识可连接,让智能体可行动" # 系统标题
subtitle: "知识库 × 知识图谱 × 智能体 Harness,开源且可私有部署" # 副标题(subtitles 为空时使用)
subtitles:
Expand All @@ -21,6 +21,6 @@ branding:

# 页脚信息
footer:
copyright: "© 语析 2026 v{{YUXI_VERSION}}"
copyright: "© 睿狐 2026 v{{YUXI_VERSION}}"
user_agreement_url: "/protocols/user-agreement.template.html"
privacy_policy_url: "/protocols/privacy-policy.template.html"
5 changes: 2 additions & 3 deletions backend/package/yuxi/models/providers/service.py
Original file line number Diff line number Diff line change
Expand Up @@ -332,9 +332,8 @@ def _validate_user_uid_header(provider_type: str, include_user_uid: bool) -> Non
raise ValueError("Gemini 供应商暂不支持请求携带用户 ID")
if not (os.getenv(USER_UID_SIGNATURE_SECRET_ENV) or "").strip():
raise ValueError(
f"开启“请求携带用户 ID”前,需要先在 API/worker 环境变量配置 {USER_UID_SIGNATURE_SECRET_ENV}"
"(专用随机密钥,勿复用 JWT_SECRET_KEY);配置方法详见"
"https://xerrors.github.io/Yuxi/intro/model-config"
f"开启「请求携带用户 ID」前,需要先在 API/worker 环境变量配置 {USER_UID_SIGNATURE_SECRET_ENV}"
"(专用随机密钥,勿复用 JWT_SECRET_KEY);配置方法详见系统配置文档。"
)


Expand Down
4 changes: 2 additions & 2 deletions backend/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -38,8 +38,8 @@ constraint-dependencies = [
]

[[tool.uv.index]]
name = "tsinghua"
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
name = "aliyun"
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

[tool.uv.sources]
Expand Down
Loading