101 lines
5.1 KiB
HTML
101 lines
5.1 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="zh-CN">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>维护优化 — Global Control Assistant</title>
|
||
<link rel="stylesheet" href="../style.css">
|
||
</head>
|
||
<body>
|
||
<div class="topbar">
|
||
<a href="../index.html">首页</a><span class="sep">/</span>
|
||
<a href="../architecture/index.html">架构</a><span class="sep">/</span>
|
||
<span class="current">维护优化</span>
|
||
</div>
|
||
|
||
<div class="container">
|
||
<h1>项目维护优化清单</h1>
|
||
<p class="subtitle">从项目维护角度审视架构、流程和技术债务</p>
|
||
|
||
<div class="summary-bar">
|
||
<div class="s-item"><div class="num" style="color:var(--green)">1</div><div class="label">已解决</div></div>
|
||
<div class="s-item"><div class="num" style="color:var(--red)">3</div><div class="label">必须做</div></div>
|
||
<div class="s-item"><div class="num" style="color:var(--orange)">3</div><div class="label">强烈建议</div></div>
|
||
<div class="s-item"><div class="num" style="color:var(--accent)">2</div><div class="label">锦上添花</div></div>
|
||
</div>
|
||
|
||
<div class="section">
|
||
<h2><span class="dot" style="background:var(--green)"></span> 已解决</h2>
|
||
<div class="issue-grid">
|
||
<div class="issue">
|
||
<h4><span class="tag t-green">已解决</span> API 数量精简</h4>
|
||
<p>从最初 180+ API 精简到 36 个 MCP Tool，用 exec 兜底低频操作。JSON Schema 自动校验。</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="section">
|
||
<h2><span class="dot" style="background:var(--red)"></span> 必须做</h2>
|
||
<div class="issue-grid">
|
||
<div class="issue">
|
||
<h4><span class="tag t-red">P0</span> 跨平台 UI 自动化</h4>
|
||
<p>AI 应用操控需要 Accessibility API：Windows (UIAutomation)、Linux (AT-SPI2)、macOS (AX API)。三套 API，每个平台独立实现。</p>
|
||
<div class="fix"><strong>方案：</strong>① 定义 UIAdapter 接口，每平台一个实现；② Phase 1 只做 Windows；③ 优先用浏览器自动化（Playwright 跨平台一致）。</div>
|
||
</div>
|
||
<div class="issue">
|
||
<h4><span class="tag t-red">P0</span> 缺少测试策略</h4>
|
||
<p>36 MCP Tool × 多平台 × 多设备接入方式 = 测试矩阵。</p>
|
||
<div class="fix"><strong>方案：</strong>① 单元测试：每个 tool handler 独立测试；② 集成测试：客户端 MCP Server ↔ Gateway；③ E2E 测试：Telegram → AI → MCP Tool → 执行；④ CI：GitHub Actions。</div>
|
||
</div>
|
||
<div class="issue">
|
||
<h4><span class="tag t-red">P0</span> 无错误恢复策略</h4>
|
||
<p>网络断开、Gateway 重启、设备休眠。远程场景下错误是常态。</p>
|
||
<div class="fix"><strong>方案：</strong>① WS 自动重连（指数退避）；② 请求超时 + 重试；③ 幂等性设计（idempotency key）。</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="section">
|
||
<h2><span class="dot" style="background:var(--orange)"></span> 强烈建议</h2>
|
||
<div class="issue-grid">
|
||
<div class="issue">
|
||
<h4><span class="tag t-orange">P1</span> 无日志与可观测性</h4>
|
||
<p>远程设备出问题时没有日志无法排查。</p>
|
||
<div class="fix"><strong>方案：</strong>① 结构化日志（pino/winston）；② 日志通过 WS 上报到 Gateway 集中查看；③ 健康心跳（30s 上报 CPU/内存/磁盘）。</div>
|
||
</div>
|
||
<div class="issue">
|
||
<h4><span class="tag t-orange">P1</span> 无配置管理方案</h4>
|
||
<p>客户端需要配置（Gateway 地址、token、代理、服务开关）。</p>
|
||
<div class="fix"><strong>方案：</strong>① 本地 JSON 配置 + 系统 keychain 存凭据；② Gateway 可远程推送配置；③ JSON Schema 校验。</div>
|
||
</div>
|
||
<div class="issue">
|
||
<h4><span class="tag t-orange">P1</span> 无自动化构建发布</h4>
|
||
<p>客户端要打包成 Windows .exe / Linux .deb / Android APK。手动打包耗时易错。</p>
|
||
<div class="fix"><strong>方案：</strong>① GitHub Actions CI；② tag push 自动构建所有平台；③ 自动更新机制（Tauri updater / Expo OTA）。</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="section">
|
||
<h2><span class="dot" style="background:var(--accent)"></span> 锦上添花</h2>
|
||
<div class="issue-grid">
|
||
<div class="issue">
|
||
<h4><span class="tag t-blue">P2</span> 文档迁移</h4>
|
||
<p>当前手写 HTML，改一个样式要改多处。迁移到 VitePress 可用 Markdown 写内容。</p>
|
||
</div>
|
||
<div class="issue">
|
||
<h4><span class="tag t-blue">P2</span> 性能监控仪表盘</h4>
|
||
<p>多设备运行后需要统一视图查看所有设备健康状态。</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<footer>
|
||
<a href="../index.html">首页</a> | <a href="../architecture/index.html">架构</a> | <a href="../security/index.html">安全</a> | <a href="../optimization/index.html">优化方案</a>
|
||
<br><br>
|
||
Global Control Assistant © 2026
|
||
</footer>
|
||
</body>
|
||
</html>
|