本页是 Dev Toolkit 的规范指南：本地双栏工具，覆盖 semver、chmod、docker run → Compose 以及列表/JSON。请先选择上方模式；所有转换均在浏览器中运行。

Dev Toolkit 将六种转换收进 IDE 风格面板。左侧粘贴、选择模式、右侧复制结构化输出。剪贴板启发式可能建议 Semver、Chmod 或 Docker。

你将得到

• semver-parse — major/minor/patch, prerelease, build
• chmod-convert — octal ↔ symbolic (755 ↔ rwxr-xr-x)
• docker-compose — docker run → Compose YAML
• list-to-json — newline → JSON string array
• json-to-list — JSON array → newline list
• columns-to-json — header CSV → JSON objects (simple comma split)

在以下情况使用

• 在以下情况使用: Semver / release notes / CI
• 在以下情况使用: chmod octal ↔ symbolic
• 在以下情况使用: docker run → Compose
• 在以下情况使用: list ↔ JSON cleanup

Dev Toolkit 模式

此工具如何帮助

1. 选择模式（Semver、Chmod、Docker Compose 或列表）。
2. 在左侧粘贴输入；Docker 以 docker run 开头；Columns → JSON 需包含表头行。
3. 查看右侧面板（以及 Semver/Chmod 详情块）。
4. 将输出复制到 Compose、文档、CI 或 JSON Formatter。
5. 若出错，查阅修复指南；不要在未调整输入时盲目切换模式。

模式: semver-parse — v?MAJOR.MINOR.PATCH[-pre][+build].

何时使用

• 何时使用: changelog / flags
• 何时使用: normalize v1.0.0
• 何时使用: check prerelease/build

常见错误

• 常见错误: 1.2 (need three parts)
• 常见错误: ^1.2.3 ranges
• 常见错误: Maven/CalVer

模式: chmod-convert — octal ↔ rwxr-xr-x.

何时使用

• 何时使用: Dockerfile 755 → symbolic
• 何时使用: ls -l → octal

常见错误

• 常见错误: sticky bits round-trip
• 常见错误: need nine r/w/x/- chars
• 常见错误: permissions only

模式: docker-compose — maps -e/-p/-v/--name only.

何时使用

• 何时使用: one-liner → Compose starter
• 何时使用: document local deps

已映射标志

• -e / --env → environment
• -p / --publish → ports
• -v / --volume → volumes
• --name → service key

常见错误

• 常见错误: must start with docker run
• 常见错误: --rm/network/gpus ignored
• 常见错误: missing image
• 常见错误: complex quoting

模式: list-to-json, json-to-list, columns-to-json.

List → JSON

模式: list-to-json — trim lines, drop blanks, JSON array.

JSON → List

模式: json-to-list — JSON array only; objects become [object Object].

Columns → JSON

模式: columns-to-json — simple comma split, not full CSV. Use CSV Viewer for quoted commas.

常见错误: v2.4.0-rc.3+build for release checklist.

此工具如何帮助

1. 选择模式（Semver、Chmod、Docker Compose 或列表）。
2. 在左侧粘贴输入；Docker 以 docker run 开头；Columns → JSON 需包含表头行。
3. 查看右侧面板（以及 Semver/Chmod 详情块）。

结果：可粘贴到文档、CI 或 Compose 的清晰输出。

常见错误: docker run -p/-e/--name only in README.

此工具如何帮助

1. 选择模式（Semver、Chmod、Docker Compose 或列表）。
2. 在左侧粘贴输入；Docker 以 docker run 开头；Columns → JSON 需包含表头行。
3. 查看右侧面板（以及 Semver/Chmod 详情块）。
4. 将输出复制到 Compose、文档、CI 或 JSON Formatter。

结果：可粘贴到文档、CI 或 Compose 的清晰输出。

常见错误: messy lines → JSON array.

此工具如何帮助

1. 选择模式（Semver、Chmod、Docker Compose 或列表）。
2. 在左侧粘贴输入；Docker 以 docker run 开头；Columns → JSON 需包含表头行。
3. 查看右侧面板（以及 Semver/Chmod 详情块）。
4. 将输出复制到 Compose、文档、CI 或 JSON Formatter。

结果：可粘贴到文档、CI 或 Compose 的清晰输出。

常见错误: Invalid semver — expected major.minor.patch.

发生原因

发生原因

诊断

诊断

修复

1. 选择模式（Semver、Chmod、Docker Compose 或列表）。
2. 在左侧粘贴输入；Docker 以 docker run 开头；Columns → JSON 需包含表头行。
3. 查看右侧面板（以及 Semver/Chmod 详情块）。

常见错误: missing networks/restart or docker run / image errors.

发生原因

发生原因

诊断

诊断

修复

1. 选择模式（Semver、Chmod、Docker Compose 或列表）。
2. 在左侧粘贴输入；Docker 以 docker run 开头；Columns → JSON 需包含表头行。
3. 查看右侧面板（以及 Semver/Chmod 详情块）。

结果：可粘贴到文档、CI 或 Compose 的清晰输出。

• 对分号 CSV 或带引号逗号使用 Columns → JSON
• 向 JSON → List 传入非数组对象
• 期望 chmod sticky 位完美往返
• 假定 Docker 保留 --rm、--network 或 healthchecks
• 将 semver 范围当作单一版本解析