opencode-android/README.th.md at main · hi77x/opencode-android

เอเจนต์การเขียนโค้ดด้วย AI แบบโอเพนซอร์ส

opencode สำหรับ Android

Important

Android data survives reinstall only if all-files access is granted: server data is stored under /sdcard/OpenCode/home; otherwise app-private data is removed on uninstall. You may need to reselect a project after reinstalling. The v0.1.1 source tag predates the Android module; build from main. The uploaded APK has not been verified as a byte-for-byte build of main. See the current Android notes.

ฟอร์กนี้รัน opencode ที่มีอยู่แบบเนทีฟบน Android: โทรศัพท์รันเซิร์ฟเวอร์จริง เอเจนต์ เซสชัน และอินเทอร์เฟซ packages/app ที่ไม่ได้แก้ไข (ผ่าน loopback ใน WebView) ไม่ต้องใช้พีซี, Termux, เซิร์ฟเวอร์ระยะไกล และไม่มีการเปลี่ยนโปรโตคอล

สิ่งที่เราเพิ่มจาก upstream (ที่เหลือคือ opencode upstream ทั้งหมด):

พาธ	เนื้อหา
`packages/android`	โฮสต์ Android: โปรเจกต์ Gradle, Activity ของ WebView, เซิร์ฟเวอร์ฝังตัว, การปรับ UI สำหรับมือถือ
`script/android`	บิลด์ที่ทำซ้ำได้: `build-apk.sh` พร้อมสคริปต์สำหรับเซิร์ฟเวอร์, ripgrep, รันไทม์ git และคำแปล
`docs/android`	เอกสารวิศวกรรม: บิลด์, นโยบายการรัน, ไดรเวอร์ภายนอก, แพตช์ upstream

มีเพียงห้าไฟล์ upstream ที่ถูกแก้ไข (เป้าหมายบิลด์ Android และความเข้ากันได้ของรันไทม์) แต่ละอย่างมีเหตุผลใน docs/android/UPSTREAM_PATCHES.md

วิธีการทำงาน: Activity เริ่มเซิร์ฟเวอร์ฝังตัว (libopencode.so serve --hostname=127.0.0.1) และโหลด http://127.0.0.1:<port>/ ใน WebView เครื่องมือรันจาก nativeLibraryDir ของแอป: /system/bin/sh, git, rg ที่แนบมา และรันไทม์ Bun ที่เปิดเป็น bun/node

ดาวน์โหลด: releases (app-release.apk, arm64, Android 8.0+)
บิลด์: ./script/android/build-apk.sh — ดู docs/android/BUILD.md
เปิดครั้งแรก: อนุญาตการเข้าถึงไฟล์ (เซสชันเก็บใน /sdcard/OpenCode/home และอยู่รอดหลังติดตั้งใหม่) จากนั้น การตั้งค่า → ผู้ให้บริการ → เชื่อมต่อผู้ให้บริการและเพิ่มโปรเจกต์ (~/workspace)
ทำงานได้: เซิร์ฟเวอร์และเว็บ UI, เซสชัน, git พร้อม diff และไฮไลต์ไวยากรณ์ (Changes), ตัวเรียกดูไฟล์โปรเจกต์ (Files), แผงการใช้บริบท (Usage), การรันคำสั่งและ JS/TS
ข้อจำกัด: ไม่มีเทอร์มินัล PTY, LSP/ตัวจัดรูปแบบ และโปรเซส MCP ภายในเครื่อง; file watcher แบบเนทีฟใช้ไม่ได้ (ค้นหาด้วย rg)
สัญญาอนุญาต: MIT เช่นเดียวกับต้นฉบับ

การติดตั้ง

# YOLO
curl -fsSL https://opencode.ai/install | bash

# ตัวจัดการแพ็กเกจ
npm i -g opencode-ai@latest        # หรือ bun/pnpm/yarn
scoop install opencode             # Windows
choco install opencode             # Windows
brew install anomalyco/tap/opencode # macOS และ Linux (แนะนำ อัปเดตเสมอ)
brew install opencode              # macOS และ Linux (brew formula อย่างเป็นทางการ อัปเดตน้อยกว่า)
sudo pacman -S opencode            # Arch Linux (Stable)
paru -S opencode-bin               # Arch Linux (Latest from AUR)
mise use -g opencode               # ระบบปฏิบัติการใดก็ได้
nix run nixpkgs#opencode           # หรือ github:anomalyco/opencode สำหรับสาขาพัฒนาล่าสุด

Tip

ลบเวอร์ชันที่เก่ากว่า 0.1.x ก่อนติดตั้ง

แอปพลิเคชันเดสก์ท็อป (เบต้า)

OpenCode มีให้ใช้งานเป็นแอปพลิเคชันเดสก์ท็อป ดาวน์โหลดโดยตรงจาก หน้ารุ่น หรือ opencode.ai/download

แพลตฟอร์ม	ดาวน์โหลด
macOS (Apple Silicon)	`opencode-desktop-mac-arm64.dmg`
macOS (Intel)	`opencode-desktop-mac-x64.dmg`
Windows	`opencode-desktop-windows-x64.exe`
Linux	`.deb`, `.rpm`, หรือ AppImage

แอปมือถือ (BETA)

OpenCode ทำงานบน Android เป็น APK เนทีฟที่บิลด์จากฟอร์กนี้ แอปมีเซิร์ฟเวอร์จริงและเว็บ UI เดียวกัน; เซสชัน คีย์ผู้ให้บริการ และโปรเจกต์เก็บใน /sdcard/OpenCode/home และอยู่รอดหลังติดตั้งใหม่

แพลตฟอร์ม	ดาวน์โหลด	หมายเหตุ
Android 8.0+ (arm64)	`app-release.apk`	BETA — อนุญาตการเข้าถึงไฟล์เมื่อเปิดครั้งแรก
บิลด์จากซอร์ส	`./script/android/build-apk.sh`	ดู `packages/android/README.md`

# macOS (Homebrew)
brew install --cask opencode-desktop
# Windows (Scoop)
scoop bucket add extras; scoop install extras/opencode-desktop

ไดเรกทอรีการติดตั้ง

สคริปต์การติดตั้งจะใช้ลำดับความสำคัญตามเส้นทางการติดตั้ง:

$OPENCODE_INSTALL_DIR - ไดเรกทอรีการติดตั้งที่กำหนดเอง
$XDG_BIN_DIR - เส้นทางที่สอดคล้องกับ XDG Base Directory Specification
$HOME/bin - ไดเรกทอรีไบนารีผู้ใช้มาตรฐาน (หากมีอยู่หรือสามารถสร้างได้)
$HOME/.opencode/bin - ค่าสำรองเริ่มต้น

# ตัวอย่าง
OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash
XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash

เอเจนต์

OpenCode รวมเอเจนต์ในตัวสองตัวที่คุณสามารถสลับได้ด้วยปุ่ม Tab

build - เอเจนต์เริ่มต้น มีสิทธิ์เข้าถึงแบบเต็มสำหรับงานพัฒนา
plan - เอเจนต์อ่านอย่างเดียวสำหรับการวิเคราะห์และการสำรวจโค้ด
- ปฏิเสธการแก้ไขไฟล์โดยค่าเริ่มต้น
- ขอสิทธิ์ก่อนเรียกใช้คำสั่ง bash
- เหมาะสำหรับสำรวจโค้ดเบสที่ไม่คุ้นเคยหรือวางแผนการเปลี่ยนแปลง

นอกจากนี้ยังมีเอเจนต์ย่อย general สำหรับการค้นหาที่ซับซ้อนและงานหลายขั้นตอน ใช้ภายในและสามารถเรียกใช้ได้โดยใช้ @general ในข้อความ

เรียนรู้เพิ่มเติมเกี่ยวกับ เอเจนต์

เอกสารประกอบ

สำหรับข้อมูลเพิ่มเติมเกี่ยวกับวิธีกำหนดค่า OpenCode ไปที่เอกสารของเรา

การมีส่วนร่วม

หากคุณสนใจที่จะมีส่วนร่วมใน OpenCode โปรดอ่าน เอกสารการมีส่วนร่วม ก่อนส่ง Pull Request

การสร้างบน OpenCode

หากคุณทำงานในโปรเจกต์ที่เกี่ยวข้องกับ OpenCode และใช้ "opencode" เป็นส่วนหนึ่งของชื่อ เช่น "opencode-dashboard" หรือ "opencode-mobile" โปรดเพิ่มหมายเหตุใน README ของคุณเพื่อชี้แจงว่าไม่ได้สร้างโดยทีม OpenCode และไม่ได้เกี่ยวข้องกับเราในทางใด

ร่วมชุมชนของเรา Discord | X.com

FilesExpand file tree

README.th.md

Latest commit

History