EveryPublish 项目总文档（唯一入口）

一句话定位：企业多平台官方账号的发布中台——网页控制台协作、审核、排期，客户端单点持号、自动发布。

当前状态：开发进行中（阶段一网页端 D1）。进度跟踪见 docs/progress.md。

文档地图（全部文档一览）

#	文档	用途	主要读者	状态
1	docs/prd.md	产品需求：做什么、给谁用、体验与验收要点	全员	v1.0 待评审
2	docs/tech-stack.md	技术栈定版（唯一权威来源）	开发	定版
3	docs/system-design.md	系统设计：功能清单/API/鉴权/传输/数据模型	开发	v1
4	docs/logic-diagrams.md	11 张逻辑图全集（架构/时序/状态机/排期）	全员	完成
5	docs/delivery-plan.md	日计划 D1-D13 + 每步验收标准 + 风险	开发/管理	完成
6	docs/page-wireframes.md	全部 22 个页面的 ASCII 线框图	前端	完成
7	docs/frontend-guide.md	starter 组件清单/场景映射/过渡效果/套用规范	前端	完成
8	docs/dev-schedule.md	AI 加速排期（参考，已被 #5 取代）	管理	归档
9	docs/multi-platform-publish-plan.md	方案总纲：调研/开源聚合/IP风控/协议考证	全员（背景）	完成
10	docs/progress.md	开发进度跟踪：逐日验收状态实时更新	全员	进行中
12	docs/web-test-report.md	网页端测试报告（检查点①）	全员	已验收 ✅
13	docs/client-test-checklist.md	Windows 客户端测试清单（检查点②）	开发/测试	待验收
11	docs/api.md	服务端接口文档（认证/工作区/成员/账号/素材/任务/挑战/通知/审计）	开发	v1

阅读路径

• 产品评审：1 → 4 → 5
• 开发开工：2 → 3 → 5 → 7 → 6
• 新人上手：1 → 9 → 4 → 3
• 向客户/上级汇报：1（定位与范围）+ 5（排期）

关键决策速览

项	决策
技术栈	React+TDesign（页面）/ Go（网页端服务层+客户端核心）/ WinUI 3（客户端壳）/ MySQL 8 + Redis（数据）
MVP 范围	网页端全部 + Windows 客户端 + 抖音/快手/小红书/B站；素材本地盘直链
二期	视频号、官方API通道(X/IG/YouTube/TikTok)、OSS、托管Agent
连接方式	WSS 主通道（Agent 出站，Ed25519 设备签名）+ HTTPS 降级；大文件直链不走 WSS
鉴权	用户 JWT+refresh；Agent 配对码+设备密钥；平台账号 cookie 仅存客户端本地
职责边界	网站=分配任务+收状态（零平台凭据）；客户端=持号+登录鉴权+发布执行（凭据仅本机）
红线	矩阵养号/搬运去重绕过/刷量/私信轰炸一律不做

目录结构

• apps/web —— 前端（TDesign starter，MIT）
• server/ —— Go 服务器（REST + WSS 网关 + 队列；端口 8090）
• shared/ —— 协议 Go module（server 与 agent-core 共用）
• client/ —— Windows 客户端（ui WinUI3 + core agent-core，D8 起）
• docs/ —— 全部文档（见上表）
• diagrams/png —— 11 张逻辑图 PNG（2400px 宽，白底）；diagrams/mmd —— mermaid 源文件
• tools/ —— 联调诊断（diag-connection.mjs）

开发进行中（阶段一 D1-D7）

• 排期：docs/delivery-plan.md（含检查点①网页端测试 / 检查点②客户端测试，均需用户确认）
• 甘特图：diagrams/png/11-开发排期甘特.png
• 本地启动：make infra-up（MySQL）→ make run（Go 后端 :8090）→ cd apps/web && pnpm dev（前端 :3003）
• 部署态（单进程）：cd apps/web && pnpm build 后直接 make run，Go 服务在 :8090 同时托管前端 + API + WSS（无需 vite）