dsh-fps-workbench 0.0.0-stage → 0.1.77

package/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog · 更新日志
+
+## [0.1.77](https://github.com/Blacstar7/dsh-fps-workbench/releases/tag/v0.1.77)
+
+### English
+
+- FPS is now packaged as `dsh-fps-workbench` for npm and the DSH Discover index. The GitHub repository and community catalog listing stay the same. Discover availability follows the catalog and mirror refresh.
+- If you installed v0.1.76 or earlier, save unsent attachments, remove `@local/claude-code-workbench`, and install `dsh-fps-workbench` in the same DSH profile. This is a one-time switch. The new package reads the same image settings, saved credentials, and local usage settings. DSH conversations, workspaces, and text drafts in the same client profile remain available.
+- Version tags trigger the release workflow for npm and GitHub. A prebuilt `.tgz` remains available through GitHub Releases.
+
+### 简体中文
+
+- FPS 改用公开包名 `dsh-fps-workbench`，供 npm 安装和 DSH「发现」索引收录。GitHub 仓库和社区目录条目沿用原来的地址。「发现」中的可见时间取决于目录和镜像刷新。
+- 已安装 v0.1.76 或更早版本的用户，先保存未发送的附件，再卸载 `@local/claude-code-workbench`，在同一个 DSH 配置安装 `dsh-fps-workbench`。这一步只需做一次。新版沿用生图设置、已保存凭证和本地用量配置。原配置中的会话、工作区和文字草稿可以继续使用。
+- 以后推送版本标签会触发 npm 和 GitHub 发布流程。GitHub Releases 继续提供预打包的 `.tgz`。
+
+## [0.1.76](https://github.com/Blacstar7/dsh-fps-workbench/releases/tag/v0.1.76) — 2026-11-11
+
+### English
+
+FPS now includes optional text-to-image tools in **Plugins → Four-pointed star → Image generation**. All four switches are off by default.
+
+- **Z-Image Turbo:** no API key; shared Hugging Face GPU quotas and queues apply.
+- **CogView-3-Flash and Pollinations:** use your own API key. FPS checks the Pollinations catalog before requesting its zero-priced SDXL Lightning community model.
+- **ComfyUI + official Comfy MCP:** enable the switch, then select **Download and install** to set up local generation. Setup shows progress and can be cancelled. The starter SD 1.5 workflow is intended for roughly 512 px drafts.
+- A compatible DSH model can call an enabled, ready provider through the native tool system. Generated images appear in **Outputs** and open in DSH's native preview. A failed request does not switch providers automatically.
+- Updated both READMEs and in-app plugin descriptions with setup, limits, and expected quality. Restart DSH after updating an existing installation.
+
+Live generation was verified with Z-Image Turbo and with the official Comfy MCP on an Apple silicon Mac. CogView and Pollinations were tested with simulated responses; local setup was not tested on Windows or Linux.
+
+### 简体中文
+
+FPS 在「插件 → Four-pointed star → 图片生成」中新增可选文生图工具。四个开关默认关闭。
+
+- **Z-Image Turbo**：无需 API Key，受 Hugging Face 共享 GPU 的排队和额度限制。
+- **CogView-3-Flash 与 Pollinations**：使用自己的 API Key。调用 Pollinations 前，FPS 会查询目录，确认 SDXL Lightning 社区模型的实时标价为零。
+- **ComfyUI + 官方 Comfy MCP**：开启后点「下载并安装」配置本地生图，可查看进度或取消。入门 SD 1.5 工作流适合生成约 512 像素的草图。
+- 支持工具调用的 DSH 模型可通过原生工具系统调用已开启、已就绪的服务。图片进入「输出内容」，可用 DSH 原生预览打开。请求失败时不会自动换服务。
+- 中英文 README 和插件详情补充了配置步骤、使用限制和预期画质。更新已有安装后，请重启 DSH。
+
+Z-Image Turbo 已实测出图，官方 Comfy MCP 已在 Apple 芯片 Mac 上实测本地出图。智谱和 Pollinations 使用模拟响应验证；Windows 和 Linux 的本地安装未实机验证。
+
+[Previous releases · 历史版本](https://github.com/Blacstar7/dsh-fps-workbench/releases)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blacstar7
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# Four-pointed star (FPS)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[简体中文](README.zh.md) · [Changelog](CHANGELOG.md)
+
+FPS is a conversation workspace for DeepSeek Harness (DSH). Track tool progress, open session outputs, and check context and provider usage from one interface. Keep unsent attachments when switching sessions, use a configured vision model to interpret images for a text-only model, or enable cloud or local image generation.
+
+## Screenshots
+
+These screenshots were captured in the English interface with simulated task data.
+
+A completed report in light mode, with tool progress in the conversation and the generated file in Outputs.
+
+![Light workspace with a completed report, tool progress, and the Outputs panel](docs/screenshots/01-workspace.png)
+
+Dark mode with the Context sidebar and provider usage popover. Balances and quotas shown are sample data.
+
+![Dark workspace showing context, an API balance, and rolling quotas](docs/screenshots/02-dark-workspace.png)
+
+An unsent draft after switching away and back. The text, image, and file are restored together.
+
+![Composer with an unsent attachment draft](docs/screenshots/03-drafts.png)
+
+## What you can do
+
+- **Context and session outputs.** Open Context in the conversation header to see the model, session state, and estimated context composition. Outputs lists local files produced or explicitly linked in the session. Select a file to open it in DSH's native preview. The header also gives you access to Files, Terminal, and Browser.
+- **Tool progress summaries.** Consecutive file reads, commands, and edits appear in one summary row. Expand it for DSH's native tool details. The task list distinguishes completed, active, and pending work. While the session runs, `ThinKing` shows elapsed time alongside the FPS mark and respects the system's reduced motion setting.
+- **Composer and attachment drafts.** Paste images or use the Add menu to choose images and files. When you return to a session, its draft text and unsent attachments are restored. Reloading or closing the interface clears unsent attachments. Each message supports up to four images of 8 MB each and six files of 20 MB each.
+- **Images with text-only models.** When the selected model does not support images, FPS looks for an available model with image input in DSH. It sends the image and prompt to that model and passes the resulting description to the current session. If no suitable model is available, the composer keeps the draft and shows an error.
+- **Sessions and workspaces.** The sidebar keeps DSH's workspaces, session search, and settings. Use the back and forward arrows beside the sidebar toggle to revisit sessions opened in the current window.
+- **Commands, references, and voice.** Type `/` to find commands and `@` to reference files or sessions. The composer footer gives you access to the workspace, permissions, model, reasoning effort, and usage. Enable Voice input in DSH’s Plugins page. The microphone appears next to Send and opens voice setup on first use if needed.
+
+FPS sends messages through the native DSH session. Models can use the tools enabled in the current configuration, and DSH runs them or requests approval according to the session permissions.
+
+## Provider usage
+
+Click the ring next to the model selector. FPS queries usage using the providers and API keys enabled in DSH. It shows the balance, spending, quota, or reset time returned by a supported endpoint. Zero balances are displayed. Accounts or fields are hidden when an endpoint is unsupported, a query fails, or data is missing. DSH supplies the session's token counts and estimated context usage separately.
+
+## Optional image generation
+
+Open **Plugins → Four-pointed star → Image generation** to switch on providers. All four are off by default. Ask for a provider by name or let FPS choose among the enabled, ready providers. Generated images appear in session outputs and open in DSH's native preview. Cloud providers receive your image prompt.
+
+The screenshot shows the download button after you turn on ComfyUI. Setup starts only when you select **Download and install**.
+
+![Four image generation switches, with ComfyUI enabled for demonstration and its download button visible](docs/screenshots/04-image-generation.png)
+
+- **Z-Image Turbo.** No API key. The shared Hugging Face Space is suited to quick concepts and subject to queueing and daily GPU quotas.
+- **CogView-3-Flash.** Standard-quality generation on Zhipu's free Flash tier. Requires a Zhipu BigModel API key and is subject to rate limits.
+- **Pollinations.** Requires your own API key. FPS uses SDXL Lightning for quick drafts when the live catalog lists it at zero price. Pollinations may still require a positive available balance.
+- **ComfyUI + Comfy MCP.** Local generation with ComfyUI and its official MCP integration. Switch it on, then start the download explicitly. The included SD 1.5 workflow is suitable for roughly 512 px drafts. Setup needs Python, Git, internet access, and 16 GiB of free disk space.
+
+See the plugin details for setup, credentials, platform requirements, and output quality. [Image generation guide](locale/detail.en.md#optional-image-generation)
+
+## Customize
+
+- **Appearance.** In DSH, open Settings → General → Appearance and select Light, Dark, or System. FPS follows that setting across its sidebar, conversation, composer, and menus.
+- **Models and usage.** In DSH, open Settings → Models to add or edit your providers, API endpoints, models, and API keys. Reopen the usage panel to query the updated configuration. A custom endpoint needs a matching usage integration to show balances or quotas. If you use a text-only model, you can add a model that supports image input here for FPS to select automatically.
+- **Tools and permissions.** Manage plugins that provide tools in DSH's Plugins page. Use the composer footer to select your session model and permissions. Tool availability depends on the model's capabilities and the session permissions.
+
+## Install
+
+Use DSH 0.2.2-rc.1 or later with the desktop or Web conversation interface. Features such as voice input and file previews require the corresponding DSH components in your profile.
+
+In DSH, open **Plugins → Add plugin**, select the npm registry, and enter `dsh-fps-workbench`. You can also download the `.tgz` bundle from the [latest GitHub release](https://github.com/Blacstar7/dsh-fps-workbench/releases/latest) and select it using the local path option. The DSH CLI supports npm installation as well.
+
+```sh
+dsh plugin --profile desktop add dsh-fps-workbench
+```
+
+Replace `desktop` with `web` for the Web profile. Restart DSH if prompted.
+
+### Switching from v0.1.76 or earlier
+
+Save any unsent attachments first. In **Plugins → Installed**, remove the old Four-pointed star entry whose package name is `@local/claude-code-workbench`, then install `dsh-fps-workbench` in the same DSH profile and restart if prompted. The new package reads the existing image provider settings, stored credentials, and local usage settings. DSH conversations and workspaces remain in the profile. Text drafts carry over in the same browser or desktop profile. Unsent attachments are held in memory until the page reloads.
+
+### Known issue
+
+**Sessions and scheduled tasks may fail to load after upgrading DSH Desktop to `0.2.2-rc.2`.** This can happen when the desktop profile still loads the `0.2.2-rc.1` storage dependency from an older Computer Use installation. The issue occurs with FPS enabled or disabled. Back up the desktop profile, move the old Computer Use packages and their storage dependency out of its package directory, and restart DSH so it loads the components bundled with the installed version.
+
+## License
+
+FPS is available under the [MIT License](LICENSE).

package/README.zh.md

@@ -0,0 +1,81 @@
+# Four-pointed star（FPS）
+
+[English](README.md) · [更新日志](CHANGELOG.md)
+
+FPS 是 DeepSeek Harness（DSH）的会话工作台。你可以在同一处跟踪工具进度、打开会话产物、查看上下文与服务商用量。切换会话后可以找回未发送的附件；使用纯文本模型时可借助已配置的视觉模型读图，也可按需开启云端或本地生图。
+
+## 界面截图
+
+以下截图使用英文界面和模拟任务数据。
+
+浅色模式下，会话中显示报告任务的工具进度，生成的文件可在「输出内容」中打开。
+
+![浅色工作台中的报告任务、工具进度和输出面板](docs/screenshots/01-workspace.png)
+
+深色模式下的上下文侧栏与用量弹窗。图中的余额和额度为演示数据。
+
+![深色工作台中的上下文、API 余额和周期额度](docs/screenshots/02-dark-workspace.png)
+
+切换会话再返回后，未发送的文字、图片和文件一同恢复。
+
+![输入框中的未发送附件草稿](docs/screenshots/03-drafts.png)
+
+## 主要功能
+
+- **上下文与会话产物**。点会话顶栏的「上下文」按钮，查看模型、会话状态和上下文占用估算。「输出内容」汇集会话生成或明确链接的本地文件，点击后用 DSH 原生预览打开。顶栏也可切换文件、终端和浏览器。
+- **工具步骤摘要**。连续的读文件、执行命令和编辑操作会汇总成一行，展开可查看 DSH 原生详情。任务列表区分已完成、进行中和待处理。会话运行时，`ThinKing` 显示用时和 FPS 标志动画，遵循系统的减少动态效果设置。
+- **输入与附件草稿**。支持粘贴图片，也可从「添加」菜单选择图片和文件。切换会话再回来时，会恢复该会话的文字草稿和未发送的附件。重新加载或关闭界面会清除未发送的附件。每条消息最多可添加 4 张各 8 MB 的图片和 6 个各 20 MB 的文件。
+- **纯文本模型识图**。如果所选模型不支持图片输入，FPS 会从 DSH 的可用模型中查找支持图片的模型，将图片和问题发给它，再把生成的描述交给当前会话。找不到可用模型时，输入框会保留草稿并提示失败。
+- **会话和工作区**。左栏保留 DSH 的原生工作区、会话搜索和设置。侧栏按钮旁的前进、后退箭头可在本次打开窗口后访问过的会话间切换。
+- **命令、引用和语音**。输入 `/` 查找命令，输入 `@` 引用文件或会话。输入框下方可选择工作区、权限、模型和推理强度，也可查看用量。在 DSH「插件」中启用「语音输入」，发送按钮旁会出现麦克风。尚未准备语音模型时，点麦克风会打开设置引导。
+
+FPS 通过 DSH 原生会话发送消息。模型可以使用当前配置已启用的工具，由 DSH 按会话权限执行或请求确认。
+
+## 用量怎么显示
+
+点模型选择器旁的圆环。FPS 根据 DSH 中已启用的服务商及其 API Key 查询用量，按适配接口实际返回的内容显示余额、已用金额、额度或重置时间。零余额正常显示。接口未适配、查询失败或缺少数据时，相应账户或字段会自动隐藏。会话 Token 和上下文占用估算由 DSH 提供，单独显示。
+
+## 可选生图工具
+
+在「插件 → Four-pointed star → 图片生成」中按需开启，四项开关默认关闭。你可以在提示词中指定服务，也可以让 FPS 从已开启、已就绪的服务中选择。生成的图片进入会话「输出内容」，可用 DSH 原生预览打开。云端服务会接收生图提示词。
+
+图中开启 ComfyUI 是为了展示下载入口。只有点「下载并安装」才会开始安装。
+
+![四个生图开关，示例中开启了 ComfyUI 并显示下载按钮](docs/screenshots/04-image-generation.png)
+
+- **Z-Image Turbo**。无需 API Key。使用 Hugging Face 的共享 Space，适合快速试稿，受排队与每日 GPU 额度限制。
+- **CogView-3-Flash**。智谱免费 Flash 模型，适合常规画质需求。需要智谱开放平台 API Key，受服务限流约束。
+- **Pollinations**。需要自己的 API Key。FPS 在实时目录标价为零时使用 SDXL Lightning 快速打样，服务仍可能要求账户有正的可用余额。
+- **ComfyUI + Comfy MCP**。通过 ComfyUI 和官方 Comfy MCP 在本机生图。开启后手动启动下载。随附的 SD 1.5 工作流适合约 512 像素的草图，安装需要 Python、Git、网络连接和 16 GiB 可用磁盘空间。
+
+安装步骤、凭证设置、平台要求和画质说明见插件详情。[图片生成说明](locale/detail.zh.md#可选生图工具)
+
+## 自定义
+
+- **外观**。在 DSH「设置 → 通用 → 外观」中选择浅色、深色或跟随系统。FPS 会同步切换侧栏、消息区、输入框和弹层的配色。
+- **模型和用量**。在 DSH「设置 → 模型」中添加或编辑自己的服务商、接口地址、模型和 API Key。再次打开用量面板即可按新配置查询。自定义地址的余额或额度需要对应的用量接口适配。使用纯文本模型时，可在同一处添加支持图片输入的模型，供 FPS 自动选择。
+- **工具和权限**。在 DSH 的「插件」中管理提供工具的插件，并在输入框下方选择会话模型和权限模式。工具能否调用取决于模型能力和当前会话权限。
+
+## 安装
+
+使用 DSH 0.2.2-rc.1 或更新版本的桌面端或 Web 会话界面。语音输入和文件预览等功能需要当前 DSH 配置启用相应组件。
+
+在 DSH「插件 → 添加插件」中选择 npm 仓库，输入 `dsh-fps-workbench`。也可从 [GitHub 最新版本](https://github.com/Blacstar7/dsh-fps-workbench/releases/latest)下载 `.tgz` 安装包，再选择本地路径安装。已安装 DSH 命令行时也可运行以下命令。
+
+```sh
+dsh plugin --profile desktop add dsh-fps-workbench
+```
+
+Web 配置将 `desktop` 换成 `web`。按 DSH 提示重启。
+
+### 从 v0.1.76 或更早版本换装
+
+先保存未发送的附件。在「插件 → 已安装」卸载包名为 `@local/claude-code-workbench` 的旧版 Four-pointed star，再在同一个 DSH 配置中安装 `dsh-fps-workbench`，按提示重启。新版会读取已有的生图开关、已保存的凭证和本地用量配置。DSH 会话和工作区保存在原配置里，同一浏览器或桌面配置中的文字草稿也可继续使用。未发送的附件只保存在页面内存中，重新加载会清除。
+
+### 已知问题
+
+**DSH 桌面端升级到 `0.2.2-rc.2` 后，会话和自动化任务可能无法加载。** 如果桌面配置仍加载旧版电脑操作组件带入的 `0.2.2-rc.1` 存储依赖，无论 FPS 是否开启，都可能遇到这个问题。请先备份桌面配置，将旧版电脑操作组件及其存储依赖移出配置的依赖目录，再重启 DSH，让它加载当前版本自带的组件。
+
+## 许可证
+
+FPS 采用 [MIT 许可证](LICENSE)。