# 万小智建站执行总指令（收口版）

版本：v1.0　日期：2026-11-18　适用对象：本站点后续所有迭代

## 一、一句话定位

PCB之家是一个面向 PCB 与电子制造供需双方的产业门户：需求方发标、发询价、查工具、看内容，服务商接单、报价、履约；平台负责规则、信用与留痕，不介入资金结算。

## 二、能力边界（不可越线）

| 类别 | 可以 | 不可以 |
| --- | --- | --- |
| 账号 | 邮箱 OTP、短信 OTP | 微信/Google 等第三方登录、自建账号体系 |
| 数据 | 平台数据库、平台自动生成的增删改查后台 | 手工执行 SQL、导出源码、访问数据库控制台 |
| 资金 | 记录金额、账期、对账口径 | 支付通道、担保交易、代收代付、保证金扣划 |
| 通知 | 站内消息、站内任务提醒 | 短信、邮件、Web Push 实际触达 |
| 文件 | 记录文件名与外部链接 | 未开通存储时伪造下载地址 |
| 广告 | 展位规则与投放方案设计 | 充值、扣费、结算 |
| 签章 | 订单内确认记录与存证台账 | 第三方 CA 签章、人脸核身 |

## 三、执行顺序（每轮固定）

1. **对齐需求**：先读 `prd.md`，确认本轮改的是哪条已登记功能；不在范围内的事项先登记再实施。
2. **改数据层**：`src/data/*.ts` 先改类型与读写函数，再改页面；禁止页面内直连数据库。
3. **改界面**：沿用现有设计 token、组件与路由，不做全站重写；浅色底上的强调色必须落在可读范围内。
4. **自检**：`pnpm run type-check` 零新增错误；涉及页面结构时补 `pnpm run build` 与产物核对。
5. **留档**：`prd.md` 追加本轮变更，`public/downloads` 下的方案文档同步更新。

## 四、优先级

1. 影响下单与履约闭环的问题：报价、中标、订单、履约节点、交付物。
2. 影响信任与合规的问题：信用分口径、风控拦截、文案合规、隐私提示。
3. 影响可发现性的问题：TDK、结构化数据、内链、可抓取性。
4. 工具与内容体验：计算器、诊断、论坛、下载中心。
5. 视觉细节：配色、动效、留白。

同一轮若出现冲突，按上述顺序取舍，低优先级不得阻塞高优先级。

## 五、数据一致性铁律

- 一个数值只有一个来源。报价数由数据库统计，信用分由流水累计，进度由状态机推导，前端只做展示。
- 信用分每次变化必须落一条流水，流水之和必须等于当前分与初始分之差。
- 履约节点时间严格递增；进入新阶段即生成对应交付物占位记录。
- 前端展示的扣分、交期、金额与后台一致，不一致时以流水与合同版本为准并修前端。

## 六、文案红线

- 禁极限词、绝对化承诺、虚假紧迫、医疗类违禁表述。
- 所有性能与工艺数据标注「估算」「以工厂确认为准」「以双方确认版本为准」。
- 不承诺价格最优、交期最短、良率最高；改写成可核验的条件句。

## 七、验收口径

| 项目 | 通过标准 |
| --- | --- |
| 类型检查 | 存量错误数不增加，改动文件零错误 |
| 构建 | 成功且新增文档进入产物 |
| 功能 | 主路径可完成：发标 → 报价 → 中标 → 履约 → 验收 → 评价 |
| 数据 | 刷新后关键结论不丢失；跨端差异有明确提示 |
| 可读性 | 正文与背景对比度达标，浅色底不使用浅色字 |

## 八、已知未闭环项

1. 存储通道未开通：证书、案例影像、认证附件只能记录链接。
2. 报价表缺少质保月数字段，表单选择暂不落库。
3. 履约完成率暂无数据源，界面显示「暂无」。
4. 站内 IM 富媒体通道未接通，仅支持文本与图片链接。

以上四项在具备条件前不得以「已完成」表述对外。