Cách dùng

Một lệnh ra báo cáo, vài lệnh để kiểm lại

Bạn làm hai việc: chạy một lần nghiên cứu trên snapshot tổng hợp, rồi kiểm báo cáo khớp đúng đầu vào bằng manifest.

Chạy một lần nghiên cứu

Dùng khi bạn có một snapshot giá tổng hợp và muốn có báo cáo. Nói với agent: «Chạy fund_research với snapshot mẫu, thư mục làm việc trong %TEMP%, tên lần chạy demo, rồi tóm tắt báo cáo.»

Tạo thư mục làm việc mới

Thư mục phải có sẵn, nằm ngoài mã nguồn, trên ổ cục bộ.

Chạy từ thư mục mã nguồn

Mỗi lần chạy cần một tên mới, chỉ gồm chữ ASCII, số, gạch ngang, gạch dưới.

PowerShell

$workspace = Join-Path $env:TEMP 'investing-demo-workspace'
New-Item -ItemType Directory -Path $workspace
python -m fund_research --input tests/fixtures/snapshot.json --workspace $workspace --run-name demo

Đọc kết quả

Lệnh chạy xong không in gì và trả mã thoát 0.

Đầu ra: thư mục demo trong workspace, gồm report.json (phân tích, nguồn, đơn vị, dự báo, giới hạn) và manifest.json (SHA-256 của đầu vào và báo cáo).

Tham số của lệnh

Lệnh duy nhất là python -m fund_research.

Tham số	Việc	Bắt buộc	Ví dụ
`--input`	File snapshot JSON tổng hợp, trên ổ cục bộ.	Có	`tests/fixtures/snapshot.json`
`--workspace`	Thư mục làm việc có sẵn, ngoài mã nguồn.	Có	`$workspace`
`--run-name`	Tên lần chạy, phải mới; tên đã có bị từ chối.	Có	`demo`
`--horizon`	Số bước dự báo trong hợp đồng, 1 đến 512. Không bật model.	Không, mặc định 1	`24`

Ví dụ đầu-cuối

Chạy trong cùng cửa sổ PowerShell sau bước tạo $workspace ở trên.

Xem kết luận của snapshot mẫu

Giá mẫu tăng 10% giữa hai nến cuối nên vượt ngưỡng minh hoạ 5%, và nến cuối có volume bằng 0.

PowerShell

$report = Get-Content (Join-Path $workspace 'demo\report.json') | ConvertFrom-Json
$report.analysis | Select-Object risk_status, return_value, warnings, mandate_status
# BREACH · 0.1 · ZERO_VOLUME · REVIEW_REQUIRED
$report.forecast.status
# unavailable

Kiểm báo cáo khớp đầu vào

Băm lại hai file và so với manifest; cả hai dòng phải là True.

PowerShell

$run = Join-Path $workspace 'demo'
$m = Get-Content (Join-Path $run 'manifest.json') | ConvertFrom-Json
(Get-FileHash tests/fixtures/snapshot.json).Hash -eq $m.input_sha256
(Get-FileHash (Join-Path $run 'report.json')).Hash -eq $m.report_sha256

Từ điển đầu ra

Những giá trị bạn sẽ gặp trong báo cáo và thông báo lỗi.

BREACH / WITHIN_DEMO_THRESHOLD: Biến động giữa hai nến cuối vượt hoặc không vượt ngưỡng minh hoạ 5%. Ngưỡng là ví dụ kỹ thuật, không phải ngưỡng đầu tư.
ZERO_VOLUME: Một trong hai nến cuối có volume bằng 0.
REVIEW_REQUIRED / UNKNOWN: Mandate luôn cần người xem xét; tuân thủ danh mục luôn chưa biết. Công cụ không tự kết luận đạt.
unavailable: Dự báo không có vì chưa cấu hình model; không có con số nào được bịa ra.
Mã thoát 0 · 2 · 3: Thành công · đầu vào, thư mục làm việc hoặc nền tảng không hợp lệ · không xuất được, ví dụ tên lần chạy đã có.
path, json, schema, stale, temporal, workspace, write: Một số mã lỗi ngắn hay gặp, in sau Invalid input: hoặc Unable to publish output:: file đầu vào không phải file local thường (ví dụ trên OneDrive), sai cú pháp, sai cấu trúc, nến cuối quá hạn, sai thứ tự thời gian, thư mục làm việc không hợp lệ, không ghi được. Thông báo không lặp lại dữ liệu hay đường dẫn.

Hỏi đáp

Chạy lại lệnh cũ thì báo Unable to publish output: write?

Đổi --run-name sang tên mới. Công cụ không bao giờ ghi đè lần chạy đã có.

Tôi dùng dữ liệu giá thật được không?

Không. Snapshot phải khai báo nguồn tổng hợp (synthetic); công cụ không đọc dữ liệu live hay kết nối mạng.

Đặt --horizon lớn có ra dự báo không?

Không. Đây chỉ là tham số của hợp đồng dự báo; dự báo vẫn là unavailable.

Muốn biết công cụ kiểm những gì?

Xem từng bước của một lần chạy và chỗ công cụ dừng lại.

Xem luồng & quy trình Đọc tài liệu