2026-03 Worklog

使用规范：在任何业务仓库（backend, admin, portal 等）提交代码并创建 MR 后，请立即在此文件末尾追加一条记录。 格式：- YYYY-MM-DD [角色/Author] 简述。关联 MR 或 Commit 链接。

记录

• 2026-03-05 [AI-Wangcai] 完成跨8仓深度分析，生成 P0 安全整改单与仓库收敛计划 ADR。
• 2026-03-06 [AI-Wangcai] 确立文档三区治理规范（Planning / Execution / Reference），并重构 sayclaw-docs 全站目录结构。
• 2026-03-06 [AI-Wangcai] 新增《风控引擎落地规划与数据模型》，包含 CDC 架构图、核心 DB 表结构设计与 3 个月实施里程碑。
• 2026-03-06 [AI-Wangcai] 重构 Reference/Modules 侧边栏，按 Portal、Admin、Core、Risk 四大业务域重新归类散落的功能文档。
• 2026-03-06 [AI-Wangcai] 新增《Web 端 WebSocket 直连架构》，规范了 app.sayclaw.ai 接入 OpenClaw 的双向通信协议与鉴权流程。

2026-03-07 00:01:26 自动巡检同步

\n### sayclaw-docs\n- a86dcf5 docs: 应用市场新增职能角色包(role_pack)体系，9个官方职能包规范 (小强)

• 3cb85cc fix: MDX < entity encoding in risk-engine-implementation (engineering) (小强)
• fbd8cd3 Merge branch 'wangcai' into 'main' (Administrator)
• c47cafe docs: add webchat websocket architecture spec (soosoogoo)
• 2902a01 docs: 增加风控引擎完整架构、数据库模型与 3 个月落地规划 (soosoogoo)
• 69c7982 fix: sidebar remove non-existent risk-control-architecture; fix MDX < entity encoding (小强)
• 41753e9 Merge branch 'wangcai' into 'main' (Administrator)
• 4a5e864 docs: refactor modules sidebar by product domain (Portal/Admin/Core/Risk) (soosoogoo)
• cf7b2d2 docs: 增加风控引擎完整架构、数据库模型与 3 个月落地规划 (soosoogoo)
• 5af82dd Merge branch 'wangcai-sync' into 'main' (Administrator)
• 9a1b00d chore(docs): 6小时自动状态同步 (2026-03-06 18:01:27) (soosoogoo)\n

2026-03-07 18:01:26 自动巡检同步

\n### sayclaw-docs\n- cb165c7 docs: WebChat WS 部署状态 - 仅 oc-ai-jp-2-02 测试中，未上线 (小强)

• 2632801 ci: fix file permissions after deploy (SayClaw Deploy)
• 1b90fbe ci: fix deploy SSH key injection (SayClaw Deploy)
• 74f864c ci: add GitLab CI/CD for docs auto-build + deploy (SayClaw Deploy)
• 1156df0 Merge branch 'wangcai-marketplace-docs' into 'main' (Administrator)
• 535d7df docs(portal): refine marketplace logic and hierarchy (soosoogoo)
• f11b18c Merge branch 'wangcai-docs-fix' into 'main' (Administrator)
• 8fd594a docs(portal): fix webchat ws architecture gaps (soosoogoo)\n\n### sayclaw-backend\n- 219d1bb Merge branch 'wangcai-scheduler-worker' into 'main' (Administrator)
• a9cffc4 fix: replace custom base64Encode with encoding/base64 stdlib (SayClaw Deploy)
• 603c222 fix: remove hardcoded ENCRYPT_KEY fallback, fatal if not set (SayClaw Deploy)
• 93f6307 feat(admin-api): enhance scheduler worker for composite marketplace items (soosoogoo)
• f091461 Merge branch 'wangcai-marketplace-api' into 'main' (Administrator)
• 6a1ad82 feat(portal-api): optimize marketplace installation API and data models (soosoogoo)
• e46d846 feat(portal-api): add Nginx auth_request handler for WebChat WS (soosoogoo)
• f7ad9c9 fix(portal-api): webchat session 语义修正 + gateway_url 修复 (Administrator)
• f371e89 fix(portal-api): webchat session 语义修正 + gateway_url 修复 (SayClaw Deploy)\n\n### sayclaw-app\n- 0394097 feat(h5): 隐藏浏览器底部导航栏 + PWA manifest (SayClaw Deploy)
• 9bde6fa Merge branch 'wangcai-ws' (soosoogoo)
• 03565dc feat(chat): WebChat 切换为 WebSocket 长连接 (Administrator)
• 0c33473 feat(chat): WebChat 切换为 WebSocket 长连接 (SayClaw Deploy)
• 022d00e feat(chat): WebChat switch to WebSocket connection via Gateway (soosoogoo)\n

2026-03-08 00:01:25 自动巡检同步

\n### sayclaw-docs\n- aa16d9b fix: remove deleted api-proxy from sidebars (小强)

• 8b32d09 Merge branch 'wangcai-llm-gateway-v2' into 'main' (Administrator)
• f28746b docs(core): 合并 API Proxy + API Key Management + LLM Gateway V2 为统一方案 (soosoogoo)
• 3bc4874 Merge branch 'wangcai-marketplace-profession' into 'main' (Administrator)
• 239af09 Merge branch 'wangcai-sync' into 'main' (Administrator)
• 7253453 docs(portal): add profession instance pool flow to marketplace (soosoogoo)
• 62dd1cf chore(docs): 6小时自动状态同步 (2026-03-07 18:01:26) (soosoogoo)\n\n### sayclaw-backend\n- cde23c2 Merge branch 'wangcai-llm-gateway-v2' into 'main' (Administrator)
• 3c92574 feat: LLM Gateway V2 — Phase 1-4 complete (soosoogoo)
• 309368c Merge branch 'fix/profession-worker-cleanup' into 'main' (Administrator)
• 2848a6b fix: prevent panic when workspace_path has no .openclaw dir (小强)
• 6f56fd7 Merge branch 'fix/profession-worker-cleanup' into 'main' (Administrator)
• 5fd6921 fix: use stdlib base64 + remove fuser -k in profession worker (小强)
• 7d7a882 Merge branch 'wangcai-profession-pool' into 'main' (Administrator)
• e8e37ed feat: profession instance pool — claim API, worker, and DB migration (soosoogoo)\n\n### sayclaw-app\n- 34a5475 fix: persist WS session_key + send history for memory continuity (小强)\n

2026-03-09 18:01:25 自动巡检同步

\n### sayclaw-docs\n- 220b3ee docs: 捕虾场 V2 — 每只虾完整技能列表、领域知识、配置文件清单 (Administrator)

• fd40511 Merge branch 'wangcai-shrimp-market' into 'main' (Administrator)
• cd2d5a0 Merge branch 'wangcai-sync' into 'main' (Administrator)
• 9f7959c docs: WebChat WS 架构增加执行记录 + 回退根因分析 (Administrator)
• 7204b41 docs(捕虾场): 重构文档结构 — 虾优先，配置/技能降级为高级玩法 (soosoogoo)
• b90afc6 docs(portal): 应用市场 → 捕虾场 + 10 只官方职能虾 (soosoogoo)\n\n### sayclaw-app\n- e8e2855 feat: 捕虾场按设计稿重写 — 1:1还原卡片/详情弹窗/配置文件浏览器/H5底部抽屉（PC+H5） (Administrator)
• fd85edd feat: 捕虾场 UI Pro Max — 渐变卡片/毛玻璃弹窗/彩色技能图标/微动画/层次阴影 (Administrator)
• 9502a5a fix: 捕虾场 — 修复侧边栏 + 增加虾详情面板（能力/巡检/推荐） (Administrator)
• 24945bb feat: 捕虾场 — 动态加载职能虾 + 一键捕获 + 技能市场（PC + H5） (Administrator)
• 8d72655 fix: H5 Chat header safe-area-inset-top + 底部间距优化（16px not 48px） (Administrator)
• 4208d3c fix: portal/m/chat.html 重定向到新页面 + 避免旧 CSS 问题 (Administrator)
• 626aa9e fix: Chat 实现完整 OC Gateway 协议（connect.challenge → connect → sessions.list → chat.send → chat events），不再走 portal-api 中继 (Administrator)
• 7703799 fix: Chat 页面从 HTTP POST 改为 WebSocket 直连 OC Gateway（共享 TG 会话 + 流式输出） (Administrator)
• 83cab97 fix: portal/index.html + portal/m/index.html 重定向到新 dashboard 页 (Administrator)
• e717fb4 feat: 全面同步设计稿 — PC+H5全页面 + 共享资源 + 动态API集成 (Administrator)
• 12e9c7f fix: H5 Chat 底部间距修复 — 默认48px留白+键盘弹出收紧（同步设计稿） (Administrator)\n

2026-03-10 更新日志

部署指南上线

• 新增 🚀 Deployment (部署指南) 章节，共 9 页：部署总览、基础设施、后端服务、前端部署、Nginx 完整配置、数据库 Schema、OC 实例集群、WebChat WS 链路、运维手册
• 地址：https://doc.sayclaw.ai/deployment/overview

WebChat 功能优化

1. 实例自动选择：Chat 页面无 instance_id 时自动调 /me/instances API
   • 1 个实例 → 自动进入
   • 多个实例 → 显示选择卡片
   • 0 个实例 → 提示前往工作台
2. 聊天记录：WS 连接后自动加载 OC Gateway chat.history（fallback portal API）

小三服务器启用

• oc-ai-jp-3-08 实例配置完成（trusted-proxy 模式）
• 绑定 [email protected] 测试账号
• Nginx oc-ws-map 已包含小三全部 8 个实例路由

AI Skills 安装

• Go 全家桶 16 个（golang + code-review/linting/testing/naming/documentation/concurrency/error-handling/interfaces/performance/style-core/context/control-flow/data-structures/defensive/functional-options/packages）
• React 2 个（react-expert, upgrade-react-native）
• 设计 12 个（ui-ux-pro-max, ant-design, refero-design, implement-design, create-design-system-rules, code-connect-components, tailwind-design-system, tailwind-4-docs, mobile-touch, awwwards-animations, motion-designer, micro-interactions）

2026-03-10 00:01:26 自动巡检同步

\n### sayclaw-docs\n- 39d9586 docs: 捕虾场后台管理完整方案（API+前端+SQL+执行计划） (iwelle)

• 8fe608e fix: api-key-management.md 对齐代码实际状态 (soosoogoo)
• 1eae9cd fix: sidebars.ts 对齐新目录结构 — core/ 移除，admin/ 完整 11 项 (soosoogoo)
• 09c19a1 docs: 后台文档 1:1 对齐菜单 — 9 个模块全覆盖 (soosoogoo)
• 2c89806 fix: sidebar 补齐 admin-users/instance-templates + 修正前端文档移动路径 (iwelle)
• 95134ef Merge wangcai-docs-restructure: 后台文档重构 — 对齐代码 68 个 API 端点 (Administrator)
• 9b74774 docs: 后台文档大重构 — 读代码对齐 68 个 API 端点 (soosoogoo)
• 18daf1e Merge wangcai-sync: 6小时自动状态同步 (Administrator)
• a73ca47 chore(docs): 6小时自动状态同步 (2026-03-09 18:01:25) (soosoogoo)\n\n### sayclaw-admin\n- bf5fbfb feat: 审计日志显示实例ID+用户邮箱列 (iwelle)
• 297c1c3 feat: 审计日志页面 — LLM请求日志+管理操作日志（搜索/筛选/分页） (iwelle)\n\n### sayclaw-backend\n- 9c31f32 feat: 审计日志关联用户 — api_key→实例→user_instances→用户邮箱 (小强)
• 1f2b6c7 feat: 审计日志直连 LiteLLM PG — 实时 1141 条请求记录 (小强)
• dfe937b feat: 审计日志 API — admin_logs + llm_request_logs 查询/搜索/分页 (小强)\n

2026-03-10 ~ 2026-03-11 更新日志

后端 (sayclaw-backend)

• 0fd3c23 feat: 重写 API Key 管理模块（api_master_keys.go / deprecated_sub_keys.go），实现 OneAPI channel/token 自动同步
• 0fd3c23 feat: portal-api 新增 POST /me/chat/save 端点，修复 webchat session verify 流程
• e172e89 Merge feature-webchat-tg-integration into main
• f1b1425 feat: LLM 日志与聊天消息双向关联（chatHistoryHandler + usageLogsHandler）
• 1a69c49 refactor: admin-api + portal-api 清除 LiteLLM 遗留 → One API (小强)

前端 (sayclaw-app)

• 4c9eabe feat: WebChat 页面 deliver=true 消息互通 + 历史记录加载 + saveChatMsg 持久化
• f050c41 feat: WebChat 和使用记录页面展示 LLM 关联信息（token/费用/延迟/模型）
• 7b0eee5 feat: 移动端 chat + usage 页面同步 Web 端完整功能
• 986cb3b feat: 移动端自动跳转（mobile-redirect.js 检测 UA/屏幕宽度）
• 3a9fe74 fix: 移动端 dashboard 添加底部导航菜单和 header，统一页面间距

文档 (sayclaw-docs)

• dc1fc88 refactor: 全项目清除 LiteLLM 遗留 → One API 命名统一 (小强)
• 87c887b docs: 用量审计&聊天记录完整方案 (小强)
• 96c014a merge: resolve worklog conflict + deployment docs (小强)
• 99b9d63 feat: deployment docs + worklog 2026-03-10 updates (小强)
• 2253556 Merge MR!19: chore(docs): 6小时自动状态同步 (Administrator)

2026-03-12 00:01:26 自动巡检同步

\n### sayclaw-docs\n- f835367 docs: 添加 Guardian 守护系统技术文档和管理后台 PRD (小强)

• 661124d merge: resolve worklog conflict — 合并 wangcai-sync 分支 (旺财)
• b362f25 docs: 更新 LLM 网关密钥管理 + WebChat 架构文档（反映 03/10-03/11 代码变更） (小强)
• 9424e5a docs: 添加 03/10-03/11 核心模块重构技术报告 + 更新工作日志和侧边栏 (小强)\n

2026-03-12 12:01:51 自动巡检同步

\n### sayclaw-docs\n- f344aef Merge branch 'wangcai-sync' into 'main' (Administrator)\n

2026-03-13 00:01:42 自动巡检同步

\n### sayclaw-docs\n- cb71699 Merge branch 'wangcai-sync' into 'main' (Administrator)\n