# Yujin Forge -- 用户手册

用于构建 React + NAC-3 应用程序的语音优先开发助手。设计宗旨是 让看护者或正在学习编程的孩子无需接触终端即可操作。

## 欢迎

Yujin Forge 做三件简单的事：

- 朗读文档（PDF、Word、HTML、MD、EPUB、CSV、Excel、源代码、 txt、RTF）。
- 接收设计规范并自动生成应用程序代码。
- 与了解你项目的 AI 助手对话：读取清单、搜索 SPEC、编辑组件、 进行提交。

## 安装

1. 从 nodejs.org 安装 Node.js 18.17 或更高版本。
2. 在终端中：

       npm install -g @yujin/forge-cli@alpha

3. 用 `yf --version` 验证。
4. 运行 `yf doctor`。

## 首次运行

    yf chat

浏览器打开 Yujin 面板。点击密钥按钮（右上角） 加载 API 密钥。每个密钥在输入时只显示一次。

## 语音命令

Yujin 理解西班牙语、英语、葡萄牙语、法语、德语、意大利语、 日语、中文、印地语和阿拉伯语。

你说 | 会发生什么
--- | ---
"打开文件名" | 打开文档。
"下一个" / "继续" | 前进到下一个块。
"搜索单词" | 搜索并读取第一个匹配。
"这里设置书签名称" | 设置书签。
"跳到书签名称" | 返回到书签。
"总结" | 重读最近的块。
"打开手册" | 用你的语言打开本手册。

## 规范导入

将规范文件拖到面板上。出现带有汉字的紫色屏幕。将文件放在上面。

1. Yujin 读取文档。
2. Claude 提取需求、实体、端点、组件和摘要。
3. Claude 生成要创建的文件计划。
4. Yujin 显示计划。你说"批准"。
5. 在你的项目文件夹中创建文件。
6. 如果出错，说"撤销"。

## 故障排除

麦克风不工作
  浏览器首次请求权限。点击 URL 旁边的锁更改权限。
它听不懂我
  在 `openai` 插槽中加载 OpenAI 密钥。
声音质量差
  加载 ElevenLabs 密钥获得更自然的声音。
我想重新开始
  关闭 Yujin。删除 `~/.yujin-forge/`。 再次运行 `yf chat`。

## 支持

支持：pablo@rpaforce.com