爱库录白皮书

2026-09-15 · 返回列表

爱库录白皮书

AiKlog · 爱库录AI知识库博客系统

版本：v1.0（2026-09-13 · 对齐发行 0.1.10）
域名：aiklog.com
样板房：https://aiklog.com
仓库：https://github.com/AiKdex/AiKlog
Release：v0.1.10（linux/windows 二进制）
定位一句话：目录即站点，文件即文章

一、产品定位与主张

1.1 主张

| 层 | 文案 | |---|---| | 主句 | 目录即站点，文件即文章 | | 副句 | 拖拽即发、语义检索、双链互文——自部署 AI 知识库博客 | | 机制 | 笔记与资料在库里整理，目录投影成公开站；数据在自己手里 | | 品类 | 自部署博客 / 知识库博客（对标 emlog、Typecho，多一个知识引擎） |

不使用：「拖一个 Markdown 就是一个公开站」（一文件 ≠ 一站）。

1.2 核心理念

用户操作：把文件放进「博客」目录 → 自动成为公开文章
用户感知：写 → 发 → 读者看 → 评论 →（可选）AI 问答
技术底座：文件引擎 + 索引引擎 + AI 网关 + 事件总线 + 插件系统

知识库是后台引擎，不是前台卖点。
读者看到的是干净博客；管理员侧才有文件库、标签、语义检索、设置。

1.3 差异化一句话

emlog 是「写博客的工具」，爱库录是「让知识自然长成公开站的系统」。

| 传统博客 | 爱库录 | |---|---| | 先有想法，再进后台写一篇 | 先有笔记/文件，再整理进目录对外 | | 搜索靠关键词 | 关键词 + 语义 | | AI 外挂插件 | AI 在引擎层（摘要/向量/推荐） | | PHP + MySQL | 单二进制 + SQLite |

二、目标用户与场景

| 用户群 | 场景 | 付费意愿（远期） | |---|---|---| | 技术博主 | 技术笔记、代码片段、学习整理 | 中 | | 知识工作者 | 读书笔记、行业观察、研究整理 | 高 | | 独立创作者 | 个人品牌、作品与内容沉淀 | 中 | | 小团队 | 团队博客 / 产品文档一体 | 高 | | 自部署爱好者 | 要数据主权、要可审计 | 中高 |

典型故事：

作者在本地/Obsidian 写笔记 → 拖进爱库录博客目录 → 公开站更新、RSS 更新
读者按意思搜索「那篇讲目录即站点的」→ 语义命中
文章之间 [[双链]] 互跳；侧栏/正文下由插件挂评论、元信息、相关推荐

非目标（精简发行不做）： 采集爬虫、IM 网关、多租户 SaaS 计费（后续版本另议）。

三、功能全景

3.1 标准博客能力（对标 emlog）

| 能力 | 状态 | 说明 | |---|---|---| | Markdown 编辑 | ✅ | Vditor 所见即所得 | | 分类 / 标签 | ✅ | 博客子目录=分类；树状标签 | | 草稿 → 发布 | ✅ | content_state.status | | 公开列表 / 文章页 | ✅ | publicPosts / /p/blog?path= | | 拖拽上传 | ✅ | 博客管理拖 md/文件夹 | | 上传后自动发布 | ✅ 可配 | blog.auto_publish_on_upload，默认关 | | 站点设置 | ✅ | blog.title/description/logo/footer/seo | | 稳定 slug | ✅ | 改文件名/分类不碎链 | | RSS 2.0 | ✅ | /api/v1/blog/feed.xml | | 评论 | ✅ 核+插件 | 读公开、写登录；UI 走 post_bottom | | SEO meta | ✅ 内置插件 | blog-seo-meta | | 元信息 / 侧栏卡 / 列表徽章 | ✅ 内置插件 | 四挂载点已落地 | | 主题协议 | ✅ | registerTheme + 爱库录主题 | | 博客开关 | ✅ | blog.open，关闭公开页/RSS |

3.2 AI / 知识库能力（emlog 不具备）

| 能力 | 状态 | 说明 | |---|---|---| | 语义搜索 | ✅ 底座 | FTS5 + 向量 + RRF（精简版 UI 仍保留检索入口） | | AI 摘要 | ✅ 底座 | 入库解读（精简发行可关外呼） | | 双链 [[wiki]] | ✅ | 阅读态可点 | | 相关推荐 | 🔶 | 向量 API 有，插件 UI 待做 | | 读者 AI 问答 | 🔶 | Agent 有，公开页入口待做 | | 知识图谱 | ⛔ 精简已裁 | ECharts 图谱不进发行版 |

3.3 博客版独有

目录即站点：放入博客目录=发布，移除=下线
博客管理专页：分类、文章、上传、站点设置、开关
存储层隐藏：博客树不在普通文件管理器裸奔，只在博客管理
搜索 scope：blog / file / all

四、技术架构

4.1 分层

接口层   公开博客 · 控制台 · RSS · OpenAPI 子集 · 插件 API
应用层   博客管理 · 发布 · 检索 · 插件 · 主题 · AI
内核层   文件引擎 · 索引引擎 · 事件总线 · 插件运行时 · 配置
存储     SQLite（WAL）+ 本地文件树（防路径穿越）
运行时   Go 单二进制（前端 go:embed）

4.2 精简发行依赖

| 保留 | 裁剪 | |---|---| | modernc.org/sqlite | bogdanfinn/tls-client 及间接依赖 | | vue / pinia / vue-router | echarts（图谱） | | vditor / marked / hljs / dompurify | 采集、IM、情报频道 |

4.3 关键契约

博客插件：manifest + registerBlogPlugin + 四挂载点
主题：registerTheme + dataSources:['blog'] + dataScope:'shared'
投递：POST /api/v1/blog/posts（外部采集线 Aikdex 用）
公开只读：/public/posts /public/site /public/comments /blog/feed.xml
OpenAPI：docs/openapi-public.yaml（blog / public / auth）

五、竞品对比与市场评估

5.1 直接竞品

| 系统 | 运行时 | DB | AI | 自部署 | 博客体验 | 知识库底座 | |---|---|---|---|---|---|---| | emlog | PHP | MySQL | 外挂/无 | ✅ | ⭐⭐⭐⭐⭐ | ❌ | | Typecho | PHP | MySQL | 无 | ✅ | ⭐⭐⭐⭐ | ❌ | | WordPress | PHP | MySQL | 插件 | ✅ | ⭐⭐⭐⭐⭐ | ❌ | | Ghost | Node | MySQL | 弱 | ✅ | ⭐⭐⭐⭐⭐ | ❌ | | Hugo | 静态 | 文件 | 无 | ✅ | ⭐⭐⭐⭐ | ❌ | | 爱库录 | Go 单二进制 | SQLite | 内置底座 | ✅ | ⭐⭐⭐⭐（打磨中） | ✅ |

5.2 间接竞品（AI 知识库）

Khoj / RAGFlow / AnythingLLM 等：有检索无「可运营的公开博客门面」。
爱库录补的是 发布层 + 博客体验，不是再做一个企业 RAG。

5.3 竞争位置

博客体验高 ↑     emlog · WordPress · Ghost
                  ★ 爱库录（目标：体验接近 + AI 底座）
              Hugo              Khoj（纯知识库）
         ───────────────────────────→ AI 能力强

5.4 市场评估（务实）

| 判断 | 说明 | |---|---| | 主市场 | 中文自部署博客（emlog/Typecho 用户升级心智） | | 切口 | 「会写 Markdown / 有笔记库」的人，要公开站且要数据主权 | | TAM 叙事 | 千万级个人站点存量中，技术/知识向子集 | | 现实份额 | 插件/主题生态远弱于 WP/emlog；靠「底座差异 + 极简部署」单点突破 | | 增长逻辑 | 样板房可访问 → 文档可装 → 内置插件证明协议 → 应用市场 | | 变现（远期） | 付费主题/插件、应用市场分成、托管版/企业支持（当前阶段不做收费墙） |

结论： 不做「又一个 WP」；做 自部署时代带知识引擎的博客。体量小但差异清晰，适合先样板房后生态。

六、已完成（截至 0.1.10）

6.1 产品与品牌

| 项 | 结果 | |---|---| | 品牌 | AiKlog 爱库录，产品全称「爱库录AI知识库博客系统」 | | 主宣传 | 目录即站点，文件即文章 | | 域名 | aiklog.com（HTTPS + LE 证书） | | 样板房 | 产品落地页 + 公开博客 + 控制台 /#/desk | | 仓库 | https://github.com/AiKdex/AiKlog（MIT） | | Release | v0.1.10 含 linux/windows 二进制 + SHA256SUMS |

6.2 精简发行

| 项 | 结果 | |---|---| | 裁剪 | 采集 / IM / tls-client / 情报频道 / ECharts / 孤儿表 | | 体积 | Linux 二进制 ~13.4MB | | 品牌默认 | site.name / SPA / 日志 / favicon 均为爱库录 |

6.3 博客与插件

| 项 | 结果 | |---|---| | 四挂载点 | 全部落地 + 11 个内置插件 | | 相关推荐 / 归档 / 分类云 / 封面 | ✅ | | 评论 / SEO / sitemap / robots | ✅ | | 读者 AI 问答 | POST /public/blog/ask + 插件（限公开上下文） | | 访问统计 PV | POST /public/blog/pv + 插件 | | 应用市场 v0.2 | zip 安装 + 设置页启停 | | 上传自动发布 | 站长可配 |

6.4 主题

| 主题 | 状态 | |---|---| | 爱库录（左图右文 + 侧栏左右） | ✅ 样板房默认 | | 极简阅读 | ✅ | | 技术文档 | ✅ |

6.5 运维

本地 fastembed embedding（bge-small-zh 512 维，离线）
Agnes LLM token 池（服务器 secrets）
build-release.sh / INSTALL.md / CHANGELOG

七、待完成

7.1 产品

| 项 | 说明 | |---|---| | 样板房 admin 改密 | 安全必做 | | AI 摘要整库跑完 | 依赖 Agnes 延迟 | | 相关推荐向量增强 | 本地 embedding 已就绪可接 | | SPA SEO prerender | 可选 |

7.2 生态

| 项 | 说明 | |---|---| | 标准博客主题 | 类 WP 杂志风 | | 应用签名 / 远程索引 | 市场 v0.3 | | 社区运营 | Issues / 中文圈 |

7.3 运营

| 项 | 说明 | |---|---| | 样板房周更 | 持续 4–8 周 | | 公开仓宣传 | README 截图 / 介绍文 |

八、应用市场规划

对齐上游记档：emlog / Z-Blog 应用中心模式——插件、主题统一「应用」；v0.2 先免费应用。

8.1 形态

应用 = 插件 | 主题
包结构：manifest.json + 前端组件 +（可选）后端声明 + 静态资源
安装：上传 zip / 从目录安装 → 校验 id/version/min_core_version → 注册 → 启用

8.2 插件清单（路线图）

P0 内置（已/近完成）

| ID | 名称 | 挂载点 | 状态 | |---|---|---|---| | blog-meta-footer | 文章元信息 | post_bottom | ✅ | | blog-tag-badges | 列表分类徽章 | list_item | ✅ | | blog-meta-card | 侧栏信息卡 | sidebar | ✅ | | blog-seo-meta | SEO / OG | head | ✅ | | blog-comments | 评论 | post_bottom | ✅ | | blog-related-posts | 相关推荐 | post_bottom | ✅ | | blog-archives | 归档 | sidebar | ✅ | | blog-tag-cloud | 分类云 | sidebar | ✅ | | blog-cover | 封面图 | list_item | ✅ | | blog-reader-ai | 读者问答 | post_bottom | ✅ | | blog-stats | 访问统计 PV | post_bottom | ✅ | | （核）slug / site-settings | 非 UI 插件 | — | ✅ |

P1 体验

| ID | 名称 | 说明 | |---|---|---| | blog-toc | 侧栏目录 | 从正文 TOC 拆出 | | blog-auto-summary | 摘要展示条 | 读 file_ai_summaries |

P2 AI / 增长

| ID | 名称 | 说明 | |---|---|---| | blog-related-ai | AI 相关推荐增强 | 摘要 + 向量融合 | | blog-tag-suggest | 发布时标签建议 | 后台 | | blog-translate-head | 标题/摘要多语 | 可选 | | 打赏 / 订阅 / 同步 | 增长集成 | 后置 |

8.3 主题清单

| 主题 | 风格 | 状态 | |---|---|---| | 爱库录（aiklog） | 冷纸 + 玉色目录卡 + 侧栏 | ✅ 样板房默认 | | 默认文章列表 | 系统内置 | ✅ | | 极简阅读（minimal） | 单栏沉浸 | ✅ | | 技术文档（docs） | 侧栏目录 + 正文栏 | ✅ | | 标准杂志风 | 类 WP | 规划 |

8.4 AI 与应用市场边界

AI 能力在内核（网关/摘要/向量），插件只做门面与场景
插件不内嵌大模型密钥逻辑；密钥与 provider 仍走主配置
应用市场 v0.2：免费应用；付费与签名审核后置

九、部署方案

9.1 推荐规格

| 档 | 配置 | 场景 | |---|---|---| | 最低 | 1C 1G 20G | 个人试用、低流量 | | 样板房 | 2C 2G+ | 公开站 + 插件 | | 团队 | 2C 4G | 多写手、大库、AI 读 |

9.2 拓扑（样板房实测）

Internet → Nginx (80/443, LE)
              ├─ /          产品落地页（静态）
              ├─ /media/    配图静态
              └─ /          proxy → 127.0.0.1:8780 aiklog (systemd)
                                └─ SQLite + data/files

9.3 最小步骤

放置二进制 + 数据目录，用户 aiklog
AIKMAP_ADMIN_PASSWORD=… ./aiklog -addr 127.0.0.1:8780 -db ./data/aiklog.db
systemd Restart=on-failure，ProtectSystem=strict
Nginx 反代 + X-Forwarded-Proto（Cookie Secure）
certbot / acme.sh 签证书
备份：整库 aiklog.db + data/files（含博客树）

9.4 升级

替换二进制 → schema migrate → 配置在 DB 自动保留
回滚：保留上一版二进制 + 快照 db

十、运营方法与策略

10.1 双线模型（已定）

| 线 | 产品 | 做法 | |---|---|---| | 内容线 | Aikdex | 自采集、近零维护；POST /blog/posts 投递样例 | | 系统线 | 爱库录 | 样板房 + 文档 + 插件/主题；要对外宣传与安装 |

比例约 7:3（产能）；爱库录是重点门面，Aikdex 是内容供应链，不反客为主。

10.2 样板房运营

| 做法 | 频率 | |---|---| | 产品/理念/教程文 | 每周 1–2 篇 | | 版本说明 / 路线图 | 每里程碑 1 篇 | | 截图更新（UI 变更后） | 随版本 | | RSS 保持可订 | 常态 |

10.3 获客渠道（规划）

GitHub README + 样板房链接
中文自部署/博客社区（emlog/Typecho 圈、V2EX、Linux.do 等）
对比文：「从 emlog 到知识库博客」（谨慎、克制）
Aikdex 求智线引流「内容样例 → 可装系统」

10.4 内容策略

不吹「最易」；讲「目录即站点」机制与真实样板房
强调数据主权、单二进制、语义检索
采集只作「可对接」能力点，不抢「知识库博客」心智

10.5 指标（起步）

| 指标 | 目标（首季） | |---|---| | 样板房 UV | 可观测增长 | | GitHub Star / Issue | 有真实反馈 | | 安装文档完成度 | runbook 可复制第二套 | | 插件启用数 | 内置 5+ 示例稳定 |

10.6 礼仪与合规

自部署产品：隐私默认本地、日志不写敏感体
开源许可与第三方依赖声明齐全
不承诺「AI 不可用仍 100% 智能」；断网时发布/RSS/浏览可用

十一、实施落地计划

阶段 0 — 精简内核（已完成）

裁采集/IM/tls/ECharts → 13.3MB 二进制 → 样板房部署。

阶段 1 — 门面补齐（2–3 周）

| 任务 | 产出 | |---|---| | 相关推荐 / 归档 / 标签云 / 封面 | P1 插件 | | sitemap + SEO 验收 | 收录友好 | | 安装 runbook + 发布包脚本 | 可复制安装 | | 改默认口令流程说明 | 安全 |

阶段 2 — AI 门面（2–3 周）

读者 AI 问答入口、摘要展示、统计插件；断网降级验收。

阶段 3 — 应用市场雏形（3–4 周）

应用包规范、目录安装、免费应用列表 UI；2–3 套主题。

阶段 4 — 运营放大（持续）

周更样板房、社区反馈闭环、版本节奏（小步 semver）。

十二、风险与规避

| 风险 | 等级 | 规避 | |---|---|---| | 生态冷启动 | 高 | 内置 5+ 插件证明协议；文档 + 示例 | | SPA 对 SEO 弱 | 中 | sitemap、meta、必要时 prerender | | 用户觉得「不需要知识库」 | 中 | 博客 UI 优先；底座隐形 | | SQLite 多写 | 低（个人博客） | WAL；多作者再议 Postgres | | AI 外呼失败 | 中 | 基础发布不依赖 AI | | 默认口令/公网裸奔 | 高 | 样板房改密、限登录、HTTPS | | 与 Aikdex 混线 | 中 | 文档写死边界：系统 vs 内容 |

十三、附录：品牌与边界

品牌

| 项 | 值 | |---|---| | 英文 | AiKlog | | 中文 | 爱库录 | | 全称 | 爱库录AI知识库博客系统 | | 域名 | aiklog.com | | 控制台 | /#/desk（不对外宣传路径） |

与 Aikdex 边界

爱库录 = 博客系统（精简发行，无采集）
Aikdex = 采集内容站（独立仓，近零维护）
Aikdex → POST /blog/posts → 爱库录（样例投递，非反客为主）

爱库录白皮书

爱库录白皮书

目录

一、产品定位与主张

1.1 主张

1.2 核心理念

1.3 差异化一句话

二、目标用户与场景

三、功能全景

3.1 标准博客能力（对标 emlog）

3.2 AI / 知识库能力（emlog 不具备）

3.3 博客版独有

四、技术架构

4.1 分层

4.2 精简发行依赖

4.3 关键契约

五、竞品对比与市场评估

5.1 直接竞品

5.2 间接竞品（AI 知识库）

5.3 竞争位置

5.4 市场评估（务实）

六、已完成（截至 0.1.10）

6.1 产品与品牌

6.2 精简发行

6.3 博客与插件

6.4 主题

6.5 运维

七、待完成

7.1 产品

7.2 生态

7.3 运营

八、应用市场规划

8.1 形态

8.2 插件清单（路线图）

P0 内置（已/近完成）

P1 体验

P2 AI / 增长

8.3 主题清单

8.4 AI 与应用市场边界

九、部署方案

9.1 推荐规格

9.2 拓扑（样板房实测）

9.3 最小步骤

9.4 升级

十、运营方法与策略

10.1 双线模型（已定）

10.2 样板房运营

10.3 获客渠道（规划）

10.4 内容策略

10.5 指标（起步）

10.6 礼仪与合规

十一、实施落地计划

阶段 0 — 精简内核（已完成）

阶段 1 — 门面补齐（2–3 周）

阶段 2 — AI 门面（2–3 周）

阶段 3 — 应用市场雏形（3–4 周）

阶段 4 — 运营放大（持续）

十二、风险与规避

十三、附录：品牌与边界

品牌

与 Aikdex 边界

相关文档