@muxiuesd/dsh-pixel-studio 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,12 @@
+# 更新记录
+
+## 0.2.0
+
+- 新增「打开图片」：把 PNG / JPEG / GIF / WebP / BMP 直接转成像素画，自动缩到 256 以内，可选自动提取配色（中位切分）/ 当前调色板 / PICO-8，可开 Floyd–Steinberg 抖动，导入前先看预览。
+- 「另存为」对话框新增导出倍率（1× / 2× / 3× / 4× / 6× / 8× / 12× / 16×，按单张 PNG 上限自动禁用超出的档位），选择会被记住；普通导出同样使用记住的倍率。
+- 新增「尺寸」：调整画布宽高（1–256），9 宫格锚点决定裁剪或扩边的方向，扩边补透明，支持撤销。
+- 撤销历史现在也记录画布尺寸，尺寸调整和绘制可以一起回退。
+
+## 0.1.1
+
+- 首个发布版本：三栏编辑器、铅笔 / 橡皮 / 油漆桶 / 吸管、1–8 方形笔刷、整数倍缩放、图层、36 色调色板（改色不动画布）、11 个新建尺寸预设、导出 1× PNG 到会话目录、`Ctrl+S` / `Ctrl+Shift+S`。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muxiuesd
+
+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,59 @@
-# Temporary Holding Version
+# dsh-pixel-studio
 
-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.
+在 DeepSeek Harness（DSH）里画像素画：会话页签里一个三栏编辑器，左工具、中画布、右调色板，滚轮缩放、图层、导出 PNG，作品存在本机。
+
+## 装法
+
+三种都可以，装完刷新页面，会话页签行里会出现“像素画”。
+
+```bash
+# 1) 官方插件管理页 / 插件市场里搜索 @muxiuesd/dsh-pixel-studio
+# 2) DSH CLI（npm）
+dsh plugin --profile web add @muxiuesd/dsh-pixel-studio
+# 3) 直接从 GitHub 仓库装（仓库根就是插件包）
+dsh plugin --profile web add github:Muxiuesd/dsh-pixel
+# 4) 本地开发
+dsh plugin --profile web add /绝对路径/dsh-pixel
+```
+
+## 能做什么
+
+- **画布**：整数倍缩放 `1×…64×`，滚轮以光标为锚点；空格/中键拖动平移，`F` 适应窗口；`4×` 以上显示格线（可关）。
+- **工具**：铅笔、橡皮、油漆桶（按合成后的颜色判断连通，视觉同色一次填满）、吸管；方形笔刷 `1–8` 像素。
+- **图层**：最多 8 层，新建/复制/合并/上移/下移/删除/改名/显隐，全部可撤销。
+- **调色板**：最多 36 色，内置 PICO-8 等预设板；改某个槽位的颜色**不会改动已经画好的像素**（画布上的旧颜色会先由一个空闲槽位接手），也可以用系统取色器可视化取色。
+- **作品**：新建时填名字和尺寸（1–256），另有 11 个常用尺寸预设；自动保存。
+- **打开图片**：选一张喜欢的 PNG / JPEG / GIF / WebP / BMP，自动缩到 256 以内并按需提取配色（也可沿用当前调色板或 PICO-8），可开抖动，生成一个新作品继续画。
+- **画布尺寸 / 裁剪**：`尺寸` 里改宽高（1–256），9 宫格锚点决定裁掉哪边或从哪边扩边，改完可以撤销。
+- **导出**：首次导出选择保存位置（默认从当前会话目录开始），之后导出直接覆盖那个文件；`另存为` 随时换位置，并可挑 1×–16× 的导出倍率（会记住上次的选择）。
+
+## 快捷键
+
+| 键 | 作用 |
+| --- | --- |
+| `B` / `E` / `G` / `I` | 铅笔 / 橡皮 / 油漆桶 / 吸管 |
+| `[` `]` | 笔刷变小 / 变大 |
+| `H` | 格线开关 |
+| `F` | 适应窗口 |
+| `+` / `-` | 放大 / 缩小 |
+| 空格 + 拖动、鼠标中键 | 平移画布 |
+| `Ctrl/Cmd+Z` / `Ctrl/Cmd+Shift+Z`（或 `Ctrl+Y`） | 撤销 / 重做 |
+| `Ctrl/Cmd+S` | 保存 |
+| `Ctrl/Cmd+Shift+S` | 另存为 PNG |
+
+## 数据与能力
+
+- 作品存在 `<profile 目录>/../pixel-studio/works.json`（默认 `~/.dsh/pixel-studio/works.json`），不上传、不联网。
+- 插件只注册一个 Host 路由 `/dsh-pixel-studio`（同源 `fetch`），用于读写作品与写 PNG 文件；不执行命令、不访问网络。
+- 导出的 PNG 由插件自己编码（IHDR + zlib + IEND），不依赖任何图像库。
+
+## 环境
+
+- DSH 0.2.x（Web / Desktop 均可），Node.js ≥ 20。
+- 客户端用 `window.__ModuleLoader__` 加载，`react` 走宿主模块表，不打包 React。
+
+## 许可
+
+MIT © 2026 Muxiuesd
+
+源码与问题反馈：<https://gitee.com/muxiuesd12138/dsh-pixel>（GitHub 镜像：<https://github.com/Muxiuesd/dsh-pixel>）