FylarOpen/dsh-fylar-office-editor
Office document preview, editing, and DOCX generation for DeepSeek Harness, powered by Fylar Office SDK.
Project Overview项目介绍
This is an Office editing plugin for DeepSeek Harness. It lets you view, edit, and download Office documents (DOCX, XLSX, PPTX etc.) directly in the DSH web environment. Note the bundled Fylar Office SDK only includes 3000 free metered uses; a paid license is required after exceeding the limit.
这是DeepSeek Harness的Office编辑插件,支持在DSH内直接打开、编辑、导出代理生成或工作区内的Word、Excel、PPT文档,适用于DSH Web环境。注意Fylar Office SDK免费额度仅3000次调用,超出需付费授权。
请帮我了解并安装插件:【dsh-fylar-office-editor】【https://github.com/FylarOpen/dsh-fylar-office-editor】
Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
npx @deepseek-ai/dsh plugin --profile web add @fylar/dsh-fylar-office-editor
把 FylarOpen/dsh-fylar-office-editor 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
Fylar Office Editor for DeepSeek Harness
Turn Office files created by an agent into documents you can open, review, edit, and download without leaving DeepSeek Harness.
English · 简体中文
@fylar/dsh-fylar-office-editor connects Office documents to the DeepSeek Harness (DSH) Web experience. It adds a single delivery card to the conversation, an Office workspace tab, a side-panel editor, and a fullscreen editor, all powered by the Fylar Office SDK.
The plugin can create a real DOCX file from the agent's Markdown response. It can also present existing DOC, DOCX, XLS, XLSX, and PPTX files created by Python, shell commands, or other tools in the current DSH workspace.
Highlights
- Office files in the conversation — open the delivered file inline, move the same editing session to the side panel, or enter fullscreen.
- Real DOCX generation — the agent can convert headings, paragraphs, lists, simple tables, code blocks, bold, italic, and inline code into an OOXML Word document.
- Word, Excel, and PowerPoint editing — open supported local or workspace files, or create blank documents from the Office tab.
- One persistent editing session — moving between Chat, the Office tab, the side panel, and fullscreen does not reopen the document.
- Export instead of silent overwrite — browser edits stay in the SDK session until you download the edited Office file.
- English and Simplified Chinese UI — the plugin shell follows the DSH locale; the SDK loads its matching language pack.
- Workspace-confined file access — the Host only serves supported files from registered DSH workspace roots and blocks traversal and symlink escapes.
The Fylar Office SDK
This plugin is powered by the Fylar Office SDK — a fully client-side, serverless Office runtime that brings native Office capabilities to any web application.
- Web-native and serverless — no server deployment, third-party conversion tools, or desktop Office suites; files are parsed, rendered, edited, and exported directly in the browser.
- Document content stays local — Office files are processed on the client instead of being uploaded for cloud document processing. The SDK may still contact the Fylar licensing service to validate credentials and meter usage as described in the commercial license.
- No iframe, just a DOM node — integration is a programmable DOM node instead of an embedded external viewer.
- High-fidelity compatibility — built around the Office (OOXML) specification to preserve layout, formatting, and document behavior, with pixel-perfect rendering wherever possible.
- High-performance rendering — documents open in seconds: first paint in under 500 ms and typical opening in 1–2 s, all processed 100% locally.
- Everything is programmable — all Office capabilities are exposed in an API-first way, and you can use the API to operate the editor as needed.
In this plugin, the SDK runs entirely inside the DSH browser session: after the browser receives a file as a Blob, the SDK owns document rendering and editing (see Editing and saving).
The bundled SDK is proprietary commercial software. Each License Credential or associated customer account includes an aggregate Free Allowance of up to 3,000 Metered Uses. Continued use after that allowance requires an active paid entitlement or another written commercial license. See the Fylar Office SDK Commercial License for the controlling definitions and terms.
Get started
Requirements
- DeepSeek Harness
0.1.5-rc.1. This release uses the right-Sidebar tab API introduced by the0.1.5release candidate line. - Node.js
^22.19.0 || >=24.0.0. - The DSH Web profile.
- A modern browser with Worker, SharedWorker, WebAssembly, IndexedDB, Blob, and ArrayBuffer support.
- A valid Fylar Office SDK License Credential or other authorization. The bundled commercial license includes the Free Allowance described above.
1. Install from npm
Stop the currently running DSH process, then install the plugin package:
npx @deepseek-ai/dsh plugin --profile web add @fylar/dsh-fylar-office-editor
If running DSH from its source repository, use the repository script instead:
pnpm dsh plugin --profile web add @fylar/dsh-fylar-office-editor
The npm package includes its verified lib/ output and SDK runtime, so users do not need to clone or build the plugin.
2. Restart DSH
npx @deepseek-ai/dsh web
When using the DSH source repository:
pnpm dsh web
Refresh an already open DSH page after the Web process restarts.
3. Ask for a document
Try one of these requests in a workspace-write session:
Turn this conversation into a Word project summary and save it as reports/project-summary.docx.
Create an XLSX comparison table in the workspace, then open it for preview.
Open the existing slides/company-introduction.pptx in the Office editor.
The built-in agent tool directly generates DOCX files. XLSX and PPTX content must currently be created by another agent tool or script; this plugin then validates and presents the resulting file.
How it works
There are two delivery paths:
office_create_docxconverts Markdown to a real DOCX file, writes it to the active DSH workspace, and publishes the result to the conversation.office_present_filevalidates an existing Office file in the active workspace and publishes it without generating or modifying the file.
DSH selects these tools from the user's request and the plugin's model guidance. Users normally do not need to mention the tool names.
After publication, the assistant turn contains one Office delivery card. Open it inline, move it to the side panel, switch to the Office tab, or enter fullscreen. Every presentation reuses the same browser-side SDK widget.
Supported formats
| Format | Open | Edit | Create from Office tab | Download edited file | Export PDF |
|---|---|---|---|---|---|
| DOC | Yes | Yes | No | DOC | Yes |
| DOCX | Yes | Yes | Yes | DOCX | Yes |
| XLS | Yes | Yes | No | XLS | Yes |
| XLSX | Yes | Yes | Yes | XLSX | Yes |
| PPTX | Yes | Yes | Yes | PPTX | No |
The Office tab also lets you select a supported local file. Local files remain browser-side and are not written into the DSH workspace by opening them.
Editing and saving
Document rendering and editing are owned by the Fylar Office SDK after the browser receives the file as a Blob. They do not write through the DSH filesystem while you type.
- Editing does not automatically overwrite the original workspace file.
- Use Export to download and retain the edited Office document.
- Closing or replacing the current document ends the browser editing session.
- Refreshing or leaving the page triggers a browser warning when the plugin has detected possible edits.
- A successful Office-format download clears that warning state; PDF export does not.
PDF export
PDF export is available for Word and Excel formats when all of the following are true:
- the page runs on
localhostor HTTPS; - the browser supports
window.queryLocalFonts; - the user grants local-font access.
When the environment does not qualify, the PDF action is disabled and the plugin explains why. PowerPoint PDF export will be introduced in a future release.
Upgrade and uninstall
To replace an existing installation, stop DSH, remove the current plugin row, install the current npm package version, and restart:
npx @deepseek-ai/dsh plugin --profile web remove @fylar/dsh-fylar-office-editor
npx @deepseek-ai/dsh plugin --profile web add @fylar/dsh-fylar-office-editor
npx @deepseek-ai/dsh web
Current limits
- This release supports DSH
0.1.5-rc.1through the0.1.5line; later DSH API changes may require another plugin release. - Only DOCX has a dedicated agent-side content generator in this release.
- Browser edits must be downloaded; they are not synchronized back to the workspace file.
- The plugin keeps one active document per page rather than one document per DSH task.
- PDF export depends on browser and font-access capabilities.
Distribution and notices
This plugin is distributed through the npm registry and includes the proprietary Fylar Office SDK runtime. The SDK license service endpoint is fixed at https://openlicense.fylar.ai. The SDK is governed by the Fylar Office SDK Commercial License, any applicable order form, and any separate written commercial agreement. It is not open-source software. The bundled license provides an aggregate maximum of 3,000 Metered Uses per License Credential or associated customer account; continued use requires a paid entitlement or another written commercial license after that allowance is exhausted.
Third-party notices are preserved in THIRD_PARTY_NOTICES. See NOTICE.md before using or redistributing a packaged build.
ZSeven-W/dsh-openpencil
HanaAyane/dsh-reasoning-effort
HuanLinOTO/dsh-plugin-better-sidebar-plugin-office
omdsh-dev/dsh-office
dingyi222666/dsh-focus-chat
609476965/dsh-LorebookMD
2768651338/dsh-effort-slider