diff options
| author | tanaka takashi <isazaka@gmail.com> | 2026-08-14 18:00:29 +0900 |
|---|---|---|
| committer | tanaka takashi <isazaka@gmail.com> | 2026-08-14 18:00:29 +0900 |
| commit | a8233adff75a4726015c7c96ce5e864d4506f6b2 (patch) | |
| tree | 8ce06e1bc5d605b9681259260c99a47921e65413 /README.md | |
| parent | e07183ee6d3e57da325213e898cdcd6687320f53 (diff) | |
Unify the public product name and repository identifier while preserving stable executable, store, AppContainer, namespace, pipe, and mutex identifiers.
Make Directory.Build.props VersionPrefix the application-version source of truth, use SDK-generated assembly metadata, and compare helper compatibility by parsed major/minor/build release identity.
Rebuild the fixed winagent-sandbox-mcp release staging directory from clean defaults, emit versioned ZIP/checksum assets, verify manifests and fresh extraction, and reject local configuration, user state, and test artifacts.
Document release/deployment separation and upgrade responsibilities, add the initial changelog, update operational script paths, and record the v0.1.0 verification results.
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 34 |
1 files changed, 28 insertions, 6 deletions
@@ -1,6 +1,6 @@ -# AI Agent Sandbox MCP Server +# WinAgent Sandbox MCP -Windows上でOllamaを利用し、AIエージェントのファイル操作とプロセス実行を、利用者がYAMLで指定した範囲へ閉じ込めるMCP Serverです。MCP Clientには`agent_run`と`agent_status`だけを公開します。 +Windows 11 x64上でOllamaを利用し、AIエージェントのファイル操作とプロセス実行を利用者がYAMLで指定した範囲へ閉じ込めるMCP Serverです。LPAC、NTFS ACL、Job Object、WFPでSandbox Process Treeを強制し、通常権限のmain processからTask単位で必要なnetwork操作だけをUAC昇格します。MCP Clientには`agent_run`と`agent_status`だけを公開します。 ## 機能 @@ -69,7 +69,7 @@ sandbox: profile: normal ``` -実環境用path、Prompt、Skillは`agent.local.yaml`から指定できます。publish/upgradeは`agent.local.yaml`、`local/`、`logs/`、`state/`、適用済み設定Storeを上書きしません。 +実環境用path、Prompt、Skillは`agent.local.yaml`から指定できます。Release artifact生成用stagingにはこれらの利用者状態を含めません。利用者deploymentをupgradeするときはExecutableと既定資産だけを置換し、`agent.local.yaml`、`local/`、`logs/`、`state/`、適用済み設定Storeを上書きしないでください。 ### 権限マトリックス @@ -164,9 +164,9 @@ stdioでもMCP Clientは通常権限で起動します。ファイル操作だã� ```json { "mcpServers": { - "agent-sandbox": { - "command": "C:\\tools\\agent-sandbox-mcp\\agent-mcp.exe", - "args": ["C:\\tools\\agent-sandbox-mcp\\agent.yaml"] + "winagent-sandbox-mcp": { + "command": "C:\\tools\\winagent-sandbox-mcp\\agent-mcp.exe", + "args": ["C:\\tools\\winagent-sandbox-mcp\\agent.yaml"] } } } @@ -221,6 +221,28 @@ dotnet test AgentSandboxMcp.slnx -c Release --no-build --no-restore .\scripts\Publish-Release.ps1 ``` +## Releaseとupgrade + +`Publish-Release.ps1`は`Directory.Build.props`のApplication Versionを読み取り、次を生成します。展開済みBundle directoryは利用者deploymentではなく、実行のたびに完全再生成されるRelease staging成果物です。 + +```text +build/Release/publish/ + winagent-sandbox-mcp/ + winagent-sandbox-mcp-v<version>-win-x64.zip + winagent-sandbox-mcp-v<version>-win-x64.zip.sha256 +``` + +ZIP内のroot directory名とExecutable名にはversionを含めません。`agent.local.yaml`、`local/`、`logs/`、`state/`、Applied Configuration StoreはBundleとZIPに含まれません。 + +利用者deploymentのupgradeでは、ZIP内のExecutableと既定資産だけを置換し、利用者固有のlocal設定、Prompt、Skill、logs、state、Applied Configuration Storeを保持してください。旧version付きdirectoryから新しいdeployment pathへ移す場合は、local資産を利用者が移動し、新しいconfig pathに対して次を実行します。 + +```powershell +.\agent-mcp.exe show .\agent.yaml +.\agent-mcp.exe apply .\agent.yaml +``` + +本Repositoryはinstallerやdeployment upgrade scriptを提供しません。 + 詳細は[仕様書](doc/Specifications.md)と[設計書](doc/Design.md)を参照してください。 ## ライセンス |
