鲸先知识库框架标准 V2

版本: v2.0
生效日期: 2026-04-19
适用范围: 全公司知识资料管理
维护方式: AI辅助 + 人工审核

一、核心理念与架构

1.1 单一事实源（Single Source of Truth）

鲸先知识库是全公司所有资料的统一出口，所有对外内容（官网、客服、营销材料、PPT）均从 Wiki 生成，杜绝多版本混乱。

原始资料 → AI编译层(Wiki) → 统一出口(官网/客服/PPT/海报)
    ↑                              ↓
    └──────── 反馈优化 ←───────────┘

1.2 三层架构（LLM-Wiki 规范）

┌─────────────────────────────────────────────────────────────┐
│  Layer 3: 应用层 (Application Layer)                          │
│  官网CMS │ 智能客服 │ 营销PPT │ 宣传海报 │ 销售话术 │ API文档   │
├─────────────────────────────────────────────────────────────┤
│  Layer 2: AI编译层 (AI Compiled Wiki) - 本知识库核心           │
│  结构化Markdown │ 实体关联 │ 版本管理 │ 自动索引              │
├─────────────────────────────────────────────────────────────┤
│  Layer 1: 原始层 (Raw Sources)                                │
│  PDF/PPT/Word/图片/视频 - 只读归档，作为可信源                 │
└─────────────────────────────────────────────────────────────┘

二、一级核心知识域（8大域）

域	图标	覆盖内容	维护负责人	权限级别
Company	🏢	公司介绍、资质证书、发展历程、组织架构、品牌规范	行政/总经办	对外公开
Product	📦	产品体系、功能说明、定价策略、版本日志、竞品分析	产品部	核心对外
Marketing	📈	营销话术、宣传文案、案例库、PPT素材、海报文案	市场部	对外公开
Solution	🧩	行业解决方案、场景方案、招投标文件、技术白皮书	解决方案部	分级管理
Technology	🛠️	系统架构、API文档、部署手册、安全规范、技术规范	技术部	内部核心
Operation	🧭	SOP流程、运营策略、客服话术、数据指标、培训资料	运营部	内部通用
Partner	🤝	供应商信息、渠道政策、合作协议、采购记录	采购/供应链	分级保密
Admin	🧾	人事制度、财务流程、行政规范、合规要求	行政/HR	内部机密

2.1 特殊功能域

域	图标	说明
Entities	🔗	实体库：产品名、客户名、术语、项目名称的统一索引页
FAQ	❓	全公司统一问答库，支撑智能客服
Dashboard	📊	AI自动生成的汇总页、数据看板、内容健康度报告
Resources	📚	原始资料归档区（PDF/PPT等源文件）
Templates	📝	文档模板库，所有新文档必须从此创建

三、目录结构规范

3.1 根目录结构

lwkb/
├── about/                      # 关于知识库
│   ├── index.md               # 知识库首页
│   ├── changelog.md           # 更新日志
│   └── usage-guide.md         # 使用指南
│
├── company/                    # 🏢 公司域
│   ├── index.md               # 公司域首页
│   ├── profile/               # 公司概况
│   │   ├── index.md
│   │   ├── introduction.md
│   │   ├── history.md
│   │   └── culture.md
│   ├── brand/                 # 品牌规范
│   │   ├── index.md
│   │   ├── visual-identity.md
│   │   └── naming-guide.md
│   ├── credentials/           # 资质证书
│   │   ├── index.md
│   │   ├── licenses.md
│   │   └── certifications.md
│   └── news/                  # 新闻动态
│       └── index.md
│
├── products/                   # 📦 产品域
│   ├── index.md               # 产品总览
│   ├── baas/                  # BaaS 平台层
│   │   ├── index.md
│   │   ├── lwep/              # 鲸先企付
│   │   ├── lwcl/              # 银企财资
│   │   └── lwct/              # 业财通
│   ├── saas/                  # SaaS 产品层
│   │   ├── index.md
│   │   ├── lwar/              # 鲸先应收
│   │   └── lwpg/              # 智能收款
│   └── solutions/             # 解决方案产品
│       ├── index.md
│       ├── lwdp/              # 资金存管
│       ├── lwle/              # 租赁通
│       └── lwpf/              # 停车缴费
│
├── marketing/                  # 📈 营销域
│   ├── index.md
│   ├── messaging/             # 品牌话术
│   ├── cases/                 # 客户案例
│   ├── materials/             # 营销素材
│   └── playbook/              # 销售手册
│
├── solutions/                  # 🧩 方案域
│   ├── index.md
│   ├── industries/            # 行业方案
│   ├── scenarios/             # 场景方案
│   └── bidding/               # 招投标
│
├── technology/                 # 🛠️ 技术域
│   ├── index.md
│   ├── architecture/          # 系统架构
│   ├── api/                   # API文档
│   ├── deployment/            # 部署运维
│   ├── security/              # 安全规范
│   └── digital-rmb/           # 数字人民币
│
├── operation/                  # 🧭 运营域
│   ├── index.md
│   ├── sop/                   # SOP流程
│   ├── service/               # 客服资料
│   ├── training/              # 培训资料
│   └── metrics/               # 数据指标
│
├── partner/                    # 🤝 合作域
│   ├── index.md
│   ├── suppliers/             # 供应商
│   ├── channels/              # 渠道合作
│   └── agreements/            # 协议模板
│
├── admin/                      # 🧾 行政域
│   ├── index.md
│   ├── hr/                    # 人事制度
│   ├── finance/               # 财务流程
│   └── compliance/            # 合规要求
│
├── entities/                   # 🔗 实体库
│   ├── index.md
│   ├── products.md            # 产品实体
│   ├── customers.md           # 客户实体
│   ├── terminology.md         # 术语表
│   └── projects.md            # 项目实体
│
├── faq/                        # ❓ 问答库
│   ├── index.md
│   ├── products/              # 产品FAQ
│   ├── sales/                 # 销售FAQ
│   └── tech/                  # 技术FAQ
│
├── resources/                  # 📚 原始资料
│   ├── index.md
│   ├── company/
│   ├── products/
│   ├── marketing/
│   └── raw/                   # 未分类原始文件
│
└── templates/                  # 📝 模板库
    ├── index.md
    ├── company/
    ├── product/
    ├── marketing/
    ├── solution/
    ├── tech/
    └── case/

3.2 产品子目录结构（以产品为单位）

每个产品统一使用三级文档结构：

products/{layer}/{product-id}/
├── index.md                   # L1: 产品概述 (Product Overview)
├── features.md                # L2: 功能说明 (Features)
├── technology.md              # L3: 技术文档 (Technology)
└── assets/                    # 产品相关图片/图表
    └── images/

文件	内容级别	说明
`index.md`	L1	产品定位、核心价值、适用场景、优势亮点
`features.md`	L2	功能清单、操作流程、界面说明、配置指南
`technology.md`	L3	架构设计、API接口、集成指南、安全说明

四、文件命名规范

4.1 命名原则

英文/拼音目录名：使用 ASCII 字符，禁止中文目录名
小写字母：统一使用小写
连字符分隔：使用 - 连接单词
简洁清晰：名称应直观反映内容

4.2 各域命名规范

类型	正确示例	错误示例
目录名	`company/`, `products/baas/`, `marketing/cases/`	`公司/`, `产品/BaaS/`, `营销案例/`
文档ID	`lwep`, `lwcl`, `lwar`, `weiyaotong`	`LWEP`, `银企财资`, `微药通`
文档名	`introduction.md`, `api-reference.md`	`介绍.md`, `API文档.md`
版本号	`v2.1`, `2026v4`	`V2.1`, `version2`

4.3 产品ID命名规范

ID	产品名称	层级	说明
`lwep`	鲸先企付	BaaS	Leader Whale Enterprise Payment
`lwcl`	银企财资	BaaS	Leader Whale Cash & Liquidity
`lwct`	业财通	BaaS	Leader Whale Connect
`lwar`	鲸先应收	SaaS	Leader Whale AR
`lwpg`	智能收款	SaaS	Leader Whale Payment Gateway
`lwdp`	资金存管	Solution	Leader Whale Deposit
`lwle`	租赁通	Solution	Leader Whale Lease
`lwpf`	停车缴费	Solution	Leader Whale Parking Fee

五、文档元数据标准（YAML Frontmatter）

每篇文档必须包含标准化的 YAML frontmatter：

yaml

---
# 基础信息
title: 文档标题                    # 必填：中文标题
description: 文档描述摘要          # 必填：用于SEO和搜索

# 分类信息
category: Product                  # 必填：一级域 (Company/Product/Marketing/Solution/Tech/Operation/Partner/Admin)
subcategory: BaaS                  # 选填：二级分类
product: lwep                      # 选填：关联产品ID

# 标签体系
tags:                              # 必填：标签数组
  - 产品                            # 内容类型
  - 对外公开                         # 权限级别
  - BaaS                           # 业务分类

# 版本控制
version: "2.1"                     # 必填：文档版本
status: active                     # 必填：状态 (draft/active/archived/deprecated)
last_updated: 2026-04-19           # 必填：最后更新日期 (YYYY-MM-DD)
maintainer: 产品部                  # 必填：维护部门/人

# 源文件追踪
source: 
  file: "产品白皮书v2.1.pdf"        # 原始文件名
  path: "/resources/products/"      # 原始文件路径
  version: "2.1"                   # 源文件版本

# AI辅助信息
ai_hints:                          # 给AI的提示
  keywords: ["关键词1", "关键词2"]   # 关键概念
  related: ["相关页面路径"]          # 关联页面
  faq_candidates: true             # 是否适合生成FAQ

# VitePress专用
outline: deep                      # 目录深度 (shallow/deep/number)
sidebar: true                      # 是否显示侧边栏
prev: false                        # 上一页链接
next: false                        # 下一页链接
---

5.1 标签体系（Tags）

内容类型标签

#公司 #产品 #方案 #技术 #营销 #运营

权限级别标签

#对外公开 #对外受限 #内部通用 #内部机密 #核心保密

业务场景标签

#可用于官网 #可用于客服 #可用于PPT #可用于海报 #可用于招投标

产品层级标签

#BaaS #SaaS #Solution

客户行业标签

#医药 #制造 #零售 #物流 #金融

六、内容分级标准（L1/L2/L3）

6.1 内容三级架构

级别	名称	目标读者	内容深度	更新频率
L1	概述层 (Overview)	客户/高管/销售	概念性、价值导向	每版本迭代
L2	功能层 (Features)	产品经理/客户	功能性、操作导向	每功能发布
L3	技术层 (Technology)	技术/实施/运维	技术性、实现导向	每技术变更

6.2 各级内容规范

L1 - 产品概述

产品定位与核心价值
目标客户与适用场景
主要优势与差异化
关联产品与生态位

L2 - 功能说明

功能清单与模块划分
核心流程与操作步骤
界面截图与示意图
配置参数与选项说明

L3 - 技术文档

系统架构与组件关系
API接口与数据模型
集成指南与SDK说明
部署配置与运维手册
安全规范与合规说明

七、AI维护与管理机制

7.1 增量入库流程 (Ingest)

上传原始文档 → AI解析提取 → 人工确认 → 生成/更新Wiki → 更新索引 → 记录日志
     ↑                                                               ↓
     └──────────────────── 定期巡检优化 ←─────────────────────────────┘

7.2 定期健康检查 (Lint)

每月自动执行：

过期内容检测：标记超过6个月未更新的页面
内容冲突检测：识别同一实体在不同页面的表述不一致
孤立页面检测：找出无内部链接指向的页面
缺失链接检测：检查死链和未创建的引用页面
元数据完整性：检查必填字段缺失

7.3 内容生命周期

草稿(Draft) → 审核中(Review) → 正式发布(Active) → 归档(Archived) → 废弃(Deprecated)
                 ↑                ↓ (每季度Review)
                 └──────────── 更新迭代 ────────────┘

7.4 权限与责任矩阵

角色	职责	权限
知识管理员	整体架构、规范制定、健康检查	全库读写
域负责人	各自域内容准确性、审核更新	域内读写
内容编辑	提交更新、创建新页面	指定域读写
只读用户	查阅知识	全库只读
AI助手	内容生成、格式调整、索引维护	受限写入

八、存量资料处理策略

8.1 原始资料归档 (Resources)

所有原始文件（PDF、PPT、Word、Keynote）统一归档到 /resources/ 目录：

resources/
├── company/                   # 公司资质类
├── products/                  # 产品资料类
│   ├── {product-id}/         # 按产品ID分目录
│   └── ...
├── marketing/                 # 营销材料类
├── solutions/                 # 方案文档类
└── raw/                       # 未分类原始文件

命名规范：{内容描述}-{版本标识}-raw.{扩展名} 示例：鲸先企付产品介绍-v2.1-raw.pdf

8.2 迁移优先级

优先级	内容类型	说明
P0	核心产品介绍	当前在售产品，销售日常使用
P1	客户案例、营销话术	支持销售和市场工作
P2	技术文档、API文档	支持实施和客户技术对接
P3	历史文档、旧版本资料	归档保存，按需迁移

九、输出与集成规范

9.1 统一出口清单

所有对外内容必须从 Wiki 生成：

出口	内容来源	同步方式
官网 (pooul.com)	Company/Product/Solution	API/人工
智能客服	FAQ/Product	API自动
营销PPT	Marketing/Product	脚本生成
宣传海报	Marketing/Brand	脚本生成
销售话术	Marketing/Messaging	文档导出
API文档	Technology/API	自动同步

9.2 自动化输出格式

PPT生成: 基于 marketing/ppt/ 模板，自动填充产品数据
海报文案: 基于 marketing/copy/ 的短文案库，自动组合
FAQ导出: 基于 faq/ 结构化数据，导出客服系统格式
API文档: 基于 technology/api/ 生成 OpenAPI/Swagger

十、实施路线图

Phase 1: 基础建设（第1-2周）

[ ] 建立完整目录结构
[ ] 制定并发布本文档标准
[ ] 创建核心模板（产品、方案、案例）
[ ] 整理并归档现有原始资料

Phase 2: 核心内容迁移（第3-6周）

[ ] P0 产品文档入库（核心在售产品）
[ ] P0 公司资质与介绍入库
[ ] P1 营销话术与案例入库
[ ] 建立 Entities 实体索引

Phase 3: 规模化运营（第7周起）

[ ] 建立定期健康检查机制
[ ] 训练AI理解公司知识
[ ] 对接官网/客服等出口
[ ] 持续优化和迭代

附录

A. 参考文档

B. 相关模板

C. 修订记录

版本	日期	修订内容	修订人
v1.0	2026-04-10	初始版本	AI Assistant
v2.0	2026-04-19	整合LLM-Wiki理念，重构8大域架构	AI Assistant

鲸先知识库框架标准 V2 ​

一、核心理念与架构 ​

1.1 单一事实源（Single Source of Truth） ​

1.2 三层架构（LLM-Wiki 规范） ​

二、一级核心知识域（8大域） ​

2.1 特殊功能域 ​

三、目录结构规范 ​

3.1 根目录结构 ​

3.2 产品子目录结构（以产品为单位） ​

四、文件命名规范 ​

4.1 命名原则 ​

4.2 各域命名规范 ​

4.3 产品ID命名规范 ​

五、文档元数据标准（YAML Frontmatter） ​

5.1 标签体系（Tags） ​

内容类型标签 ​

权限级别标签 ​

业务场景标签 ​

产品层级标签 ​

客户行业标签 ​

六、内容分级标准（L1/L2/L3） ​

6.1 内容三级架构 ​

6.2 各级内容规范 ​

七、AI维护与管理机制 ​

7.1 增量入库流程 (Ingest) ​

7.2 定期健康检查 (Lint) ​

7.3 内容生命周期 ​

7.4 权限与责任矩阵 ​

八、存量资料处理策略 ​

8.1 原始资料归档 (Resources) ​

8.2 迁移优先级 ​

九、输出与集成规范 ​

9.1 统一出口清单 ​

9.2 自动化输出格式 ​

十、实施路线图 ​

Phase 1: 基础建设（第1-2周） ​

Phase 2: 核心内容迁移（第3-6周） ​

Phase 3: 规模化运营（第7周起） ​

附录 ​

A. 参考文档 ​

B. 相关模板 ​

C. 修订记录 ​