v0.5.0 Headless Architecture & Structured Outputs Schema

AI Coding Agent Độc Lập
Cho Termux & Đa Nền Tảng

Nền tảng coding agent độc lập, hiệu năng cao và bảo mật nghiêm ngặt. Tối ưu hàng đầu cho Termux trên Android và tương thích hoàn toàn Linux, macOS, Windows. Sử dụng API key cá nhân (BYOK), cơ chế phân quyền Fail-Closed và không phụ thuộc dịch vụ trung gian.

0 Native Addons Termux Native First-Class 100% BYOK Freedom 8 Fail-Closed Hooks

Trình quản lý gói:

npm install -g @nguyenhuumanh/vyen

Yêu cầu Node.js >= 22.16 LTS · Mã nguồn biên dịch sẵn · Tương thích tức thì

Kịch bản minh họa:

~/workspace/production · git:(main) · vyen v0.5.0

POSIX Interactive Session

Engine: Active Tokens: 1,420 Decision: Approved

Quy trình độc lập · Kiểm toán JSONL cục bộ

Lệnh mẫu thông dụng:

Kiến Trúc Hệ Thống

Nguyên Lý Thiết Kế Cốt Lõi

Được thiết kế cho các kỹ sư đòi hỏi sự chính xác tuyệt đối, tốc độ thực thi tại biên và tính toàn vẹn hệ thống.

Termux First-Class

Tối Ưu Native Cho Termux Trên Android

Xây dựng bằng 100% JavaScript thuần chạy trên Node >= 22.16 LTS. Vận hành trực tiếp trong môi trường Termux mà không cần quyền root, không cần proot hay glibc wrapper cồng kềnh.

Khởi chạy tức thì trong thư mục $HOME của thiết bị di động
Tận dụng ripgrep hệ thống với cơ chế fallback JS thuần mượt mà
Hỗ trợ đầy đủ tương tác clipboard hệ thống Android

BYOK Freedom

Bring Your Own Key & Tự Do Đa Provider

Loại bỏ hoàn toàn chi phí thuê bao cố định và rủi ro bị khóa chặt vào một nhà cung cấp. Bạn toàn quyền sử dụng API key cá nhân để kết nối trực tiếp với các mô hình tiên tiến nhất (OpenAI, Anthropic, Gemini, Groq, local LLM).

Tương thích OpenAI, Responses API chuẩn mực và Anthropic Messages
Hỗ trợ suy luận cục bộ ngoại tuyến qua Ollama, vLLM, LM Studio
Tự động khám phá danh mục model linh hoạt qua lệnh /models

Fail-Closed Safety

Kiến Trúc Bảo Mật Phân Tầng & Workspace Trust

Quyền kiểm soát chặt chẽ với các chế độ Ask / Auto / Read-Only. Xác thực Workspace Trust bằng chữ ký SHA-256 bảo vệ toàn diện các kịch bản shell thực thi.

8 Hook vòng đời fail-closed (PreToolUse, PostToolUse...) bảo vệ hệ thống
Ngăn chặn hoàn toàn việc rò rỉ credential API ra shell con
Nhật ký kiểm toán audit log định dạng JSONL minh bạch cục bộ

Extensible Power

Subagents & Model Context Protocol (MCP)

Khả năng mở rộng không giới hạn: phân quyền tác vụ cho các Subagent chạy nền độc lập, kết nối công cụ ngoài qua chuẩn Model Context Protocol (MCP) và ghép đôi thiết bị qua /pair.

Quản lý MCP cấp độ user và project (.vyen/mcp.json) với ưu tiên User Deny
Điều phối mạng lưới tác vụ Agent Network và workflow tùy biến
Ghép đôi thiết bị từ xa qua tunnel bảo mật Cloudflare (/pair)

Đối Sánh Kỹ Thuật

So Sánh Vyen Với Các Giải Pháp Khác

Đánh giá các tiêu chí kiến trúc quan trọng cho lập trình viên cần sự tự chủ và tính di động.

Bảng so sánh kỹ thuật: ↔ Vuốt ngang

Tiêu chí kiến trúc	Vyen CLI	Claude Code	Cursor / Aider
Termux (Android) Native	✔ Native (0 root / 0 proot)	✘ Không hỗ trợ	⚠ Phức tạp qua proot/glibc
Chi phí / Thuê bao	✔ Miễn phí 100% (Open-Source)	Tính theo token API	$20/tháng subscription
Lựa chọn Provider (BYOK)	✔ OpenAI, Anthropic, Ollama, LM Studio	Chỉ Anthropic	Đa dạng
Fail-Closed Lifecycle Hooks	✔ 8 Sự kiện chuẩn + SHA-256 Trust	✔ Có hooks	✘ Không hỗ trợ
Điều khiển từ xa (Pair)	✔ /pair Cloudflare QR Tunnel	✘ Không hỗ trợ	✘ Không hỗ trợ

Bắt Đầu Nhanh

Hướng Dẫn Cài Đặt Đa Nền Tảng

Hệ thống tự động phát hiện thiết bị hoặc bấm phím số 1-4 để chuyển đổi.

Quy trình cài đặt trên Termux (Android): Node.js >= 22.16 LTS

# 1. Cài đặt các gói công cụ hệ thống cần thiết
pkg install nodejs-lts git bash ripgrep

# 2. Cài đặt Vyen CLI từ npm toàn cục
npm install -g @nguyenhuumanh/vyen

# 3. Khởi chạy wizard thiết lập tương tác
vyen setup

Quy trình cài đặt trên Linux (Debian, Ubuntu, Arch, Fedora): npm / pnpm / yarn / bun

# Cài đặt Vyen toàn cục
npm install -g @nguyenhuumanh/vyen

# Chạy wizard tương tác thiết lập provider và model
vyen setup

# Bắt đầu làm việc
vyen

Quy trình cài đặt trên macOS (Apple Silicon / Intel / Darwin): Terminal / iTerm2 / Ghostty

# Cài đặt Vyen toàn cục
npm install -g @nguyenhuumanh/vyen

# Cấu hình API key & chọn model
vyen setup

# Mở giao diện agent
vyen

Quy trình cài đặt trên Windows (PowerShell / Windows Terminal): PowerShell 7+ hoặc Windows PowerShell

# Cài đặt Vyen trong PowerShell
npm install -g @nguyenhuumanh/vyen

# Chạy wizard hướng dẫn cấu hình
vyen setup

# Bắt đầu phiên làm việc
vyen

Kiến trúc: Lệnh vyen setup tự động kiểm tra model qua endpoint, mã hóa key quyền 0600 và lưu trữ an toàn.

Xem tài liệu chi tiết →

Giải Đáp Kỹ Thuật

Câu Hỏi Thường Gặp (FAQ)

Những thắc mắc phổ biến nhất của các kỹ sư khi triển khai Vyen CLI.

1. Vyen CLI hoạt động trên Termux như thế nào mà không cần quyền root?

2. Mô hình Bring Your Own Key (BYOK) tiết kiệm chi phí ra sao?

3. Cơ chế bảo mật Fail-Closed Hooks và Workspace Trust vận hành thế nào?

4. Làm thế nào để điều khiển Vyen từ xa qua lệnh /pair?

Khi gõ lệnh /pair trong phiên làm việc, Vyen khởi tạo một tunnel bảo mật qua Cloudflared và in ra mã QR ngay trong terminal. Bạn chỉ cần quét mã bằng camera điện thoại để mở giao diện Web UI điều khiển phiên agent từ xa. Kết nối được bảo vệ bởi token ngẫu nhiên 128-bit và áp dụng cơ chế ủy quyền an toàn.

5. Vyen có hỗ trợ kết nối mô hình cục bộ ngoại tuyến (Ollama, LM Studio) không?

Hoàn toàn có! Bạn có thể trỏ Vyen tới bất kỳ máy chủ tương thích OpenAI API nào đang chạy trên máy tính hoặc mạng LAN nội bộ (như http://localhost:11434/v1 với Ollama, hoặc LM Studio, vLLM). Quá trình suy luận diễn ra 100% offline, đảm bảo mã nguồn và dữ liệu mật của dự án không bao giờ rời khỏi thiết bị của bạn.

6. Hệ sinh thái Subagent và Model Context Protocol (MCP) hoạt động ra sao?

Vyen hỗ trợ chia tách nhiệm vụ phức tạp cho các Subagent chạy song song trong không gian làm việc độc lập. Đồng thời, cấu hình .vyen/mcp.json cho phép kết nối tức thì các máy chủ MCP (công cụ truy vấn database, GitHub, Brave Search, hệ thống tệp bên ngoài) với nguyên tắc bảo mật tối thượng: User Deny luôn có quyền ưu tiên cao nhất.

Nhật Ký Phiên Bản & Bản Vá

Lịch Sử Tiến Hóa & Sửa Lỗi Chi Tiết

Minh bạch 100% mọi commit, bản vá an ninh, sửa lỗi kiểm toán và các mốc kiến trúc theo thời gian thực.

v0.5.1 (Bản vá Git Master · npm: v0.5.0) Bản vá an ninh mới nhất

2026-11-01 · Vừa cập nhật

Vá lỗ hổng Policy Bypass & Lệnh đặc quyền su (ae1c317, 715e7e3):

src/workflow.ts: Khắc phục lỗi bước workflow con không kế thừa policy và hookBus, chặn đứng hoàn toàn việc bypass cấu hình deny do người dùng đặt ra.
src/policy.ts: Thắt chặt regex nhận diện lệnh bọc su -c, ngăn chặn kỹ thuật bypass bộ lọc qua tiến trình đặc quyền.
src/pair.ts: Lọc sạch và kiểm duyệt nghiêm ngặt tham số lệnh gửi từ xa qua tunnel Cloudflare.

Chống rò rỉ Credential & Khóa chặt bất biến Read-Only (715e7e3):

src/process.ts: Tự động scrub sạch biến môi trường VYEN_API_KEY khi spawn tiến trình shell con, triệt tiêu nguy cơ lộ key ra các tool thứ ba.
src/memory.ts: Tự động loại bỏ credential và API key trước khi ghi vào tệp memories.json.
src/files.ts: Bảo đảm tuyệt đối bất biến chỉ đọc (read-only invariant), không cho phép tool sửa đổi tệp ngoài ranh giới cho phép.
src/cli.ts: Duy trì liên tục chính sách phân quyền khi thay thế phiên (/new, /resume).

Phòng thủ SSRF toàn diện & Fallback Web Search (2fef5c4):

src/web.ts: Chống tấn công SSRF bằng kỹ thuật DNS Pinning, chặn toàn bộ truy cập vào dải IP nội bộ (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16, 127.0.0.0/8) và endpoint metadata đám mây (169.254.169.254).
Bổ sung cơ chế fallback tự động chuyển đổi sang các nhà cung cấp tìm kiếm dự phòng khi DuckDuckGo bị nghẽn.

v0.5.0 Architecture Release

2026-10

Chuẩn hóa Headless Contract (R1.4) & Tách Module src/events.ts

Bổ sung cờ --output-format stream-json|text với schema v1 có phiên bản chuẩn.
Hỗ trợ --json-schema <schema> ép kiểu Structured Outputs qua Ajv validator (cơ chế fail-closed).
Tách module src/events.ts quản lý tập trung toàn bộ Zod schemas và kiểu sự kiện headless.
Chuẩn hóa tài liệu token budget cho môi trường tự động hóa không giám sát.

v0.4.0 Major Architecture

2026-10

Lifecycle Hooks, Workspace Trust SHA-256 & Project MCP

Cấu hình phân tầng .vyen/settings.json với chính sách permissions.allow|ask|deny.
8 sự kiện Hook vòng đời fail-closed (PreToolUse, PostToolUse, Stop, SessionStart...) bảo vệ an toàn hệ thống.
Xác thực Workspace Trust (--trust-workspace) bọc mã băm SHA-256 cho settings và kịch bản thực thi.
Hỗ trợ Project MCP (.vyen/mcp.json) theo quy tắc User Deny Wins.
Ghép đôi thiết bị từ xa qua Cloudflared (/pair) kèm QR và web UI điện thoại.

v0.3.1 Maintenance

2026-10

Lệnh Tự Nâng Cấp vyen upgrade

Lệnh vyen upgrade [VERSION] tự động nhận diện npm/pnpm/yarn/bun.
Hỗ trợ thông báo cập nhật bản mới một lần mỗi ngày trong TUI.

v0.3.0 Foundation

2026-10

Tối Ưu Hiệu Năng TUI & Kiểm Toán Bảo Mật Toàn Diện

Render TUI tăng tốc ~80 lần mỗi frame; tối giản giao diện với thanh trạng thái tập trung.
Vá bảo mật: không lộ API key vào môi trường bash, rg, git.
Sửa lỗi xử lý chuỗi regex trong edit_file và apply_patch.
Nhật ký audit log JSONL cục bộ bảo vệ quyền riêng tư người dùng.

Kho lưu trữ: tungsten321/Vyen-cli:master

ae1c317 fix(security): resolve workflow policy default bypass and su wrapper regex

2026-11-01 22:17

Kế thừa policy và hook bus vào step harness của workflow; sửa regex su wrapper chặn bypass đặc quyền.

Files: src/workflow.ts, src/policy.ts, src/pair.ts

715e7e3 fix(security): resolve policy enforcement, credential scrubbing, and read-only invariants

2026-11-01 21:41

Scrub VYEN_API_KEY khỏi shell con và memories.json; ép bất biến chỉ đọc; gắn policy khi session replace.

Files: src/process.ts, src/memory.ts, src/files.ts, src/cli.ts

2fef5c4 fix(web): address code review findings for ssrf, help, and fallbacks

2026-11-01 20:53

Chống SSRF với DNS Pinning, chặn private/loopback/cloud metadata IP; bổ sung fallback web search.

Files: src/web.ts, src/help.ts, src/pair.ts

AI Coding Agent Độc Lập Cho Termux & Đa Nền Tảng

Kiến Trúc Hệ Thống

Tối Ưu Native Cho Termux Trên Android

Bring Your Own Key & Tự Do Đa Provider

Kiến Trúc Bảo Mật Phân Tầng & Workspace Trust

Subagents & Model Context Protocol (MCP)

Đối Sánh Kỹ Thuật

Bắt Đầu Nhanh

Giải Đáp Kỹ Thuật

Nhật Ký Phiên Bản & Bản Vá

AI Coding Agent Độc Lập
Cho Termux & Đa Nền Tảng