Archived
ChaiHaoandClaude Opus 5
85466e815f
给「任务活动开发 agent」沉淀的两份操作手册,基准是用户验收过的 A1(quote-intake@42, 三条形状不同的案例 released、被拒 0)。 活动开发规范.md 第三版,按四条轴重组: · 解耦机制 —— 活动与系统之间只有安装通道;三份声明=三个授权面; 边界纪律「别替下游产出」(随令牌流向下游的只有验收过的成果); · Harness 契约 —— 台账三写一撤与字段四标记(required/expect/tally/auto)、 基座读数全表与机检纪律(三次违反史逐条记账)、一路的门与闸 (起单宽进/提交闸两端/提交门/放行门哨兵/熔断)、拒回话术三分、五类卡、 phases/三色日志/一轮一句、放行落地; · Loop —— 局面组成、行动十四型全表、串纪律、人工激活与 start (「话说的范围要盖住门拦的范围」)、doneWhen 自动收步; · 活动怎么写 —— 清单六区(ledgers/editableAtRelease/判据措辞/内部一致性不上卡)、 建模十纪律(哨兵 ifPart、阶段全覆盖补进)、剧本 steps 六字段与 doneWhen 三坑、 guide 写作十条(一单一卡、卡骨架照抄、纯文本)、三常备案例与验收口径。 排障速查表并入这一轮全部新账(14 行新增)。 HTML报告生成规范.md 初版(用户点名单独成册,并强调报告与表单的关系): · 一份 HTML 三个身份:件(看)/表单(改)/归档件(存)—— 同一份,分开必分叉; · 报告与卡的关系立成硬规矩:逐行数据归件、整单级归卡;编辑在件、提交在卡; 同一个数管三处(件上红带/卡上闸/放行门 L1 同源);保存链路与三条实测教训; · 绑定语言全表、不算不判(按值上色/按条数分宽/按数开关)、编辑态四件套 (闸/孪生件/增删行/缺项红带)、PRD 平移法、浏览器走查清单、陷阱表。 CLAUDE.md 文档权威地图指向两份新版。五道门禁全绿(975 passed)。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JsTDjoHovERXyy6Wmw1ALp
471 lines
46 KiB
Markdown
471 lines
46 KiB
Markdown
# JCAI-WOS —— 企业级 AI Native 任务操作系统
|
|
|
|
> 一句话:组织的工作定义为可编排的工作流,工作流由**活动**编排而成;活动是完成一项任务的
|
|
> Agent 机制,系统外开发、安装即用。人只在责任点与放行点出现 —— 确定交系统,临场交 AI,落地交人。
|
|
|
|
## 现状快照(2026-08-02)
|
|
|
|
- **三面一体**:设计中心 `/design`(九区:蓝图/触发器/流程包/活动库/工具箱/数据域/知识库/
|
|
大模型/**测试台:三格 —— 流程(投一封信)/ 活动(按契约填入参)/ 日志(历次试跑存档)**)· 运营中心 `/ops`(六区:驾驶舱/工作流/任务/员工/台账/系统)· 工作台 `/`。
|
|
`/gov` 302 → `/ops`。
|
|
- **编排层与流程引擎已跑通并测死**:起单宽进(门口不拒缺项)、数据按字段名流动(无强制
|
|
类型)、边只表达顺序与条件(对齐 Mastra)、闭合校验只查结构闭合 + 活动装载、一条流恰一个
|
|
生效版本、在途按启动版本跑完、版本号与名归设计人员自己定。
|
|
- **活动一律案例模型**(2026-07-29 范式退役):flow-engine 已删,业务模型只有
|
|
CMMN + 说明书 + DMN 一形;`defineActivity` 已去 `paradigm`,`run` 改为可选 ——
|
|
行为全在清单里。`turn-runner` 每拍要 `agent.decide` —— **环境无模型密钥时
|
|
案例活动一步走不动**,三套端到端(unified-quote-flow / new-package-flow / testbed-trace)
|
|
整套跳过,恢复条件写在各文件头。
|
|
- **A1 客户RFQ受理已是真活动包**(2026-07-30):`activities/quote-intake@2.0.0` 经**安装通道
|
|
读文件**装入(`seed-activities.ts` 读 `dist/{manifest.json,index.js}`,不经 import ——
|
|
与 activities 之间只有安装通道)。五对象台账(record / type_table / verdict / alt_request /
|
|
rfq_request)、两张判定表(F-01 完整度 · P-03 三分类)、三条技能、四张 HTML 报告模版;
|
|
**案例模型照 SOP 图一步一项**(S1…S6 + 放行,7 项,扁平无阶段)—— v2.0.0 重写:
|
|
上一版 12 项(擅自加阶段/里程碑/裁量项)让 Agent 全程跟 harness 较劲,实测无限死循环;
|
|
流程包 A1 节点已指向它。其余**五**槽位照旧占位。
|
|
- **模型实例**:只留 `deepseek-v4-flash` / `deepseek-v4-pro` 两条;种子读不到
|
|
`JCAI_DEEPSEEK_API_KEY` 就**不绑密钥**(卡上如实显示不可用),去治理台大模型区补。
|
|
- **A1 已真跑通**(2026-07-30):起单 → Loop 逐拍 → 写台账草稿 → 提交放行 → 人签 →
|
|
releaseWrite 合并进正式版 → 发射 intake 口 → `released`。三分类与双去向旗业务正确
|
|
(A 直通 / B 寻源 / C 选型)。为跑通它补了 Loop 的七个洞:`write` 行动 · `finish` 宣告完成 ·
|
|
进行中的项进局面 · 工具清单进单拍提示词 · 里程碑自达成 · 在途验收不被兜底 save 擦掉 ·
|
|
必交付物只数本单草稿。**A1 的槽位 `rfq-intake` 已退役卸载**(库里两个同名活动会骗人)。
|
|
- **A1 两条路径都跑通并零卡壳**(2026-07-30):常路五步与最长路径(含 S2 补全卡来回)
|
|
各跑一遍 `released`,**行动被拒 0 次**。补全卡走对话卡族(`ask` 行动);
|
|
连续 5 拍被拒即熔断交人(`stalledTurns`)。
|
|
- **一拍一串行动**(2026-07-30,`AgentTurn.actions`,封顶 6):从前一拍只许一个行动,
|
|
每个 write/finish/start 都单烧一遍完整上下文 —— A1 六步恰花 21 拍(19 拍是该约束下的
|
|
最短路径)。收成串后 **7 拍 released、56k token**(自 21 拍 173k);纪律引擎强制:
|
|
被拒停在谁那儿(前缀生效)、tool 后截断、挂起型收拍。浏览器 UI 点「确认通过」→
|
|
released 全链亦验证过。
|
|
- **写的授权面是台账声明,不是计划项**(2026-07-30 修死锁):`write` 的 itemId 降为记账,
|
|
挂不上(项已完成/人工激活未 start/阶段/不存在)照写不拦、留痕注明。此前绑死在项生命周期上,
|
|
实测死锁:S5 收完才发现打标没写全,能挂的项全 Completed,每拍补写被「要先 start T_release」
|
|
拒回,连拒五拍熔断 —— 而数据本身合规。台账声明与空转检查仍是硬门。
|
|
同批修:`finish` 对非人工激活的项就地过 Active 再收(白按一下省一拍);
|
|
事件到达痕**只记 task 层一条**(此前 task 与 loop 各记一条,同一次回传日志三行像结巴)。
|
|
最长路径(含补全卡人环)复测:**8 拍 released、64k token、行动被拒 0 次**。
|
|
- **每拍时延 20-56s → 1.5-4.9s**(2026-07-30):trace 拆出 tokIn/tokOut/reasonChars 实证 ——
|
|
慢全在**隐藏推理解码**(最慢拍可见 1538 字、推理 9808 字)。`ModelCall.reasoning: 'off'`
|
|
经 provider-profile 的 `reasoningControl` 译成 DeepSeek `thinking:{type:'disabled'}`
|
|
(探针核过;`low` 在该厂无效)。配套:write patch 只带有值列、scope 摊平字段前置整表殿后
|
|
(rest 3000→1800)、轨迹剔除装配技能戳、旧出参截 120 字、技能戳版本不变不重写、温度 0.2。
|
|
off 档一次误判(缺目标价当关键字段)以**说明书写死规则**治(「关键字段只有 PN/EAU/交期」),
|
|
不给思考额度 —— 判断归判定表与说明书,模型只做编排。复测:7 拍 49k token released、零被拒。
|
|
- **工作台交互按 PRD 补全**(2026-07-30):①对话区点卡 → 视图区 locate 跳转(待办跳页位、
|
|
办结跳成果详情);②工作成果页签真实现(一行一份 → 定稿报告[印章+verdict+嵌 HTML 汇报] →
|
|
返回列表);③执行工单挂作业指导书卡组二;④工单办结回执以人事件进对话流,引擎内部观察
|
|
(internal 标)与裸「事件到达(human)」不再污染对话区;⑤空待处理四态分明(推进中动画 /
|
|
等外部回音 / 都办完了 / 已收尾)。
|
|
- **AI 工作中动画**(2026-07-30):对话区**办事条**(均衡条,语义「在办事」不是「在打字」;
|
|
三点气泡仍留给回话中)+ 头像呼吸环;空工作区**推进场景**(涟漪 + 微光工作线)。
|
|
纯 CSS、只动 transform/opacity、prefers-reduced-motion 全静止;
|
|
状态源自任务投影 `runtime === 'running'`,等人/等外部/已收尾不亮 —— 界面不撒谎。
|
|
- **活动开发规范已重写为开发手册**(2026-07-30 第二版):销账史砍掉(在 git),
|
|
精华收进建模八纪律与排障速查表;余账在 §15(④受理分支误吞验收裁决 ·
|
|
⑤治理台白名单授权口 · ⑦dist 真编译 · ⑧单拍工具缝 · ⑨⑩死代码 · ⑪评价卡暂不做)。
|
|
语义源两卷(操作系统/活动模型)已归档 `docs/archive/`。
|
|
- **实时同步补齐五处**(2026-07-30 第二轮,测试台为引子):①订阅层不失效
|
|
`['gov','testbed',*]` —— 测试台全靠 2s 轮询而轮询到终态即停,一单跑完那屏就此定格;
|
|
②`testCurrentRoute` 把已终结的试跑单当成「在跑」,旋钮永久锁死(现返回 `live` 分开
|
|
「摆出来」与「占着仪器」);③试跑起单/销毁不广播 —— 销毁掉的真任务还挂在别人工作台上;
|
|
④**`kind:'system'` 声明了却全仓从未发布** —— 治理台所有配置面(活动/工具/模型/流程包/
|
|
数据域/驾驶舱)永不实时刷新;现由 `/api/gov/*` 写路由中间件统一发(一处拦住,新路由自动生效),
|
|
任务走到终态也补发一次(台账与指标不以任务为轴);⑤本地 id 活过服务端事实 ——
|
|
别处销毁后面板还钉着旧号,显示「取数失败」的鬼卡片(渲染期对齐,服务端说没了就松手)。
|
|
订阅映射已抽成纯函数 `invalidateFor` 并按「哪一屏靠什么刷新」逐屏断言(8 条)。
|
|
- **MVP 工作流第一轮跨节点跑通 A1→A2**(2026-07-31),并挖出**七个编排缺陷**(全已修):
|
|
①六节点绑的是退役槽位 id ②流程包入参还是 `customerCode`+`rfqRef`
|
|
③**触发器装配映射是空的** —— 事件触发的 scope **不打底**(只有 registration 才铺 scope),
|
|
「同名会自动带过去」是错觉,`subject`/`body` 同名照样缺
|
|
④E5 读 `needSourcing` 而 A2 出口不发 ⑤E10/E11/E12 读 `outcome` 而 A6 三口载荷是空对象
|
|
⑥A2 要 `originalPn` 而 A1 发的是 `altRequests`(上游发一批、下游要一个)
|
|
⑦**自动收步与行动串并行** —— 引擎在拍首收了 T_select,而模型这一拍原本就打算 write 完再 finish,
|
|
`Completed → Active` 当场抛非法迁移,连拒五拍熔断;现与 `start` 同款:收过了就当已完成。
|
|
④⑤⑥ 同一类:**边读什么 / 下游要什么,上游就得发什么** —— 光测单活动测不出来,只有真跑跨节点才现形。
|
|
- **六个活动全部转正为真活动包**(2026-07-31):`REAL_PACKAGES` 六件齐,经安装通道读
|
|
`dist/` 装入 —— 治理台里不再有 `viewTemplates: []` 的占位槽。六份案例模型统一到 A1 的
|
|
状态机模式(剧本 `steps`:intent / guide / writes / tools / doneWhen):
|
|
**A2/A3 各只有「派一张执行单 + 放行」两项**(专家判断,建细了只是跟 harness 较劲);
|
|
**A4 定价**三项(算价归判定表 · **超限才叫人**的决策卡 · 放行);
|
|
**A6 议价**三项(落单 · **发出去人工激活 + 立监听等回音** · 放行);
|
|
**A7 归档**两项(一步落三张表 —— 它们互不依赖,分开只多两次 finish)。
|
|
凡触达世界的项一律不给 `doneWhen`(给了等于给引擎一把替人签字的钥匙)。
|
|
- **A2/A3 的简化口径**(同日):案例模型从九个 humanTask 砍成**两项** ——
|
|
`T_select`/`T_source`(派**一张执行单**,卡面两张可编辑表)+ `T_release`(人工激活)。
|
|
上一版把「FAE/采购脑子里怎么想」当成了「系统要管几步」;而那一整段在业务上是**一件事**。
|
|
剧本与 A1 同一套(`doneWhen` 真了引擎自己收步)。`REAL_PACKAGES` 已含这两个,
|
|
不再是治理台里 `viewTemplates: []` 的占位槽。
|
|
- **判据三态 + 表格默认锁着**(2026-08-01,`quote-intake@20.0.0`,用户两问):
|
|
①「这条未达标为啥还在」—— `acceptanceCriterionCheckSchema` 只有 `{label,level,pass}`,
|
|
**裁断与理由传不到卡面**,于是「裁了但裁成不满足」与「压根没裁」都是一个红叉。
|
|
补 `settled` + `rationale`,卡面变三态:达标(绿)/ **AI 判为不满足 · 交你定**
|
|
(琥珀 + 左侧色条 + 理由)/ 未达标(红)。更早的注释写着「理由随卡交给人」——
|
|
**那句话描述的行为从来没实现过**,因为契约里没有那两个字段。
|
|
②**表格默认锁着**:每张可改的表各带一道闸(`[data-edit-for]`),锁着只出「编辑」,
|
|
开了换「取消 / 保存」;取消还原成按下那一刻的值,保存才交给外层缓冲。
|
|
**看与改是两件事** —— 从前一进屏 54 个输入框一起亮着。
|
|
途中踩了跨 realm 陷阱:`event.target instanceof Element` 在 iframe 元素上**恒为 false**
|
|
(`Element` 是父文档的构造器),症状是点「编辑」毫无反应而 class/CSS/选择器逐个查都对。
|
|
**认能力不认血统**;监听挂载也改成幂等的(srcdoc 换文档时机抓不准,每次有机会就挂一遍)。
|
|
验收:6/6 released;浏览器里走完「编辑→改→取消还原→再改→保存→提交」,落草稿层。
|
|
- **A1 连跑 10/10 全 released、行动被拒 0 次**(2026-08-01,`quote-intake@19.0.0`,
|
|
10-11 拍 / 99-112k token)。基线是 5 轮熔断 1(其中一轮 13 次拒回、23 拍、234k token)——
|
|
五处 harness 改动逐轮逼出来的(见下两条与 `docs/debt.md`)。
|
|
- **最后一条自报的机检判据也交给基座数**(2026-08-01):台账字段声明加 `required`(可选,
|
|
不建 NOT NULL —— 草稿层的本分就是过程中允许缺),基座据此出 `域_对象_missing` 与
|
|
`_missing_keys`(缺在哪几行、缺哪一列)。A1 的「必填齐(PN/年用量)」原读活动自写的
|
|
`missing_key_total` —— 人在卡上补了年用量、基座已写回草稿层,而那个数要模型自己重算,
|
|
**漏算一次这道门就再也开不了**:十轮里三轮死在这。这是「机检只许读基座数得出来的数」
|
|
这条纪律第二次被违反,第一次是 missing_minor_total 被改小那次。
|
|
- **Harness 三条死胡同已通**(2026-08-01,连跑 A1 摸底逼出来的:5 轮熔断 1、再 6 轮熔断 2)。
|
|
三条全是同一个病 —— **判据正确地拦住一件办错的事,而模型没有一个动作能把它办对**:
|
|
①**写错一行没有退路** → 加 `drop` 行动(`ledger.draftDrop` → `DraftStore.drop`):
|
|
只撤本单草稿层那一笔,正式版一个字都动不了、不抛事件,**不是第四种写**。
|
|
起因:客户明说本轮跳过的那颗料被写进有效清单,数全对(9 有效/1 跳过)而表里 10 行,
|
|
`record_rows = line_total` 拦住 —— 模型唯一能改的是那个数(改了 skipped_total 又不对),
|
|
13 次拒回、23 拍、234k token;
|
|
②**拒回只给数字** → 读数连**主键名单**一起摆(`域_对象_keys`,封顶 12 行):
|
|
两份名单一比,多的那个 PN 就在里面对着,一句话能办的事;
|
|
③**拒回把模型指上死路** —— 「要先 start,当下是 Completed」,而 start 一个 Completed
|
|
项同样被拒,两堵墙对着撞;现按状态分开说,且 start 已收的项改为无事发生。
|
|
**拒回的话是模型下一拍的行动指南,指错方向比不给指引更糟** —— 同一条也改了提交门的
|
|
结尾建议:先分清差的是**数**还是**行**,行不对就 drop,别去改数。
|
|
顺带:**收步判据与验收判据同源**(S2/S5/S6 都改读基座的 `_rows`)——
|
|
松出来的那一截就是返工;S2 那条把「多写一行」的发现点从第 10 拍提前到**第 2 拍**。
|
|
还删了孤儿模版 `intake-gaps`(7 处 `view:` 无一指向它)。
|
|
- **对话区一轮一句(不是一拍一句)**(2026-08-01,用户:「太密集了」):形状是
|
|
**设定目标 →(分析现状 → 规划 → 执行)× N 轮 → 一个气泡**,气泡可以是仅结论,
|
|
也可以是**结论 + 功能卡两部分**。三处:①`turn-runner` 的 `handsOff` ——
|
|
只有交出控制权那一拍(ask/human/decide/listen/submit)的交代进对话区,
|
|
别的拍留进工作日志(`internal`);②提示词与 say 字段说明明写这条规矩,
|
|
否则模型照旧每拍写播报、只是被默默丢掉(白烧 token 还写不好总结);
|
|
③`chat-projection` 把交代与卡**并成一个气泡**,并把收尾三条引擎回声
|
|
(裁决 / 发口 / 终态)收成一条。并卡的判断按**来路**认(只有 terminal 不认领卡)——
|
|
一度写成 `tag !== 'conclusion'`,而交代本身常是结论口吻,于是第一轮并对、第二轮没并。
|
|
账:同一条 11 拍的 A1,对话区 **9 条 → 5 条**;压下的 8 条交代一条不少留在工作日志。
|
|
- **放行卡不摆 L5、去向不再有 L4 裁量**(2026-08-01,用户当场指出):
|
|
L5「BD 放行」是**责任关**,而那张卡本身就是这道关 —— 列进判据表等于摆一条恒为
|
|
「未达标」的项,「n/m 达标」永远差一条;声明留着、呈现去掉(滤在基座组卡处,六活动通用)。
|
|
L4「去向判断合乎业务常理」删掉 —— 去向已由出口谓词算出,再让模型裁一次是**给自己
|
|
没做的决定盖章**:裁「满足」是废话,裁「不满足」也改不动什么(能改的是三类条数,
|
|
那已由 route-alt / route-rfq 两条机检看着)。**判据得能指向一个可做的动作。**
|
|
- **三个区各归各位:件归工作区,判据与指导书归对话区**(2026-08-01,`quote-intake@14.0.0`,
|
|
用户指出「你用你自己的报告格式嵌套了一层我要的报告格式」):工单报告组件自带一整套外壳
|
|
(题头/编号带/依据带/判据表/章节头),又把活动推的那一屏包在里面 —— 两套版面语言叠着。
|
|
现在 **待处理与工作成果只放那份 HTML 模版**;作业指导书 · 依据 · 判据 · 填报表单 ·
|
|
**提交与裁决**全在对话区的卡上。**待处理是可编辑态**:可改的格子在模版里挂 `data-col`、
|
|
行容器挂 `data-edit="域.对象"`,渲染时每格多渲一个 `<input class="jc-cell">` 孪生件,
|
|
只读那份与输入那份**由样式表按根节点的 `editing` 二选一** —— 同一份 HTML 两处用,不存两份。
|
|
收值在外层(`allow-same-origin` 读得到 DOM),**iframe 里仍然一行脚本都没有**;
|
|
收上来按台账地址对上工单 `blocks[i]` 的 `ledger`/`fields`,仍走老的 `table:N` 回传。
|
|
同批修两个只在真人点的那条路上现形的洞:①**监听挂在 about:blank 上** ——
|
|
`srcDoc` 异步换文档,渲染那刻挂的监听随旧文档作废,人改了两格提交时载荷一个字都没有;
|
|
②**算出来的去向没交回去** —— `routedPort` 那一路 `selectedPorts` 恒空,按「确认通过」
|
|
当场判「选择组未选出口」,台账都合并进正式表了单子却死在最后一步(`blocked`)。
|
|
验收:浏览器里走完两道人环 —— 件上改两格 → 提交 → 落草稿层 → 放行 → **released**,
|
|
九行数据(含人补的 eau/brand)落进正式表;工作成果那一屏零输入框、零外壳。
|
|
- **阶段2 补回成一项:受理需求交人审定**(2026-08-01,`quote-intake@13.0.0`,用户指出
|
|
「我都没确认需求 它就让我验收了」):「经过人」从前不是一项,而是归一那步收步条件里的半句
|
|
`missing_minor_total = 0 or answered_total > 0` —— **只在缺东西的时候才叫人**。
|
|
一封字段齐全的询价进来,这半句在拆完那一刻就为真,引擎自己把那步收了,
|
|
人一眼没看过受理需求,下一次被叫到已是终局验收。现在 `S3_confirm` 是独立一项:
|
|
**人工激活 + 不给 doneWhen**(与放行同款),`view: intake-overview`,一单必发一张;
|
|
S4 的入场前提改读 `confirmed_total`(只有人回卡才产生的数)。
|
|
规范 §7.1 立纪律 3.5:**判据是「这件事办完了没有」,不是「要不要办」**。
|
|
连带修掉一个零条死锁:**没写过 ≠ 写了 0 行** —— 全 A 类那条路上替代请求表一行没写,
|
|
`quote_intake_alt_request_rows` 整个键不存在,而判据 `= type_c_total`(0=0)本该成立,
|
|
未绑定的名字比较为假 → 永远过不去、连撞五拍熔断;现按 `declarations.ledger` 先铺 0。
|
|
验收:常路 **11 拍 released、被拒 0**;全齐无 C 类那条 **10 拍 released**、去向 `to-sourcing`。
|
|
- **A1 两份报告改为从 PRD 目标件整份搬过来**(2026-08-01,`quote-intake@12.0.0`):
|
|
`views/prd-style.ts` 是机械抽取的整段样式表 + 图标精灵(`PRD_CSS`/`PRD_SPRITE`,数值未改),
|
|
`views/report.ts` 逐块搬标记、只把写死的数据换成绑定 —— **不再用 `@sdk` 拼装件复述**
|
|
(那套外壳有自己的版面语言,「照着做」出来的是第二种版面;前三轮报「25 块到位」都是
|
|
结构断言,对版面零约束)。规范 §10.3.1 立此法:**视觉目标件只能看,不能用 DOM 断言验收**。
|
|
连带三件:①**`data-class-of` 不再以 `data-slot` 为前提** —— 纯色块(格里不写字、只按值上色)
|
|
从前整条静默失色,屏上一排灰格子看着像「还没算出来」(补 4 条用例);
|
|
②**去向进视图**:`case:routeKey/routePort/routeTo/routeWhy` 由基座按出口谓词求值后注入,
|
|
与放行发口是同一次判定,报告只摆不算(分布条按条数分宽也走同一招:条数投影成 class + 宽度梯子);
|
|
③`contact_name` 落进 `verdict` —— 老客户不重写主数据,联系人卡从前会显示公司名。
|
|
端到端复跑:**10 拍 released、96k token、行动被拒 0 次**,去向 `to-alternative(type_c_total > 0)`。
|
|
- **A1 五轮端到端全部 released**(2026-07-31):行动被拒 **0** 次,判据 7/8(只剩 L5 人放行)。
|
|
跑测逼出并修掉两个「人答了什么 Agent 看不见」:①可编辑表的修改只活在组件局部 state,
|
|
回传载荷一个格子都没有(加 `onTableChange` 链,键 `table:N`、首行列名);
|
|
②决策卡选了哪个不进轨迹(`payloadOf` 只认 values/output/error,补 `detail.value`)。
|
|
两者都会让 Agent 重发同一张卡 —— 人以为自己白填/白点了一次。
|
|
- **工作台空占位统一**(2026-07-31):任务那一栏的空态从裸 `execution-panel` 改挂
|
|
`jc-panel-card`(其余四模块一直有,只它是画布上飘着的一段文字);
|
|
`.jc-empty` 由固定内边距改 `margin:auto` + `justify-content:center`,在栏内真居中。
|
|
- **活动状态机:每步一条剧本,成果已在就自己收**(2026-07-31,治 A1 空转)。
|
|
`LoopModel.steps` 一个计划项一条:`intent` / `guide` / `writes` / `tools` / `doneWhen`。
|
|
引擎每拍开头先对任务视图求 `doneWhen`,**真了就自己 finish 那一项,不问模型**
|
|
(人工激活的项不自动收 —— T_release 触达世界,不给它 doneWhen);
|
|
上下文按状态组织:只摊开当前这一步的做法与它该用的东西,其余步骤各留一行。
|
|
起因是实测死循环:S1 一次写齐八字段后 S3「补齐八字段」已无活可干,而每拍喂整本说明书,
|
|
模型只能把同样三行再写一遍 → 「写了等于没写」被拒 → 下一拍再来一遍,连拒到熔断。
|
|
**`doneWhen` 的坑**:S-FEEL 里未绑定的名字 `!= null` 求值为 **true**,写它等于那一步开局即收;
|
|
布尔列也不能当判据(分不清「没写」与「写了 false」)—— 一律取同步写下的计数列(测里拦下过)。
|
|
实测三连:**A1 三次端到端全部 `released`,行动被拒 0 次,S3 每次自动收步**;
|
|
8 拍 / 58k token(状态机之前是 11 拍 / 82-90k)。
|
|
- **决策卡 Agent 侧接通**(2026-07-31):新增 `decide` 行动(contract / port / turn-runner /
|
|
engines / 提示词 / 解析)。此前决策卡**只有 UI 没有 Agent 侧**,岔路口只能写成补全卡 ——
|
|
人拿到一张要敲字的表单而不是两个可点的选项。少于两个选项拒发。
|
|
- **真实文件进得了活动**(2026-07-31):`sys.upload`(迁移 0024)存原字节 + 读出来的文本;
|
|
`POST /api/gov/upload`(base64,8MB 封顶)/ `GET /api/gov/upload/:id`;
|
|
xlsx **不引依赖**自己读(ZIP 中央目录 + `inflateRawSync` + XML,13 条测试);
|
|
契约字段标 `format:'file'` → 测试台出文件选择器。读不出文本的类型如实说读不出。
|
|
- **沟通记录接通**(2026-07-31):`sys.task_comm`(迁移 0025);活动清单声明
|
|
`contract.input.inboundComm`(哪几个入参字段合起来是那封来件),基座**起单那一刻**归档 ——
|
|
人一点开这单,沟通记录里就已经躺着那封信,不必等模型跑几拍。附件那一行照抄基座的读取说明。
|
|
- **测试台改三格 + 试跑日志**(2026-07-30):两档旋钮长在内容里(别处跳不进来、刷新记不住
|
|
试的是哪一台,第三样东西也塞不进二档),提到页签 —— **流程 / 活动 / 日志**;单在另一台上
|
|
不抢页签,只挂一句「它在那边」。日志是**拔之前先存一份**:停止仿真照旧连根拔掉,拔前
|
|
`archiveRun` 存一条(逐拍轨迹 + 台账草稿 + 发出去的人卡 + 读数),**一次试跑一条**
|
|
(流程包把名下节点任务合成一条,痕带节点名前缀、按时刻排);可单删可清空,`reset-runs` 一并清。
|
|
库表 `sys.testbed_run`(迁移 0023),路由四条挂 `/api/gov/testbed/logs`(写路由中间件自动广播)。
|
|
顺手修:单活动那一台的负责人下拉掉进 `.tb-asn-r` 的 40px 那一格(它比流程那台少一列),
|
|
现给 `.solo` 四列版 + 插座列加宽到 184–238px。
|
|
- **台账列归型前移到写入那一刻**(2026-07-30):模型用 `""` 表示「原文没给」,草稿层照收,
|
|
到 `releaseWrite` 才被 PG 掀桌(`invalid input syntax for type double precision: ""`)——
|
|
**而那是人签完字之后**,整单落 `blocked`。现在 `draftWrite` 按声明列型归:空值=不写这一列、
|
|
数值/布尔字符串转真类型、归不了当场拒(理由喂回下一拍)。台账字典也带上列型给 Agent 看。
|
|
- **前端实时刷新已通**(2026-07-30):前端那一侧一直是好的(单条 SSE + 按前缀失效缓存),
|
|
三处**后端没广播**:①`task-advancer` 只在 runtime/terminal **换名字**时广播,而案例活动
|
|
连跑十几拍全程 `running`(改为 `progressed` 即广播);②`interaction` 的推送一个订阅者都没有
|
|
(加 `onPush` 系统级转接);③发消息不经事件投递,收件人的消息气泡不动(outbox 处补广播)。
|
|
- **四类人类工具:前三类已通**(2026-07-30):执行(工单 · 报告页填报提交)、
|
|
**补全**(对话卡 · `ask` 行动,两条路必走其一)、验收(工单 · 判据表 + AI 已填好可编辑 +
|
|
裁决在对话区)。决策卡(第四类)UI 已在、Agent 侧未接。
|
|
验收修订链原来断在五处「声明了没接线」——契约 `revisableAtRelease` 定死哪几个值可改、
|
|
改完落哪儿;拟值放行前从台账现读,不让模型重述。
|
|
- **A1 的两份执行页照 PRD 目标件重做并跑实**(2026-07-31,`quote-intake@9.5.0`):
|
|
`~/coding/JCAI_PRD/docs/活动执行页/` 的两份 HTML 是「办完该长什么样」的答案 ——
|
|
**询价受理需求**(来件原文 → 受理要素四卡 → 指标带 → PN 清单 → 本轮不报)与
|
|
**统一受理记录**(要素 → 逐条记录带标 → 分级依据 → 分流去向 → 两类请求 → 结论 →
|
|
这一签下去会发生什么)。`@sdk` 补 `letter` / `factCards` / `actionList` 与列样式
|
|
`req`/`opt`/`num`/`pill`;`data-blank` 让空值真的留空,必填/选填胶囊与缺项标底
|
|
由模版自己的 CSS 出 —— **模版仍不许算**(分布条宽度、命中高亮这类算出来的画面一律不做假)。
|
|
顺手删掉 `@sdk` 里五个零调用方的拼装件(kvCard/tableCard/noteCard/stagesCard/critList)。
|
|
- **A1 六轮端到端,末轮九行数据全对**(2026-07-31):每轮 `released`、**行动被拒 0 次**,
|
|
9-10 拍 / 76-89k token。逐轮逼出并修掉五个洞:
|
|
①**机检判据两边都由活动自报** —— 条数报 9 而表里 10 行、三类条数报 7A/2B 而判定器给
|
|
5A/3B,派单数同源同错于是「2 = 2」顺利过关;现加基座读数 `域_对象_rows`(本单写下几行),
|
|
判据必有一边不是自报,`classify` 出参也带 `counts` 供照抄;
|
|
②**问过 ≠ 答过** —— 收步判据写 `asked_total`(卡一发就为真),人填完提交这一步当场被收,
|
|
答案没轮到写回台账;改等 `answered_total`;
|
|
③**归档件被冲掉** —— 收口后引擎再跑一拍,推固定的 `case-overview` 退到「声明的第一张」,
|
|
把人刚签过的放行页冲成阶段二的执行件;现按剧本 `view` 推、活步收完不推;
|
|
④**说明书与剧本各写一份六步**,分叉出三个案例模型里不存在的计划项名(S1_register 等),
|
|
模型照它报 itemId 一报一个被拒;说明书现在只讲整单的事,逐步做法归剧本(有测试钉死);
|
|
⑤三类数据失真(PN 抄漏后缀→同一料两行、数值缺失写成 0、制表符 BOM 拆错列)——
|
|
逐条在说明书里写死实测账。
|
|
- **Harness 可靠性:三处「门本身教模型撒谎」已修**(2026-08-01,两条样例路径连跑逼出来的):
|
|
①**机检判据读活动自报的数** —— 一颗料只缺目标价,模型如实记 1、被连拒四次,
|
|
第五拍把那个数**改回 0** 就绿了(台账从此写着「缺选填 0 条」);
|
|
**机检只许读基座数得出来的数**,数不出来的别假装机器判得了 —— 该条已降 L4 交人;
|
|
②**裁量判据也被要求「为真」** —— 它如实裁「未满足」并写了理由,提交照样被拒,
|
|
判-提-拒十二轮 21 拍 187k token,最后把裁断翻成「满足」才过去;
|
|
提交门已改:机检必须为真、**裁量裁过即可**,裁断连理由随卡交给签字的人;
|
|
③**熔断数不出「同一堵墙」** —— 拒回标题带着串位(「第 2 个」),整条一比成了 N 堵墙,
|
|
叙事窗 20 条也装不下几次撞墙;一单被同一条判据拒回 **33 次**、40 万 token 烧到
|
|
`exhausted`。已修:削掉串位前缀比对 + 熔断另开 60 条窗。
|
|
顺带:计划项号认唯一前缀简写(`S4` → `S4_history`)。
|
|
**验收**:Itelma 与新客户两条路径各三轮全部 `released` ——
|
|
10 拍 / 88-90k / 被拒 0 与 9-11 拍 / 71-88k / 被拒 0-1,数据逐轮对得上。
|
|
- **执行页补到「能做的极限」**(2026-08-01):新增 `data-class-of`(把值消毒成 class 后缀,
|
|
仍只是取值,判断留在样式表)—— 于是类标 A/B/C 三色、两枚旗的是/否、**一条料一格的刻度条**
|
|
都真做得出来;要素卡补方/圆标(方=组织、圆=人,里面放图标不放算出来的首字母)与大号计数;
|
|
G2 那段改成**三条规则连着本单计数**的规则表 —— 命中由编排层求值,这份件不画对勾替它宣布。
|
|
仍不做的只剩两类:按条数分宽的分布条(宽度得算)、编辑态(沙箱无脚本,改数走执行卡)。
|
|
- **试跑日志吞主键已修**(2026-08-01):存档那一屏只渲染 `patch`,`key` 整个不显示 ——
|
|
三行受理记录屏上只剩「eau / lead_time」,看的人据此判「PN 没提取到」,而 PN 一条不少。
|
|
两处观测面已合并到 `gov-testbed/internal/drafts.tsx` 一份实现。
|
|
- **就地改的三处不老实已修**(2026-08-02,同一单实测逼出来的):
|
|
①**保存按地址走,不看当下那张卡** —— 载荷从前是 `{workOrderId, values:{'table:0':…}}`,
|
|
列名由那张工单的 `blocks[0]` 给出,于是「这份件能不能改」被绑在了「此刻开着的那张卡
|
|
长什么样」上。一单在放行门连拒五拍熔断,引擎发的是**没有 blocks 的熔断卡**,而屏上摆着的
|
|
正是受理记录那份件 —— 闸在、编辑进得去、保存按得下,前端找不到匹配的块,**一格都没往下送**;
|
|
人要补的恰恰是把这一单卡在那儿的那个必填格。现在收件自己说的话(`data-edit` 地址 +
|
|
`data-col` 列名),授权面改由**活动清单的台账声明**把关。
|
|
②**必填还空着就按不下提交**(`ExecutionWorkOrder.gate`,基座按声明现算,
|
|
与放行门 L1 `域_对象_missing = 0` **同一个数同一套算法**);闸上摆出差在哪一行哪一格,
|
|
人在件上补齐、保存,闸自己开。算不出来(卡上没绑表)就不给闸 —— 没有依据的时候不拦人。
|
|
③**只写真改了的那几行**:件上按一次保存整张表都回传,照单全写会留「就地修订成果:4 行」
|
|
的痕而人只改了一格。
|
|
端到端:12/12 判据、`released`、被拒 0(另一轮 3 次、亦 released)。
|
|
- **日志只有三色**(2026-08-02 用户定):负责人绿 · 智能体蓝 · 系统灰(`LogLine.who`)。
|
|
从前按归侧上五色 —— 那是**度量**的分法(自主率要把「等外面」与「机器干的」分开),
|
|
对读日志的人不构成区别。连带两件:放行那一刻四条痕说的是同一件事(合并 / 发口 / 流转 / 终态),
|
|
日志只留说得出实情的那一条(带「几行没进正式表」);台账写入认 `by` 定主语 ——
|
|
放行合并归系统,人工修订归人。
|
|
- **件上的表能增删行**(2026-08-02 用户:「编辑列表应该还能增删行」):手改本来就是
|
|
**兜 AI 的错**那一手,而错不止「这一格填错了」——「这一行根本不该在」(客户点名跳过的料
|
|
被写进了有效清单)与「漏了一行」是同一类错,只给改格子就没有出口。
|
|
序号那一格编辑态换成 ×(一列两用),表尾一条「加一行」;删是**挂记号不当场抹掉**
|
|
(看得见、可后悔),「取消」把加的撤掉、把记号摘掉、把值放回去,三样一起才叫还原。
|
|
**删要说出来**(载荷 `drops`),不靠「没回传就是删了」—— 那种口径会把一次不完整的回传
|
|
变成一次删表。撤的只是本单草稿层那一笔(`draftDrop`),正式版一个字不动。
|
|
痕里点名撤了哪几行并写「别再写回去、条目数跟着改对」—— 那条痕是**下一拍模型的行动指南**,
|
|
不说清它会照「条目数 9 而表里 8 行」判成少写了一行,把人刚删的写回去。
|
|
实测:删一行 + 加一行 + 补必填 → **released、11 拍、被拒 0**。
|
|
- **裁量判据带谓词时谓词说了算**(2026-08-02 用户:「这个价格是我填写的,但是它判错了」):
|
|
「选填缺口:已补齐,或由你放行时确认可以先受理」是复合命题 —— 前半句基座数得出来
|
|
(`域_对象_gaps`),后半句才需要人。从前整条只读裁断,于是模型凭记忆写理由,
|
|
人填好的目标价它照样判「客户未提供」(复现的那单更离谱:两行年用量都填着,
|
|
它写「共 4 处选填缺口」,而 EAU 压根是必填)。现在谓词为真即达标、**那句相反的话一并丢掉**;
|
|
谓词为假才轮到裁量。同批:验收卡的判据改为**读时现算**(`container.checks.of`,
|
|
与提交门同一段 `criterionCheck`)—— 人在成果件上补一格,判据跟着变;
|
|
`remark` 不再算选填缺口(它是我方写的注,不是客户该给而没给的)。
|
|
- **作业指导书与验收判据同一套版面**(2026-08-02 用户定):从前指导书是一串松散的圆点、
|
|
判据是一摞带章的行,同一张卡上两套版面语言。差别只留一处:**指导书不画对勾** ——
|
|
它是要办的事,系统并不知道人做没做。执行卡那一钮也改称「查看工单」。
|
|
连带挖出:**引擎压根不往下传 `steps` / `standard`** —— 活动照骨架写了,发卡时一个字
|
|
都没到卡面,人拿到的只有一句「请核对确认」。空着不是简洁,是把交代省掉了。
|
|
- **建客户要公司与联系人都经人确认**(2026-08-02 用户定):录入卡加 `also` 段 ——
|
|
一张卡两段(公司档 + 联系人档),确认一次落两行,值按 `段号.列名` 隔开
|
|
(两张表都有 `name`,平铺会互相盖掉而没人看得出来)。从前联系人由 AI 自己写,
|
|
而 `contact_code` 恰是它编出来的那一个。
|
|
- **该问人的问人,人答不上来的别摆到他面前**(2026-08-02 用户两条):
|
|
①卡面摆的是台账登记的**表人读名**(「客户档案」),不是 `customer.profile`;
|
|
主键行只摆表单里没有的那几格、用中文列名 —— 从前一句「主键 customer_code=待定」
|
|
既是英文列名,又在替一件他马上就要做的事做旁白。
|
|
②**自增列不问人**:声明加 `FieldDeclaration.auto`,标了的列压根不进表单,
|
|
写入那一刻由基座按「同组其余主键值-两位序号」生成(`CU-9001-01`,序号数正式版 + 本单草稿,
|
|
同一单连加两位也不撞);卡上另摆一句「由系统按顺序生成,不用你填」——
|
|
**不能一声不吭地拿掉**,那样人会以为这张档少了一格。
|
|
- **放行卡砍掉四条判据,办结后换成落地结果**(2026-08-02 用户定):
|
|
`downgrade-safe` · `route-alt` · `route-rfq` · `typed-on-record` 四条都是**内部一致性**
|
|
(打标依据对不对、几类料开了几张单、两张表行数齐不齐)—— 该由引擎自己看住,
|
|
而放行卡是给签字的人看的:一屏九条,真正要他过目的那几条反而淹了。
|
|
落地那一侧不因此变松:同一批基座读数仍在 S5/S6 的收步判据里。
|
|
**办结之后那一屏换成「这一签下去发生了什么」**:进了哪几张表各几行(摆表的人读名)、
|
|
转去哪儿了(摆出口的 description)、试跑挡下几行 —— 判据说的是签之前要核什么,
|
|
签完再回看,那一摞对勾答不了这个问题。事实取自放行那一刻的**结构化留痕**
|
|
(`ledger-write` / `release-verdict` 的 detail),不解析日志句子。
|
|
- **判据措辞写全,两张卡的按钮统一**(2026-08-02 用户定):
|
|
「客户已确认(认出或已建档)」→「客户已确认:发件邮箱认出为老客户,或已为新客户建好档」,
|
|
五条同批改写;执行卡与验收卡那一钮改成同一形状 —— 图标一格、**四字粗体**
|
|
(执行工单 / 验收工单)、小字说明、右侧箭头,且四字在上小字在下(从前是反的)。
|
|
- **执行工单说的是「哪几格必须有、哪几格值得追」**(2026-08-02 用户定):
|
|
A1 的作业指导书从「怎么核表」改成逐项建议 —— PN/年用量必须有(缺一条走不到放行)、
|
|
目标价尽量试探出来、客户料号对齐回价单、品类与制造商能填就填;
|
|
收口标准写明「问不到的留空并在备注里写明,放行时由你决定先受理还是退回」。
|
|
- **A1 不再开请求单**(2026-08-02 用户当场定):`alt_request` / `rfq_request` 两张表
|
|
连同 S6 的开单动作、两个派单计数列、报告里那两张明细表一并退休。原话:
|
|
「这两项数据不在这里产出;随令牌流向下一个节点的只有工作成果验收内的内容;
|
|
进入选型替代后,活动会自己归一需要的数据」。从前 A1 逐条开单交给 A2/A3 ——
|
|
那是**替下游把它的输入先摆好**,而下游本来就要照自己口径归一一遍:
|
|
同一份事实两处各存一份,改一处就分叉而没人看得出以哪份为准。
|
|
S6 的收步判据改读 `route_decided_total`(旗是布尔,分不清「没写」与「写了 false」)。
|
|
报告同批瘦身三处:两张请求单表 + 那条对账说明、「受理结论」四格表、
|
|
「本轮不报 0 行」横幅 —— 后两者要么与别处重复,要么九成时候在说「没有」。
|
|
- **消息不再被内部事件刷屏**(2026-08-02 用户:「消息怎么总莫名其妙的出内容」):
|
|
「无主入站待认领」从前只看「有没有主 + 有没有人接住」,于是**台账写一行发的
|
|
`data` 事件**也进兜底 —— 装一次活动包就往三个人收件箱塞十几条
|
|
「无主入站待认领:(无主题) … 原件:无」。判据加一刀认**来源**不认类型:
|
|
同样是 `data`,从通道进来的是件、台账写出来的是事实;只有 `source.kind === 'channel'`
|
|
才谈得上「无人认领」。顺带:顺利收尾那条 `终态:released` 不再进对话区
|
|
(落地结果那一屏已经说全了,且它摆的是英文状态名);没顺利收尾的仍出声,措辞取
|
|
`TERMINAL_STATE_LABEL`。
|
|
- **一道只认「有人写过」的门等于没有门**(2026-08-02,用户送来一单熔断的实测):
|
|
那一单跳过 S4/S5/S6 直接提交放行 —— 受理记录三行一个标没打、分类表一行没写,
|
|
却进得了放行门。查出来三个洞:
|
|
①**放行门的入场哨兵 `s_routed` 只有 onPart 没有 ifPart** —— 「往 need_sourcing 写过一笔
|
|
就开门」,模型顺手写了个 `false` 就把门推开了。现在认**办完了没有**,
|
|
且三个数全由基座现数(打了标的条数 = 记录行数、去向定过了)。
|
|
②「每条都已打标」这条 L2 读的还是活动自报的 `untyped_total` ——
|
|
「机检只许读基座数得出来的数」**第三次**被违反(前两次:missing_key_total /
|
|
missing_minor_total)。改读 `_type_tag_a + _b + _c = _rows`,两边都是基座出的数。
|
|
③**拒回把「活没干完」说成了「数或行对不上」** —— 那一单数是对的(诚实报了 3 条没打标)、
|
|
行也是对的,而话术只给「改数 / 改行」两条路,还明写「别为了过判据去改那个数」,
|
|
正好堵死它唯一想走的门,于是原样重提五拍熔断。现在判据点名的表若**这一单一行都没写**
|
|
(基座 `_rows` = 0),就直说「那一步还没办,回去办了再来」。
|
|
**指向两扇打不开的门,比不指还糟。**
|
|
- **验收那一屏是活动的收口,答两件事**(2026-08-02 用户定):①落了什么 —— 按**交付物**点名
|
|
(`RequiredDeliverable.ledgers` 说清一份成果由哪几张表承载:A1 的受理记录 / 分类表 / 结论
|
|
是**同一份**询价受理记录的内部结构,从前各占一条,人在成果面上看到三样东西);
|
|
②往哪儿去 —— 转出哪一口、**带过去哪些字段**(载荷即已落地的事实,摆列名不摆值),
|
|
一个口都没发就直说「到此为止」。同批:`统一受理记录` 全仓改称 `询价受理记录`;
|
|
成果列表执行蓝 / 验收绿两色;办结卡那一钮改称「打开报告」。
|
|
- **签完到收尾之间有自己的话**(2026-08-02 用户:「点完验收按钮后会闪一下中间态」):
|
|
那不是渲染毛病,是**真的中间态**(合并 / 发口 / 落终态还在跑)。从前它落在通用四态里 ——
|
|
待办清零先闪一句「都办完了」再跳「已收尾」;那句话在那一刻是对的,可它说的是另一件事。
|
|
现在这一段说「字已签下,正在落地」。**中间态本来就该说出来,只是要说对。**
|
|
- **进度条漏了一格,和一条已经不存在的路**(2026-08-02 用户送来一条实测日志):
|
|
①`INTAKE_PHASES` 漏了 `S3_confirm`(它是 08-01 才补回成一项的)—— 计划项六个、名单里五个,
|
|
于是 S2 一收进度条当场跳到「判定去向」,而人这会儿正对着受理需求审定那张卡:
|
|
**他手上办的那件事在条上没有格子**,条却已经走过去了。补成四格
|
|
(定位客户 / 归一受理 / 交你审定 / 判定去向 + 基座统一加的放行收口),
|
|
包内自测钉死「除放行外每一项恰好属于一个阶段」。
|
|
②说明书里还留着「人交回来还缺必填,就再发一张卡」—— **提交闸上线后那条路已经不存在**
|
|
(缺必填按不下提交),模型照它办,每次都撞在「这件事刚问过,人也答过了」上,连烧四拍。
|
|
改成「这张卡一单只发一次」;同时把提交闸补到**服务端**(收下回传之前把住)——
|
|
说明书向模型承诺「卡回来时必填一定是齐的」,那句承诺只有服务端拦得住才算数。
|
|
- **话说的范围要盖住门拦的范围**(2026-08-02 用户问「为什么会少了 start」查出来的):
|
|
提示词那条规矩写的是「标了『须你启动』的项要先 start **再调工具**」——只说了调工具;
|
|
而拦截那一侧(`readyToWork`)管的是 tool / ask / human / decide / entry / finish 一整片。
|
|
模型那一拍要发的是 `human`(派工单),照字面读这条规矩管不着它,于是漏了 start,
|
|
撞上「S3_confirm 标了人工激活,要先 start 再干活」白烧一拍。**话窄一格,模型就正好漏在那一格上。**
|
|
写全之后三案例复跑 **全部被拒 0**(案例三从 14 拍 126k / 被拒 2 → 11 拍 97k / 被拒 0)。
|
|
同批两处呈现:目标价改左对齐(右对齐是给要竖着相加的数用的,这张表一行一个料、彼此不相加);
|
|
待处理那一屏表上方加**缺项红带**,点名还差几格、差在哪一行哪一列 —— 两个数由基座现算
|
|
(`_missing` / `_missing_keys`,与提交闸、放行门 L1 同源),「一格不缺就别出这条带」
|
|
交给样式表(`data-class-of` → `v-0` 那档 display:none),模版仍不算也不判。
|
|
- **A1 三案例常备**(2026-08-02):全 A 类直通 / 客户点名跳一条 / 新客户中文正文列料缺必填 ——
|
|
三条来件形状真不同(俄文 BOM 附件、正文点名跳料、中文正文列料无附件),
|
|
末次复跑 **3/3 released、全部被拒 0**(11 / 10 / 11 拍)。
|
|
- 后端 19 模块 + 6 活动包 + 前端 features;五道门禁全绿(2026-08-02)。
|
|
- **别用 `db:seed` 当装活动的手段**:它会重写整套治理台配置。装活动用 `pnpm activities:install`。
|
|
|
|
## 文档权威地图
|
|
|
|
| 层 | 文件 | 说明 |
|
|
|---|---|---|
|
|
| **活文档**(冲突时以代码现状为准) | `docs/编码规范.md` | 工程结构权威:模块层级 L1-L8、依赖门禁、AI 协作协议 §12 |
|
|
| | `docs/产品设计.md` | 三面一体的产品形态与决策记录 |
|
|
| | `docs/活动开发规范.md` | **开发活动照这份**(2026-08-02 第三版,按四轴重组:解耦机制/Harness 契约/Loop/活动怎么写):基座读数与机检纪律、门与闸、五类卡、剧本 steps、建模十纪律、三常备案例与验收口径(released+被拒0)、**排障速查表**;§8 = 待实现 |
|
|
| | `docs/HTML报告生成规范.md` | **报告模版照这份**(2026-08-02 从开发规范拆出):一份 HTML 三个身份(件/表单/归档件)、**报告与卡的关系与同源纪律**、绑定语言全表、编辑态(闸/孪生件/增删行/红带)、PRD 平移法、陷阱表 |
|
|
| | `docs/debt.md` | 欠账台账(只增,销账划线) |
|
|
| | `docs/adr/` · 各模块 `CONTRACT.md` | 架构决策与模块级不变量 |
|
|
| 业务样例(活) | `docs/MVP示例工作流.html` | 七节点 SOP + 判定表 + 台账域 —— 开发活动的业务素材 |
|
|
| 前端语义权威 | `~/coding/JCAI_PRD/workbench` `~/coding/JCAI_PRD/governance` | 原型 1:1 平移(只平移不 import);工作台视图逻辑以 `workbench/.../\_data/model.ts` 统一建模为准 |
|
|
| 归档 | `docs/archive/` | 已完成使命的文档(**操作系统/活动模型两卷语义源**、旧 README 规格包、PROGRESS、旧计划),只读;代码注释里的 OS x.x / AM x.x 编号指向归档卷章节 |
|
|
|
|
## 铁规矩(违者返工)
|
|
|
|
1. **五道门禁以退出码验**,不许以 echo 验:`pnpm -s typecheck && pnpm -s lint &&
|
|
pnpm -s depcruise && pnpm -s api:check && pnpm -s test`(或 `pnpm gates`)。
|
|
2. **契约变更四步**(§12.4):depcruise 反查下游 → 同步 CONTRACT.md →
|
|
`pnpm api:check --update && git add api-report` → 破坏性走三步弃用。
|
|
3. **§12.5 禁止清单**:no `any` / `as unknown as` / `@ts-ignore`;domain 零 IO;
|
|
不删测试;不动门禁配置;不绕写三分/两缝。
|
|
4. **mock 只许出现在外界**(邮件通道、外部系统的录制回放替身);系统内部机制不得 mock。
|
|
5. **密钥只从环境读**:`JCAI_DEEPSEEK_API_KEY`(模型)、`JCAI_SEED_PASSWORD`(种子口令)、
|
|
`JCAI_SECRET_KEY`(凭证密封);不入源码、不入包、不入留痕;E2E 永不回退开发库。
|
|
6. **试跑一律用 AI 账号**(密码 `jcai-dev-2026`),绝不派到用户工作台;测完
|
|
`pnpm --filter @app/api reset-runs` 清运行数据(清跑出来的,留配置好的)。
|
|
7. **安装恒新增**:活动/工具改了内容必须升版本号,同版重装是 no-op(静默丢失,踩过)。
|
|
8. **界面不撒谎**:状态如实(未绑就写未绑)、错误带厂商原话、不可用不摆假数字。
|
|
|
|
## 常用命令
|
|
|
|
```bash
|
|
pnpm gates # 五道门禁(gen:tiers → typecheck → lint → depcruise → api:check → test)
|
|
pnpm db:up # docker compose 起 PG16
|
|
pnpm db:migrate # 应用迁移(新迁移写 db/migrations/ 并登记 meta/_journal.json)
|
|
pnpm db:seed # 播种(五员工 + AI 账号;登录者 = 冯兵)
|
|
pnpm dev:api # :8787 pnpm dev:web # :5173(/api 反代)
|
|
pnpm --filter @app/api reset-runs # 清运行数据,留配置
|
|
pnpm activities:install # 只装活动包(不碰治理台配置)—— 开发活动时用这个,别用 db:seed
|
|
```
|
|
|
|
## 结构速查
|
|
|
|
```
|
|
apps/api/src/modules/<m>/{index,contract,port,CONTRACT.md,internal/{domain,usecase,adapter}}
|
|
apps/api/src/app/ # 唯一组装层:container / wiring/engines / routes / workers / seed
|
|
apps/web/src/features/ # desk-*(工作台)· gov-*(设计+运营)· auth
|
|
packages/{contracts,activity-sdk,sfeel,ui-kit,testing}
|
|
activities/<id>/src/{index,manifest,case-model,skills,views/} # 活动包(只准 import @sdk/@contracts)
|
|
```
|