项目文档

文档总索引与维护规则

当前发布（2026-10-23）：v0.2.1-rc.2 正式版，沿用2100标准APK / dsh.android.client。用户已授权以贡献者身份直接公开发布至 DSH-APP/DSHA，不创建PR；覆盖此前公开暂停规则。下方较早的“仅私有交付/公开暂停”按当时记录阅读，不作为当前发布规则；本次发布不修改应用实现与APK字节。

核验日期：2026-10-22。当前性能维护版本 0.2.1-rc.2-20261022.0243-dsh0.2.1-rc.2 / code190；本轮范围与产物、启动/初始化完整调查、脱敏证据。下段F13数量/固定包是历史基准，不是当前清单。公开发布继续暂停，仅私有维护交付。

核验日期：2026-10-21。当前维护入口为build190/F13，完整诊断身份0.2.1-rc.2-20261021.2107-dsh0.2.1-rc.2 /190；本批软件、APK及未验范围见F13记录。F13冻结源码2215成员/200篇Markdown，Java adoption 1029项。分发/格式证明与JUnit执行计数分开。固定输入包738,101,893 bytes，SHA-256 da3a87e9782469136f08d37143582fec845af1a69406b9a534f8cb7f68249ed8，原始输入直接展开到项目路径；不是完整源码ZIP的大小或摘要。完整英文入口见English index。已发布F12保留原身份，F11未上传；平台primary、当前源码/锁和实际执行证据互不替代，历史本机附件不冒称随源码可取得。

当前功能与架构

文档	解决的问题
项目维护总手册	全部主要功能、框架分层、入口类与修改/测试地图
ADB / Root / Shizuku 权限架构	系统权限、特权通道、无障碍、自有审批、服务与撤销、故障排查
环境、数据与插件机制	解压启动、正常/安全/应急、受管更新、pnpm/插件事务、凭据、备份与恢复
运行引擎与运行态	当前proot/proroot、DSHA v1.1.6历史、vendor版本、loader/shim、退出监督与兼容边界
端口与网络	自动/手动Web端口、备用本机记忆、3090桥/ADB/LAN分域、当前重试接入边界
DNS配置	auto/ipv4/native的真实差异、Node窄lookup重试、glibc no-aaaa与用户选择
虚拟屏架构	Core/Manager/工具路由、帧/节点/anchor证据、采集输入、关闭恢复与修改回归
ADR0001 / ADR0002 / ADR0003	架构取舍、权限与数据边界、虚拟屏生命周期及后果
资料与来源依据	官方primary入口、工程上游关系、固定版本/摘要、许可与来源限制

用户操作与开发入口

README、开发约束、构建、贡献流程、接手指南。
Standard、Low、插件、虚拟屏开启、网页文件交互、v5备份格式、配置恢复。
工程规范、模块地图、安全模型、源码来源、下载校验。

当前操作与专题

场景	文档
首次安装、组件探测、按需修复、维护与中断恢复	安装与维护、启动与诊断、应用及受管更新
引擎/静态加载器/seccomp、DNS、端口排查	运行与网络选择、引擎、DNS、端口
设备通道、3090协议、LAN、文件与系统文档入口	设备通道、桥与文件、LAN、Web文件
一键/手动/自动备份、恢复、快照与独立应急	备份与恢复、配置快照、独立应急、v5格式
插件安装、系统/用户分层、协议、权限与重启	插件操作、插件运行与权限
PTY/简易终端、WebView/Gecko、桌面UA、PiP	终端、浏览器内核、画中画
语言锁存、悬浮条、审批和任务通知	语言、悬浮与通知
源码/固定输入/签名/发布与测试证据	构建与发布、领域边界、议题流程、分诊用语

每篇新专题注明核验日期、参考基线、真实生效时机及失败/验证边界。三篇Agent流程是F11新写维护说明，不伪称恢复旧原件，也不证明远端标签、权限或工作流配置。GLOSSARY按实际术语需求创建。

当前默认与术语：proot默认、proroot显式可选；默认Web端口为自动，备用只在本机保存；DNS auto并非全局IPv4优先。原生模型配置生产入口已移除，模型设置在Web；画中画默认关闭；一键备份先安全停止DSH/任务并保存无密码归档，外置工作区内容另备。精确定义以对应专页和当前代码为准。

历史材料如何阅读

CHANGELOG保留旧版本的默认值和性能记录，同时追加build190迁移说明。DSHA v1.1.6不是proroot上游版本；当前vendor锁v1.2.8。旧构建的回退、安装、签名、包名或测试数量不能用作当前交付结论。

当前源码发布补齐普通维护Markdown及其需要的历史发布说明，包括真实fix1、build156与旧接手原件；它们保持原归属。历史文内的app/build回执、旧本机APK、原始设备日志、截图和私有审计附件没有为修复导航而上传。它们是当时本机材料引用，不能当成当前仓库下载入口或本轮复测证明。当前维护请从本索引进入，不按旧脚本生成额外审计APK或清理用户数据。

历史报告原文保持；发布可见性检查区分当前指南链接、可用历史说明和未分发的本机证据。找到旧报告的真实原件会核对摘要后纳入，不凭空重建遗失回执。下表用于定位报告本身，不声称其所有原始现场附件都在源码包内。

文档更新与可复核性

F11以实际分发stage检查引用，而非用开发机全树存在替代交付闭合。以下历史材料按真实原件纳入精确白名单；它们仅证明原时点，不恢复旧格式化、审批、版本或验收要求。

真实历史文件	分发用途
build154 POLICY	旧审计正文的当时约束说明；当前约束仍看AGENTS/现行专题
rc2全局审计总结	build147当时的架构/交付范围；不是本轮设备回执
build155架构、剩余项	对应历史发布说明及build156评估的递归文档依赖
build156架构、剩余项	对应历史原件与当时未验范围
历史文档保存清单、ShellService来源记录、BUILD原件记录	3项新增显式JSON元数据；连同原6项共9项，不开放其他audit JSON
Termux历史README	F盘找到的3547字节原件，SHA `c29a880a9d7014d58b125bd57e6f7a52a4bae4bda64e76dd22a2819382f521ca`精确符合保存清单

保存清单记录的全部历史对象不因此全部随本包分发。特别是历史执行台账、原始设备图/日志等仍按各自保密与分发范围处理；来源JSON中的未知授权也不会因文件可下载而变成已证实授权。

为使原字节历史发布页的真实相对链接在GitHub/源码ZIP中可点击，F11新增以下5份导航副本。每份与所列源文件原字节相同；这是本轮导航复制，不是声称新追回了五份旧保存原件。既有历史发布原件不改写，也不按新位置重新解释其链接。第5份发布页是导航副本内继续引用的必要递归目标。

本轮导航副本	原字节复制来源
build156架构副本	原文
build156剩余项副本	原文
build155剩余项副本	原文
build155架构副本	原文
build155发布页副本	原文

两份固定上游原文另有8条上游相对引用，不代表这些目标存在于APK本地：mobile README（SHA 852f84c7a58695bfca8730e003155c2a061d58e31f648e88d10e0528499b63ab）的4图及AGENTS映射到上游固定commit 10e58ce0c4ed424c7fbd9c91d48db06c6061b4e4；Termux原许可证（SHA a8992ad867b1b4ea442693acb2e1ee829a814758e79a099bd8243a04ae383304）的2目录及共享许可证映射到commit 6e2689f55295fa444be8ac8592c527c2c5ef3253。门禁输出精确上游URL并标upstream-source-relative警告；--strict-history仍失败。源路径、源摘要或目标任一变化都不能沿用例外，其他缺失目标继续失败。没有改动这两份上游原文或APK资产。

改默认值、设置项、环境变量、授权或端口时，先核ConfigStore/配置入口与实际调用链，补用户可见作用层、下次生效时机及迁移规则。
同步专页、总手册、README和CHANGELOG；历史条目保留时间归属，不用新状态重写旧结果。
文档引用文件存在与该文件进入Git/完整源码ZIP是两项检查；新维护页必须进入最终发布清单。
原生API文档只说明平台合同；隐藏API、厂商能力和实际权限按当前代码与明确的设备证据声明。引用官方资料不代表上游认证本分支。
记录测试对象、失败/跳过、增量或缓存复用及未运行范围。源码CI、Host、浏览器、实际APK与手机验收分开；本轮暂停设备验收。
运行源码检查、锁/描述符与许可检查；包/签名与附件摘要由统一交付负责人核对。私钥、用户凭据、设备原日志和截图不作为文档附件上传。

随源码提供的历史说明

历史原字节与可读视图

下列历史文件原本使用CRLF。为符合当前源码的LF规范，其常用文档路径提供仅换行规范化的可读视图；完整原字节另存tools/history，既有Git属性保护原字节，退休材料不参与部署或测试发现。没有补写原验收事实，视图和原件摘要分别记录。

可读视图	原字节	原件SHA-256
releases/v0.2.1-rc.2-build190-20261019.md	原件	`f172ce28b9cbc8933e8ae3bc7ad0f01f39441e3c0e9eecbbcf955b06ea432d37`
releases/v0.2.1-rc.2-build190-fix1-20261019.md	原件	`d34ca245134ce842f404c52fe52060c9255bd31d4ecee2bc7c5966a0017c3c0c`
releases/v0.2.7-build156-20261003.md	原件	`8cc70cb1720736e0f9c7427b6b5399155b1983d4bfe51d755ece02dc0196cd55`
source-updates/20261019-build190-vscreen-port.md	原件	`7a37fa7c1155553d0fa767e629a5a437ccf33fcabb9d0e41b976fe7841890bc4`

当前上榜

284
潜力榜 · 90 天斜率
2281 星 · 136 fork · 星 / 天
潜力 →

近 30 天势头

累计 Star 走势

名次走势

DSH-APP/DSHA