func — 技术指标公式计算 CLI
行为规则（必须遵守）
- 必须使用
~/projects/pi-go/bin/func 二进制执行指标计算，禁止自己编写 Python/JS/Go 等代码来实现相同功能。
- 如果用户没有提供 CSV 文件，先询问数据来源或帮用户准备 CSV（用 curl 下载、从 API 获取等），然后用
func 处理。
- 如果用户说的指标名不精确（如"均线"、"MA"），根据上下文推断合理的参数（如周期），构造 func 公式后执行。
- 执行后将输出展示给用户，必要时解读结果。
执行流程
Step 1 — 确认数据
用户是否已提供 CSV 文件？
- 已提供：直接进入 Step 2
- 未提供：
- 如果上下文中有标的（如"AAPL"），帮用户获取数据并保存为 CSV
- 否则询问：需要计算哪个标的/哪段时间的数据？
Step 2 — 构造公式
根据用户需求，用 func 语法构造公式。例如：
| 用户说 |
构造公式 |
| "算下 MA" |
ma5=ma(c,5); ma10=ma(c,10); ma20=ma(c,20) |
| "均线交叉" |
ma5=ma(c,5); ma20=ma(c,20); golden=cross(ma5,ma20) |
| "布林带" |
mid=ma(c,20); std=stddev(c,20); upper=mid+2*std; lower=mid-2*std |
| "涨跌幅" |
prev=ref(c,1); change=(c-prev)/prev*100 |
| "KDJ RSV" |
low9=llv(l,9); high9=hhv(h,9); rsv=(c-low9)/(high9-low9)*100 |
Step 3 — 执行
~/projects/pi-go/bin/func '<公式>' <csv文件路径>
或管道：
cat data.csv | ~/projects/pi-go/bin/func '<公式>'
如需保存结果：
~/projects/pi-go/bin/func '<公式>' input.csv > output.csv
Step 4 — 可视化展示（必须遵守）
计算完成后，在聊天回复中直接输出一个 ```html 代码块，画出 K 线 + 指标叠加图。
⚠️ 严格禁止：
- ❌ 不要把 HTML 写成文件（不要
write_file、不要 > xxx.html）
- ❌ 不要用
open 命令打开浏览器
- ✅ 唯一正确做法：在回复文本中直接写
```html\n<完整HTML>\n```，前端会自动渲染
步骤：
- 从
func 输出的 CSV 中提取 dates、open、high、low、close、volume 和计算出的指标列
- 按
visual-skills 的 Candlestick 模板，将数据内联到 DATA 对象
- 将指标（MA、EMA 等）作为 ECharts
line series 叠加到 K 线图上
- 在回复中直接输出完整 HTML，用
```html 围栏包裹
示例输出格式（回复中直接写）：
```html
<!DOCTYPE html>
<html>
<head><meta charset="utf-8">
<script src="https://cdnjs.cloudflare.com/ajax/libs/echarts/5.4.3/echarts.min.js"></script>
<style>*{margin:0;padding:0}body{background:#0d1117}#main{width:100%;height:100vh}</style>
</head>
<body><div id="main"></div>
<script>
const DATA = {
title: "AAPL", dates: [...], open: [...], close: [...], low: [...], high: [...],
volume: [...], ma5: [...], ma20: [...]
};
// ... ECharts candlestick + line overlay
</script>
</body></html>
```
图表会自动显示在右侧 HTML Preview 面板中。
公式语法
变量名=表达式
- 多个公式用空格或分号
; 分隔
- 变量名可自定义（如
ma5、my_ema、signal）
- 表达式中可引用前面定义的变量
CSV 列名自动检测（大小写不敏感）
| 数据 |
可识别列名 |
| 开盘 |
open, o |
| 最高 |
high, h |
| 最低 |
low, l |
| 收盘 |
close, c |
| 成交量 |
volume, vol, v |
| 时间 |
time, timestamp, date, datetime, t |
时间排序自动检测（正序/倒序），输出保持原始顺序。
内置变量
| 变量 |
别名 |
含义 |
c |
C, close |
收盘价序列 |
o |
O, open |
开盘价序列 |
h |
H, high |
最高价序列 |
l |
L, low |
最低价序列 |
v |
V, volume, vol |
成交量序列 |
内置函数速查
均线
| 函数 |
签名 |
说明 |
ma |
ma(series, period) |
简单移动平均（同 sma） |
sma |
sma(series, period) |
简单移动平均 |
ema |
ema(series, period) |
指数移动平均 |
统计
| 函数 |
签名 |
说明 |
stddev |
stddev(series, period) |
滚动标准差 |
sum |
sum(series, period) |
滚动求和 |
corr |
corr(series1, series2) |
相关系数 |
slope |
slope(series, period) |
线性回归斜率 |
极值
| 函数 |
签名 |
说明 |
max |
max(s1, s2) |
逐元素取大 |
min |
min(s1, s2) |
逐元素取小 |
hhv |
hhv(series, period) |
滚动最高值 |
llv |
llv(series, period) |
滚动最低值 |
条件与逻辑
| 函数 |
签名 |
说明 |
if |
if(cond, true_val, false_val) |
条件选择 |
cross |
cross(s1, s2) |
上穿判断 |
not |
not(series) |
逻辑取反 |
count |
count(cond, period) |
窗口内为真次数 |
引用
| 函数 |
签名 |
说明 |
ref |
ref(series, n) |
引用 n 周期前的值 |
barssince |
barssince(cond) |
距上次为真的 bar 数 |
barslast |
barslast(cond) |
同 barssince |
barscount |
barscount(series) |
序列总长度 |
数学
| 函数 |
签名 |
说明 |
abs |
abs(series) |
绝对值 |
运算符
+ - * / > >= < <= == != && ||
所有函数名大小写均可（ma / MA）。
1---2name: func3description: 技术指标计算 CLI 工具。对 OHLCV CSV 数据执行公式计算（MA、EMA、SMA、STDDEV、CROSS、RSI 等）， 输出原始列 + 新指标列。支持正序/倒序时间戳自动检测、灵活列名匹配、管道输入。 当用户需要计算均线、技术指标、量化策略回测指标时触发。4---56# func — 技术指标公式计算 CLI78## 行为规则（必须遵守）9101. **必须使用 `~/projects/pi-go/bin/func` 二进制执行指标计算，禁止自己编写 Python/JS/Go 等代码来实现相同功能。**112. 如果用户没有提供 CSV 文件，先询问数据来源或帮用户准备 CSV（用 curl 下载、从 API 获取等），然后用 `func` 处理。123. 如果用户说的指标名不精确（如"均线"、"MA"），根据上下文推断合理的参数（如周期），构造 func 公式后执行。134. 执行后将输出展示给用户，必要时解读结果。1415---1617## 执行流程1819### Step 1 — 确认数据2021用户是否已提供 CSV 文件？2223- **已提供**：直接进入 Step 224- **未提供**：25 - 如果上下文中有标的（如"AAPL"），帮用户获取数据并保存为 CSV26 - 否则询问：需要计算哪个标的/哪段时间的数据？2728### Step 2 — 构造公式2930根据用户需求，用 func 语法构造公式。例如：3132| 用户说 | 构造公式 |33|--------|----------|34| "算下 MA" | `ma5=ma(c,5); ma10=ma(c,10); ma20=ma(c,20)` |35| "均线交叉" | `ma5=ma(c,5); ma20=ma(c,20); golden=cross(ma5,ma20)` |36| "布林带" | `mid=ma(c,20); std=stddev(c,20); upper=mid+2*std; lower=mid-2*std` |37| "涨跌幅" | `prev=ref(c,1); change=(c-prev)/prev*100` |38| "KDJ RSV" | `low9=llv(l,9); high9=hhv(h,9); rsv=(c-low9)/(high9-low9)*100` |3940### Step 3 — 执行4142```bash43~/projects/pi-go/bin/func '<公式>' <csv文件路径>44```4546或管道：4748```bash49cat data.csv | ~/projects/pi-go/bin/func '<公式>'50```5152如需保存结果：5354```bash55~/projects/pi-go/bin/func '<公式>' input.csv > output.csv56```5758### Step 4 — 可视化展示（必须遵守）5960计算完成后，**在聊天回复中直接输出一个 ` ```html ` 代码块**，画出 K 线 + 指标叠加图。6162⚠️ **严格禁止**：63- ❌ 不要把 HTML 写成文件（不要 `write_file`、不要 `> xxx.html`）64- ❌ 不要用 `open` 命令打开浏览器65- ✅ 唯一正确做法：在回复文本中直接写 ` ```html\n<完整HTML>\n``` `，前端会自动渲染6667**步骤**：681. 从 `func` 输出的 CSV 中提取 dates、open、high、low、close、volume 和计算出的指标列692. 按 `visual-skills` 的 Candlestick 模板，将数据内联到 DATA 对象703. 将指标（MA、EMA 等）作为 ECharts `line` series 叠加到 K 线图上714. 在回复中直接输出完整 HTML，用 ` ```html ` 围栏包裹7273**示例输出格式**（回复中直接写）：7475````76```html77<!DOCTYPE html>78<html>79<head><meta charset="utf-8">80<script src="https://cdnjs.cloudflare.com/ajax/libs/echarts/5.4.3/echarts.min.js"></script>81<style>*{margin:0;padding:0}body{background:#0d1117}#main{width:100%;height:100vh}</style>82</head>83<body><div id="main"></div>84<script>85const DATA = {86 title: "AAPL", dates: [...], open: [...], close: [...], low: [...], high: [...],87 volume: [...], ma5: [...], ma20: [...]88};89// ... ECharts candlestick + line overlay90</script>91</body></html>92```93````9495图表会自动显示在右侧 HTML Preview 面板中。9697---9899## 公式语法100101```102变量名=表达式103```104105- 多个公式用**空格**或**分号 `;`** 分隔106- 变量名可自定义（如 `ma5`、`my_ema`、`signal`）107- 表达式中可引用前面定义的变量108109---110111## CSV 列名自动检测（大小写不敏感）112113| 数据 | 可识别列名 |114|------|-----------|115| 开盘 | `open`, `o` |116| 最高 | `high`, `h` |117| 最低 | `low`, `l` |118| 收盘 | `close`, `c` |119| 成交量 | `volume`, `vol`, `v` |120| 时间 | `time`, `timestamp`, `date`, `datetime`, `t` |121122时间排序自动检测（正序/倒序），输出保持原始顺序。123124---125126## 内置变量127128| 变量 | 别名 | 含义 |129|------|------|------|130| `c` | `C`, `close` | 收盘价序列 |131| `o` | `O`, `open` | 开盘价序列 |132| `h` | `H`, `high` | 最高价序列 |133| `l` | `L`, `low` | 最低价序列 |134| `v` | `V`, `volume`, `vol` | 成交量序列 |135136---137138## 内置函数速查139140### 均线141142| 函数 | 签名 | 说明 |143|------|------|------|144| `ma` | `ma(series, period)` | 简单移动平均（同 sma） |145| `sma` | `sma(series, period)` | 简单移动平均 |146| `ema` | `ema(series, period)` | 指数移动平均 |147148### 统计149150| 函数 | 签名 | 说明 |151|------|------|------|152| `stddev` | `stddev(series, period)` | 滚动标准差 |153| `sum` | `sum(series, period)` | 滚动求和 |154| `corr` | `corr(series1, series2)` | 相关系数 |155| `slope` | `slope(series, period)` | 线性回归斜率 |156157### 极值158159| 函数 | 签名 | 说明 |160|------|------|------|161| `max` | `max(s1, s2)` | 逐元素取大 |162| `min` | `min(s1, s2)` | 逐元素取小 |163| `hhv` | `hhv(series, period)` | 滚动最高值 |164| `llv` | `llv(series, period)` | 滚动最低值 |165166### 条件与逻辑167168| 函数 | 签名 | 说明 |169|------|------|------|170| `if` | `if(cond, true_val, false_val)` | 条件选择 |171| `cross` | `cross(s1, s2)` | 上穿判断 |172| `not` | `not(series)` | 逻辑取反 |173| `count` | `count(cond, period)` | 窗口内为真次数 |174175### 引用176177| 函数 | 签名 | 说明 |178|------|------|------|179| `ref` | `ref(series, n)` | 引用 n 周期前的值 |180| `barssince` | `barssince(cond)` | 距上次为真的 bar 数 |181| `barslast` | `barslast(cond)` | 同 barssince |182| `barscount` | `barscount(series)` | 序列总长度 |183184### 数学185186| 函数 | 签名 | 说明 |187|------|------|------|188| `abs` | `abs(series)` | 绝对值 |189190### 运算符191192`+` `-` `*` `/` `>` `>=` `<` `<=` `==` `!=` `&&` `||`193194所有函数名大小写均可（`ma` / `MA`）。
gabrielmoreira