dsh-skill-deterministic-pixel-art 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +72 -16
- package/README.zh-CN.md +61 -14
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -6,23 +6,58 @@ Optional third-party DSH bundle carrying the original `deterministic-pixel-art`
|
|
|
6
6
|
Skill, references, editable examples, Python renderer and recipes. Users and
|
|
7
7
|
models can invoke it as needed; a same-name local Skill can take precedence.
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## Already installed: start a conversation
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
Open a conversation in the same DSH profile where the plugin is installed and
|
|
12
|
+
enabled, then send:
|
|
12
13
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
14
|
+
> Use deterministic-pixel-art to make a 16×16 pixel lantern with a transparent background. Read the Skill and check the available Python/Pillow environment first. Deliver the PNG, editable JSON and an 8× nearest-neighbor preview, and inspect the finished image.
|
|
15
|
+
|
|
16
|
+
After receiving the image, you can continue:
|
|
17
|
+
|
|
18
|
+
> Change only the lantern's metal outline to dark brown. Keep the glass and everything else unchanged. Preserve the first version and deliver a separate revised PNG with its editable source.
|
|
19
|
+
|
|
20
|
+
You can also provide an existing PNG and describe the region to change, what to
|
|
21
|
+
preserve and the intended result. You do not need to learn commands or JSON first.
|
|
22
|
+
Provide references or explicit requirements for a particular game style.
|
|
23
|
+
|
|
24
|
+
Expect a native-size PNG and editable source. An enlarged preview alone is not
|
|
25
|
+
enough. Desktop tools can deliver files directly; command-line-only environments
|
|
26
|
+
should return absolute file paths.
|
|
27
|
+
|
|
28
|
+
## Installation and compatible versions
|
|
29
|
+
|
|
30
|
+
| Name | Purpose |
|
|
31
|
+
| --- | --- |
|
|
32
|
+
| Deterministic Pixel Art | Display name |
|
|
33
|
+
| `dsh-skill-deterministic-pixel-art` | npm package name |
|
|
34
|
+
| `deterministic-pixel-art` | Skill name to use in a conversation |
|
|
35
|
+
|
|
36
|
+
This directory targets bundle **0.1.1**, supporting DSH core and DSH Skill
|
|
37
|
+
**0.2.2-rc.1 through 0.2.2-rc.3**. Node must be **>=24.9.0** and Cordis
|
|
38
|
+
**~4.1.0**. Drawing requires Python **3.10+** and Pillow **>=10.4,<13**.
|
|
39
|
+
Earlier versions, future release candidates and stable releases are outside this
|
|
40
|
+
declaration. Desktop app and core versions differ; check the core with that
|
|
41
|
+
installation's `dsh --version`.
|
|
42
|
+
|
|
43
|
+
Use DSH's supported npm plugin installation method to install and enable the
|
|
44
|
+
package in the profile used for chat. CLI users with an existing working profile
|
|
45
|
+
can replace `YOUR-PROFILE` with its non-`desktop` profile name:
|
|
46
|
+
|
|
47
|
+
```text
|
|
48
|
+
dsh plugin --profile YOUR-PROFILE add dsh-skill-deterministic-pixel-art@0.1.1
|
|
16
49
|
```
|
|
17
50
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
51
|
+
If 0.1.1 is absent from the registry, it has not been published yet. Build a local
|
|
52
|
+
candidate using the [instructions below](#build-a-local-package); the old 0.1.0
|
|
53
|
+
package declares support for rc.1 only. The npm CLI does not manage Electron's
|
|
54
|
+
reserved `desktop` profile; use the desktop's plugin interface or bundled command.
|
|
55
|
+
npm installation does not require a marketplace listing.
|
|
22
56
|
|
|
23
|
-
##
|
|
57
|
+
## Optional: create a command-line profile
|
|
24
58
|
|
|
25
|
-
|
|
59
|
+
Skip this section if you already have a working profile. Use the official DSH CLI,
|
|
60
|
+
or run `dsh` inside **DSH Terminal** in DSH NEXT. Choose an unused profile name;
|
|
26
61
|
the examples use `pixel-art`. Initialize it **once, before installing**:
|
|
27
62
|
`--from-default-profile` replaces the target profile, including its plugins and
|
|
28
63
|
local configuration. Do not rerun that initialization to start another task.
|
|
@@ -32,18 +67,18 @@ dsh --profile pixel-art --from-default-profile headless --help
|
|
|
32
67
|
```
|
|
33
68
|
|
|
34
69
|
This initializes the profile without a model call. Then choose **one** installation
|
|
35
|
-
method. When the official npm registry provides version **0.1.
|
|
70
|
+
method. When the official npm registry provides version **0.1.1**, use its exact
|
|
36
71
|
package version:
|
|
37
72
|
|
|
38
73
|
```text
|
|
39
|
-
dsh plugin --profile pixel-art add dsh-skill-deterministic-pixel-art@0.1.
|
|
74
|
+
dsh plugin --profile pixel-art add dsh-skill-deterministic-pixel-art@0.1.1
|
|
40
75
|
```
|
|
41
76
|
|
|
42
|
-
|
|
43
|
-
path instead; quote paths containing spaces:
|
|
77
|
+
For a local candidate, build the archive using the instructions below and use its
|
|
78
|
+
absolute path instead; quote paths containing spaces:
|
|
44
79
|
|
|
45
80
|
```text
|
|
46
|
-
dsh plugin --profile pixel-art add "/absolute/path/to/dsh-skill-deterministic-pixel-art-0.1.
|
|
81
|
+
dsh plugin --profile pixel-art add "/absolute/path/to/dsh-skill-deterministic-pixel-art-0.1.1.tgz"
|
|
47
82
|
```
|
|
48
83
|
|
|
49
84
|
Both methods install into `pixel-art`; Desktop uses a separate profile.
|
|
@@ -110,6 +145,12 @@ version before a model task. `ACCOUNT_SIGN_IN_REQUIRED` means the account route
|
|
|
110
145
|
is unavailable: check the overlay, normal sign-in and `DSH_HOME`, rather than
|
|
111
146
|
reinstalling the Skill. A same-name local Skill can override the bundled one.
|
|
112
147
|
|
|
148
|
+
On Windows, `sandbox-local: windows-acl workspace grant failed` can stop shell
|
|
149
|
+
commands before Python starts. Try a separate task folder under your user
|
|
150
|
+
directory, where your account has full control, while keeping `workspace-write`.
|
|
151
|
+
If it persists, use DSH's sandbox diagnostics; reinstalling this bundle does not
|
|
152
|
+
repair host permissions.
|
|
153
|
+
|
|
113
154
|
## Verification and sources
|
|
114
155
|
|
|
115
156
|
Platform validation uses Windows DSH NEXT **2.0.22-next**, core **0.2.2-rc.1**,
|
|
@@ -117,6 +158,8 @@ Node **24.21.0**, Python **3.12.14** and Pillow **12.3.0**. Run
|
|
|
117
158
|
`python -B tools/check_dsh.py` with Node/npm and development requirements to
|
|
118
159
|
build and check the actual archive, real Skill services and relocated renderer.
|
|
119
160
|
That check requires no model call.
|
|
161
|
+
CI uses `--skill-version` to check the three matching service versions on Windows
|
|
162
|
+
and Ubuntu.
|
|
120
163
|
|
|
121
164
|
`tools/package_dsh.py` reuses the authoritative inputs in `skill-content/`,
|
|
122
165
|
`src/`, `recipes/` and existing examples. Generated resources are not maintained
|
|
@@ -125,3 +168,16 @@ bundled. See LICENSE and NOTICE.md for licensing and sources.
|
|
|
125
168
|
|
|
126
169
|
This project is not endorsed by DeepSeek. For native Skill installation, follow
|
|
127
170
|
[INSTALL.md](https://github.com/Chenamel/deterministic-pixel-art/blob/main/INSTALL.md).
|
|
171
|
+
|
|
172
|
+
## Build a local package
|
|
173
|
+
|
|
174
|
+
Only source development and local candidate acceptance need this section. From a
|
|
175
|
+
checkout with Python and the repository's development requirements:
|
|
176
|
+
|
|
177
|
+
```sh
|
|
178
|
+
python -B tools/package_dsh.py --out dist/dsh-package
|
|
179
|
+
npm pack ./dist/dsh-package --ignore-scripts --pack-destination dist
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
The package output directory must be new. The archive has no installation scripts;
|
|
183
|
+
ordinary use can install the npm package directly.
|
package/README.zh-CN.md
CHANGED
|
@@ -6,22 +6,52 @@
|
|
|
6
6
|
说明、Python 工具、配方和可编辑示例。用户与模型都可按需调用;同名本地 Skill
|
|
7
7
|
可以优先使用。
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## 已安装:直接开始对话
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
在已安装并启用插件的同一个 DSH 配置中开启对话,发送:
|
|
12
12
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
13
|
+
> 请使用 deterministic-pixel-art,制作一个 16×16、透明背景的像素提灯。先读取这个 Skill 并检查可用的 Python/Pillow 环境。交付 PNG、可继续修改的 JSON,以及 8 倍最近邻预览;完成后看图检查。
|
|
14
|
+
|
|
15
|
+
拿到图片后可以继续说:
|
|
16
|
+
|
|
17
|
+
> 只把提灯的金属边框改成深棕色,玻璃和其他部分保持原样。保留初版,另交修改后的 PNG 和源文件。
|
|
18
|
+
|
|
19
|
+
也可以提供已有 PNG,指出要修改的区域、保留的部分及目标效果。不必先学习命令
|
|
20
|
+
或 JSON;需要特定游戏风格时,提供参考图或明确要求。
|
|
21
|
+
|
|
22
|
+
应收到原尺寸 PNG 和可编辑源文件。只有放大预览图还不够;桌面可直接交付文件,
|
|
23
|
+
仅命令行环境则应返回文件的绝对路径。
|
|
24
|
+
|
|
25
|
+
## 安装与兼容版本
|
|
26
|
+
|
|
27
|
+
| 名称 | 用途 |
|
|
28
|
+
| --- | --- |
|
|
29
|
+
| Deterministic Pixel Art | 展示名称 |
|
|
30
|
+
| `dsh-skill-deterministic-pixel-art` | npm 安装包名 |
|
|
31
|
+
| `deterministic-pixel-art` | 对话中使用的 Skill 名称 |
|
|
32
|
+
|
|
33
|
+
本目录对应 bundle **0.1.1**,支持 DSH core 与 DSH Skill
|
|
34
|
+
**0.2.2-rc.1 至 0.2.2-rc.3**。Node 要求 **>=24.9.0**,Cordis 为
|
|
35
|
+
**~4.1.0**;绘图需要 Python **3.10+**、Pillow **>=10.4,<13**。
|
|
36
|
+
更早版本、未来 rc 及正式版不在兼容声明内。桌面应用版本与内核版本不同,可用
|
|
37
|
+
该安装的 `dsh --version` 核对内核。
|
|
38
|
+
|
|
39
|
+
通过 DSH 支持的 npm 插件安装入口,将包装入实际用于聊天的配置并启用。
|
|
40
|
+
已有正常配置的 CLI 用户,可将 `YOUR-PROFILE` 换成自己的非 `desktop` profile:
|
|
41
|
+
|
|
42
|
+
```text
|
|
43
|
+
dsh plugin --profile YOUR-PROFILE add dsh-skill-deterministic-pixel-art@0.1.1
|
|
16
44
|
```
|
|
17
45
|
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
46
|
+
若 registry 尚无 0.1.1,说明该版本尚未发布;本地候选按文末的
|
|
47
|
+
[打包说明](#生成本地包)生成,不要将仅声明 rc.1 的旧 0.1.0 当作新版替代。
|
|
48
|
+
npm CLI 不管理 Electron 专用的 `desktop` profile;桌面使用其自身的插件入口
|
|
49
|
+
或内置命令。npm 安装无需等待市场收录。
|
|
21
50
|
|
|
22
|
-
##
|
|
51
|
+
## 可选:新建命令行配置
|
|
23
52
|
|
|
24
|
-
|
|
53
|
+
已有可用配置可以跳过本节。使用官方 DSH CLI,或在 DSH NEXT 的
|
|
54
|
+
**DSH Terminal** 中运行 `dsh`,选择未使用过的 profile 名称;
|
|
25
55
|
以下用 `pixel-art`。**先初始化一次,再安装插件**:`--from-default-profile`
|
|
26
56
|
会替换目标 profile,包括其中的插件和本地配置。以后启动任务不要重复初始化。
|
|
27
57
|
|
|
@@ -30,16 +60,16 @@ dsh --profile pixel-art --from-default-profile headless --help
|
|
|
30
60
|
```
|
|
31
61
|
|
|
32
62
|
这条命令初始化配置,不调用模型。随后**选择一种**安装方式。官方 npm registry
|
|
33
|
-
提供 **0.1.
|
|
63
|
+
提供 **0.1.1** 时,使用精确包版本:
|
|
34
64
|
|
|
35
65
|
```text
|
|
36
|
-
dsh plugin --profile pixel-art add dsh-skill-deterministic-pixel-art@0.1.
|
|
66
|
+
dsh plugin --profile pixel-art add dsh-skill-deterministic-pixel-art@0.1.1
|
|
37
67
|
```
|
|
38
68
|
|
|
39
|
-
|
|
69
|
+
本地候选按文末说明生成归档,改用其绝对路径;含空格路径保留引号:
|
|
40
70
|
|
|
41
71
|
```text
|
|
42
|
-
dsh plugin --profile pixel-art add "/absolute/path/to/dsh-skill-deterministic-pixel-art-0.1.
|
|
72
|
+
dsh plugin --profile pixel-art add "/absolute/path/to/dsh-skill-deterministic-pixel-art-0.1.1.tgz"
|
|
43
73
|
```
|
|
44
74
|
|
|
45
75
|
两种方式都安装到 `pixel-art`;Desktop 使用独立的 profile。
|
|
@@ -99,12 +129,18 @@ shell 检查 Python 和 Pillow。缺少它们属于运行前置条件,安装 b
|
|
|
99
129
|
表示账户路线不可用,应检查 overlay、正常登录和 `DSH_HOME`,不必重装 Skill。
|
|
100
130
|
同名本地 Skill 会覆盖随包版本。
|
|
101
131
|
|
|
132
|
+
Windows 若出现 `sandbox-local: windows-acl workspace grant failed`,shell 命令
|
|
133
|
+
可能在 Python 启动前就被阻止。可保持 `workspace-write`,先将任务副本放到用户
|
|
134
|
+
目录下、当前账户具有完全控制权限的独立文件夹再试。若仍失败,使用 DSH 的沙箱
|
|
135
|
+
诊断;重装本 bundle 无法修复宿主目录权限。
|
|
136
|
+
|
|
102
137
|
## 验证与来源
|
|
103
138
|
|
|
104
139
|
本机验证基线为 Windows DSH NEXT **2.0.22-next**、core **0.2.2-rc.1**、Node
|
|
105
140
|
**24.21.0**、Python **3.12.14**、Pillow **12.3.0**。
|
|
106
141
|
`python -B tools/check_dsh.py` 需要 Node/npm 和开发依赖,检查实际归档、真实
|
|
107
142
|
Skill 服务与搬移后的绘图工具,不需要模型调用。
|
|
143
|
+
CI 在 Windows 和 Ubuntu 分别用 `--skill-version` 检查三版配套服务。
|
|
108
144
|
|
|
109
145
|
`tools/package_dsh.py` 复用 `skill-content/`、`src/`、`recipes/` 与原示例目录的
|
|
110
146
|
权威输入;不手工维护生成资源,不建立第二套绘制引擎。`skill-manifest.json`
|
|
@@ -113,3 +149,14 @@ Skill 服务与搬移后的绘图工具,不需要模型调用。
|
|
|
113
149
|
本项目不是 DeepSeek 官方插件。也可以按原仓库的
|
|
114
150
|
[INSTALL.md](https://github.com/Chenamel/deterministic-pixel-art/blob/main/INSTALL.md)
|
|
115
151
|
直接安装原生 Skill。
|
|
152
|
+
|
|
153
|
+
## 生成本地包
|
|
154
|
+
|
|
155
|
+
仅源码开发或本地候选验收需要本节。在源码仓库安装 Python 和开发依赖后运行:
|
|
156
|
+
|
|
157
|
+
```sh
|
|
158
|
+
python -B tools/package_dsh.py --out dist/dsh-package
|
|
159
|
+
npm pack ./dist/dsh-package --ignore-scripts --pack-destination dist
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
生成目录必须不存在。包没有安装脚本;通常使用者直接安装 npm 包即可。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-skill-deterministic-pixel-art",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Third-party DSH bundle for the Deterministic Pixel Art Skill and its editable PNG tools.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "index.js",
|
|
@@ -34,11 +34,11 @@
|
|
|
34
34
|
},
|
|
35
35
|
"engines": {
|
|
36
36
|
"node": ">=24.9.0",
|
|
37
|
-
"dsh": "0.2.2-rc.1"
|
|
37
|
+
"dsh": ">=0.2.2-rc.1 <=0.2.2-rc.3"
|
|
38
38
|
},
|
|
39
39
|
"peerDependencies": {
|
|
40
40
|
"@deepseek-ai/cordis": "~4.1.0",
|
|
41
|
-
"@deepseek-ai/dsh-skill": "0.2.2-rc.1"
|
|
41
|
+
"@deepseek-ai/dsh-skill": ">=0.2.2-rc.1 <=0.2.2-rc.3"
|
|
42
42
|
},
|
|
43
43
|
"devDependencies": {
|
|
44
44
|
"@deepseek-ai/cordis": "~4.1.0",
|