remoteconn-gitea/prototype/README.md

RemoteConn 全功能原型（PLAN 落地版）

已实现能力

• 会话状态机：idle / connecting / auth_pending / connected / reconnecting / disconnected / error。
• 多服务器管理：新增、编辑、删除、全选、搜索、排序、连接测试。
• 认证管理：密码 / 私钥 / 证书三种认证动态表单，凭据以 credentialRef 方式管理。
• 主机指纹策略：严格校验、首次信任、每次手动确认（known_hosts）。
• 终端交互：模拟 SSH 传输层、命令发送、清屏、延迟展示、断线重连。
• Codex 模式编排：cd <目录> -> command -v codex -> codex --sandbox ...。
• 日志体系：
  • 会话日志 SessionLog（状态、耗时、命令标记、错误、延迟采样）。
  • 日志筛选（服务器/状态/日期）与脱敏导出。
• 主题引擎：字体/字号/行高、液态透明度、背景模糊、动效速度、WCAG 对比度提示与自动优化。
• 插件系统 MVP：
  • 插件包导入/导出（JSON）。
  • manifest 校验（id/semver/权限白名单）。
  • 生命周期 onload/onunload。
  • 插件 API（commands/session/storage/ui/logger）。
  • 插件命令渲染到终端页命令条。
  • 单插件错误隔离与熔断计数。

文件说明

• liquid-console.html：四个主窗口（连接、设置、终端、日志）与三个 dialog（Codex、快照、主机指纹）。
• liquid-console.css：液态视觉、弹性布局、会话状态样式、插件与日志界面样式。
• liquid-console.js：完整业务逻辑（状态机、主题、日志、插件运行时、传输抽象）。

使用方式

1. 打开页面：/prototype/liquid-console.html。
2. 默认首页为连接页，选择服务器后点击“连接”。
3. 连接后可在终端页执行命令或启动 Codex。
4. 设置页支持主题、安全策略和插件管理。
5. 日志页支持筛选并导出脱敏文本。

插件包格式

{
  "manifest": {
    "id": "codex-shortcuts",
    "name": "Codex Shortcuts",
    "version": "0.1.0",
    "minAppVersion": "0.1.0",
    "description": "提供常用 Codex 快捷命令",
    "entry": "main.js",
    "style": "styles.css",
    "permissions": ["commands.register", "session.read", "session.write", "ui.notice"]
  },
  "mainJs": "module.exports = { onload(ctx) { ... } }",
  "stylesCss": ".command-chip { ... }"
}

说明

• 当前仓库是可交互原型，传输层使用 MockTransport。
• 已保留 TerminalTransport 抽象接口形态，后续可替换为 iOS Native SSH / WSS Gateway。