Skip to content

Latest commit

 

History

History
49 lines (35 loc) · 4.45 KB

README.md

File metadata and controls

49 lines (35 loc) · 4.45 KB

KeyPort 文档导航

当前正式运行入口、工作区与迁移边界请先阅读 README 和 Issue #105 验收。下列文档保留历史设计与阶段证据,不表示旧入口仍在运行。

本期产品范围与整合规划

  • 统一 SSH 连接策略实施方案:2026-09-15 基于当前正式入口核查的恢复方案;统一别名、多地址策略、OpenSSH 执行、信任映射、迁移同步与阶段验收。待实施。

  • 一期产品边界与功能整合规划:2026-09-11 确认的管理应用、本机 OpenSSH、辅助脚本边界;删除/合并/下沉清单、优化优先级、分期与验收标准。属于规划,尚未实施功能整合。

  • 本期产品范围优先阅读上述规划;下文网络拓扑及协议扩展文档仍提供领域与历史设计依据,既有安全和迁移契约继续有效。

Graph 改版提案

以下文档定义 Issue #26 的目标方向:

  1. 领域词汇:统一 Node、节点角色、工作区设备档案、Endpoint、SSH 账户、服务、授权和本地观测。
  2. 网络拓扑领域模型重构设计:定义全量重构的 Node/Role/Profile/Endpoint 边界、SSH 第一阶段和 VPN/RDP/服务扩展位置。
  3. ADR 0002:统一 Node 身份并分离访问事实:记录 Host/Device 合并为统一机器身份、访问事实保持独立的架构决策。
  4. Graph 拓扑与跨设备授权架构:记录当前 Host v6 Graph 投影、接入/授权流程、多设备场景和 iCloud 边界;实体边界重构时以新领域模型为准。
  5. 整体重构与迁移计划:记录当前 Host v6 写权切换、旧 UI 删除门槛和实施阶段;后续实现阶段需按新领域模型调整。
  6. ADR 0001:Graph 是 Host v6 访问事实的投影:记录不创建第二套 Graph 事实源的历史决策。

新的领域模型文档既是全量重构的设计基线,也是当前 V1 实现基线。默认 Graph 已从 topology-v1.json 的统一快照投影;Graph 架构和整体重构计划中的 Host v6 实体关系只保留为迁移、Cloud、SSH 和恢复适配器的历史证据,不应继续作为新实体的设计依据。涉及安全、同步、迁移和隧道的既有契约仍需在代码重构时逐项迁移和验证。

当前承重架构与实现证据

产品与技术基线

阅读顺序

  • 想理解本期方向:一期产品边界与功能整合规划 → 领域词汇 → 网络拓扑领域模型重构设计 → ADR 0002 → Graph 架构 → 整体重构计划。
  • 想实现 Graph:先读 JODER-10 第 5-10 节,再读 Graph 架构第 3-10 节。
  • 想改接入或免密流程:先读 APP Review 第 4、10、11 节,再读整体计划第 5、7、8 节。
  • 想改同步或数据模型:先读网络拓扑领域模型重构设计,再以 JODER-10 和当前 Host v6 代码核对迁移契约;Graph 文档只定义投影和 UI 消费方式。
  • 想了解当前运行版本:读根 README、APP Review 和一期实现架构说明。