lucianwhy/fengshu-skill

---

从「读过」到「随时找得到」

你可能记得风叔写过一个观点，却想不起文章标题；也可能找到了一句话，但不确定它在什么背景下成立。

Fengshu 希望把这种模糊的记忆变成清晰的阅读路径：提出问题 → 找到文章 → 展开前后文 → 带着出处继续讨论。

试着问：「风叔关于信息不对称的文章，分别讨论了哪些问题？」

连接知识库后，AI 可以搜索不同角度的候选文章，读取命中片段的上下文，再按文章标题、日期和可用的原文链接整理答案。归纳和推断会与原文观点分开说明。

一个项目，两层能力

本仓库是知识库的 AI 使用入口。 它提供 Skill、阅读框架和本地参考资料；线上文章库、向量索引与服务端独立维护，不包含在本仓库中。安装 Skill 不会自动创建或连接线上知识库。

没有 MCP 时，仍可使用本地资料和分析框架；连接 MCP 后，才能调用独立知识库的检索能力。实际可读范围取决于所连接服务的授权。

你可以用它做什么

检索如何发生

flowchart LR
    Q[你的问题] --> S[Skill · 研究与表达]
    S --> M[MCP · 检索工具]
    M --> A[语义向量 · 关键词检索]
    A --> C[候选片段 · 排序与去重]
    C --> R[原文存储 · 读取上下文]
    R --> O[观点整理 · 标题 / 日期 / 来源]

MCP 先检索相关材料，再按需要补充阅读上下文，为 AI 的回答提供依据。目前提供两套独立部署：

• 语义与关键词检索：按含义寻找相关片段，也支持标题、短语和关键词匹配；balanced、semantic、exact 对应不同检索需求。
• 多角度查询与去重：同一问题可以从 2～3 个角度搜索，按文章 ID 合并结果，减少重复文章占位。
• 片段级上下文展开：搜索返回真实 chunk_id 和位置；可读取目标片段的前后文，必要时再分页阅读全文。
• 原文一致性校验：从经过 SHA-256 校验的文章构建索引，保留真实片段位置；Cloudflare 版在上下文读取时也校验原文摘要。
• 来源追溯：保留文章标题、日期及可用的公开链接；Skill 要求区分原文、归纳和推断。

这些能力帮助 AI 找到和理解材料，并不保证每个回答都正确。找不到可靠出处时，应直接说明。

MCP 工具

推荐顺序：先搜索 → 再读局部上下文 → 必要时阅读全文。工具与参数以实际连接的实例为准，详细使用策略见 SKILL.md。

开始使用

安装 Skill

支持 SKILL.md 的客户端可按自己的安装方式使用本仓库。例如安装到 Codex 的个人 Skill 目录：

mkdir -p ~/.codex/skills
git clone https://github.com/lucianwhy/fengshu-knowledge.git ~/.codex/skills/fengshu

安装后开启新对话，明确提出与风叔文章或思考方式有关的问题。支持显式调用的客户端可以使用 $fengshu。仓库名改为 fengshu-knowledge，Skill 的调用名仍是 fengshu。

WorkBuddy 等客户端请按其当前 Skill 安装方式放入相应目录；工具触发与 MCP 配置方式以客户端支持情况为准。

连接知识库 MCP

默认入口提供免登录、免 Token 的免费远程 MCP，使用 Streamable HTTP。

给 Agent 配置的 MCP 地址：

https://fengshu.wanghaoyue.me/mcp

查看接入说明与免费额度

原 Cloudflare 认证入口继续保留：https://fengshu-knowledge-free.2485855953.workers.dev/mcp，仅该备用入口仍需 GitHub OAuth。两套服务独立运行、分别计量。

1. 在支持远程 MCP / Streamable HTTP 的 Agent 中添加上面的地址。
2. 鉴权选择「无」，不填写 Header、API Key 或 GitHub Token。
3. 连接后即可搜索文章、展开上下文；调用 get_fengshu_quota 查看剩余额度。

默认入口不再要求浏览器登录或 OAuth。曾经配置过旧凭证的客户端可删除该服务后按「无鉴权」重新添加；工具列表在会话开始时固定的客户端，需要重新连接或新开会话。客户端仍须实际支持 MCP；普通网页链接不会自动变成 AI 工具。

默认入口按出口 IP 计量：每天 30 次检索、100 次阅读，每分钟最多 6 次工具调用。 同一网络地址的所有 Agent 共用额度，换 Agent 名称不会重置；IPv6 按 /64 网段合并。共享网络的不同用户可能共用额度，换网络也可能获得不同额度，IP 不能精确识别个人。

全站每天最多 500 次、每月最多 10,000 次检索，每天最多 2,000 次阅读。每日额度于北京时间零点恢复。单查询计 1 次，多角度查询计 2～3 次；限制用于保护服务器资源。备用 Cloudflare 服务仍按 GitHub 账号和底层请求数计量。

服务免费，不提供充值或付费入口，只开放公开文章。详细规则见 MCP 免费接入与额度说明。

项目结构

SKILL.md                             AI 使用入口与检索策略
references/frameworks.md             常见阅读角度及局限
references/knowledge_base/           本地主题资料与索引
references/FENGSHU_STYLE_PROFILE.md   表达方式分析
docs/mcp-access-plan.md              免费接入与额度管理
scripts/                            本地素材处理脚本
assets/                             SVG 与 GIF 视觉资源

原有 scripts/extract_knowledge.py 用于处理本地 PDF/DOCX 素材，运行前需检查路径和依赖；线上知识库的部署、文章同步和索引维护由独立服务完成。

项目进展

• 已提供：可安装的 Skill、本地参考资料、免登录的阿里云 MCP、按 IP 共享的额度与全站上限；原 Cloudflare 认证版保持独立运行。
• 已验证：无凭证调用全部 5 个工具、文章检索、上下文与分页阅读，以及更换 Agent 和伪造转发请求头不会重置当前 IP 的限流。
• 后续更新：项目介绍文章发布后，在这里补充公众号原文链接。

使用边界

这是第三方整理的研究工具，不代表风叔本人，也不表示获得作者背书。整理的分析框架是阅读线索，不应被当作作者在所有情境下的立场。

文章与资料的权利属于各自权利人；项目的 MIT 许可不自动授予第三方文章的复制、分发或收费访问权。连接知识库时应遵守相应内容权限，受限材料不能因接入 MCP 而自动获得公开授权。

致谢与许可

感谢风叔（碧树西风）及「记忆承载」「西风的罗盘」的文章，也感谢 女娲·Skill造人术 提供早期方法参考。

代码与原创整理见 MIT License；第三方内容的权利另行处理。