表格实验室
表格实验室 / 入门指南
GETTING STARTED / 入门指南

让 Harness 读到第一张 Excel 表

先用一张 6 行订单表跑通流程:选工作区、发一条指令、自己核对答案。

在练习文件夹里启动 Harness

Harness 是运行智能体的工作环境。你在对话里说任务,它通过可用工具读写工作区的文件;最后用 Excel 打开新文件检查。本教程网站只提供资料,不需要在这里输入密钥或上传表格。

  1. 在电脑上新建 excel-lab 文件夹,下载 orders.xlsx 放进去。如果已装好桌面版,可直接打开它并选择这个文件夹。
  2. 要使用 Web 界面,先安装 Node.js,再在该文件夹打开终端并运行下面的命令。启动后按终端提示打开本地地址,默认是 http://127.0.0.1:3080。
npx @deepseek-ai/dsh web
  1. 在 Harness 的“设置 → 模型”配置自己的模型/API 密钥。再点“选择工作区”,添加并选中刚刚的练习目录。该目录下只放练习文件。
  2. 首次只做读取。需要写文件时,先看清操作和目标路径,再允许另存练习结果。

第一次对话,只让它读表

PROMPT / 任务提示词
请列出当前工作区的文件。读取 orders.xlsx,告诉我工作表名、表头和数据行数,并列出前两条订单号。不要修改文件。
应该看到什么

表名是“订单”,表头是订单号、客户编号、数量、单价 / 元;表头以下有 6 行。前两条订单号是 S01、S02。若回答里没有这些实际值,请它说明用什么工具、打开了哪个路径。

接着做工作簿体检。可以先请模型列计划,确认统计对象和分母后,再让它保存一份结果文件。

Skill、Tool 和插件分别管什么

概念在 Excel 任务里怎样理解
Skill(技能)一套能复用的做事说明,例如“先盘点,再写公式,最后对总额”。
Tool(工具)实际执行动作的能力,例如列文件、运行脚本或写工作簿。
Plugin(插件)给 Harness 扩展能力的组件;加载的插件可以提供工具或技能。

先用上面的只读任务测试现有环境。若能看见文件却读不出单元格,让 Harness 列出当前可用的表格读取方法和缺少的依赖;获得真实行号后再开始做分析。

需要扩展时怎么装

按当前官方 Web 指南,插件页可启用实验性的“自定义插件索引”,再在“发现”里添加可信的 HTTPS 索引源、选定包和版本、确认安装。没有现成索引不等于需要随便找一个安装。具体界面、可用技能和权限可能随版本不同;装完仍用同一份小表验证。

查看官方插件安装说明

常见卡点

“找不到文件”,但它就在下载目录?

把文件移到刚选中的练习工作区,确认浏览器下载没有改名(如 orders (1).xlsx)。先让模型只列当前目录的文件名。

回复说“已生成”,在哪里下载结果?

让它返回实际写入的相对路径、工作表名和记录数。到工作区确认新文件存在并在 Excel 打开;只有聊天中的表格不等于已写入 .xlsx。

公式写进去了,为什么读到空值?

有些写入工具只写公式,不计算结果。用 Excel 打开、执行重新计算并另存,再读一次。不要把空白当零,也不要用固定数值覆盖公式。

我需要在这个网页上传自己的数据吗?

不需要。跟练只用本站的模拟表。Harness 的模型服务可能接收任务内容;练习用副本,避免把真实客户或员工记录放进练习工作区。

版本与资料

本手册以公开的开发者预览版文档为依据,示例使用本地工作区,菜单名称以所用版本为准。