跳转至

关于 FSSC Wiki

最后更新：2026-04-26

一、什么是 FSSC Wiki

FSSC Wiki 是一个审核手册知识库站点，将柒鑫集团旗下各公司的业务审核手册统一管理、在线浏览、智能问答。

核心能力

能力 说明
在线阅读 按公司+章节组织，浏览器直接访问
全文搜索 右上角搜索框，跨公司关键词检索
智能问答 右下角 💬 气泡，自然语言提问，AI 基于手册内容回答并标注来源
手册批注 段落级批注，悬停 ✏ 标记，点击打开面板，支持回复与昵称
部门政策分享 每周五自动扫描 5 大主题新政，管理员可编辑评语并分享
反馈建议 「帮助 → 反馈与建议」页面提交，管理员可回复

二、内容组织

已上线公司（5家）

公司 章节 表格 状态
云商公司 11章 5张 ✅
化工公司 11章 3张 ✅
欧泰公司 9章 1张 ✅
实业公司 8章 — ✅
财智公司 — — ⏳ 待补充

导航结构

首页 | 关于 FSSC Wiki | 关于 LLM Wiki | 部门政策分享 | 审核手册 ▾ | 帮助
                                                           ┣━ 云商 (11章)
                                                           ┣━ 化工 (11章)
                                                           ┣━ 欧泰 (9章)
                                                           ┣━ 实业 (8章)
                                                           ┗━ 财智 (占位)
  • 首页：公司卡片一览，点击进入对应手册
  • 关于 FSSC Wiki：本文
  • 关于 LLM Wiki：概念介绍独立页面
  • 部门政策分享：每周五自动化政策雷达扫描 + 管理员精选分享
  • 审核手册：点击展开公司列表，浏览具体章节
  • 帮助：反馈与建议

三、功能详解

3.1 快速搜索

右上角搜索框输入关键词（如「发票」「预付」「报关」），结果按相关性排列，点击跳转到对应章节。

3.2 智能问答（Q&A）

点击右下角 💬 蓝色聊天气泡按钮打开问答面板：

  • 输入自然语言问题，AI 从手册内容检索并生成回答
  • 回答底部标注来源（[来源 N，章节 X] ↗），点击可跳转到原文位置
  • 对话记录跨页面保留（localStorage 持久化）
  • 支持「清空对话」🗑 按钮重置
  • 界面采用 Google Gemini 美学风格（白色基调、Google Blue 点缀、三点脉冲加载动画）

技术实现：BGE 向量嵌入 → ChromaDB（wiki_qa 集合）检索 → DeepSeek 合成回答。

⚠️ 注意：Q&A 服务通过端口 8766 运行，外网访问通过统一服务器代理（/api/qa/），无需单独放行防火墙。

3.3 手册批注

审核手册每个段落末尾有批注入口：

  • 无批注段落：悬停段落显示 ✏ 铅笔，点击打开批注面板
  • 已有批注段落：💬 N 气泡常亮，数字显示批注条数
  • 批注面板：段落原文预览 → 已有批注列表（可回复）→ 昵称输入 → 新建批注
  • 昵称：首次输入后自动保存（localStorage 持久化），后续面板自动填充
  • 定位：基于段落索引 + 前 30 字 hash 锚定，页面重新加载自动匹配

3.4 反馈与建议

访问「帮助 → 反馈与建议」：

  • 任何 LAN 用户可查看所有反馈、提交新建议
  • 管理员（少波）可回复每条反馈，回复需输入密钥
  • 提交/回复后页面自动刷新，无需手动刷新

四、访问方式

方式 地址
本机访问 http://127.0.0.1:8765
局域网访问 http://192.168.110.87:8765
外网访问（推荐） https://xy14.tailf37954.ts.net/
Q&A 服务 端口 8766（自动调用，无需手动访问）
反馈 & 批注服务 端口 8767（自动调用，无需手动访问）

⚠️ LAN IP 由 DHCP 分配，可能变动。外网地址通过 Tailscale Funnel 固定映射，不受网络切换影响。分享给朋友直接用 https://xy14.tailf37954.ts.net/。

五、技术架构

┌──────────────────────────────────────────────────┐
│                  FSSC Wiki                        │
│                                                   │
│  ┌─────────────────┐   ┌──────────────────────┐  │
│  │  MkDocs Site     │   │  Q&A Service          │  │
│  │  端口 8765        │   │  端口 8766             │  │
│  │                   │   │                      │  │
│  │  · 5家公司手册     │   │  · BGE 向量嵌入        │  │
│  │  · Material 主题   │   │  · ChromaDB 检索       │  │
│  │  · 全文搜索        │   │  · DeepSeek 合成回答   │  │
│  │  · Gemini 风 Q&A   │   │  · 来源锚点跳转        │  │
│  └─────────────────┘   └──────────────────────┘  │
│                                                   │
│  ┌──────────────────────────────────────────────┐ │
│  │  反馈板 & 批注 (端口 8767)                    │ │
│  │  · FastAPI + feedback.json + annotations.json│ │
│  │  · 密钥回复（yanglan）/ 段落级批注            │ │
│  └──────────────────────────────────────────────┘ │
│                                                   │
│  ┌──────────────────────────────────────────────┐ │
│  │  政策雷达 & 部门政策分享                       │ │
│  │  · policy_radar_V1.py（每周五自动扫描5主题）   │ │
│  │  · featured_policies.json（精选+编辑评语）     │ │
│  └──────────────────────────────────────────────┘ │
│                                                   │
│  ┌──────────────────────────────────────────────┐ │
│  │  维护脚本                                      │ │
│  │  · sync_*_to_wiki.py（4家公司同步）             │ │
│  │  · onboard_company.py（新公司上线管线）         │ │
│  │  · self_check.py（28项系统自检）                │ │
│  │  · nightly_memory_consolidation.py（夜间整理）  │ │
│  └──────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────┘

源文件组织

目录 说明
scripts/llm_wiki/ MkDocs 项目根目录（配置、主题、页面）
scripts/llm_wiki/wiki/ 手册 Markdown 源文件，按公司分文件夹
scripts/llm_wiki/site_build/ 编译后的静态站点
scripts/wiki_qa/ Q&A 后端服务 + 反馈板 + 批注系统
media/{公司名}公司审核手册_转换/ 原始 docx/md 源文件
memory/feedback.json 反馈数据存储
memory/wiki_annotations/annotations.json 批注数据存储
memory/policy_radar/ 政策雷达扫描结果 + 点击量 + 精选政策

六、管理员维护

6.1 新公司上线

python scripts/onboard_company.py --company 公司名 --docx "media/xxx.docx"

一条命令完成 9 步：建文件夹 → 转换 → 生成脚本 → 同步 → 注入导航 → 更新首页 → 构建。

6.2 更新手册内容

修改 media/{公司名}公司审核手册_转换/ 中的源文件后，运行对应同步脚本：

python scripts/sync_yshang_to_wiki.py   # 云商
python scripts/sync_hg_to_wiki.py       # 化工
python scripts/sync_ot_to_wiki.py       # 欧泰
python scripts/sync_sy_to_wiki.py       # 实业

同步后再执行 mkdocs build 重新编译。

6.3 系统自检

python scripts/self_check.py

自动检查 28+ 项：服务状态、端口、ChromaDB 索引、前端组件、同步脚本、磁盘空间、运行时间。结果输出到 memory/scripts_health.md。

6.4 重新索引 Q&A

Q&A 内容变更后需要重建向量索引：

python scripts/wiki_qa/build_index.py

6.5 防火墙

# 右键以管理员身份运行
scripts/install_firewall_rules.bat

放行 8765（Wiki）、8766（Q&A）、8767（反馈板 & 批注）三个端口。

6.6 外网访问（Tailscale Funnel）

本机重启后，需要按顺序启动服务：

# 1. Wiki 统一服务器（合并 Q&A + 批注代理）
cd C:\Users\10015\.copaw\workspaces\default\scripts\llm_wiki
python combined_server.py

# 2. Q&A 问答服务
python scripts/wiki_qa/qa_server.py

# 3. 反馈 & 批注服务
python scripts/wiki_qa/feedback_server.py

# 4. 对外暴露（Tailscale Funnel）
"C:\Program Files\Tailscale\tailscale.exe" funnel --bg 8765

对外地址：https://xy14.tailf37954.ts.net/（朋友直接浏览器打开，无需安装任何东西）

6.7 反馈板密钥

回复密钥联系管理员获取。如需修改，编辑 scripts/wiki_qa/feedback_server.py 中的 REPLY_TOKEN。