# fromsko-blogs

> RAG Chat + Slide Deck + Notes — 交互式幻灯片演示、RAG 聊天与 Obsidian 语法笔记系统。

## 认证

访问管理界面需要密码认证。POST 请求到 `http://localhost:3000/api/auth/login`：

```
POST http://localhost:3000/api/auth/login
Content-Type: application/json

{"password": "<APP_PASSWORD>"}
```

成功后返回 Set-Cookie: `ppt-auth=authenticated`，后续请求携带此 cookie 即可访问受保护页面。

公开笔记和本文件 (/llms.txt) 无需认证。

## MCP 服务端

MCP endpoint: `http://localhost:3000/api/mcp`

支持 Streamable HTTP + SSE 双协议传输。

### Streamable HTTP 配置

```json
{
  "fromsko-blogs": {
    "url": "http://localhost:3000/api/mcp"
  }
}
```

### stdio 代理配置（Claude Desktop 等）

```json
{
  "fromsko-blogs": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "http://localhost:3000/api/mcp"]
  }
}
```

### 可用工具

- `rag_search`: 知识库语义检索
- `rag_chat`: RAG 上下文对话问答
- `list_documents`: 列出知识库文档
- `list_models`: 列出可用 LLM 模型
- `get_slides`: 获取幻灯片信息

## 笔记

公开笔记可直接通过 URL 访问，无需认证：

- [关于 AI 工具层的思考](http://localhost:3000/notes/inspiration/ai-tool-layer): 个人灵感 (#灵感 #ai #架构)
- [Next.js 16 新特性](http://localhost:3000/notes/public/nextjs16-features): 公开笔记 (#nextjs #前端)
- [Rust 程序设计语言](http://localhost:3000/notes/reading/books/rust-book): 阅读笔记 / 书籍阅读 (#rust #书籍 #系统)
- [MCP 协议规范解读](http://localhost:3000/notes/reading/papers/mcp-spec): 阅读笔记 / 论文阅读 (#mcp #论文 #协议)
- [gh (GitHub CLI) 速查](http://localhost:3000/notes/reading/source-code/gh-cli-cheatsheet): 阅读笔记 / 源码解析 (#gh #github-cli #cheatsheet)
- [gh 迁移：方案 B（token 搬运）](http://localhost:3000/notes/reading/source-code/gh-migration-token-transfer): 阅读笔记 / 源码解析 (#gh #github-cli #migration)
- [omp APPEND_SYSTEM 文档](http://localhost:3000/notes/reading/source-code/omp-append_system): 阅读笔记 / 源码解析 (#omp #system-prompt)
- [omp 扩展能力菜单](http://localhost:3000/notes/reading/source-code/omp-extensions-notes): 阅读笔记 / 源码解析 (#omp #extension #plugin #notes)
- [omp 多账户渠道配置规范](http://localhost:3000/notes/reading/source-code/omp-multi-account-provider-config): 阅读笔记 / 源码解析 (#omp #config #multi-account)
- [omp system prompt 与 context 注入](http://localhost:3000/notes/reading/source-code/omp-system-prompt-identity-conflict): 阅读笔记 / 源码解析 (#omp #system-prompt #诊断)
- [React Markdown 源码解析](http://localhost:3000/notes/reading/source-code/react-markdown): 阅读笔记 / 源码解析 (#react #源码 #渲染)
- [鸽子项目列表](http://localhost:3000/notes/showcase/pigeon-projects): 项目展示 (#鸽子 #项目 #展示)
- [技术栈总览](http://localhost:3000/notes/showcase/tech-stack): 项目展示 (#技术栈 #展示)

## 配置下载

- [.env 模板](http://localhost:3000/notes/configs/dotenv-template.env): 项目环境变量配置模板
- [MCP Streamable HTTP 配置](http://localhost:3000/notes/configs/mcp-streamable.json): Cursor / omp 直连配置
- [MCP stdio 代理配置](http://localhost:3000/notes/configs/mcp-stdio.json): Claude Desktop mcp-remote 代理配置

## 链接

- [首页](http://localhost:3000)
- [Notes 管理](http://localhost:3000/notes): 笔记 · 书签 · 配置（需认证）
- [MCP 说明页](http://localhost:3000/mcp): MCP 连接指南