diff --git a/docs/ai-agent-integration.md b/docs/ai-agent-integration.md index 3b6f8f0..ffa8efc 100644 --- a/docs/ai-agent-integration.md +++ b/docs/ai-agent-integration.md @@ -1,12 +1,12 @@ # AI Agent 接入使用说明 (Uniapp 前端) > 适用版本: backend PR-WB-MP-INLINE-MEDIA (2026-09-16) 及之后; PR-OSS-REGISTRY (2026-09-15) 之后 12 个云存储 provider -> 适用前端: `D:/projects/shop-projects/frontend` (uniapp 多端: 微信小程序 MP / H5 / App / Harmony) +> 适用前端: 本仓库 (uniapp 多端: 微信小程序 MP / H5 / App / Harmony) > 配套阅读: > - `common/js/ai-service.js`、`pages_tool/ai-chat/` > - 后端 `docs/mp-media-upload-integration.md` (媒体上传后端单点真源) > - 后端 `docs/ai-agent-protocol-spec.md` (本文档对应的完整后端协议规范, 仓内后端目录) -> - `D:/projects/refs/codebuddy-agent-sdk/docs/wb-cloud-sdk-coverage.md` (WB Cloud SDK 协议约束矩阵 — J7/J9/J10/J1/Q6) +> - WB Cloud SDK 协议约束矩阵 (`docs/wb-cloud-sdk-coverage.md`, WB Cloud SDK 参考仓内) (J7/J9/J10/J1/Q6) 本文档面向前端工程师, 解决把 WorkBuddy Agent / AI 智能客服集成进 uniapp 时 最常踩的 4 个坑: @@ -2177,7 +2177,7 @@ uniapp 内联 `:style` 绑定的 rpx 在 H5 端被浏览器丢弃, CSS 文件里 | 媒体上传后端单点真源 | `backend/docs/mp-media-upload-integration.md` | 后端 media_policy / HINTS / STS 错误翻译 | | WB Agent 平台协议 | `backend/src/addon/aiagent/docs/workbuddy_api.md` | ACP / AgentOS REST+ACP 双轨 | | **后端协议完整规范** | `backend/docs/ai-agent-protocol-spec.md` | SSE/WS 帧结构 + REST 端点 + A/B 路径差异 | -| **WB Cloud SDK 协议约束矩阵** | `D:/projects/refs/codebuddy-agent-sdk/docs/wb-cloud-sdk-coverage.md` | J7 (inline base64 ✅) / J9 (URL fetch, 服务端策略) / J10 (无 `/uploads/*` API) / J1 (KB 挂载) / Q6 (source_app 白名单) | +| **WB Cloud SDK 协议约束矩阵** | `docs/wb-cloud-sdk-coverage.md` (WB Cloud SDK 参考仓) | J7 (inline base64 ✅) / J9 (URL fetch, 服务端策略) / J10 (无 `/uploads/*` API) / J1 (KB 挂载) / Q6 (source_app 白名单) | | **后端 PR-WB-MP-INLINE-MEDIA ANALYSIS** | `backend/tests/wb_media_backend/ANALYSIS.md` §8 | attachments.data 字段 PR 详情 + 4 处文件改动面 + 协议层 A/B 对称修复 + 26 项 sanity 测试结果 | | ai-chat 前端入口 | `frontend/pages_tool/ai-chat/index.vue` | 路由 + agent_id 接收 | | ai-chat 消息渲染 | `frontend/pages_tool/ai-chat/ai-chat-message.vue` | 流式消息 / 历史 / 预览 | diff --git a/docs/i18n-audit-report.md b/docs/i18n-audit-report.md index b5b3914..74fe765 100644 --- a/docs/i18n-audit-report.md +++ b/docs/i18n-audit-report.md @@ -1,6 +1,6 @@ # 国际化(i18n)全量审计报告 -> 审计范围:`z:\D\projects\shop-projects\frontend` 下所有 `.vue` / `.js` 文件(排除 `node_modules`、`uni_modules`、`unpackage`、`docs`、`scripts` 等) +> 审计范围:项目根目录下所有 `.vue` / `.js` 文件(排除 `node_modules`、`uni_modules`、`unpackage`、`docs`、`scripts` 等) > 审计时间:2026-06-29 > 当前静态校验:`node scripts/i18n-check.js` 通过(zh-cn / en-us key 完全一致) > 修复状态:P0 / P1 / P2(兜底 + 验证)已修复并验证 ✅ diff --git a/docs/theme-multi-platform.md b/docs/theme-multi-platform.md index 7fbaa76..47e2d29 100644 --- a/docs/theme-multi-platform.md +++ b/docs/theme-multi-platform.md @@ -106,8 +106,9 @@ background: linear-gradient(<角度>, var(--token-start, #原始色) 0%, var(--t ## 四、强制兼容性测试项(上 HBuilder 前必做) ```bash +# 以下命令均在项目根目录(含 package.json)下执行 + # 1. 静态语法检查 -cd D:/projects/shop-projects/frontend node --check common/js/theme-override.js node --check store/index.js # App.vue 走 vue 编译器,不在 node 范畴