本地网页会话

ftckb serve 在 127.0.0.1 上启动一个单会话的本地网页界面（仅本机可访问），适合不想记斜杠命令的队员：

ftckb serve --knowledge PATH --team 20827 --season 2025-2026 --provider deepseek [--repo PATH] [--config PATH] [--port 0-65535] [--no-browser]

• 端口：默认随机（--port 0），启动时终端会打印 url= 和 token=；token 是一次性访问令牌，页面每次请求都要带（查询参数或 X-FTCKB-Token 头），泄露只需重启换新。
• 未给 --no-browser 时自动打开默认浏览器（macOS open / Linux xdg-open / Windows start）。
• API key 只进内存：优先读环境变量；没有则启动时在终端以隐藏方式输入一次，绝不写入配置文件、绝不打印。
• 页面为中文，全部按钮操作；回答、引用、Agent 差异分栏展示。
• 网页里可以改队伍/赛季/Provider/仓库/知识路径：对话历史保留（除非点「清空对话」）；有未提交的 Agent 编辑改动或处于编辑模式时，仓库/知识路径不可改。
• 关闭服务：点「关闭服务」按钮，或 Ctrl-C 结束进程。

HTTP 接口（/api/status|ask|submit|mode|undo|discard|diff|save|clear|configure|shutdown）返回统一 JSON：成功 {ok:true,...}；业务拒绝 {ok:false,error:{code,message}}；未授权 HTTP 401。模型调用在后台线程串行执行，网页不会卡死。

与文档站的关系

本文档站是静态说明网站。访问 ftckb.lucasxl.com 不会连接你的本地项目；本地网页 Agent 需要在自己的电脑上单独启动。