Spaces:
Runtime error
Runtime error
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,12 +1,71 @@
|
|
| 1 |
-
--
|
| 2 |
-
|
| 3 |
-
|
| 4 |
-
|
| 5 |
-
|
| 6 |
-
|
| 7 |
-
|
| 8 |
-
|
| 9 |
-
|
| 10 |
-
|
| 11 |
-
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
diff --git a/README.md b/README.md
|
| 2 |
+
index 78b3df7d801c0fb4c65a1fec41df0fbc82abc27e..a1eca3cfb0b7c12367a26a984a774d0735c89ce7 100644
|
| 3 |
+
--- a/README.md
|
| 4 |
+
+++ b/README.md
|
| 5 |
+
@@ -1,2 +1,64 @@
|
| 6 |
+
-# my-ai-coder
|
| 7 |
+
-ai
|
| 8 |
+
+# My Omni AI Studio
|
| 9 |
+
+
|
| 10 |
+
+一个前端单页 AI 工作台，支持：
|
| 11 |
+
+
|
| 12 |
+
+- AI 聊天
|
| 13 |
+
+- AI 代码生成
|
| 14 |
+
+- AI 写作
|
| 15 |
+
+- AI 视频任务提交
|
| 16 |
+
+- AI 换脸任务提交（示例）
|
| 17 |
+
+
|
| 18 |
+
+## 快速开始
|
| 19 |
+
+
|
| 20 |
+
+1. 打开 `index.html`（可用 VSCode Live Server 或任意静态服务器）。
|
| 21 |
+
+2. 在页面配置你的 Hugging Face Token。
|
| 22 |
+
+3. 按需替换模型 ID（支持 Hugging Face 上任意可访问模型）。
|
| 23 |
+
+4. 在不同标签页输入提示词并调用。
|
| 24 |
+
+
|
| 25 |
+
+## 直接一键传到 Hugging Face（Space）
|
| 26 |
+
+
|
| 27 |
+
+> 你要的“直接一键上传”已支持：执行下面一条命令即可创建/更新你的 Space。
|
| 28 |
+
+
|
| 29 |
+
+```bash
|
| 30 |
+
+HF_TOKEN=你的hf_token python scripts/deploy_to_hf_space.py --space 你的space名字 --sdk static
|
| 31 |
+
+```
|
| 32 |
+
+
|
| 33 |
+
+发布完成后会输出你的 Space 地址：
|
| 34 |
+
+
|
| 35 |
+
+```text
|
| 36 |
+
+https://huggingface.co/spaces/<你的用户名>/<你的space名字>
|
| 37 |
+
+```
|
| 38 |
+
+
|
| 39 |
+
+### 脚本能力（升级版）
|
| 40 |
+
+
|
| 41 |
+
+- 支持 `HF_TOKEN` 或 `HUGGING_FACE_HUB_TOKEN`
|
| 42 |
+
+- 支持 `--private` 创建私有 Space
|
| 43 |
+
+- 支持 `--sdk static|gradio|docker`
|
| 44 |
+
+- 支持 `--branch` 指定推送分支
|
| 45 |
+
+- 支持 `--message` 自定义部署提交信息
|
| 46 |
+
+- 支持多次 `--include` 附带额外文件
|
| 47 |
+
+- 默认 `--force` 覆盖发布，可用 `--no-force` 关闭
|
| 48 |
+
+
|
| 49 |
+
+示例：
|
| 50 |
+
+
|
| 51 |
+
+```bash
|
| 52 |
+
+HF_TOKEN=你的hf_token python scripts/deploy_to_hf_space.py \
|
| 53 |
+
+ --space my-omni-ai-studio \
|
| 54 |
+
+ --sdk static \
|
| 55 |
+
+ --private \
|
| 56 |
+
+ --include assets/logo.png
|
| 57 |
+
+```
|
| 58 |
+
+
|
| 59 |
+
+## 说明
|
| 60 |
+
+
|
| 61 |
+
+- Token 只保存在本地浏览器 `localStorage`。
|
| 62 |
+
+- 视频与换脸模型通常是异步工作流，示例中会显示原始响应，你可以继续扩展为轮询任务状态 + 结果展示。
|
| 63 |
+
+- 部署脚本会自动调用 Hugging Face Hub API 创建 Space（`type=space`），然后通过 git push 发布文件。
|
| 64 |
+
+
|
| 65 |
+
+## 测试
|
| 66 |
+
+
|
| 67 |
+
+```bash
|
| 68 |
+
+node --check app.js
|
| 69 |
+
+python -m py_compile scripts/deploy_to_hf_space.py
|
| 70 |
+
+python -m unittest tests/test_deploy_to_hf_space.py
|
| 71 |
+
+```
|