A AWEI STUDIO
简/ 繁/ EN/ 日
特性与文档

产品帮助文档

从 0 认识阿威工作室，再逐个查看每个产品的使用方法。所有内容从这里开始。

本页持续更新，更多章节将逐步补充

工作室简介

从 0 开始，认识阿威工作室

阿威工作室（Awei Studio）于 2023 年创立，是一支专注 AI 原生工具的独立团队。我们相信最好的开发工具应当隐形于工作流之中——轻量、克制、零负担。

我们用四个产品覆盖开发者从编码、训练到操作系统的全流程：Awei Claw（AI 编程 IDE）、Awei Code（便携编码应用）、阿威云试炼（云端训练平台）、Awei OS（AI 原生操作系统）。它们彼此独立，又共享同一套云端同步与专家系统。

本页是它们的统一帮助文档。建议从左边的目录开始：先了解工作室的整体思路，再按需查看每个产品的使用方法。后续的高级用法与常见问题会持续补充到这里。

提示：所有产品均坚持零内购，基础能力免费可用；Awei Code 仅 70MB，解压即用。

Awei Claw Awei Claw AI 编程 IDE

面向专业开发者的智能编程环境

Awei Claw 是一款 AI 编程 IDE，拥有超大上下文窗口与 250+ 内置专家系统，能够理解你的整个代码库，并以专业 Agent 的方式协助完成编码任务。

使用方法

  1. 获取安装包：在下载中心或代码平台获取 Awei Claw，国内用户选 Gitee 版本，国际用户选 GitHub 版本。
  2. 安装并启动：按平台指引完成安装，打开后进入编程工作区。
  3. 选择专家：在专家面板中挑选合适的专家系统（250+），或直接向 Agent 描述你的任务。
  4. 开始协作：借助超大上下文窗口处理大型项目，实时获得代码补全、重构与解释建议。

Awei Claw 如何下载 AweiClaw

三种获取方式，按需选择最适合的一种

Awei Claw 提供三种获取方式，你可以根据自己的需求选择最合适的一种。

方式一：下载 Release 可执行文件（推荐）

适合：普通用户，想快速上手，不想折腾编译环境。

我们为 Windows 用户提供了预编译的 AweiClaw.exe，无需安装，下载后双击即可运行。

下载步骤

  1. 打开 AweiClaw Releases 页面
  2. 找到最新的 Release（建议选择 Latest 标记的版本）
  3. 在 "Assets" 区域，点击 AweiClaw.exe 下载
  4. 下载完成后，双击 AweiClaw.exe 即可启动

注意事项

  • Windows 11 / Windows 10：系统通常已内置 WebView2 运行时，可直接运行。
  • Windows 7 / 8：可能需要安装 WebView2 运行时（微软官方提供，免费）。
  • 首次运行如果 Windows 弹出 "Windows 已保护你的电脑" 提示，点击「更多信息」→「仍要运行」即可（这是因为 EXE 尚未进行代码签名）。
  • 如果程序闪退，请检查是否安装了 .NET 8.0 桌面运行时（下载地址）。

方式二：从源码编译

适合：开发者、希望自行构建或二次开发的用户。

环境要求

工具版本要求说明
.NET SDK8.0+用于编译桌面版启动器
Git任意新版用于克隆仓库
Windows10 / 11目前桌面版仅支持 Windows

步骤

第一步：克隆仓库

git clone https://github.com/fox12387/awei-Claw.git
cd AweiClaw

第二步：编译桌面版

cd aweiclaw-launcher

# 还原依赖（会自动下载 WebView2 等 NuGet 包）
dotnet restore

# 编译项目
dotnet build -c Release

# 发布单文件可执行文件（可选，生成独立的 AweiClaw.exe）
dotnet publish -c Release -r win-x64 --self-contained false -p:PublishSingleFile=true

第三步：运行

编译完成后，可执行文件位于：

bin/Release/net8.0-windows/AweiClaw.exe（build 输出）
或 publish/AweiClaw.exe（publish 输出）

双击运行即可。

方式三：使用 Web 网页版

适合：macOS / Linux 用户、不想下载任何东西、或者想在移动设备上体验。

Web 版无需下载安装，直接通过浏览器访问即可使用全部功能。

在线地址

https://fox12387.github.io/AweiClaw/

本地运行 Web 版

如果你更愿意在本地运行 Web 版：

  1. 克隆仓库或下载源码 ZIP
  2. 直接用浏览器打开 aweiclaw-site/index.html
  3. 开始使用
提示：Web 版依赖网络连接（用于调用 AI API），请确保浏览器可以正常访问互联网。

系统要求总览

项目Windows 桌面版Web 网页版
操作系统Windows 10 / 11任意（有现代浏览器即可）
.NET 运行时8.0（部分场景需要）不需要
WebView2需要（Win10/11 已内置）不需要
网络需要（调用 AI API）需要
磁盘空间~50 MB0（浏览器访问）
内存建议 2 GB+建议 2 GB+

常见问题 (FAQ)

Q：Mac / Linux 能用桌面版吗？
目前桌面版仅支持 Windows。Mac 和 Linux 用户请使用 Web 网页版，功能完全一致。
Q：下载后被杀毒软件拦截怎么办？
AweiClaw 是开源项目，代码完全透明。如果 Windows Defender 或其他杀毒软件报警，这是因为 EXE 未经过数字签名证书认证。你可以放心将其加入白名单运行。
Q：运行桌面版提示缺少 .NET 运行时？
请前往微软官方下载页下载并安装 .NET 8.0 桌面运行时 (Desktop Runtime)，选择 x64 版本。
Q：如何确认自己下载的是最新版本？
在 AweiClaw 应用中，点击左下角齿轮（设置）图标 → 查看页面底部的版本号。与 Releases 页面上的 Latest 版本对比即可。
Q：Web 版和桌面版功能有区别吗？
核心 AI 编程功能完全一致。桌面版的优势在于可离线使用部分功能、独立窗口体验更佳。Web 版则跨平台、无需安装。

Awei Code Awei Code 便携编码

仅 70MB 的便携桌面编码应用

Awei Code 是一款只有 70MB 的便携编码应用，无需安装、解压即用，并通过 mySQL 云端实时同步你的每一行代码，实现多端无缝衔接。

使用方法

  1. 下载：在下载中心选择对应平台的版本（Windows / 安卓 / 终端内测）。
  2. 运行：Windows 版解压后双击即可运行，无需管理员权限；安卓版安装 APK；终端版在命令行调用。
  3. 登录同步：点击右上角"注册 / 登录"创建账号，即可启用 mySQL 云端同步。
  4. 编辑与同步：新建或打开项目，代码变更会自动同步到云端，可在其他设备继续编辑。

阿威云试炼 阿威云试炼 云端训练

弹性算力的云端 AI 训练平台

阿威云试炼是一个云端 AI 训练平台，提供随开随用的弹性算力，让模型训练不再受限于本地设备的性能。

使用方法

  1. 打开项目：在下载中心或产品页进入阿威云试炼项目主页。
  2. 进入控制台：注册 / 登录后，进入云端训练控制台。
  3. 创建任务：新建训练任务，上传或选择你的数据集与基础模型。
  4. 启动训练：开启弹性算力开始训练，实时查看指标、日志与产出。

Awei OS Awei OS 操作系统

AI 原生的操作系统

Awei OS 是一款 AI 原生操作系统，内置全局智能助手，从底层重新定义人机协作，并坚持零内购。

使用方法

  1. 获取版本：在下载中心选择 Awei OS 的 Python 版或 HTML 版。
  2. 启动环境：Python 版按说明运行脚本启动桌面环境；HTML 版直接用浏览器打开。
  3. 使用助手：通过全局智能助手完成文件管理、自动化与日常任务。
  4. 免费使用：所有基础能力免费可用，无需任何内购。

阿威音乐 阿威音乐 音乐播放器

网页版音乐播放器

阿威音乐（Awei Music）是一款单文件网页音乐播放器，打开即用、无需安装，将搜索、播放、歌单、离线缓存与歌词整合在一个轻量页面中。

播放数据来自在线音乐服务，首次搜索需通过图形人机验证以防接口被滥用；缓存后的歌曲可在无网络时继续收听。

使用方法

  1. 打开入口：从官网产品页或下载中心进入「阿威音乐」，或直接用浏览器打开 awms.html。
  2. 搜索音乐：在搜索框输入歌曲名、歌手或专辑，点击搜索按钮；首次使用需完成图形人机验证。
  3. 开始播放：在结果中点击任意歌曲即可播放，底部播放条显示封面、标题与歌手。
  4. 播放控制：用播放条切换 播放 / 暂停、上一首、下一首，并可在 顺序播放 模式间切换。
  5. 进度与音量：拖拽进度条跳转，调节音量；点击倍速按钮可在 0.5× 至 2× 之间切换。
  6. 查看歌词：点击正在播放的歌曲标题，进入全屏歌词页，再次点击关闭。
  7. 歌单管理：在左侧新建歌单，将歌曲「添加到歌单」；歌单可删除、导出为 ZIP，也可从 ZIP 导入。
  8. 离线缓存：在歌曲菜单选择「缓存」，之后在「缓存音乐」页即可无网络收听。
  9. 下载到本地：在歌曲菜单选择「下载到本地」，把音频保存到本机。
  10. 123 云盘导入：在左侧选择「123 云盘导入」，粘贴分享链接与提取码，首次需填写解析 Key（自动保存），即可把云盘歌曲加入歌单。

开发者模式（命令行控制）

按 Ctrl+Shift+D 开启开发者模式，可通过本地音乐代理（默认 http://localhost:7890/musicapi）接收 AI 或脚本指令，支持 run（播放）、sou（搜索 / 换源）、speed（倍速）等命令，便于接入你的自动化流程。

常见问题

搜索没有结果？
请先完成图形人机验证；部分歌曲可能因版权或接口限制无法播放，可尝试换源或重新搜索。

缓存的歌曲在哪里？
缓存保存在浏览器本地存储，无网络时到「缓存音乐」页播放；清除浏览器数据会导致缓存丢失。

开发者模式连不上代理？
确认本地音乐代理已启动并监听 7890 端口，且已在设置中填写代理地址。