公开分级与内容边界
版本：v1.1
日期：2026-09-26
状态：执行基线
公开级别：公开
维护人：Cursor
上级：度裁知识库 README
1. 分级定义
| 级别 |
谁读 |
载体 |
典型内容 |
| 公开 |
互联网用户、伙伴、开发者 |
https://api.ducai.cc/static/kb/ |
术语、产品线关系、阶段口径、行业协作说法 |
| 伙伴 |
签约集成/分销伙伴 |
与公开同一站点（md 标 伙伴；深度集成仍走专项方案） |
B1/B2、ISV 红线索引、货盘 ID 规则 |
| 内部 |
度裁员工（平台超管控制台身份） |
fit1/private/kb-internal/ + API GET /api/v1/merchant/console/internal-kb/…；入口 商家控制台 → 超级管理员 → 内部知识库 |
构建/上云纪律、运维路径说明（非密钥正文） |
| 机密 |
最小授权角色 |
禁止 KB 构建；仅 Git + 02平台安全/ |
密钥、渗透结论、未公开定价、客户敏感数据 |
文首元数据：> **公开级别**：公开 | 伙伴 | 内部 | 机密。公网构建执行 assert_no_classified_in_public_sources()（scripts/tools/build_kb_site.py）。
2. 2026-09-26 泄漏风险评估（公网 KB）
| 项 |
原状 |
风险 |
处置 |
09-知识库维护手册 写 services/ecs.pem、云 IP |
公网可读 |
高 |
迁至 internal/；公网 09-贡献与反馈 |
05 / 02 写内网 API 地址 |
过时 + 拓扑 |
中 |
已改写；现役见 Body3D服务管理 |
| 多 AI 席位名 |
协作文化 |
低 |
公网保留「主责」索引 |
| 表名、RBAC 角色名 |
集成线索 |
低～中 |
保留；不写 Key 用法 |
| 生产线 10 |
工厂业务 |
无 |
保持公开 |
3. 主人拍板（2026-09-26）
3.1 内部入口与门禁（采纳建议 B + JWT/角色）
| 决策 |
内容 |
| 入口 |
商家控制台「超级管理员」→ 内部知识库（外链 /static/internal-kb-launcher.html） |
| 鉴权 |
同源 控制台会话（ops-session-auth.js + localStorage portal/Key）+ GET /api/v1/merchant/console/rbac-matrix 探活后，经 GET /api/v1/merchant/console/internal-kb/{path} 拉取 HTML；须 mc:sys:rbac:manage（对齐超管侧栏） |
| 不落公网静态 |
内部 HTML 在 services/fit1/fit1/private/kb-internal/，不放在 /static/kb-internal/，避免 StaticFiles 裸挂载 |
| 不做 |
独立 Nginx auth_basic 账号表（过渡方案否决） |
3.2 伙伴内容（采纳建议甲）
- 公开与伙伴继续同一公网 KB；不另建登录后伙伴站。
- 集成细节、合同、环境 Key → 签约后专项文档/对接，不进 KB 机密层。
3.3 机密（主人确认）
- 永不进入 KB 构建（公网或 internal 产物均禁止
公开级别：机密）。
- 机密正文只在
docs/02平台安全/、.env、仓库权限与合同渠道维护。
3.4 工程落点速查
| 动作 |
命令/路径 |
| 构建公网 + 内部 |
python scripts/tools/update_kb_site.py |
| 公网上云 |
python scripts/cloud/deploy_kb_site.py（含 private/kb-internal 同步） |
| 内部 MD 源 |
docs/01整体规范/度裁知识库/internal/ |
| 维护手册 |
internal/09-知识库维护手册 |
4. 维护纪律
- 新篇必须标 公开级别；不确定 → 先 内部，评审后再降级公开。
- 大范围发布后抽查 05、07、08。
- 机密不得出现在
PAGE_ORDER / INTERNAL_PAGE_ORDER 的构建产物中。
修订
| 版本 |
日期 |
说明 |
| v1.0 |
2026-09-26 |
首版：四级定义、泄漏评估 |
| v1.1 |
2026-09-26 |
主人拍板：控制台内部 KB + 伙伴公网混排 + 机密不进 KB；工程落点 §3.4 |