开发文档

本节是 Cosmosh 工程实现与治理规范的事实来源。

推荐阅读顺序

flowchart TD
  A[项目地图] --> B[架构设计]
  B --> C[IPC 协议字典]
  B --> D[SSH 终端实现]
  B --> H[本地优先审计事件]
  B --> G[数据库安全]
  B --> E[SFTP 文件系统]
  B --> I[SSH 端口转发]
  B --> F[UI/UX 规范]

文档分区

• 核心
  • 项目地图
  • 架构设计
  • IPC 协议字典
• 运行时能力
  • SSH 终端实现
  • 本地优先审计事件
  • 数据库安全
  • SFTP 文件系统
  • SSH 端口转发
• 设计与治理
  • UI/UX 规范

任务导向入口

• 新增运行时能力：先看项目地图，再看架构设计，最后同步IPC 协议字典。
• 调整 SSH 行为：优先阅读SSH 终端实现，并同步协议说明到IPC 协议字典。
• 调整 SSH 端口转发：优先阅读SSH 端口转发，再在IPC 协议字典核对 IPC 覆盖。
• 排查安全敏感操作链路：优先阅读本地优先审计事件，并在IPC 协议字典核对桥接覆盖。
• 排查数据库加密启动问题：优先阅读数据库安全，再结合架构设计核对进程职责。
• 调整界面交互：先遵循UI/UX 规范，再落地页面样式变更。

治理参考

• 文档治理与撰写规范集中维护在 docs/README.md 与仓库根目录 AGENTS.md。