code-repo-wiki 0.5.0

自动分析代码仓库结构，通过 LLM 生成结构化项目文档（Code Repo Wiki）
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

name: Release

# 发布工作流（tag v* 触发）：
#   1. create-release   —— 创建 Draft GitHub Release（--generate-notes）
#   2. publish-crates-io —— crates.io 发布（Trusted Publishing，OIDC 免长期 token）
#   3. build-binaries   —— 矩阵构建并上传二进制到 Draft（共享 release-id，
#                          消除并发创建竞态——矩阵各 job 各自创建 Release 会
#                          反复 "release not found"）
#   4. publish-release  —— 全部二进制上传完成后 Draft → 正式发布
#
# 注意（首次发布）：
#   - 新 crate 不能走 Trusted Publishing，首次必须手动 `cargo publish`
#     （crates.io 账号验证邮箱 + cargo login 后手动执行一次）；
#   - 之后 tag vX.Y.Z 推送即自动触发本工作流。
#   - 仓库 Actions 写权限需为 Read and write（Settings → Actions → General →
#     Workflow permissions），否则 GITHUB_TOKEN 无法创建/编辑 Release。

on:
  push:
    tags:
      - "v*"

permissions:
  contents: write
  id-token: write # Trusted Publishing：向 crates.io 换取短期发布 token

concurrency:
  group: release-${{ github.ref }}
  cancel-in-progress: false

defaults:
  run:
    shell: bash

env:
  CARGO_TERM_COLOR: always

jobs:
  create-release:
    runs-on: ubuntu-latest
    outputs:
      release_id: ${{ steps.create.outputs.release_id }}
    steps:
      - uses: actions/checkout@v4
      # Draft Release 先行创建：build-binaries 矩阵各 job 通过 release-id
      # 上传到同一个 Draft；全部上传完成后由 publish-release 转为正式。
      - name: Create draft release
        id: create
        run: |
          echo "release_id=$(gh release create "${{ github.ref_name }}" --draft --generate-notes --json id --jq .id)" >> "$GITHUB_OUTPUT"
        env:
          GH_TOKEN: ${{ github.token }}

  publish-crates-io:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
      - name: Install system deps (git2/openssl)
        run: sudo apt-get update && sudo apt-get install -y libssl-dev zlib1g-dev
      # OIDC 交换 30 分钟短期 token（需 crates.io 侧启用 Trusted Publishing：
      # https://crates.io/settings/trusted-publishing → Add owner）
      - uses: rust-lang/crates-io-auth-action@v1
        id: auth
      - name: Publish to crates.io
        run: cargo publish --locked
        env:
          CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}

  build-binaries:
    needs: create-release
    strategy:
      fail-fast: false
      matrix:
        include:
          - target: x86_64-unknown-linux-gnu
            os: ubuntu-latest
          - target: x86_64-pc-windows-msvc
            os: windows-latest
          - target: x86_64-apple-darwin
            os: macos-latest
          - target: aarch64-apple-darwin
            os: macos-latest
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4
      - uses: dtolnay/rust-toolchain@stable
        with:
          targets: ${{ matrix.target }}
      - uses: Swatinem/rust-cache@v2
      - name: Install system deps (git2/openssl)
        if: runner.os == 'Linux'
        run: sudo apt-get update && sudo apt-get install -y libssl-dev zlib1g-dev
      # macos 自带 LibreSSL 与 openssl-sys 构建不兼容——
      # 安装 Homebrew openssl@3 并以 PKG_CONFIG_PATH 暴露（keg-only 不自动链接）
      - name: Install OpenSSL (macos)
        if: runner.os == 'macOS'
        run: |
          brew install openssl@3
          echo "PKG_CONFIG_PATH=$(brew --prefix openssl@3)/lib/pkgconfig" >> "$GITHUB_ENV"
      # 上传到 create-release 的 Draft（release-id 指定，消除并发创建竞态）
      - uses: taiki-e/upload-rust-binary-action@v1
        with:
          bin: code-repo-wiki
          target: ${{ matrix.target }}
          tar: unix
          zip: windows
          release-id: ${{ needs.create-release.outputs.release_id }}

  publish-release:
    needs: [create-release, build-binaries]
    runs-on: ubuntu-latest
    steps:
      # 4 个目标二进制全部上传完成后，Draft → 正式发布
      - name: Publish release
        run: gh release edit "${{ github.ref_name }}" --draft=false
        env:
          GH_TOKEN: ${{ github.token }}