walioffice-dsh-plugin

配置

基础办公工具

基础办公工具默认使用 DSH 已配置的 LLM。如果需要明确指定 provider 和模型，请在启动 DSH 之前，在同一个终端逐条执行：

export WALIOFFICE_LLM_PROVIDER=deepseek

export WALIOFFICE_LLM_MODEL=deepseek-chat

然后启动 DSH：

dsh web

插件的配置优先级如下：

1. WALIOFFICE_LLM_PROVIDER、WALIOFFICE_LLM_MODEL
2. DSH_LLM_PROVIDER、DSH_LLM_MODEL
3. DSH 自身已配置的 LLM provider

图片和视频工具（可选）

只有使用 image_prompt、wali_video_generate 或 video_storyboard 时，才需要额外配置图片或视频 API。配置图片 API 时，逐条执行：

export AGNES_IMAGE_BASE_URL=https://your-image-api.example.com

export AGNES_IMAGE_API_KEYS=key-1,key-2

图片工具使用的模型是 agnes-image-2.1-flash。如果 DSH 通过 ~/.dsh/settings.yaml 管理模型，请确保该模型已经配置。

配置视频 API 时，逐条执行：

export AGNES_VIDEO_BASE_URL=https://your-video-api.example.com

export AGNES_VIDEO_API_KEYS=key-1,key-2

视频工具使用的模型是 agnes-video-v2.0。如果 DSH 通过 ~/.dsh/settings.yaml 管理模型，请确保该模型已经配置。

配置完成后，必须在同一个终端启动 DSH：

dsh web

如果不使用 AGNES_* 变量，也可以使用兼容变量 LLM_IMAGE_*、LLM_VIDEO_*。插件还支持从 DSH 的 ~/.dsh/settings.yaml、~/.dsh/.credentials.yaml 读取配置。仓库中的 .env.example 只是变量清单，DSH 不会自动加载 .env 文件。

不要把真实 API key 写入 README、提交到 Git，或发布到 issue。

使用

通过 Web 界面使用

1. 启动 DSH Web：dsh web。
2. 在输入框上方选择办公类型，或选择综合模式。
3. 输入任务要求，例如“根据下面的内容生成一份 PPT”或“把这组数据整理成 Excel”。
4. 等待工具执行完成。
5. 在右侧 WaLiOffice 面板查看预览、最近产物和汇总结果。

可直接尝试以下任务：

生成一份关于人工智能入门的 PPT，包含 8 页，最后输出 pptx 文件。

把下面的会议纪要整理成 Word 文档，并保存为 docx 文件。

根据以下销售数据生成 Excel 表格，并增加一个按月份统计的图表。

查看生成文件

.pptx、.docx、.xlsx 和 .md 文件默认写入启动 DSH 时所在目录的 output/ 文件夹。先查看当前目录：

pwd

再查看生成的文件：

ls -la output

图片和视频工具返回远程资源 URL，不会自动下载到 output/。

通过 Web 界面使用

1. 启动 DSH Web：dsh web。
2. 在输入框上方选择办公类型，或选择综合模式。
3. 输入任务要求，例如“根据下面的内容生成一份 PPT”或“把这组数据整理成 Excel”。
4. 等待工具执行完成。
5. 在右侧 WaLiOffice 面板查看预览、最近产物和汇总结果。

可直接尝试以下任务：

生成一份关于人工智能入门的 PPT，包含 8 页，最后输出 pptx 文件。

把下面的会议纪要整理成 Word 文档，并保存为 docx 文件。

根据以下销售数据生成 Excel 表格，并增加一个按月份统计的图表。