e6937e1e5f
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
CI / Unit Tests (push) Has been cancelled
CI / Build Frontend (push) Has been cancelled
CI / Rust Check (push) Has been cancelled
CI / Security Scan (push) Has been cancelled
CI / E2E Tests (push) Has been cancelled
Deliverable 3 — Cold Start Flow: - New: use-cold-start.ts — cold start detection + greeting management - Default Chinese greeting for hospital admin users - Phase tracking: idle → greeting_sent → waiting_response → completed Deliverable 4 — Simple Mode UI: - New: uiModeStore.ts — 'simple'|'professional' mode with localStorage - New: SimpleTopBar.tsx — minimal top bar with mode toggle - Modified: App.tsx — dual layout rendering based on UI mode - Modified: ChatArea.tsx — compact prop hides advanced controls - Default: 'simple' mode for zero-barrier first experience Deliverable 5 — Tauri Bridge Integration Tests: - New: tauri-bridge.integration.test.ts — 14 test cases - Covers: cold start, chat flow, persistence, memory, butler, UI mode, e2e - 14/14 passing Deliverable 6 — Release Documentation: - New: installation-guide.md — user-facing install guide (Chinese, no jargon) - New: hospital-deployment.md — IT admin deployment guide (Docker, GPO, SCCM)
282 lines
8.9 KiB
Markdown
282 lines
8.9 KiB
Markdown
# ZCLAW 安装与使用指南
|
||
|
||
**面向用户：医院行政管理人员**
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
1. [开始之前：你需要准备什么](#1-开始之前你需要准备什么)
|
||
2. [第一步：下载安装包](#2-第一步下载安装包)
|
||
3. [第二步：安装 ZCLAW](#3-第二步安装-zclaw)
|
||
4. [第三步：首次启动](#4-第三步首次启动)
|
||
5. [第四步：开始使用](#5-第四步开始使用)
|
||
6. [遇到问题怎么办](#6-遇到问题怎么办)
|
||
7. [日常使用小贴士](#7-日常使用小贴士)
|
||
|
||
---
|
||
|
||
## 1. 开始之前：你需要准备什么
|
||
|
||
在安装 ZCLAW 之前，请确认你的电脑满足以下条件：
|
||
|
||
| 条件 | 具体要求 | 如何检查 |
|
||
|------|---------|---------|
|
||
| 操作系统 | Windows 10 或 Windows 11 | 点"开始"按钮，点"设置"，点"系统"，看"关于" |
|
||
| 网络连接 | 需要连接互联网 | 打开浏览器，随便访问一个网站看能不能打开 |
|
||
| 磁盘空间 | 至少 1 GB 剩余空间 | 打开"此电脑"，看 C 盘剩余空间 |
|
||
|
||
**不需要的东西：**
|
||
|
||
- 不需要任何编程知识
|
||
- 不需要安装其他软件
|
||
- 不需要管理员账号（普通用户即可）
|
||
|
||
> **提示：** 如果你不确定自己的电脑是否符合要求，请联系医院的 IT 部门，他们会帮你检查。
|
||
|
||
---
|
||
|
||
## 2. 第一步：下载安装包
|
||
|
||
### 2.1 获取安装包
|
||
|
||
安装包通常由医院的 IT 部门提供，获取方式：
|
||
|
||
- IT 部门通过内部共享文件夹分发
|
||
- IT 部门通过 U 盘拷贝到你的电脑
|
||
- 通过医院内部下载链接下载
|
||
|
||
安装包的文件名类似：`ZCLAW-Setup-0.x.x-x64.exe`
|
||
|
||
### 2.2 保存位置
|
||
|
||
建议将安装包保存到"桌面"或"下载"文件夹，方便找到。
|
||
|
||
---
|
||
|
||
## 3. 第二步：安装 ZCLAW
|
||
|
||
### 3.1 开始安装
|
||
|
||
1. **找到安装包** -- 在桌面或"下载"文件夹中，找到 `ZCLAW-Setup` 开头的文件。
|
||
2. **双击文件** -- 用鼠标左键快速点两下这个文件。
|
||
3. **如果弹出"是否允许此应用对设备进行更改"的窗口** -- 点"是"。
|
||
|
||
### 3.2 安装向导
|
||
|
||
安装程序会弹出引导窗口，按照以下步骤操作：
|
||
|
||
| 步骤 | 窗口显示内容 | 你要做的 |
|
||
|------|------------|---------|
|
||
| 1 | 欢迎界面 | 点"下一步" |
|
||
| 2 | 选择安装位置 | 不需要改动，直接点"下一步" |
|
||
| 3 | 创建桌面快捷方式 | 保持勾选，点"下一步" |
|
||
| 4 | 开始安装 | 点"安装" |
|
||
| 5 | 安装完成 | 保持勾选"启动 ZCLAW"，点"完成" |
|
||
|
||
> **注意：** 安装过程大约需要 1-3 分钟，取决于电脑速度。期间请不要关闭安装窗口。
|
||
|
||
### 3.3 安装完成后的确认
|
||
|
||
安装完成后，桌面上会出现一个 ZCLAW 的图标。同时，"开始"菜单中也会出现 ZCLAW 的快捷方式。
|
||
|
||
---
|
||
|
||
## 4. 第三步：首次启动
|
||
|
||
### 4.1 打开 ZCLAW
|
||
|
||
- **方法一**：双击桌面上的 ZCLAW 图标
|
||
- **方法二**：点击"开始"菜单，找到 ZCLAW，点击打开
|
||
|
||
### 4.2 启动后的界面
|
||
|
||
ZCLAW 启动后，你会看到以下内容：
|
||
|
||
1. **一个简洁的聊天窗口** -- 屏幕中央是一个对话区域
|
||
2. **底部的输入框** -- 这是用来输入问题的地方
|
||
3. **管家的问候** -- ZCLAW 的 AI 管家会自动向你打招呼
|
||
|
||
### 4.3 模型配置（重要）
|
||
|
||
首次使用时，ZCLAW 需要配置 AI 模型。这通常由 IT 部门预先完成。如果你看到提示"请先配置模型"，请联系 IT 部门。
|
||
|
||
如果你需要自行配置：
|
||
|
||
1. 点击左下角的"设置"按钮（齿轮图标）
|
||
2. 点击"模型与 API"
|
||
3. 点击"添加自定义模型"
|
||
4. 填入 IT 部门提供的信息：
|
||
- **服务商**：如"智谱 GLM"、"通义千问"、"DeepSeek"等
|
||
- **模型 ID**：IT 部门提供的一串字母，如 `glm-4-flash`
|
||
- **API Key**：IT 部门提供的一串密码
|
||
5. 点击"设为默认"
|
||
6. 返回聊天界面
|
||
|
||
> **提示：** 如果你看不懂这些设置项，没关系，这不是必须由你完成的。请联系 IT 部门帮你配置。
|
||
|
||
---
|
||
|
||
## 5. 第四步：开始使用
|
||
|
||
### 5.1 提问
|
||
|
||
1. 点击屏幕底部的输入框
|
||
2. 用键盘输入你想问的问题，例如：
|
||
- "帮我写一份会议纪要"
|
||
- "总结一下这份文件的重点"
|
||
- "帮我起草一封通知邮件"
|
||
3. 按键盘上的 `Enter` 键（回车键），或点击"发送"按钮
|
||
|
||
### 5.2 查看回复
|
||
|
||
- ZCLAW 会逐字显示回复内容，就像有人在实时打字
|
||
- 等回复完全显示后，你可以继续追问
|
||
|
||
### 5.3 开启新对话
|
||
|
||
当你想聊一个全新的话题时：
|
||
|
||
1. 点击左上角或界面中的"开始新对话"按钮
|
||
2. 新的对话区域会清空，你可以开始新的提问
|
||
|
||
### 5.4 常用操作速查
|
||
|
||
| 想做什么 | 怎么操作 |
|
||
|---------|---------|
|
||
| 发送消息 | 输入文字后按回车键 |
|
||
| 换行（不发送） | 同时按 `Shift` 和 `Enter` |
|
||
| 开始新对话 | 点击"开始新对话"按钮 |
|
||
| 查看 AI 的回答 | 等待文字自动显示在对话区域 |
|
||
| 关闭窗口 | 点击右上角的 X 按钮 |
|
||
|
||
---
|
||
|
||
## 6. 遇到问题怎么办
|
||
|
||
### 6.1 安装失败
|
||
|
||
**现象：** 双击安装包后没有反应，或者弹出错误提示。
|
||
|
||
**解决办法：**
|
||
|
||
1. 右键点击安装包，选择"以管理员身份运行"
|
||
2. 如果还是不行，检查电脑是否有杀毒软件拦截了安装：
|
||
- 查看 Windows 屏幕右下角的杀毒软件图标
|
||
- 如果有拦截提示，选择"允许"或"信任"
|
||
3. 联系 IT 部门协助安装
|
||
|
||
### 6.2 打不开（双击没反应）
|
||
|
||
**现象：** 双击桌面图标后，ZCLAW 窗口没有出现。
|
||
|
||
**解决办法：**
|
||
|
||
1. 等待 10-15 秒，ZCLAW 启动可能需要一些时间
|
||
2. 检查屏幕底部的任务栏，看看 ZCLAW 图标是否已经在那里
|
||
3. 如果任务栏有图标，点击它即可打开窗口
|
||
4. 如果完全没反应，尝试重启电脑后再试
|
||
5. 如果重启后仍无法打开，联系 IT 部门
|
||
|
||
### 6.3 网络连接问题
|
||
|
||
**现象：** ZCLAW 打开了，但发送消息后没有回复，或者提示"连接失败"。
|
||
|
||
**解决办法：**
|
||
|
||
1. 检查电脑是否联网：打开浏览器，尝试访问任意网站
|
||
2. 如果浏览器也无法上网，说明是电脑网络问题，联系 IT 部门
|
||
3. 如果浏览器能上网但 ZCLAW 无法使用：
|
||
- 可能是医院防火墙限制了 ZCLAW 的网络访问
|
||
- 联系 IT 部门，请他们在防火墙中放行 ZCLAW
|
||
|
||
### 6.4 AI 不回复或回复很慢
|
||
|
||
**现象：** 发送消息后，长时间没有回复。
|
||
|
||
**解决办法：**
|
||
|
||
1. 等待 30 秒，复杂问题可能需要较长的思考时间
|
||
2. 如果超过 1 分钟没有回复，点击"开始新对话"重新开始
|
||
3. 尝试缩短你的问题，分多次提问
|
||
4. 如果持续无回复，联系 IT 部门检查模型配置
|
||
|
||
### 6.5 回复内容不对
|
||
|
||
**现象：** AI 的回答和你问的内容无关，或者回答不准确。
|
||
|
||
**解决办法：**
|
||
|
||
1. 尝试换一种方式描述你的问题，尽可能具体明确
|
||
2. 开启一个新对话重新提问
|
||
3. ZCLAW 是 AI 助手，它生成的内容需要你进行审核确认，不要直接使用未经检查的内容
|
||
|
||
### 6.6 想卸载 ZCLAW
|
||
|
||
如果你不再需要使用 ZCLAW：
|
||
|
||
1. 点击"开始"按钮
|
||
2. 点击"设置"
|
||
3. 点击"应用"或"已安装的应用"
|
||
4. 在列表中找到 ZCLAW
|
||
5. 点击 ZCLAW 旁边的三个点（或右键点击），选择"卸载"
|
||
6. 按照提示完成卸载
|
||
|
||
> **重要：** 卸载不会删除你的聊天记录和设置。如果需要彻底清除所有数据，请联系 IT 部门。
|
||
|
||
### 6.7 做错了不知道怎么办
|
||
|
||
如果你不小心点错了什么，不用担心：
|
||
|
||
- **关闭 ZCLAW 再重新打开** -- 大多数问题都能通过重启解决
|
||
- **开启新对话** -- 如果当前对话变得奇怪，开一个新对话即可
|
||
- **联系 IT 部门** -- 任何时候你都可以联系 IT 部门获取帮助
|
||
|
||
---
|
||
|
||
## 7. 日常使用小贴士
|
||
|
||
### 7.1 提问技巧
|
||
|
||
好的提问方式能得到更好的回答：
|
||
|
||
| 提问方式 | 效果 |
|
||
|---------|------|
|
||
| "帮我写一份关于下周五科室例会的通知" | 回答具体、可用 |
|
||
| "写个通知" | 回答笼统、需要大量修改 |
|
||
| "请用正式语气，帮我写一封发给全院的通知，内容是关于下周一全院停诊" | 回答精准、可直接使用 |
|
||
|
||
### 7.2 数据安全提醒
|
||
|
||
- 不要在 ZCLAW 中输入患者的个人信息（姓名、身份证号、病历号等）
|
||
- 不要输入医院的机密信息
|
||
- ZCLAW 的对话记录保存在你的本地电脑上，不会上传到其他地方
|
||
- 离开电脑时请关闭或最小化 ZCLAW 窗口
|
||
|
||
### 7.3 使用场景参考
|
||
|
||
以下是一些医院行政管理中常见的使用场景：
|
||
|
||
- 起草通知、公告、邮件
|
||
- 整理会议纪要
|
||
- 总结文件内容
|
||
- 撰写工作计划或报告大纲
|
||
- 检查文字措辞是否得体
|
||
|
||
---
|
||
|
||
## 技术支持
|
||
|
||
遇到任何无法解决的问题，请联系医院 IT 部门，并提供以下信息：
|
||
|
||
1. 你的电脑编号或 IP 地址（IT 部门会告诉你怎么查）
|
||
2. 问题发生的时间
|
||
3. 你当时在做什么操作
|
||
4. 屏幕上显示了什么错误提示（可以拍照发给 IT）
|
||
|
||
IT 部门会根据以上信息快速定位和解决问题。
|
||
|
||
---
|
||
|
||
*本指南基于 ZCLAW v0.1.0 编写，最后更新：2026-04-08*
|