diff --git a/.claude/settings.local.json b/.claude/settings.local.json
deleted file mode 100644
index f8c8297..0000000
--- a/.claude/settings.local.json
+++ /dev/null
@@ -1,10 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(ls -la \"C:\\\\Users\\\\Administrator\\\\.claude\\\\projects\\\\d--MusicServer\\\\memory\" 2>/dev/null; cat \"C:\\\\Users\\\\Administrator\\\\.claude\\\\projects\\\\d--MusicServer\\\\memory\\\\MEMORY.md\" 2>/dev/null; ls /d/MusicServer/*.md 2>/dev/null)",
-      "Read(//c/Users/Administrator/.claude/projects/d--MusicServer/memory/**)",
-      "Bash(grep -rn \"from '\\\\.\\\\./\\\\.\\\\./request'\" /d/MusicServer/musicSdk --include=\"*.js\" -l)",
-      "Bash(grep -v \"from '\\\\./\\\\|from '\\\\.\\\\./\\\\|from '\\\\.\\\\./\\\\.\\\\./\")"
-    ]
-  }
-}
diff --git a/.gitignore b/.gitignore
index 6f068f0..1bf747f 100644
--- a/.gitignore
+++ b/.gitignore
@@ -22,6 +22,10 @@ Thumbs.db
 # ZCode 本地目录
 .zcode/
 
+# Agent 工作目录（本机记忆日志、工具权限配置；含本机绝对路径，不入库）
+.workbuddy/
+.claude/
+
 # IDE
 .vscode/
 .idea/
@@ -38,3 +42,6 @@ coverage/
 # 以下规则仅作保险，防止旧的发射产物被误生成后提交。
 src/**/*.js
 sdk/**/*.js
+
+# 汽水官方签名原生模块（专有二进制，不入库；QS_MSSDK_DIR 亦可指向别处）
+soda-mssdk/
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
index 2ad2dd7..3fc4143 100644
--- a/pnpm-workspace.yaml
+++ b/pnpm-workspace.yaml
@@ -1,2 +1,4 @@
+# isolated-vm 的原生构建脚本需显式放行（pnpm 12 要求），
+# 否则加载失败会降级为「未安装 isolated-vm」，社区 .js 音源脚本被静默跳过。
 allowBuilds:
   isolated-vm: true