Appearance
书灵工坊
书灵工坊是你的 AI 能力控制台：在这里挑模型、造 Agent、装 Skill、攒提示词，并决定助手能用哪些工具。
这篇是界面操作指南，只讲每个分区里做什么、改完什么时候生效。Agent、Skill、工具、模型分别负责什么，见 Agent、Skill、工具与模型。
入口：顶部导航 → 书灵工坊。「工坊目录」分成四组：
| 分组 | 分区 | 用来做什么 |
|---|---|---|
| 模型与渠道 | 模型 | 服务商与模型库 |
| 调用用量 | 概览、分析与明细 | |
| 智能体 | 墨灵助手 | 默认助手 · 身份、提示词与能力 |
| 创作智能体 | 从灵感到成稿的平台智能体 | |
| 我的智能体 | 自己创建的智能体与协作 | |
| 能力 | 市场 | 发现并安装工具、Skill 和提示词 |
| 工具 | 我的 MCP / OpenAPI 连接 | |
| 技能 | 安装、编写与发布技能 | |
| 提示词 | 模板、变量与快捷指令 | |
| 偏好与权限 | 偏好设置 | 助手开关与模型偏好 |
| 执行权限 | 审批模式与白名单 |
建议的配置顺序
先把模型配好（模型），再调 Agent（创作智能体 / 我的智能体），最后定边界（执行权限与偏好设置）。
自定义 Agent
创建一个
「我的智能体」→ 新建 Agent，需要填：
- 名称（必填），例如「悬疑剧情策划师」
- 头像、分组、标签
- 模型：可以直接选一套，也可以开启「按来源顺序自动切换」，让它在几种来源之间按顺序取用
保存后进入详情页继续配提示词与能力。头像统一走图片上传，本地图片也能用。
详情页的五个页签
| 页签 | 配什么 | 谁能改 |
|---|---|---|
| 基础设定 | 名字、头像、说明、分组、标签、运行模型 | 自定义 Agent 全部可改；内置 Agent 只能改分组、标签、模型 |
| 提示词 | 角色提示词，叠加在平台规则之上 | 改不了平台的核心规则 |
| Skill | 它掌握的方法与流程 | 分「全局 Skill」与「专属 Skill」 |
| 工具 | 它能调用的外部能力 | 分「全局工具」与「专属工具」 |
| 协作 | 它能委派任务的伙伴 | 只能选已启用、能参与会话的 Agent |
几个要点：
- 改动会自动保存，侧栏会显示「已自动保存」「待保存」或「保存中…」。
- 内置 Agent 改过之后卡片会标「已改」，并给你一个「恢复默认」；未改的不会显示。
- 自定义 Agent 顶部有启用开关。启用后才成为墨灵助手的协作者，也才会出现在输入框的智能体候选里；停用即断开。
- 默认的墨灵助手不能作为别人的协作者——它自己会自动发现可委派的伙伴。
- 切到「专属 Skill」或「专属工具」时，如果这个 Agent 还没有属于你的版本，页面会先请你创建；自定义 Agent 天然已有自己的版本。
批量改模型
- 「创作智能体」页页头有「批量应用」，「我的智能体」同样有。它作用于当前筛选出来的列表。
- 一个弹窗里选范围、模型和参数，提交后整批生效；不会带上灵感与自动标题这类轻量任务。
- 只想动一个 Agent 的一个字段时，用列表里的快捷配置即可，其他没动的字段会保留。
- 创作智能体页顶部还有一行「灵感 · 标题 · 幽灵续写来源」摘要，点「设置」展开完整控件，配的是灵感与自动标题用的模型，改完自动保存。
模型中心（BYOK）
「模型」页左侧是渠道列，右边是这个渠道的模型。墨灵是平台渠道，只读；其余都是你自己接入的服务商。
视频教程
不想看文字？可以看 B 站视频：【墨灵小说使用教程】第一期：用墨灵优雅的配置自定义模型。更多视频见 视频教程。
接入自己的服务商
- 新建服务商，填名称、接口地址、密钥。
- 保存前可以先「检测」，确认这个地址和密钥能通。
- 折叠的「配置」区里能改名称、接口地址、密钥，并切换协议（对话补全 / 响应接口）。
- 展开「高级设置」还能指定模型列表路径、请求路径，以及自定义 Headers（每行一条
Name: Value，密钥值不会回显）。 - 更多操作里有清理凭据、停用服务商、删除服务商。
管理模型
- 「拉取」从上游同步模型目录：单个添加会先打开参数弹窗确认，批量则「按默认添加」。
- 模型列表按「已启用 / 已禁用」分组，支持搜索和类型筛选，每个模型一行开关。
- 「测活」会真的打一次请求：正常会显示耗时，异常会显示「异常」并可以点开看失败详情。
- 编辑模型里可以改上下文窗口、最大输出、能力开关（工具、图片识别），以及是否支持思考。选上「支持思考」后可以设默认思考参数；模板识别不出来的渠道，还能自己勾选「思考档位」，输入框里只会显示你启用的档位。
API Key 只在安全表单里录入
密钥填在模型中心的输入框里就够了，不要发进聊天，也别写进提示词或 Skill 文件。页面只显示脱敏指纹，不回显明文。
文本与图片分开选
Agent 的模型槽位里，文本模型和生图模型是两件事：
- 文本槽位用来读懂需求、写提示词；图片槽位负责出图。
- 图片槽位默认用平台图片模型，也可以换成你自己接入的图片模型——能不能选，以页面实际给你的选项为准。
- 按张计费的视觉任务里，文本槽位不额外计费，图片按成功张数计费。
具体扣费口径以页面上的计费说明为准。
Skill 市场与导入
「技能」页有三个标签：Skill 库、市场、草稿。
装别人的 Skill
- 在「市场」里搜索并「安装到个人库」。装的是共享发布包，会自动跟随市场更新，更新只影响后续新任务。
- 「Skill 库」左侧目录可以切「全部 Skill」「个人发布」「市场安装」，还能按标签叠加筛选；顶部有「本页启用」「本页停用」。
- 想二次修改：在市场安装项上「复制为草稿」，你会得到一份不受市场更新影响的独立副本，原安装项仍然保留。
- 个人库行尾的开关只对墨灵助手生效；其他 Agent 要在自己的 Skill 页单独分配。
导入自己的包
「导入」支持两种来源：
| 来源 | 说明 |
|---|---|
| 本地 ZIP | 一个包里可以有多个 Skill |
| 链接 | GitHub 仓库 / 目录 / 文件 / 归档 / 发布页、HTTPS ZIP、单个 SKILL.md |
流程是先「解析来源」，再勾选要导入哪些 Skill（只有一个候选会自动选中，多个候选默认都不选），最后选「导入为草稿」或「导入并发布」。只含 SKILL.md 的链接会明确提示缺少旁边的脚本与素材。
草稿不等于可用
草稿里可以改文件、看文件树、校验和发布。草稿不会生效；发布后还要到目标 Agent 的 Skill 页启用，新任务才会用上，运行中的任务不会中途换。
最常见的误会
「装好了」不等于「用上了」。安装 / 导入 → 在 Agent 里分配并启用 → 下一个新任务才生效。
提示词模板库与市场
「提示词」页按创作分类筛选：全部、收藏、通用、灵感、设定、角色、剧情、大纲、正文、润色；左侧标签可以与分类叠加，搜索覆盖名称、指令、标签和正文。
攒自己的模板
「新建提示词」可以填名称、说明、正文、快捷指令、标签和素材图：
- 正文里写
会被自动识别，每个变量可以设展示名和默认值。 - 快捷指令支持中英文，聊天里输入
/加指令即可调用。
在聊天里用
- 输入框以
/（或／）开头会唤起快捷面板，排序是收藏优先，然后最近使用、使用次数、更新时间。 - 没有变量的模板直接插入；有变量的会弹出填写窗口，边填边看实时预览，必填项没填完不能插入。
- 模板只替换你这次要发送的正文，不会改变你本轮已选的引用、联网或其他能力状态。
消息操作区还能把内容「保存为提示词」；对助手的回复，多一个「整理为 Skill 草稿」，把一段跑通的流程沉淀成可复用能力。
从市场安装
提示词页右上角「去市场」可以安装精选模板：装完就是你自己的副本，可以改内容、设快捷指令、收藏，市场后续改动不会影响它。
执行权限中心
「执行权限」有两个页签：默认权限、白名单。页头会一直显示你当前是「继承系统默认」还是「个人设置」。
| 策略 | 说明 |
|---|---|
| 每次询问 | 每一次工具调用都先暂停等你确认，适合试用新能力 |
| 白名单 | 已选工具可直接执行；其余工具会在真正调用前征求你的同意 |
| 完全放行 | 不再弹执行确认，只在你完全信任当前工作环境时使用 |
- 白名单始终保留为一份「可预配置集合」，即使当前不是白名单模式，也可以先把清单勾好。
- 白名单目录按业务分组和外部来源展示，支持搜索、筛选与批量勾选。
- 「恢复系统默认」会清掉你的个人覆盖，之后平台调整系统默认时会自动跟随；它也会丢弃未保存的草稿。
- 保存后影响后续新任务，不会中断正在运行的任务。
偏好设置
独立分区，改完即生效，没有保存按钮，跟随你的账号。
| 分组 | 项 | 说明 |
|---|---|---|
| 对话体验 | 生成式 UI | 开启后墨灵可以在回答里直接写出图表、清单或小工具这类可交互的网页片段；关闭后它只会输出普通文本 |
| 对话体验 | 动态临时 Agent | 开启后助手遇到复杂任务时，可以把它拆成几块交给多个临时子 Agent 并行处理，最后汇总成一条回答；关闭后所有工作都由主 Agent 依次完成 |
| 模型 | 上下文压缩模型 | 会话过长需要压缩历史时用来写摘要的模型。留空表示跟随当前对话模型 |
| 模型 | 动态临时 Agent 模型 | 临时子 Agent 干活时用的模型。留空表示跟随父 Agent |
生成式 UI 的用法与适用场景见 生成式 UI。
「模型」一栏右上角有「计费说明」，可以按计费方式或按功能查看每条规则与免费模型名单，详见 数据中心与用量。
用量与调用追踪
「调用用量」分五个视图：
| 视图 | 看什么 |
|---|---|
| 概览 | 调用量、成功率、Token、缓存命中、模型与渠道分布、每日趋势 |
| 分析 | 针对当前时间范围的进一步拆解 |
| 明细 | 一次模型调用一行 |
| 任务 | 按任务聚合，能看整条执行链路 |
| 会话 | 按会话聚合 |
- 顶部可以选时间区间，以及模型范围（整个渠道的全部模型，或某一个模型）。
- 「明细」的列包括时间、模型、Agent、渠道、状态、协议、思考、输入、输出、缓存命中、缓存命中率、工具、首字 / 总耗时。
- Agent 一列显示可读名称（你自建的 Agent 也会解析成名字），模型一列显示实际调用的模型；自带模型还会额外标出上游模型名。
- 每行右侧可以打开「调用详情」，或直接跳到「任务追踪」「会话追踪」；也可以复制任务 ID / 运行 ID 反馈问题。
- 任务追踪有独立页面地址，可以直接收藏或分享给别人。
数据保留说明
概览统计会持续汇总保留；调用详情、任务追踪和临时运行会话最多保留 30 天。过期的明细查不到，但总览数字仍然在。
「调用用量」之外的消费与账单，在个人设置的资产与明细里看。两者关系见 数据中心与用量。