first commit

prototype/README.md

@@ -0,0 +1,54 @@
+# 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. 日志页支持筛选并导出脱敏文本。
+
+## 插件包格式
+```json
+{
+  "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。