Initialize cross-platform workspace host scaffold
Verify / verify (ubuntu-latest, linux-x64) (push) Canceled after 0s
Verify / verify (windows-latest, win-x64) (push) Canceled after 0s

This commit is contained in:
Youmu Liu
2026-09-29 11:30:51 +08:00
commit 4bc3552167
56 changed files with 2627 additions and 0 deletions
+20
View File
@@ -0,0 +1,20 @@
# 仓库开发约定
## 入口
阅读 `docs/overview.md`、`docs/architecture.md` 和涉及的 `docs/platforms/` 文档。当前实现状态以 `docs/implementation-status.md` 为准。
## 实现
- 使用 .NET 10、nullable 和集中包版本管理。
- 通过 `build.ps1` 或 `build.sh` 调用 NUKE;交付前执行 `Verify`。
- 产品项目为 `src/WorkspaceAccessHost.csproj`,代码直接在 `src/` 下通过目录和命名空间区分职责。
- 领域逻辑保持操作系统与传输框架无关;平台调用分别放入 `Platforms/Windows`、`Platforms/Linux`。
- 同一程序通过 `host`、`agent` 参数选择进程角色,按目标平台发布一套产品产物。
- 连接接管、断线及输入派发遵守 host 独占和工作区归属规则。
- 认证、授权、用户映射完成后才可调用连接控制核心。
- 增加真实 PTY、IPC、OIDC 实现时,同步维护 readiness 和状态文档。
## 文档
文档库是面向所有仓库访问者的当前设计说明。使用中文正文和准确的 API 名称;描述目标行为、运行前提、实现状态和验收条件。保持总功能表中的每项平台差异与一份独立说明文档对应。新增页面加入导航,并通过 `CheckDocs`。