trade-message-center/.trellis/spec/mind-test-harness/development/index.md

Mind 测试支架开发规范

本规范定义 @trade-message-center/mind-test-harness 的唯一用途：人工联调时模拟外部 Mind 依赖，并提供针对 Bright 业务的本地操作页面。它不是产品运行时模块，也不是可复用的 workspace 库。

当前基线

• 包目录为 apps/mind-test-harness/；src/entry.ts 在显式执行 pnpm dev:harness 时启动 Mind 授权模拟和独立 Bright 联调页。
• 包可以依赖共享协议 @trade-message-center/onetalk-contract，但仓库内任何其它包不得依赖它；server 也不得导入它来注册路由或提供页面。
• 包是顺道编写的低优先级手工工具：不声明 build 或 test 脚本，不含测试文件，不产生 dist/；根 pnpm dev、typecheck、test、build、生产 Docker 镜像和发布流程都不包含它。它的失败只报告，绝不阻断主流程。

规范目录

文档	内容	状态
项目级代码架构	所有包共享的职责、依赖方向和源码约定	项目级必读
边界与启动契约	独立性、监听地址、环境变量和验证约束	已建立

开始前检查

1. 先阅读项目级代码架构和 边界与启动契约，确认改动只服务人工测试。
2. 搜索 workspace manifests，确认没有包把 @trade-message-center/mind-test-harness 列为 dependency、devDependency、peerDependency 或 optionalDependency。
3. 不新增 test/、*.test.*、build 脚本、outDir、dist 或 package export；完成支架改动不要求测试或将它接入根质量门禁，错误只需如实报告。
4. 修改联调页 Origin 或 Bright 目标地址时，同时核对 server 的 MIND_PAGE_ORIGIN，避免以 CORS/WS 绕过掩盖配置错误。