{
  "markdown": "# Fund Assistant / 基金投资助手\n\nA Claude Code skill for Chinese mutual fund investment management.\n\n一个用于中国公募基金投资管理的 Claude Code 技能。\n\n---\n\n## English\n\n### Overview\n\nFund Assistant is a comprehensive tool for querying fund data, managing investment portfolios, and tracking market trends. It integrates with Eastmoney APIs to provide real-time fund valuations, NAV data, and market information.\n\n### Features\n\n- **Fund Query**: Real-time NAV estimates, historical NAV, fund details\n- **Fund Search**: Search funds by name or code\n- **Portfolio Management**: Add/remove holdings, track cost basis, calculate returns\n- **Market Data**: Major indices, capital flow, northbound capital\n- **Multi-user Support**: Isolated data storage for different users\n- **Import/Export**: Backup and restore portfolio data\n\n### Quick Start\n\n```bash\n# Initialize data directory\npython scripts/portfolio.py init\n\n# Query fund real-time valuation\npython scripts/fund_api.py query 001618\n\n# Add a holding (code, shares, cost)\npython scripts/portfolio.py add 001618 1000 1.5\n\n# View portfolio\npython scripts/portfolio.py list\n```\n\n### Scripts\n\n| Script | Purpose |\n|--------|---------|\n| `scripts/fund_api.py` | Fund data API (query, search, history, positions) |\n| `scripts/portfolio.py` | Portfolio management (add, update, remove, export) |\n\n### Data Storage\n\nData is stored in `.fund-assistant/` directory (relative to the script's parent directory by default).\n\nYou can override the workspace path via environment variable:\n```bash\nexport FUND_WORKSPACE=/path/to/workspace\n```\n\nDirectory structure:\n```\n.fund-assistant/\n├── config.json           # Global config (current user)\n└── users/\n    └── {username}/\n        ├── portfolio.json    # Holdings\n        └── transactions.json # Transaction history\n```\n\n---\n\n## 中文\n\n### 概述\n\n基金投资助手是一个综合性工具，用于查询基金数据、管理投资组合和跟踪市场趋势。它集成了东方财富 API，提供实时基金估值、净值数据和市场信息。\n\n### 功能特性\n\n- **基金查询**：实时估值、历史净值、基金详情\n- **基金搜索**：按名称或代码搜索基金\n- **持仓管理**：添加/删除持仓、记录成本、计算收益\n- **市场数据**：大盘指数、资金流向、北向资金\n- **多用户支持**：不同用户数据隔离存储\n- **导入导出**：备份和恢复持仓数据\n\n### 快速开始\n\n```bash\n# 初始化数据目录\npython scripts/portfolio.py init\n\n# 查询基金实时估值\npython scripts/fund_api.py query 001618\n\n# 添加持仓（代码、份额、成本）\npython scripts/portfolio.py add 001618 1000 1.5\n\n# 查看持仓\npython scripts/portfolio.py list\n```\n\n### 脚本说明\n\n| 脚本 | 用途 |\n|------|------|\n| `scripts/fund_api.py` | 基金数据 API（查询、搜索、历史、持仓） |\n| `scripts/portfolio.py` | 持仓管理（添加、更新、删除、导出） |\n\n### 常用命令\n\n#### 基金 API\n```bash\npython scripts/fund_api.py query 001618,000001   # 查询实时估值\npython scripts/fund_api.py search 白酒           # 搜索基金\npython scripts/fund_api.py detail 001618         # 基金详情\npython scripts/fund_api.py history 001618 y      # 历史净值\npython scripts/fund_api.py position 001618       # 持仓明细\npython scripts/fund_api.py manager 001618        # 基金经理\npython scripts/fund_api.py index                 # 大盘指数\npython scripts/fund_api.py flow                  # 资金流向\npython scripts/fund_api.py north                 # 北向资金\n```\n\n#### 持仓管理\n```bash\npython scripts/portfolio.py init                 # 初始化\npython scripts/portfolio.py list                 # 查看持仓\npython scripts/portfolio.py add 001618 1000 1.5  # 添加持仓\npython scripts/portfolio.py update 001618 shares=1500  # 更新\npython scripts/portfolio.py remove 001618        # 删除\npython scripts/portfolio.py user 老婆            # 切换用户\npython scripts/portfolio.py users                # 列出用户\npython scripts/portfolio.py export data.json     # 导出\npython scripts/portfolio.py import data.json     # 导入\n```\n\n### 数据存储\n\n数据默认存储在脚本所在目录的上级 `.fund-assistant/` 目录。\n\n可通过环境变量 `FUND_WORKSPACE` 指定工作目录：\n```bash\nexport FUND_WORKSPACE=/path/to/workspace\n```\n\n目录结构：\n```\n.fund-assistant/\n├── config.json           # 全局配置（当前用户）\n└── users/\n    └── {用户名}/\n        ├── portfolio.json    # 持仓数据\n        └── transactions.json # 交易记录\n```\n\n### 收益计算\n\n```\n当日收益 = (当前净值 - 昨日净值) × 持有份额\n持仓收益 = (当前净值 - 成本价) × 持有份额\n收益率 = (当前净值 - 成本价) / 成本价 × 100%\n```\n\n### 注意事项\n\n1. 首次使用需运行 `portfolio.py init` 初始化\n2. 交易时段：9:30-11:30, 13:00-15:00（工作日）\n3. 净值通常在交易日 18:00-22:00 公布\n\n---\n\n## License\n\nMIT\n",
  "bytes": 3999,
  "sha": "c7fa82bac3c5c4464de61b45e3105f1224519b713f3d2888988cfbac701fd5ac",
  "repo_slug": "xer97/fund-assistant",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_xer97_fund_assistant_fund_assistant_648c4601/readme"
}