快速开始

从下载安装到第一次对话——五分钟跑通 ChengYoung。

1. 下载并安装

• 打开 chengyoung.com，点击「免费下载」，得到安装包 ChengYoung_<版本>_x64-setup.exe。
• 校验完整性（推荐）：下载同一发布页的 SHA256SUMS.txt，在 PowerShell 中执行：

Get-FileHash .\ChengYoung_1.13.0_x64-setup.exe -Algorithm SHA256

将输出与 SHA256SUMS.txt 中对应行比对，一致即可安装。

• 双击安装包完成安装（当前用户安装，无需管理员权限）；安装完成后应用自动启动。
• 更新：应用内「设置 → 更新」可检查并一键安装新版本；若手动运行新安装包，请先完全退出应用（含系统托盘图标）。

2. 首次启动：选择模型

ChengYoung 支持两类模型，可随时切换：

• 本地模型（推荐起点，可完全离线）：内置 llama.cpp 推理引擎，支持 Vulkan GPU 加速。首次选择模型时会按需从 Hugging Face 与 ModelScope（魔搭）双下载源获取模型文件——国内网络选择 ModelScope 通常更快；模型只下载到你的电脑，使用过程不需要联网。
• 你自己的云提供商：在设置中填入 API Key 即可接入云端模型。Key 只保存在操作系统密钥链中，不上传、不写入配置文件明文。

3. 第一次对话

1. 在输入框下方选择工作目录——Agent 将在该目录内读写文件、执行命令；「拖入文件即可读取」。

1. 输入你的任务，例如「帮我看看这个项目的结构，总结每个模块的作用」。Agent 会自主调用工具（读文件、搜索、执行命令等）完成任务。

1. 每次工具调用都会请求你的批准：允许 / 询问 / 拒绝三态由你掌控（默认询问），也可以在设置中按工具逐项调整。

1. 输入框上方的起手卡片（探索代码库 / 总结 / 审查 / README）点击后只填充输入框，你可以先编辑再发送。

4. 下一步

• 提示文件：在项目根目录创建 .cyhints（兼容旧名 .goosehints 与 AGENTS.md），写下项目约定与偏好——每次会话自动生效。
• 工作流：把可重复的多步任务保存为一键运行的工作流；技能：让 Agent 按领域知识行事；调度：定时自动执行任务。
• 扩展（MCP）：接入文件系统、浏览器、数据库等更多工具；安装扩展需要你显式同意。
• 右栏工作区：内嵌浏览器（第三方网页隔离运行，Agent 控制默认关闭）、扩展与会话能力都在这里。

关于隐私

ChengYoung 零采集：产物内不含遥测代码；对话、文件与模型文件都保存在本机。数据只在你明确配置的模型提供商场景下按需发送（详见「隐私与数据」文档）。

本页基于上游开源文档（Apache-2.0）改写，已修改；来源与变更见 /legal/provenance。