DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

zhibo0502 /

zhibo0502/dsh-zipfix

Topic repository only

ZIP 中文文件名乱码修复器 · DeepSeek Harness 插件(5 个 agent 工具 + Web 侧边栏上传修复 / mojibake filename fixer)

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@b744c02d

dsh-zipfix

CI npm License: MIT Node

DeepSeek Harness 插件:修复 ZIP 压缩包与已解压目录中的中文文件名乱码。提供 5 个 agent 工具和一个侧边栏上传面板。

ZIP 里的文件名如果按 GBK/Big5 编码写入却未置位 UTF-8 标志(通用位 bit 11),在 UTF-8 系统代码页下会显示为 ╢╖├┼、Ö·ÃÅ、���� 等乱码。本插件只修复文件名这一层,文件内容保持原样。

Features

  • 读取 ZIP 中央目录原始文件名字节,嗅探 UTF-8 / GBK / GB18030 / Big5 编码
  • 按正确文件名解压,逐条校验 CRC32;生成置位 UTF-8 文件名标志(0x0800)的修复版 ZIP
  • 已解压目录的形态 A(CP437 / Latin-1 / CP1252 → GBK)批量改名
  • U+FFFD 不可逆乱码:按源包 (size, CRC32) 唯一配对还原;无源包时用文档内部标题生成候选,并以编码指纹验证
  • 侧边栏「ZIP 修复」:上传 ZIP → 体检 → 下载修复版 ZIP 或按正确文件名解压
  • 零运行时依赖,无网络请求;不删除、不覆盖源文件

Packages

目录 说明
dist/dsh-zipfix/ 可发布单包 dsh-zipfix(工具 + 侧边栏 UI),由 tools/build-dist.mjs 生成
dsh-zipfix-plugin/ 修复核心与 5 个 agent 工具的源码包
dsh-zipfix-ui/ 侧边栏 UI 与 /zipfix-api 的源码包

Install

npm 包 dsh-zipfix(registry.npmjs.org),在 DSH 中安装:

plugin_manager { action: "install_bundle", target: "dsh-zipfix@0.4.0" }

DSH 插件市场索引(发现 → 添加索引源):

https://raw.githubusercontent.com/zhibo0502/dsh-zipfix/main/plugin-index.json

本地目录安装:

plugin_manager { action: "install_bundle", target: "<仓库目录>/dist/dsh-zipfix" }

安装后任意会话可用 zipfix_* 工具,左侧边栏出现「ZIP 修复」入口。

Tools

工具 作用
zipfix_scan 只读体检:编码判定、形态分类、可修复条目、下一步建议
zipfix_fix_zip 解压 + 生成修复版 ZIP;dryRun 默认开启,force 可强制处理合规包
zipfix_rename_dir 已解压目录形态 A 批量改名
zipfix_match_source 形态 B:按 (size, CRC32) 与源 ZIP 唯一配对改名
zipfix_verify_names 内容反推 + 编码指纹验证

Development

npm ci
npm run lint          # ESLint
npm test              # 30 项自动测试 + dist 冒烟
npm run formal        # TLA+ / TLC 形式化验证
npm run build         # 生成 dist/dsh-zipfix
npm run build:check   # 校验 dist 与源码同步
npm run validate:index  # 用 DSH 官方校验器校验 plugin-index.json

CI 执行 lint / test / formal / build:check / validate:index。

Repository layout

dsh-zipfix-plugin/   # 修复核心 + 5 个工具(源码)
dsh-zipfix-ui/       # 侧边栏 UI + /zipfix-api(源码)
dist/dsh-zipfix/     # 可发布单包(生成物)
plugin-index.json    # DSH 插件市场索引(format 1)
spec/                # TLA+ 规格与 TLC 配置
tools/               # dist 组装、索引生成/校验、TLC 运行器
docs/publishing.md   # 发布说明

Security

  • 写操作默认 dry-run;同名目标自动加 _fixed 后缀;不删除、不覆盖源文件
  • /zipfix-api 所有路由先经 connection.requestRejection 宿主认证(fail closed),另有同源 CSRF token

License

MIT

—/ 5

No ratings yet

Manifest verification required

Commit b744c02d2e6b

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout