本文档目录与根目录 README 共同描述当前项目状态。功能、架构或发布流程变化时，应在同一个变更中同步更新对应文档。
- 项目架构与运维总览：运行链路、目录职责、插件部署、数据位置、安全边界和验证命令。
- 桌面打包与应用内更新手册：macOS/Windows 构建、签名、Release 资产、测试步骤与故障排查。
- 0.3.6 测试版发布说明：Windows 工作区授权、WSL 优化和测试签名说明。
- 0.3.7 测试版发布说明：Windows 内置 MinGit、版本中心与完整 HTML 会话导出。
- 0.3.8 测试版发布说明：DSH rc.7、沙箱幂等授权、Windows 文件名与应用端口兼容修复。
- 0.3.9 测试版发布说明：插件故障安全恢复、附件拖放与云端长上下文兼容修复。
- 0.3.10 测试版发布说明：图片文件回退、右键菜单增强与 Qwen 推理档位适配。
- 0.3.11 测试版发布说明：第三方集成页面槽、云端登录稳定性与模型能力适配。
- 0.3.12 测试版发布说明：第三方集成页面自定义 SVG 图标支持。
- 0.3.13 测试版发布说明：修复安装版 Grep/Glob 的 ripgrep 启动路径并加强原生可执行组件校验。
- 0.3.14 测试版发布说明：扩展 SSH 连接、文件传输与 Agent 工具，并增强安全存储不可用时的登录兼容性。
- 根目录 README：面向使用者和开发者的项目入口及功能说明。
- 贡献指南：代码、测试、原生依赖和文档同步要求。
- 安全策略：漏洞报告、凭据保护和软件更新信任边界。
- 第三方声明：DSH、插件市场、性能预设及 npm 依赖许可。
以下变化必须更新文档：
- 新增或移除 DSH 插件、Electron IPC、权限或网络访问。
- 修改安装器格式、签名方式、更新仓库、缓存位置或 Release 文件名。
- 修改用户数据目录、迁移策略、凭据保存方式或恢复行为。
- 新增平台原生依赖或改变支持的操作系统/CPU 架构。
- 修复只在打包环境出现的问题时，把根因、验证方法和预防检查写入发布手册。
当前文档基线：BOTCF 0.3.14，DeepSeek Harness 0.1.0-rc.7，更新日期 2026-08-20。