Creator OS 使用手册

Creator OS 是面向微信公众号、自媒体和企业新媒体团队的 AI 内容运营工作台。本手册依据当前产品代码、接口和 v0.5.38 线上界面核对，覆盖从首次配置到推送公众号草稿箱的完整流程。

重要：Creator OS 会帮助你采集、写作、配图、排版和评审，但不会替代事实核查、版权审核和最终发布判断。当前“一键推送”只创建微信公众号草稿，不会自动群发。

快速开始

先认识五个主入口

登录工作台后，左侧固定显示五个入口：

第一次登录

全新部署第一次打开时，需要创建本地管理员账户。密码至少 8 位，并同时包含文字和数字。正式公网环境建议使用 12 位以上的独立密码。

普通试用账户需要管理员从后台生成邀请码。用户可以在登录页选择“有邀请码？注册试用账号”，输入用户名、密码和邀请码完成注册。设置中心不提供邀请码生成功能。

建议的首次配置顺序

按下面顺序配置，可以减少后续排错：

1. 打开“设置 > 模型接入”，先配置并检测文字模型。
2. 配置图片模型，确认模型确实支持横向比例生成。
3. 打开“写手库”，检查至少一个写手的名称、简介和完整提示词。
4. 打开“图片风格”，确认封面比例为 2.35:1，正文配图为 16:9。
5. 打开“话题分类”和“情报信源”，保留真正需要关注的分类与来源。
6. 需要推送公众号时，再配置 AppID、AppSecret 和 IP 白名单。
7. 回到“今日”，确认四项创作环境检查均已完成。

不连接公众号也可以使用情报、选题、写作、配图、排版预览和复制 HTML。

模型接入

推荐 API 申请入口

这些链接只用于申请接口。Creator OS 不会读取平台账户密码；你只需要把平台提供的 API Key、Base URL 和模型 ID填入“设置 > 模型接入”。不要把 API Key 发到群聊、截图或问题反馈中。

配置文字模型

进入“设置 > 模型接入 > 文本模型”。选择预设平台或新增连接，然后填写：

以 DeepSeek 官方兼容接口为例，当前产品预设为：

接口协议：OpenAI 兼容对话接口
Base URL：https://api.deepseek.com/v1
模型 ID：deepseek-chat
API Key：你的 DeepSeek API Key

填写后执行以下操作：

1. 点击“保存文本模型配置”。
2. 点击“检测此模型”。
3. 看到“连接正常”和实际耗时后，再设为当前模型。
4. 返回选题页进行一次短文章生成测试。

“已保存”不等于“可调用”。只有检测成功，才能证明当前地址、协议、模型和 Key 能完成真实请求。

配置图片模型

进入“设置 > 模型接入”，点击顶部“图片模型”。系统会直接显示 65535 gpt-image-2 连接；如需申请 Key，可点击 GPT Image 2 中转。Creator OS 支持多种图片协议，具体是否可用取决于服务商接口。至少确认三件事：

1. 当前模型可以返回真实图片文件或可下载地址。
2. 当前模型能够接收目标比例参数。
3. 返回图片的真实像素比例通过系统复核。

文章封面默认目标比例是 2.35:1，对应微信公众号头条封面约 900×383。正文配图默认是 16:9。系统要求模型直接按目标比例生成，不使用裁切、补边、拉伸或二次扩图来伪造比例。

如果接口返回的原图比例不合格，本次任务会失败，并保留失败信息供重试，不应覆盖当前已保存图片。

模型故障排查

文字或图片生成失败时，按这个顺序检查：

1. 在“模型接入”点击“检测此模型”。
2. 核对接口协议，不要把 Anthropic 接口当成 OpenAI 兼容接口。
3. 核对 Base URL 是否包含正确版本路径。
4. 核对模型 ID 是否真实存在且账户有权调用。
5. 检查 Key 是否过期、额度不足或被限流。
6. 查看右下角任务中心的具体错误，不要连续重复提交。
7. 管理员查看服务日志中的 HTTP 状态码和供应商返回信息。

写手与修改动作

管理写手库

进入“设置 > 写手库”。每个写手包含：

• 名称：在选题和文章中显示。
• 简介：帮助用户快速判断适用场景。
• 完整提示词：决定写作角色、结构、语言、事实边界和禁用表达。

可以新增、编辑、删除和拖动排序。修改完成后点击“保存当前设置”。删除和排序会写入当前账户的数据，刷新后不应恢复旧状态。

一个可用的写手提示词至少应说明：

# 角色
你为哪类读者写作，擅长哪些主题。

# 判断方式
如何处理事实、争议、因果和反方解释。

# 结构
开头如何进入，正文如何推进，结尾如何收束。

# 语言
句子长度、术语密度、口语程度和常用表达。

# 禁止事项
禁止编造数据、虚构引语、使用空泛套话或省略来源边界。

配置局部修改

进入“设置 > 局部修改”，可以配置正文选区弹出的动作。每个动作包含按钮名、说明和提示词。

在内容编辑区选中文字后，选择一个动作。系统只把选区、动作要求和当前文章上下文发给文字模型，完成后只替换选中的文字。

建议动作使用明确动词，例如“压缩一半”“补充证据边界”“改成自然口语”。不要使用“优化一下”这类无法验收的指令。

图片风格与品牌素材

四种图片资产不要混淆

文章封面不会覆盖品牌头图。品牌头图也不占用公众号消息封面的位置。

编辑图片风格

进入“设置 > 图片风格”。你可以：

• 修改全局补充要求。
• 新增、修改和删除图片风格。
• 编辑每个风格的名称、说明和完整提示词。
• 拖动调整风格顺序。
• 设置文章封面和正文章节图比例。

全局补充要求会叠加到当前选中的图片风格。提示词应描述画面主体、构图、色彩、材质、信息密度和禁止事项，不要只写“高级”“好看”。

品牌与素材

进入“设置 > 品牌与素材”，配置公众号名称、主题色、作者简介、品牌头图和尾图。上传图片按原文件保存，不裁切、不缩放、不做二次处理。

生成品牌图时，系统只根据卡片中的提示词和独立比例字段发起请求。要出现公众号名称、Slogan、人物或安全区，必须在提示词里明确写出。

话题与情报信源

话题分类

“设置 > 话题分类”是情报中心和今日话题分布的统一数据源。每个话题可设置名称、语义范围、关键词和启用状态。

话题名称负责界面识别，语义范围说明“收什么”和“不收什么”，关键词用于初步匹配。分类范围越清楚，后续情报筛选越稳定。

情报信源

“设置 > 情报信源”支持 RSS、网站、Reddit 和需要 Key 的 API 类型。可以检测全部信源、查看最近延迟、启用、停用、编辑或删除自定义信源。

内置信源通常只能停用，自定义信源可以删除。刷新失败时先检测信源，不要反复点击情报页刷新。

今日创作台

“今日”用于判断系统是否准备好，以及当前最值得处理的内容。页面包括：

• 文字模型、品牌素材、公众号和情报刷新检查。
• 情报总量、高价值信号、内容项目和草稿完成率。
• 写手数量、活跃信源和本地数据量。
• 关注话题分布与优先处理队列。

这里的数字是导航和诊断入口，不是最终业务报表。遇到“正在读取”长时间不结束时，先访问 /api/health，再检查浏览器网络请求和服务日志。

情报与素材采集

浏览情报

情报页支持日期、话题和搜索筛选。打开一条情报后，可以查看来源、摘要、相关度、命中话题、关键词和原始链接，并把需要的内容加入选题。

导入网页或公众号文章

从情报页或选题页打开素材采集：

1. 选择归属话题。
2. 粘贴公开的 HTTP 或 HTTPS 链接。
3. 点击解析并导入。
4. 检查标题、摘要、正文和来源是否完整。

需要登录、强反爬或高度动态渲染的网页可能无法完整解析。系统会拒绝私有地址、局域网地址和保留地址。

上传本地文档

当前明确支持 .docx、.txt、.md、.markdown、.html 和 .htm。PDF 不在素材采集箱的明确支持列表中。

联网搜索

输入搜索话题、语言范围和结果数量后开始搜索。搜索结果不会自动全部进入素材库，必须选择需要的结果并执行解析导入。联网搜索依赖服务端可用的搜索服务配置。

从选题生成文章

组织写作上下文

选题页包含三组来源：

• 已选情报：从情报页主动加入。
• 导入素材：网页、搜索结果或本地文档。
• 已用历史素材：过去文章真正保存过的来源。

只有本次主动勾选的内容会进入生成上下文。系统不会把整个素材库自动混入每篇文章。

写作角度

写作角度可以是一段判断、一个问题或一个标题灵感。没有情报素材时，也可以直接输入灵感生成内容。

一段有效角度通常回答：

发生了什么变化？
谁会受到影响？
为什么是现在？
有哪些事实和反方解释？
读者看完可以做什么？

启动生成

选择写手后点击“生成并进入内容项目”。文章生成会进入后台任务，通常包含素材分析、按写手生成、风格检查、问题修复和保存。

任务开始后可以切换到其他页面。后台任务不会因为离开选题页而自动中断。不要因为没有立即跳转就重复创建同一任务。

编辑内容项目

内容项目列表

内容页左侧是项目列表，可以新建空白项目、打开文章、修改标题和删除项目。桌面端可拖动项目栏右边缘调整宽度。

删除文章需要确认。成功删除后不应通过刷新恢复，删除前请确认已经备份需要保留的正文和素材。

正文编辑

正文编辑区包含独立标题、公众号摘要、Markdown 正文、章节结构和全文改写。保存快捷键：

Windows：Ctrl + S
macOS：Command + S

推荐正文结构：

## 为什么这件事现在发生

正文段落。

### 一个需要单独解释的问题

继续解释。

> 引用、摘要或需要强调的判断。

- 列表项一
- 列表项二

**重点内容**

文章标题在独立标题框中填写，正文不必重复 # 标题。

插入原文图片

在“正文图片”区域可以从当前文章关联素材中插入原文图片，也可以上传或粘贴图片。素材图只来自当前文章的来源，不混入其他文章的封面和生成图片。

全文改写

在右侧输入具体要求后点击“一键改写全文”。结果会替换当前正文并保存。高风险改写前建议先复制原文，因为当前产品没有完整的可视化版本差异比较器。

生成封面与配图

生成文章封面

进入“内容 > 封面与配图”：

1. 确认当前文章封面比例。
2. 选择图片风格。
3. 点击“生成封面”。
4. 在右下角任务中心查看调用、比例验证和保存状态。
5. 成功后预览原图，确认文字、人物和主体没有被裁切。

封面提示词会明确要求模型直接输出 2.35:1 横向画布。系统不会先生成其他比例再裁切。

生成章节配图

可以为单个章节生成，也可以使用“随机选 3 个章节配图”或“一键全部章节配图”。随机生成的章节图使用各章节卡片自己选择的图片风格，不强制继承封面风格。

批量任务中，成功和失败按每张图片独立记录。失败项可以从任务中心或对应图片卡片重试，已经成功的图片不应被重复生成覆盖。

切换历史图片

封面和章节图会保留历史版本。使用上一张、下一张切换当前版本。打开大图后可使用左右按钮或键盘方向键切换，按 Esc 关闭。

公众号排版

Markdown 转微信 HTML

“公众号排版”会把独立标题、摘要、章节、小标题、引用、列表、图片、代码和表格分别转换，并使用内联样式提高微信编辑器兼容性。

选择与预览主题

选择排版主题后点击刷新排版。预览画布接近微信后台宽度，并提供多档缩放。复制 HTML 后仍建议在微信后台执行手机预览。

重点检查：

• 首屏标题和摘要换行。
• 封面、头图、章节图和尾图是否完整。
• 列表、引用、代码和表格在窄屏上的表现。
• 外部链接是否符合公众号规则。

导入外部排版

系统可以学习 Doocs CSS 或公开公众号文章中的允许样式。外部 CSS 会经过安全过滤，不会原样执行 javascript:、外部 url()、危险定位和动画属性。

学习公众号文章可能受反爬、登录、重定向和版权限制。只学习排版结构，不复制文章内容。

专家评审

专家评审包含三种角色：标题传播、配图视觉和正文内容。每次评审都会真实调用当前可用的文字模型，并生成新的评审编号和更新时间。

评审开始后可以切换页面，任务会继续执行。评审结果可能包含总分、问题、标题候选、图片建议和正文修改建议。

如果所有模型线路都失败，本次结果不会覆盖旧评审。页面会显示失败原因并允许重试。

评审是模型建议，不是真实传播数据，也不能替代事实核查、版权审核和人工判断。

检查与推送

发布前检查

“检查与发布”会检查标题、摘要、正文长度、排版、专家评审和封面。专家评审可以跳过，未评审只显示风险提示，不应伪装成公众号未连接。

连接微信公众号

进入“设置 > 公众号与账号”，填写公众号名称、AppID 和 AppSecret，并启用目标账号。AppSecret 保存后不明文回显。

微信接口还要求服务器公网出口 IP 在公众平台白名单内。保存账号后回到发布页重新检查连接状态。

一键推送

推送前系统会保存正文、检查微信状态、上传封面和正文图片，然后创建公众号草稿并保存 media_id。成功后文章状态变为“已推草稿”。

当前不会自动群发。请进入微信公众平台草稿箱继续预览、修改和人工发布。

历史推送会记录成功或失败状态、时间、公众号和错误摘要，便于排查重复推送或接口失败。

后台任务与重试

文章生成、全文改写、封面、批量配图和专家评审都会进入右下角任务中心。任务会显示名称、阶段、进度、成功或失败状态。

正确的处理方式：

1. 先看任务是否仍在推进。
2. 切换页面不会自动终止后台任务。
3. 失败后阅读具体错误，再使用“重试”。
4. 不要连续点击同一生成按钮制造重复任务。
5. 图片批量任务按成功数和失败数分别结算。

设置保存与数据

设置如何保存

写手、动作、图片风格、话题、信源、模型和品牌配置都属于当前账户。编辑完成后点击“保存当前设置”。模型编辑器也有独立的“保存配置”按钮。

删除和排序成功后，刷新页面不应恢复。若恢复，通常表示保存失败、并发版本冲突、数据目录未持久化或旧部署重新加载了 seed。

导出脱敏设置

“设置 > 系统与缓存”可以导出脱敏共享设置。导出包可以包含话题、写手、动作、图片风格和模型元数据，但不会包含 API Key、AppSecret、登录密码、文章正文、私有素材和图片文件。

数据备份

当前产品主要使用按用户隔离的 JSON、Markdown 和工作区文件，不是关系型数据库。正式部署必须备份完整持久化目录。只备份 GitHub 代码不能恢复用户文章和设置。

常见问题

写作一直失败

先在模型接入页检测当前文字模型。再检查任务中心和服务日志。重点核对协议、Base URL、模型 ID、Key、额度和超时。不要通过重复点击判断是否恢复。

图片失败但后来出现成功结果

以服务器图片任务的最终状态为准。批量任务可能部分成功、部分失败。页面应分别显示成功数和失败数；失败项可以重试，不应把整个批次简单判为全部失败。

封面看起来像被裁切

先打开原图预览并检查真实像素。封面目标是约 2.35:1，不是 16:9。如果原图本身比例不对，说明图片供应商没有遵守比例参数；如果原图正确但预览缺内容，属于前端容器显示问题。

设置删除后又恢复

停止重复删除，先导出脱敏设置并备份数据。管理员检查设置保存接口、版本冲突、持久化磁盘和部署是否重新加载默认 seed。

情报刷新失败

进入“设置 > 情报信源”执行全部检测。区分单个信源失败、全部失败、能够连接但没有新条目、搜索 Key 缺失和网络超时。

已连接微信但仍提示未连接

检查当前启用公众号、AppID、AppSecret、服务器出口 IP 白名单和 /api/wechat/status 返回。保存公众号后应重新读取连接状态。

页面很慢或一直加载

依次检查：

1. /api/health 是否返回 200。
2. 浏览器 Network 中哪个接口最慢。
3. 服务器 CPU、内存和磁盘。
4. 是否存在多个重复后台任务。
5. 持久化目录是否可读写。

当前产品边界

• 当前推送到公众号草稿箱，不自动群发。
• 当前没有微信 OAuth 或消息回调流程。
• PDF 不在素材采集箱明确支持列表中。
• 视频接口存在，但主内容流程不是完整的视频编辑产品。
• 专家评审是模型建议，不是事实或传播效果保证。
• 当前主要使用本地持久化文件，不适合多个服务副本同时写同一目录。
• 公开 SaaS 还需要更完整的组织权限、配额、审计、找回密码、对象存储、数据库和持久队列。

提交问题时提供什么

请提供页面、操作、期望结果、实际结果、是否稳定复现、版本 commit、浏览器、脱敏错误提示，以及是否影响数据。

不要提供 API Key、AppSecret、登录密码、Session Cookie、未脱敏用户资料或完整私有文章。