panda-data-tools 0.0.1__tar.gz

panda_data_tools-0.0.1/.env

@@ -0,0 +1,6 @@
+PANDA_DATA_USERNAME=""
+PANDA_DATA_PASSWORD=""
+
+
+
+PYPI_API_TOKEN="pypi-AgEIcHlwaS5vcmcCJDExOTRmOTRjLTMxZWEtNDk3NS1hYzYxLTEwYzk2MGUyNWM5YgACKlszLCI4MmIzNjM0Yi0wYjk3LTQxMDYtYTAwYi1hNDhmMjk5MTJhNTMiXQAABiDThZRNeuQCxEbUZUr0VfVU07sxyygLH6tZFD_RYn1Esw"

panda_data_tools-0.0.1/.gitignore

@@ -0,0 +1,2 @@
+# 本地 API 凭证（全量接口测试）
+tests/local_credentials.py

panda_data_tools-0.0.1/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

panda_data_tools-0.0.1/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.9" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="panda-data" project-jdk-type="Python SDK" />
+</project>

panda_data_tools-0.0.1/.idea/panda-data.iml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="panda-data" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+  <component name="PyDocumentationSettings">
+    <option name="format" value="PLAIN" />
+    <option name="myDocStringFormat" value="Plain" />
+  </component>
+  <component name="TestRunnerService">
+    <option name="PROJECT_TEST_RUNNER" value="py.test" />
+  </component>
+</module>

panda_data_tools-0.0.1/.idea/vcs.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

panda_data_tools-0.0.1/.idea/workspace.xml

@@ -0,0 +1,232 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="3b25ef23-4048-4dd2-8008-78f06b201660" name="Changes" comment="projection commit">
+      <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="FileTemplateManagerImpl">
+    <option name="RECENT_TEMPLATES">
+      <list>
+        <option value="Python Script" />
+      </list>
+    </option>
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="GitHubPullRequestSearchHistory">{
+  &quot;lastFilter&quot;: {
+    &quot;state&quot;: &quot;OPEN&quot;,
+    &quot;assignee&quot;: &quot;S1mpleUser0618&quot;
+  }
+}</component>
+  <component name="GithubPullRequestsUISettings">{
+  &quot;selectedUrlAndAccountId&quot;: {
+    &quot;url&quot;: &quot;https://github.com/PandaAI-Tech/panda-data.git&quot;,
+    &quot;accountId&quot;: &quot;67658ba6-4085-425d-8327-6bd147249138&quot;
+  }
+}</component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 0
+}</component>
+  <component name="ProjectId" id="3B9fQ2gGN5xDs6yQBheKBdShq8S" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent">{
+  &quot;keyToString&quot;: {
+    &quot;ModuleVcsDetector.initialDetectionPerformed&quot;: &quot;true&quot;,
+    &quot;Python tests.pytest in test_all_apis.py.executor&quot;: &quot;Run&quot;,
+    &quot;Python.call_tool.executor&quot;: &quot;Run&quot;,
+    &quot;Python.test.executor&quot;: &quot;Run&quot;,
+    &quot;Python.test_all_apis.executor&quot;: &quot;Run&quot;,
+    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.TerminalTabsStorage.copyFrom.TerminalArrangementManager.252&quot;: &quot;true&quot;,
+    &quot;RunOnceActivity.git.unshallow&quot;: &quot;true&quot;,
+    &quot;git-widget-placeholder&quot;: &quot;main&quot;,
+    &quot;last_opened_file_path&quot;: &quot;/Users/lxh/PycharmProjects/panda-data&quot;
+  }
+}</component>
+  <component name="RecentsManager">
+    <key name="CopyFile.RECENT_KEYS">
+      <recent name="$PROJECT_DIR$" />
+    </key>
+  </component>
+  <component name="RunManager" selected="Python.test">
+    <configuration name="call_tool" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="panda-data" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/panda-data-skill/scripts" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/panda-data-skill/scripts/call_tool.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="main" type="PythonConfigurationType" factoryName="Python" nameIsGenerated="true">
+      <module name="panda-data" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/main.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="test" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="panda-data" />
+      <option name="ENV_FILES" value="$PROJECT_DIR$/.env" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/tests" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/tests/test.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="test_all_apis" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+      <module name="panda-data" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <envs>
+        <env name="PYTHONUNBUFFERED" value="1" />
+      </envs>
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/tests" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/tests/test_all_apis.py" />
+      <option name="PARAMETERS" value="" />
+      <option name="SHOW_COMMAND_LINE" value="false" />
+      <option name="EMULATE_TERMINAL" value="false" />
+      <option name="MODULE_MODE" value="false" />
+      <option name="REDIRECT_INPUT" value="false" />
+      <option name="INPUT_FILE" value="" />
+      <method v="2" />
+    </configuration>
+    <configuration name="pytest in test_all_apis.py" type="tests" factoryName="py.test" temporary="true" nameIsGenerated="true">
+      <module name="panda-data" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="_new_keywords" value="&quot;&quot;" />
+      <option name="_new_parameters" value="&quot;&quot;" />
+      <option name="_new_additionalArguments" value="&quot;&quot;" />
+      <option name="_new_target" value="&quot;$PROJECT_DIR$/tests/test_all_apis.py&quot;" />
+      <option name="_new_targetType" value="&quot;PATH&quot;" />
+      <method v="2" />
+    </configuration>
+    <list>
+      <item itemvalue="Python.main" />
+      <item itemvalue="Python.call_tool" />
+      <item itemvalue="Python.test" />
+      <item itemvalue="Python.test_all_apis" />
+      <item itemvalue="Python tests.pytest in test_all_apis.py" />
+    </list>
+    <recent_temporary>
+      <list>
+        <item itemvalue="Python.test" />
+        <item itemvalue="Python tests.pytest in test_all_apis.py" />
+        <item itemvalue="Python.call_tool" />
+        <item itemvalue="Python.test_all_apis" />
+      </list>
+    </recent_temporary>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-python-sdk-4e2b1448bda8-9a97661f3031-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-252.27397.106" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="3b25ef23-4048-4dd2-8008-78f06b201660" name="Changes" comment="" />
+      <created>1773906187094</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1773906187094</updated>
+    </task>
+    <task id="LOCAL-00001" summary="projection commit">
+      <option name="closed" value="true" />
+      <created>1774338964054</created>
+      <option name="number" value="00001" />
+      <option name="presentableId" value="LOCAL-00001" />
+      <option name="project" value="LOCAL" />
+      <updated>1774338964054</updated>
+    </task>
+    <task id="LOCAL-00002" summary="projection commit">
+      <option name="closed" value="true" />
+      <created>1774342655433</created>
+      <option name="number" value="00002" />
+      <option name="presentableId" value="LOCAL-00002" />
+      <option name="project" value="LOCAL" />
+      <updated>1774342655433</updated>
+    </task>
+    <task id="LOCAL-00003" summary="projection commit">
+      <option name="closed" value="true" />
+      <created>1774345486028</created>
+      <option name="number" value="00003" />
+      <option name="presentableId" value="LOCAL-00003" />
+      <option name="project" value="LOCAL" />
+      <updated>1774345486028</updated>
+    </task>
+    <option name="localTasksCounter" value="4" />
+    <servers />
+  </component>
+  <component name="VcsManagerConfiguration">
+    <MESSAGE value="projection commit" />
+    <option name="LAST_COMMIT_MESSAGE" value="projection commit" />
+  </component>
+</project>

panda_data_tools-0.0.1/CHANGELOG.md

@@ -0,0 +1,63 @@
+# Changelog
+
+本文件记录 PandaAI 金融数据 Tool 层 (`panda-data-tools`) 的所有版本变更。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [2.0.0] - 2025-07-18
+
+### Added
+
+- 新增 DuckDB 本地数据缓存模块 (`panda_tools/cache.py`)
+  - `CacheManager` 类：支持 `save`、`read`（带过滤条件）、`clear`、`list_tables`、`close`
+  - 可配置数据库路径，默认 `./panda_data_cache.duckdb`
+  - DuckDB 未安装时优雅降级，记录警告日志
+- 新增数据导出模块 (`panda_tools/exporter.py`)
+  - `export_data` 函数：支持 CSV、Excel、DuckDB 三种格式导出
+  - CSV 导出使用 UTF-8 with BOM 编码（`utf-8-sig`）
+  - Excel 导出基于 openpyxl 引擎
+  - DuckDB 导出为指定数据库文件的表
+  - 自动创建输出目录
+  - 统一错误消息格式：`"导出失败：{ErrorType}: {message}"`
+- 新增属性基测试（Hypothesis）
+  - 缓存存取往返一致性测试 (Property 2)
+  - 缓存过滤查询正确性测试 (Property 3)
+  - 缓存清除有效性测试 (Property 4)
+  - 导出往返一致性测试 (Property 5)
+  - 导出成功消息验证测试 (Property 6)
+  - 导出失败消息格式测试 (Property 7)
+  - 导出自动创建目录测试 (Property 8)
+- 新增 `CHANGELOG.md` 版本变更记录
+- 新增 `duckdb` 为项目依赖
+
+### Changed
+
+- `pyproject.toml` 添加 `duckdb` 到 dependencies
+- `pyproject.toml` 添加 `[project.optional-dependencies]` test 组（pytest, hypothesis, duckdb, openpyxl）
+- `README.md` 更新，补充 cache.py 和 exporter.py 模块文档
+
+## [1.0.0] - 2025-07-01
+
+### Added
+
+- 初始发布，将 panda_data 包的 38 个金融数据查询 API 封装为 LLM function calling tools
+- 凭证管理模块 (`panda_tools/credential.py`)
+  - `CredentialManager` 类：支持环境变量配置用户名和密码
+- API 返回值格式化器 (`panda_tools/formatter.py`)
+  - `safe_call` 函数：统一 API 调用和错误处理
+  - 错误消息格式：`"API 调用失败：{ErrorType}: {message}"`
+- Tool 注册中心 (`panda_tools/registry.py`)
+  - `ToolRegistry` 类：管理所有 tool 的注册和发现
+- 6 个分类 Tool 模块，覆盖 38 个 API：
+  - `tools/market_data.py` — 行情数据
+  - `tools/market_ref.py` — 基础信息
+  - `tools/financial.py` — 财务数据
+  - `tools/futures.py` — 期货数据
+  - `tools/trade_tools.py` — 交易工具
+- 测试套件：
+  - `tests/test_credential.py` — 凭证管理测试
+  - `tests/test_formatter.py` — 格式化器测试
+  - `tests/test_registry.py` — 注册中心测试
+  - `tests/test_schema.py` — Tool schema 验证测试
+  - `tests/test_all_apis.py` — 全量 API 测试

panda_data_tools-0.0.1/PKG-INFO

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: panda-data-tools
+Version: 0.0.1
+Summary: PandaAI 金融数据 API 的 LLM Tool 封装层，将 38 个数据查询方法封装为符合 function calling 规范的 tools。
+Requires-Python: >=3.12
+Requires-Dist: duckdb
+Requires-Dist: panda-data
+Requires-Dist: panda-data-tools
+Requires-Dist: pandas
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: test
+Requires-Dist: duckdb; extra == 'test'
+Requires-Dist: hypothesis; extra == 'test'
+Requires-Dist: openpyxl; extra == 'test'
+Requires-Dist: pytest; extra == 'test'

panda_data_tools-0.0.1/README.md

@@ -0,0 +1,184 @@
+# panda-data-tools
+
+PandaAI 金融数据 API 的 LLM Tool 封装层，将 `panda_data` 包的 38 个数据查询方法封装为符合 LLM function calling 规范的 tools。
+
+## 安装
+
+```bash
+# 本地安装（推荐使用 uv）
+uv pip install .
+
+# 或使用 pip
+pip install .
+```
+
+### 依赖说明
+
+核心依赖：
+
+- `pandas` — 数据处理
+- `duckdb` — 本地数据缓存和 DuckDB 格式导出
+
+可选依赖：
+
+- `openpyxl` — Excel 格式导出（未安装时 Excel 导出返回错误提示）
+
+## 构建分发包
+
+```bash
+uv build
+```
+
+## 使用方式
+
+### 基本用法
+
+```python
+from panda_tools.credential import CredentialManager
+from panda_tools.registry import ToolRegistry
+
+# 1. 认证初始化（从环境变量读取凭证）
+CredentialManager.init_from_env()
+
+# 2. 获取所有 tool 定义
+registry = ToolRegistry()
+tools = registry.get_all_tools()
+
+# 3. 调用指定 tool
+result = registry.call_tool("get_market_data", start_date="20250101", end_date="20250110", symbol="000001.SZ")
+print(result)
+```
+
+### 数据缓存
+
+使用 `CacheManager` 将查询结果缓存到本地 DuckDB 数据库，避免重复调用远程 API：
+
+```python
+from panda_tools.cache import CacheManager
+
+# 初始化缓存管理器（可自定义数据库路径）
+cache = CacheManager(db_path="./my_cache.duckdb")
+
+# 缓存查询结果
+cache.save("get_market_data", df)
+
+# 读取缓存数据（支持过滤条件）
+cached_df = cache.read("get_market_data", symbol="000001.SZ")
+
+# 查看所有缓存表
+tables = cache.list_tables()
+
+# 清除指定表缓存
+cache.clear("get_market_data")
+
+# 清除所有缓存
+cache.clear()
+
+# 关闭连接
+cache.close()
+```
+
+### 数据导出
+
+使用 `export_data` 将 DataFrame 导出为 CSV、Excel 或 DuckDB 格式：
+
+```python
+from panda_tools.exporter import export_data
+
+# 导出为 CSV（UTF-8 with BOM 编码，Excel 打开中文不乱码）
+result = export_data(df, "output/data.csv", format="csv")
+
+# 导出为 Excel
+result = export_data(df, "output/data.xlsx", format="excel")
+
+# 导出为 DuckDB 表
+result = export_data(df, "output/data.duckdb", format="duckdb", table_name="market_data")
+```
+
+输出目录不存在时会自动创建。
+
+## 测试
+
+```bash
+# 运行属性基测试和单元测试（不需要 API 凭证）
+uv run pytest tests/ -v
+
+# 运行 Hypothesis 属性基测试
+uv run pytest tests/ -v -k "hypothesis or property"
+
+# 运行全量接口批量测试（需要 API 凭证）
+uv run --with ./panda_data-0.1.0-py3-none-any.whl pytest tests/test_all_apis.py -v
+
+# 按类别测试
+uv run --with ./panda_data-0.1.0-py3-none-any.whl pytest tests/test_all_apis.py -v --category market_data
+
+# 测试单个方法
+uv run --with ./panda_data-0.1.0-py3-none-any.whl pytest tests/test_all_apis.py -v --method get_market_data
+```
+
+测试依赖：`pytest`、`hypothesis`、`duckdb`、`openpyxl`
+
+## 项目结构
+
+```
+panda-data/
+├── panda_tools/
+│   ├── __init__.py          # 包入口
+│   ├── credential.py        # 凭证管理
+│   ├── registry.py          # Tool 注册中心
+│   ├── formatter.py         # 返回值格式化
+│   ├── cache.py             # DuckDB 本地数据缓存（v2.0.0 新增）
+│   ├── exporter.py          # 数据导出 CSV/Excel/DuckDB（v2.0.0 新增）
+│   └── tools/               # 按类别组织的 tool 定义
+│       ├── __init__.py
+│       ├── market_data.py   # 行情数据（2个方法）
+│       ├── market_ref.py    # 市场参考数据（20个方法）
+│       ├── financial.py     # 财务与因子（5个方法）
+│       ├── trade_tools.py   # 交易工具（5个方法）
+│       └── futures.py       # 期货（3个方法）
+├── tests/
+│   ├── __init__.py
+│   ├── test_all_apis.py     # 全量接口批量测试
+│   ├── test_cache.py        # 缓存模块测试（属性基 + 单元）
+│   ├── test_exporter.py     # 导出模块测试（属性基 + 单元）
+│   ├── test_credential.py   # 凭证管理测试
+│   ├── test_formatter.py    # 格式化器测试
+│   ├── test_registry.py     # 注册中心测试
+│   ├── test_schema.py       # Tool schema 验证测试
+│   ├── test_changelog.py    # CHANGELOG 格式测试
+│   └── test_skill_content.py # SKILL.md 内容测试
+├── panda-data-skill/       # ClawHub 技能包（发布用）
+│   ├── SKILL.md
+│   ├── README.md
+│   ├── CHANGELOG.md
+│   ├── api_reference.md
+│   └── scripts/
+│       └── call_tool.py
+├── pyproject.toml
+├── CHANGELOG.md
+└── README.md
+```
+
+## v2.0.0 新特性
+
+### DuckDB 本地数据缓存
+
+- 基于 DuckDB 的查询结果本地持久化存储
+- 支持按表名存取、过滤查询、单表/全量清除
+- DuckDB 未安装时自动降级，不影响现有功能
+
+### 数据导出
+
+- 支持 CSV（UTF-8 with BOM）、Excel（openpyxl）、DuckDB 三种格式
+- 自动创建输出目录
+- 统一的错误消息格式
+
+### 属性基测试
+
+- 使用 Hypothesis 框架编写属性基测试
+- 覆盖缓存存取往返、过滤查询、清除有效性
+- 覆盖导出往返一致性、成功消息、失败消息、目录自动创建
+
+## 变更记录
+
+详见 [CHANGELOG.md](CHANGELOG.md)。

panda_data_tools-0.0.1/build_and_push.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# PyPI 发布脚本：构建 wheel/sdist 并上传到 Test PyPI 或正式 PyPI。
+# 依赖：pip install build twine
+#
+# 令牌（勿提交到 git）：
+#   - Test PyPI: 在 https://test.pypi.org/manage/account/token/ 创建，设置 TEST_PYPI_API_TOKEN
+#   - 正式 PyPI: 在 https://pypi.org/manage/account/token/ 创建，设置 PYPI_API_TOKEN
+#
+# 用法：
+#   ./build_and_push.sh build          # 仅清理并构建 + twine check（默认）
+#   ./build_and_push.sh test           # 构建并上传到 Test PyPI
+#   ./build_and_push.sh prod           # 构建并上传到正式 PyPI
+#   ./build_and_push.sh clean          # 仅删除 dist/ build/ 等
+#
+# 发布后用户安装（与 pyproject.toml [project] name 一致）：
+#   pip install panda-data-tools
+#
+# 安装后 Python 中 import 的是包目录名 panda_tools（非 PyPI 项目名）：
+#   from panda_tools.credential import CredentialManager
+#   from panda_tools.registry import ToolRegistry
+
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$ROOT"
+
+# PyPI / pip 使用的发行版名称（与 pyproject.toml [project] name 一致）
+DISTRIBUTION_NAME="panda-data-tools"
+
+clean() {
+  rm -rf dist build *.egg-info
+}
+
+build_only() {
+  clean
+  python -m build
+  twine check dist/*
+  echo "构建完成: dist/"
+}
+
+upload_test() {
+  export TWINE_USERNAME=__token__
+  export TWINE_PASSWORD="${TEST_PYPI_API_TOKEN:?请设置环境变量 TEST_PYPI_API_TOKEN（Test PyPI API token）}"
+  twine upload --repository-url https://test.pypi.org/legacy/ dist/*
+  echo "已上传到 Test PyPI。本地验证安装示例："
+  echo "  pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ ${DISTRIBUTION_NAME}"
+}
+
+upload_prod() {
+  export TWINE_USERNAME=__token__
+  export TWINE_PASSWORD="${PYPI_API_TOKEN:?请设置环境变量 PYPI_API_TOKEN（PyPI API token）}"
+  twine upload dist/*
+  echo "已上传到 PyPI。用户安装："
+  echo "  pip install ${DISTRIBUTION_NAME}"
+  echo "验证导入示例："
+  echo "  python -c \"from panda_tools.credential import CredentialManager; from panda_tools.registry import ToolRegistry; print('ok')\""
+}
+
+case "${1:-build}" in
+  clean)
+    clean
+    echo "已清理 dist/、build/、*.egg-info"
+    ;;
+  build)
+    build_only
+    ;;
+  test)
+    build_only
+    upload_test
+    ;;
+  prod|publish)
+    build_only
+    read -r -p "确认上传到正式 PyPI？(y/N) " ans
+    case "$ans" in
+      y|Y|yes|YES) upload_prod ;;
+      *) echo "已取消"; exit 1 ;;
+    esac
+    ;;
+  *)
+    echo "用法: $0 {build|test|prod|clean}" >&2
+    exit 1
+    ;;
+esac

panda_data_tools-0.0.1/panda-data-skill/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+本文件记录 Panda Data Skill 的所有版本变更。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+## [2.0.0] - 2025-07-18
+
+### Added
+
+- 与 panda-data-tools v2.0.0 对齐
+- 支持 DuckDB 本地数据缓存
+- 支持数据导出（CSV、Excel、DuckDB）
+- 完善 SKILL.md 结构，包含全部 35 个 API 方法说明
+
+## [1.0.0] - 2025-07-01
+
+### Added
+
+- 初始发布
+- 35 个金融数据 API 的 LLM Tool 封装
+- 支持行情、市场参考、财务、交易、期货五大分类