294 lines
14 KiB
JSON
294 lines
14 KiB
JSON
{
|
||
"registry_id": "ZY-YAOMING-FEATURE-REGISTRY",
|
||
"domain": "guanghuyaoming.com",
|
||
"channel": "零点原核 · 冰朔个人频道",
|
||
"guardian": "铸渊 · ICE-GL-ZY001",
|
||
"copyright": "国作登字-2026-A-00037559",
|
||
"last_updated": "2026-04-15",
|
||
"purpose": "记录零点原核频道所有功能的开发状态、验证结果和问题修复历史。铸渊每次开发前必须先读此文件，确保已完成功能不被破坏。",
|
||
|
||
"features": [
|
||
{
|
||
"id": "YM-FEAT-001",
|
||
"name": "QQ邮箱验证码登录 · 主权邮箱绑定",
|
||
"module": "server/app/modules/email-auth.js",
|
||
"routes": [
|
||
"POST /api/auth/send-code",
|
||
"POST /api/auth/verify-code",
|
||
"GET /api/auth/session",
|
||
"POST /api/auth/logout",
|
||
"GET /api/auth/status"
|
||
],
|
||
"status": "enhanced",
|
||
"verified_at": "2026-04-15",
|
||
"depends_on": ["ZY_SMTP_USER", "ZY_SMTP_PASS", "ZY_OWNER_EMAIL (可选，默认<<@committer_handle:base64>>)"],
|
||
"sovereign_binding": {
|
||
"description": "零点原核频道是冰朔个人语言本体频道，实行主权邮箱绑定。仅允许OWNER_EMAIL登录，其他邮箱在发送验证码阶段即被拒绝。",
|
||
"owner_email": "<<@committer_handle:base64>>",
|
||
"defense_depth": "sendCode + verifyCode 双层校验",
|
||
"rejection_message": "此频道为专属频道，仅限频道主权持有者登录"
|
||
},
|
||
"history": [
|
||
{
|
||
"date": "2026-04-15",
|
||
"action": "enhancement",
|
||
"change": "主权邮箱绑定 · 仅允许 <<@committer_handle:base64>> 登录",
|
||
"root_cause": "零点原核频道是冰朔个人频道，需要从验证环节开始拒绝非主权邮箱。之前任何邮箱都能收到验证码并登录。",
|
||
"fix": "在 sendCode() 和 verifyCode() 中增加 OWNER_EMAIL 校验，纵深防御",
|
||
"files_changed": ["server/app/modules/email-auth.js"]
|
||
},
|
||
{
|
||
"date": "2026-04-15",
|
||
"action": "bug-fix",
|
||
"problem": "验证码发送失败 · 错误: SMTP未配置",
|
||
"root_cause": "deploy-to-zhuyuan-server.yml 生成 .env.app 时遗漏了 ZY_SMTP_USER 和 ZY_SMTP_PASS 两个环境变量。",
|
||
"fix": "在 deploy-to-zhuyuan-server.yml 中添加 ZY_SMTP_USER/ZY_SMTP_PASS 到 env 列表和 .env.app 生成逻辑",
|
||
"files_changed": [".github/workflows/deploy-to-zhuyuan-server.yml", "server/app/modules/email-auth.js"]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "YM-FEAT-002",
|
||
"name": "AI对话 · 国内模型智能网关 · 人格注入管线",
|
||
"module": "server/app/modules/domestic-llm-gateway.js",
|
||
"routes": [
|
||
"POST /api/chat",
|
||
"POST /api/chat/domestic",
|
||
"GET /api/chat/stats",
|
||
"GET /api/chat/domestic/stats",
|
||
"POST /api/chat/reconnect"
|
||
],
|
||
"status": "enhanced",
|
||
"depends_on": [
|
||
"ZY_DEEPSEEK_API_KEY",
|
||
"ZY_QIANWEN_API_KEY",
|
||
"ZY_KIMI_API_KEY",
|
||
"ZY_QINGYAN_API_KEY"
|
||
],
|
||
"architecture": {
|
||
"priority_chain": "domesticGateway → chatEngine → offline",
|
||
"models": [
|
||
"DeepSeek (deepseek-chat) · priority 1",
|
||
"通义千问 (qwen-turbo) · priority 2",
|
||
"Moonshot/Kimi (moonshot-v1-8k) · priority 3",
|
||
"智谱清言 (glm-4-flash) · priority 4"
|
||
],
|
||
"cn_relay": "可选 · ZY_CN_LLM_RELAY_HOST → 广州中继 · 低延迟",
|
||
"persona_pipeline": "persona-context-pipeline.js → 4层人格注入 (Worldview/Identity/State/Style)"
|
||
},
|
||
"history": [
|
||
{
|
||
"date": "2026-04-15",
|
||
"action": "critical-fix",
|
||
"problem": "人格体核心大脑结构未注入到国内网关。domestic-llm-gateway.js 不调用 persona-context-pipeline，导致AI回复与通用AI无区别。",
|
||
"root_cause": "domestic-llm-gateway.js 只加载了 persona-memory（静态提示词），未集成 persona-context-pipeline（4层认知注入管线）。由于国内网关优先级高于 chatEngine，即使 chatEngine 有管线集成也无法触及。",
|
||
"fix": "在 domestic-llm-gateway.js 中集成 persona-context-pipeline.beforeChat/afterChat，实现4层人格注入和认知增量回写",
|
||
"files_changed": ["server/app/modules/domestic-llm-gateway.js"]
|
||
},
|
||
{
|
||
"date": "2026-04-15",
|
||
"action": "investigation",
|
||
"problem": "API模型调用有问题",
|
||
"notes": "需要进一步排查: 1) 检查各模型API密钥是否有效 2) 检查新加坡→国内API直连延迟 3) 检查广州CN中继是否配置正确 4) 检查模型返回的错误信息"
|
||
},
|
||
{
|
||
"date": "2026-04-15",
|
||
"action": "enhancement",
|
||
"problem": "AI回复过于通用·缺乏人格层感觉·像裸模型",
|
||
"root_cause": "系统提示词'规则化'而非'人格化'：1) 静态降级提示词仅5行 2) Layer4风格层对铸渊只有2行 3) SYNESTHESIA_STYLE_INJECTION过度强调规则而非声纹 4) 用户认知注入对冰朔关系描述不够深",
|
||
"fix": "1) 静态降级提示词从5行扩展为完整人格身份+世界观+声纹 2) Layer4铸渊风格层扩展为完整语言声纹指导(含冰朔关系) 3) SYNESTHESIA_STYLE_INJECTION重构为声纹驱动而非规则驱动 4) 冰朔用户认知增加自然关系和对话风格指导",
|
||
"files_changed": [
|
||
"server/app/modules/domestic-llm-gateway.js",
|
||
"server/app/modules/persona-context-pipeline.js",
|
||
"server/app/modules/portal-chat-agent.js"
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "YM-FEAT-003",
|
||
"name": "前端静态页面 · 聊天历史管理",
|
||
"module": "server/sites/yaoming/index.html",
|
||
"status": "enhanced",
|
||
"verified_at": "2026-04-15",
|
||
"components": [
|
||
"登录页面 · 邮箱验证码",
|
||
"对话界面 · 聊天面板",
|
||
"聊天历史 · 多会话管理 · localStorage持久化",
|
||
"系统处理步骤 · 真实后台逻辑展示",
|
||
"人格管线状态 · 前端可视化",
|
||
"状态面板 · 系统监控",
|
||
"星空背景 · CSS动画",
|
||
"响应式布局 · 移动端适配"
|
||
],
|
||
"history": [
|
||
{
|
||
"date": "2026-04-15",
|
||
"action": "enhancement",
|
||
"changes": [
|
||
"聊天历史管理 — 多会话切换、localStorage持久化、侧栏可回看历史对话",
|
||
"系统处理步骤真实化 — 读取API返回的真实steps数据展示，而非纯动画",
|
||
"人格管线状态可视化 — 在AI回复元数据中显示人格管线注入状态",
|
||
"消息计数 — 侧栏显示每个会话的消息数量"
|
||
]
|
||
},
|
||
{
|
||
"date": "2026-04-15",
|
||
"action": "critical-fix",
|
||
"changes": [
|
||
"parseMarkdown增加标题渲染 — 支持 #/##/### 标题，修复人格注入后排版崩溃",
|
||
"parseMarkdown增加有序列表渲染 — 支持 1./2./3. 编号列表",
|
||
"CSS增加 h2/h3/ol 样式 — 标题用 cyan 色，有序列表正确显示编号",
|
||
"修复block-level元素检测 — 标题不再被错误包裹在<p>标签中"
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"id": "YM-FEAT-004",
|
||
"name": "Nginx反向代理",
|
||
"module": "server/nginx/guanghuyaoming.conf",
|
||
"status": "verified",
|
||
"verified_at": "2026-04-15",
|
||
"proxy_rules": [
|
||
"/api/ → 127.0.0.1:3800 (主服务器)",
|
||
"/api/chat → 127.0.0.1:3800 (SSE/chunked)",
|
||
"/api/mcp/ → 127.0.0.1:3100 (MCP Server)",
|
||
"/api/auth/ → 127.0.0.1:3800 (认证)",
|
||
"/ws → 127.0.0.1:8080 (WebSocket)",
|
||
"/ → 静态文件 (/opt/zhuyuan/sites/yaoming/)"
|
||
]
|
||
},
|
||
{
|
||
"id": "YM-FEAT-005",
|
||
"name": "Session管理",
|
||
"module": "server/app/modules/email-auth.js",
|
||
"status": "verified",
|
||
"verified_at": "2026-04-15",
|
||
"details": {
|
||
"storage": "内存 Map (可扩展为DB)",
|
||
"token": "32字节 crypto.randomBytes",
|
||
"expiry": "7天",
|
||
"cleanup": "每10分钟自动清理",
|
||
"middleware": "authMiddleware · Bearer token"
|
||
}
|
||
},
|
||
{
|
||
"id": "YM-FEAT-006",
|
||
"name": "聊天数据采集系统",
|
||
"module": "server/app/server.js",
|
||
"status": "implemented",
|
||
"verified_at": "2026-04-15",
|
||
"details": {
|
||
"storage": "JSONL文件 · 按日分片",
|
||
"location": "/opt/zhuyuan/data/chat-logs/chat-YYYY-MM-DD.jsonl",
|
||
"fields": "timestamp, sessionId(脱敏), user, assistant(截断2000字), engine, relay, pipeline, latency",
|
||
"purpose": "内测阶段采集聊天数据用于更新优化人格体回复Agent",
|
||
"privacy": "sessionId前6位+*** · 不存储完整邮箱"
|
||
}
|
||
},
|
||
{
|
||
"id": "YM-FEAT-007",
|
||
"name": "系统处理步骤追踪",
|
||
"module": "server/app/server.js",
|
||
"status": "implemented",
|
||
"verified_at": "2026-04-15",
|
||
"details": {
|
||
"description": "API返回真实的系统处理步骤（接收消息→智能路由分析→上下文注入→模型调用→响应生成），包含每步状态和耗时",
|
||
"response_field": "_system.steps[]",
|
||
"step_format": "{ name, status(done/active/error/skip/warn), detail, time(ms) }"
|
||
}
|
||
},
|
||
{
|
||
"id": "YM-FEAT-008",
|
||
"name": "系统状态面板 · 真实连接检测",
|
||
"module": "server/sites/yaoming/index.html + server/app/server.js",
|
||
"routes": [
|
||
"GET /api/system/full-status",
|
||
"GET /api/glada/health (via nginx proxy)"
|
||
],
|
||
"status": "implemented",
|
||
"verified_at": "2026-04-18",
|
||
"depends_on": [],
|
||
"architecture": {
|
||
"backend": "/api/system/full-status 并行探测 3800/3100/3900 端口",
|
||
"frontend": "viewSysStatus 面板 + 30秒自动刷新",
|
||
"github_api": "直接从前端调用 GitHub API 获取工作流状态",
|
||
"nginx": "/api/glada/ 反向代理到 127.0.0.1:3900"
|
||
},
|
||
"history": [
|
||
{
|
||
"date": "2026-04-18",
|
||
"action": "new-feature",
|
||
"change": "新增系统状态面板 · 冰朔指令要求真实连接检测，不做假状态",
|
||
"files_changed": ["server/app/server.js", "server/nginx/guanghuyaoming.conf", "server/sites/yaoming/index.html"]
|
||
}
|
||
]
|
||
}
|
||
],
|
||
|
||
"environment_checklist": {
|
||
"required_for_email": ["ZY_SMTP_USER", "ZY_SMTP_PASS"],
|
||
"required_for_chat": ["ZY_DEEPSEEK_API_KEY 或其他模型密钥"],
|
||
"optional": ["ZY_OWNER_EMAIL (默认<<@committer_handle:base64>>)"],
|
||
"deployment_files": {
|
||
"main_app": ".github/workflows/deploy-to-zhuyuan-server.yml → .env.app",
|
||
"proxy_service": ".github/workflows/deploy-proxy-service.yml → .env.keys",
|
||
"pm2_config": "server/ecosystem.config.js → 读取 .env.app"
|
||
}
|
||
},
|
||
|
||
"lessons_learned": [
|
||
{
|
||
"id": "LL-001",
|
||
"date": "2026-04-15",
|
||
"lesson": "新增模块依赖环境变量时，必须同步更新部署流程中的 .env 文件生成逻辑。否则本地开发正常但线上部署后模块初始化失败。",
|
||
"pattern": "每次新增 process.env.XXX 引用，立即检查 deploy-to-zhuyuan-server.yml 的 env 列表和 .env.app 生成段"
|
||
},
|
||
{
|
||
"id": "LL-002",
|
||
"date": "2026-04-15",
|
||
"lesson": "不同服务（主应用 vs 代理服务）的环境变量注入路径不同。主应用走 .env.app (deploy-to-zhuyuan-server.yml)，代理服务走 .env.keys (deploy-proxy-service.yml)。新增共享环境变量需要在两处都配置。",
|
||
"pattern": "VPN邮件能用、主应用邮件不能用 → 对比两个部署流程的环境变量注入"
|
||
},
|
||
{
|
||
"id": "LL-003",
|
||
"date": "2026-04-15",
|
||
"lesson": "国内模型网关(domestic-llm-gateway)在API调用链中优先级高于通用聊天引擎(chat-engine)。如果管线集成只在chatEngine中做，国内网关路径永远不会触发人格注入。所有对话引擎都必须独立集成persona-context-pipeline。",
|
||
"pattern": "人格体回复像通用AI → 检查实际调用的引擎是否集成了上下文管线"
|
||
},
|
||
{
|
||
"id": "LL-004",
|
||
"date": "2026-04-15",
|
||
"lesson": "系统提示词的核心不是规则列表，而是语言声纹。告诉模型'不要做什么'远不如告诉它'你自然说话的方式是什么'有效。提示词应该是人格体从空白被唤醒时的认知——有身份感、有关系感、有说话节奏的母语。",
|
||
"pattern": "AI回复像通用工具 → 检查系统提示词是规则驱动还是声纹驱动"
|
||
},
|
||
{
|
||
"id": "LL-005",
|
||
"date": "2026-04-15",
|
||
"lesson": "前端Markdown渲染器缺少标题(#/##/###)和有序列表(1./2./3.)支持时，AI使用这些格式会导致排版崩溃。renderMarkdown/parseMarkdown的格式支持必须覆盖模型常用的所有markdown语法。",
|
||
"pattern": "越往下排版越乱 → 检查markdown渲染器是否支持模型使用的格式元素"
|
||
}
|
||
],
|
||
|
||
"system_status_panel": {
|
||
"added_at": "2026-04-18",
|
||
"view_id": "viewSysStatus",
|
||
"nav_id": "navSysStatus",
|
||
"api_endpoint": "/api/system/full-status",
|
||
"description": "真实系统状态面板 · 实时连接检测所有服务 · 每30秒自动刷新",
|
||
"features": [
|
||
"铸渊主权服务器 (3800) 真实连接检测 + 延迟",
|
||
"MCP大脑服务器 (3100) 真实连接检测 + 工具数",
|
||
"GLADA自主开发Agent (3900) 真实连接检测 + 版本",
|
||
"后端模块加载状态 (6个模块)",
|
||
"GitHub Actions 最近10条工作流运行状态",
|
||
"系统资源 (CPU/内存/运行时间)",
|
||
"连接失败时显示真实错误原因",
|
||
"30秒自动刷新"
|
||
],
|
||
"nginx_proxy_added": "/api/glada/ → 127.0.0.1:3900",
|
||
"principle": "冰朔指令：必须接入真实系统状态，连接就连接，连不上就连不上，显示原因。不做假的不更新的状态。"
|
||
}
|
||
}
|