xtb2sure
XTB转换 .xlsx 出口到 Sure.am-兼容的CSV文件。
它是做什么的
- 读取
Cash Operations从XTB导出工作簿中获取。 - 生成两个CSV文件：
- 交易CSV (
date,amount,name,account,notes） - 投资CSV (
date,ticker,currency,qty,price,account,name）
- 交易CSV (
要求
- node . js 24 +
安装
使用npm全局安装：
npm install -g @jaskrowo/xtb2sure
这使得 xtb2sure 命令在您的系统上随处可用。
使用
xtb2sure convert <input.xlsx> --currency <CODE> --account "<ACCOUNT_NAME>"
选项:
--out-dir <dir>-默认文件名的输出目录（默认为输入文件的目录）--transactions-out <file>-事务CSV路径--investments-out <file>-投资CSV路径--strict-第一次转换失败--dry-run—不写输出文件--report <file>-将转换报告JSON写入文件--config <file>-配置文件路径(默认为~/.config/xtb2sure/config.json）
示例：
xtb2sure convert report.xlsx --currency USD --account "XTB IKE"
xtb2sure convert report.xlsx --currency PLN --account "XTB PLN" --out-dir ./out
配置
一些XTB代码与Sure使用的代码不同。我的供应商。您可以通过JSON配置文件覆盖导出的计时器 ~/.config/xtb2sure/config.json (或 $XDG_CONFIG_HOME/xtb2sure/config.json 当设置):
{
"tickerOverrides": {
"IPOL.UK": "IPOL.L"
}
}
键是XTB代码，值是Sure。是股票。覆盖只适用于投资CSV；不匹配的代码将原封不动地导出。
使用 --config <file> 从其他位置加载配置文件。
退出代码
0成功1转换或验证失败2使用或配置错误
开发
克隆存储库并安装依赖项：
git clone https://github.com/domeq/xtb2sure.git
cd xtb2sure
npm install
直接从源代码运行CLI -不需要构建步骤（Node.js会本地运行TypeScript）：
node src/cli.ts convert report.xlsx --currency USD --account "XTB IKE"
您可以这样使用任何CLI标志，例如： node src/cli.ts --version.
生成所需的编译输出 dist/，发布的包使用它)：
npm run build
运行测试（Node.js测试运行器）：
npm test
运行检查和类型检查：
npm run lint
npm run typecheck