外观
说明
定制版和官方版有什么不同
Harness 的核心是官方的：首次运行时从网上下载并缓存在本机，能力更新跟着官方走。定制版在核心之上加了三件事：
| 官方 Harness | 本站定制版 | |
|---|---|---|
| 运行形态 | CLI / 自行部署 | Windows 桌面应用（已签名 .exe，支持应用内更新） |
| 登录与模型 | 自行配置 API | 登录 元流 账号，自动同步已有的密钥、分组与模型；设置里看余额 |
| 界面 | 网页 / 终端 | 桌面窗口 + 右侧工作台（文件树、编辑器、终端、Git）与一组内置插件 |
所以不需要手填 Base URL 和 Key：密钥与分组仍以控制台为准，客户端不会替你新建密钥或分组（见 创建 API 密钥）。
桌面壳的几点行为
- 首次启动：需联网下载官方核心，可能要几分钟；成功后缓存，之后启动很快。
- 关窗 ≠ 退出：点右上角关闭只是把窗口藏进系统托盘，后台服务与会话都还在；想真正退出，在托盘图标右键菜单里选「退出」。
- 数据目录：会话与配置在
~/.yuanliu-harness（Windows 下即C:\Users\你的用户名\.yuanliu-harness）。卸载应用不会删除该目录，彻底清除需手动删除；运行时缓存在系统应用数据目录，另算。 - 更新：应用内可检查更新；也可回 元流 首页 重新下载。
登录与模型
登录后，应用同步你账号下已有的 API 密钥、分组与模型列表，不需要手填 Base URL 或 Key；余额在设置里查看，不足就去控制台「充值/订阅」。
| 入口 | 作用 |
|---|---|
| 左侧栏底部账号入口 | 未登录时显示「未登录」，点它进设置「平台」区登录；已登录时可「刷新模型目录」「退出登录」 |
| 设置 → 平台 区 | 登录表单（邮箱 / 密码 / 记住密码）、余额、已同步的分组与模型数、「刷新模型目录」（本站模型或分组有变更时点它重新同步） |
| 设置 → 模型设置 | 本地启用/禁用、重命名、排序模型与分组；可把多个平台分组合并显示、决定是否显示倍率 |
| 同上 | 可选接入 DeepSeek 官方模型：自行填写官方 Key，凭据存本机凭据库，不经过本站转发 |
选模型建议：先用廉价模型走通流程、确认费用可接受，正式复杂任务再换更强的模型。部分模型有推理强度档位（off / low / medium / high），越高越慢越贵，按任务难度选，不必默认拉满。
还要在 Cursor / Cline / Codex 等第三方客户端里用本站？那是另一条路：单独创建 API 密钥并按应用设置填 Base URL 与 Key，两套用法互不替代。
内置插件
定制版预置了一批常用插件，覆盖工作台、模型设置、预览与安全，省去自行安装时的版本兼容问题：
| 方向 | 插件 | 说明 |
|---|---|---|
| 工作台 | dsh-better-sidebar 及伴随插件 | 文件树、编辑器、真实终端、Git / diff、划选追问、对话大纲、文件拖拽上传、图标主题 |
| 预览 | dsh-better-sidebar-pdf、dsh-latex-preview | PDF、LaTeX 与图片等预览 |
| 模型与设置 | dsh-desktop-model-selection、dsh-desktop-model-settings | 模型选择入口、分组 / 倍率 / 官方 Key 设置（见上节） |
| 网络与安全 | dsh-desktop-network、dsh-safe-download-files | 代理设置；限制下载类型与目标，降低误下可执行文件的风险 |
| 联网搜索 | dsh-free-search | 为 Agent 补充联网检索 |
| 编辑与代码 | dsh-better-edit、dsh-codegraph | 更稳的编辑操作；代码结构索引 |
| 其它 | dsh-sentinel、dsh-workspace-menu、dsh-quilt-compact、dsh-desktop-sidebar-rail | 条件监控、工作区 / 会话菜单、上下文压缩、侧栏布局 |
| Office 桥 | dsh-office-bridge | 操控本机打开的 Word / Excel / PPT（预装并默认启用，详见案例） |
更多插件可在侧栏「插件」面板浏览安装（或 dsh plugin --profile web add <包名>）。安装前看清插件会执行什么，不要装来源不明、命令看不懂的插件。
权限与安全边界
Agent 不是「点哪里改哪里」的软件，行为与所用模型、权限模式都有关。权限上要注意这几点：
- 默认
workspace-write：标准文件工具的写入一般限制在当前工作区内，能挡住「写到盘符根目录」这类误操作。但它不是沙箱虚拟机。 - 读取通常更宽：工作区之外的文件也可能被读到。敏感目录不要和日常工作区混在一起打开。
- Shell 是另一条路：终端命令仍可能影响工作区之外的文件；需要跑命令时写清允许范围，并自己看终端输出。
- 用轨迹排查：怀疑越权或异常时，在轨迹视图里看 Agent 实际调用了哪些工具、作用在哪些路径。
把 Agent 当成「会操作电脑的助手」而不是「绝对听话的工具」：重要项目先 Git / 备份，工作区选小、任务拆开、方向不对就打断。
常见问题
这是 DeepSeek 官方产品吗？
不是。你在本站下载的是 元流 定制桌面客户端：Harness 核心是官方的（首次安装时从网上下载），本站增加了桌面壳、登录、模型同步与内置插件。
数据存在哪里？卸载会删光吗？
用户数据在 ~/.yuanliu-harness，卸载通常不会删除；手动删除该文件夹才会清空（删前确认没有要保留的会话）。
为什么比在线聊天贵很多？
默认 Agent 模式：读文件、改文件、跑命令都带来多轮请求。先用廉价模型试价、把任务拆小。计价见价格说明。
提示 API 密钥无效，或模型列表不对？
按顺序排查：1) 控制台里是否还有可用密钥 / 分组、余额是否正常；2) 客户端重新登录；3) 仍不对时，点左侧栏账号菜单或设置「平台」区的「刷新模型目录」重新同步。客户端不会替你自动新建密钥，创建见 创建 API 密钥。
Agent 会不会改坏我的文件？
有可能。权限边界见上节。实务上：重要项目先 Git / 备份，工作区选小、任务拆开，方向不对就打断。
其它插件怎么装？
内置插件之外的扩展以单独发布的插件形式提供，安装与配置见 案例目录。