使用手册 / 第 01 章
开发
以下操作在桌面应用中完成。只管理自己的开发环境,或在明确授权的环境中排查问题。
Hosts:为本机设置域名映射
- 打开「开发 → Hosts」。先在「系统」查看实际生效文件;这是只读预览。要新增映射,在左侧新建或选择分组,填入 IP、主机名和备注。
- 启用该分组及所需记录,点「保存」。若需要管理员权限,在 macOS 输入管理员密码,或在 Windows 确认系统 UAC 提示。
- 保存成功后回「系统」核对实际文件,或在「域名解析核对」中对比本机解析和公网 DNS。公网查询会通过 DoH 发送域名,不要把不宜外发的内部域名提交给公网解析服务。
常规保存只更新 Dockyard 管理的部分,并对相同的 IP 与主机名去重。复制外部记录不会移除原行;选择「移入分组并接管」并保存,才会移除原行,将它交给分组控制。出现外部冲突时先核对系统文件,避免与其他编辑器同时保存。
删除分组确认后会立即写入系统 hosts。 改动前可在「备份」中创建分组备份;导入备份只恢复草稿,仍需「保存」才能写回系统。
开发环境:安装和切换工具版本
打开「开发 → 开发环境」。在「语言与运行时」查看 Python、Go、Rust、Java、Node.js、Bun、Deno、Zig、.NET SDK、Dart、Flutter 和 PHP;「包管理与构建工具」包含 CMake、Ninja。查看已经检测到的版本、来源和可执行文件路径,不需要先安装 mise。
- 选择工具,点「安装版本」。缺少受管 mise 时,先阅读联网安装提示并确认;组件装好后再次点「安装版本」。
- 搜索并选择具体版本,查看安装结果。可保留多份版本;通过 mise 安装后,应用会尝试启用该版本并配置终端。如果版本已装好但启用失败,可用「启用版本」重试。
- 重开终端,在实际项目目录验证所用版本。项目配置可以覆盖全局默认;页面上的「当前 PATH」只反映 Dockyard 进程,不能代替终端核对。
点具体版本可查看相应的依赖详情,功能随工具而异。例如 Python 安装包需要该解释器已有 pip;Bun 和 .NET 的全局包或工具可能与其他项目共用。取消安装不回滚已经完成的改动,卸载共享版本前先检查依赖它的项目。
平台限制:可安装版本取决于平台、架构和上游。外部终端集成面向 macOS 的 zsh/bash 和 Windows PowerShell;此处不支持在 Windows 安装 PHP 或在 Windows ARM64 原生安装 Flutter。Flutter 的移动端开发还需配置相应平台 SDK,CMake 和 Ninja 不附带编译器。
Node.js:选择运行时和管理 npm 全局包
- 在「开发环境」选择 Node.js,点「安装版本」。首次安装可用推荐的 mise;也可以选自带 npm 的「官方发行包」,它不需要 mise,但不会自动接管终端的默认 Node.js。
- 点击要管理的版本号,核对 Node.js 和 npm 的路径,再选择或测速 npm 源。需要下载包时,先确认所选源可访问且可信。
- 在该版本的全局依赖中搜索并安装包,或检查更新、逐项或批量更新和卸载。完成后在同一详情页核对包列表,不要把全局包操作误当成修改项目的依赖文件。
外部安装没有通用的「设为默认」按钮;仅对可核实且支持卸载的安装提供卸载,不能从这里卸载系统 Node.js。卸载前核对实际路径和正在使用该版本的工具。
配套组件:按需安装,不必装全
打开「开发 → 配套组件」,核对组件用途、平台支持和安装状态,再按需安装或检查更新。若列表仅显示已安装项,可在模块设置中切到全部组件。首次下载需要联网确认;完成后回原功能重试。
例如 mise 用于版本管理,MongoDB Shell 用于执行脚本,Docker 凭据助手用于补充私有仓库认证支持。它们不提供 MongoDB 服务端或 Docker 引擎。删除受管组件后,依赖它的功能可能需要重新安装组件;删除 mise 不等于卸载已装的运行时。
环境变量:区分应用、系统与进程的值
- 打开「开发 → 环境变量」。在「应用」中搜索 Dockyard 当前读取到的值,或在「系统」分别查看整机和当前用户的配置。展开
PATH等列表可以逐项核对。 - 要判断运行中的进程是否继承了某个值,选中变量后打开「查看包含该变量的进程」。结果是一次快照,只显示变量是否存在、是否与选中值相同,不显示目标进程中的原始值。
此页只读;系统配置不一定等于某个 Shell 的有效环境。检测到变量也不表示程序实际使用了它,权限不足时则可能查不到。敏感值默认遮罩,显示或复制前注意屏幕共享和剪贴板。
代码仓库:核对差异、提交与推送
- 打开「开发 → 代码仓库」,添加已有的本地 Git 仓库。若检测不到 Git,按页面指引安装系统 Git,再点「重新检测」,必要时重启应用。
- 选择仓库,浏览提交图谱、分支、文件或历史差异。在更改抽屉区分工作区、未跟踪项与暂存区,检查差异后暂存要提交的文件;暂存选错时可取消暂存。
- 填写说明并选择「提交已暂存更改」或「提交并推送」。后者需要当前分支已有上游并通过远端认证。推送失败时提交仍在本地,解决问题后用「重试推送」,不要重复提交。
「撤回修改」会用暂存区版本覆盖已跟踪文件的工作区内容。 未暂存的改动不能从此界面恢复;它不删除未跟踪文件,也不清除暂存改动。列表中的「移除」只取消仓库登记。AI 起草提交说明会把已暂存差异发给配置的模型;发送前检查敏感内容,生成后再审阅并手动提交。
Docker:拉取镜像、启动容器和检查日志
先安装 Docker CLI 并启动可连接的引擎,例如 Docker Desktop。打开「开发 → Docker」,核对 CLI 的当前上下文;它可能指向远程 Docker 主机。操作前确认这个目标是你有权管理的环境。
- 在「镜像」点「拉取镜像」,选择来源并搜索,或填写完整镜像名和标签。私有仓库沿用 Docker 登录凭据;按提示检查凭据助手。所选来源不会修改 Docker 的全局镜像加速配置。
- 在本地镜像行点「启动」,按需设置名称、端口和环境变量;未覆盖的选项沿用镜像默认值。发布的端口绑定 Docker 主机的
127.0.0.1,宿主端口留空可自动分配。远程上下文中的回环地址不是当前电脑。 - 到「容器」核对状态和端口,打开「日志」或「配置」排查启动问题。没有看到成功结果时先刷新列表,不要直接重复创建。可对选中容器启停、重启或暂停/恢复;运行中容器还可在「文件」浏览和传输文件。
容器终端目前支持 macOS/Linux,且镜像内必须有可用的 Shell。上传同名文件可能覆盖容器内的现有文件。
清理前先备份。 删除运行中容器会强制停止它并删除容器可写层,不会同时删除数据卷。「清理已停止的容器」作用于当前上下文中的全部已停止容器;清理悬空镜像和构建缓存是独立操作。删除数据卷会永久丢失卷内数据,仍被容器引用的卷不能删除。
本机终端:在本机运行命令和浏览文件
- 打开「连接 → 终端连接 → 本机终端」。Shell 默认在用户主目录启动;命令在本机以当前用户身份运行,不需要 SSH。
- 右侧文件区可输入路径、逐级浏览或只读预览。可读到 Shell 的工作目录时可启用「跟随终端」;无法跟随时可手动输入路径。文本和图片的预览上限分别为 2 MiB 和 20 MiB。
Windows 需要 Windows 10 1809 或更新版本,使用系统 Windows PowerShell,无需 PowerShell 7;目录请手动浏览。目录跟随不适用于 SSH 远端或 tmux 窗格。
「新建终端」「重启终端」「在终端中打开」会替换当前会话,不是另开标签。 先保存工作并处理正在运行的任务。普通页面切换不结束会话,但应用退出会关闭它。若要连接远端,请查看 SSH 与 SFTP。