docs: make Chinese README the default
Checks (magui2.0) / python-format (push) Has been cancelled
Checks (magui2.0) / python-lint (push) Has been cancelled
Checks (magui2.0) / python-pyright (push) Has been cancelled
Checks (magui2.0) / python-test (push) Has been cancelled
Checks (magui2.0) / frontend-format (push) Has been cancelled
Checks (magui2.0) / frontend-lint (push) Has been cancelled
Checks (magui2.0) / frontend-typecheck (push) Has been cancelled
Checks (magui2.0) / frontend-test (push) Has been cancelled
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (javascript-typescript) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
Checks (magui2.0) / python-format (push) Has been cancelled
Checks (magui2.0) / python-lint (push) Has been cancelled
Checks (magui2.0) / python-pyright (push) Has been cancelled
Checks (magui2.0) / python-test (push) Has been cancelled
Checks (magui2.0) / frontend-format (push) Has been cancelled
Checks (magui2.0) / frontend-lint (push) Has been cancelled
Checks (magui2.0) / frontend-typecheck (push) Has been cancelled
Checks (magui2.0) / frontend-test (push) Has been cancelled
CodeQL Advanced / Analyze (actions) (push) Has been cancelled
CodeQL Advanced / Analyze (javascript-typescript) (push) Has been cancelled
CodeQL Advanced / Analyze (python) (push) Has been cancelled
This commit is contained in:
@@ -1,3 +1,9 @@
|
||||
<!-- WEHUB_ZH_README -->
|
||||
> [!NOTE]
|
||||
> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
|
||||
> [English](./README.en.md) · [原始项目](https://github.com/microsoft/magentic-ui) · [上游 README](https://github.com/microsoft/magentic-ui/blob/HEAD/README.md)
|
||||
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
|
||||
|
||||
<p align="center">
|
||||
<picture>
|
||||
<source media="(prefers-color-scheme: dark)" srcset="docs/_assets/magentic-lite-logo-dark.png">
|
||||
@@ -6,55 +12,55 @@
|
||||
</p>
|
||||
|
||||
<p align="center">
|
||||
<em>Big tasks. Small models.</em>
|
||||
<em>大任务。小模型。</em>
|
||||
</p>
|
||||
|
||||
---
|
||||
|
||||
**MagenticLite** is the next generation of Magentic-UI — an agentic application from **Microsoft AI Frontiers**, redesigned to do more with less. It pairs an on-device-friendly orchestrator model ([MagenticBrain](https://aka.ms/MagenticBrain-foundry)) with a specialized browser-use model ([Fara](https://aka.ms/fara-foundry)) so you can automate real work without depending on frontier-scale compute.
|
||||
**MagenticLite** 是 Magentic-UI 的下一代版本——一款来自 **Microsoft AI Frontiers** 的智能体(agentic)应用,经过重新设计,以更少的资源完成更多工作。它将适合本地运行的编排模型([MagenticBrain](https://aka.ms/MagenticBrain-foundry)) with a specialized browser-use model ([Fara](https://aka.ms/fara-foundry)) so you can automate real work without depending on frontier-scale compute.
|
||||
|
||||
- **Built for small models, efficient by design.** Strong agentic performance without heavy compute — no frontier-scale models required.
|
||||
- **Works across the browser and your local file system.** Web research, form filling, file management — in one workflow.
|
||||
- **Keeps you in the loop and in control.** Steer, approve, or take over at any point. MagenticLite stops and checks in before taking critical actions.
|
||||
- **Safe by design.** Browser sessions run inside a lightweight VM sandbox ([Quicksand](https://microsoft.github.io/quicksand/)) so the agent can't reach the rest of your machine without your say-so.
|
||||
- **专为小模型打造,设计上高效。** 无需沉重算力即可获得强大的智能体性能——不必依赖前沿级大模型。
|
||||
- **横跨浏览器与本地文件系统。** 网络调研、表单填写、文件管理——同一工作流内一气呵成。
|
||||
- **让你始终参与并掌控全局。** 随时引导、审批或接管。MagenticLite 在执行关键操作前会暂停并征求确认。
|
||||
- **安全优先的设计。** 浏览器会话在轻量级 VM 沙箱([Quicksand](https://microsoft.github.io/quicksand/)) so the agent can't reach the rest of your machine without your say-so.
|
||||
|
||||
## See it in action
|
||||
## 亲眼见证
|
||||
|
||||
Click any task below to expand and watch MagenticLite handle it end to end.
|
||||
点击以下任意任务即可展开,观看 MagenticLite 端到端完成全过程。
|
||||
|
||||
<details open>
|
||||
<summary><b>Fill expense forms</b></summary>
|
||||
<summary><b>填写报销表单</b></summary>
|
||||
|
||||
https://github.com/user-attachments/assets/a982b60d-127e-4310-96e6-9f094dffb7f0
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Find prices for recipe ingredients</b></summary>
|
||||
<summary><b>查找食谱食材价格</b></summary>
|
||||
|
||||
https://github.com/user-attachments/assets/7ff87917-752f-4e40-b319-8036e08ab8f9
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Find and book a restaurant</b></summary>
|
||||
<summary><b>查找并预订餐厅</b></summary>
|
||||
|
||||
https://github.com/user-attachments/assets/ee5f967e-ee1b-4554-b329-36b56b595aa4
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary><b>Organize local files</b></summary>
|
||||
<summary><b>整理本地文件</b></summary>
|
||||
|
||||
https://github.com/user-attachments/assets/aff385dd-f856-4db4-8f26-08fd0f940aa4
|
||||
|
||||
</details>
|
||||
|
||||
## Quick start
|
||||
## 快速开始
|
||||
|
||||
These steps get you running on macOS or Windows (WSL). Need more detail or a different platform? See the [Installation Guide](./docs/installation.md).
|
||||
以下步骤可在 macOS 或 Windows(WSL)上运行。需要更多细节或其他平台?请参阅[安装指南](./docs/installation.md)。
|
||||
|
||||
### 1. Install MagenticLite
|
||||
### 1. 安装 MagenticLite
|
||||
|
||||
```bash
|
||||
# Create a project directory
|
||||
@@ -68,36 +74,36 @@ source .venv/bin/activate
|
||||
uv pip install "magentic_ui>=0.2.0"
|
||||
```
|
||||
|
||||
### 2. Run
|
||||
### 2. 运行
|
||||
|
||||
```bash
|
||||
magentic-ui --port 8081
|
||||
```
|
||||
|
||||
Open <http://127.0.0.1:8081/> and follow the in-app onboarding to connect a model endpoint. If you don't have one yet, see the [Model Hosting Guide](./docs/model-hosting-guide.md).
|
||||
打开 <http://127.0.0.1:8081/> 并按照应用内引导连接模型端点。若你尚无可用端点,请参阅[模型托管指南](./docs/model-hosting-guide.md)。
|
||||
|
||||
> **Looking for the previous Magentic-UI 0.1 release** (optimized to run with frontier models)? It lives on the [`magentic-ui-0.1`](https://github.com/microsoft/magentic-ui/tree/magentic-ui-0.1) branch.
|
||||
> **在找此前的 Magentic-UI 0.1 版本**(针对前沿模型优化)?它位于 [`magentic-ui-0.1`](https://github.com/microsoft/magentic-ui/tree/magentic-ui-0.1) branch。
|
||||
|
||||
## Documentation
|
||||
## 文档
|
||||
|
||||
| Doc | What's in it |
|
||||
| 文档 | 内容 |
|
||||
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------- |
|
||||
| [Installation](./docs/installation.md) | Supported platforms, macOS / WSL prerequisites, install + run commands |
|
||||
| [Build from source](./docs/build-from-source.md) | How to run MagenticLite from a clone of this repo (`uv sync`, `pnpm dev`, etc.) |
|
||||
| [Model hosting guide](./docs/model-hosting-guide.md) | End-to-end walkthrough of standing up a model endpoint and connecting MagenticLite to it |
|
||||
| [Configuration](./docs/configuration.md) | Sandbox, agent mode, tool approval, full `config.yaml` example |
|
||||
| [Troubleshooting](./docs/troubleshooting.md) | Common errors and how to fix them |
|
||||
| [Limitations](./docs/limitations.md) | Tasks and usage patterns MagenticLite doesn't handle well today |
|
||||
| [Transparency Note](./docs/TRANSPARENCY_NOTE.md) | Intended uses, responsible-use guidance, risks, and mitigations |
|
||||
| [安装](./docs/installation.md) | 支持的平台、macOS / WSL 前置条件、安装与运行命令 |
|
||||
| [从源码构建](./docs/build-from-source.md) | 如何从本仓库克隆运行 MagenticLite(`uv sync`、`pnpm dev` 等) |
|
||||
| [模型托管指南](./docs/model-hosting-guide.md) | 搭建模型端点并将 MagenticLite 与之连接的端到端指南 |
|
||||
| [配置](./docs/configuration.md) | 沙箱、智能体模式、工具审批,以及完整的 `config.yaml` 示例 |
|
||||
| [故障排除](./docs/troubleshooting.md) | 常见错误及修复方法 |
|
||||
| [限制](./docs/limitations.md) | MagenticLite 目前尚难胜任的任务与使用模式 |
|
||||
| [透明度说明](./docs/TRANSPARENCY_NOTE.md) | 预期用途、负责任使用指引、风险及缓解措施 |
|
||||
|
||||
## License
|
||||
## 许可证
|
||||
|
||||
Microsoft, and any contributors, grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT). See the [LICENSE](LICENSE) file.
|
||||
Microsoft 及其任何贡献者,根据 [MIT License](https://opensource.org/licenses/MIT). See the [LICENSE](LICENSE) file.
|
||||
|
||||
Microsoft, Windows, Microsoft Azure, and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at <http://go.microsoft.com/fwlink/?LinkID=254653>.
|
||||
Microsoft、Windows、Microsoft Azure 及/或文档中提及的其他 Microsoft 产品与服务,可能是 Microsoft 在美国及/或其他国家/地区的商标或注册商标。本项目的许可并不授予你使用任何 Microsoft 名称、标识或商标的权利。Microsoft 的一般商标使用准则见 <http://go.microsoft.com/fwlink/?LinkID=254653>。
|
||||
|
||||
Any use of third-party trademarks or logos are subject to those third-party's policies.
|
||||
任何第三方商标或标识的使用均须遵守相应第三方的政策。
|
||||
|
||||
Privacy information can be found at <https://go.microsoft.com/fwlink/?LinkId=521839>.
|
||||
隐私信息见 <https://go.microsoft.com/fwlink/?LinkId=521839>。
|
||||
|
||||
Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel, or otherwise.
|
||||
Microsoft 及任何贡献者保留所有其他权利,无论基于其各自的版权、专利或商标,无论通过默示、禁止反言或其他方式。
|
||||
|
||||
Reference in New Issue
Block a user