|
|
@@ -1,212 +0,0 @@
|
|
|
-# NPM 技能包发布管理
|
|
|
-
|
|
|
-本文记录 Claude Code / OpenClaw 技能包的 npm 发布、下载、安装和验证方式。
|
|
|
-
|
|
|
-## 发布状态总览
|
|
|
-
|
|
|
-| 技能包 | npm 包名 | 当前版本 | 状态 | 本地目录 | npm 链接 |
|
|
|
-|---|---|---:|---|---|---|
|
|
|
-| Claude Code VOC Intelligence | `@vocmarket/voc-skill` | `0.3.15` | 已发布 | `claude-code/claude-code-voc-intelligence/` | https://www.npmjs.com/package/@vocmarket/voc-skill |
|
|
|
-| 提号 SOP 博主名单 | `@vocmarket/tihao` | `1.0.10` | 已发布 | `E:\workspace\tihao-ai\claude-code-tihao-sourcing\` | https://www.npmjs.com/package/@vocmarket/tihao |
|
|
|
-| 装修量尺图缺标记检查 | `@gangvy/claude-code-measurement-marker-check` | `0.1.2` | 已发布 | `claude-code-measurement-marker-check/` | https://www.npmjs.com/package/@gangvy/claude-code-measurement-marker-check |
|
|
|
-
|
|
|
-## VOC Intelligence 安装入口
|
|
|
-
|
|
|
-推荐给 VSCode Claude Code 插件使用工作区安装：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npx --yes @vocmarket/voc-skill@latest workspace --smoke
|
|
|
-```
|
|
|
-
|
|
|
-工作区安装会写入：
|
|
|
-
|
|
|
-```text
|
|
|
-.\.mcp.json
|
|
|
-.\.claude\plugins\voc-intelligence
|
|
|
-.\.claude\skills\xiaohongshu-trend-intelligence\SKILL.md
|
|
|
-.\.claude\skills\douyin-trend-intelligence\SKILL.md
|
|
|
-```
|
|
|
-
|
|
|
-全局安装：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npm install -g @vocmarket/voc-skill
|
|
|
-claude-voc install
|
|
|
-```
|
|
|
-
|
|
|
-npx 免全局安装：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npx --yes @vocmarket/voc-skill@latest install
|
|
|
-```
|
|
|
-
|
|
|
-Claude Code 命令行加载：
|
|
|
-
|
|
|
-```powershell
|
|
|
-claude --plugin-dir "$env:USERPROFILE\.claude\plugins\voc-intelligence"
|
|
|
-```
|
|
|
-
|
|
|
-## 提号 SOP 安装入口
|
|
|
-
|
|
|
-推荐给 VSCode Claude Code 插件使用工作区安装：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npx --yes @vocmarket/tihao@latest workspace --smoke
|
|
|
-```
|
|
|
-
|
|
|
-工作区安装会写入：
|
|
|
-
|
|
|
-```text
|
|
|
-.\.mcp.json
|
|
|
-.\.claude\plugins\tihao
|
|
|
-.\.claude\skills\tihao\SKILL.md
|
|
|
-```
|
|
|
-
|
|
|
-全局安装：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npm install -g @vocmarket/tihao
|
|
|
-tihao install --smoke
|
|
|
-```
|
|
|
-
|
|
|
-使用全局 CLI 安装到当前项目工作区：
|
|
|
-
|
|
|
-```powershell
|
|
|
-tihao workspace --smoke
|
|
|
-```
|
|
|
-
|
|
|
-发布后验证：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npm view @vocmarket/tihao name version dist-tags.latest --registry=https://registry.npmjs.org/
|
|
|
-npx --yes @vocmarket/tihao@latest workspace --smoke
|
|
|
-```
|
|
|
-
|
|
|
-### 数据库 `skills` 表记录
|
|
|
-
|
|
|
-| 字段 | 值 |
|
|
|
-|---|---|
|
|
|
-| `skillName` | `tihao` |
|
|
|
-| `displayName` | `提号` |
|
|
|
-| `status` | `published` |
|
|
|
-| `npmPackage` | `@vocmarket/tihao` |
|
|
|
-| `npmVersion` | `1.0.10` |
|
|
|
-| `installCommand` | `npx --yes @vocmarket/tihao@latest workspace --smoke` |
|
|
|
-| `globalInstallCommand` | `npm install -g @vocmarket/tihao && tihao install --smoke` |
|
|
|
-| `workspaceSkillPath` | `.claude/skills/tihao/SKILL.md` |
|
|
|
-| `globalSkillPath` | `%USERPROFILE%/.claude/skills/tihao/SKILL.md` |
|
|
|
-| `pluginName` | `tihao` |
|
|
|
-| `mcpServerName` | `tihao` |
|
|
|
-| `legacyNpmPackages` | `@vocmarket/tihao-sop` |
|
|
|
-| `legacyCliNames` | `tihao-sourcing` |
|
|
|
-| `legacyPluginNames` | `tihao-sourcing` |
|
|
|
-| `legacySkillNames` | `tihao-creator-sourcing` |
|
|
|
-
|
|
|
-包内同步记录：`E:\workspace\tihao-ai\claude-code-tihao-sourcing\docs\skill-database-record.json`。
|
|
|
-
|
|
|
-## 教学测试话术
|
|
|
-
|
|
|
-小红书趋势情报：
|
|
|
-
|
|
|
-```text
|
|
|
-帮我做一份家装全屋定制行业的小红书趋势情报。
|
|
|
-先用演示样例跑通流程，不要真实采集。
|
|
|
-在聊天里给我第一轮样本观察和待确认问题。
|
|
|
-```
|
|
|
-
|
|
|
-抖音趋势情报：
|
|
|
-
|
|
|
-```text
|
|
|
-帮我做一份家装全屋定制行业的抖音趋势情报。
|
|
|
-先用演示样例跑通流程，不要真实采集。
|
|
|
-在聊天里给我第一轮样本观察和待确认问题。
|
|
|
-```
|
|
|
-
|
|
|
-真实采集口径：
|
|
|
-
|
|
|
-```text
|
|
|
-请切到 live 模式，并先检查 token 和余额状态。
|
|
|
-```
|
|
|
-
|
|
|
-没有 token 或余额不足时，技能包必须返回充值/开通链接，不允许把底层 403、权限或余额接口报错直接展示给用户。
|
|
|
-
|
|
|
-## 发布流程
|
|
|
-
|
|
|
-发布前验证：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npm --prefix claude-code/claude-code-voc-intelligence run mcp:smoke
|
|
|
-npm --prefix claude-code/claude-code-voc-intelligence run smoke:package
|
|
|
-npm --prefix claude-code/claude-code-voc-intelligence run xhs:sample
|
|
|
-npm --prefix claude-code/claude-code-voc-intelligence run dy:sample
|
|
|
-npm run claude-voc:acceptance
|
|
|
-```
|
|
|
-
|
|
|
-构建套件与 npm 包：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npm run claude-voc:build
|
|
|
-npm run claude-voc:npm-pack
|
|
|
-```
|
|
|
-
|
|
|
-发布：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npm run claude-voc:npm-publish
|
|
|
-```
|
|
|
-
|
|
|
-发布后验证：
|
|
|
-
|
|
|
-```powershell
|
|
|
-npm view @vocmarket/voc-skill name version dist-tags.latest --registry=https://registry.npmjs.org/
|
|
|
-$test = Join-Path $env:TEMP ("vocmarket-online-smoke-" + [guid]::NewGuid())
|
|
|
-New-Item -ItemType Directory -Path $test | Out-Null
|
|
|
-Push-Location $test
|
|
|
-npm exec --yes --package @vocmarket/voc-skill@latest -- claude-voc workspace --smoke
|
|
|
-Pop-Location
|
|
|
-```
|
|
|
-
|
|
|
-## 认证方式
|
|
|
-
|
|
|
-发布脚本支持临时读取 `NPM_TOKEN` 或 `NODE_AUTH_TOKEN`。本地建议放在：
|
|
|
-
|
|
|
-```text
|
|
|
-release\npm\claude-code-voc-intelligence\.env.local
|
|
|
-```
|
|
|
-
|
|
|
-只允许本地使用，不要提交 npm token、VOC session token、模型 API key 或任何真实用户 token。
|
|
|
-
|
|
|
-## 本次发布记录
|
|
|
-
|
|
|
-- 2026-06-15 已发布 `@vocmarket/tihao@1.0.8`，npm `latest` 已验证为 `1.0.8`；本版把对外包名、主 CLI、插件目录和 MCP server 统一改为 `tihao`。
|
|
|
-- 已完成线上安装验证：`npx --yes @vocmarket/tihao@latest workspace --smoke` 与 `npm exec --yes --package @vocmarket/tihao@latest -- tihao install --smoke`。
|
|
|
-- 旧包 `@vocmarket/tihao-sop`、旧 CLI alias `tihao-sourcing` 和旧插件目录 `tihao-sourcing` 仅作为迁移兼容；客户新安装统一使用 `@vocmarket/tihao`。
|
|
|
-- 2026-06-15 已发布 `@vocmarket/tihao-sop@1.0.7`，npm `latest` 已验证为 `1.0.7`；本版同步区分项目级安装 `workspace --smoke` 和用户级全局 skill 安装 `install --smoke`。
|
|
|
-- 已完成线上安装验证：`npx --yes @vocmarket/tihao-sop@latest workspace --smoke`。
|
|
|
-- 本次 skill 改名后，CLI 仍为 `tihao-sourcing`，插件目录仍为 `tihao-sourcing`，Claude Code skill 改为 `tihao`；安装器会清理同目标下的 legacy skill `tihao-creator-sourcing`。
|
|
|
-- 2026-06-15 已发布 `@vocmarket/tihao-sop@1.0.6`，发布时 npm `latest` 已验证为 `1.0.6`。
|
|
|
-- 2026-06-05 已发布 `@vocmarket/tihao-sop@0.1.15`，npm `latest` 当时已验证为 `0.1.15`。
|
|
|
-- 发布 `0.1.14` 时出现过一次 `PUT 200`、`dist-tag latest` 可见但 `npm view`/`npx` 短暂 404 的半可见状态；已用 `0.1.15` 重新发布并通过安装验证。
|
|
|
-- 2026-06-05 已发布 `@vocmarket/voc-skill@0.3.15`，npm `latest` 已验证为 `0.3.15`。
|
|
|
-- 已完成线上安装验证：`npm exec --yes --package @vocmarket/voc-skill@latest -- claude-voc workspace --smoke`。
|
|
|
-- 本次改名只改 npm 对外包名，CLI 仍为 `claude-voc`，插件目录仍为 `voc-intelligence`，避免破坏 Claude Code 工作区识别。
|
|
|
-- 已将旧包 `@gangvy/claude-code-voc-intelligence@*` 标记为 deprecated，安装旧包时会提示改用：`npx --yes @vocmarket/voc-skill@latest workspace --smoke`。
|
|
|
-- 已借鉴 `tihao-sop` 的验收方式新增 `npm run claude-voc:acceptance`：串联包级 smoke、MCP smoke、npm pack dry-run、临时 workspace 安装和 `.mcp.json` 绝对路径断言。
|
|
|
-- 发布过程中出现过一次“publish 已成功但后置 npm view 短暂 404”的假失败；确认方式是等待后重新执行 `npm view @vocmarket/voc-skill@0.3.15 version`。
|
|
|
-- 2026-05-25 已发布 `@gangvy/claude-code-voc-intelligence@0.3.0`，npm `latest` 已验证为 `0.3.0`。
|
|
|
-- `0.3.0` 新增抖音趋势情报能力：`douyin-trend-intelligence` skill、`voc_douyin_trend_run`、`voc_douyin_token_check`、`voc_douyin_preference_update`。
|
|
|
-- 保留小红书趋势情报能力，并让工作区安装同时生成小红书和抖音两个 skill 入口。
|
|
|
-- 统一 token / 充值体验：没有 token 返回开通链接，余额不足或业务 403 返回充值链接，不暴露底层接口报错。
|
|
|
-- 新增 `business-status recharge guard` smoke，用来防止 HTTP 200 但业务码 403 时误判为成功。
|
|
|
-- 已通过 `mcp:smoke`、`smoke:package`、`xhs:sample`、`dy:sample`、`claude-voc:build`、`claude-voc:npm-pack`、`claude-voc:npm-publish`。
|
|
|
-- 当前新包发布后已用 `npm exec --yes --package @vocmarket/voc-skill@latest -- claude-voc workspace --smoke` 从 npm registry 重新安装并验证通过。
|
|
|
-
|
|
|
-## 后续更新规则
|
|
|
-
|
|
|
-- 升级功能时先改 `claude-code/claude-code-voc-intelligence/package.json` 版本，再同步 `package-lock.json`、`skill-package-manifest.json`、`.claude-plugin/plugin.json` 和发布管理文档。
|
|
|
-- 保持输入简单：用户说自然语言即可，不要求理解 MCP schema。
|
|
|
-- 第一轮报告只输出“初步判断 / 机会假设 / 待校准”，不写成最终结论。
|
|
|
-- 新增平台能力优先作为并列 skill 和并列 MCP tool，不把完整业务闭环强塞进单一 skill。
|
|
|
-- 每次发布前必须跑 `npm run claude-voc:acceptance`，它会覆盖 sample、workspace 安装、no-token 充值提示、余额/业务码保护、MCP tool 发现和 npm pack dry-run。
|
|
|
-
|
|
|
-- 2026-06-17 已发布 `@vocmarket/tihao@1.0.10`，npm `latest` 已验证为 `1.0.10`；本版把首版报告默认改为 live + resultFirstMode 高质量首版，sample 仅在用户明确要演示时使用，token 缺失时主动要 sessionToken 而不退回 sample。
|
gangvy