Agent Skills
返回列表
💻

AI 数字员工聊天站点

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f12a44b7/self-dev-npc-chat-site

技能介绍

要解决的问题

从零搭建带 AI 数字员工对话能力的网站时，开发者常陷入全栈链路的琐碎细节：前后端接口对接、第三方平台（CNB）授权、实时轮询逻辑优化，稍有疏漏就会出现「NPC 不回复」「历史丢失」等问题。本技能封装了一套可落地的部署方案，帮你避开这些常见坑。

核心能力

  • 提供 FastAPI 后端骨架（约 250 行单文件），内置 5 个核心端点，覆盖消息发送、评论分页、轮询初始化等关键场景
  • 配套独立前端页面，包含实时对话页 /chat.html 和历史记录页 /history.html
  • 对接 CNB Issue 作为消息通道，通过 @npc/XXX 提及触发 AI 回复，实现「前端发消息→后端转 Issue→AI 回复→轮询展示」的完整链路
  • 提供关键场景的避坑方案，如解决 Token 被掩盖、轮询重复回复等问题

关键步骤

  1. 创建 CNB 仓库并配置具备 repo-code:rw 权限的 Token，作为后端操作的基础凭证
  2. 部署 FastAPI 后端，通过 systemd 托管服务、Nginx 反代 /api/ 请求
  3. 使用 assets/ 目录下的前端页面文件，配置访客 ID 持久化、3s 间隔轮询（上限 20 次）
  4. 在 Issue 正文和追加评论中添加 @npc/XXX(YYY) 提及，并附上符合「口语化、有态度」要求的 INSTRUCTION
  5. 针对工具自动掩盖 Token 的问题，采用 sed 命令或 python -c 动态注入的方式解决

适用边界

  • 依赖 CNB 平台的相关能力，需提前注册并创建合规仓库
  • 前端轮询逻辑需严格遵守「先取初始评论数再轮询」的顺序，否则会出现历史消息重播
  • 对话页必须采用独立页面设计，避免使用弹框式交互导致 DOM 异常
  • 多次编辑前端代码后需验证 DOM 完整性，防止多余闭合标签导致交互失效

使用场景

  • 作为独立开发者，要快速搭建一个 AI 数字员工对话网站，通过 FastAPI 后端与 CNB Issue 串联消息链路。
  • 小团队需要部署带历史记录的对话页面，在 /history.html 展示访客与 NPC 的历史交互内容。
  • 技术负责人要优化 AI 回复的实时性，实现前端 3 秒轮询并防止历史消息重播或漏取。
  • 全栈工程师要对接 CNB 平台，配置具备 repo-code:rw 权限的 Token 并解决 Token 被掩盖的问题。

适合人员

  • 全栈开发者，需要从零搭建带 AI 对话功能的网站，快速跑通前后端与第三方平台对接流程。
  • 后端工程师，想要获得一套可复用的 FastAPI 对话接口骨架，减少重复编写轮询与分页逻辑的时间。
  • 独立项目维护者，希望部署低成本、易维护的 AI 对话站点，通过 CNB Issue 实现轻量化的消息通道。
  • 技术团队负责人，需要为团队提供一套避坑指南，解决 NPC 回复异常、历史丢失等常见部署问题。