WorkspaceAccessHost/AGENTS.md

仓库开发约定

入口

阅读 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。