iven/zclaw_openfang
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
36a1c87d87bd8af514edeef8a9b1f0fbaafa4928
zclaw_openfang/docs/installation-guide.md
iven e6937e1e5f
Some checks failed
CI / Lint & TypeCheck (push) Has been cancelled
Details
CI / Unit Tests (push) Has been cancelled
Details
CI / Build Frontend (push) Has been cancelled
Details
CI / Rust Check (push) Has been cancelled
Details
CI / Security Scan (push) Has been cancelled
Details
CI / E2E Tests (push) Has been cancelled
Details
feat: deliverables 3-6 — cold start, simple mode UI, bridge tests, docs 
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)
2026-04-09 09:51:56 +08:00

8.9 KiB
Raw Blame History

ZCLAW 安装与使用指南

面向用户：医院行政管理人员

目录

  1. 开始之前：你需要准备什么
  2. 第一步：下载安装包
  3. 第二步：安装 ZCLAW
  4. 第三步：首次启动
  5. 第四步：开始使用
  6. 遇到问题怎么办
  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