Skip to content

👾 Open Computer Use – Open-Source Alternative to Codex Computer Use

docs: add custom README demo covers

Leo270d0d93cc6b
diff --git a/README.md b/README.md
index 93c8544..b4281d2 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,8 @@
# open-computer-use
- [中文说明](./README.zh-CN.md)
+[中文说明](./README.zh-CN.md)
- [![Watch the demo](https://img.youtube.com/vi/2s6aVpGiwaQ/0.jpg)](https://youtu.be/2s6aVpGiwaQ)
+[![Open Computer Use custom demo cover](./docs/generated/readme-assets/open-computer-use-demo-cover.png)](https://youtu.be/2s6aVpGiwaQ)
`open-computer-use` is an open-source `Computer Use` service exposed over `MCP`, so any AI agent or MCP client can call it directly and use computer interaction capabilities on macOS.
@@ -64,7 +64,7 @@ Cursor Motion is an open-source cursor motion system for macOS, based on public
swift run CursorMotion
```
-[![Watch the demo](https://img.youtube.com/vi/KRUq5GUHv1Q/0.jpg)](https://youtu.be/KRUq5GUHv1Q)
+[![Cursor Motion custom demo cover](./docs/generated/readme-assets/cursor-motion-demo-cover.png)](https://youtu.be/KRUq5GUHv1Q)
## License
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 3ba087c..b0cb29c 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -2,7 +2,7 @@
[English Version](./README.md)
-[![查看演示视频](https://img.youtube.com/vi/2s6aVpGiwaQ/0.jpg)](https://youtu.be/2s6aVpGiwaQ)
+[![open-computer-use 自定义演示封面](./docs/generated/readme-assets/open-computer-use-demo-cover.png)](https://youtu.be/2s6aVpGiwaQ)
`open-computer-use` 是一个开源的 `Computer Use` 服务,已经包装成 `MCP` 协议,支持所有的 AI Agent 或 MCP Client 快速调用,实现 macOS 上的 `Computer Use` 能力
@@ -69,7 +69,7 @@ Cursor Motion 是一个面向 macOS 的开源光标运动系统,基于 Softwar
swift run CursorMotion
```
-[![查看演示视频](https://img.youtube.com/vi/KRUq5GUHv1Q/0.jpg)](https://youtu.be/KRUq5GUHv1Q)
+[![Cursor Motion 自定义演示封面](./docs/generated/readme-assets/cursor-motion-demo-cover.png)](https://youtu.be/KRUq5GUHv1Q)
## License
diff --git a/docs/generated/readme-assets/cursor-motion-demo-cover.png b/docs/generated/readme-assets/cursor-motion-demo-cover.png
new file mode 100644
index 0000000..9234a34
Binary files /dev/null and b/docs/generated/readme-assets/cursor-motion-demo-cover.png differ
diff --git a/docs/generated/readme-assets/open-computer-use-demo-cover.png b/docs/generated/readme-assets/open-computer-use-demo-cover.png
new file mode 100644
index 0000000..5a70b45
Binary files /dev/null and b/docs/generated/readme-assets/open-computer-use-demo-cover.png differ
diff --git a/docs/histories/2026-04/20260420-1825-clarify-youtube-demo-links-in-readme.md b/docs/histories/2026-04/20260420-1825-clarify-youtube-demo-links-in-readme.md
new file mode 100644
index 0000000..fb264f3
--- /dev/null
+++ b/docs/histories/2026-04/20260420-1825-clarify-youtube-demo-links-in-readme.md
@@ -0,0 +1,35 @@
+## [2026-04-20 18:25] | Task: clarify README YouTube demo links
+
+### 🤖 Execution Context
+* **Agent ID**: `codex`
+* **Base Model**: `GPT-5 family (Codex)`
+* **Runtime**: `Codex CLI`
+
+### 📥 User Query
+> README 里的 YouTube 链接渲染后看起来像普通图片,不容易让人意识到它其实是视频;希望说明原因并把展示改得更明确。
+
+> 后续又要求把显式说明收敛成更简洁的样式,改为在视频缩略图下方放一个居中的 caption。
+
+> 之后又提出已经做了一张 base64 图片,希望给 README 留一个可替换的占位,并说明该怎么接入。
+
+> 最后提供了两张本地 PNG,希望直接移到仓库里作为正式封面图使用。
+
+### 🛠 Changes Overview
+**Scope:** `repository docs`
+
+**Key Actions:**
+- **[Centered captions]**: 在中英文 README 的两个演示区保留原有缩略图链接,并把说明文字改成图片下方居中的 caption。
+- **[Less visual noise]**: 去掉图片上方额外的说明行,避免 README 顶部和章节之间被重复文案打断。
+- **[Custom cover placeholder]**: 在中英文 README 顶部 demo 区增加注释式占位,约定把 base64 解码到仓库内固定路径后再替换图片引用。
+- **[Repo-local covers]**: 把用户提供的两张 `1280x720` PNG 移到 `docs/generated/readme-assets/`,并把中英文 README 的两处视频封面都切到仓库内相对路径。
+- **[History sync]**: 新增本次文档改动 history,保持 README 展示策略的变更可追踪。
+
+### 🧠 Design Intent (Why)
+GitHub README 不会把普通外链视频缩略图自动渲染成带播放键或 YouTube 角标的嵌入式卡片;在不引入 iframe 的前提下,用自定义封面图加下方 caption 是更直接的表达。最终封面资源落到仓库内固定目录,并通过相对路径引用,既符合 GitHub README 的稳定渲染方式,也比继续保留 base64 占位或外链缩略图更可维护。
+
+### 📁 Files Modified
+- `README.md`
+- `README.zh-CN.md`
+- `docs/generated/readme-assets/open-computer-use-demo-cover.png`
+- `docs/generated/readme-assets/cursor-motion-demo-cover.png`
+- `docs/histories/2026-04/20260420-1825-clarify-youtube-demo-links-in-readme.md`