change v1

2026-07-09 14:00:57 +08:00 · 2026-04-25 16:18:45 +08:00
parent 737f9bca95
commit c244e4cdf1
89 changed files with 17382 additions and 6198 deletions
--- a/docs/qa/AGENT_SKILL_ACCEPTANCE_CHECKLIST.zh-CN.md
+++ b/docs/qa/AGENT_SKILL_ACCEPTANCE_CHECKLIST.zh-CN.md
@@ -0,0 +1,272 @@
+# Agent 4 Skill 验收清单
+
+本文档用于验收 Agent 对 4 个管理类 skill 的字段认知、工具调用和用户可见行为是否与页面编辑能力对齐。
+
+当前范围：
+- `model_management`
+- `exchange_management`
+- `trader_management`
+- `strategy_management`
+
+验收目标：
+- 页面上能手动改的核心字段，Agent 也能稳定改
+- Agent 能回答页面上可见的字段与选项
+- 模糊请求不会被硬塞进错误 skill
+- 多字段一句话更新时，不会被窄动作截断
+
+## 0. 前置条件
+
+- 已完成登录
+- 后端已启动
+- 至少准备 1 条可编辑的模型、交易所、交易员、策略数据
+- 测试前如果有旧上下文，先在 Agent 会话里执行 `/clear`
+
+建议先跑自动化回归：
+
+```bash
+go test ./agent -run 'Test(ManageModelToolSchemaExposesEditableFields|ManageExchangeToolSchemaExposesEditableFields|ManageTraderToolSchemaExposesAdvancedFields|ManageStrategyToolSchemaExposesFieldLevelConfig|ModelManagementManualEditableFieldsAreCoveredByAgent|ExchangeManagementManualEditableFieldsAreCoveredByAgent|TraderManagementManualEditableFieldsAreCoveredByAgent|StrategyManagementManualEditableFieldsAreCoveredByAgent|ExchangeManagementUpdateSupportsManualFields|ModelManagementThinkAndActSupportsCompositeFieldUpdates|TraderManagementUpdateSupportsAdvancedManualFields|StrategyManagementThinkAndActSupportsGridAndRiskFields)'
+```
+
+对应测试主要在：
+- [skill_dispatcher_test.go](/Users/zheweifang/Desktop/Nofx2/nofxi-dev/agent/skill_dispatcher_test.go)
+- [config_tools_test.go](/Users/zheweifang/Desktop/Nofx2/nofxi-dev/agent/config_tools_test.go)
+
+## 1. 自动化覆盖基线
+
+通过以下检查后，才进入手工验收：
+
+- [ ] 4 个 skill 的 tool schema 已暴露字段级参数
+- [ ] 4 个 skill 的 manual editable field 集合都被 agent 字段目录覆盖
+- [ ] `model` 支持一句话同时改 `enabled + custom_api_url + custom_model_name`
+- [ ] `exchange` 支持一句话同时改 `account_name + hyperliquid_wallet_addr + testnet`
+- [ ] `trader` 支持高级字段更新
+- [ ] `strategy` 支持 grid/risk 多字段更新
+
+## 2. Model Skill
+
+页面参考：
+- [ModelConfigModal.tsx](/Users/zheweifang/Desktop/Nofx2/nofxi-dev/web/src/components/trader/ModelConfigModal.tsx)
+
+核心字段：
+- `provider`
+- `name`
+- `api_key`
+- `custom_api_url`
+- `custom_model_name`
+- `enabled`
+
+手工验收：
+
+- [ ] 说“列出我的模型配置”时，能列出当前模型
+- [ ] 说“这个模型的接口地址改成 xxx，模型名称改成 yyy，并且禁用”时，能一次成功更新
+- [ ] 说“这个模型有哪些字段能改”时，回答至少覆盖 `API Key / 接口地址 / 模型名称 / 启用状态`
+- [ ] 说“把这个模型启用”时，不会误触发重命名流程
+- [ ] 说“把这个模型改成最好的”这类抽象诉求时，不应硬造字段值；应该解释或引导
+
+通过标准：
+- 回复文本明确说明已更新模型配置
+- 页面刷新后字段真实变化
+- 不出现“我还需要你明确要操作哪个对象”这种错误兜底
+
+## 3. Exchange Skill
+
+页面参考：
+- [ExchangeConfigModal.tsx](/Users/zheweifang/Desktop/Nofx2/nofxi-dev/web/src/components/trader/ExchangeConfigModal.tsx)
+
+核心字段：
+- 公共字段：
+  - `exchange_type`
+  - `account_name`
+  - `enabled`
+  - `testnet`
+- CEX:
+  - `api_key`
+  - `secret_key`
+  - `passphrase`
+- Hyperliquid:
+  - `api_key`
+  - `hyperliquid_wallet_addr`
+- Aster:
+  - `aster_user`
+  - `aster_signer`
+  - `aster_private_key`
+- Lighter:
+  - `lighter_wallet_addr`
+  - `lighter_api_key_private_key`
+  - `lighter_api_key_index`
+
+手工验收：
+
+- [ ] 说“把 Dex 的账户名改成 Dex Pro，Hyperliquid 钱包改成 0xabc，testnet 打开”时，能一次成功更新
+- [ ] 说“这个交易所有哪些字段能改”时，能按当前交易所类型回答差异字段
+- [ ] 说“把这个交易所禁用”时，不会误进入改名分支
+- [ ] 说“列出我的交易所配置”时，能读出当前配置
+- [ ] 对缺少必填凭证的创建请求，会明确指出缺哪一项，而不是模糊失败
+
+通过标准：
+- 回复文本明确说明已更新交易所配置
+- 页面刷新后对应字段真实变化
+- 不因为对象解析失败而掉到“请明确对象”
+
+## 4. Trader Skill
+
+页面参考：
+- [TraderConfigModal.tsx](/Users/zheweifang/Desktop/Nofx2/nofxi-dev/web/src/components/trader/TraderConfigModal.tsx)
+
+页面核心字段：
+- `name`
+- `ai_model_id`
+- `exchange_id`
+- `strategy_id`
+- `is_cross_margin`
+- `show_in_competition`
+- `scan_interval_minutes`
+- `initial_balance`
+
+Agent 扩展字段：
+- `btc_eth_leverage`
+- `altcoin_leverage`
+- `trading_symbols`
+- `custom_prompt`
+- `override_base_prompt`
+- `system_prompt_template`
+- `use_ai500`
+- `use_oi_top`
+
+手工验收：
+
+- [ ] 说“把交易员 A 切换到策略 B，扫描间隔改成 8 分钟，全仓关闭，竞技场显示关闭”时，能一次成功更新
+- [ ] 说“把高级交易员的 BTC/ETH 杠杆改成 8，山寨币杠杆改成 4，交易对改成 BTC、ETH，自定义 prompt 改成 xxx，启用 AI500”时，能成功更新
+- [ ] 说“这个交易员有哪些字段能改”时，至少能回答页面核心字段和 Agent 扩展字段
+- [ ] 说“启动这个交易员”时，仍会保留高风险确认链路
+- [ ] 说“为什么我的交易员不交易”时，仍能走诊断 skill，不会被错误识别成 update
+
+通过标准：
+- 回复文本明确说明更新了交易员配置或绑定
+- 页面刷新或查询结果能看到真实变化
+- `交易对` 提取不会误吞后半句自然语言
+
+## 5. Strategy Skill
+
+页面参考：
+- [StrategyStudioPage.tsx](/Users/zheweifang/Desktop/Nofx2/nofxi-dev/web/src/pages/StrategyStudioPage.tsx)
+
+编辑器模块：
+- `grid_config`
+- `coin_source`
+- `indicators`
+- `risk_control`
+- `prompt_sections`
+- `custom_prompt`
+- `publish_settings`
+
+重点字段：
+- 元信息：
+  - `name`
+  - `description`
+  - `strategy_type`
+  - `is_public`
+  - `config_visible`
+- Grid:
+  - `symbol`
+  - `grid_count`
+  - `total_investment`
+  - `upper_price`
+  - `lower_price`
+  - `use_atr_bounds`
+  - `atr_multiplier`
+  - `distribution`
+  - `enable_direction_adjust`
+  - `direction_bias_ratio`
+  - `max_drawdown_pct`
+  - `stop_loss_pct`
+  - `daily_loss_limit_pct`
+  - `use_maker_only`
+- Coin source:
+  - `source_type`
+  - `static_coins`
+  - `excluded_coins`
+  - `use_ai500`
+  - `ai500_limit`
+  - `use_oi_top`
+  - `oi_top_limit`
+  - `use_oi_low`
+  - `oi_low_limit`
+- Risk:
+  - `max_positions`
+  - `min_confidence`
+  - `min_risk_reward_ratio`
+  - `btceth_max_leverage`
+  - `altcoin_max_leverage`
+  - `btceth_max_position_value_ratio`
+  - `altcoin_max_position_value_ratio`
+  - `max_margin_usage`
+  - `min_position_size`
+- Indicators / timeframe:
+  - `primary_timeframe`
+  - `primary_count`
+  - `selected_timeframes`
+  - `ema_periods`
+  - `rsi_periods`
+  - `atr_periods`
+  - `boll_periods`
+  - `enable_ema`
+  - `enable_macd`
+  - `enable_rsi`
+  - `enable_atr`
+  - `enable_boll`
+  - `enable_volume`
+  - `enable_oi`
+  - `enable_funding_rate`
+- Prompt:
+  - `role_definition`
+  - `trading_frequency`
+  - `entry_standards`
+  - `decision_process`
+  - `custom_prompt`
+
+手工验收：
+
+- [ ] 说“把策略 A 改成网格策略，网格数量改成 14，ATR 倍数改成 2.5，最大保证金使用率改成 0.6”时，能一次成功更新
+- [ ] 说“把选币来源改成静态，静态币改成 BTC、ETH，排除 DOGE，AI500 关闭”时，能成功更新
+- [ ] 说“选币来源有哪些”时，能回答当前面板的来源类型与相关选项，而不是重复草稿摘要
+- [ ] 说“这个策略里面的参数和 prompt 分别是什么样的”时，能走 explain/detail，不会误更新
+- [ ] 说“帮我创建一个不亏钱的策略”这类抽象请求时，不应直接强绑到字段创建；应该回退 planner 或引导细化
+
+通过标准：
+- 回复文本明确说明已更新策略参数或进入合理引导
+- Strategy Studio 刷新后真实反映更新
+- 不会把开放式目标误当作已可执行的精确配置
+
+## 6. 跨 Skill 语义验收
+
+- [ ] 模糊输入先过统一语义网关，再决定 `continue_active / resume_snapshot / start_new`
+- [ ] 一个 skill 进行中时，问页面字段选项，优先走 explain，不要硬落 execute
+- [ ] 开放式目标型请求在参数不足时，优先回 planner，不要强行进 hard skill
+- [ ] 同一句话改多个字段时，不会只改其中一个窄字段
+- [ ] `/clear` 后，旧的 skill session / workflow / execution state / snapshots 都被清空
+- [ ] 切回旧话题时，snapshot restore 能恢复到正确对象，而不是凭 heuristics 误接
+
+## 7. 回归记录模板
+
+每次验收建议记录：
+
+- 日期：
+- 提交版本：
+- 后端 PID：
+- 前端地址：
+- 本轮执行人：
+
+逐项记录：
+- 用例：
+- 用户原话：
+- 预期：
+- 实际：
+- 是否通过：
+- 备注：
+
+## 8. 当前结论口径
+
+当本文档第 1 节自动化基线和第 2-6 节核心手工项全部通过后，才建议对外宣称：
+
+“Agent 对 4 个 skill 已基本对齐当前页面可编辑能力，并具备稳定的 explain / execute / planner fallback 行为。”
--- a/docs/qa/fixtures/agent_self_play_seed.zh-CN.json
+++ b/docs/qa/fixtures/agent_self_play_seed.zh-CN.json
@@ -0,0 +1,38 @@
+{
+  "scenarios": [
+    {
+      "name": "trader_create_reports_all_missing_prereqs",
+      "desc": "空白环境下创建交易员，应一次性报告所有必填槽位和依赖缺口。",
+      "turns": [
+        {
+          "user": "帮我创建一个交易员",
+          "want_all": ["名称", "交易所", "模型", "策略", "当前还没有可用交易所配置", "当前还没有可用模型配置", "当前还没有可用策略"]
+        }
+      ]
+    },
+    {
+      "name": "strategy_update_risk_control_clamp_requires_acceptance",
+      "desc": "策略参数越界时，应先给出风控收敛说明，再等待确认应用。",
+      "setup": [
+        {
+          "tool": "manage_strategy",
+          "args": {
+            "action": "create",
+            "name": "风险策略",
+            "lang": "zh"
+          }
+        }
+      ],
+      "turns": [
+        {
+          "user": "把风险策略的杠杆改成100",
+          "want_any": ["手动面板允许的范围", "按风控范围收敛"]
+        },
+        {
+          "user": "确认应用",
+          "want_any": ["确认应用", "风控范围", "已更新策略参数"]
+        }
+      ]
+    }
+  ]
+}