天风金工 · 工作
服务记录使用说明
本页说明如何在网页上登记路演与课题，以及如何让 AI Agent 通过 MCP 代为管理。站点入口：fduzdl的个人空间 → 工作 → 服务记录。
1. 打开与登录
- 浏览器访问
http://47.114.75.232/，进入「fduzdl的个人空间」。 - 点 工作 → 服务记录。也可直接打开
http://47.114.75.232/工作/服务记录/。 - 输入共用访问密码。勾选「记住密码（30 天）」后，同一浏览器下次不用再输。
- 不勾选则关闭浏览器后需要重新登录。
- 密码错误会提示「密码错误」，不会进入系统。
顶栏左侧可回到个人空间；右侧可同步 Teambition、导出 Excel、退出登录。本页也可从顶栏「使用说明」打开。
2. 路演记录
用于登记已排期的路演、午餐、晚餐，按周看日程，避免时间撞车。
2.1 周视图
- 表格列为周一到周日，行是 9:00–18:00，每半小时一格。
- 「上一周 / 本周 / 下一周」切换日期范围。
- 空格单击：新增。已占用格子单击：修改或删除，不能再往上面叠一条。
- 一条记录按时长向下占多格。例如 9:00 开始、90 分钟，占 9:00 / 9:30 / 10:00 三格。
- 格子里只显示 机构 和 客户名字。颜色区分类型：深蓝=路演，橙=午餐，酒红=晚餐。
- 每天日期下方有路演区域下拉：上海、北京、广州、深圳。按日保存，与格子里的单条路演无关；可改回「区域」表示未选。
2.2 填写字段
| 字段 | 说明 |
|---|---|
| 机构名称 | 必填。输入时模糊搜索客户名单，点选后自动带出该机构的第一位销售（可改、可再选多人）。名单里没有的机构，保存后会加入列表，下次可搜到。 |
| 客户名字 | 必填。选好机构后再搜该机构下的客户名单，可填多人，用顿号（、）隔开；每输入一个名字都会模糊搜索。名单里没有的名字也可以直接填写，保存后会加入该机构的客户名单。 |
| 开始日期 / 时间 | 默认是你点的那一格，可改。 |
| 时长 | 点选 30、60、90、120 分钟。新增时默认 60 分钟。 |
| 服务类型 | 路演 / 午餐 / 晚餐。默认规则：开始时间 11:30–13:00 为午餐，17:00 及以后为晚餐，其余为路演，仍可手改。 |
| 销售 | 必填。点开文本框只列出当前机构的销售，可点选、可搜、可手填，多人用顿号（、）隔开。选好机构后默认填该机构名单中的第一个销售。名单里没有的销售名，保存后会加入该机构的销售名单。 |
| 路演主题 | 默认沿用最近一次保存成功的主题，可改。 |
若所选时段已有安排，保存会被拒绝，提示「该时段已有安排」。请改时间、改时长，或先删掉原来的那条。
3. 课题记录
用于不占日程格子的服务：课题、资料发送、微信交流、电话交流。同一天可以有多条。
- 点「课题记录」页签，右上角「新增」。列表按开始日期所在周（周一到周日）分组，点击周标题可折叠/展开；本周默认展开。点表格一行可编辑或删除。
- 机构、客户、销售规则与路演相同（机构模糊搜、客户可搜可手填）。
- 开始日期：点选后弹出当前日期前后两周的日历。日历上方有年份和月份，格子里也标了「几月 / 几日」。已选日期会显示成「2026年9月16日」这种格式。
- 截止日期：不能早于开始日期，默认等于开始日期。
- 服务主题必填。服务类型四选一：课题、资料发送、微信交流、电话交流。
4. 导出 Excel
- 点顶栏「导出 Excel」。
- 选开始日期、结束日期（按记录上的日期，闭区间）。
- 勾选一类或几类服务类型；一个都不勾 = 导出该区间全部类型。
- 列固定为：日期、机构、参与客户、服务类型、服务内容、销售。
路演的「服务内容」是路演主题；课题类的「服务内容」是服务主题。若区间内没有记录，不会下载空表，会提示「该区间没有可导出的记录」。
5. 同步 Teambition
顶栏「同步 Teambition」是手动、双向：两边都没有的记录会补上；已对齐的记录按下面规则更新字段，不会删除。
- 只处理当前日期前后 20 天、标题以
张栋梁开头的任务，不会拉取历史全部记录。 - Teambition 有、服务记录没有：按标题
张栋梁-机构-客户-服务内容拆开写入。路演按任务分组落到北京 / 上海 / 广州 / 深圳；课题写入「委托课题」，当天 09:00–18:00。 - 在网页上新增或修改一条记录时，会立刻把这一条写到 Teambition（已有对应任务则更新）。路演需先选当天区域；刚选区域时，也会把当天已有路演补写过去。
- 客户名称、销售名称不一致时仍会对齐，以 Teambition 为准写回服务记录；带括号等后缀时（如
李丹妮（销售））去掉后缀再写入。 - Teambition 标题里没有服务内容时，用服务记录网页上的服务主题补到标题里。
- 销售：新写入 Teambition 时作为执行人和参与人；张栋梁本人会加入参与人。
- 两边用时间重叠 + 相似机构对齐；客户名不同不阻止匹配。
同步在服务器上登录 Teambition，点一次大约几秒到几十秒。结果弹窗会列出同步区间、新增条数和跳过原因。
6. 手机使用
- 路演表会缩到一屏宽度，整周七天同时可见，不必左右滑动。格子里仍然是机构 + 客户名字。
- 上下滑动可看 9:00–18:00。顶栏按钮会折行。
- 建议用系统浏览器打开；登录后勾选记住密码更方便。
7. 让 AI Agent 管理记录（MCP）
配置好服务记录 MCP 后，可在 Cursor 里用自然语言增删改查，不必手点格子。例如：
- 「今天下午 14:00 给平安资产张三做 60 分钟路演，主题风格轮动」
- 「列出本周路演」
- 「给国泰基金付涵建一条课题：自由现金流因子测试」
- 「导出 9 月的午餐和路演」
- 「把服务记录和 Teambition 同步一下」
7.1 在 Cursor 里接入
- 本仓库已准备独立环境
mcp/.venv（不要用全局 Python 装mcp，会和 RQSDK 的 PyJWT 冲突）。 - MCP 只写在项目
D:\BaiduSyncdisk\天风证券工作\服务记录\.cursor\mcp.json，不要写到电脑用户级~/.cursor/mcp.json。 - 用 Cursor 打开「服务记录」文件夹（不要只开「路演记录网页」子目录）。命令指向
路演记录网页/mcp/.venv/Scripts/python.exe和mcp/server.py。 - 密码默认读网站同级
config.json的access_password；也可在项目 mcp.json 的env里设SERVICE_RECORD_PASSWORD。 - 地址默认
http://47.114.75.232/工作/服务记录，可用SERVICE_RECORD_BASE_URL覆盖。 - 保存后完全退出并重新打开 Cursor（只关窗口不够），在 MCP 列表里看到
service-record为已连接。 - 其它电脑：拷贝本仓库、建同样的 venv，把配置写进那台机器上该项目的
.cursor/mcp.json，不要写用户级配置。
7.2 Agent 会遵守的规则
- 先搜机构再写记录。销售默认该机构第一个名字，可改成多个（顿号分隔）或手填新名字。
- 路演时长只有 30/60/90/120；冲突时段不会强行写入。
- 客户可从名单匹配，也可以按你说的名字直写。
- 不要让 Agent 直接改服务器上的 JSON 文件；一律走 MCP 接口，这样和网页看到的是同一份数据。
8. 常见问题
保存失败 / 该时段已有安排
目标时间段已有路演。打开那一格看是谁，改时间或先删除旧记录。
搜不到机构
机构来自客户名单，以及路演/课题里新填过的机构。保存一条含新机构或新客户名的记录后，下次就能搜到。若要从 Excel 整表替换名单，再生成 data/orgs.json / data/clients.json。
客户名单和机构对不上
客户名字 sheet 里的机构写法可能和机构名单略有出入（如「平安资管」与「平安资产」）。可换关键词再搜，或直接手填客户名。
换电脑记录还在吗
在。数据存在服务器，不在浏览器里。换电脑只要打开同一网址并输入密码。
同步 Teambition 跳过了路演
当天没选路演区域（上海/北京/广州/深圳）时，不会往 Teambition 写路演。先在周表表头选区域再同步。时段已有安排的 Teambition 任务也不会硬塞进格子。
忘记密码
服务器 /opt/service-record/config.json 的 access_password。改完需重启 service-record 服务。