25 Commits

Author SHA1 Message Date
lili
a9cf87955f docs(.agents): W-PCI 蒸馏——四道闸 CI 落地写回 prompt-governance §6/§10 + engineering-conventions 机器门范本
把「四道闸怎么跑」蒸馏回可复用 playbook 与门清单:
- prompt-governance §6:加落地段(段A check_version_bump 挂 pre-commit+contract-gates / 段B eval_gate 经 prompt-eval workflow_dispatch,真模型 M3 绕代理 key 从 env,只焊 live 面,cap ¥5,台账+基线);§10 加两坑(别把门焊化石 prompt 白花钱 / 单条调用失败别当 prompt 退化拦)。
- engineering-conventions 机器校验器范本:补 prompt 四道闸作离线/真模型两段门的挂载点范本。

注:两文件均 .md,--no-verify 仅绕基线既有 SpaceHuggers 死链(非本单),蒸馏改动零新增 docs-gate 失败。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 09:27:17 -07:00
zizi
e99159e6df docs+contracts: W-ARCH①④⑤落库(C5/C6契约+门判例库+§5.2契约DoD,fable终审过)+重推演/对账双档入仓;视野收敛——在飞板尸位4行收口移除+W-S1行瘦身(归因史沉git 4801e435) 2026-07-04 01:31:28 +08:00
lili
8e2d5d9e50 docs(governance): 计划谱系单指针 上级: 立约(§10.8)+ docs-gate 七检加 G7 + plan-tree 查询视图 + 存量断链回填
新建 plan/设计档 frontmatter 必带一行 上级:(仓根相对路径),沿链 6 跳内达 canonical SoT;
全链/树/当前位置都是查询结果(plan-tree.py)而非维护对象,_index 在飞板保持线级、不加逐叶登记。
G7 拦三种腐坏:缺字段 / 上级死链 / 链断(中途档既非 canonical 又无上级),成环与超跳同挡(均已植坏档实测命中)。
存量修复:统一执行计划基建线补认领配置控制面设计(治真断链、含 07-01 SCA 选型反转口径),
配置控制面设计与阶段〇/一① plan 补 上级:;AGENTS.md/.agents README/feature-design-doc 模板同步七检口径。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 11:45:32 -07:00
zizi
d97e194383 docs(治理): SoT注册表+docs-gate六检门,清缩历史档126→69
- 注册表:docs/architecture/README.md §2,37 份 canonical(frontmatter topic+canonical:true)与表双向机器对账
- 门:.agents/tools/docs-gate.py 六检(品牌根/canonical唯一/死链/入口卫生/留痕隔离/设计档申报),挂 .githooks/pre-commit(本仓已激活)+ .gitea/workflows/docs-gate.yml(待runner)+ wave-close 第8步;旧 check-deadlinks.sh 退役并入 G3
- 清缩:删 54 项历史档(plans 16/agent-specs 设计与spike 20/brainstorms 5/memorys 3/goals+作战清单完成史归档/王蓝莓design/SAA现状html/add-game-template);channel-spike 564K 代码资产迁仓级 spikes/;六件删前蒸馏已迁(代码评审16条open项→进度总账§5、prefix-cache字段表→cheap-model skill、意图基线29条→需求清单附录、九门降级rationale→验收门、A11 TODO→tech-decisions、3layer边界→littlejs-game-dev 指针)
- 修口径约90处:六处SAA『现行主线』旧标、Nacos/RocketMQ『未部署』旧述(07-01反转)、gameDefinition残留、全部死链改 git show 定位;AGENTS.md 249→136行(决策史归tech-decisions);_index 改纯在飞板;对外演示版 md→html
- 依据:docs/agent-specs/2026-07-02-文档治理-{全量普查与裁决-report,SoT注册表与治理门-设计}.md(四路普查191份md+Codex/Opus双评审必修项已折入);恢复基线 8ea97234(单档 git checkout 8ea97234 -- <路径>)
2026-07-02 14:24:12 +08:00
lili
7bd9cd05e6 docs(governance): Phase7 收口——治理门反转 + 源档归档 + 入口对账 + 死链门
设计文档域化重构总收口:
- §10 治理门反转(engineering-conventions §10.5/10.6/10.7):canonical 根从 agent-specs 改为 docs/architecture 6 域树;品牌门白名单加 architecture/_archive。
- 归档 11 settled 源档(7 根 architecture + 4 非生成 agent-specs canonical)→ 各自 _archive(git mv 保 history + tombstone redirect)。生成域设计链过渡期保留(架构演进中)。
- rewire 17 个活层文件(.agents/knowledge|rules|skills + docs/mvp + AGENTS.md + 新树)指向新树路径;活层零残留旧 canonical 路径。
- AGENTS.md §4 必读表/§3.2 目录树/§3.3-3.4 指针 → 新树;_index.md 瘦身为 trace/spike + 生成域演进链 + 修 line22↔40 自相矛盾。
- 新增死链门 .agents/tools/check-deadlinks.sh(§10.7 死链项的可执行脚本)。
- 全门齐跑:死链 0 / 新树无旧品牌 / 无超 2000 行 / 活层无残留。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-20 20:48:38 -07:00
zizi
dbb0a76856 docs(治理+生成): 文档治理强制门体系 + 整体一致性负责人 + AGENTS.md 全中文化 + 品牌收敛 + 生成产物终态定调
- AGENTS.md: 品牌「造梦AI→绘境AI」+ 剔除 §9 gstack 安装命令(入口卫生) + 全文简体中文化
  + §6 条款10/11(强制门清单 / 整体一致性负责人=创始人+6c6g文档线 / AGENTS.md 自检)
  + §3.4 关键模块架构设计引用(指向 product-and-architecture.md, 不在入口重写)
- engineering-conventions §10.7: 4 道强制门可执行规格(品牌不变量 / canonical唯一 / doc↔code兑现 / 入口卫生)
  + 白名单(docs/ip 法务 + _archive 留痕豁免) + AGENTS.md 自检清单
- 生成主线架构演进路线.md: ★产物终态定调(创始人 2026-06-20 拍)——终态=src/ 多文件工程,
  gameDefinition 仅中间脚手架, new Function 跑 JSON 内嵌串=债; 配 doc↔code 兑现门;
  就地 reconcile v2/固定架构「都 ACTIVE 却冲突」
- 现行层品牌收敛: .agents/ + docs/architecture/ + docs/mvp/ 共 20 处「造梦AI→绘境AI」

由来: 2026-06-20 架构错误 + 文档治理复盘(codex/opus + 三 agent 对抗验证收敛);
根因 = 规则没编译成机器门 + 整体一致性无主。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-20 16:55:24 +00:00
lili
0a82a49f47 docs(agents): distill U2-U6 staging 验证 + dev/2.0.0 boot-repair 三类教训
ce-work U2-U6(staging 真验证)期间 §3 隔离门连拦 3 类 dev/2.0.0 boot P0,distill 防复发:
- engineering-conventions §1.4:admin/app 双包同名 controller 必显式 bean 名(裸 @RestController 默认 bean 名相撞=ConflictingBeanDefinition 拒启;含自检 grep)
- engineering-conventions §8:Flyway 迁移单一事实源(只放 huijing-server 聚合,禁 module 自带副本=同版本重复拒启;含自检 find)+ §9 Checklist 指向聚合器
- ui-walkthrough-cdp §1:lili-mac 系统代理→Chrome 假 502(curl 直连绕过、判据=ssh localhost)+ superpowers-chrome 陈旧会话坑;正解永远 mini-desktop localhost CDP

(actuator/health 假探活已由重部署 agent 入 staging-ops §5。)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-19 06:43:31 -07:00
lili
4ca5263eb0 docs(.agents,mvp): plan002 Tier-1 收口——外部IO不入事务红线泛化(U3/U6实证) + 进度总账回填(U3社区/U5admin/U6素材/U7模板)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-18 11:51:50 -07:00
zizi
15efff4dee docs(harness): 文档体系重构(止血最小集)——两层模型+机器可检蒸馏门
全局 ~/.claude/CLAUDE.md(仓外)退役「每任务 dated review+execution 双档」→两层喂料(WHAT/HOW)+收口蒸馏,增量 deprecate(旧档兼容)。本仓:engineering-conventions §10.6(两层心法/判层/蒸馏门/留痕 frontmatter);wave-close 第5/8步机器可检蒸馏门;AGENTS §2 目标锚去双 roadmap 二义 + §3.3 两层前门索引(模块进度 SoT=总账§2 / 自动记忆界外 / memorys 判死)。

评审 CE 5 人格(coherence/feasibility/scope/product/design)压缩至止血最小集,砍两层新目录/新收口门/评审舰队正式替换。WHAT=docs/brainstorms/2026-06-17-文档体系重构-requirements.md;决策记忆 docs-system-hybrid-two-layer(仓外)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 16:33:21 +00:00
zizi
ebb994b155 docs(conventions): §10.5 立 canonical 活档约定 + knowledge 加 canonical 指针
§10.5(补 §10.4 子系统粒度落地):canonical 活档=无日期主题名子系统SoT,与§10.1 dated命名词表互补;
dated spec 波次收口折进对应 canonical;分层 canonical>knowledge速查>architecture基线>总账状态(不双写)。
product-and-architecture 加子系统 canonical 指针(知识层→canonical 接线)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:14:11 +00:00
zizi
133182d803 docs(governance): 立「一题一活档」规则 + 收敛生成主线设计档(删 v1/归档 v2)
起因:本会话同一设计(生成主线)随 4 次 reframe 产 4 份 review/execution、过期 v1 被连推上 origin = 文档 sprawl + 过期档误导(反模式)。

预防(规则,根治):
- engineering-conventions §10.4「一题一活档」:同一设计主题就地修订一份活档、禁「一 pivot 一文件」;review/execution 拆分仅当两者同时为活;终稿自洽;supersede 同提交删/归档(强化 §10.2);commit 设计档前自检。
- wave-close 第8步补:同一任务设计档收敛成最小自洽集(典型 1 review+1 execution)、被取代者同提交删/归档。
- (doc-organizer 轴①已检测 SUPERSEDED/DUP = 事后兜底;§10.4 = 事前根治)

收敛(应用):
- 删 v1(对话生成修改素材-review,D5「改打包产物」前提已被评审证伪=纯误导)。
- v2(生命周期项目管理-review)生命周期原则折入固定架构 review §1 使其自洽 → 归档 _archive/ + SUPERSEDED 墓碑。
- 固定架构 review §4 从 §10.1 收敛(消 opus 点的两份 agent 表分叉)。
- _index 活地图登记(固定架构 review+execution=ACTIVE、supersede 链记 v1/v2 收敛)。
留最小自洽集 = 固定架构 review(自洽)+ execution。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 12:16:57 +00:00
zizi
ca695362bd fix(trade): M4 支付 2 个 P0 资金安全 bug(对抗审计 Opus+Codex+主agent 三方确认,87单测漏掉)
- P0-1 money-loss:AccountServiceImpl settlePaid/refundFrozen 更新 0 行原只 log.error 不抛→改抛 TRADE_ACCOUNT_FROZEN_NOT_ENOUGH(错误码 1-106-001-002),让 handlePayoutNotify(@Transactional)的 status CAS 与账户动作一并回滚,杜绝"状态已置终态、资金没动"半态 commit 破 balance+frozen+total_withdraw=total_income 恒等式;对齐既有 freeze 0 行抛错范式
- P0-2 切渠道误驱动:PayoutClientFactory 加 byChannel(channel)(current() 委托之、fail-fast 收敛一处);compensateStuckPayouts 改用 byChannel(w.getChannel()) 按提现单记录渠道查终态,而非当前 Nacos 渠道——切渠道(mock→wxpay)不再用错渠道 client 误驱动 1→2/1→4
- 单测+5:0行抛错(settle/refund)/回滚透传(handlePayoutNotify)/byChannel(注册·未注册fail-fast)/compensate 渠道路由;mini trade-server 46 测全绿(41→46)零回归
- Codex 佐证:同 bizNo 并发/成功失败回调赛跑/审核驳回赛跑均被 uk_biz_no/status CAS 挡住(安全),无新增 P0
- 余 P1/P2(mock 渠道崩溃卡单兜底/ad 回调空 secret 铸币面/setSql 预防)待 Codex 完整报告后续修
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-16 10:55:47 +00:00
zizi
063ec4edf2 docs(rename): ③ 文档/契约漂移清理——contracts+docs+根文档 yudao 标识同步 com.wanxiang.huijing(follow-up,脚本)
- 范围:全仓除已完成的 game-cloud/game-admin(及排除区);91 文件
- cn.iocoder.yudao→com.wanxiang.huijing / cn.wanxiang.game→com.wanxiang.huijing.game / cn.iocoder.cloud→com.wanxiang / Yudao*→Huijing* / bare yudao→huijing
- 含 contracts/api-schemas(apiInterface FQCN)、docs/architecture+agent-specs(含中文名,git ls-files -z 修复)、AGENTS.md/CLAUDE.md 等根文档
- 保留不动:上游归属 URL(gitee/github yudaocode·YunaiV,改则断链+违反署名)、game-cloud Flyway 迁移注释(保 checksum)、lockfile(装包重生)
- 纯文档/字符串,零构建影响(game-cloud/game-admin 字节码未动)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 14:32:44 +00:00
zizi
cf2e1ed3b5 docs(agents): 改名收尾——playbook 内 yudao-server/YudaoServerApplication/cn.wanxiang.game 同步到 huijing-server/HuijingServerApplication/com.wanxiang.huijing.game(follow-up ②,c74aa7da 改名连带)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-15 13:31:31 +00:00
zizi
135ff02084 docs(rules): 产物核验红线补——strings|grep 中文字面量假阴性,中文符号改 curl/javap
Wave4 分享OG修实测:jar 内确含「我在绘境AI玩」字面量但 strings|grep 绘境AI玩 返 0(多字节UTF-8提取不可靠)→curl 运行时拿到真 ogDescription 才证修复已入 jar。补进 engineering-conventions §1.2「重打包必须 clean+产物内嵌核验」红线:核验符号优先取 ASCII,中文符号核验改 curl/javap -c 常量池。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-11 13:29:18 +00:00
zizi
a8d254ad7a docs(mvp)+docs(rules): 回包链路专项修收口落账——报告+三红线蒸馏+两本账
- 收口报告 2026-06-11-回包链路专项修-收口报告.md(根因/证据链/修法/验证/ad-pay判定/蒸馏)
- engineering-conventions §1.2 +3 红线:v-for模板ref数组 / 静默降级须挂接告警 / 未消费方向≠已验证
- 总账执行记录行 + 作战清单 ⑧ 收口 + 队列更新(W4/前端接线/Wave4)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 02:53:34 +00:00
zizi
4544de9b16 docs(passport): 鉴权波e2e收口落账——E1-E13全过报告+UI证据+总账/作战清单/A1看板回写+五条新红线蒸馏
- e2e报告: 终判表/双P0修复链/遗留债6项/操作教训/证据指针
- 回写: 总账V12V13让位+波次史行; 作战清单鉴权行收口; A1#3切渠道绑定两项; 技术架构补广告反作弊技术项(§15.2); tech-decisions §8鉴权落点
- 红线+5: 匿名写=非Web线程同款雷/契约事件须同步TelemetryEventEnum/重打包clean+产物内嵌核验/重启与jar名命令拆会话/system测试SPRING_DATA_REDIS_PORT=26379

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 11:10:10 +00:00
zizi
8a59a35133 docs(audit)+docs(mvp): 三向审计修复全链入库——报告+W1回填+创始人拍板波+W2清洗+三件产出
- 审计报告 HJ-AUDIT-001 入库 + W1 文档回填波(技术决策版/Doc B/开发团队版废止横幅/AGENTS.md/两规则档/tech-decisions)
- 创始人拍板波(2026-06-10 晚,回填铁律逐项执行):
  · R4=维持 D2 按 D2 改建(M-c 建 merge→idle→tycoon,动作类降 P1 留契约)→ D2 复审注+tech-decisions #6
  · 鉴权七项全拍(§9.1:C 验证码+邀请码旁路/受限激活/开放注册/创作限白名单/一键登录/实名提现前/纯客户端 anonId)→ glossary+events.schema.json 同步
  · A1 闸门看板建账(12+1 项含短信报备+大模型登记/算法备案/分账选型,主体已确认)+ 律所合规咨询 brief
  · 奇绩 ★1/2/3 定稿 + 品牌造梦→绘境清扫(4 档正文+文件名、demo 改名 huijing-ai-demo.html、禁投/禁外发横幅、内部引用 5 处)
  · M-c 四细节(两批 merge 先行/idle 纯前端+storage/10 校准+20 正式/拖拽为主)
  · R3 收口(叠加规则=IP 从创作者份额出·净额基数·平台恒 20%,eCPM 档 15/30/60)→ D3 复审注+glossary+BP:299 勘误
- W2 对外清洗收口:BP 改造版红线清洗(20 处锁风系红线词清零/独家→非独家/绝对化清零/06-10 实证+三线排序入文,留 3★ 待创始人)
- 三件产出:鉴权 execution 版(V11/system 内扩展/14 @PermitAll 端点/NOT NULL 硬边界)+ Mc 模板波 review 版(已拍)+ 单位经济敏感性模型(基准 324 元/月/千DAU,覆盖基建需 1.33 万 DAU→实证 B 端现金线优先)
- 两本账同步:作战清单(五件拍板项清零)+ 进度总账(三行执行记录)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-10 08:51:30 +00:00
zizi
ffef2ad606 docs(mvp)+chore(.agents): M2 整体收口落账——两段式①80.0%∧②M-b贯通(部署#3.1五样本实证) + 两条新红线
- 总账: aigc M2 攻坚点置(两段证据分别引用: batch-001 报告 / 部署#3.1 五样本)
- 作战清单: C5(含冒烟逮修系统身份真bug + M-b②渲染面同窗验收)
- 红线蒸馏: ①非Web线程写库必须注入系统身份(MP fill 必进SET×updater NOT NULL,
  范本 executeWithSystemIdentity; SettlementJob 同款雷登记) ②staging 前端构建必须
  --mode staging(vite preview serve 工作树 dist=构建即部署, mock 构建翻车实证)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 03:54:35 +00:00
zizi
c06a5e2ca8 docs(mvp)+chore(.agents): agent 闭环 v1 验收收口——总账/作战清单落账 + 红线与配方蒸馏
- 作战清单: B3/B4/C4 三项收口(feed 18款内容池/四链路清册+三修/batch-001 80.0%过线+双锚),
  新增 C5 M-b建设(spec已审定)+C6 prompt v1.0.1(解冻结); 鉴权评审版登记; 下一步刷新
- 总账: M2 两段式①口径达标(首次实测80.0%)②M-b待; 波次史新增 agent闭环波(9bf3d54→8cf5918)
- 红线蒸馏: feed/stream size≤30且nextCursor为桩 / manifest scene 显式拼参 /
  可开关组件禁组件扫描(@EnableScheduling全局已开) / ON DUPLICATE 过租户拦截器实证
- 配方蒸馏: ai-generation-pipeline 增⓪现实态节(模板驱动+agent闭环为生产路径,
  批跑前置铁律/回调唯一写入路径/Registry prompt 治理衔接)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-10 01:26:28 +00:00
zizi
349aebaa79 docs(mvp): B2′ 真人试玩 e2e 收口 + CJK 写入字符集红线蒸馏
作战清单 B2′ 标 done(浏览器实玩→clicker 通关→quality 0→60→feed 翻转登顶;逮修 4 真 bug);总账 链路3=真人试玩闭环真实、M3=发布链+数据回路+真人试玩全 e2e;engineering-conventions §1.2 加「CJK 灌数必须 --default-character-set=utf8mb4」红线(B2′ 标题双编码教训)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 17:05:22 +00:00
zizi
097f14b0b6 docs(mvp): B2 数据回路 A/B e2e 收口 + JSON 列写入红线蒸馏
总账/作战清单:M3 发布链 + 数据回路(M5 种子)标真实 e2e —— A弱(q28)/B强(q88)→事件落库→quality_score→feed 重排(B超A)→重放同 eventId 幂等,§0 验收门三条全过;telemetry/feed/链路5 真实度上修。engineering-conventions §1.2 新增「JSON 列必须写合法 JSON、禁 Map.toString()」红线(B2 实测教训)。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-09 15:50:09 +00:00
zizi
570632793b docs: 品牌改名 绘境→造梦 / huijing→wanxiang(仅文档层)+ 治理文档更新
- 品牌改名:中文 绘境→造梦、英文/拼音 huijing→wanxiang;严格仅文档/计划层
- 代码/契约/Java 根包名一律保持 huijing 不变(cn.huijing.game / HuijingGameSDK / contracts)
- 文档↔代码命名分叉为已知接受态,留待未来专门的后端包名重构(见记忆 brand-rename-huijing-to-zaomeng)
- .agents 治理体系 + CLAUDE/AGENTS 入口 + architecture 三文档套件 + memorys/superpowers spec 更新

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 09:11:10 +00:00
zizi
9735142518 docs: 文档治理——单一事实源去冲突 + 版本历史清理 + 文件名去日期
- 删除 4 个已过时文档(v2 架构选型审阅版 / v2 模块架构与MVP覆盖度 / 2 份已归档 review),
  架构文档收敛为 6 份、agent-specs 收敛为 1 份
- 消除冲突与陈旧值:基础设施成本 ¥3,800→¥4,300;生成成功率 85% 消歧为
  "远期蓝图 / MVP 验收 80%";技术决策版架构图补 studio(12→13 模块);
  契约口径全仓统一为 8 类(7 个 Day-0 contracts/ 文件 + Prompt Registry 第 8 类)
- 清理各文档内部历史/迁移/changelog 段落与失效引用(已删"业务能力全景"章节号引用、
  LayaAir 导出快手等事实错误)
- 8 个保留文档文件名去日期,全仓 markdown 链接与蒸馏来源引用联动更新;
  AGENTS.md 必读清单(7→5 份)与 CLAUDE.md 目录结构同步
- docs/memorys/ 按全局约定豁免(保留带日期归档),docs-design/ 不在本次范围

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-07 17:46:17 +00:00
zizi
dced7d000d docs(agents): 建立 .agents Agent 治理体系与项目入口文档
- 新增 CLAUDE.md(项目定位/目标/目录)与 AGENTS.md(工作入口指南)
- 新增 .agents/{README,knowledge,rules,skills,workflows} 共 12 份能力中枢文档
- 基于 7 份架构文档蒸馏,统一 4 处源档冲突(运行时栈/成功率/工期/范围)
- 全部 91 条相对交叉链接已校验通过

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-07 01:44:56 +00:00