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 |
| # | 模块 | 线上位置 / 接口 | 健康标准 | 新旧 |
|---|---|---|---|---|
| 1 | 首页与登录鉴权 | teacher.cxzn.tech → /teacher/;JWT 双轨(class-service 主钥/记忆宝副钥) | 首页 200;无 token 401(鉴权生效) | 既有 |
| 2 | AI 助手(颉先生对话) | 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/classes | 401/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 且学科相关 | 既有 |
| 11 | docx 课件预览 | 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:8003 | strokes/ci/idiom/poems 实测 success | 新增 |
| 16 | 留言入口(开发首欠) | 聊天工具栏「+」入口(方案已定调,待上线) | 上线后并入清单 | 待上线 |
| # | 模块 | 线上位置 / 接口 | 健康标准 | 新旧 |
|---|---|---|---|---|
| 1 | 家长端外壳(AppShell) | /parent/index.html(聊天容器、抽屉导航、frameView 内嵌框架) | 页面 200;外壳正常加载 | 既有 |
| 2 | 仓颉先生对话 | 外壳聊天链路(瑞达应答) | 对话正常收发,身份正确 | 既有 |
| 3 | 功能首页 home | /parent/classic/?page=home&embed=1 | iframe 内页正常渲染 | 既有 |
| 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 | 既有 |
| 11 | TTS 五音色 | 语音服务 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 | 新增 |
| # | 模块 | 线上位置 / 接口 | 健康标准 | 新旧 |
|---|---|---|---|---|
| 1 | 管理后台(admin) | admin 后台入口 | 登录正常、各菜单可用 | 既有 |
| 2 | 校长端·学校创建 | 选学段自动生成对应年级+每年级 8 个班+班级邀请码(扳机功能箱规则) | 建校流程一次走通,邀请码自动生成 | 既有 |
| 3 | 教师管理 | 勾选分配/撤除(unassign-class、teacher_delete 接口,8-17 上线) | 分配/撤除操作生效 | 既有 |
| 4 | 课程分配 | 校长端课程勾选分配 | 分配生效、教师端可见 | 既有 |
| 5 | 支付与商店管理 | /api/pay/shop/admin/ | 接口 200(涉及费用,只盯不改) | 既有 |
| 6 | 数据统计 | 后台统计页 | 数据正常展示 | 既有 |
| 7 | 留言工单(开发首欠) | 留言入口接智能体对话(方案已定调,待上线) | 上线后并入清单 | 待上线 |
| # | 模块 | 线上位置 | 健康标准 | 新旧 |
|---|---|---|---|---|
| 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 造码) | 拆解台造码代码正常展示 | 既有 |
| 4 | FAISS 向量库 | 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 节奏) | 按节奏扩字,入知识库可查 | 新增 |
| 时间 | 动作 | 责任人 |
|---|---|---|
| 约 09:00 | 教师端全链路早巡检,报告落盘 | 墨耕 |
| 白天 | 各分身责任田自检+当日任务推进 | 瑞达 / 商衡 / 构元 |
| 19:30 | 110 crontab 触发日志汇总 | 系统 |
| 20:00 前 | 四分身交当日工作日志 | 墨耕 / 瑞达 / 商衡 / 构元 |
| 20:30 | 小蜜点名:产物清点 + 定版资产巡检 7 项 | 小蜜 |
| 23:50 | 构元收工日志落盘 | 构元 |
| # | 检查项 | 健康标准 |
|---|---|---|
| 1 | teacher.cxzn.tech/zaoma.html | 200(造码拆解台·教师端) |
| 2 | cangjie.cxzn.tech/zaoma.html | 200(拆解台·家长端直达) |
| 3 | teacher.cxzn.tech/mubu.html | 200(编程幕布) |
| 4 | cangjie.cxzn.tech/parent/classic/ 内容 | 含 src="/zaoma.html"(家长端造码 tab=新拆解台) |
| 5 | TeacherCourses-8Atf6pHt.js 内容 | 含「编程幕布」「造码拆解」(课程中心双 chip) |
| 6 | 知识库接口双域名(teacher+cangjie) | strokes 实测 success:true(带 X-API-Token) |
| 7 | teacher.cxzn.tech/cangjie-compiler/health | 200(仓颉编译服务) |
| 级别 | 定义 | 处置 |
|---|---|---|
| P0 | 线上功能不可用/资损风险 | 立即修复+立即上报窦总;必要时直接用 stable 副本回滚 |
| P1 | 核心链路受损但有绕行 | 当日修复,当日报 |
| P2 | 非核心异常/遗留问题 | 记录跟踪,无恶化每周汇总 |
| P3 | 观察项/探测受限 | 持续观察,手段恢复后补查 |
| 资产 | 线上现役 | 定版副本(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 |