ci: add automated NuGet publishing

Author: ycode-lin

.github/workflows/publish.yml

@@ -0,0 +1,105 @@
+name: Publish NuGet Package
+
+on:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 10.0.x
+
+      - name: Resolve package version
+        id: version
+        shell: bash
+        run: |
+          if [[ "${{ github.event_name }}" == "release" ]]; then
+            TAG_NAME="${{ github.event.release.tag_name }}"
+          elif [[ "${{ github.ref_type }}" == "tag" ]]; then
+            TAG_NAME="${{ github.ref_name }}"
+          else
+            echo "workflow_dispatch must be run from a tag ref such as v1.0.4." >&2
+            exit 1
+          fi
+
+          PACKAGE_VERSION="${TAG_NAME#v}"
+
+          if [[ -z "${PACKAGE_VERSION}" ]]; then
+            echo "Package version could not be resolved from the release tag." >&2
+            exit 1
+          fi
+
+          echo "tag_name=${TAG_NAME}" >> "${GITHUB_OUTPUT}"
+          echo "package_version=${PACKAGE_VERSION}" >> "${GITHUB_OUTPUT}"
+
+      - name: Restore
+        run: dotnet restore YCode.CLI/YCode.CLI.csproj
+
+      - name: Pack
+        run: >
+          dotnet pack YCode.CLI/YCode.CLI.csproj
+          --configuration Release
+          --no-restore
+          -p:ContinuousIntegrationBuild=true
+          -p:PackageVersion=${{ steps.version.outputs.package_version }}
+          --output ${{ github.workspace }}/artifacts
+
+      - name: Publish to NuGet.org
+        shell: bash
+        run: |
+          shopt -s nullglob
+          packages=("${{ github.workspace }}/artifacts/"*.nupkg)
+
+          if (( ${#packages[@]} == 0 )); then
+            echo "No .nupkg files were generated." >&2
+            exit 1
+          fi
+
+          dotnet nuget push "${packages[@]}" \
+            --api-key "${{ secrets.NUGET_API_KEY }}" \
+            --source "https://api.nuget.org/v3/index.json" \
+            --skip-duplicate
+
+      - name: Configure GitHub Packages source
+        run: >
+          dotnet nuget add source
+          --username "${{ github.repository_owner }}"
+          --password "${{ secrets.GITHUB_TOKEN }}"
+          --store-password-in-clear-text
+          --name github
+          "https://nuget.pkg.github.com/${{ github.repository_owner }}/index.json"
+
+      - name: Publish to GitHub Packages
+        shell: bash
+        run: |
+          shopt -s nullglob
+          packages=("${{ github.workspace }}/artifacts/"*.nupkg)
+
+          dotnet nuget push "${packages[@]}" \
+            --source github \
+            --api-key "${{ secrets.GITHUB_TOKEN }}" \
+            --skip-duplicate
+
+      - name: Upload package to GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: bash
+        run: |
+          shopt -s nullglob
+          packages=("${{ github.workspace }}/artifacts/"*.nupkg)
+
+          gh release upload "${{ steps.version.outputs.tag_name }}" "${packages[@]}" --clobber

README.md

@@ -16,6 +16,9 @@
 
 # 运行（本地调试）
  dotnet run --project YCode.CLI\YCode.CLI.csproj
+
+# 作为全局工具安装（NuGet 发布后）
+ dotnet tool install --global YCode.CLI
 ```
 
 ## 配置
@@ -69,13 +72,24 @@ flowchart TD
 - **扩展功能**：基于项目实现更多代理类型或技能
 - **改进文档**：帮助完善使用说明和示例
 
+## 发布流程
+仓库已配置 GitHub Actions 自动发布：
+
+- 在 GitHub 创建一个 `Release`，tag 使用 `v1.0.4` 这类语义化版本格式
+- Workflow 会自动执行 `dotnet pack`
+- 生成的 `.nupkg` 会推送到 `nuget.org`
+- 同一个包也会推送到 GitHub Packages
+- 包文件会作为资产上传到对应的 GitHub Release
+
+Workflow 默认读取仓库里的 `NUGET_API_KEY` secret。
+
 ## 参考资源
 - [Microsoft Agents AI 文档](https://learn.microsoft.com/en-us/dotnet/agents/)
 - [MCP 协议规范](https://spec.modelcontextprotocol.io/)
 - [Kode 项目](https://github.com/shareAI-lab/Kode) (Python实现的参考)
 
 ## Star History
-[![Star History Chart](https://api.star-history.com/svg?repos=lyq-lin/YCode.CLI&type=Date)](https://star-history.com/#lyq-lin/YCode.CLI&Date)
+[![Star History Chart](https://api.star-history.com/svg?repos=ycode-lin/YCode.CLI&type=Date)](https://star-history.com/#ycode-lin/YCode.CLI&Date)
 
 ## 许可证
 MIT License

YCode.CLI/YCode.CLI.csproj

@@ -5,13 +5,23 @@
 		<TargetFramework>net10.0</TargetFramework>
 		<ImplicitUsings>enable</ImplicitUsings>
 		<Nullable>enable</Nullable>
+		<IsPackable>true</IsPackable>
 
 		<!-- 全局工具必备配置 -->
 		<PackAsTool>true</PackAsTool>
 		<ToolCommandName>ycode</ToolCommandName>
-		<!-- 全局使用的命令名 -->
-		<PackageOutputPath>./nupkg</PackageOutputPath>
-		<!-- 可选：NuGet包输出目录 -->
+		<PackageId>YCode.CLI</PackageId>
+		<Version>1.0.4</Version>
+		<Authors>lyq-lin</Authors>
+		<Description>YCode is an AI-powered coding agent that operates inside your repository. It provides intelligent code assistance, file operations, and multi-step task management.</Description>
+		<PackageTags>ai;coding-agent;cli;dotnet-tool;developer-tools</PackageTags>
+		<PackageReadmeFile>README.md</PackageReadmeFile>
+		<PackageLicenseExpression>MIT</PackageLicenseExpression>
+		<PackageProjectUrl>https://github.com/ycode-lin/YCode.CLI</PackageProjectUrl>
+		<RepositoryUrl>https://github.com/ycode-lin/YCode.CLI</RepositoryUrl>
+		<RepositoryType>git</RepositoryType>
+		<PublishRepositoryUrl>true</PublishRepositoryUrl>
+		<PackageOutputPath>$(MSBuildThisFileDirectory)nupkg</PackageOutputPath>
 	</PropertyGroup>
 
 	<ItemGroup>
@@ -24,7 +34,7 @@
 	</ItemGroup>
 
 	<ItemGroup>
-	  <Folder Include="nupkg\" />
+		<None Include="../README.md" Pack="true" PackagePath="\" />
 	</ItemGroup>
 
 </Project>