# 筑鸡 — 用户使用手册

> 版本：1.0.0 | 最后更新：2026-07-29

自主开发，持续更新！！欢迎提建议。

欢迎使用筑鸡，它是用于专属工具生成的龙虾（openclaw）！！！你只需要用一句话描述想要的工具，AI 就会自动帮你生成一个可以直接双击运行exe的程序。

---

## 目录

1. [安装与启动](#1-安装与启动)
2. [首次使用：激活软件](#2-首次使用激活软件)
3. [认识主界面](#3-认识主界面)
4. [开始对话：让 AI 帮你造工具](#4-开始对话让-ai-帮你造工具)
5. [管理你的工具箱](#5-管理你的工具箱)
6. [管理对话记录](#6-管理对话记录)
7. [系统设置](#7-系统设置)
8. [软件更新](#8-软件更新)
9. [常见问题](#9-常见问题)

---

## 1. 安装与启动

### 系统要求

| 项目 | 要求 |
|------|------|
| **磁盘空间** | 至少 1 GB 可用空间 |
| **操作系统** | Windows 10、Windows 11、Windows Server 2019 及以上版本 |

> 未来版本将支持 macOS 和 Linux 系统，敬请期待。

### 获取安装包

从官方渠道获取安装包（或由你的软件提供方发送给你），运行安装程序按提示完成安装。

### 启动软件

单个文件启动。

找到桌面上的「筑鸡」图标，双击打开即可。软件会在后台自动启动所需的服务。

> 首次启动可能需要等待几秒钟，这是正常现象。

---

## 2. 首次使用：激活软件

首次打开软件时，你会看到一个激活界面。一次授权，永久使用！！！

### 激活步骤

1. 在输入框中输入你收到的**序列号**（格式类似：XXXX-XXXX-XXXX-XXXX）
2. 点击「立即进行在线激活」按钮
3. 等待几秒钟，系统会联网验证你的序列号
4. 验证成功后，按提示配置 AI 服务并准备运行组件
5. 准备完成后自动进入软件主界面，无需创建或登录本地账号

### 注意事项

- 一个序列号只能绑定一台电脑
- **首次激活需要联网**：软件会连接服务器验证序列号并完成初始化，请确保网络连接正常
- 激活并初始化完成后，如果你使用的是本地大模型，软件可以完全离线运行，无需再次联网
- 如果你使用的是在线 AI 服务（如 GPT-5、Claude 5 等），则对话过程仍需联网
- 如果激活失败，页面底部会显示你的**设备识别码**，请将此识别码发送给技术支持以获得帮助

---

## 3. 认识主界面

软件主界面分为两个区域：

### 左侧边栏

这是你的导航中心，包含以下功能：

| 功能 | 说明 |
|------|------|
| **新建任务** | 开始一个新的 AI 对话 |
| **工具箱** | 查看和管理 AI 为你生成的所有工具 |
| **任务列表** | 你的历史对话记录，按时间排列 |
| **系统设置** | 配置软件参数 |

> 如果屏幕较小，侧边栏会自动收缩为图标模式。点击左上角的菜单按钮可以展开或收起。

### 右侧主区域

这是你和 AI 对话的地方，也是工具生成、查看结果的核心区域。

---

## 4. 开始对话：让 AI 帮你造工具

这是筑鸡最核心的功能。你可以用自然语言描述需求，AI 会自动完成：理解需求 → 编写代码 → 编译生成 → 产出可执行文件。

### 基本流程

![使用流程手绘图解](./images/zhuji_user_guide_flow.png)

**第一步：新建对话**

点击侧边栏的「新建任务」按钮（带加号的按钮），开始一个新的对话。

**第二步：描述你的需求**

在底部的输入框中，用日常用语描述你想要的工具。例如：

```
帮我做一个批量文件重命名工具，能按照序号给文件夹里的所有图片重新编号
```

```
我需要一个工具，能把一个文件夹下所有的 Excel 文件合并成一个
```

```
帮我做一个局域网文件共享工具，手机扫码就能下载电脑上的文件
```

**第三步：等待 AI 完成**

按下回车键发送后，AI 会开始工作。你可以在对话中看到 AI 的思考过程和操作步骤。整个过程通常需要 1-5 分钟，取决于工具的复杂程度。

**第四步：获取成品**

AI 完成后，会告诉你工具已经生成。生成的工具会自动保存到「工具箱」中，你可以直接下载使用。

### 对话技巧

| 技巧 | 示例 |
|------|------|
| **说清楚用途** | "我需要批量给 PDF 加水印" 比 "处理 PDF" 更好 |
| **描述期望效果** | "生成后双击打开，选择文件夹，自动处理" |
| **提出修改要求** | AI 生成后不满意？直接说 "把界面改成中文" 或 "加一个进度条" |
| **追加功能** | "在刚才的工具上加一个功能：处理完自动打开输出文件夹" |

### 什么样的工具可以生成？

以下是一些常见的使用场景，仅供参考：

- **文件处理**：批量重命名、格式转换、文件分类整理、压缩解压
- **办公效率**：Excel 数据合并、PDF 拆分合并、图片批量处理
- **数据处理**：CSV 数据清洗、文本查找替换、日志分析
- **网络工具**：局域网文件共享、二维码生成、简单的 HTTP 服务
- **系统工具**：磁盘空间分析、重复文件查找、批量文件移动、文件统计处理

---

## 5. 管理你的工具箱

工具箱是你所有 AI 生成工具的管理中心。点击侧边栏的「工具箱」进入。

### 工具卡片

每个工具以卡片形式展示，包含以下信息：

| 信息 | 说明 |
|------|------|
| **工具名称** | AI 根据功能自动命名（通常是中文名） |
| **描述** | 工具的功能说明 |
| **版本号** | 如果你让 AI 修改过工具，版本号会递增 |
| **文件大小** | 生成的程序文件大小 |
| **平台** | 适用的操作系统（如 windows/amd64） |
| **创建时间** | 工具生成的时间 |

### 操作说明

- **下载**：点击卡片上的「下载」按钮，将工具保存到你电脑上的指定位置。下载后可以双击运行，也可以发送给其他人使用。
- **详情**：点击「详情」按钮，查看工具的完整信息，包括版本历史和每次修改的变更内容。
- **删除**：点击红色的删除按钮移除工具。注意：删除后无法恢复。
- **搜索**：顶部搜索框可以按名称或描述搜索工具。

### 版本历史

在详情弹窗中，你可以查看工具的每个版本：

1. 点击某个版本条目，可以展开查看该版本的修改内容
2. 不同颜色标记了新增（绿色）和删除（红色）的代码变更
3. 你随时可以下载当前最新版本

---

## 6. 管理对话记录

你和 AI 的每次对话都会自动保存，方便日后查阅和继续。

### 对话列表

侧边栏中的「任务」区域显示所有对话记录。

- **切换对话**：点击任意对话可切换到该对话的内容
- **新建对话**：点击顶部的「新建任务」按钮
- **搜索对话**：点击侧边栏右上角的搜索图标，输入关键词搜索

### 对话管理操作

将鼠标移到某个对话上，右侧会出现操作按钮：

| 操作 | 说明 |
|------|------|
| **置顶** | 将常用对话固定在列表顶部 |
| **归档** | 隐藏不常用的对话（不是删除） |
| **重命名** | 给对话起一个更好记的名字 |
| **导出 MD** | 将对话内容导出为 Markdown 格式文件 |
| **导出 HTML** | 将对话内容导出为网页格式文件 |
| **删除** | 永久删除对话（不可恢复） |

### 查看已归档对话

点击侧边栏右上角的筛选按钮（漏斗图标），选择「显示已归档会话」，即可看到所有被归档的对话。在归档的对话上点击归档按钮可以恢复它。

### 清空所有记录

在筛选菜单中选择「清空所有记录」可以一次性删除所有对话。此操作不可逆，请谨慎使用。

---

## 7. 系统设置

点击侧边栏底部的「系统设置」进入设置页面。

### 通用设置

- **运行组件**：查看并准备筑鸡生成工具所需的本地组件
- **AI 服务**：维护模型地址、模型名称和 API 密钥
- **日志级别**：如果遇到问题需要排查，可以调为 debug

### 认证设置

- **启用/关闭认证**：控制是否需要登录才能使用
- **用户名和密码**：设置登录凭据

修改设置后，点击右上角的「保存更改」按钮使配置生效。

> 大部分情况下，你不需要修改任何设置，使用默认配置即可。

---

## 8. 软件更新

筑鸡内置了自动更新功能：

- 软件启动时会自动检查是否有新版本
- 如果发现新版本，系统会弹出通知提醒
- 你可以选择「立即更新」或「跳过此版本」
- 更新过程是自动的，下载并安装完成后软件会自动重启
- 更新期间请不要关闭软件

你也可以在系统设置中手动检查更新。

---

## 9. 常见问题

### 软件打开后一直在加载怎么办？

- 首次启动可能需要 10-30 秒初始化，请耐心等待
- 如果超过 1 分钟仍未加载，尝试关闭软件后重新打开
- 仍然无法解决，请联系技术支持并提供日志文件

### 激活失败怎么办？

- 检查序列号是否输入正确（注意区分大小写和连字符）
- 确认网络连接正常
- 检查序列号是否已在其他设备上使用
- 将页面底部的「设备识别码」发送给技术支持

### AI 生成的工具打不开怎么办？

- Windows 可能会弹出安全警告，选择「仍要运行」即可
- 如果杀毒软件拦截，请将工具添加到白名单
- 确保你下载的是对应操作系统的版本

### 怎么把工具分享给同事？

1. 在工具箱中找到要分享的工具
2. 点击「下载」将它保存到电脑
3. 通过微信、邮件或 U 盘将下载的文件发送给同事
4. 同事收到后双击即可运行，不需要安装任何软件

### 生成的工具需要联网吗？

大部分工具不需要联网，下载后可以完全离线使用。除非你要求 AI 生成的工具本身包含网络功能（比如局域网文件共享）。

### 可以修改已经生成的工具吗？

可以！在对话中直接告诉 AI 你想修改什么，例如：

- "把界面改成深色主题"
- "添加一个进度条显示处理进度"
- "支持拖拽文件到窗口来选择文件"

AI 会在原有基础上修改并重新编译，工具箱中的版本号会自动更新。

### 能同时生成多个工具吗？

可以。你可以新建多个对话，每个对话生成不同的工具。但建议同一时间只运行一个生成任务，以获得最佳性能。

---

## 联系与支持

如果在使用过程中遇到任何问题，请通过以下方式联系我们：

- 反馈问题时，请尽量附上：问题描述、截图、设备识别码

---

*筑鸡 — 对话即开发，AI 帮你造工具*  
*海南木知咨询文化有限公司 版权所有*