dsh-porter
其他 活跃维护

dsh-porter

ShatterDusk/dsh-porter

支持会话数据跨根迁移、状态检查、损坏修复与格式转换,无需依赖原会话工具即可运行,操作逻辑简洁高效,可快速完成各类会话数据运维需求。

0
Stars 标星
0
Forks 分支
0
Watchers 关注
0
Open Issues
JavaScript
主要语言
MIT
开源协议
87 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:ShatterDusk/dsh-porter
git clone https://github.com/ShatterDusk/dsh-porter.git
git clone git@github.com:ShatterDusk/dsh-porter.git
README.md main

dsh-porter

npm version
license
node

DSH 会话数据运维 CLI:跨根迁移(含 workspace 归属同步)、体检、修复、格式转换。零 dsh 依赖。

DSH 会话文件不能直接复制迁移(cwd 路径编码写在数据里、格式严格、归属状态分离)——dsh-porter 处理这些。详见 docs/format.md。

Install

npm install -g dsh-porter

Requires Node >= 20.11.

Quick Start

# 体检数据根
dsh-porter inspect ~/.dsh

# 迁移预览 → 执行(Windows 根 → WSL 根)
dsh-porter migrate /mnt/c/Users/1/.dsh ~/.dsh --direction to-wsl --dry-run
dsh-porter migrate /mnt/c/Users/1/.dsh ~/.dsh --direction to-wsl

Commands

Command Description
migrate <src> <dst> --direction to-wsl|to-win|auto 跨根迁移会话:cwd 转化 + 格式合规重写 + workspace 归属同步
inspect <session|root> 体检:健康状态/帧数/行数/版本
convert <file> --format zstd|plain zstd ↔ 明文互转
repair <file> 修复损坏会话(torn 截断/污染隔离)
archive <src> <dst> 归档:迁移 + 两阶段删源

所有命令支持 --json 与语义化退出码(0 成功 / 1 部分失败 / 2 用法 / 3 环境)。

Research

  • docs/format.md — DSH 会话格式研究(帧结构 / header schema / 兼容约束;生态内首份公开文档)

Test

npm test

License

MIT