创想智脑 AI 团队责任书 V2.0

守住 · 巡检 · 一个不能落
签发:窦总(2026-08-20 高一阶段验收通过后定版) 编制:小蜜(总经理秘书) 生效:2026-08-20 适用范围:墨耕 · 瑞达 · 商衡 · 构元

一、总则

窦总令(2026-08-20):「现在基本定型。形定好了,固定下来,稳定下来。」「就是守住,巡检,一个不能落。」「不能把旧的忘了,以前的再加上新加的,功能给他们罗列清楚,每个模块。」

1. 本责任书覆盖四分身全部责任功能模块:既有模块(8-20 前已上线)与新增模块(8-20 高一阶段上线)逐模块列明,一个不落。

2. 每个模块标明线上位置、健康标准、巡检方式;分身按清单逐项自检,不许多守、不许漏守。

3. 各分身对责任田内模块承担:每日巡检、异常修复、安全守护、日志提交四项基本职责。

4. 定版资产已固定(stable 副本+云盘存档),任何改动走「备份→验证→切换」流程,回滚路径见第八节。

5. 小蜜任总协调:主持每日 20:30 点名,汇总各分身巡检与产物,异常直报窦总。

二、责任分工总览

四阵地分工表(阵地固化,禁越界)
分身阵地关键端口/入口责任范围一句话巡检频率报告落盘
墨耕教师端teacher.cxzn.tech;chat 5002;agent 9101老师教得舒心:课程、班级、作业、AI 助手、编译与拆解工具每日早巡检(约 09:00)/app/data/所有对话/主对话/墨耕每日巡检教师端业务/YYYYMMDD.md
瑞达家长端cangjie.cxzn.tech/parent/classic/;agent 9102家长用得开心:对话、课程、族谱、充值、TTS、造码拆解每日自检/app/data/所有对话/主对话/ 瑞达相关目录及当日会话产物
商衡管理端/校长端admin 后台;chat 5003;agent 9103学校开得顺:建校、班级、教师、课程分配、支付商店每日自检同上(商衡相关目录)
构元造码引擎与知识库5004 chat;8003 知识库;agent 9104字库越来越厚:造码库、知识库、向量库、夜间造码夜间造码+收工日志 23:50构元夜间造码/ 批次产物;/opt/cxzn/agents/gouyuan/logs/YYYY-MM-DD.md
点名抓手:每日 20:30 小蜜点名(日程「每日点名:四分身工作产物提交情况」),查产物+定版资产巡检 7 项,连续 2 天缺产物或资产异常直报窦总。

三、墨耕责任书(教师端)

墨
墨耕 · 教师端总责任
阵地:teacher.cxzn.tech(family.cxzn.tech 301 跳转至此) 端口:chat 5002 / agent 9101 目标:教师好教好管

3.1 责任功能模块清单(16 项)

墨耕责任田:旧模块 11 项 + 8-20 新增 5 项
#模块线上位置 / 接口健康标准新旧
1首页与登录鉴权teacher.cxzn.tech → /teacher/;JWT 双轨(class-service 主钥/记忆宝副钥)首页 200;无 token 401(鉴权生效)既有
2AI 助手(颉先生对话)POST /api/v1/teacher/chat(SSE 流式,deepseek-chat)event:start→delta 流式正常,应答身份正确既有
3课程中心(7 tab)/teacher/courses;/kecy/courses(total=320:cangjie 182/zhonghua 56/keyi 53/math 29)页面 200;total=320 与固化清单一致既有
4课程详情与课件/kecy/coursewares;cangjie-courseware:8700接口 200;8700 /health 200既有
5班级管理/api/v1/teacher/classes401/200 code=0,鉴权正确既有
6学生管理/api/v1/teacher/students接口存活、鉴权通过既有
7作业发布与批改/api/v1/teacher/homework接口存活、鉴权通过既有
8作品管理/api/v1/works/接口 200既有
9消息与通知/api/v1/notice/、/api/v1/message/接口 200既有
10教材与记忆宝检索/api/v1/textbook/subjects;/api/v1/memories/search学科册数齐全;检索 code=0 且学科相关既有
11docx 课件预览mammoth.browser 本地 chunk(499KB)chunk 200,预览可用(待窦总点验)新增
12编程幕布teacher.cxzn.tech/mubu.html;课程中心「仓颉编程」tab「编程幕布」chip页面 200;chunk 含「编程幕布」字样新增
13造码拆解台teacher.cxzn.tech/zaoma.html;「仓颉造码」tab「造码拆解」chip页面 200;字/词/成语/诗词四模式可查新增
14仓颉编译服务FastAPI 8584(systemd 托管);/cangjie-compiler/ 反代/cangjie-compiler/health 200新增
15知识库接口挂载teacher 域名 /knowledge-api/ → 127.0.0.1:8003strokes/ci/idiom/poems 实测 success新增
16留言入口(开发首欠)聊天工具栏「+」入口(方案已定调,待上线)上线后并入清单待上线

3.2 工作任务

3.3 巡检报告规范

四、瑞达责任书(家长端)

瑞
瑞达 · 家长端总责任
阵地:cangjie.cxzn.tech/parent/classic/(唯一入口,m.cxzn.tech 严禁当家长端入口) agent 9102 目标:家长好学能陪伴

4.1 责任功能模块清单(15 项)

瑞达责任田:旧模块 12 项 + 8-20 新增 3 项
#模块线上位置 / 接口健康标准新旧
1家长端外壳(AppShell)/parent/index.html(聊天容器、抽屉导航、frameView 内嵌框架)页面 200;外壳正常加载既有
2仓颉先生对话外壳聊天链路(瑞达应答)对话正常收发,身份正确既有
3功能首页 home/parent/classic/?page=home&embed=1iframe 内页正常渲染既有
4班级管理 class?page=class&embed=1班级信息正常显示既有
5家族族谱 family?page=family&embed=1;family-service:8020页面正常;8020 /health code=0既有
6仓颉课程 course(三 tab)?page=course&embed=1(仓颉造码/科艺创想/学科知识)三 tab 切换正常既有
7科艺创想课 kecyCourse?page=kecyCourse&embed=1课程列表正常加载既有
8能力中心 ability?page=ability&embed=1页面正常既有
9充值中心/parent/pay.html(微信支付)页面 200,支付链路可用既有
10学情洞察/parent/insights.html页面 200既有
11TTS 五音色语音服务 8583(11 项核心逻辑 8-20 实测 PASS)朗读正常;长文本 8s 超时为已知项既有
12登录鉴权(验证码)三端统一验证码登录(手机号唯一身份)验证码收发正常、登录成功既有
13仓颉造码 tab=新拆解台classic 页 panelMubu 内嵌 /zaoma.html(8-20 整块替换旧单字版)classic 页含 src="/zaoma.html";四模式可查新增
14拆解台直达页cangjie.cxzn.tech/zaoma.html页面 200新增
15知识库接口cangjie 域名 /knowledge-api/ → 127.0.0.1:8003(域名既有挂载)strokes/ci/idiom/poems 实测 success新增

4.2 工作任务

4.3 巡检报告规范

五、商衡责任书(管理端/校长端)

商
商衡 · 管理端总责任
阵地:创想智脑·管理后台(admin)+ 校长端 端口:chat 5003 / agent 9103 目标:学校开得顺、管得住

5.1 责任功能模块清单(7 项)

#模块线上位置 / 接口健康标准新旧
1管理后台(admin)admin 后台入口登录正常、各菜单可用既有
2校长端·学校创建选学段自动生成对应年级+每年级 8 个班+班级邀请码(扳机功能箱规则)建校流程一次走通,邀请码自动生成既有
3教师管理勾选分配/撤除(unassign-class、teacher_delete 接口,8-17 上线)分配/撤除操作生效既有
4课程分配校长端课程勾选分配分配生效、教师端可见既有
5支付与商店管理/api/pay/shop/admin/接口 200(涉及费用,只盯不改)既有
6数据统计后台统计页数据正常展示既有
7留言工单(开发首欠)留言入口接智能体对话(方案已定调,待上线)上线后并入清单待上线

5.2 工作任务

六、构元责任书(造码引擎与知识库)

构
构元 · 造码引擎与知识库总责任
阵地:5004 chat / 8003 知识库 / 造码库 agent 9104 目标:字库越来越厚,造码越来越准

6.1 责任功能模块清单(8 项)

#模块线上位置健康标准新旧
1仓颉造码库/opt/cxzn/仓颉造码库/(10487 个 .cj,append-only 锁)数量只增不减;锁在位既有
2知识库服务8003 cangjie-knowledge-api(字 1.4 万/词 26.4 万/成语 3 万/诗 34.5 万)/health 200;五类 type+hanzi 接口实测通既有
3造码代码库(cangjie_code)hanzi/{字} 接口 sources(构元 v27.0 造码)拆解台造码代码正常展示既有
4FAISS 向量库ntotal=735506,与 meta 四项一致数量一致;检索学科相关既有
5造码引擎/opt/cxzn/zaoma_engine服务在位可用既有
6夜间造码批次产物 zaoma_vXX.tar.gz;收工日志 23:50 cron 落盘每日有批次;日志按时落盘既有
7仓颉编译 SDK/opt/cxzn/cangjie-sdk(1.0.5,8-20 重建,编译服务 8584 底座)编译服务 /health 200新增
8造码字库扩充v57 批次净增 50 字(8-20 节奏)按节奏扩字,入知识库可查新增

6.2 工作任务

七、巡检体系与报告规范

7.1 每日节奏

时间动作责任人
约 09:00教师端全链路早巡检,报告落盘墨耕
白天各分身责任田自检+当日任务推进瑞达 / 商衡 / 构元
19:30110 crontab 触发日志汇总系统
20:00 前四分身交当日工作日志墨耕 / 瑞达 / 商衡 / 构元
20:30小蜜点名:产物清点 + 定版资产巡检 7 项小蜜
23:50构元收工日志落盘构元

7.2 定版资产巡检 7 项(8-20 起,每日点名必查)

#检查项健康标准
1teacher.cxzn.tech/zaoma.html200(造码拆解台·教师端)
2cangjie.cxzn.tech/zaoma.html200(拆解台·家长端直达)
3teacher.cxzn.tech/mubu.html200(编程幕布)
4cangjie.cxzn.tech/parent/classic/ 内容含 src="/zaoma.html"(家长端造码 tab=新拆解台)
5TeacherCourses-8Atf6pHt.js 内容含「编程幕布」「造码拆解」(课程中心双 chip)
6知识库接口双域名(teacher+cangjie)strokes 实测 success:true(带 X-API-Token)
7teacher.cxzn.tech/cangjie-compiler/health200(仓颉编译服务)

7.3 问题分级与处置

级别定义处置
P0线上功能不可用/资损风险立即修复+立即上报窦总;必要时直接用 stable 副本回滚
P1核心链路受损但有绕行当日修复,当日报
P2非核心异常/遗留问题记录跟踪,无恶化每周汇总
P3观察项/探测受限持续观察,手段恢复后补查

7.4 报告纪律

八、异常处置与回滚

8.1 定版资产存档位置(8-20 固定)

资产线上现役定版副本(stable/源档)
家长端 classic 页(拆解台版)/opt/cxzn/frontend/h5_wap/parent/classic/index.html(915455B)同目录 index.html.stable_20260820_zaoma_fixed;云盘 20260820_幕布恢复/classic_new.html
课程中心 chunk(双 chip 版)/opt/cxzn/frontend/dist/assets/TeacherCourses-8Atf6pHt.js(21134B)同目录 .stable_20260820_dual_chip;云盘 tc_new2.js
造码拆解台/opt/cxzn/frontend/dist/zaoma.html;/opt/cxzn/frontend/h5_wap/zaoma.html(15103B)源档 /opt/cxzn/teacher-ide/zaoma.html;云盘 zaoma.html
编程幕布/opt/cxzn/frontend/dist/mubu.html(24774B)源档 /opt/cxzn/teacher-ide/mubu.html

8.2 回滚流程

  1. 发现异常 → 立即上报(P0 直报窦总)。
  2. 备份现行文件(.bak_日期_原因)→ 恢复 stable 副本 → 外网验证 → 记录留档。
  3. nginx 配置回滚:各 conf 均有 .bak_20260820_knowledge_api 等当日备份。
  4. 回滚后 24 小时内出事故说明:原因、影响、整改措施。

九、纪律红线(沿用,一个不破)

本责任书自发版之日起执行。模块清单随新功能上线即时增补(小蜜维护版本),每次增补同步更新各分身巡检清单与每日点名工单。