项目首页：项目、工作区与分享

登录后的首页是你的项目库。左侧栏提供新建与导入入口、视图切换、工作区列表和账户菜单；中间是项目列表。

项目类型

KloseDoc 支持四种项目类型，前三种共用同一套编辑器、协作和分享能力：

新建项目

点击左侧栏 新建项目：

1. 填写 项目名称（最多 160 个字符）。
2. 选择 项目类型，默认是 LaTeX。
3. 对话框底部会显示创建位置：“创建到我的项目”或“创建到工作区‘X’”，取决于当前打开的是哪个视图。
4. 点击 创建项目。文档项目直接进入编辑器，网页演示项目进入发布页。

新项目会带一个最小的起始模板，没有其他模板可选。

导入已有项目

导入 ZIP

点击 导入 ZIP，选择或拖入一个包含 Markdown、LaTeX 或 Typst 项目的 ZIP 压缩包（默认最大 100 MB，一次一个）。文件夹结构和图片、字体等资源会被保留。

• 项目名称 留空时使用 ZIP 文件名，文件名里的 - 和 _ 会替换成空格。
• 写作格式 可以选“自动识别”或指定 Markdown / LaTeX / Typst。
• 网页演示项目不能通过 ZIP 导入，请在发布页上传。

从 GitHub 导入

点击 从 GitHub 导入。第一次使用需要先 连接 GitHub，授权 GitHub App，并在 GitHub 上把 App 安装到你的账号或组织、勾选要使用的仓库。连接后：

1. 在 仓库 下拉框中选择仓库，看不到新仓库时点 刷新仓库。
2. 可选填写 项目名称，默认使用仓库名。
3. 若仓库同时包含多种格式，需要选择 项目类型 和 主文件。
4. 点击 导入仓库。

导入后项目与仓库保持连接，可以在编辑器中 Pull 和 Push，见协作与版本。首次同步限制为 100 个文件、100 MB 源码，不支持 Git LFS、submodule 和符号链接。

视图、搜索与列表

左侧栏提供四个视图：

• 最近使用：你拥有和被共享的项目，按最近打开时间排序。
• 我的项目：只显示你拥有的项目，按更新时间排序。
• 与我共享：他人共享给你且你已接受的项目。
• 回收站：你自己移入回收站的项目。

列表包含 项目、工作区、所有者、更新时间 和 操作 五列。项目名旁有类型标记；所有者是你自己时显示“你”，否则显示对方名字，悬停显示邮箱；更新时间显示相对时间（如“3 小时前”），悬停显示精确时间。更新时间反映最后一次内容编辑，而不是重命名。

顶栏的 搜索项目 按项目名称过滤当前视图或工作区，不搜索正文。列表每次加载 50 个项目，底部有加载更多按钮。视图、工作区、搜索词会写进地址栏，刷新和前进后退都能回到原位。

在宽度 820px 以下的屏幕上，左侧栏收起为 ☰ 抽屉。

工作区

工作区是你个人的整理标签，用来把项目分组。工作区不会共享给他人；你可以把自己的项目和“与我共享”的项目都归入工作区，这不影响项目所有者和其他协作者看到的位置。

• 新建：点击左侧栏“工作区”旁的 ＋，填写名称（最多 80 个字符），点击 创建工作区。名称不能重复。
• 打开：点击工作区名称即可查看其中的项目。此时新建或导入的项目会直接进入该工作区。
• 重命名 / 删除：工作区旁的 ⋯ 菜单。删除工作区不会删除项目，项目会回到“我的项目”或“与我共享”。
• 移动项目：把项目行拖到左侧栏的某个工作区上，或拖到 我的项目 上移出工作区；也可以在项目 ⋯ 菜单中选 移动到工作区…。

工作区只有一层，不能嵌套。

项目操作

每一行末尾的 ⋯ 菜单：

• 所有人可用：打开项目、下载源码压缩包、移动到工作区…。
• 仅所有者可用：重命名项目、移至回收站；网页演示项目还有 发布演示。
• 在回收站中：恢复、永久删除。顶栏的 清空回收站 会永久删除回收站里的全部项目。

回收站不会自动清空。项目在回收站期间，它的分享链接会失效。

分享与成员

分享在编辑器里操作：打开项目后点击工具栏的 分享，进入“分享此项目”面板。面板顶部显示 当前在线 的协作者。

邀请成员（仅所有者）

在 邀请成员 区填写对方的 邮箱地址，选择权限 可编辑 或 可查看，点击 邀请。对方必须已经注册 KloseDoc 账号。

被邀请的人会在自己的项目首页顶部看到“项目邀请”卡片，可以 接受 或 忽略。接受前，成员列表里会标记“等待接受”。所有者可以随时修改成员角色或用 × 移除成员。

链接分享（仅所有者）

在 链接分享 区打开开关，会生成两个链接：

• 可编辑链接：打开者必须登录，登录后自动成为编辑者。
• 只读链接：无需登录即可查看；已登录用户打开后自动成为查看者。

通过链接加入的项目会出现在对方的“与我共享”视图中。已经是编辑者的成员不会因为打开只读链接而降级。关闭开关会让两个链接立即失效；再次打开会生成新的链接，旧链接不再可用。

非所有者在分享面板里只能复制当前项目链接。

权限一览

账户菜单

点击左下角的头像和名字：

• 管理后台：仅管理员可见。
• 邀请好友：见注册与登录。
• Agent 接入：创建 MCP 令牌，让 Codex、Claude Code 等 Agent 操作你的项目，见Agent 接入。
• 连接 GitHub：连接后显示为“GitHub: 用户名”。
• 深色模式 / 浅色模式。
• 退出登录。

目前没有修改显示名称或密码的界面。

限制

这些上限由管理员在后台调整。超出时编辑器或导入对话框会给出错误提示，例如“一个项目最多可包含 1000 个文件”。