知识库维护与同步
维护目标
商业客服知识库必须和当前产品、Dashboard 页面、支付入口和公开政策保持一致。任何会影响客服回答的上线，都需要同步更新本 Wiki。
hermes-service 目录已经与当前生产环境脱节，当前不再作为商业客服知识来源、事实来源或同步目标。
事实优先级
优先级从高到低：
- 当前线上 Dashboard 页面实际展示。
- 当前代码中的用户可见文案和功能开关。
- 官网公开页面、用户协议、隐私政策、退款政策。
- 本 Wiki。
- 临时沟通记录。
如果本 Wiki 与线上页面冲突，以线上页面和已发布代码为准，并尽快修正文档。
必须同步的变更
以下变更上线后必须更新知识库：
- 支付方式变化。
- 套餐名称、金额、额度、倍率、最低充值金额变化。
- 退款政策变化。
- 发票流程变化。
- 联系客服入口、客服邮箱、二维码或工单字段变化。
- 支持的 Provider、模型、Base URL、Agent 接入方式变化。
- 企业订阅、合同、SLA、对公付款和对账策略变化。
- 用户协议、隐私政策、退款政策变化。
当前支付同步规则
当前 Wiki 对外口径：
- 当前用户侧可见支付入口：支付宝。
- 微信支付、Solana Pay / USDT / USDC、Lemon Squeezy 不作为当前可见购买入口回答。
- 历史订单或兼容类型不等同于当前售卖能力。
如果未来重新开放其他支付方式，应同时更新：
本 Wiki 的职责
本 Wiki：
- 面向客服、运营、销售支持和普通用户可读的知识库。
- 写清楚页面路径、处理流程、材料清单和安全边界。
- 不写未上线承诺、隐藏需求或数据库操作说明。
- 作为当前商业客服支持知识库的维护入口。
废弃来源：
- 不再从
hermes-service目录抽取客服知识。 - 不再要求同步
hermes-service/knowledge-bundles。 - 不再用
hermes-service/data/knowledge判断当前生产客服口径。
更新流程
- 确认变更已经上线或即将上线。
- 找到受影响页面和代码文案。
- 更新本 Wiki 对应章节。
- 检查是否存在过期关键词，例如旧支付方式、旧邮箱、旧套餐。
- 检查 wikilink 是否仍能对应到文件。
- 需要发布静态 Wiki 时再构建和发布。
禁止写入
不要把以下内容写进公开或半公开 Wiki：
- 线上数据库凭据。
- 上游 token。
- 内部 SSH 地址和私钥。
- 用户个人敏感数据。
- 真实订单流水。
- 未公开折扣策略。
- 未签署合同条款。
- 未上线功能承诺。
维护检查清单
每次商业化相关上线后检查：
- 支付入口是否准确。
- 套餐和价格是否声明“以页面展示为准”。
- 退款和发票是否只承诺流程，不承诺结果。
- 企业采购是否转人工。
- 技术支持是否不要求完整 Key。
- 联系方式是否一致。
- 工单材料清单是否完整。
- FAQ 是否同步。