# Awei AI Harness

**Repository Path**: awei-studio/awei-ai-harness

## Basic Information

- **Project Name**: Awei AI Harness
- **Description**: Awei AI Harness
- **Primary Language**: HTML
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-19
- **Last Updated**: 2026-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Awei AI Harness

> 一句命令拉取到本地 · 让 Agent 替你动手

Awei AI Harness 是阿威工作室开源的 **AI 编程工作台** —— 14+ 内置工具，∞ 模型兼容，工具调度延迟 < 8ms。内置工具包含文件操作、命令执行、搜索、用户提问、插件生成，让 AI Agent 像真人开发者一样在你电脑上干活。

> 预览版 · MIT 协议 · 完全开源

## 一句命令启动

```bash
# 1. 拉取源码（任选）
git clone https://gitee.com/awei-studio/awei-ai-harness.git

# 2. 进入目录
cd awei-ai-harness

# 3. 双击 start.bat 或一句命令
start.bat
```

启动后浏览器自动打开 `http://localhost:3001`，即可进入 AI 工作台。

## 核心能力

| 能力 | 说明 |
|------|------|
| **14+ 内置工具** | 文件读写、代码编辑、命令执行、Shell 等 |
| **∞ 模型兼容** | OpenAI / Claude / DeepSeek / Ollama / 自定义 API |
| **完全开源** | MIT 协议，源码可商用、可改 |
| **< 8ms 工具调度** | 工具调用全程本地转发，超低延迟 |
| **Awei ID** | 与阿威云平台账号互通，token 云端扣费 |
| **插件系统** | .acj / .amd 阿威插件格式，支持 skill / ui / clue 三类 |
| **多语言** | 中英双语界面（i18n 可扩展） |

## 工作目录模式

Awei AI Harness 支持四种工作模式：

- **标准模式**：完整 Agent，可读、改、执行文件
- **极简模式**：只读 + 修改文件，限制工具
- **插件模式**：让 AI 直接生成 `.acj` 阿威插件（保存到工作目录）

## 插件格式（.acj / .amd）

`.acj`（Awei Card & JavaScript）= 插件主清单，含类型标签 `<skill-acj>` / `<ui-acj>` / `<clue-acj>`、元数据、运行逻辑。
`.amd`（Awei Markdown）= 调用说明，告诉 AI 何时使用。

启用插件后，skill/clue 类注入 system prompt，ui 类直接修改页面布局。

## 技术栈

- **前端**：HTML + Tailwind CDN + Vanilla JS（无构建步骤）
- **后端**：纯 Node.js（无依赖，`server.js` 一文件搞定）
- **存储**：localStorage + 可选 PickDuck 云数据库（账号 / token）

## 文档与源码

- **源码仓库**：https://gitee.com/awei-studio/awei-ai-harness
- **问题反馈**：在 Gitee Issues 提单

## License

MIT © AWEI Studio