QoderWork 中文教程

QoderWork 概览

QoderWork 是一款桌面端智能工作助手，将 Qoder 的 Agent 能力从代码领域扩展到日常工作场景。通过简单的自然语言对话，就能完成文件整理、数据处理、文档生成等任务，自动化你的多种场景。

核心能力

• 自主规划执行：理解复杂任务意图，自动拆解执行步骤；全程可见可控，实时掌握任务进展；遇到问题主动沟通，确保结果符合预期
• 能力可扩展：内置多种主流 MCP（模型上下文协议）工具；支持自定义 Skills，打造专属工作流；场景多样化，覆盖你的各类工作需求
• 本地安全运行：隐私安全可控，敏感数据本地处理；精细化权限控制，未经授权无法访问任何内容

典型场景

价格

QoderWork 支持 Qoder 账号登录，与 Qoder 账号共享 Credits。

常见问题

Q: 我的文件会被上传到云端吗？ A: QoderWork 的文件操作在本地完成，但为了实现 AI 理解和分析，相关文本内容会发送至大模型 API 服务商。

Q: AI 能访问我的哪些文件？ A: 只能访问你明确授权的工作目录，未授权的如确需访问会征求你的同意。

Q：适合什么样的用户？ A：想用 AI 的任何人，比如：

• 文件管理混乱的办公人员
• 需要处理大量文档的专业人士
• 希望自动化重复工作的知识工作者

QoderWork Skills

什么是 Skill？

在日常工作中，我们经常反复处理相似任务：写周报、整理文档、生成信息图等。若每次都要重新向 AI 说明需求、偏好和流程，不仅耗时，也容易遗漏关键细节。

Skills（技能）正是为解决这个问题而设计的。Skill 是一份提前写好的工作指南，告诉 QoderWork 在面对某一类任务时：遵循什么步骤、输出什么格式、注意哪些细节。只需定义一次，QoderWork 便能在后续每次对话中自动识别并应用，像训练有素的助手一样稳定、一致地完成工作。

从技术角度看，每个 Skill 本质上是一个包含 SKILL.md 文件的文件夹，存放于 ~/.qoderwork/skills/ 目录下。SKILL.md 用自然语言描述技能的名称、触发条件和执行步骤 —— 无需写代码，只需将工作经验和流程用文字表达清楚即可。

Skill 能带来什么？

• 告别重复解释：每次开启新对话，都需要花时间描述需求和偏好。有了 Skill，这些信息被一次性固化下来 —— 后续使用时只需一句话触发，甚至可以自动识别应用，省去大量重复沟通的时间。
• 保证输出一致性：当团队对某类产出有明确的格式、风格要求时（比如周报必须包含哪些板块），Skill 能确保每一次输出都符合既定标准，不会因为沟通偏差或执行者不同而出现质量波动。
• 个人经验变成可复用资产：工作中积累的最佳实践、处理技巧和判断标准，都可以通过 Skill 沉淀下来。它不仅服务于创建者本身，还可以分享给团队成员，让经验在组织内流转复用，而不是停留在个人脑海中。
• 让 AI 从「通才」变成「专才」：QoderWork 本身具备广泛的通用能力，而 Skill 就像给它加装了一个个专业模块 —— 文档处理专家、设计助手、数据分析师等。通过不同的 Skill 组合，QoderWork 可以适配工作中几乎所有的场景。

获取 Skill

• 在对话中搜索安装：直接用自然语言描述需求，QoderWork 通过内置的 find-skill 功能从技能库中检索并推荐最匹配的 Skill
• 在 Skill 广场浏览安装：Skill 广场是 QoderWork 内置的技能市场，汇集官方和社区贡献的各类 Skill
• 从开源社区获取：GitHub 等平台上有大量社区共享的 Skill
• 手动上传本地文件：已有写好的 Skill 文件时，在技能页面，点击安装技能，直接上传 SKILL.md 及辅助文件

使用 Skill

• 自动触发：直接描述需求，QoderWork 自动判断是否有匹配的 Skill 并启用
• @ 快捷调用：在对话输入框中输入 @，QoderWork 会弹出已安装的 Skill 列表，选择即可调用
• 对话中指定调用：直接在对话中指名使用某个 Skill

创建 Skill

• 从满意的任务中沉淀：当 QoderWork 出色完成了一项任务时，直接在对话中要求沉淀
• 与 QoderWork 对话共创：有明确的工作流程想要自动化时，可通过设置面板发起共创对话

QoderWork MCP

什么是 MCP？

MCP（Model Context Protocol，模型上下文协议）是一种开放协议，用于标准化 AI 应用与外部工具和数据源之间的连接方式。你可以把它理解为 AI 世界的 "USB 接口"—— 就像 USB 让各种外设即插即用一样，MCP 让 AI 能够以统一的方式调用各类外部服务。

在没有 MCP 之前，AI 助手只能基于对话上下文回答问题。接入 MCP 后，QoderWork 可以直接操作你的日历、查询文档、获取地图信息等，真正成为一个能 "动手做事" 的助手。

工作原理

MCP 采用客户端 - 服务端架构：

• MCP 客户端：即 QoderWork，负责发起请求并展示结果
• MCP 服务端：由各服务提供方（如钉钉、高德地图等）部署，负责执行具体操作并返回数据

当你在 QoderWork 中提出需求时，AI 会自动判断是否需要调用某个 MCP 服务，然后通过协议完成调用并将结果呈现给你 —— 你只需像平时一样用自然语言描述需求即可。

添加 MCP 服务

粘贴 JSON 配置

适合从 MCP 市场直接复制 JSON 配置的场景：

1. 点击 + 添加 → 粘贴 JSON 配置
2. 在弹出的对话框中，粘贴从 MCP 市场复制的 JSON 配置
3. 点击 导入 完成添加

手动填写配置

适合手动填写服务配置的场景：

• Streamable HTTP / SSE：远程托管的 MCP 服务，通过 URL 访问
• STDIO：本地运行的 MCP 服务，通过命令行启动

管理 MCP 服务

添加完成后，MCP 服务会出现在 MCP 服务 页面的自定义服务区域中。你可以：

• 通过开关启用或禁用某个服务
• 展开服务查看其提供的工具列表
• 点击编辑图标修改配置，或点击删除图标移除服务

实战示例：接入钉钉 MCP

1. 进入钉钉 MCP 市场：访问钉钉 MCP 市场，浏览可用的服务
2. 获取配置信息：复制 JSON Config 或 Streamable Http URL
3. 在 QoderWork 中添加：选择对应的添加方式，完成配置
4. 验证是否接入成功：在 QoderWork 对话中直接尝试使用该服务

QoderWork 典型案例

场景一：文件整理

场景说明：自动识别项目文件类型，按照规范的目录结构进行智能整理。

场景二：照片管理

场景说明：按时间、地点、主题自动分类整理本地照片，支持批量重命名和元数据提取。

案例一：竞品分析自动化工作流

场景说明：结合网络搜索、数据分析、文档创作等多个能力，完成端到端的竞品分析任务。

执行效果：QoderWork 会依次调用网络搜索工具、Excel 技能、数据分析工具、PowerPoint 技能，最终输出包含完整分析逻辑的 PPT 文件和数据支持的 Excel 表格。

案例二：项目文档体系搭建

场景说明：为开源项目自动生成完整的文档体系，包括 README、API 文档、使用指南等。

案例三：数据驱动的业务报告生成

场景说明：从原始数据到可视化报告的全流程自动化，适用于周报、月报等定期报告场景。

执行效果：QoderWork 协调多个工具完成数据处理流程，最终生成可直接提交给管理层的商业报告。

案例四：多城市旅行规划自动化

场景说明：结合地图服务、网络搜索、文档创作等能力，生成全方位的旅行攻略和展示材料。

执行效果：QoderWork 协调多个工具完成旅行规划，最终输出完整的旅行规划方案，包含攻略文档、演示文稿和展示网页。

案例五：学术研究全流程支持

场景说明：从文献检索到报告撰写的学术研究完整流程，适用于课题研究、论文撰写等场景。

案例六：培训课程资料包制作

场景说明：批量生成完整的培训课程资料，包括大纲、课件、信息图和学员手册。

QoderWork 用户案例

案例 1：企业年度工作总结自动生成

50+ 份文档整合为年度总结，从两天缩短到 6 分钟。

案例 5：外贸跟单英文工艺文件处理

场景故事：周姐在一家外贸服装公司做跟单，最让她头疼的活就是处理国外客户发来的英文 Tech Pack。过去处理一个 Tech Pack 至少要 2-3 小时，使用 QoderWork 后大幅提高效率。

执行效果：QoderWork 自动提取所有测量点，将英文术语翻译成中文，按格式整理成 Excel 表格，保持原始精度，每个 Style 一个 Sheet。

案例 9：电商销售数据汇总并生成可视化页面

场景痛点：多个区域销售明细 Excel 分散存储，汇总和可视化需手工操作，难以快速生成全局视图。

使用 QoderWork 之后：将美区 / 欧区 / 全球销售明细 Excel 汇总，生成可交互的 HTML 可视化分析页面，支持动态筛选，零门槛使用。

案例 11：Excel 一对多列展开为一对一行

场景痛点：Excel 中存在一对多关系的列，需手工展开为一对一行，传统做法需编写复杂公式。

使用 QoderWork 之后：一句话描述需求，QoderWork 自动完成列展开，操作简单，零门槛。

案例 15：自动分析内容生成思维导图

场景痛点：阅读完线上和线下内容后，手工梳理思维导图耗时费力，难以快速形成结构化知识体系。

使用 QoderWork 之后：自动分析线上和线下内容，生成结构化 XMind 思维导图文件，支持多源输入，输出标准格式。

教师成绩分析案例

场景：张老师是一名初中数学老师，需要全面了解班级成绩情况。

执行效果：QoderWork 自动读取所有 Excel 文件，完成数据分析，生成可视化的班级成绩分析报告，并对需要重点关注的学生给出建议。

• QoderWork 官方网站：https://qoder.com/qoderwork
• QoderWork 官方文档：https://docs.qoder.com/zh
• QoderWork 英文文档：https://docs.qoder.com/
• QoderWork 日文文档：https://docs.qoder.com/ja
• QoderWork 中文文档：https://www.w3cschool.cn/qoderworkdocs/