Skip to content

Docs Index

AceGuru-mjh edited this page Oct 1, 2026 · 4 revisions

深度文档索引

🛠️ 工程化 · 🏠 首页 › Docs-Index

Home Version Kotlin Modules Tools License

Docs-Index

📑 本页目录

Wiki 讲"怎么用 / 怎么改 / 为什么";仓库 docs/ 保存原始设计稿、审计与交付报告。 本页是这 68 篇 markdown 的分类目录(均为仓库内相对路径)。

1. 架构与设计

文档 内容 相关 Wiki
docs/agent-modes.md 六种 Agent 模式详解 Agent 引擎
docs/task-execution-architecture.md 任务执行架构(编排路径) 任务编排器
docs/liquid-glass-system.md Liquid Glass 组件系统:七档材质 / 组件 API / 真实性验收矩阵 Liquid Glass
docs/PERF.md 性能笔记 终端运行时
docs/pipeline-output-optimization.md 流水线输出优化记录 CI 流水线
docs/MIGRATION_REPORT.md 迁移报告 —
docs/PHASE4_DEPRECATION_AND_VERIFICATION.md Phase 4 弃用与验证 —

2. 工具系统

文档 内容
docs/tool-system-v2.md v2:结构化工具契约 / Schema DSL / 风险门控 + 15 个新工具
docs/tool-system-v3.md v3:执行硬化八层(超时/重试/限流/熔断/追踪/批量/组合动作/环境门控)+ 业界对标
docs/feature-request-write-tool-diff-stat.md 写工具 diff 统计的需求提案

3. MCP 生态

文档 内容 相关 Wiki
docs/mcp-sandbox.md 沙箱 MCP(PRoot Ubuntu)使用指南:Issue #163 / #149,三入口、预置清单、npx 冷启动 MCP 生态 §3
docs/reverse-mcp-host.md 逆向 MCP Host 设计文档:Issue #173,协议子集 / 三重安全门 / 局限性 MCP 生态 §5
docs/hub-ecosystem.md Hub 生态:内置瘦身 75→13 + 官方仓库分发 + 斜杠门控 + 市场配置启动闭环 MCP 生态 §4
docs/longtask-resilience-mcpso-context.md 长任务韧性 + mcp.so 社区目录 + 上下文检索增强(PR #249) MCP 生态 · 任务编排器

4. 终端 / PRoot / Ubuntu

文档 内容
docs/terminal-api.md 终端 API 契约
docs/terminal/TERMINAL_SDK_BOUNDARY.md 终端 SDK 边界(为什么 emulator 不能反向依赖 platform)
docs/terminal/TERMUX_CAPABILITY_MATRIX.md 与 Termux 的能力对标矩阵
docs/T82_TERMINAL_CAPABILITY_REPORT.md T82 终端能力报告
docs/ubuntu-lifecycle.md Ubuntu 生命周期编排
docs/ubuntu-rootfs-t72.md T72 Ubuntu rootfs 供给设计
docs/proot-binary-provenance.md PRoot 预编译二进制来源与指纹

5. 记忆系统 cs-mem

文档 内容
docs/memory-and-workflow-research.md 记忆与工作流调研报告:对标 MemGPT/Letta、Mem0、A-MEM、Zep/Graphiti、Voyager、Claude Code、OpenHands、SWE-agent
docs/cs-mem-gaps-spec.md cs-mem 缺口补全规格(含缺口 #9 拓扑迁移)

6. 浏览器自动化

文档 内容
docs/web-browser-automation.md 浏览器智能体总体设计
docs/web-browser-automation-proposal.md 立项提案
docs/web-browser-automation-gap-audit.md 差距审计
docs/web-browser-automation-final.md 最终方案
docs/web-browser-chrome.md Chrome 风 UI 与 bridge 设计

7. UI 审计

文档 内容
docs/agent-ui-audit.md Agent UI 审计
docs/ui-quality-audit-2026-08-27.md UI 质量审计(2026-08-27)

8. 审计 / 混沌工程 / 测试

文档 内容
docs/TESTING.md 单一权威测试文档:理念 / 矩阵 / 替身规范 / FAQ / 测试文件清单(撰写时 74,主干现已 252,清单待同步)
docs/chaos-engineering-review.md 混沌工程评审
docs/CHAOS_AUDIT_2026-09.md 混沌审计报告(2026-09)

9. 任务交付报告(T7x 系列)

文档 内容
docs/T76_ADR.md T76 架构决策记录(ADR)
docs/T76_ARCHITECTURE_AUDIT.md T76 架构审计
docs/T76_FINAL_REPORT.md T76 最终交付报告
docs/pr-t76.md T76 PR 描述
docs/pr-body.md PR 模板/正文
docs/T81_ARCHITECTURE_ASSESSMENT.md T81 架构评估
docs/T81_FINAL_REPORT.md T81 最终报告
docs/T82_FINAL_REPORT.md T82 最终报告

10. 资源

文件 用途
docs/assets/banner.svg README / Wiki 顶部横幅
docs/assets/viro-pet-preview.gif 预览动图

Tip

想查某个特性"当初为什么这样做",先看这里的 ADR / 交付报告; 想知道"现在该怎么写",看 Wiki;两份不一致时以代码为准,欢迎提 Issue 修正 Wiki。


🎨 本 Wiki 用到的开源视觉 / 动画服务

效果 服务 用在哪
波浪动画横幅(页首 / 页脚) capsule-render 首页 + 全部 58 页的头部与页脚分割线
打字机动画文字 readme-typing-svg 首页 + 17 个重点页的副标题
技术栈图标条 skillicons 首页技术栈区
提交连续打卡统计 github-readme-streak-stats 首页底部
徽章 shields.io 全站
架构 / 时序 / 状态机图 Mermaid(GitHub 原生渲染) 各页图示
Star 增长曲线 star-history 首页底部
动效预览 GIF 仓库内置 docs/assets/viro-pet-preview.gif 首页"动效预览"

Note

这些服务都是纯图片渲染(SVG / GIF),不引入脚本,因此在 GitHub Wiki 的 严格 HTML 清洗下依然能正常显示与动画。

footer

🏠 返回首页 · 📚 文档索引 · ❓ FAQ · 🔧 故障排查 · 🗺️ 路线图 · 🐛 提 Issue

Android Guru Agent · v1.4.4 · Kotlin 2.0.21 · Compose · PRoot · Room

Clone this wiki locally