# NEXA Codex实施任务书

## v1.6 已交付工作台能力

当前 HTML 已包含连线六个月路线图、七条业务线选项卡、业务及任务的四色状态、总历时与当前状态历时、独立匿名留言，以及十二套岗位泳道 / 任务流。69 个流程步骤分解记录在 source/process-flow-data.json，保留原始 SOP 文本，新增 R/A/C、整改与交接分工为待 G1 批准的岗位提案。

source/collaboration-server.py 提供 SQLite 持久化、版本冲突保护、留言请求去重及共享导出；数据库在站点目录外。当前服务为本地运行，未部署公网。后续外部协作需部署该后端及持久化存储，使用同一 HTTPS 服务地址；不要只托管 HTML 或把 localStorage 当成多人共享。组织编辑器仍沿用原有浏览器保存，不自动同步 Word / Excel。


版本 1.5　编制 2026-10-05　周期 T0启动日起六个运营月

本任务书与WOC手册、六个月执行台账、路线图和execution-data.json共同使用。首先落实当前可确认的输入和方案，再实现经批准的全案。人员按岗位配置；预算、合作条款、SDK、地区及实际能力缺失时保留待确认。

路线图 v1.5 以 NEXA 官网首页为准，复用森林视频、白色留白、居中标题、玻璃仪表盘和 GSAP 入场节奏。原 Logo 保持原稿，品牌绿色为 #22C55E。居中的执行面板按 M1–M6 展示真实计划基线，每月八项任务可打开责任、依赖、KPI 与验收证据。门店概念图支持放大；三类设备规划弹窗注明概念状态、待核验条件和关联任务。支持首屏、任务预览及设备弹窗的中英文切换，运营基线文档和验收记录继续使用中文。

背景支持暂停/恢复、离屏暂停和减少动态效果，视频失败时保留静态渐变背景。组织编辑器数据结构与保存键保持不变；岗位编辑、拖拽、撤销、导入导出继续使用原有逻辑。页面数字均为计划范围，不能当作经营完成量、真实能源读数或已经接入的硬件证据。

## 先读取并核验

1. 读取用户当前指令及目标目录中的AGENTS.md。
2. 读取WOC手册、execution-data.json、台账中已批准版本及Q01至Q12的最新答案。
3. 盘点现有NEXA工程和官网。当前核验的server/app.mjs只允许simulator/disabled，realHardware和payments为false；后续先验证是否已变化。
4. 指定R执行岗位、A负责岗位、独立验收岗位，确认可用工时与证据目录。
5. 输出本轮范围、依赖、预期产物和验收，然后在已授权范围执行。

## 推荐执行顺序

第一轮完成C01、C03和C10的需求设计及表单，不依赖实物接口的部分先落地。C02同步做逐店勘察与空间要求。C04、C05先做资料与技术适用性核验；C06至C09由对应岗位补齐合同和专业材料。G2后实物与系统联调，G3后复制门店和受控客户交付。

## C01 公司组织与运营制度

前置输入 Q01 Q02 Q12 W0-M1

交付 公司章程字段、股权/主体图、19类岗位任命表、RACI、签约/采购/付款/验收/发布权限矩阵、预算申请模板。

验收 每个事项一个A；岗位可填人员与备岗；金额阈值待G1批准。不得把岗位建议当实际雇员。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C02 三店展厅全案

前置输入 Q03 W1-M1 W3-M2 W6-M2

交付 S1/S2/S3逐店设计brief、客户动线、五场景演示脚本、BOQ字段、施工采购排期、开业验收清单。

验收 三店独立许可、预算、照片、缺陷与签字；先验证S1再复制。概念图不推定面积或设备能力。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C03 系统PRD与交互设计

前置输入 W2-M1 Q04 Q05

交付 现有能力盘点、角色矩阵、十流程PRD、信息架构、可点击原型、数据模型、API契约、UAT。

验收 复用NEXA视觉；客户、店员、工程师、运营角色分离；异常和权限具有真实设计。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C04 贝乐与BroadLink实物集成

前置输入 Q05 Q11 W3-M1 W6-M1

交付 授权/SDK清单、准确型号/固件能力矩阵、适配器契约、设备身份绑定、遥测及命令模型、100次控制测试计划。

验收 真实样品至少三类；接收与物理完成分离；无反馈IR标记sent而不伪造reported；幂等、超时、解绑和跨账户拒绝通过。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C05 Meta Muse与语音AI

前置输入 Q06 C03 C04

交付 所指产品核验、加拿大和API商用条件结论、ASR/意图/工具/权限/回执架构、含糊与危险意图处理、200条测试集。

验收 接口或区域不满足时交付阻塞与可选技术方案待审；不以其他模型的演示冒充Muse。中英文、噪声、权限撤销和误执行分别统计。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C06 擎洲光电加拿大合作

前置输入 Q07 W4-M1

交付 中英文主体和授权核验、合作SOW及条款差异、产品认证与质量责任、加拿大场景试点、交付对账模板。

验收 法务与双方审稿可核验；未签协议不得写已合作；试点验收须现场及双方证据。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C07 BC PNP材料管理

前置输入 Q08 W5-M1 Q02 Q03

交付 Base/Regional/Strategic Projects路径对比材料、顾问材料索引、投资/就业/主动管理证据模板、外部事件状态机。

验收 专业资格结论由持牌顾问确认；不保证获批、不默认三店支出合格、不生成虚假投资或员工记录。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C08 国内选品与本地售后

前置输入 Q09 W6-M1 C03 C04

交付 十个候选SKU评审、五样品测试、合同SLA、安装交付、工单分级、中国升级、RMA、备件库存与供应商评分。

验收 本地客户有单一责任岗位；时区/工作时段/首次响应/7日观察明确；国内资料脱敏；库存序列号可追溯。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C09 供应链金融落地

前置输入 Q10 W7-M1 W6-M2

交付 真实贸易资金流、债权/货权/担保材料、资金方比较、全成本、13周现金流、试单对账与停止条件。

验收 股权、申请人个人投资和债务分别处理；授信与放款与结算分别记录；最终资金或担保行为由有权岗位操作。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## C10 WOC运营工作台

前置输入 C01 C03 execution-data.json

交付 任务/关口/KPI/岗位/证据/风险/合同/SKU/三店/客户订单工单的持久化后台；导入导出及角色权限。

验收 所有验收条件服务端验证；匿名或只隐藏按钮不能保护数据；不把本地计划页包装为已连接生产后台。

证据 文件版本、测试对象和环境、样本、结论、缺陷、复核人及日期。

## 系统十条关键流程

登录与权限；建家及成员；设备绑定与解绑；控制与状态；断网/超时恢复；五场景及逐设备结果；语音授权与确认；商品报价及订单；安装验收；售后升级与RMA。

Home OS为客户应用。门店与运营后台连接CRM、报价、订单、库存、安装与工单。两者共享经授权的数据对象和ID，前端不写入可信设备遥测或财务结算。

## 设备和语音契约

Device含稳定ID、tenant/site/house归属、型号、固件、序列号、能力、在线状态、source。Telemetry为数值、单位、测量时间、接收时间、质量和来源。Command含commandId、幂等键、意图、参数、授权主体、期望状态、执行状态及设备级结果。

命令状态应以实际协议能力定义，例如queued、sent、ack、reported、failed、unknown。厂商ack代表收到，不当然代表物理完成。IR设备无报告状态时显示sent/unverified；可以增加人工或独立传感验证。超时保留原命令ID，不自动改键重复执行。

语音链为音频同意 → ASR → 结构化意图 → 家庭与角色权限 → 参数与风险判断 → 工具执行 → 独立回执 → 回复。语音文本默认不长期保存；保存范围、时间和区域由隐私评审决定。LLM不得直接持有绕过服务端权限的设备密钥。

## 运营工作台数据对象

Organization、RoleAssignment、Workstream、Milestone、Task、Dependency、GateDecision、Evidence、KpiDefinition、KpiObservation、Risk、ChangeRequest、Partner、ContractObligation、Store、Sku、ProcurementOrder、InventoryBatch、Customer、Quote、Order、Installation、Ticket、Rma、FinanceTransaction。

计划JSON提供结构种子，不包含实际人员、实际经营或私密客户资料。组织/用户/客户数据必须持久化并有访问控制。实际验收数据另存，不能写死为成功。

每个Milestone关联计划基线、修订版本、R、A、条件、验收、证据、独立复核与日期。每个KpiObservation关联指标版本、期间、分子、分母或实测值、样本量、单位及来源。

## 验证矩阵

|对象|验证|通过条件|
|---|---|---|
|任务与关口|缺证据、缺验收人、前置未解、复核不通过|任一缺项不得显示已验收|
|KPI|空白、零、零分母、小样本、目标缺失|缺失为未测，零保留，样本不足不判达标|
|日期|填写T0、不同月长、月末启动|截止日与EDATE规则一致，变更保留旧基线|
|账户与门店|两个用户或店员跨家庭/跨店读取写入|无授权不得读写，审计记录完整|
|设备|离线、超时、同键重试、解绑、假ack|不得伪造物理完成，不重复执行|
|语音|中英文、噪声、含糊、危险意图、撤权|明确确认/拒绝/失败恢复，可追溯|
|安装售后|报价至安装，故障至中国支持及RMA|同一订单/设备/工单连续追踪，本地有负责岗位|
|门店|许可、工程、五场景、培训与CRM|每店独立验收，无重大安全缺陷|
|融资|PO、放款、物流、验收、应收、回款|节点和银行账一致，逾期与费用不隐去|
|运维|备份恢复、发布回滚、供应商中断|实际恢复后数据一致，手工补录有审计|

## 交付文件标准

每个工作包建立 brief.md、deliverables/、acceptance.md、evidence/、open-questions.md 和change-log.md。若更合适可沿用仓库现有规范，确保信息完整。报告产物链接、真实验证、已知限制及需专业或外部决策的具体事项。

## 可复制的首轮指令

```text
读取本目录的NEXA WOC运营手册、execution-data.json、执行台账和Codex实施任务书。先核验当前代码与最新Q01至Q12答案，完成C01公司运营模板、C03系统PRD与十流程设计、C10运营工作台需求及数据结构。保持NEXA原视觉；岗位姓名留空；未知事项标待确认。每项产物必须有R、A、依赖、验收和证据。按具备条件的范围创建可审查文件，不把模拟能力宣称为真实上线。
```

## 可编辑组织架构衔接（v1.1）

读取最新导出的 nexa-org/version=1 JSON，并结合组织架构使用说明.md。nodes 的稳定 ID、parent、order 定义架构，code 与 title 是可编辑标签，type 区分岗位、部门和治理；name、backup、hours 为实际任命字段。初始数据仍留空，不推定真实雇佣关系。

先验证根节点、唯一代码、合法上级、无循环和工时范围，再依据最新架构同步 C01 的岗位任命、RACI、授权矩阵及 Excel 台账。涉及改名或删除时逐项核验里程碑责任岗位映射。保存原始 v1.0 基线及变更记录，明确批准人与生效日。当前页面为本地编辑器；多人共享和持久化权限后台仍在 C10 范围。