跳到主要内容

AI Trading Matrix 项目文档 IA Audit

  • 日期:2026-05-15
  • Controller:AI Trading Matrix Controller
  • 控制包:packets/sync/labs-fintecai-project-controller-doc-refactor-r4-2026-05-15.md
  • 项目阶段:reference-evaluation-first
  • DOC_CHANGE_SCOPE:trading-matrix
  • 状态:Proposed

本 audit 是 R4 控制包 §3 最小 audit 包,只做只读分析,不直接改正文。


1. 当前目录树

projects/trading-matrix/
├── project-anchor.md
├── inherited-context.md
├── current-state.md
└── current-practice-profile.md

references/trading-matrix/
├── README.md
├── nofx-reference-evaluation-plan.md
├── nofx-reference-evaluation.md
└── external-reference-candidate-scan.md

evaluation/trading-matrix/
└── (不存在)

source/project-prealignment/trading-matrix/
└── (不存在)

controllers/trading-matrix/
├── state.md
└── checkpoints/
├── 2026-05-13-current-session-recovery.md
├── 2026-05-13-admin-batch4-pickup.md
└── 2026-05-14-controller-rewrite-dispatch-pickup.md

packets/sync/
└── trading-matrix-context-entry-cleanup-2026-05-13.md

文件总计:13(4 项目正文 + 4 参考 + 1 Controller state + 3 checkpoints + 1 sync)。

与 FinClaw 相比(~30+ 文件含 V1 design、task-packets、evaluation cases、reference experience),Trading Matrix 文件体量小,目录结构扁平,IA 复杂度低。


2. 文件角色标签

2.1 projects/trading-matrix/

文件角色依据公共入口引用
project-anchor.mdcanonical项目定义、生态角色、职责边界、第一阶段目标、执行治理边界的唯一权威源INDEX.mdsidebars.jsdocs-manifest.jsonllms.txt
inherited-context.mdsupport将生态基线、项目注册表、金融风险、执行治理口径下推到项目层;不增加项目自有事实INDEX.mdsidebars.jsdocs-manifest.json
current-state.mdsupport记录当前事实、缺口、风险、开放问题和下一步INDEX.mdsidebars.jsdocs-manifest.json
current-practice-profile.mdevidenceBatch 1-6 工程实践画像,证明执行域工程实践存在,不等于产品定义或生产 readyINDEX.mdsidebars.jsdocs-manifest.json

2.2 references/trading-matrix/

文件角色依据公共入口引用
README.mdreference参考评估入口 hub,规定 NOFX gap 与其他第三方参考线的使用顺序和吸收边界INDEX.mdsidebars.jsdocs-manifest.jsonllms.txt
nofx-reference-evaluation-plan.mdreferenceNOFX 最新仓库 gap 评估计划,定义对照维度、评估路线、输出格式和吸收边界sidebars.jsdocs-manifest.json
nofx-reference-evaluation.mdevidence (draft)当前仅 Batch 1-2 的 README + 代码入口级 gap 对照;多数能力域待复核INDEX.mdsidebars.jsdocs-manifest.json
external-reference-candidate-scan.mdreference外部参考候选收集、筛选和评估规则;候选池当前为空INDEX.mdsidebars.jsdocs-manifest.json

2.3 controllers/trading-matrix/

文件角色依据
state.mdcontroller-stateController 恢复入口、职责范围、authoritative docs 列表、任务队列和默认验证命令
checkpoints/2026-05-13-current-session-recovery.mdcontroller-state (ephemeral)会话恢复临时 checkpoint;内容已被后续 checkpoint 超越
checkpoints/2026-05-13-admin-batch4-pickup.mdcontroller-stateAdmin Batch 4 分发接手记录
checkpoints/2026-05-14-controller-rewrite-dispatch-pickup.mdcontroller-stateAdmin rewrite dispatch 接手记录

2.4 packets/sync/

文件角色依据
trading-matrix-context-entry-cleanup-2026-05-13.mdsync (absorbed)CONTEXT.md 公共入口清理记录,已完成吸收

2.5 公共入口角色标签不一致问题

INDEX.mdprojects/trading-matrix/ 下全部 4 个文件统一标为 canonical。但 Batch 8C-3 audit 和本次 audit 的判断是:只有 project-anchor.mdcanonical,其余为 supportevidence

这是 Admin-owned 公共入口问题,Controller 不直接修改。见 §7.1 Admin 回写请求。


3. 命名问题清单

3.1 R4 §4 后缀一致性

R4 固定后缀表:*-plan.md / *-audit.md / *-task-packet.md / *-reference-analysis.md(desk research)/ *-reference-evaluation.md(复现/体验证据)。

文件当前后缀是否命中固定后缀判断
project-anchor.md-anchor否,但属于 canonical 项目锚点,非参考/评估/任务类保留:R4 后缀表针对参考/评估/任务类文档,canonical 项目锚点不适用
inherited-context.md-context否,同上保留:support 类项目继承文档
current-state.md-state否,同上保留:support 类项目状态文档
current-practice-profile.md-profile否,同上保留:evidence 类工程实践画像,无标准后缀可替代
nofx-reference-evaluation-plan.md-plan合规
nofx-reference-evaluation.md-evaluation是(*-reference-evaluation.md合规
external-reference-candidate-scan.md-scan问题-scan 不在 R4 固定后缀表中

3.2 具体命名问题

#文件问题建议新名影响范围
N-1references/trading-matrix/external-reference-candidate-scan.md后缀 -scan 不在 R4 固定表中;内容本质是 desk research + intake surfaceexternal-reference-candidate-analysis.md(使用 -reference-analysis 家族后缀)INDEX.md 1 处、sidebars.js 1 处、docs-manifest.json 1 处、llms.txt 0 处(未直接引用此文件路径)、references/trading-matrix/README.md 内链 2 处、nofx-reference-evaluation.md 内链 1 处、current-state.md 内链 1 处

其他文件名均符合 lowercase-kebab-case.md,无版本前缀冲突,无同义后缀混用。

3.3 跨目录对象名一致性

对象projects/ 中的引用名references/ 中的引用名一致性
NOFX 参考评估"最新 NOFX gap 评估" / "NOFX gap 深评估""NOFX 参考评估" / "当前 Trading Matrix vs NOFX 最新仓库 gap"基本一致,但"深评估"与"参考评估"可收束为统一术语
外部参考扫描"NOFX 之外的第三方参考项目""外部参考候选" / "candidate scan"基本一致
当前实践画像"当前本地实践版本画像" / "当前实践画像""Trading Matrix 当前实践"一致

无需改名处置,但后续 rewrite-lite 应将"NOFX gap 深评估"统一为"NOFX 参考评估(代码/体验层 deep evaluation)"。


4. 处置建议

4.1 projects/trading-matrix/

文件处置理由影响范围
project-anchor.mdkeep唯一 canonical;结构完整,15 节覆盖定义/角色/接口/治理/回流;最后更新 2026-05-07,内容仍准确
inherited-context.mdkeepsupport,准确继承生态基线;与 project-anchor.md 存在内容重叠(§5-§9),但重叠属于继承关系设计而非冗余
current-state.mdrewrite (lite)support,最后更新 2026-05-07,但实践画像已推进到 Batch 6(2026-05-12)、NOFX 评估到 Batch 2(2026-05-14);§4 待核验进展、§6 缺口、§8 下一步和 §9 待决问题需与画像 / 评估最新状态对齐无公共入口链接变化
current-practice-profile.mdkeepevidence,已完成 Batch 1-6,内容详实;后续只需补运行验证状态和 NOFX 对照输入链接

4.2 references/trading-matrix/

文件处置理由影响范围
README.mdkeepreference hub,使用顺序、吸收边界和处理规则清晰
nofx-reference-evaluation-plan.mdkeep评估计划,仍在执行中
nofx-reference-evaluation.mdkeepdraft evidence;需要继续 Batch 3+ 代码/体验深评估
external-reference-candidate-scan.mdrename后缀 -scan 不在 R4 固定表;建议改为 external-reference-candidate-analysis.md见 §3.2 N-1

4.3 controllers/trading-matrix/

文件处置理由
state.mdrewrite (lite)需要登记本次 IA audit、吸收 rewrite-dispatch-pickup checkpoint、更新 §5 当前状态和 §6 任务队列
checkpoints/2026-05-13-current-session-recovery.mddefer纯会话恢复临时产物,内容已被后续 checkpoints 超越;可在后续清理批次中 archive 或删除,本批不动
checkpoints/2026-05-13-admin-batch4-pickup.mdkeep接手边界记录,仍有追溯价值
checkpoints/2026-05-14-controller-rewrite-dispatch-pickup.mdkeeprewrite lane pickup 记录,尚未被 state.md 完整吸收

4.4 packets/sync/

文件处置理由
trading-matrix-context-entry-cleanup-2026-05-13.mdkeep已 absorbed,具有公共入口修正追溯价值

4.5 缺失目录

路径处置理由
evaluation/trading-matrix/defer当前无评测 case、eval schema 或 run evidence;当项目进入产品定义 / MVP 阶段且有输出对象 JSON sample / 状态机 / 验收 case 时再建立;本阶段 reference-evaluation-first,评测层不应先于参考评估完成
source/project-prealignment/trading-matrix/deferTrading Matrix 不处于 prealignment 阶段;早期来源材料在工程仓库 docs/prd/nofx-analysis/other/nofx/,不需要搬入治理仓库

5. 内容深度问题

5.1 projects/references/ 的边界

当前边界判断:清晰,无结构性违规。

维度projects/trading-matrix/references/trading-matrix/边界状态
所有权项目自有事实(定义、状态、实践画像)第三方参考分析(NOFX、外部候选)清晰
写入方向描述 Trading Matrix 是什么、已有什么、缺什么描述外部参考项目与 Trading Matrix 的 gap清晰
吸收关系接收参考评估稳定结论转译输出结论到 projects/ 需经过转译已在 references/README.mdnofx-reference-evaluation-plan.md §7 显式规定

观察到的边缘模糊区域(不构成违规,但需关注)

  1. current-practice-profile.md 的 §7"后续对照输入"段落包含大量 NOFX 比较预期和指向。这些属于 practice profile 的 forward-pointer,不是参考评估本身,设计合理。但段落体积大(Batch 1-6 各有独立对照输入),后续 rewrite-lite 可考虑将对照输入整合为独立段落或抽取为 reference link index,降低 practice profile 的认知负荷。

  2. nofx-reference-evaluation.md 的 gap 对照表大量引用 current-practice-profile.md 作为 Trading Matrix 侧证据。这是正确的引用方向(reference 引用 project evidence),不是边界违规。

结论projects/references/ 边界当前无需调整。

5.2 参考评估证据

当前证据覆盖度

评估线已完成未完成证据充分度
NOFX 最新仓库 gap 评估Batch 1(README 级)+ Batch 2(代码入口级)Batch 3+(能力域深对照)、体验路径(全部 6 条均为"待评估")、既有分析文档 / 迁移记录 cross-reference不充分:9 个能力域中 1 个 待复核、4 个 参考后改造、2 个 保留自身演进、1 个 不应继承;但多数判断基于 README / 入口级证据而非代码深读或运行体验
外部第三方参考评估框架(字段、轴线、规则、降级规则)候选项目(0 项登记)、quick scan、deep evaluation:框架就绪但无候选输入

关键证据 gap

#Gap风险
E-1NOFX 评估无体验路径证据(全部 6 条 Dashboard / Strategy Studio / Backtest Lab / Competition / Trader Config / Auto Trading 均为"待评估")参考评估只能输出文档级和代码入口级 gap,无法输出产品体验级可借鉴 / 反例判断
E-2NOFX 评估未 cross-reference 既有 docs/prd/nofx-analysis/*docs/task/done/* 迁移记录已整合能力和遗留来源可能重复评估或遗漏
E-3外部候选池为空无法对 Trading Matrix 做多维度竞品/反例/可借鉴能力交叉对比
E-4当前实践画像(Batch 1-6)完成度远高于参考评估(Batch 2);下游 rewrite 如果基于不充分参考评估做决策,等于跳过 reference-evaluation-firstreference-evaluation-first 约束实质未被满足

5.3 执行治理(授权/风控/审计/可回滚)语境标注

当前标注分布

治理维度project-anchor.md 中的标注current-practice-profile.md 中的证据current-state.md 中的缺口登记nofx-reference-evaluation.md 中的 gap
授权§10 执行治理边界 4 层分层(信息→支持→授权执行→禁止漂移)Batch 5:JWT、authz.CanRead/WriteTrader、admin whitelist;缺口:webhook 无 JWT、admin debug 无 JWT、session middleware 未注册、event-backtest 无对象级权限§6.4 治理缺口第 1 条Batch 2:NOFX 有 JWT/token blacklist/crypto encryption,但 roadmap 仍列 RBAC/session/rate limit 为待做
风控§10 禁止漂移、§6 不拥有无边界控制Batch 4/5:策略级 RiskControlConfig、余额/equity/max positions/risk ratio、DrawdownMonitor emergency close;缺口:无真实交易开关、环境隔离、max daily loss、global kill switch、SL/TP 失败处置§6.4 治理缺口第 2 条Batch 2:NOFX 有策略风险 clamp 和 trade_execution 大额确认,但未形成完整 risk policy
审计§10 Authorization / Audit Record 输出对象Batch 5:event_log/decision/order/fill/position 分散记录;缺口:无统一 audit log、无来源 IP/请求头指纹/权限判定/admin 操作独立审计面§6.4 治理缺口第 1 条Batch 2:NOFX roadmap 列 audit logging 为待做
可回滚§10 可回滚治理边界Batch 5:StopTrader + final snapshot、ClosePosition、EventOrderWatcher cancel;缺口:无全局暂停、全账户撤单、失败补偿、自动恢复禁用、灾难回滚 runbook§6.4 治理缺口第 3 条未在 NOFX 评估中独立对照

核心问题

#问题说明
G-1执行治理 4 层分层在 project-anchor.md §10 中有清晰定义,但 current-state.mdcurrent-practice-profile.md 中的治理观察未按此 4 层标注治理证据存在但没有与 canonical 定义的 4 层(信息输入→交易执行支持→授权执行→禁止漂移)对齐标注;后续 reader 需要自己做映射
G-2current-practice-profile.md Batch 5 的治理画像和 Batch 6 的体验观察是当前最丰富的执行治理证据源,但它们埋在 ~280 行的长文档中执行治理证据没有独立 evidence index 或摘要;当项目进入产品定义时,writer 必须回溯全文档提取
G-3current-state.md §6.4 的治理缺口列表是 2026-05-07 版本,未吸收 Batch 4-6 的具体发现治理缺口在 practice profile 中有细粒度证据,但在 current-state 中只有粗粒度泛指
G-4在参考评估层(nofx-reference-evaluation.md),Risk / Audit / Authorization 域只有一行 gap 对照;NOFX 的 agent skill confirmation rules、trade execution safety 和 x402 wallet boundary 未被独立标注为可借鉴/反例执行治理在参考评估中没有得到与执行链路同等的对照深度

5.4 需 rewrite 的章节(非 rename)

文件章节问题建议动作
current-state.md§4 当前已知进展§4.1 最后一段仍写"在参考项目评估前,应先完成画像"——画像已完成到 Batch 6rewrite §4 以反映 Batch 1-6 完成事实和 NOFX Batch 2 进展
current-state.md§6 当前主要缺口§6.1 多条事实缺口已被实践画像填充;§6.4 治理缺口未吸收 Batch 4-6 具体发现rewrite §6 以反映已填充 vs 仍缺失的精确状态
current-state.md§8 下一步第 1 条"完成实践画像"已完成;第 2-4 条 NOFX/外部评估仍是 next;整体排序需更新rewrite §8 以反映当前 next-step 优先级
current-state.md§9 待决问题第 1 条"画像 Batch 1 是否只填摘要"已被 Batch 1-6 证否;其余多条仍有效删除已回答的问题,保留仍有效的
current-practice-profile.md§7 后续对照输入6 批对照输入累积 ~90 行,认知负荷高后续 rewrite-lite 可将 6 批对照输入整合为按能力域索引的对照摘要表

6. Reader-Test 计划

6.1 本批触发条件

本次 IA audit 为只读分析,不改正文。后续基于本 audit 的改造分两类触发:

触发场景reader-test 等级依据
current-state.md rewrite-lite(support 文档内部更新)L1(R-self + 1 独立 Agent)R4 §6 + reader-testing-protocol §4:单 lane 重构
external-reference-candidate-scan.md renameL0(R-self 即可)纯文件名变更,无内容改造
如果后续触及 project-anchor.md canonical 首屏L1 升级到 L2reader-testing-protocol §4:canonical 重构
如果后续触及公共入口(INDEX / sidebars / manifest)L2reader-testing-protocol §4:公共入口重构

6.2 独立 reader 调度

当 L1 触发时:

视角推荐 Agent调度方式
R-selfAI Trading Matrix Controller(本 session)改后自审
R-agent-low-contextCodex exec read-onlycodex exec --sandbox read-only --json with fresh prompt

归档路径(预留):evidence/reader-tests/2026-05-<DD>-trading-matrix-ia-rewrite-l1/


7. 风险与开放问题

7.1 Admin 回写请求

请求 1:公共入口角色标签修正

字段
对象AI Trading Matrix
需要更新的公共入口INDEX.md
原因INDEX.mdinherited-context.mdcurrent-state.mdcurrent-practice-profile.md 统一标为 canonical,但 Batch 8C-3 audit 和本次 audit 判断分别为 supportsupportevidence
新增入口
移除入口
语义层INDEX.md 中 Trading Matrix 行的角色标签应区分为 canonical(project-anchor)+ support(inherited-context、current-state)+ evidence(current-practice-profile)
验收命令npm run build

请求 2:rename 联动

如果 N-1 rename(external-reference-candidate-scan.mdexternal-reference-candidate-analysis.md)获批,需 Admin 同步更新 INDEX.mdsidebars.jsdocs-manifest.json 中的对应路径。

7.2 Open Gaps

#Gap影响优先级后续动作
OG-1current-state.md 落后于实践画像 Batch 6 和 NOFX 评估 Batch 2reader 读 current-state 会低估当前已知证据和已发现风险P1rewrite-lite,纳入下一批改造
OG-2执行治理 4 层(信息→支持→授权→禁止漂移)未在 practice profile 和 current-state 中作为标注轴治理证据分散,无法快速回答"当前哪些能力处于哪一治理层"P1后续 rewrite-lite 时在 current-state 或 practice profile 增加治理层映射表
OG-3NOFX 评估只有 Batch 2(README + 代码入口),reference-evaluation-first 约束实质未满足下游 rewrite / 产品定义如果现在启动,依据不充分P0继续 NOFX Batch 3+(代码深对照 + 体验路径)
OG-4外部参考候选池为空无法做交叉对比和多维度反例P1登记候选 + quick scan
OG-5evaluation/trading-matrix/ 不存在无评测 case、eval schema、run evidenceP2defer 到产品定义 / MVP 阶段
OG-6checkpoints/2026-05-13-current-session-recovery.md 为纯会话恢复临时产物,无持久价值目录噪声P3后续清理批次 archive 或删除
OG-7state.md §10 未吸收 Checkpoints 列表未更新 rewrite-dispatch-pickup checkpointController 恢复时可能遗漏 rewrite lane 状态P1本次 audit 落盘后更新 state.md

7.3 执行治理专项 Open Gaps(从实践画像中提取)

以下 gaps 来自 current-practice-profile.md Batch 4-6,但尚未被 current-state.mdproject-anchor.md 显式登记为治理缺口:

#Gap治理层风险等级来源
EG-1/api/event/receive webhook 无路由层 JWT、无 DataHorizon token 校验、无重放保护授权执行practice-profile Batch 5
EG-2/api/admin/test-querystrings.HasPrefix(trimmed, "SELECT") 限制 SQL,无 JWT授权执行practice-profile Batch 5
EG-3AutoStartRunningTraders 服务启动时自动恢复 is_running=1 的交易员,无当次人工确认禁止漂移practice-profile Batch 5
EG-4SL/TP 设置失败不阻断已完成开仓,产生"未保护仓位"状态风控practice-profile Batch 4
EG-5VerifyOtpLogic 打印 OTP secret 和输入 code审计practice-profile Batch 5
EG-6SessionMiddleware 存在但未在 server 注册授权practice-profile Batch 5
EG-7event-backtest task/signal 接口无对象级 user 校验授权practice-profile Batch 5
EG-8GetPositionEvent 无显式 authz.CanReadTrader,通过 position_id 反查存在跨用户风险授权practice-profile Batch 4/5
EG-9DebateExecute 后端未接入真实执行但前端 mock 返回 success禁止漂移practice-profile Batch 5/6
EG-10前端 trader start/stop 无二次确认、无真实交易模式确认授权执行practice-profile Batch 6

这些 gaps 在工程仓库中需要修复,在治理仓库中需要在后续 current-state.md rewrite-lite 或 execution governance evidence index 中显式标注。


8. 总结

8.1 IA 结论

AI Trading Matrix 在治理库中的目录结构是 5 个项目中最扁平、最小的。4 个项目正文 + 4 个参考评估文档的 IA 清晰度高于平均水平。核心问题不是 IA 混乱,而是:

  1. 参考评估证据不足:NOFX 评估只到 Batch 2,外部候选为空,reference-evaluation-first 约束未实质满足。
  2. current-state.md 滞后:落后于实践画像和参考评估进展约一周。
  3. 执行治理标注缺乏结构化映射:丰富的治理证据散落在 practice profile Batch 4-6 中,没有按 canonical 定义的 4 层体系做索引。

8.2 本批建议改造优先级

优先级改造类型前置条件
1继续 NOFX 深评估 Batch 3+内容产出无(工程仓库 + NOFX 仓库已就绪)
2current-state.md rewrite-lite正文更新本 audit 落盘
3外部参考候选登记 + quick scan内容产出
4external-reference-candidate-scan.md rename(N-1)IA 归一Admin rename 联动
5state.md 更新(吸收 checkpoints + 本 audit)Controller 维护本 audit 落盘
6执行治理 4 层映射表结构化标注current-state.md rewrite-lite 同步

8.3 不做事项

  • 不恢复 projects/trading-matrix/CONTEXT.md 为入口。
  • 不创建产品定义 / MVP / PRD(参考评估未充分)。
  • 不把工程进展伪装为文档进展(FR-016 / FR-008)。
  • 不直接修改公共入口(INDEX / sidebars / manifest / llms)。
  • 不在 audit 完成前批量 rename 或合并文件。
  • 不改其他项目目录或正式事实。