Your Name
cdd0be328a
Critical runtime bugs:
- terminal.html WebSSH完全不可用（URL前缀/JSON解析/Content-Type三处错误）
- servers.py路由遮蔽：/logs被/{id}拦截，3个前端页面同步日志查询失败
- scripts.html startExecPoll()→startExecPolling()，长任务快速执行崩溃
- agent.py {value!r!s:.50}格式串非法，agent发非数值时ValueError
- alerts.html d.daily.reduce()无null检查，API返回空数据时TypeError
Resource leak / stability:
- websocket.py僵尸连接未关闭TCP，文件描述符泄漏
- websocket.py _last_alert_time字典无限增长（加1小时过期清理）
- asyncssh_pool.py全忙时超过MAX_CONNECTIONS无限增长
- self_monitor.py Telegram告警无冷却，宕机时每30秒刷屏
- schedule_runner.py一次性调度执行超60秒会重复触发
- 限速脚本EXPIRE每次重置窗口可绕过（改用Lua原子脚本）
Security:
- JWT access token加token_version声明，改密码后旧token立失效（零宽限）
- INSTALL_MODE导入时常量→动态函数，安装后JWT认证不再残留禁用
- install.py /lock端点加管理员存在性验证，防止阻断安装
- ServerUpdate schema移除connectivity只读字段，防止伪造连接状态
Frontend fixes:
- doExec()缺r.ok检查、commands.html null检查
- _server_to_dict()补last_checked_at+ssh_key_public
- _field_match()逗号cron表达式修复
- alerts类型显示、SSH会话名称、搜索高亮定位
- 一次性/循环定时任务（run_mode+fire_at+自动禁用）
Dead code removed (400+ lines):
- SyncService batch_push/_push_single等5个方法（零调用者）
- 5个未使用schema（SyncCommands/SyncConfig/SyncSftp/FileDeploy/PaginatedResponse）
- 6个零调用service方法、3个无前端API端点
- 4个未使用import
Schema migrations:
- push_schedules: run_mode + fire_at列，cron_expr改NULL
- servers: 7个新列 + ssh_key_private/public VARCHAR(500)→TEXT
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
开发与审计标准文档
本目录存放所有可复用的开发规范与审计标准，可直接发给 AI 使用。
切换 AI 时：先读docs/project/standards-transfer-package.md（全量转接 + 严谨性契约）。
项目功能与接续（非本目录，但 AI 必读）
| 文档 | 路径 | 用途 |
|---|---|---|
| 标准转接包 | docs/project/standards-transfer-package.md |
全量标准索引；逐行审查与开发同等强制 |
| AI 接续 SSOT | docs/project/AI-HANDOFF-2026-05-23.md |
待办、验证、端口模型、接续提示词 |
| 全站功能清单 | docs/project/nexus-full-site-features.md |
18 页 + API 能力 Markdown 版 |
| 开发验收标准 | docs/project/development-acceptance-standard.md |
L0～L5 验收层级、命令、上线闸门 |
| 功能说明书 HTML | docs/Nexus-功能说明书.html |
面向人的全站说明（浏览器打开） |
文档清单（权威正文在本目录）
1. 系统开发标准（完整版）
文件: system-development-standard.md
用途: 全栈系统开发规范，约束代码生成、Code Review、架构评审
涵盖: 实现铁律、架构分层、后端编码、前端安全、数据库规范、测试、迁移、文档交付
2. 逐行审计完整规范（完整版）
文件: line-walk-audit-standard-v2.md
用途: AI 执行全量逐行代码审计的完整操作手册
涵盖: 8 步走读流程、规则表（PY/FE/SH/SQL 共 27 条）、Closure 格式、批次规划、§十四 执行提示词
3. 审计核心原则（速查卡）
文件: audit-core-principles.md
用途: 精炼的审计底线，每次任务开始前给 AI 的系统提示词前缀
涵盖: 审计本质、实现原则、DoD 逐项勾选、严重度表、修复纪律、10 大高频漏报
docs/project/下同名文件为副本；冲突以本目录为准。
Cursor 规则audit-line-review.mdc另引用docs/project/line-walk-audit-standard.md（Nexus 批次 SSOT）。
使用方式
给其他 AI 做代码审计（与团队同等严谨）
完整转接（推荐）：
→ 粘贴 docs/project/standards-transfer-package.md §8 完整提示词
→ 或按该文档档 C 全文阅读三件套
最小化（仅原则，仍须满足 DoD）：
→ 粘贴 audit-core-principles.md 全文
→ + line-walk-audit-standard-v2.md §十四.1 执行提示词
→ 附上要审计的代码
给其他 AI 做代码生成
→ 粘贴 system-development-standard.md 全文作为规范约束
→ + .cursor/rules/perfect-implementation.mdc + nexus-*.mdc
两者同时使用
系统提示词：
[system-development-standard.md 全文]
---
[audit-core-principles.md 全文]
任务：
请按以上标准对 [目录/文件] 进行逐行走读审计，发现问题直接修复。
版本历史
| 版本 | 日期 | 变更 |
|---|---|---|
| standards-transfer-package | 2026-05-23 | 全量标准转接包，接续 AI 必读 |
| system-development-standard v1.0 | 2026-05-23 | 从 Nexus mdc 规则 + Phase 1–4 审计实践提炼 |
| line-walk-audit-standard v2.0 | 2026-05-23 | 整合 audit-line-review.mdc + PY-11~PY-20 新规则 |
| audit-core-principles v1.0 | 2026-05-23 | 从 v2.0 提炼的精简版 |