# 普惠AI指令拆解引擎 — 用户手册（v1.3.1）

> 平台品牌：普惠 AI（普惠 AI 全民智能服务平台）
> 引擎全称：**普惠AI指令拆解引擎**（原名「凡人歌」→ 2026-09-26 定名「普惠AI指令拆解引擎」）
> 一句话：**你说大白话，它出派工单**——全自动标准化拆解任务指令。

## 一、它是什么

一个**任务/项目指令引擎**：把人话需求 → 多轮追问补齐 → 输出一份**能直接执行的标准任务包**。

- **零算力**：识别、追问、组装全是确定性规则，**不调用大模型**，不花 token
- **零依赖**：只用 Python 标准库，拷进去就能跑；**不联网**，离线可用
- **有行业标准**：工具怎么做、行业合规红线、验收标准、卡住怎么办、同行业历史经验，任务包里都带着

## 二、三种用法（任选一种）

| 用法 | 怎么开始 | 适合谁 |
|---|---|---|
| **插件** | 解压 `普惠AI插件_v1.3.1.zip`，宿主里 `from fanrenge import run_once` | 会用智能体的人（Hermes / OpenClaw / Claude Code） |
| **网页版** | 双击 `启动普惠AI网页版.bat` → 浏览器打开 `127.0.0.1:8899` | 演示、试用、门店老板 |
| **桌面版** | 双击 `普惠AI指令拆解引擎.exe` | 零基础用户、离线环境 |

## 三、怎么用（三步，谁都学得会）

1. **说需求**：像跟人说话一样，例如「做一个旅游线路咨询登记单页，客户填姓名电话意向线路」
2. **答追问**：它只问没说清的关键项（做到什么程度算满意、手上有什么材料、要几个页面…），如实回答就行
3. **拿任务包**：出两份结果——
   - **大白话版**：一条条怎么做，直接照做
   - **结构化任务包**：交给智能体执行（JSON，字段固定）

## 四、任务包里有什么（v1.3.1）

| 内容 | 说明 |
|---|---|
| 分步任务 | 8 个环节：目标 → 查历史经验 → 环境（含怎么自测）→ 工具 → 澄清 → 拆步 → 约束 → 验收 + 交付复盘 |
| 适用工具（行业标准） | 这个行业该用什么工具，**没有该工具时的替代路径**也写了 |
| 行业合规提醒 | 行业红线，避免踩坑（如 AI 生成内容须标识、医疗不做诊疗建议） |
| 做完拿什么证明 | 自测手段清单（跑测试/打开页面/截图/录屏） |
| 卡住怎么办 | 应变预案：最可能卡在哪、备选路径是什么 |
| 上次同类任务 | 前置经验检索：同行业以前怎么做的（本地台账，零算力） |
| 新行业候选 | 遇到没见过的行业会自动记下来，问够 3 次就自动生成该行业的行业包草案 |

## 五、行业包是怎么长出来的（不用你操心）

没见过的行业 → 自动登记 → 同一个行业出现 3 次 → 自动出行业包草案 → 系统自己质检 7 条 → **人工审核通过才入库**（AI 不会自动改库）→ 入库前自动备份、入库后自动跑回归测试。
管理员命令：`python fanrenge/pack_draft.py list|clean|gen|check <名>|approve <名>|suggest`

## 六、常见问题

**Q：要装大模型吗？**
A：不用。引擎是纯规则、零算力；"说话"由你的智能体负责，引擎负责"把话说清楚、把活拆明白"。

**Q：要联网吗？**
A：不用。全程本地运行，不联网、不上传任何数据（网页版只监听本机 127.0.0.1）。

**Q：要钱吗？**
A：引擎本身免费（MIT 许可）；如果你拿它去调大模型执行，费用是那个大模型的钱。

**Q：行业包更新了怎么办？**
A：插件版换 `templates.json` 即可；桌面版只替换 exe 同级 `data/` 目录里的 json，**不用重新安装**。

**Q：能保证完全准确吗？**
A：规则引擎的输出是确定性的（同样的输入 → 同样的任务包），但**行业标准需要人工把关**；发现不合适就改行业包，改完立即生效。

**Q：数据存哪里？**
A：全在本机。行业包、词典、候选池、经验台账都在 `fanrenge/`（源码版）或 `data/`（桌面版）目录里，可随时备份和带走。

---
许可：MIT ｜ 作者：汪君（普惠AI全民智能服务平台）