Skip to content

USER_GUIDE.md

Latest commit

 

History

History
324 lines (247 loc) · 7.68 KB

USER_GUIDE.md

File metadata and controls

324 lines (247 loc) · 7.68 KB

Muses 使用指南

🤖 AI驱动的博客文章生成平台

从素材到高质量博客文章的完整流程指南

📋 目录

🚀 快速开始

1. 访问平台

打开浏览器访问：http://localhost:3004

2. GitHub登录

  • 点击"使用GitHub登录"按钮
  • 授权Muses访问你的GitHub账户
  • 自动跳转回平台主页

3. 基础配置

首次登录后需要配置以下信息：

  • OpenAI API Key（用于AI文章生成）
  • 默认GitHub仓库（用于文章发布）
  • GitHub访问Token（用于仓库操作）

⚙️ 初次设置

OpenAI API Key配置

  1. 获取API Key

    • 访问 OpenAI官网
    • 创建新的API Key
    • 复制密钥（注意保存，只显示一次）

  2. 在Muses中配置

    • 进入"设置"页面
    • 找到"OpenAI配置"部分
    • 粘贴API Key并保存
    • ✅ 平台会加密存储你的密钥

GitHub集成设置

  1. 创建GitHub Personal Access Token

    访问：https://github.com/settings/tokens
点击：Generate new token (classic)
权限选择：
✅ repo (完整仓库访问权限)
✅ public_repo (公共仓库权限)
✅ write:packages (包写入权限)

  2. 配置默认仓库

    • 在设置中填写你的博客仓库URL
    • 格式：https://github.com/用户名/仓库名
    • 例如：https://github.com/Rain1601/myblog

🤖 创建AI写作助手 (Agent)

为什么需要Agent？

每个Agent都是一个个性化的AI写作助手，具有独特的：

  • 写作风格和语调
  • 专业领域和专长
  • 目标受众定位
  • 内容长度偏好

创建流程

  1. 进入Agent管理

    • 点击侧边栏"Agents"
    • 点击"创建新Agent"

  2. 基本信息

    Agent名称：技术博客专家
描述：专注于前端技术和开发实践的写作助手

  3. 写作风格配置

    语调：专业且易懂
风格：实用导向，包含代码示例
长度：中等长度 (800-1500字)
目标受众：前端开发者

  4. 自定义提示词

    你是一位资深的前端开发专家，擅长将复杂的技术概念
用简单易懂的方式解释。请：
- 提供实用的代码示例
- 包含最佳实践建议
- 添加可能的坑和解决方案
- 保持内容的时效性

Agent管理技巧

  • 多样化Agent：为不同类型内容创建专门的Agent

    • 技术教程Agent
    • 产品分析Agent
    • 个人思考Agent
    • 新闻总结Agent

  • 定期优化：根据生成效果调整Agent配置

📝 生成文章流程

方法一：上传文件生成

  1. 支持的文件类型

    • 📄 PDF文件
    • 📋 Markdown文件
    • 📝 纯文本文件

  2. 操作步骤

    进入"生成文章" → 选择Agent → 上传文件 → 等待处理 → 查看结果

  3. 处理过程

    • 系统自动提取文件内容
    • AI分析并理解素材
    • 根据Agent风格重新组织
    • 生成完整的博客文章

方法二：对话式生成

  1. 适用场景

    • 想法还不够完整
    • 需要交互式探讨
    • 希望逐步完善内容

  2. 操作流程

    选择Agent → 开始对话 → 描述你的想法 →
AI提问和建议 → 完善内容 → 生成最终文章

方法三：文本输入生成

  1. 直接输入

    • 粘贴现有文档内容
    • 输入要点和大纲
    • 提供参考资料

  2. AI处理

    • 自动整理结构
    • 补充相关内容
    • 优化表达方式

🔧 GitHub集成设置

仓库配置

  1. 创建博客仓库（如果还没有）

    # 在GitHub上创建新仓库
# 建议命名：username.github.io 或 blog-repo

  2. 目录结构建议

    your-blog-repo/
├── posts/          # 文章目录
├── assets/
│   └── images/     # 图片目录（Muses自动使用）
├── _config.yml     # 配置文件（如果使用Jekyll）
└── README.md

发布路径配置

在文章发布时，你可以自定义：

  • 文件路径（如：posts/2024/）
  • 文件名格式
  • 提交信息模板

🖼️ 图片管理

GitHub图床功能

Muses提供内置的GitHub图床功能：

  1. 工作原理

    • 图片上传到你的GitHub仓库
    • 自动存储在assets/images/目录
    • 生成GitHub Raw URL供访问
    • 与文章一起管理，永久可用

  2. 使用方式

    • 在编辑器中直接粘贴图片
    • 或使用上传按钮选择文件
    • 系统自动处理并插入链接

  3. 图片命名

    格式：image_YYYYMMDD_HHMMSS_唯一ID.扩展名
例如：image_20241201_143022_a7b8c9d2.png

图片优化建议

  • 文件大小：建议单张图片不超过1MB
  • 格式选择：PNG（高质量）、JPG（平衡）、WebP（最优）
  • 命名规范：使用描述性名称便于管理

📤 发布文章

发布前检查

  1. 内容检查

    • 文章标题和结构
    • 代码语法高亮
    • 图片显示正常
    • 链接可访问

  2. 元数据设置

    ---
title: "文章标题"
date: 2024-12-01
tags: [技术, 前端, React]
category: 开发
---

发布选项

  1. 直接发布

    • 一键发布到GitHub仓库
    • 自动提交到主分支
    • 实时更新博客网站

  2. 保存草稿

    • 暂时保存到平台
    • 后续可继续编辑
    • 完善后再发布

  3. 自定义发布

    • 选择目标分支
    • 自定义文件路径
    • 添加自定义提交信息

发布后管理

  • 查看发布状态：在文章列表中查看发布状态
  • 更新文章：修改后可重新发布
  • 版本管理：通过GitHub查看文章变更历史

❓ 常见问题

技术问题

Q: OpenAI API调用失败怎么办？ A: 检查API Key是否正确，余额是否充足，网络是否正常。

Q: GitHub发布失败？ A: 确认GitHub Token权限充足，仓库地址正确，网络连接正常。

Q: 图片上传失败？ A: 检查图片大小，确认GitHub Token有仓库写入权限。

使用技巧

Q: 如何写出更好的自定义提示词？ A:

  • 明确角色定位
  • 描述具体要求
  • 举例说明期望效果
  • 定期根据结果调整

Q: 如何选择合适的Agent？ A: 根据内容类型、目标读者、写作风格来选择匹配的Agent。

Q: 文章生成质量不满意怎么办？ A:

  • 调整Agent配置
  • 提供更详细的素材
  • 使用对话模式逐步完善
  • 手动编辑生成结果

账户和安全

Q: 数据安全如何保障？ A:

  • API Key加密存储
  • 数据仅存储在你的设备和选择的仓库中
  • 支持随时删除账户和数据

Q: 如何备份我的文章？ A: 所有文章都发布到你的GitHub仓库，天然具备版本控制和备份功能。

🎉 开始你的创作之旅

现在你已经掌握了Muses的完整使用流程！

建议的第一步操作：

  1. ✅ 完成基础配置（API Key、GitHub设置）
  2. ✅ 创建第一个Agent
  3. ✅ 尝试上传一个文档生成文章
  4. ✅ 测试GitHub发布功能
  5. ✅ 探索图片上传和管理

持续优化：

  • 根据写作需求创建多个专业Agent
  • 建立自己的文章模板和风格
  • 利用GitHub仓库管理你的知识库

🔥 开始创造属于你的高质量内容吧！

有问题？查看 常见问题 或联系技术支持