> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 创建你的第一个项目

> 在 SoloEnt 中设置新的写作项目

在 SoloEnt 中，每部作品都是一个独立的项目，存储在你本地电脑的文件夹中。

<Info>
  Agent 会根据需要在你的项目文件夹中自动创建和组织文件。
</Info>

## 创建新项目

<Steps>
  <Step title="选择位置">
    选择你想创建项目的父文件夹。
  </Step>

  <Step title="创建新文件夹">
    点击 **New Folder** 并为你的项目命名。
  </Step>

  <Step title="在 SoloEnt 中打开">
    SoloEnt 会自动打开你的新项目文件夹。
  </Step>
</Steps>

## 打开现有项目

<Steps>
  <Step title="点击打开">
    在 SoloEnt 中选择 **Open Folder**。
  </Step>

  <Step title="导航到项目">
    浏览到你的项目文件夹位置。
  </Step>

  <Step title="选择文件夹">
    选择项目文件夹并点击 **Open**。
  </Step>
</Steps>

<Warning>
  始终打开 **项目文件夹**，而不是单个文件。这样 Agent 才能管理你的整个项目结构。
</Warning>

## 文件夹权限

<Accordion title="为什么 SoloEnt 需要文件夹访问权限？" icon="lock">
  **首次访问：**

  * 你的系统可能会出于安全原因请求你的密码
  * 这将授予 SoloEnt 读写文件的权限

  **安全性：**

  * 权限仅限于你打开的特定文件夹
  * SoloEnt 无法访问你系统的其他部分
  * 你可以随时在系统设置中撤销权限
</Accordion>

## 项目组织建议

<CardGroup cols={2}>
  <Card title="每个文件夹一个项目" icon="folder">
    将每部作品保存在自己的专用文件夹中
  </Card>

  <Card title="使用描述性名称" icon="tag">
    使用清晰的项目名称（例如 "SciFi-Novel-2026"）
  </Card>

  <Card title="使用版本控制" icon="code-branch">
    使用时间线跟踪版本历史
  </Card>

  <Card title="避免特殊字符" icon="circle-exclamation">
    只使用字母、数字、连字符和下划线
  </Card>
</CardGroup>

## 打开后会发生什么？

打开项目文件夹后：

1. **文件管理器填充**：左侧面板显示你的项目结构
2. **Agent 激活**：准备好帮助你完成写作任务
3. **编辑器就绪**：开始创建或编辑文件
4. **一切准备就绪**：开始你的创作之旅

## 开始你的第一次写作会话

<Steps>
  <Step title="告诉 Agent 你的想法">
    在 Agent 对话中描述你想写什么。

    例如："我想写一本关于年轻巫师的奇幻小说"
  </Step>

  <Step title="让 Agent 设置结构">
    Agent 会创建必要的文件夹和初始文件。
  </Step>

  <Step title="开始写作">
    开始创作你的大纲、角色或第一章。
  </Step>
</Steps>

## 故障排除

<AccordionGroup>
  <Accordion title="无法打开文件夹">
    * 检查文件夹权限
    * 确保文件夹存在且路径正确
    * 尝试创建新文件夹
    * 重启 SoloEnt 并重试
  </Accordion>

  <Accordion title="权限被拒绝">
    * 在提示时输入系统密码
    * 检查系统安全设置
    * 尝试其他文件夹位置
    * 以适当的权限运行 SoloEnt
  </Accordion>

  <Accordion title="文件不显示">
    * 确认你打开的是文件夹，不是文件
    * 检查文件夹是否包含兼容的文件
    * 刷新文件管理器
    * 重启 SoloEnt
  </Accordion>
</AccordionGroup>

## 下一步

<CardGroup cols={2}>
  <Card title="规划模式" icon="lightbulb" href="./plan-mode">
    学习使用 Agent 进行战略规划
  </Card>

  <Card title="编辑器功能" icon="pen-to-square" href="./Editor">
    掌握写作编辑器
  </Card>

  <Card title="Agent 命令" icon="terminal" href="./commands">
    使用强大的写作命令
  </Card>

  <Card title="方法论" icon="book-open" href="./methodology">
    理解 SoloEnt 的写作方法
  </Card>
</CardGroup>