Windows 上的 AI Agent 客户端
ChengApp 是 ChengOS 平台的 Windows 桌面客户端，用 Tauri 2 与 Rust 构建。本页只描述可以从源码或测试验证的行为，以及它们成立的条件。
本地工作区与单实例交接
客户端以工作区为单位组织文件与会话。重复打开应用不会创建第二个窗口，而是唤起已有窗口，并把本次启动携带的目录交给当前工作区。这让“在资源管理器里对着目录打开”成为一个可预期的动作。
工作区路径边界
工作区路径校验覆盖 Windows 上常见的路径逃逸入口：junction 规范化、\\?\ 形式的路径比较、备用数据流（ADS），以及 CON、NUL、COM1、LPT1 等保留设备名的拒绝。这是路径层面的校验，不等同于完整的沙箱或安全认证，也不替代系统权限控制。
凭据与模型的边界
凭据集中保存在保管库中，模型只能拿到凭据句柄来调用工具，API Key 的明文不会进入模型上下文。需要注意的是，用户自己粘贴进对话的内容不受此约束。
系统要求
Windows 10 1809 及以上或 Windows 11，64 位。客户端依赖系统的 WebView2 运行时；安装程序对 WebView2 的检测与引导方式仍在确认中，在确认前我们不把它作为卖点描述。
常见问题
- ChengApp 和 ChengOS 是什么关系？
- ChengOS 是工作流与 Agent 平台，负责编排与执行；ChengApp 是它在 Windows 与 Android 上的客户端。你可以只用客户端连接他人部署的 ChengOS，也可以自己部署一套。
- 有 macOS 版本吗？
- 暂时没有。macOS 只出现在路线图中，当前发布清单里没有 macOS 安装包，我们也不把它写成已支持平台。
本页主张的依据
最后核验:
- 重复打开应用时会回到已有窗口，并可将本次启动携带的目录交给当前工作区。
- 适用范围: Windows 桌面客户端。
- 依据: chengapp/src-tauri — tauri-plugin-single-instance，chengapp://launch-path 事件 ·
- 工作区路径校验覆盖 Windows junction、备用数据流与保留设备名等路径边界。
- 适用范围: 覆盖 junction 规范化、\\?\ 路径比较、ADS 与 CON/NUL/COM1/LPT1 设备名拒绝；不等同于完整安全认证。
- 依据: chengapp Windows 路径校验测试 ·
- 模型只能通过凭据句柄调用工具，API Key 明文不进入模型上下文。
- 适用范围: 凭据保管库与工具调用路径；不涵盖用户自行粘贴到对话中的内容。
- 依据: ChengOS Credential Vault 与工具调用实现 ·
- 当前提供 Windows 与 Android 客户端；macOS 仅在路线图中，无 iOS 目标。
- 适用范围: 以发布清单 lib/config/release-manifest.json 为准。
- 依据: lib/config/release-manifest.json ·