Skip to main content

ms-toolbox

MatsubaraSoda 个人工具箱

安装

需要 Python 3.12+。推荐使用 uv 安装为全局命令行工具:

# 从 PyPI 安装(推荐)
uv tool install ms-toolbox

工具列表

安装 ms-toolbox 后,下列命令均可直接使用;完整参数以各命令的 --help 输出为准。

pdf-extract — 提取 PDF 的指定页码范围,另存为新文件

pdf-extract -i input.pdf -o output.pdf --start 5 --end 10

把 input.pdf 的第 5 页到第 10 页(含首尾)保存为 output.pdf,成功时退出码为 0。

参数 必填 说明
-i, --input 是 输入 PDF 文件路径
-o, --output 是 输出 PDF 文件路径
--start 是 起始页码(1 起始,包含该页)
--end 是 结束页码(包含该页)

退出码:0 成功;1 提取失败;2 意外错误。

--- 正在启动 PDF 提取工具 ---
输入文件:input.pdf
输出文件:output.pdf
页码范围:5 到 10
成功提取第 5 页到第 10 页,并保存到 'output.pdf'。

tag-csv2str — 读取标签树 CSV,生成所有可能的标签组合

tag-csv2str -i test_tags.csv

输入格式见 tests/tag/test_data/test_tags.csv。从 <root> 开始递归遍历标签树(邻接表存储,深度优先展开)生成所有可能的标签组合;<root> 和带 <hidden> 前缀的节点仅用于组织树结构,不会进入最终组合。结果逐行输出到 stdout。

参数 必填 说明
-i, --input 是 输入标签树 CSV 文件路径

退出码:0 成功;2 意外错误(如 CSV 文件不存在)。状态信息输出到 stderr,组合结果输出到 stdout。

输入示例(CSV FILE/test_tags.csv):

<root>,<hidden>审查,<hidden>发型,long_hair
"<hidden>审查, 1girl, <hidden>发型",safe,short_hair,ponytail
,,short_hair,<hidden>
,,long_hair,
## -i flag
tag-csv2str -i test_tags.csv | Out-File -FilePath output.jsonl -Encoding utf8

输出示例(JSON):

{"tag_string": "safe, 1girl, short_hair"}
{"tag_string": "safe, 1girl, short_hair"}
{"tag_string": "safe, 1girl, long_hair, ponytail"}
{"tag_string": "safe, 1girl, long_hair"}

tag-tag2nl — 用 TIPO 扩写 tag_string

把每组 Danbooru tags 交给 TIPO 扩写,每组 tags 的扩写结果作为单行字符串输出到 stdout。运行前需在配置文件 %LOCALAPPDATA%\ms-toolbox\config.yaml 中指定 tipo_worker_python_exe,指向已装好下列依赖的解释器(版本为实测可用版本,不随本项目安装):

库 版本 说明
tipo-kgen 0.3.1 扩写核心
transformers 5.20.2 官方依赖限制较旧,5.x 实测可用但需额外安装 protobuf
sentencepiece 0.2.2 解析 tokenizer.model
protobuf 7.36.2 transformers 5.x 加载 tokenizer 所需补丁依赖
tiktoken 0.14.0 解析失败时的兜底
torch 2.6.0+cu124 CUDA 推理依赖
huggingface_hub 1.31.0 读取本地模型缓存
参数 必填 说明
-t, --tags 否;不填时走 stdin 一个或多个 tag_string。

退出码:0 成功;2 意外错误。

输入示例(JSONL / input.jsonl):

{"tag_string": "safe, 1girl, short_hair"}
{"tag_string": "safe, 1girl, short_hair"}
{"tag_string": "safe, 1girl, long_hair, ponytail"}
{"tag_string": "safe, 1girl, long_hair"}
## -t flag
tag-tag2nl -t "safe, 1girl, short_hair" "safe, 1girl, short_hair" "safe, 1girl, long_hair, ponytail" "safe, 1girl, long_hair"

## stdin
Get-Content input.jsonl -Raw | tag-tag2nl | Out-File -FilePath output.jsonl -Encoding utf8

## 输出均为 stdout jsonl

输出示例(JSONL / output.jsonl):

{"prompt": "1girl, \n\nshort hair, simple background, hair between eyes, fangs, open mouth, looking at viewer, frills, bow, bat wings, red eyes, solo, center frills, blush, grey hair, bowtie, wrist cuffs, shirt, outstretched arms, :d, full body, no headwear, black dress, red bow, white background, smile, white shirt, short sleeves, wings, red bowtie, blush stickers, dress, puffy sleeves, standing, petticoat, red footwear, standing on one leg, puffy short sleeves,\n\na charming illustration by the artist cato (monocatienus), known for their whimsical and detailed style. The central figure is Remilia Scarlet, depicted in a full-body shot with her arms outstretched as if welcoming the viewer into her world. She is dressed in an elegant black dress adorned with frills and puffy short sleeves, complemented by red footwear that matches her eyes. The background is simple and white, allowing Remilia to stand out prominently.\n\nsafe"}
{"prompt": "1girl, \n\nshort hair, blush, short sleeves, bow, looking at viewer, fangs, no headwear, simple background, puffy sleeves, red footwear, full body, wings, frills, standing on one leg, white shirt, red bowtie, grey hair, center frills, solo, white background, wrist cuffs, red eyes, open mouth, dress, petticoat, standing, :d, outstretched arms, red bow, blush stickers, smile, puffy short sleeves, bowtie, hair between eyes, black dress, bat wings, shirt,\n\na character from the Touhou series, illustrated in the distinctive style of artist kame (kamepan44231). The central figure is Remilia Scarlet, depicted with her signature pale skin and striking red eyes. She has short, light purple hair and wears a black dress adorned with white ruffles at the hem. Her most notable feature is the pair of bat-like wings that extend from her back, adding an ethereal quality to her appearance.\n\nsafe"}
{"prompt": "1girl, \n\nlong hair, ponytail, bow, solo, hand up, white socks, blue bowtie, white apron, looking at viewer, blue eyes, apron, socks, open mouth, blue dress, frills, dress, black footwear, frilled apron, short sleeves, blue bow, puffy short sleeves, white headwear, grey hair, standing on one leg, very long hair, blush stickers, wrist cuffs, white background, bowtie, standing, shoes, puffy sleeves, maid headdress, hat, simple background, full body,\n\na charming illustration by the artist saijo1201, known for their whimsical and detailed style. The central figure is a young girl with long, flowing silver hair adorned with blue ribbons. She wears a white apron over her dress and has striking black shoes with bows on them. Her eyes are large and expressive, adding to the overall cuteness of the image.\n\nsafe"}
{"prompt": "1girl, \n\nlong hair, tail ornament, blush, thighhighs, purple eyes, tail raised, closed mouth, very long hair, shirt, frilled skirt, black shirt, breasts, skirt, sleeveless shirt, tail bow, looking at viewer, bow, animal ears, hand up, blue bow, cat girl, hairband, sleeveless, white background, bare shoulders, small breasts, cat ears, pleated skirt, white hair, wrist cuffs, purple skirt, grey thighhighs, frills, simple background, black hairband, animal ear fluff, cat tail, solo,\n\nA young girl with long white hair and purple eyes. she is wearing a black dress with a blue ribbon tied around her waist and a pair of cat ears on her head. the background is white, making the girl and her outfit stand out. the overall style of the illustration is anime-inspired.\n\nsafe"}

本地开发

git clone https://github.com/MatsubaraSoda/ms-toolbox
cd ms-toolbox
uv sync             # 创建虚拟环境并安装依赖(含开发依赖)
uv run pytest -v    # 运行测试

许可证

本项目基于 MIT License 发布。

Metadata

Release files for ms-toolbox 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ms-toolbox 0.1.2
File Size Uploaded Provenance Actions
ms_toolbox-0.1.2.tar.gz 13.9 kB With provenance Details for ms_toolbox-0.1.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ms-toolbox 0.1.2
File Interpreter ABI Platform Actions
ms_toolbox-0.1.2-py3-none-any.whl Python 3 none any Details for ms_toolbox-0.1.2-py3-none-any.whl

Total release size: 30.8 kB

Release files / ms_toolbox-0.1.2.tar.gz

Download URL ms_toolbox-0.1.2.tar.gz
Size 13.9 kB
Tags Source
SHA-256 checksum
How to use checksums
e3db9c889ff80c50ac667a7af75cd86f5b5f6aa0fba0a233ce743c0c146c6f3c
BLAKE2b-256 checksum
How to use checksums
7ad00dfbc0faa2acd17bba0f5ad24187ee76df00a7d1718d5bcd5fd522aa6849
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Release files / ms_toolbox-0.1.2-py3-none-any.whl

Download URL ms_toolbox-0.1.2-py3-none-any.whl
Size 16.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d63ae6ecaaad6675397d4b34a20f7730cbe930ea1c9d8be766b6f07e19d918ec
BLAKE2b-256 checksum
How to use checksums
239679f615b520a8d4cddeae673f963b67f1b60999534bedf07ba5f09aec4283
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

Security for ms-toolbox 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for ms_toolbox-0.1.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page