冰川GPT 用户手册

版本 v5.10.5 | 适用对象：公司全体员工

最近更新 / What's New

这部分专门放最近补上的功能，方便你快速扫一眼新能力和新入口。

0.1 会话同步与恢复

• 个性化 → 记忆里新增了「恢复聊天记录」按钮。
• 如果你发现侧边栏会话列表丢失、刷新后又不见了，先开启「会话同步」，再点一次恢复按钮。
• 管理员后台也新增了会话恢复页，支持批量候选、批量预览和批量恢复。

0.2 任务列表与生成任务

• 任务列表的读取路径做了性能优化，打开更快。
• 管理员可以按需查看更详细的队列诊断；普通用户默认只看自己的任务。
• 视频任务轮询也做了优化，减少后台扫描压力。

0.3 图片与视频创作

• 新增并完善了 og-image-2 图片模型，图生图和图片编辑都能正常使用。
• 无限画布支持 GPT 画质选择器，gpt-image-2 可按需切换画质档位。
• 视频编辑器支持时间线剪辑、变速、截帧和片段导出。

0.4 如果你只想看最常用的

• 新建对话：开始对话
• 会话同步：设置 → 个性化 → 记忆
• 恢复聊天记录：设置 → 个性化 → 记忆
• 任务列表：设置菜单 → 📋 任务列表
• 帮助中心：设置菜单 → 帮助

1. 欢迎 & 快速开始

1.1 冰川GPT 是什么

冰川GPT 是公司自主搭建的 AI 智能助手平台，集成了全球主流的 50+ 款 AI 大模型，帮助你完成日常工作中的各种任务：

• 智能对话：向 AI 提问、讨论方案、写作文案 开始新对话
• 创作工坊：一键生成图片、视频、音频 打开创作工坊
• 文档分析：上传 Word、PPT、Excel、PDF，AI 帮你总结翻译
• 知识库：建立你的专属知识库 管理知识库
• 智能体：创建自定义 AI 角色 浏览智能体
• 个性化：AI 记住你的偏好和习惯 个性化设置

1.2 登录方式

冰川GPT 使用钉钉账号登录，无需额外注册。

• 在浏览器中打开冰川GPT 的访问地址
• 页面自动跳转到钉钉授权页面
• 使用钉钉扫码或点击「确认授权」
• 授权成功后自动进入主界面

首次登录可能需要几秒钟加载。如果登录失败，请检查你的钉钉账号是否已加入公司组织。

1.3 界面总览

冰川GPT 主界面

界面分为三个区域：

侧边栏快捷入口：

侧边栏底部点击头像/姓名区域可打开设置菜单（主题、个性化、帮助等）。

置顶会话会折叠在「📌 置顶」分组中，点击可展开/收起。

1.4 发送第一条消息（3分钟上手）

第一步：点击「新建会话」按钮

第二步：在输入框中输入问题，例如：

`帮我写一封给客户的感谢邮件，要求礼貌、专业、简洁`

第三步：按 Enter 发送

AI 根据提问生成了项目管理思维导图

小贴士：

· 按 Shift + Enter 换行（不发送）

· 按 Ctrl + ↑/↓ 浏览发送过的历史消息

· 可以直接拖拽或粘贴文字、图片、文件到输入框

2. 对话聊天

2.1 新建会话 & 管理会话

新建会话 每个会话独立，AI 只记得当前会话中的对话内容。

右键菜单（右键点击侧边栏会话）：

搜索会话：快捷键 Ctrl+K 快速打开搜索框，输入关键词查找历史对话。

会话按时间自动分组：今天、昨天、本周、更早。智能体的会话自动归到对应分组。

**贴心细节：**切换会话直接显示最后一条消息（无需等待滚动），切回已读会话时自动恢复上次阅读位置。侧边栏支持拖拽调整宽度，移动端支持滑动手势展开/收起。

2.2 发送消息

文字：输入框直接输入，Enter 发送。

图片：点击上传按钮 → 🖼️ 图片 / 拖拽上传 / Ctrl+V 粘贴。

文件：点击上传按钮 → 选择类型（详见第7章）。

URL 导入：上传按钮 → 🔗 从URL导入 → 输入地址。

上传菜单：图片、视频、音频、文档、URL导入

2.3 AI 回复

流式输出

AI 实时逐字回复。回复中可点击「停止」中断生成。

深度思考 🧠

部分模型支持深度思考，AI 先推理分析再回答。点击输入框的「深度思考」按钮开启。

适用场景：数学计算、逻辑推理、代码分析、复杂方案规划

联网搜索 🔍

需要最新信息时，点击「联网搜索」按钮开启。AI 先搜索互联网再回答。

适用场景：最新新闻、实时数据、产品价格、技术文档

2.4 消息操作

费用明细（v5.4.11 新增）

每条消息底部和页面底栏现在显示分项费用明细：

• Token 分项：输入、输出、缓存命中、缓存创建（有值才显示）
• 费用分项：输入￥x 缓存￥x 输出￥x = ￥总额，一目了然
• Claude/OpenAI 缓存命中自动按优惠价计算

点击消息底部的 token 区域可展开费用明细。仅有一项费用时直接显示总额，不显示分项。

2.5 代码块功能

2.6 Mermaid 图表

AI 可生成流程图、时序图、甘特图等，支持缩放、拖拽、下载 SVG、全屏查看。

2.7 数学公式（v5.4.9 新增）

AI 回复中的数学公式会自动渲染为漂亮的数学符号：

• 行内公式：用 $...$ 包裹，如 $E=mc^2$ 会渲染为数学符号
• 块级公式：用 $$...$$ 包裹，居中显示

普通价格文本（如 $100）不会被误当公式。公式渲染基于 KaTeX 本地库，无需联网。

3. 模型选择

冰川GPT 集成 50+ 款大模型。打开模型广场

模型广场：搜索、筛选、排序、对比模型

3.2 AI 帮我选

不确定该用哪个模型？让 AI 帮你挑。点击底栏输入框旁的 ✨ 图标，或在模型广场右上角点击「✨ AI帮我选」。AI 会根据你的对话内容自动推荐最合适的模型。

鼠标悬停在模型名称上，会弹出该模型的能力介绍（如"思考模型，适合复杂推理"），帮你快速了解模型特点。

3.4 常用模型推荐

日常聊天 & 通用问答

深度分析 & 复杂任务

编程 & 代码

中文写作 & 中文任务

长文档处理

3.5 模型能力标签

所有模型对公司员工免费使用。建议日常用轻量模型，复杂任务再切换高端模型。

3.6 冰川GPT 为 Claude Code 解锁更多模型（v5.8 新增）

这是冰川GPT 独有的能力，并非 Claude Code 自带功能。冰川自研的协议转换代理层将 Anthropic Messages API 实时转译为 OpenAI Chat/Responses 等协议，让 Claude Code Desktop 也能调用非 Claude 厂商的模型。

• 请求转换：Anthropic 请求 → 冰川智能路由 → 目标厂商协议（OpenAI / DeepSeek / Qwen / 豆包 / Kimi / MiniMax / GLM）
• 响应还原：厂商回复 → 反向转回 Anthropic SSE 流式格式 → Claude Code 无感接收
• 缓存适配：自动剥离动态标识头，注入厂商对应的缓存策略（prompt_cache_key），第三方模型也能享受前缀缓存命中
• 工具调用映射：function calling（tool_use）在 Anthropic ↔ OpenAI Responses 之间双向映射，完整支持工具链

智能模型列表

Claude Code 访问 /v1/models 时冰川代理自动过滤，只展示受支持的模型。百万级上下文模型默认标注 [1M]，一眼识别大容量选手。

横向兼容模型阵容

配置方法

在 Claude Code 中设置环境变量即可使用：

ANTHROPIC_API_URL=https://你的冰川GPT地址
ANTHROPIC_API_KEY=sk-xxx（在开放平台自助创建）

**缓存说明：**冰川代理已自动剥离请求中的动态标识头（如 billing-header），确保 OpenAI 自动前缀缓存正常命中，实测缓存命中率从 ~15% 提升至接近 100%。所有适配的模型均支持流式、工具调用、深度思考等能力。

4. 创作工坊

打开创作工坊

创作工坊模式选择：图片、视频、音频

4.1 图片生成

图片生成模式：在视觉模型广场选择模型和生成方式 - 选择「🎨 图片生成」 - 输入描述，如：`一只戴着墨镜的柴犬坐在海边，夕阳西下，油画风格` - 调整参数：清晰度、宽高比、数量 - 点击发送

支持的图片模型（持续更新）

默认图片模型已切换为 Wan2.7-Image，需要 4K 高清时切到 Wan2.7-Image Pro。AI 局部编辑中用户选择的模型会自动记忆（localStorage），下次打开自动恢复。

4.2 视频生成

视频生成模式：在视觉模型广场选择模型和生成方式

视频生成较慢（几十秒到几分钟），超时后系统自动转为后台任务继续执行，刷新页面后自动恢复进度。输入视频超过 10 秒时自动截取前 10 秒。

文生视频参考图（v5.6.9 新增）

在「文生视频」模式下，可以上传参考图让 AI 理解画面内容，然后生成相应的视频提示词：

• 进入「创作工坊 - 视频 - 文生视频」
• 点击上传图片 → 图片进入聊天输入区（非视频素材卡槽）
• 页面会出现黄色提示条「参考图不会传给生成模型，但会传给 AI 理解」
• 输入文字描述后发送 → AI 理解参考图内容并生成视频提示词 → 系统自动文生视频

参考图仅供 AI 对话模型理解画面，不会传给视频生成 API。若想让图片「动起来」，请使用「首帧生成」模式。

支持的视频模型（v5.8 更新）

系统集成了多家厂商的视频生成模型，覆盖不同场景和价位。HappyHorse 1.0 为当前默认视频模型。

视频模型详细对比

**选择建议：**日常使用选 HappyHorse，又快又稳无审核烦恼；需要音频/视频延长/首尾帧等高级功能选 Seedance 2.0；追求极致画质选 Veo 3.1（4K）；性价比之选 Kling 3.0-Omni 或 Wan2.7。

**注意事项：**Seedance 系列审核较严，包含敏感内容的图片可能被拒绝。HappyHorse 不支持音频生成。Veo 系列时长固定（4/6/8s）且按 USD 计费，价格较高。

生成进度与费用

• 实时进度：生成过程中显示状态（提交 → 排队 → 生成 → 处理），格式如「生成中 · 用时 2 分 30 秒 · 预计还需 1-2 分钟」
• 排队机制：Wan 视频等厂商同时最多 5 个并发，超出自动进入排队，可显示"X 小时 X 分"倒计时（v5.6.0 新增）
• 自动恢复：超时后前台自动开始轮询，刷新页面不会丢失进度（v5.4.20 新增）
• 费用透明：所有视频模型价格统一显示为 元/秒，方便横向对比
• 生成详情：完成后显示模型名称、实际费用、分辨率、时长、Seed 值
• 状态提示：不可用的模型自动置灰，限流/超时有友好提示

生成效果示例

AI 生成示例：「一只戴着墨镜的柴犬坐在海边沙滩椅上，夕阳西下，油画风格」

4.3 音频生成

4.4 AI 图片编辑

右键图片 → 「图片编辑」，或在素材卡槽右键打开编辑器，支持多种操作：

AI 构图（智能扩图）

AI构图本质是智能扩图：AI 分析画面构图，自动计算四边扩展量，再调用图片生成模型填充空白区域，让画面比例更协调、构图更专业。

• 打开图片编辑器 → 点击「🖼️ AI构图」标签
• 选择构图场景（三分法 / 半身人像 / 头像特写 / 风景全景 / 产品展示等 11 种）
• 选择目标比例（比例自动 / 1:1 / 16:9 / 9:16 等，默认自动）
• 点击「🪄 智能构图」→ AI 自动分析并填充上下左右扩展量 + 生成扩图提示词
• 选择画质（自动/512px/1K/2K/4K，默认按输出分辨率自动计算）
• 确认预览无误 → 点击「✨ 开始构图」

推荐配合万相2.7-Image 模型使用，效果最佳。素材卡槽右键菜单也可快速进入「AI扩图」，Ctrl+滚轮缩放预览（v5.4.15 新增）。

AI 局部编辑

精准替换图片中的任意区域，其余部分完全保留。

• 打开图片编辑器 → 点击「✨ AI局部编辑」标签
• 在画布上拖拽或单击创建选区（最多 2 个）
• 在弹出框中输入描述（如"把这里的天空换成星空"）
• 选择模型 → 点击「✨ AI 编辑」

4.5 AI 抠图

图片编辑弹窗中的「抠图」标签页

AI 抠图可以一键去除图片背景，生成透明 PNG 图片。适合做产品白底图、证件照、设计素材等。

三种抠图模式

如何使用

方式一：从素材卡槽操作

• 在创作工坊中上传一张图片到素材卡槽
• 右键点击图片 → 选择「AI 抠图」
• 自动打开图片编辑弹窗并跳转到抠图标签

方式二：从图片编辑弹窗

• 在图片编辑弹窗中点击顶部的「抠图」标签页
• 选择抠图模式（智能 / 人像 / 商品）
• 点击「开始抠图」
• 等待几秒，AI 自动去除背景
• 抠图结果以棋盘格背景展示透明区域，可直接保存

图片分辨率最大支持 2000 × 2000，文件最大 10MB。超限时系统自动压缩处理。结果自动保存到素材中心。

4.6 无限画布

无限画布首页：输入创意、浏览推荐、管理项目

无限画布是一个可视化的 AI 创作工具，用节点和连线的方式编排 AI 工作流。相比创作工坊的对话式交互，无限画布更适合需要多步骤、多素材组合的美术创作场景。

入口：侧边栏顶部「无限画布」按钮，或直接访问 /huobao-canvas 打开无限画布

核心概念

画布中有不同类型的节点，通过连线组合成工作流：

快速上手

画布工作区：左侧节点工具栏 + 中间画布 + 底部输入框 - **打开画布** → 在首页输入创意描述或点击「+ 新建项目」 - **添加节点** → 点击左侧工具栏的 **+** 按钮，或从工具栏拖拽节点到画布 - **连接节点** → 从一个节点的输出端口拖线到另一个节点的输入端口 - **配置参数** → 在文生图/视频配置节点中选择模型、设置尺寸等 - **生成** → 点击运行按钮，生成的图片/视频自动显示在对应节点中

LLM 节点（v5.4.7 新增）

LLM 节点可以在画布中直接调用大模型，实现文本生成、分镜拆分等能力：

• 模型选择 — 自动获取系统中所有可用的聊天模型
• 输出格式 — 支持纯文本、JSON、Markdown 三种格式
• 自动传播 — LLM 生成的内容自动传递到下游文本节点
• 视频输入 — 连接视频节点后，模型列表自动过滤为支持视频的模型

实用功能

• AI 润色提示词 — 点击「✨ AI 润色」一键优化你的描述，提升生成质量
• AI 脚本生成 — 文本节点支持 AI 一键生成文案，Ctrl+Enter 快捷键触发（v5.4.12 新增）
• 分镜表格编辑器 — 全屏分镜编辑界面，支持导出 CSV；AI 可自动生成完整分镜（v5.4.12 新增）
• 推荐灵感 — 首页和画布底部都有随机创意推荐，点击即可开始创作
• 撤销 / 重做 — 完整的操作历史，放心大胆地实验
• 项目管理 — 多个项目独立保存，随时在首页切换
• 批量下载 — 点击右上角导出按钮，下载画布中所有生成的素材
• 素材自动同步 — 画布中生成或上传的素材自动同步到主界面历史记录（v5.5 新增）
• 深色模式 — 右上角切换主题，自动跟随系统设置
• API 配置 — 右上角齿轮图标，配置连接地址和密钥

无限画布适合需要反复调整和组合多张图片的创作场景，如概念设计、分镜绘制、素材加工等。简单的图片/视频生成推荐使用创作工坊。

5. 智能体

浏览智能体

智能体是"定制版的 AI 角色"，你可以给 AI 设定特定身份、能力和知识背景。

例如：面试官、翻译助手、客服 NPC、代码审查员……

智能体管理页面：浏览、搜索和创建 AI 智能体

5.2 使用智能体

在侧边栏找到「AI智能体」→ 点击智能体名称 → 查看历史会话或新建对话。

侧边栏展示（v5.4.7 改进）

智能体在侧边栏以单节点形式展示，显示头像、名称和会话数量，不再展开子列表。点击后右侧弹出会话列表面板。

进入智能体会话后，所有配置自动切换到该智能体的专属设置，离开时恢复全局配置。对话气泡始终显示智能体的名称和头像。

5.3 创建智能体

打开智能体管理 → 点击「+ 创建 AI 智能体」

独立配置（v5.4.5 新增）

为每个智能体独立设置专属配置，进入会话时自动生效：

每个设置旁都有「恢复默认」按钮。设置已迁移到云端，换电脑/浏览器自动同步。

5.4 智能体会话列表

点击智能体先看到历史会话列表

点击侧边栏的智能体，先展示该智能体的历史会话列表：

• 查看之前和这个智能体的所有对话记录
• 点击某条会话 → 继续之前的聊天
• 点击「+ 新建」→ 开始全新的对话
• hover 会话项右侧显示删除按钮，可直接删除单条会话
• 会话按最近活跃时间排序，方便快速找到

这个改进让你不会重复创建新会话，轻松延续之前的对话。删除会话有二次确认，不用担心误删。

5.5 分享智能体

智能体广场：浏览、搜索和分享 AI 智能体

创建好的智能体可以分享给同事使用：

• 打开智能体广场
• 找到你创建的智能体，点击分享按钮
• 复制生成的分享链接
• 将链接发送给同事
• 同事打开链接即可一键添加该智能体到自己的列表

智能体广场

在智能体广场中可以：

5.6 创建智能体详解

创建智能体界面：设置名称、提示词和分类

打开智能体广场 → 点击「+ 创建 AI 智能体」

• 名称：给智能体起个好记的名字（如"周报助手"、"翻译官"）
• 设定描述：告诉 AI 它的角色和行为规则（即系统提示词）
• 分类：选择所属类别，方便其他人在广场中找到
• 点击「创建 AI 智能体」完成创建

创建后可以随时编辑。支持一键让 AI 帮你生成头像和提示词模板。

5.7 克隆智能体 & 权限保护（v5.8 新增）

为了解决分享智能体的权限安全问题，v5.8 对智能体权限体系进行了全面重构：

克隆为我的智能体

看到别人的好用的智能体？一键克隆即可拥有自己的副本，自由修改配置：

• 在智能体广场 / 右键菜单 / 详情抽屉中点击「克隆为我的智能体」
• 系统自动创建名为"原名（克隆）"的副本，visibility 为 private
• 克隆后自动进入编辑界面，可自由修改名称、提示词、模型等全部配置
• 克隆体拥有全新的 share_id，与原智能体完全独立

权限保护机制

注意事项：克隆功能复制完整配置（模型、思考级别、知识库开关、记忆范围、工坊偏好等），但知识库文档内容不随克隆复制（知识库属于原智能体创建者）。

6. 知识库

管理知识库

上传文档到知识库后，AI 在回答时会自动检索你的资料，给出更准确的回答（RAG 技术）。

6.1 上传文档

• 打开：设置 ⚙️ → 个性化 → 「知识库」标签页
• 点击「上传」→ 选择文件（PDF、Word、TXT 等）
• 系统自动解析并建立向量索引

6.2 URL 导入

输入 URL（每行一个，最多 10 个）→ 系统自动抓取网页内容并索引。

6.3 知识库配额

6.4 使用原理

AI 收到问题 → 自动搜索知识库 → 找到相关段落 → 基于资料回答。这就是 RAG 技术：先查资料，再回答。搜索精度经过优化校准，闲聊时不会返回无关结果，专业问题能精准命中。

7. 文件处理

7.2 文件预览面板（v5.4.5 新增）

上传文件后，预览面板固定在聊天区右侧停靠（类似 Chrome 开发者工具），聊天区自动让出空间：

• 边聊边看：左侧对话，右侧预览文件，无需切换
• 拖拽调整：拖拽分割线自由调整预览面板宽度
• 文档卡槽：输入框上方显示「📄 文档(3)」卡片，点击查看文件列表，可逐个删除或追加
• 移动端适配：手机自动切换为全屏模式

7.3 支持的文件类型

7.4 文档解析

上传文档后可以让 AI：总结要点、翻译、分析数据趋势、写会议纪要……

8. 个性化设置

打开个性化设置

个性化面板：自定义指令、记忆、知识库、实验功能

8.1 自定义指令

8.2 记忆功能

打开记忆设置

记忆标签页

**强烈建议开启「会话同步」：**多设备无缝切换，清除缓存也不丢聊天记录。 立即开启

会话恢复

如果你发现侧边栏会话列表突然变少、刷新后又恢复不了，先检查「会话同步」是否已经打开，再点击这里的：

恢复聊天记录

这个按钮会从云端重建你的会话列表索引，适合本地缓存异常、浏览器重置、换设备后会话显示不完整的情况。

已经手动删除过的会话不会被恢复。若恢复后仍看不到完整会话，请联系管理员处理云端数据。

智能记忆更新（v5.4.5 新增）

AI 现在不仅能新增记忆，还能自动更新和删除已有记忆：

• 你说"我搬到上海了" → AI 自动把"住在北京"更新为"住在上海"
• 你说"忘掉我之前说的饮食偏好" → AI 精准删除相关记忆

不再会出现记忆越积越多、旧信息和新信息矛盾的问题。

8.3 帮助中心

设置 ⚙️ → 「帮助」，打开独立的帮助页面，图文并茂地介绍所有功能和操作指南。帮助面板支持拖拽调整宽度，不遮挡聊天区。

8.4 其他设置

• 主题切换：亮色 ☀️ / 暗色 🌙 / 自动 🌓
• 纯净模式：AI 回复更简洁直接
• 桌面通知：AI 回复完弹出提醒

9. 素材管理

打开素材中心

素材库：我的素材、历史生成、历史上传、公共素材 - **顶部上传按钮**：素材库顶部新增上传入口，支持多文件同时上传（v5.4.22 新增） - **音频卡片播放**：音频素材卡片显示播放按钮，直接预览（v5.4.22 新增） - **AI 自动标签**：上传后自动识别内容添加标签 - **批量操作**：批量打标签、批量分享 - **公共素材**：浏览同事分享的素材 - **历史记录云端化**：历史生成/上传记录改为数据库存储，换设备不丢失（v5.5 新增）

10. 任务列表

生成图片或视频时，任务会在后台排队执行。打开任务列表面板可实时查看所有任务的进度和状态。

入口：点击右上角头像 → 设置菜单 → 📋 任务列表，面板从右侧滑入。

11. 视频编辑器

视频编辑器是内置的轻量级剪辑工具，支持多片段时间线编辑、变速、分割、单帧截图和片段导出。适合对 AI 生成视频做快速后处理。

入口：在创作工坊视频消息中，点击视频卡片上的「✂️ 编辑」按钮，或从素材中心打开任意视频。

视频编辑器：左侧预览区 + 右侧属性面板 + 底部时间线 + 顶部工具栏

11.1 时间线剪辑

时间线标尺会自动根据总时长调整刻度。入点/出点的橙色高亮区间在时间线上实时显示。

11.2 变速

选中视频片段后，右侧属性面板可调整播放速度（0.1x ~ 10x）：

变速示例：点击 0.25× 后片段时长 0:08 → 0:32，时间线标签变为橙色「0.3×」

变速后片段在时间线上的宽度自动等比缩放（慢速变宽，快速变窄）。入点/出点同步等比缩放，保持相对位置不变。拼合导出时后端对每段单独做变速处理，支持任意组合。

变速标签会显示在片段右上角（如「2.0×」），方便一眼确认。播放预览时 playbackRate 实时跟随片段速度。

11.3 导出片段

使用入点/出点圈定要导出的区间，再点击「导出片段」生成文件。

单帧预览弹窗：支持下载、保存到素材库、追加到视频轨道

设置入出点

• 把播放头移到区间起点 → 点击「入点」按钮（或按 I）
• 把播放头移到区间终点 → 点击「出点」按钮（或按 O）
• 时间线橙色区域即为选定的导出范围

导出设置

点击「开始导出」后系统调用后端 ffmpeg 处理，完成后可直接下载或保存到素材库。

导出弹窗顶部有循环播放预览，以选定区间和对应片段速度预览实际效果，确认无误再导出。

入点/出点设置后时间线橙色高亮显示导出区间

GIF 导出采用两步调色板生成，颜色更鲜艳，文件通常比同分辨率 MP4 大。若只需要分享动图，推荐降低帧率（10-15fps）和分辨率（360p-480p）以控制文件大小。

12. 消息中心

站内消息列表

查看系统更新公告、新功能通知。支持筛选已读/未读、点赞和评论。打开消息中心

13. 分享功能

• 分享对话：顶部「分享聊天」按钮 → 生成链接
• 分享智能体：右键智能体 → 分享
• 分享消息：悬停消息 → 点击分享按钮

14. 高级技巧

14.1 提示词写作指南

好的提示词是高质量 AI 输出的关键。以下是从官方文档和实践中总结的系统化指南：

基础法则

进阶技巧

**核心原则：**Claude 官方推荐的"提示词工程"最佳实践——Be clear, Be specific, Give examples, Let Claude think（清晰、具体、举例、让模型思考）。越是复杂的任务，越值得花时间写好提示词。

14.2 最佳实践

模型选择策略

效率提升技巧

• 善用快捷键：Ctrl+K 搜索会话，Ctrl+↑/↓ 浏览历史消息，Ctrl+V 粘贴图片
• 智能体模板化：把高频使用的提示词创建为智能体（如周报助手、翻译官），一键复用
• 会话置顶：重要会话右键置顶，始终在手边
• 合理使用深度思考：只在复杂推理时开启，日常对话不开更省 Token
• 联网搜索按需开启：查最新信息时开，写创意内容时关（AI 更有创造力）
• 素材素材中心：AI 生成的所有内容自动保存，随时回顾和复用

Claude Code 使用建议

• 选择合适的模型：日常编码用 Sonnet 4.6，大型重构用 Opus 4.7，快速迭代用 DeepSeek V4 Flash
• 利用 [1M] 模型：标注 [1M] 的模型支持百万级上下文，适合分析大型代码库
• 缓存自动生效：同一会话多轮对话自动享受缓存优惠，无需手动配置
• 工具调用：GPT-5.5 等模型现已支持完整的工具调用功能（function calling）

**省 Token 小技巧：**开启新会话时 AI 会从头读取全部历史。如果话题跳转较大，建议新建会话以节省上下文。定期清理不用的旧会话可以让侧边栏更清爽。

15. 开放API (OpenAPI)

13.1 简介

冰川GPT 提供 OpenAI 兼容的开放API，供公司内部所有 AI 应用场景统一调用。无需对接多家 AI 厂商，只需一个 API 地址 + 一个密钥，即可访问平台上 50+ 款大模型的能力。

**核心价值：**统一入口、统一计费、统一管理。各团队不需要各自申请和维护 AI 厂商的 API Key，直接使用冰川GPT 的开放API 即可。

13.2 接口列表

LLM 聊天

图片生成

视频生成

Claude / Gemini 兼容

Embeddings

完整的 API 文档请查看：/openapi.json（OpenAPI 3.0 规范）

13.3 应用场景

13.4 快速接入

认证方式

所有接口通过 API Key 认证，支持以下方式（任选其一）：

Python 示例（使用 OpenAI SDK）

from openai import OpenAI

client = OpenAI(
 api_key="sk-xxx", # 在开放平台自助创建
 base_url="https://你的域名" # 冰川GPT 地址
)

response = client.chat.completions.create(
 model="gpt-5.4-mini",
 messages=[{"role": "user", "content": "你好"}]
)
print(response.choices[0].message.content)

AI 编程工具配置（Claude Code / Kilo Code / Open Code 等）

Base URL: https://你的冰川GPT域名
API Key: sk-xxx（在开放平台自助创建）
Model: 选择需要的模型（如 claude-sonnet-4-6, gpt-5.4 等）

Claude Code 专用配置（环境变量）：

ANTHROPIC_API_URL=https://你的冰川GPT域名
ANTHROPIC_API_KEY=sk-xxx

⚠️ API 行为重要变更（v5.8）

• 未知模型返回 404：使用未在系统中配置的模型名调用 API 将返回 404 model_not_found（之前会静默 fallback 到默认模型），请确认客户端传参正确
• /v1/models 智能过滤：Claude 客户端（User-Agent 含 "Claude"）访问时只返回 Anhropic 兼容模型列表，支持 ?limit=N 参数控制数量

**如何获取 API Key？**现在可以在开放平台自助创建（见 13.5 节），也可联系管理员申请。每个密钥支持配额控制和有效期设置。

13.5 开放平台（自助管理）

v5.4.6 推出全新的 API 开放平台，公司员工可以自助创建和管理 API Key，无需联系管理员。

入口：设置菜单 ⚙️ → 开放平台，或直接访问 /open-platform 打开开放平台

开放平台首页：模型广场、定价信息、快速入口

平台功能

用量统计（v5.4.9 新增）

用量统计：总览面板 + 每日趋势图 + 密钥/模型分布 + 调用明细 - **总览面板** — 总消费、请求次数、Token 用量、生成图片/视频数 - **分类金额卡片** — 文字/图片/视频三类费用独立显示，点击可按类型过滤明细（v5.4.22 新增） - **日期区间选择** — 支持自定义日期范围查询（v5.4.22 新增） - **每日消费趋势** — 柱状图展示每日花费，点击柱子可过滤当天明细 - **密钥/模型分布** — 各密钥和模型的调用量、费用占比 - **调用明细** — 逐条查看每次调用的时间、密钥、模型、Token 分项（输入/输出/缓存创建/缓存命中）、费用，支持按密钥/模型/类型筛选 - **冰川GPT终端** — 直接使用冰川GPT的用量也统计在内

支持 7/30/90 天维度切换及自定义日期区间。点击趋势图柱子或密钥名称可快速过滤明细。

13.6 API Key 自助管理

API 令牌管理界面：查看密钥状态、额度和有效期

创建 API Key

• 打开开放平台 → 点击左侧「API 密钥」
• 点击右上角「+ 新建 API 密钥」
• 填写名称，设置配额上限和过期时间（可选）
• 点击创建，立即复制完整密钥（密钥仅在创建时完整显示一次！）

管理操作

**注意：**外部用户（公众人员）无法访问开放平台。密钥创建后仅显示一次完整内容，请务必妥善保存。每位用户最多创建 20 个密钥。

16. 常见问题

Q：模型那么多，我该选哪个？

A：日常聊天用 GPT-5.4 Mini 或 Claude Haiku 4.5；编程用 Claude Sonnet 4.6；复杂推理用 Claude Opus 4.7；中文写作用 Qwen3.6-Max 或 DeepSeek V4 Pro。详见 最佳实践。

Q：Claude Code 怎么配置使用冰川模型？

A：设置环境变量 ANTHROPIC_API_URL 和 ANTHROPIC_API_KEY 即可，详见 Claude Code 适配指南。

Q：视频生成选哪个模型好？

A：推荐 HappyHorse 1.0——生成快（~2分钟）、效果对标 Seedance 2.0、无严格审核。需要音频或视频延长选 Seedance 2.0。详见 视频模型对比表。

Q：AI 回复不准确怎么办？

A：1. 提供更多上下文 2. 切换更强模型 3. 开启深度思考 4. 开启联网搜索 5. 优化提示词（参考提示词指南）

Q：图片/视频生成失败？

A：1. 检查描述是否含敏感内容 2. 更换模型（Seedance审核严可换HappyHorse）3. 点击气泡下方的「AI诊断」按钮分析原因 4. 查看任务列表了解具体错误信息

Q：怎么克隆别人的智能体？

A：在智能体广场 / 右键菜单 / 详情抽屉中点击「克隆为我的智能体」即可一键复制。查看详情

Q：智能体会不会被别人误改？

A：不会。v5.8 已全面加固权限：他人无法编辑/删除你的智能体，知识库有独立权限隔离，云端同步自动过滤。查看详情

Q：会话记录会丢失吗？

A：先开启「会话同步」，再在「个性化 → 记忆」里点一次「恢复聊天记录」。去开启 / 恢复 如果是管理员帮你恢复的，刷新后仍看不到完整列表，也可以再点一次恢复按钮让本地索引重新同步。

Q：怎么让 AI 记住我的偏好？

A：开启记忆功能

Q：AI 太啰嗦？

A：开启「纯净模式」（设置 → 纯净模式）。

Q：能让 AI 主动聊天吗？

A：打开「主动聊天」开关

Q：多浏览器能同步吗？

A：打开「会话同步」开关

Q：会话列表突然变少怎么办？

A：先到「个性化 → 记忆」检查会话同步是否打开，再点击「恢复聊天记录」。如果还是不完整，联系管理员用后台会话恢复工具检查云端数据。

Q：可以用手机访问吗？

A：可以，手机浏览器打开访问地址即可。

Q：无限画布和创作工坊有什么区别？

A：创作工坊是对话式交互，适合快速生成单张图/视频；无限画布是节点式工作流，适合多步骤、多素材组合的美术创作。查看详情

Q：视频编辑器支持哪些功能？

A：支持多片段时间线剪辑、修剪头尾、分割、变速（0.1x~10x）、单帧截图、入出点导出（MP4/GIF）。在创作工坊视频消息中点击「✂️ 编辑」进入。查看详情

Q：怎么获取 API Key？

A：打开设置菜单 → 开放平台，自助创建即可。查看详情

Q：页面显示异常怎么办？

A：建议使用 Chrome 浏览器访问。如果显示异常，按 Ctrl + F5 强制刷新。钉钉内置浏览器有时会缓存旧版本资源。

附录

A. 支持的 AI 厂商

B. 支持的文件格式

冰川GPT 用户手册 · 版本 {{ app_version }}

如有问题欢迎在冰川GPT 中直接提问，AI 助手会帮你解答