KJ

k4wai1/jav

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

0 stars 0 forks 质量 54 趋势 14NOASSERTION

Jav — 非根的 Android 控制运行时,基于 MCP:设备内 UI 自动化、原生遥测 API 和双层 AI(Jev + director)

概览

规范细节存在于 AGENTS.md、PROTOCOL.md、ARCHITECTURE.md、PLAN.md 以及文档/规范中。 设备内应用(dev.k4wai1.jav)通过AccessibilityService显示屏幕,并通过用户启动的特权操作向PC上的Go MCP服务器(jav, cmd/jav, stdio)执行。 Jav从不循环,从不计划,也不发明坐标。导演握着环;Jav握着装置。 每个工具返回{ok, verified, evidence, hint}。验证:仅在真实后验证时为真,绝不在“命令发送”时。工具/列表每个工具包含紧凑的1–2行描述;完整的7部分规范作为MCP资源加载(android://tool/,android://tools/,索引 android://tools/catalog)。启动时使用真实的tiktoken分词器测量:(指令+38个简洁描述)和(包含38个工具的固定MCP模式,未合并不可简化)——即v1.2.0之前~8.8k。参见文档/基准测试/PERFORMANCE.md §9。

概述(AI 翻译)

全控制的Android MCP运行时。无root权限。

以无障碍为先的设备应用 + Go MCP 服务器(标准):38 个原子工具, 雫门壳,配有 WS/尾网,配有 TOFU 钉针。

发行作品 · 协议· 基准测试 · 计划

英语优先,西班牙语 después。 规范细节存在于 AGENTS.md, PROTOCOL.md、ARCHITECTURE.md、PLAN.md 和 docs/specs/。


什么是贾夫

Jav 是一个完全控制的 Android MCP 运行时,无需 root 权限。 一个设备内应用 (Jav, dev.k4wai1.jav)通过AccessibilityService曝光屏幕,且 通过Shizuku(由用户发起)对Go MCP服务器进行特权操作 PC(jav,标准)。

Jav(本仓库) Director(外部,非Jav的一部分)
什么 Go MCP 服务器(cmd/jav)+ Android 应用 dev.k4wai1.jav OpenCode / Claude / 光标 / 操作符
是否 暴露38个原子MCP工具,不运行循环,也不运行内部规划器 读取每个屏幕,每步选择一个原子工具,验证效果
战术帮助 发球 resolve_element(盲目第一季Jev解决器) 决定目标、开门并批准预览

Jav从不循环,从不计划,也不发明坐标。导演保持

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

English first, español después. Normative detail lives in AGENTS.md, PROTOCOL.md, ARCHITECTURE.md, PLAN.md and docs/specs/.


What is Jav

Jav is a full-control Android MCP runtime without root. An on-device app (Jav, dev.k4wai1.jav) exposes the screen via AccessibilityService and privileged actions via Shizuku (started by the user) to a Go MCP server on the PC (jav, stdio).

Jav (this repo) Director (external, not part of Jav)
What Go MCP server (cmd/jav) + Android app dev.k4wai1.jav OpenCode / Claude / Cursor / operator
Does exposes 38 atomic MCP tools, runs no loops and no internal planner reads each screen, picks one atomic tool per step, verifies the effect
Tactical help serves resolve_element (blind S1 Jev resolver) decides goals, gates, and approves previews

Jav never loops, never plans and never invents coordinates. The Director holds the loop; Jav holds the device.

Architecture

Interactive version: docs/diagrams/jav-architecture.html

The Director reads the screen, picks one atomic tool per step and verifies the effect. When the screen is noisy, resolve_element adds a blind tactical resolver (S1 Jev): the accessibility tree is pruned to a numbered table (≤254 candidates) and Jev answers in a single pass — a Choice + confidence, no free text, anti-prompt-injection by construction. conf ≥ 0.70 (tau) or

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →