用 WorkBuddy 搭个能问答的知识库，只给星球粉丝看

我刚干了一件事：把自己 5 年的公众号文章、电脑里散落的原始 md 草稿、三个付费专栏，连同一本已经出版的《Redis 高手心法》，全塞进了一个知识库。

现在星球里的朋友不用再翻历史推文、不用重复问我「Redis 持久化那段到底怎么理解」，直接在 WorkBuddy 里像跟我聊天一样「问」这些内容，知识库会自动检索作答。

这篇不是安利，是手把手。照着做，你也能用 WorkBuddy + ima，半天搭出一个只给特定人看、还能问答的知识库。

一、先说清楚：为什么要搞这个

内容创作者都躲不开三个痛点：

资产散落。公众号一篇文章、本地一份 md 草稿、专栏一份成稿、书稿一份 PDF------同一份知识，躺在四个地方。
重复答疑。粉丝老问同一类问题，你答第 100 遍「去看我那篇讲 AOF 的文章」，但对方压根找不到那篇。
福利没入口。你想把沉淀回馈给铁粉，但公众号文章谁都能看，专栏又隔着付费墙，根本没有「只给星球粉」的专属知识空间。

目标其实很朴素：一个能检索、能问答、且只对星球粉丝开放的知识库。 这就是 WorkBuddy + ima 能给你的东西。

二、整体方案：一张图看明白

核心就三层：

资产层：公众号文章（URL）、本地 md、付费专栏 md、出版书 PDF。
导入层：WorkBuddy 上的 ima 技能，走 ima 的 OpenAPI 把内容写进知识库。
消费层：ima 共享知识库，设好权限后只放星球粉进来，他们用 WorkBuddy（或 ima 本身）提问。

为什么是 WorkBuddy 而不是纯手工传？因为批量导入 + 建文件夹 + 后续更新，用对话指令一句话搞定，比在客户端里一个个拖文件省太多时间。后面第三步会看到。

三、第一步：把资产分个类

动手前，先把你要灌进去的东西按「类型」归个类，因为不同类走不同导入通道：

资产类型	例子	导入方式
网页/公众号文章	`mp.weixin.qq.com/s/xxx`	按 URL 导入（`import_urls`），可使用 down.mptext.top/dashboard 工具批量导出。
本地文件	电脑里的 `.md` 草稿	文件上传
付费专栏	仓库里的 `articles/*.md`	批量文件上传
出版书	《Redis 高手心法》PDF	文件上传

一句话原则：能给出链接的，走 URL；只有文件的，走上传。 别把 PDF 转成链接瞎传，也别手动把公众号文章复制成 md 再上传------既丢格式又费手。

四、第二步：拿到 ima 的「钥匙」

WorkBuddy 要替你写 ima，得先有凭证。

打开 ima.qq.com/agent-inter...，用你的腾讯账号登录，拿到 Client ID 和 API Key。

在 WorkBuddy 接入 IMA。
ruby 复制代码
```
请安装 ima 技能
下载地址：https://app-dl.ima.qq.com/skills/ima-skills-1.1.7.zip
API Key 获取：https://ima.qq.com/agent-interface
```
一键复制到 workbuddy，按照提示会让你把第二步获取的 API Key 给到 workbuddy 就可以。

在 workbuddy 中使用 ima 连接器打通知识库。

五、第三步：让 WorkBuddy 接管导入

这是最爽的一步。你不用写一行上传代码，直接对 WorkBuddy 下指令。

导入本地/专栏 md（批量）：

直接把本地目录地址告诉 Workbuddy 导入到 ima 知识库即可。

bash 复制代码

把 /Users/magebte/Documents/magebyte/pay-columns/ai-coding-mastery/articles/
下面所有 .md 文件，导入到我的 ima 知识库「码哥跳动·知识资产」，
按文件名里的模块建子文件夹。

导入公众号文章（按 URL）：

由于微信公众号的文章很多，手动一篇篇导入不现实。我们可以使用 down.mptext.top/ 把公众号文章批量导出，然后再让 workbuddy 上传到 ima 知识库。

点击导出为 excel 或者 md 都可以。

接着把导出的文件丢给 workbudyy 解析并导入 ima 知识库。

导入出版书：

javascript 复制代码

把 ~/books/redis-gaoshou-xinfa.pdf 上传到 ima 知识库「码哥跳动·知识资产」，
放到「出版著作」文件夹。

WorkBuddy 背后实际跑的是这套（懂技术的看一眼，不懂直接跳过）：

文件上传 ：preflight-check 先校验类型 → check_repeated_names 查重名 → create_media 在服务端建媒体 → 把文件传到腾讯云 COS → add_knowledge 正式入库。
URL 导入 ：直接调 import_urls，一次最多 10 个，把 mp.weixin.qq.com 的文章链接给它就行，服务端会抓取正文。

我自己的《Redis 高手心法》和《后端面试高手心法》、《AI 超能工具箱》、《Claude Code AI 高阶编程实战》专栏，就是这么一批批灌进去的，比在客户端里手动拖省了至少两小时。

六、第四步：设权限，只给星球粉看（最关键）

这一步做错了，你的知识库就成公开的了。 顺序不能反：

在 ima 客户端（或微信「ima 知识库」小程序）里新建知识库时，一定选 「共享知识库」------个人知识库只有你自己能看，没法分享。
进入知识库 → 成员管理 → 加入方式设为「需确认」或「仅邀请」 ，并关掉「允许他人加入」。这样知识库变私密，只有你邀的人进得来。
把成员角色设成 「查看者」 ：能看、能搜、能问，但不能改不能下。再顺手打开 「禁止导出/下载」，内容就拿不走。
需要的话，还能给单个文件单独设查看权限------比如某份还没写完的专栏草稿，整库可见但对某人单独隐藏。
点「分享」生成链接或二维码，发到你的知识星球。粉丝点开提交加入申请，你审核通过即可。

一句话记牢：共享知识库 + 仅邀请 + 查看者 + 禁止导出 = 只给星球粉看的只读知识库。

在这里我把微信公众号的文章知识库全部公开给大家使用，大家直接订阅即可。【ima知识库】码哥跳动公众号 ima.qq.com/wiki/?share...

《Redis 高手心法》和《后端面试高手心法》、《AI 超能工具箱》、《Claude Code AI 高阶编程实战》专栏，就只有知识星球的读者可以订阅了......

还没进星球的朋友------你懂的，入口在公众号菜单。

七、第五步：日常怎么用

搭好之后，粉丝那边这样用：

在 WorkBuddy 里问：左侧「连接器」搜 ima 知识库 → 连接 → 授权。之后直接对话：「码哥讲 Redis 持久化那段，AOF 和 RDB 我老搞混，帮我讲讲区别。」WorkBuddy 会去你的知识库检索作答。
在 ima 里问：粉丝也能直接在 ima 客户端/小程序里对知识库提问，不用装 WorkBuddy。

你这边要做的只有一件：内容有更新，重新跑一遍第三步的导入指令，粉丝即时就能问到新内容。知识库是活的，不是一次性快照。

八、踩坑提醒（省你两小时）

这几个坑我替你踩过了：

MCP 是只读的，别在它上面死磕写入。 ima 给 WorkBuddy 留了两条通道：MCP（搜知识库、读笔记，四条全是只读）和 OpenAPI（经 ima 技能，能上传、能导入）。要灌资产，走 OpenAPI 那条；光连了 MCP 就想写文件，写不进去。
API Key 会过期/有额度。哪天导入突然报错，先想是不是 Key 到期了，去 agent-interface 重新拿。
文件名重复不支持替换 。同一文件传两次，ima 会问你「保留两者还是取消」，不会覆盖。批量传之前先 check_repeated_names 查一遍。
视频、B 站/YouTube 链接不支持。这类走客户端，别指望 API。
个别公众号文章抓不到。遇到登录墙或反爬，那条 URL 会失败，手动补传 PDF 或 md 即可。
大文件上传要调超时。书稿 PDF 偏大时，COS 上传可能超时，把上传超时显式调大（比如 300 秒）再试。

九、写在最后

上面这套，我已经给自己跑通了：5 年公众号 + 本地草稿 + 两个付费专栏 + 一本《Redis 高手心法》，全在一个只对星球粉开放的 ima 知识库里。

星球里的朋友，按第六步的操作申请加入「码哥跳动·知识资产」即可，审核通过后就能来「问」我这些年写下的东西了。这算一份迟到但实在的粉丝福利。

还没进星球的朋友------你懂的，入口在公众号菜单。

码哥跳动 · 让沉淀可被问答