# Q's blog

> Bsheepcoder 的技术博客，记录 AI、编程、计算机科学的学习笔记


## AI Resources

- [PDC Protocol](/pdc-protocol.md): 本站遵循的平行数据通道协议规范
- [AI Context](/ai-context.md): 站点写作规范与分类体系
- [Search Index](/api/index.json): 结构化文章列表（含元数据和 API 地址）
- [By Category](/api/categories/skill.json): 按分类聚合（skill/prompt/info/hexo/ai）
- [Full Content](/llms-full.txt): 全部文章全文合并（可直接一次读取）

## Articles

- [PDC 协议接入 MCP 生态：两种部署模式实战](/api/posts/hexo-pdc-mcp-adapter.md): PDC 协议通过薄适配器接入 MCP 生态，让 Qoder、Claude Desktop、Cursor 等 MCP 客户端直接访问静态博客内容。本文详细讲解本地 stdio 和远程 HTTP（Cloudflare Worker）两种部署模式的实现细节、配置方法和适用场景，附完整代码和手动测试流程。
- [MCP 协议详解：AI 应用的 USB-C 接口](/api/posts/ai-mcp-protocol.md): 从 M×N 集成难题到 M+N 线性解法，深入解析 Model Context Protocol 的三大原语（Resources/Tools/Prompts）、两层架构（数据层 + 传输层）、JSON-RPC 生命周期和六大安全原则。结合企业知识库、研发工具链、数据库助手等真实业务场景，说明 MCP 如何成为 AI 应用的标准化上下文接口。
- [PDC 协议：让博客同时服务人类与 AI 的平行数据通道](/api/posts/pdc-protocol.md): PDC（Parallel Data Channel）协议是一种让静态博客同时服务人类读者和 AI Agent 的内容交付协议。通过构建时生成平行数据通道（JSON/MD/TXT），实现人类看 HTML、AI 读零噪音 Markdown，四层架构覆盖数据通道、文章格式、内容注入和静态托管兼容性，零运行时开销，完美适配 GitHub Pages。
- [提示词：工作周报助手](/api/posts/prompt-weekly-report.md): 将零散工作记录整理为简明日报的提示词，用最少的字描述清楚任务进度，仅用 1. 和 - 分点分级。固定两大板块：本周工作、下周计划，下周计划从本周未完成任务发散。AI 可通过 API 直接提取使用。
- [提示词写作技巧：用 XML 结构构建可复用提示词](/api/posts/skill-prompt-writing.md): 基于 OpenAI GPT-5.5 和 Anthropic 公开指南的提示词写作方法，用 XML 标签组织结构（role/goal/instructions/output_format/stop_rules），6 步写出可复用、可检索、AI 可直接提取的提示词。
- [提示词：代码审查助手](/api/posts/prompt-code-review.md): PR 提交后自动化代码审查的提示词模板，基于 OpenAI GPT-5.5 和 Anthropic 公开指南优化，采用 outcome-first 结构（goal + success_criteria + stop_rules），覆盖安全/性能/可维护性三维检查，按严重程度分组输出。AI 可通过 API 直接提取使用。
- [如何生成好的 Agent Skill：从原理到实践](/api/posts/skill-how-to-generate.md): 基于 Qoder skill-generator 的跨平台实践经验，结合 OpenAI GPT-5.5 提示词指南和 Anthropic Claude Code Skills 规范，从 Token 经济学、注意力分配、上下文窗口管理等底层原理出发，系统分析什么样的 Agent Skill 是好的 Skill。
- [什么是好的提示词：从 Token 原理到开源实践](/api/posts/ai-prompt-engineering.md): 从 Token 分词、注意力机制、上下文窗口等底层原理出发，结合 OpenAI GPT-5.5、Anthropic、Google 等开源提示词实践，系统分析什么样的提示词是好的提示词，以及为什么好。涵盖 outcome-first、检索预算、停止条件等最新实践。
- [Kokoro TTS 本地语音合成引擎集成指南](/api/posts/skill-kokoro-tts.md): 介绍 Kokoro TTS 本地语音合成引擎的部署配置、OpenAI 兼容 API 调用、Node.js 脚本集成方法及完整音色列表，适用于 derder-bot 等聊天机器人发送语音消息。
- [RSS 日报 · 2026-06-18](/api/posts/rss-daily-2026-06-18.md): 2026年6月18日 RSS 日报，从 16 个可信源中精选 20 条重要资讯，涵盖 AI、科学、安全、商业、国际新闻等领域，附分析师解读。
- [RSS 日报生成工作流](/api/posts/skill-rss-daily.md): 介绍如何从 RSS 源大全中抓取全部可信源、按重要程度筛选 20 条新闻、生成每日 RSS 日报文章并部署到博客的完整工作流。
- [Hexo AI 数据通道：让 AI 零噪音读取博客内容](/api/posts/hexo-ai-data-channel.md): 完整的 Hexo AI 数据通道解决方案：通过构建时生成静态 JSON/MD/TXT 文件，让 AI Agent 获取零噪音的博客文章内容，完美兼容 GitHub Pages，支持加密文章保护。
- [RSS 源大全：可信信息获取的数据源清单](/api/posts/rss-source-collection.md): 经过实际验证的 RSS 源大全，按学术、AI、技术、新闻、独立博客分类，标注可访问性和可信度，附简单介绍和推荐订阅组合。
- [GitHub Pages 完全指南：原理、配置与使用限制](/api/posts/hexo-github-pages-guide.md): 详细介绍 GitHub Pages 的工作原理、配置方法、使用限制和常见问题，包括免费账户与付费账户的区别、私有仓库的 Pages 支持、自定义域名配置和流量限制等。
- [Hexo 博客文章加密实现](/api/posts/hexo-blog-encryption.md): 介绍 hexo-blog-encrypt 插件如何为 Hexo 静态博客实现客户端文章加密，涵盖 AES-256-GCM 加密原理、PBKDF2 密钥派生流程和配置方法。
- [用 Hexo 搭建认知管理系统](/api/posts/hexo-cognitive-management.md): 介绍如何用 Hexo + Butterfly 主题搭建一个 AI 索引友好的认知管理系统，涵盖项目架构、文章命名规范、Front-Matter 设计、内容索引策略和自动化部署流程。