chore(sdks): refine packaging

.github/workflows/publish-csharp-sdks.yml

@@ -56,16 +56,26 @@ jobs:
 
       - name: Restore
         if: startsWith(github.ref, format('refs/tags/csharp/{0}/v', matrix.sdk.tagPrefix))
-        run: dotnet restore "${{ matrix.sdk.csprojPath }}"
+        run: |
+          EXTRA_RESTORE_ARGS=""
+          if [ "${{ matrix.sdk.name }}" = "code-interpreter" ]; then
+            EXTRA_RESTORE_ARGS="-p:UseLocalOpenSandboxProjectReference=false"
+          fi
+          dotnet restore "${{ matrix.sdk.csprojPath }}" ${EXTRA_RESTORE_ARGS}
 
       - name: Pack
         if: startsWith(github.ref, format('refs/tags/csharp/{0}/v', matrix.sdk.tagPrefix))
         run: |
+          EXTRA_PACK_ARGS=""
+          if [ "${{ matrix.sdk.name }}" = "code-interpreter" ]; then
+            EXTRA_PACK_ARGS="-p:UseLocalOpenSandboxProjectReference=false"
+          fi
           dotnet pack "${{ matrix.sdk.csprojPath }}" \
             --configuration Release \
             --no-restore \
             -p:PackageVersion="${PACKAGE_VERSION}" \
             -p:ContinuousIntegrationBuild=true \
+            ${EXTRA_PACK_ARGS} \
             --output ./artifacts/${{ matrix.sdk.name }}
 
       - name: Publish to NuGet

sdks/Directory.Build.props

@@ -0,0 +1,8 @@
+<Project>
+  <PropertyGroup>
+    <!-- Shared C# SDK packaging metadata -->
+    <OpenSandboxPackageVersion>0.1.0</OpenSandboxPackageVersion>
+    <OpenSandboxCodeInterpreterPackageVersion>0.1.0</OpenSandboxCodeInterpreterPackageVersion>
+    <OpenSandboxDependencyVersionRange>[$(OpenSandboxPackageVersion),0.2.0)</OpenSandboxDependencyVersionRange>
+  </PropertyGroup>
+</Project>

sdks/code-interpreter/csharp/src/OpenSandbox.CodeInterpreter/OpenSandbox.CodeInterpreter.csproj

@@ -10,14 +10,14 @@
 
     <!-- Package Information -->
     <PackageId>Alibaba.OpenSandbox.CodeInterpreter</PackageId>
-    <Version>0.1.0</Version>
+    <Version>$(OpenSandboxCodeInterpreterPackageVersion)</Version>
     <Authors>Alibaba Group</Authors>
     <Company>Alibaba Group Holding Ltd.</Company>
     <Product>OpenSandbox Code Interpreter SDK</Product>
     <Description>A C# SDK for code interpretation with OpenSandbox. Provides high-level APIs for executing code in multiple languages (Python, JavaScript, TypeScript, Go, Java, Bash) within secure sandbox environments.</Description>
     <Copyright>Copyright 2026 Alibaba Group Holding Ltd.</Copyright>
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
-    <PackageProjectUrl>https://github.com/alibaba/OpenSandbox</PackageProjectUrl>
+    <PackageProjectUrl>https://open-sandbox.ai</PackageProjectUrl>
     <RepositoryUrl>https://github.com/alibaba/OpenSandbox.git</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
     <PackageTags>sandbox;code-interpreter;execution;opensandbox;alibaba;python;javascript</PackageTags>
@@ -27,18 +27,30 @@
     <GenerateDocumentationFile>true</GenerateDocumentationFile>
     <NoWarn>$(NoWarn);CS1591</NoWarn>
     <TreatWarningsAsErrors Condition="'$(Configuration)' == 'Release'">true</TreatWarningsAsErrors>
+
+    <!--
+      Default to local source reference for development.
+      For release packing with NuGet version range, run:
+      dotnet pack -c Release -p:UseLocalOpenSandboxProjectReference=false
+    -->
+    <UseLocalOpenSandboxProjectReference Condition="'$(UseLocalOpenSandboxProjectReference)' == ''">true</UseLocalOpenSandboxProjectReference>
   </PropertyGroup>
 
   <!-- Expose internals to test project -->
   <ItemGroup>
     <InternalsVisibleTo Include="OpenSandbox.CodeInterpreter.Tests" />
   </ItemGroup>
 
-  <!-- Project References -->
-  <ItemGroup>
+  <!-- Use local project reference for day-to-day development -->
+  <ItemGroup Condition="'$(UseLocalOpenSandboxProjectReference)' == 'true'">
     <ProjectReference Include="..\..\..\..\sandbox\csharp\src\OpenSandbox\OpenSandbox.csproj" />
   </ItemGroup>
 
+  <!-- Use NuGet dependency range for release packaging -->
+  <ItemGroup Condition="'$(UseLocalOpenSandboxProjectReference)' != 'true'">
+    <PackageReference Include="Alibaba.OpenSandbox" Version="$(OpenSandboxDependencyVersionRange)" />
+  </ItemGroup>
+
   <!-- Common Dependencies -->
   <ItemGroup>
     <PackageReference Include="Microsoft.Extensions.Logging.Abstractions" Version="8.0.2" />

sdks/code-interpreter/javascript/package.json

@@ -23,7 +23,7 @@
   "bugs": {
     "url": "https://github.com/alibaba/OpenSandbox/issues"
   },
-  "homepage": "https://github.com/alibaba/OpenSandbox",
+  "homepage": "https://open-sandbox.ai",
   "files": [
     "dist",
     "src"

sdks/code-interpreter/python/pyproject.toml

@@ -47,9 +47,9 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/alibaba/OpenSandbox"
+Homepage = "https://open-sandbox.ai"
 Repository = "https://github.com/alibaba/OpenSandbox"
-Documentation = "https://docs.opensandbox.io"
+Documentation = "https://open-sandbox.ai"
 Issues = "https://github.com/alibaba/OpenSandbox/issues"
 
 [tool.hatch.version]

sdks/mcp/sandbox/python/pyproject.toml

@@ -47,9 +47,9 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/alibaba/OpenSandbox"
+Homepage = "https://open-sandbox.ai"
 Repository = "https://github.com/alibaba/OpenSandbox"
-Documentation = "https://docs.opensandbox.io"
+Documentation = "https://open-sandbox.ai"
 Issues = "https://github.com/alibaba/OpenSandbox/issues"
 
 [project.scripts]

sdks/sandbox/csharp/Directory.Build.props

@@ -1,4 +1,6 @@
 <Project>
+  <Import Project="$(MSBuildThisFileDirectory)..\..\Directory.Build.props" Condition="Exists('$(MSBuildThisFileDirectory)..\..\Directory.Build.props')" />
+
   <PropertyGroup>
     <EnableNETAnalyzers>true</EnableNETAnalyzers>
     <AnalysisLevel>latest</AnalysisLevel>

sdks/sandbox/csharp/src/OpenSandbox/OpenSandbox.csproj

@@ -10,14 +10,14 @@
 
     <!-- Package Information -->
     <PackageId>Alibaba.OpenSandbox</PackageId>
-    <Version>0.1.0</Version>
+    <Version>$(OpenSandboxPackageVersion)</Version>
     <Authors>Alibaba Group</Authors>
     <Company>Alibaba Group Holding Ltd.</Company>
     <Product>OpenSandbox SDK</Product>
     <Description>A C# SDK for low-level interaction with OpenSandbox. It provides the ability to create, manage, and interact with secure sandbox environments, including executing shell commands, managing files, and reading resource metrics.</Description>
     <Copyright>Copyright 2026 Alibaba Group Holding Ltd.</Copyright>
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
-    <PackageProjectUrl>https://github.com/alibaba/OpenSandbox</PackageProjectUrl>
+    <PackageProjectUrl>https://open-sandbox.ai</PackageProjectUrl>
     <RepositoryUrl>https://github.com/alibaba/OpenSandbox.git</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
     <PackageTags>sandbox;container;docker;execution;opensandbox;alibaba</PackageTags>

sdks/sandbox/javascript/package.json

@@ -29,7 +29,7 @@
   "bugs": {
     "url": "https://github.com/alibaba/OpenSandbox/issues"
   },
-  "homepage": "https://github.com/alibaba/OpenSandbox",
+  "homepage": "https://open-sandbox.ai",
   "files": [
     "dist",
     "src"

sdks/sandbox/python/pyproject.toml

@@ -49,9 +49,9 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/alibaba/OpenSandbox"
+Homepage = "https://open-sandbox.ai"
 Repository = "https://github.com/alibaba/OpenSandbox"
-Documentation = "https://docs.opensandbox.io"
+Documentation = "https://open-sandbox.ai"
 Issues = "https://github.com/alibaba/OpenSandbox/issues"
 
 [tool.hatch.version]