前言¶
在 DeepSeek Harness（DSH）里做对比表、调研矩阵或结构化数据时，常见做法是让智能体在对话里输出 Markdown 表格。表格能读，但不便长期编辑、套用公式，也难与 CSV、Excel 工作流对接。若希望智能体直接建表、填数、改范围，并在侧边栏里像表格软件一样操作，需要客户端侧的可写表格能力。dsh-sheets 是维护者 iggypcnfsky 发布的 DSH 客户端插件，在 Harness 左侧栏提供 Sheets 面板；面板打开时会刷新，智能体通过工具修改后无需整页重载即可看到更新。
这是什么¶
dsh-sheets（npm 包名 @iggylove/dsh-sheets，版本 1.0.0，MIT 许可证）面向 DSH 的 Web 端：多工作簿、多标签页，可编辑单元格网格，支持轻量公式、格式、CSV/Excel 导入导出，并为智能体暴露一组 spreadsheet_* 工具。数据默认落在配置目录下的 data/dsh-sheets（可通过环境变量覆盖，见下文）。
社区目录页：dsh-sheets（SkillHub）。源码与说明：iggypcnfsky/dsh-sheets。DSH 生态强调「一切皆插件」；SkillHub 为社区目录，与 DeepSeek、幻方无官方从属关系。
核心功能¶
面板与编辑¶
- 多个工作簿，每个工作簿多个工作表（标签页）。
- 单元格网格：方向键移动、Enter/Tab 编辑、块状粘贴、列宽调整、插入或删除行列。
- 格式：填充色与文字色（深色填充时自动对比度）、粗体/斜体、左/中/右对齐、自动换行与行高增长、清除格式、按内容调整列宽。
- 区域选择：Shift+点击或 Shift+方向键；点击行号或列标可选整行/整列。
公式¶
在面板内求值，支持算术、单元格与区域引用、跨表 'Sheet'!A1，以及 SUM、AVERAGE、MIN、MAX、COUNT、COUNTA、SUMIF、SUMIFS、COUNTIF、AVERAGEIF、IF、IFERROR、AND、OR、NOT、ROUND、ROUNDUP、ROUNDDOWN、ABS、SQRT、POWER、PI、三角与反三角函数、DEGREES、RADIANS、TEXT、LEN、UPPER、LOWER、TRIM、CONCAT 等。
导入与导出¶
- 导入：
.csv、.tsv、.txt、.xlsx（智能体工具还可接受.xls、.xlsm等本地路径）。 - 导出：当前表为 CSV；整个工作簿为 Excel（
.xlsx，含公式）。
智能体工具¶
插件在系统提示中引导智能体：用户要表格、对比或调研矩阵时优先用工具，而非只打 Markdown；用户提供文件路径时用 spreadsheet_import，而非让用户手动导入。
| 工具 | 用途 |
|---|---|
spreadsheet_list |
列出工作簿、工作表及尺寸 |
spreadsheet_create |
按名称、表头列和行数据创建工作簿 |
spreadsheet_read |
读取整表或 A1 区域，可限制行列上限 |
spreadsheet_write |
写区域、追加行、替换行或清空区域 |
spreadsheet_manage |
重命名/删除工作簿，增删改工作表，增删行列 |
spreadsheet_import |
从本地路径导入到新建或已有工作簿 |
存储与上限¶
- 持久化路径：存在
DSH_PROFILE_DIR时为DSH_PROFILE_DIR/data/dsh-sheets，否则~/.dsh/data/dsh-sheets；可用DSH_SHEETS_DIR覆盖。 - 规模上限（资料注明）：最多 500 个工作簿；每工作簿 60 张表；每表 5,000 行、120 列；每工作簿 250,000 个单元格。
- 插入/删除行列不会自动改写已有公式引用，结构变更后若区域移动需自行更新公式。
- Excel 导入保留值、公式、填充色、自定义列宽；边框、合并单元格、字体族、条件格式不导入；日期可能显示为格式化文本或序列号。
环境与依赖¶
安装前需满足：
- DeepSeek Harness：
>=0.2.2-0且<0.3.0-0 - Node.js：20 或更新
安装与启用¶
从 GitHub Release 安装（资料中的正式命令）：
dsh plugin --profile <profile> add https://github.com/iggypcnfsky/dsh-sheets/releases/download/v1.0.0/iggylove-dsh-sheets-1.0.0.tgz
npm 发布后可改用：
dsh plugin --profile <profile> add @iggylove/dsh-sheets
安装完成后重启 dsh web。左侧栏应出现 Sheets 面板。已安装的 Harness 也可在 Plugins 页面按 npm 名安装，或通过目录页的本地包安装方式安装（与 README 描述一致）。
典型用法¶
1、安装并重启 Web 后，在左侧打开 Sheets。
2、在对话中向智能体说明需求，例如建立带表头的对比表、填入多行数据或更新某一区域。智能体应调用 spreadsheet_create、spreadsheet_write、spreadsheet_read 等；面板保持打开时 edits 会反映到界面上。
3、若本地已有表格文件，可将路径交给智能体，由其调用 spreadsheet_import 导入 .xlsx、.csv 等。
4、在面板中可手动编辑、设置格式与公式；需要落盘或交给外部分析时，使用导出 CSV 或整簿 .xlsx。
适用场景与注意¶
适合谁： 经常在 DSH 里用智能体维护结构化表、做轻量计算、与 CSV/Excel 来回交换，且希望结果留在可编辑面板而非一次性 Markdown 输出的开发者或团队。
运行方式： 插件随当前 DSH 进程与配置 profile 运行，读写本机路径与 data/dsh-sheets 目录。安装前应阅读 源码仓库 与 MIT 许可证，确认能力与权限范围符合你的环境策略。XLSX 读写依赖浏览器侧的 CompressionStream/DecompressionStream；当前基于 Chromium 的 Harness 构建支持该能力。
结尾¶
dsh-sheets 把「可写电子表格 + 智能体工具」放进 DSH 客户端：对话里建表改表，侧边栏同步展示，并覆盖公式、格式与常见表格文件格式。进一步说明与 Issue 见 GitHub；目录索引见 SkillHub 插件页。
