feat: deliverables 3-6 — cold start, simple mode UI, bridge tests, docs
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)
This commit is contained in:
iven
2026-04-09 09:51:56 +08:00
parent ffaee49d67
commit e6937e1e5f
8 changed files with 2031 additions and 4 deletions

281
docs/installation-guide.md Normal file
View File

@@ -0,0 +1,281 @@
# 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*