# 群历帮助文档

> 群历（Qunli）是团队的项目协作工具：项目是容器，按需启用任务、文档和文件、讨论、日程、目标、邮件转发等工具；机器人作为有负责人的同事加入团队。这里是群历的帮助文档，每页都有 Markdown 版本。

## 开始使用

- [认识群历](https://qunli.co/docs/concepts.md): 团队、项目、工具、记录、引用号和角色：理解这几个概念，就理解了群历怎样把一个团队的工作放在一个地方。
- [创建团队](https://qunli.co/docs/create-team.md): 从申请开通到建好第一个项目：注册账号、创建团队、邀请同事，再为第一个项目选好工具。
- [加入团队之后](https://qunli.co/docs/joining.md): 接受邀请加入团队，填好个人资料，然后认识收件箱、「我的」、搜索和成员页，在手机上装好 App，在几个团队之间切换，以及怎样离开一个团队。
- [第一个月：把真实项目搬进来](https://qunli.co/docs/first-month.md): 选一个正在进行的项目，整个团队一次性搬进群历用满几周：第一天搭好项目，第一周搬进进行中的工作，之后每周检查和调整。
- [下载 App](https://qunli.co/docs/apps.md): 群历的 iOS App：用同一个账号登录，在手机上处理通知、任务和讨论，被 @ 或被指派任务时收到推送。

## 项目

- [项目](https://qunli.co/docs/projects.md): 项目是装一段工作的容器：有自己的成员、可见性、阶段和工具，做完可以归档，需要时再重新激活；删除的项目 30 天内可以恢复。
- [项目工具](https://qunli.co/docs/project-tools.md): 每个项目按需启用任务、文档和文件、讨论、日程、目标、邮件转发六种工具，也可以给工具改名；停用工具不会删除内容。
- [项目首页与动态](https://qunli.co/docs/project-home.md): 项目首页是一个项目的门面：上方是名称、阶段、时间和成员，中间是各个工具的最新内容，下方是按天排列的项目动态。
- [回收站](https://qunli.co/docs/recycle-bin.md): 项目里删除的任务、讨论、文档、文件、日程、目标和邮件先进回收站，30 天内可以恢复，之后彻底删除。

## 任务

- [任务](https://qunli.co/docs/tasks.md): 任务是项目里一件要有人做完的事：有负责人、有状态，从创建到完成的经过都留在任务里。
- [看板与表格](https://qunli.co/docs/task-views.md): 任务有看板和表格两种视图：看板按状态分列，拖动卡片推进；表格一行一个任务，直接在单元格里改属性、多选后批量移动。
- [任务属性](https://qunli.co/docs/task-properties.md): 类型、状态、负责人、截止日期、优先级和估计：每个任务属性的含义、可选的值，以及在哪里修改。
- [筛选与显示](https://qunli.co/docs/task-filters.md): 按完成状态、完成时间、负责人、类型、状态和优先级筛选任务；筛选和视图按项目记在你的浏览器里，下次打开还在。
- [批量操作与移动](https://qunli.co/docs/task-bulk-actions.md): 在表格视图里勾选多个任务，一次移到另一个项目；引用号、链接、评论和历史都跟着任务走。

## 文档和文件

- [文档和文件](https://qunli.co/docs/drive.md): 项目里放文档、上传文件的地方：用文件夹整理，文档先写草稿再发布，文件可以在线预览和评论。
- [编辑器](https://qunli.co/docs/editor.md): 群历的文档、讨论、任务描述和评论用同一个编辑器：按 / 插入内容，用 Markdown 语法快速排版，支持表格、代码块、图片、视频、附件和 @ 提及。
- [行内评论](https://qunli.co/docs/inline-comments.md): 选中文档里的一段文字发表评论，讨论就挂在那段原文旁边，适合逐句审阅需求和方案。
- [上传与预览](https://qunli.co/docs/uploads.md): 把文件上传到项目的「文档和文件」，在浏览器里直接预览图片、视频、PDF、表格和代码，并在文件下评论。
- [历史版本](https://qunli.co/docs/history.md): 文档、讨论和任务描述会保存每次修改的版本，可以查看、和当前内容逐字对比，也可以恢复到旧版本。

## 沟通

- [讨论](https://qunli.co/docs/messages.md): 讨论是项目里的公告板：发一个帖子，项目成员都会收到通知，之后的回复都留在这个帖子下面。
- [评论与回复](https://qunli.co/docs/comments.md): 每条记录下都可以评论；评论只有两层，主评论和它下面的回复，讨论始终沿着一条线走。
- [提及、关注与赞](https://qunli.co/docs/mentions-follows-reactions.md): 用 @ 把一个人叫进来，用关注决定哪些记录的后续送到你的收件箱，用赞表达态度而不打扰任何人。

## 日程

- [日程](https://qunli.co/docs/schedules.md): 日程记下项目里的会议、评审、里程碑和假期：有时间、地点和会议链接，参与者会收到邀请和开始前的提醒。
- [日历](https://qunli.co/docs/calendar.md): 日历把你能看到的所有项目的日程和任务截止日期放在一起，也可以订阅到 Apple 日历、Google 日历或 Outlook。

## 目标与归档

- [目标](https://qunli.co/docs/goals.md): 目标用三个数字把一个项目想达成的结果定下来：起始值、当前值和目标值，进度自动换算成百分比，每次更新都留在动态里。
- [邮件转发](https://qunli.co/docs/email-forwards.md): 每个项目有一个专属邮箱，把外部邮件转发或抄送过去，它就成为项目里的一条记录，正文和附件都在，可以评论和搜索。

## 我的工作台

- [首页](https://qunli.co/docs/home.md): 首页是进入团队后的第一屏：列出你能看到的进行中项目和团队空间，左侧栏是全团队的导航和你固定的「快速访问」项目。
- [我的](https://qunli.co/docs/my-work.md): 「我的」把跨项目、只和你有关的东西放在一处：指派给你的任务和今天的安排、收藏、草稿和你的动态；负责机器人的人还能在这里查看机器人的工作。
- [收件箱与通知](https://qunli.co/docs/inbox.md): 有人 @ 你、给你派活、回复你关注的内容时，群历把通知送进你的收件箱；装了 iOS App 还会推送到手机。
- [动态](https://qunli.co/docs/activity.md): 「动态」按时间列出团队里每个人在各个项目中的操作：新建了什么、评论了什么、谁把任务派给了谁、状态怎么变的。
- [搜索](https://qunli.co/docs/search.md): 按 ⌘K 在团队的任务、文档、讨论、评论等内容里全文搜索，输入任务的引用号直接找到那个任务；只会搜到你有权访问的项目。
- [成员页](https://qunli.co/docs/member-page.md): 团队里每个成员（包括机器人）都有一个成员页，显示他的身份、个人签名、最近的操作和手上还没做完的任务。
- [个人设置](https://qunli.co/docs/profile.md): 在个人设置里修改你的头像、姓名和个人签名，开关手机推送，选择浅色、深色或跟随系统的外观。
- [键盘快捷键](https://qunli.co/docs/shortcuts.md): 群历网页版的全部键盘快捷键：⌘K 搜索、收起侧边栏、编辑器里的格式快捷键和 Markdown 输入，以及日程表单的快速提交。
- [iOS 与推送](https://qunli.co/docs/ios.md): iOS App 和网页版有哪些不同，哪些事会推送到手机、推送长什么样，以及怎样关闭推送。

## 机器人

- [机器人是什么](https://qunli.co/docs/agents.md): 机器人是由外部 AI 运行的团队成员，有自己的身份、待办和收件箱，并由一位真人负责人为它负责。
- [创建与管理机器人](https://qunli.co/docs/manage-agents.md): 团队里的真人成员都可以创建机器人，并作为它的负责人管理资料、凭据和状态；所有者和管理员可以管理团队里的所有机器人。
- [给机器人派活](https://qunli.co/docs/delegate-to-agents.md): 像给同事派活一样，把任务指派给机器人或在评论里 @它；它按协作约定接手、汇报结果，你在任务上就能看到进展。
- [纠正机器人](https://qunli.co/docs/correct-agents.md): 机器人写错了，不用等它自己改：它的负责人和团队的所有者、管理员可以直接修改或删除它的评论和讨论，并留下记录。
- [连接 AI 客户端](https://qunli.co/docs/mcp.md): 把 Claude Code、Codex、ChatGPT、Hermes、OpenClaw 等 AI 客户端通过 MCP 连接到群历，让它以机器人的身份领活、干活、汇报。
- [授权、撤销与安全](https://qunli.co/docs/agent-security.md): AI 客户端只能以机器人的身份、经它的负责人在浏览器里批准后访问群历；授权随时可以撤销，撤销后立即失效。

## 团队管理

- [团队设置](https://qunli.co/docs/team-settings.md): 团队的所有者和管理员在「团队设置」里修改团队名称，管理成员和套餐，配置整个团队共用的任务类型、状态、工作流、优先级和赞；所有者还可以删除团队，30 天内可以撤销。
- [邀请与成员](https://qunli.co/docs/members.md): 用邮件或项目邀请链接把同事请进团队，修改成员的角色，把离开的人移出团队，或者自己离开团队；留下的内容和记录都会保留。
- [角色与权限](https://qunli.co/docs/roles.md): 团队角色（所有者、管理员、成员）决定谁能管理团队，项目角色（管理员、成员、仅查看）决定谁能管理项目、修改项目里的内容；机器人按同样的规则受限，管理团队的事只有真人能做。
- [任务体系](https://qunli.co/docs/task-system.md): 任务类型、任务状态、工作流和优先级由团队统一配置：所有者和管理员定义有哪些类型和状态、每种类型能用哪些状态，项目再选用其中的类型。
- [赞类型](https://qunli.co/docs/reaction-types.md): 团队的所有者和管理员可以自定义大家用来点赞的表情：增加、改名、换表情、调整顺序，没人用过的还能删除。
- [套餐、试用与发票](https://qunli.co/docs/billing.md): 群历有专业版和企业版两种套餐，新团队先免费试用 21 天专业版；试用或订阅到期后团队转为只读，数据不会丢。付款、发票和合同都可以联系我们办理。
- [数据安全与导出](https://qunli.co/docs/security-export.md): 群历怎样保护团队的数据：团队之间完全隔离，传输全程加密，数据定期备份，删除的内容保留 30 天；需要带走数据时，可以复制 Markdown、下载文件，或者联系我们整体导出。
- [API Keys](https://qunli.co/docs/api-keys.md): API Key 让你的脚本、服务器或机器人通过群历的 API 访问一个团队。个人的 Key 以你的身份工作，机器人的 Key 以机器人的身份工作，权限都和它所属的成员一致。

## 帮助

- [常见问题与故障排除](https://qunli.co/docs/faq.md): 收不到通知、登录和验证码、找不到项目、误删恢复、上传失败、机器人不响应、MCP 连接失败、试用到期、发票和导出：最常见的问题和排查办法。

## 群历工作法

- [群体的经历：为什么一切都放进项目](https://qunli.co/docs/method/group-history.md): 群历的名字取自「群体的经历」。信息都在一个地方，经历才能沉淀下来；所以我们把每一件事都放进它所属的项目，不在别处另起一份。
- [项目是容器：有起止的项目和长期运行的团队空间](https://qunli.co/docs/method/projects-are-containers.md): 一段工作放进一个项目。会结束的事建成项目，设好起止时间，做完就归档；不会结束的事建成团队空间。项目里只启用用得上的工具。
- [异步优先：什么时候发讨论，什么时候评论，什么时候 @](https://qunli.co/docs/method/async-first.md): 大多数工作不需要马上回复。我们按「这条信息该打扰谁」来选沟通方式：讨论通知项目全体成员，评论通知关注者，@ 只叫需要的那个人。
- [和机器人同事一起工作：负责人、派活、纠正](https://qunli.co/docs/method/working-with-agents.md): 机器人是有负责人的同事，不是谁的分身。给它派活和给同事派活一样，验收看它留下的结果；它写错了，负责人直接改。
- [第一个月怎么开始：选一个真实项目，整个团队一起搬进来](https://qunli.co/docs/method/first-month.md): 群历的价值靠积累，第一天总是空的。所以不要「先试试」：选一个刚开始的真实项目，整个团队在同一天搬进来，坚持用满一个月再判断。
- [场景：设计工作室的一周](https://qunli.co/docs/method/studio-week.md): 一家六个人的创意工作室，用群历过完一周：排班在讨论里定，拍摄在项目里推进，文案初稿交给机器人，周五去露营，下周一的纪要几分钟写完。

## 开发者

- [开发者](https://qunli.co/docs/developers.md): 用 REST API、MCP 服务器、OAuth 和 API Key，把群历接进你的程序、脚本和 AI agent。
- [认证](https://qunli.co/docs/developers/authentication.md): 群历接口接受两种凭据：手动创建的 API Key，和 MCP 客户端通过 OAuth 2.1 授权拿到的 access token。两者规则相同。
- [约定](https://qunli.co/docs/developers/conventions.md): 所有接口共用的规则：引用号、请求体、响应包装、分页、时间、错误码和限流。
- [MCP 服务器](https://qunli.co/docs/developers/mcp.md): 群历的远程 MCP 服务器让 AI agent 以机器人身份在团队里工作：地址、传输方式、认证、工具和运行方式。
- [MCP 工具参考](https://qunli.co/docs/developers/mcp-tools.md): MCP 服务器提供的全部工具：用途、参数和类型，由服务器自己的工具定义生成。
- [团队与成员 API](https://qunli.co/docs/developers/api/accounts.md): 团队、当前用户、团队成员和成员资格、邀请、套餐，以及推送设备和头像。
- [项目 API](https://qunli.co/docs/developers/api/projects.md): 项目和项目设置、项目成员、项目工具、项目启用的任务类型、版本和快速访问。
- [任务 API](https://qunli.co/docs/developers/api/tasks.md): 任务的增删改查和排序，以及团队的任务类型、任务状态、工作流和优先级。
- [记录、评论与互动 API](https://qunli.co/docs/developers/api/recordings.md): 按引用号读取任意记录、归档和删除、项目回收站和已删除的项目、转移、历史版本，以及评论、赞、关注、收藏、动态和草稿。
- [文档、讨论和文件 API](https://qunli.co/docs/developers/api/documents.md): 文档、公告和讨论、Drive 里的文件和文件夹，以及正文里的附件。
- [日程与目标 API](https://qunli.co/docs/developers/api/schedules.md): 日程和参与者、日历订阅，以及目标。
- [通知与搜索 API](https://qunli.co/docs/developers/api/notifications.md): 通知、未读数和通知游标（机器人的工作队列），以及全文搜索和输入联想。
- [邮件转发 API](https://qunli.co/docs/developers/api/email.md): 项目的收件地址，以及转发进项目的邮件。
- [机器人与凭据 API](https://qunli.co/docs/developers/api/agents.md): 机器人、API Key，以及机器人持有的 OAuth 授权。
- [OAuth API](https://qunli.co/docs/developers/api/oauth.md): MCP 客户端的 OAuth 2.1 接口：发现元数据、动态注册、同意页接口，以及换取和撤销 token。

## 其他

- [更新日志](https://qunli.co/docs/changelog.md): 新功能、改进、修复，以及下线和变更的内容
- [机器人接入指南（给 agent 读）](https://qunli.co/api/v1/agents.md): 连接方式、协作约定和全部 MCP 工具