WechatExplorer/docs/development/overview.md

开发、测试与构建

本文面向希望参与 TraceMemo 开发、验证文档或维护集成的贡献者。普通用户请从第一次使用开始。

技术基线

• Electron + React + TypeScript；
• pnpm 7+；
• Go（构建微信连接器）；
• 平台对应的 Electron/native 构建环境。

产品文档的事实来源优先级是：当前源码 → 当前 UI/Renderer → 测试 → package/config → README/docs → 历史资料。功能、API、版本、隐私和兼容性变更时，不要只改 README。

本地开发

pnpm install
pnpm dev

本地依赖安装、Go 环境和 Electron 二进制下载异常，请查看本地启动排障。

常用检查：

pnpm typecheck
pnpm test:unit
pnpm test:component
pnpm test:integration
pnpm test:e2e:build

完整测试入口 pnpm test 还会运行 Skill 安装指令、微信连接器、构建和 Playwright 测试；需要对应平台环境。

代码变更对应文档

代码区域	需要同步检查的文档
src/shared/ai-search.ts、AI Search pipeline	user-guide/ai-search.md、concepts/answer-sources.md
src/shared/knowledge.ts、src/main/knowledge/	user-guide/knowledge.md、concepts/how-it-works.md
src/shared/voice-recognition.ts	user-guide/voice.md
src/shared/group-report.ts、报告 UI	user-guide/report.md、API/Agent 文档
src/shared/export.ts、导出服务/UI	user-guide/export.md
src/main/services/recall-archive-service.ts、防撤回设置	user-guide/recall-protection.md、user-guide/privacy.md
src/shared/local-api-test.ts、src/main/http-server.ts	agent/api.md、api-security.md、打包 Skill
Agent Hub service/UI	agent/agent-hub.md、user-guide/privacy.md
设置导航、连接页面	user-guide/getting-started.md、docs/README.md

文档检查

提交文档变更前至少执行：

git diff --check
rg -n "v2\.1\.7|TraceMemo|迹忆|mcpServers|无鉴权" README.md docs --glob '*.md' --glob '!DOCUMENTATION_AUDIT.md' --glob '!development/overview.md'

历史迁移说明可以出现旧版本号；正式使用指南不要把过时版本写成当前版本。负向澄清“6131 不是 MCP Server”可以保留，以防用户照抄错误配置。