Skip to content

Add cross-platform POSIX scripts and Docker-based dev path (improve contributor experience) #108

Description

@loootte

Problem

仓库脚本以 PowerShell 为主,这对非 Windows 的贡献者(macOS/Linux)不太友好,虽然有部分 Git Bash 脚本。为了扩大贡献者范围并支持 Docker-based 开发,建议补充跨平台开发脚本与文档。

Proposed work

  • 提供 posix shell (bash) 版本的关键脚本:start.sh、stop.sh、dev-core.sh、dev-desktop.sh,功能与 PowerShell 等价
  • 在 scripts/README.md 中增加 cross-platform 使用说明与示例(包括 macOS、Linux 的依赖、如何启用 mock 引擎)
  • 增加一个 Docker 化的 dev path:scripts/dev-docker.sh,能在容器里运行 core(可选挂载本地源码)以便无本机 Python 环境的人开发或跑 CI smoke tests
  • 在 CI 文档中说明在非 Windows 环境如何本地复现 CI 步骤(desktop build、core pytest mock)

Acceptance criteria

  1. scripts/start.sh / stop.sh / dev-core.sh / dev-desktop.sh 在仓库中可运行并在 Linux/macOS 下实现 README 中列出的功能(mock 模式优先)。
  2. scripts/dev-docker.sh 能在本地启动 core 容器并暴露 8765 端口以供 UI 调试。
  3. scripts/README.md 更新,包含 cross-platform 指南。

Notes

  • 保持 PowerShell 脚本为首选 Windows 路径,但确保 POSIX 路径与 CI 环境兼容。

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions