星图增强插件

这是一个供公司内部使用的 Chrome MV3 插件，用于增强巨量星图达人市场页面的使用体验。

主要功能：

• 在星图达人列表页补充插件侧数据列
• 支持勾选部分达人后导出 CSV
• 支持将达人数据提交为批次
• 集成 Logto 登录
• 支持内部压缩包分发后通过 Load unpacked 安装

当前固定扩展 ID：

• pkjopdibdnomhogjheclhnknmejccffg

---

一、项目目录

• src/
  • 插件源码
• dist/
  • 开发构建产物
• dist-release/
  • 内部分发构建产物
• release/
  • 打包后的内部交付压缩包
• docs/
  • 项目说明文档
• tests/
  • 自动化测试
• scripts/
  • 构建和打包脚本

---

二、开发环境

安装依赖：

npm install

运行测试：

npm test

开发构建：

npm run build

说明：

• npm run build 会生成开发版到 dist/
• 开发版包含本地调试需要的宽权限

---

三、内部交付构建

生成内部使用构建：

npm run build:release

生成内部压缩包：

npm run package:internal

生成结果：

• 构建目录：dist-release/
• 压缩包：release/star-chart-search-enhancer-internal.zip

说明：

• 这个压缩包不是给 Chrome 商店上传的
• 它是发给公司内部同事使用的交付包
• 同事收到后需要解压，再到 chrome://extensions 中 Load unpacked

---

四、插件安装方式

本项目当前采用公司内部手工安装方式：

1. 解压内部压缩包
2. 打开 chrome://extensions
3. 打开右上角 开发者模式
4. 点击 加载已解压的扩展程序
5. 选择解压后的插件文件夹

安装后请确认扩展 ID 是：

• pkjopdibdnomhogjheclhnknmejccffg

---

五、认证与配置

插件使用 Logto 登录。

认证配置位于：

• src/shared/auth-config.ts

当前主要配置包括：

• logtoEndpoint
• appId
• apiResource
• scopes

说明：

• popup 中的开发调试面板默认关闭
• 如果需要本地调试受保护接口，可以手动把 enableDevAuthPanel 改为 true

---

六、批次提交说明

提交批次时，前端当前会提交以下核心字段：

• logtoUserId
• creatorName
• resource
• batchName
• createdAt
• authors

说明：

• batchId 不再由前端生成
• 现在由后端生成 7 位数字批次 ID

---

七、重要文档

给内部同事的安装与使用说明：

• docs/aigc-user-guide.md

内部压缩包分发说明：

• docs/internal-extension-distribution.md

---

八、常用命令

npm install
npm test
npm run build
npm run build:release
npm run package:internal

---

九、维护注意事项

• 扩展 ID 已通过 manifest.key 固定
• 不要泄露本地私钥文件 .local/extension-key.pem
• 如果后端地址发生变化，需要同步更新：
  • scripts/manifest.mjs
  • 对应后端配置文件
  • 相关文档

---

十、当前状态

当前项目已经支持：

• 新固定扩展 ID
• 内部压缩包分发
• 自定义批次名称弹窗
• 后台静默导出
• 批次提交不再由前端生成 batchId