====== AI 助手使用指南 ======

「万念霖衢」是合肥一中电脑社的 AI 助手（网页端 https://hfyzdns.cn/ai/tts.html）。本文说明其**全部新逻辑**：功能、用法、权限与标记语法。

----

===== 1. AI 对话 =====

  * 默认模型 **GPT-OSS 120B**；DeepSeek/GLM/Llama 可切换；模型抽风自动换下一个（悬浮窗提示）
  * 回答流式输出（丝滑不抖），自动朗读（4 音色）
  * **身份识别**：登录后 AI 知道你是谁/职务（服务端校验 Cookie，无法伪造）；回答因人而异，管理内容仅对管理员说明
  * **知识检索**：知识库（public:*）、技术博文、社员公开主页随问随查；面板显示「正在查阅→已查阅」

===== 2. 多模态上传 =====

AI 面板四个上传按钮，文件进「附件框」自动理解（动效+对勾）：

  * 🖼 图片（≤10MB）→ OCR 文字识别
  * 🎤 音频（≤10MB）→ 语音转文字
  * 🎬 视频（≤10MB）→ 抽音轨转文字
  * 📄 文档 txt/doc/docx/pdf/ppt/pptx（**≤7MB**）→ 文本提取
  * 支持多选；识别文本不显示在对话里，但 AI 能"看到"

===== 3. 万念造物 =====

**创建**：说「帮我做个网页」→ AI 生成 HTML → 自动保存为私有页面（对话里出现造物卡片）
**管理**：说「我的页面」→ 管理面板（查看/发布/转私有/删除/复制链接）
**修改**：说「把 xxx 页面改成…」→ AI 读取当前代码修改后写回
**公开页**：https://hfyzdns.cn/c/<用户名>/<页面>/
**限制**：每用户 ≤20 页、单页 ≤200KB；页面自动安检（无恶意脚本/网络请求）；游客不可用

===== 4. 权限分级 =====

  * **游客**：AI 对话 5 轮、朗读/听写、文件识别；5 轮后弹窗引导登录
  * **社员**：无限对话、万念造物、社员卡片、身份识别、主页编辑
  * **管理层/管理员**：知识库管理区等

===== 5. AI 标记语法（回答中自动渲染）=====

  * `[[博文:标题]]` — 博文胶囊 | `[[知识库]]` — 知识库胶囊 | `[[跳转:路径]]` — 跳转胶囊
  * `[[社员:用户名]]` — 社员卡片（**必须用英文用户名**）
  * `[[图:URL]]` / `[[视频:URL]]` — 图片/视频（站内或 https，安全校验）
  * `[[造物创建:标题]]` + html 代码块 — 创建造物 | `[[造物更新:slug]]` + 代码块 — 修改造物

===== 6. 安全边界 =====

  * AI 只能读白名单内容（公开 wiki/博文/社员公开资料/自己的造物），不能读敏感文件、不能执行命令
  * 媒体/卡片/造物均经过安全校验（URL 白名单、消毒、CSP）

---

← [[:start|返回知识库首页]]