csdn-private-ai 0.0.1 → 0.0.2

package/README.md

@@ -69,6 +69,9 @@
 - VSIX 打包和 npm 打包现在分开控制：
   - VSIX 打包走 `.vscodeignore`
   - npm 打包走 `.npmignore`
+- Marketplace 顶层扩展图标现在单独走 `media/icon.png`
+  - 这是给 VS Code Marketplace 展示页用的 PNG 图标
+  - 侧边栏容器里继续使用 `media/icon.svg`
 - 生成 VSIX：
   - `npm run package:vsix`
   - 默认产物路径：`artifacts/csdn-private-ai-<version>.vsix`
@@ -77,6 +80,14 @@
   - 默认产物路径：`artifacts/csdn-private-ai-<version>.tgz`
 - 一次性同时生成 VSIX 和 npm tarball：
   - `npm run release:local`
+- 发布到 VS Code Marketplace：
+  - 先把 `package.json` 里的 `publisher` 从 `local` 改成你在 Marketplace 上真实创建的 publisher id
+  - 再准备 Azure DevOps 的 Personal Access Token，并确保包含 Marketplace 的 `Manage` 权限
+  - 本机可先执行 `vsce login <publisher-id>`
+  - 或者直接设置环境变量 `VSCE_PAT`
+  - 然后执行 `npm run publish:marketplace`
+- 如果你想先验证 Marketplace 发布前的打包结果，可先执行：
+  - `npm run package:vsix`
 - 实际发布到 npm：
   - 先执行 `npm login`
   - 先确认 `package.json` 里的 `name` 和 `version` 都是你要发布的值
@@ -87,6 +98,7 @@
 - 当前脚本默认依赖你本机已经全局安装好的 `vsce`
 - npm 打包和发布脚本固定使用项目内的 `.npm-cache`，避免受系统全局 npm 缓存权限影响
 - 仓库当前已补 `MIT` 许可证文件：`LICENSE`
+- 如果你后续要做 CI 发布，Marketplace 侧优先使用 `VSCE_PAT`，npm 侧优先使用 `NPM_TOKEN`
 
 ## 超时说明
 
@@ -136,6 +148,10 @@
 - 这是基于 CSDN 当前前端 bundle 对齐出来的私有协议，后续如果 CSDN 更新 AK/SK 或网关签名规则，优先修改 `src/services/csdnSigner.ts`。
 - 如果文章绑定规则变化，或后续不再允许用纯数字 `articleId` 走兜底 URL，优先修改 `src/utils/article.ts`，并同步更新侧边栏文案和 README。
 - 如果 VSIX 打包失败，优先检查全局 `vsce` 是否可用，以及 `.vscodeignore` 和 `package.json` 里的脚本是否还保持一致。
+- 如果 Marketplace 发布失败，先检查：
+  - `package.json` 里的 `publisher` 是否还是默认的 `local`
+  - `VSCE_PAT` 或 `vsce login` 是否对应同一个 publisher
+  - `media/icon.png` 是否仍然存在，且是至少 `128x128` 的 PNG
 - 如果 npm 包里没有带上 `.vsix`，优先检查 `.npmignore`，以及发布前是否实际生成了 `artifacts/*.vsix`。
 - 如果 CSDN 修改了 smart chat 的 URL `sign` 计算规则，优先修改 `src/services/csdnSigner.ts`。
 - 如果再次出现“网关签名失败，但浏览器里同请求能用”，优先检查 `src/services/csdnSigner.ts` 里的 query `sign` 是否仍然是“UTF-8 Base64 + 双 MD5”。
@@ -157,6 +173,7 @@
   - `media/sidebar.css`
 - 如果复制按钮或剪贴板行为变了，要同时检查 `src/webview/sidebarViewProvider.ts` 和 `media/sidebar.js` 的消息协议是否仍一致。
 - 如果活动栏图标显示异常，优先检查 `media/icon.svg` 是否仍然使用 `currentColor` 单色路径，而不是带背景色的大面积填充。
+- 如果 Marketplace 展示图标显示异常，优先检查 `media/icon.png` 和 `package.json` 顶层 `icon` 字段，不要只改 `media/icon.svg`。
 - 插件不会把 Cookie 透传给 Webview，也不会把 Cookie 打进日志，这条约束后续不要破坏。
 
 ## 当前实现变更记录
@@ -189,3 +206,4 @@
 - 将 VSIX 和 npm 的打包规则拆分为 `.vscodeignore` 与 `.npmignore` 两套，避免 `vsce` 因和 npm 文件白名单冲突而打包失败。
 - 补充了 npm 发布前需要先 `npm login` 的说明，并验证了 `npm publish --dry-run` 下 tarball 确实会包含生成出来的 `.vsix`。
 - 补充了 `MIT` 许可证文件，消除了 VSIX 打包时缺少 LICENSE 的警告前提。
+- 增加了 `publish:marketplace` 脚本，并补上了 Marketplace 使用的 PNG 图标与发布说明。

package/package.json

@@ -2,8 +2,9 @@
   "name": "csdn-private-ai",
   "displayName": "CSDN Private AI",
   "description": "在 VS Code 侧边栏中复用 CSDN 私有 AI 对话接口。",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "publisher": "local",
+  "icon": "media/icon.png",
   "engines": {
     "vscode": "^1.90.0"
   },
@@ -103,6 +104,7 @@
     "package:vsix": "npm run compile && vsce package --allow-missing-repository -o artifacts/csdn-private-ai-$npm_package_version.vsix",
     "package:npm": "npm pack --pack-destination artifacts --cache .npm-cache",
     "release:local": "npm run package:vsix && npm run package:npm",
+    "publish:marketplace": "vsce publish --allow-missing-repository",
     "publish:npm": "npm publish --access public --cache .npm-cache",
     "prepublishOnly": "npm run package:vsix"
   },