安装与启动
安装后启动没反应 / 浏览器没自动打开？
手动打开浏览器访问 http://127.0.0.1:8502。如果端口被占用，
可在启动命令里指定其他端口，如 --server.port 8503。
提示缺少模块怎么办？
核心依赖只需 pip install pandas openpyxl；完整功能用
pip install -e ".[all]"。若某个可选库缺失，
对应功能会给出安装提示，不影响其他功能。
支持 macOS / Linux 吗？
目前安装包仅提供 Windows 10 / 11 版本。
模型配置
不配置大模型能用吗？
能。内置规则引擎覆盖 20+ 种常见任务（分组统计、清洗、画图、报告等），
不装任何模型也能完成日常表格处理。配置模型后可理解更复杂的自然语言表达。
推荐用哪个模型？
推荐 DeepSeek 官方（deepseek-chat），中文理解好、价格低。
如对数据安全要求高，建议用本地 Ollama（如 qwen2.5:7b）。
调用模型报 401 认证失败？
API Key 无效或不完整。请到模型平台重新完整复制（DeepSeek 的 Key 形如
sk- + 32 位字符），注意不要漏字符或多空格。
提示无法连接模型 / 超时？
若本机开启了代理软件，可能导致 SSL 或 URL 解析异常。可在启动脚本中清空
HTTP_PROXY / NO_PROXY 等环境变量后重试；
国内模型服务通常可直连。
数据处理
上传后列名变成 Unnamed: 0 怎么办？
说明你的表是「报表型」（第一行是合并大标题）。DataHand 已内置
表头自动检测，重新上传即可正确识别；也可手动指定表头行。
一个 Excel 有多个 Sheet 会自动识别吗？
会。上传时自动识别所有工作表，多个文件里的多个 Sheet 也全部载入，
表名显示为「文件名::Sheet名」，可切换、对比、跨表处理。
支持多大的文件？
取决于可用内存。经验值：8 GB 内存约可处理 100-200 万行。
超大文件建议先拆分或抽样。
图表中文显示成方块？
已内置中文字体自动适配（SimHei / 微软雅黑）。若仍异常，
说明系统缺少中文字体，安装任一中文字体后重启即可。
数据安全
数据会上传到你们服务器吗？
不会。DataHand 是本地工具，没有我们的服务器参与。
使用本地大模型时全程零出站请求；使用云端模型时只发送字段结构与你的指令文本，
不发送原始数据行。
API Key 存在哪里？
仅保存在本机用户目录的 ~/.datahand/config.json，
不会以任何方式传输到其他地方。
适合处理敏感数据（薪酬/客户名单）吗？
适合。配合本地大模型可完全离线运行，数据不出本机，
满足金融、医疗、政务等合规要求。
版本与回滚
怎么查看当前版本？
在软件的「版本管理」页面可查看当前版本号、完整版本历史与变更说明；
命令行执行 python -m datahand --version 也可查看。
处理错了能回滚吗？
可以。DataHand 内置
快照与回滚机制：每次重要操作前自动创建数据快照，
可随时回滚到任意历史版本。详见
使用指南 · 版本管理。
购买与授权
专业版怎么付款？
支持微信扫码支付（见
定价页）。
付款后把订单号与邮箱发给我们，核验后发送安装包与激活码。
可以开发票吗？
企业采购可开增值税普通发票 / 专用发票，邮件提供抬头与税号即可。
激活码能换机吗？
可以。专业版为 最多 3 台设备授权，授权码激活后会绑定该电脑的设备指纹。换机时联系我们解绑旧设备，即可在新电脑上用同一授权码重新激活。