@yizhuan-cli/cli 0.1.16-beta.1 → 0.1.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yizhuan-cli/cli",
-  "version": "0.1.16-beta.1",
+  "version": "0.1.16",
   "description": "易撰命令行工具，用于通过 API Key 查询易撰真实数据。",
   "private": false,
   "type": "module",

package/resources/yizhuan-cli/SKILL.md

@@ -68,11 +68,13 @@ yizhuan doctor
 - 微信公众号暂不支持全网搜索作品。用户提出该请求时必须明确说明不支持，不得改用作品库检索并把 `empty` 解释为全网没有相关作品；微信公众号作者全网搜索仍可使用 `author_search`。
 - 查询指定作者最近作品时，直接使用 `intent=works_search`，同时提供 `platform`、`authorName` 和 `timeRange`；不得先用 `author_search` 的 `workCount` 判断该作者是否有作品。
 - `author_search` 返回的 `extAuthorId` 是平台外部作者 ID，不是易撰内部 `authorId`。需要按外部 ID 查询作品时只能传 `extAuthorId` / `ext_author_id`（兼容 `author_id`），必须同时提供 `platform`，由服务端完成内部 ID 转换；禁止把它直接作为内部 `authorId` 使用。
+- 关注公开作者时，先用 `author_search` 取得并选定完整作者资料，再调用 `accounts` 的 `mode=follow_public_author`；必须传该结果的 `platform`、`extAuthorId` 和 `nickname`。`nickname` 必须是公开搜索结果中的作者名称，绝不能将 `extAuthorId` 作为名称写入。
 - 公开作者结果中的 `workCount: 0` 可能是上游未返回作品数后的缺省值，不代表作者没有作品；是否有作品必须以 `works_search` 的结果为准。
 - 作品复合筛选优先使用统一协议 `intent=works_search`。平台使用 `platform`，分类使用 `categories`，内容类型使用 `content_type`，最低阅读/播放和评论分别使用 `min_views`、`min_comments`；需要固定顺序时显式传 `sort_by` 和 `order`。不得把作品查询改成作者、雷达或热点查询。
 - 当前 CLI 不支持按单篇作品 URL 或平台侧 `articleId` 精确查询作品详情。用户提供作品链接或文章 ID 时，直接说明该能力暂不支持；不得将完整链接或纯文章 ID 改作 `keyword` 搜索，也不得把这种搜索返回的 `empty` 解读为全网不存在该作品。
 - 作品查询返回后必须逐项核对用户要求的分类、类型和指标阈值；低于阈值或缺少必要指标的项目不得作为符合条件的结果展示，也不得擅自放宽条件。展示总数必须使用返回的 `data.total`，不能把当前页条数当成总数。
 - 作者累计指标筛选使用 `author_query`，不得改成作品指标或擅自降低阈值。必须逐项映射用户给出的所有条件：粉丝使用 `min_follower` / `max_follower`，点赞使用 `min_total_likes` / `max_total_likes`，阅读使用 `min_total_views` / `max_total_views`，关注使用 `min_friends` / `max_friends`，作品数使用 `min_work_count` / `max_work_count`；复合条件不得遗漏任何字段。例如“百家号粉丝大于50万，点赞大于10万”必须同时传 `platform_id:2`、`min_follower:500000` 和 `min_total_likes:100000`。
+- 用户按粉丝、关注、阅读、评论或点赞询问“最高作者”时，始终以作者结果的对应累计字段排序或判断，禁止改查作品、雷达作品或单篇作品指标。若返回作者中目标字段均为 `0`，如实说明“查询到的作者该指标均为 0，无法据此排序或判断最高作者”；不得据此断言平台不支持，也不得以作品数据补充或替代结论。
 - 作者指标查询返回后，必须核对 `data.items` 中所有已请求指标。指标缺失、显示“暂未返回”或低于/高于用户阈值的项目不得作为符合条件的结果展示；一旦发现此类项目，必须先检查实际请求参数是否遗漏对应的 min/max 字段并使用完整参数重新查询，禁止直接报告原总数。
 - “我的关注作者”使用 `radar` 且 `mode=following`，不是作品收藏。
 - “我的灵感”“灵感库”“灵感作品”“我的收藏”和“收藏作品”是同一业务概念，均直接使用 `favorites`；不得尝试 `inspiration` 等不存在的 ability，也不要反问用户是不是指收藏作品。

package/resources/yizhuan-cli/manifest.json

@@ -1,14 +1,14 @@
 {
   "schemaVersion": 1,
   "name": "yizhuan-cli",
-  "version": "0.1.16-beta.1",
-  "compatibleCliVersion": "0.1.16-beta.1",
-  "source": "npm:@yizhuan-cli/cli@0.1.16-beta.1",
+  "version": "0.1.16",
+  "compatibleCliVersion": "0.1.16",
+  "source": "npm:@yizhuan-cli/cli@0.1.16",
   "digestAlgorithm": "sha256",
   "files": [
     {
       "path": "SKILL.md",
-      "sha256": "4c7a2c189e1b86577a8b3ff290d7cc1031a4cf3fb3e3e075560f4b672adf90dc"
+      "sha256": "a46185057b4fa09503ba1773d3e8912a9a448c845f16c39759e5e19b246a1e39"
     }
   ]
 }

package/src/doctor.js

@@ -210,7 +210,7 @@ export function inspectSkill(
     }
     return check('pass', 'skill', `正式 Skill ${metadata.version} 来源和摘要有效：${resolved.target}`)
   } catch (error) {
-    return check('fail', 'skill', `正式 Skill 校验失败：${error.message}`, '保留冲突内容并人工确认，或移走后重新运行 skill sync。')
+    return check('fail', 'skill', `正式 Skill 校验失败：${error.message}`, '人工确认后运行 yizhuan skill sync --repair，或移走冲突内容后重新同步。')
   }
 }
 

package/src/index.js

@@ -59,7 +59,7 @@ Usage:
   yizhuan config init [--api-key-stdin] [--api-base-url <url>] [--force]
   yizhuan config path
   yizhuan config show
-  yizhuan skill sync [--global]
+  yizhuan skill sync [--global] [--host <name>] [--repair]
   yizhuan doctor [--json]
 
 Examples:
@@ -323,6 +323,65 @@ function assignFlagParams(params, args) {
   return params
 }
 
+const AUTHOR_RANKING_METRICS = [
+  {
+    key: 'friendsCount',
+    label: '关注数',
+    patterns: [/关注/, /friends(?:Count|_count)?/i]
+  },
+  {
+    key: 'followerCount',
+    label: '粉丝数',
+    patterns: [/粉丝/, /follower(?:Count|_count)?/i]
+  },
+  {
+    key: 'totalViews',
+    label: '阅读数',
+    patterns: [/阅读|播放/, /(?:total)?views?/i]
+  },
+  {
+    key: 'totalLikes',
+    label: '点赞数',
+    patterns: [/点赞/, /(?:total)?likes?/i]
+  }
+]
+
+function rankingMetric(query, params) {
+  const text = [
+    query,
+    params?.metric,
+    params?.sortBy,
+    params?.sort_by,
+    params?.order
+  ].filter(Boolean).join(' ')
+  if (!/(最高|最多|最大|第一|排行|排名|top)/i.test(text)) return undefined
+  return AUTHOR_RANKING_METRICS.find((metric) => metric.patterns.some((pattern) => pattern.test(text)))
+}
+
+export function annotateUnavailableAuthorRanking(result, { query, params } = {}) {
+  const metric = rankingMetric(query, params)
+  const items = result?.data?.items
+  if (!metric || !Array.isArray(items) || items.length === 0) return result
+
+  const allValuesAreZero = items.every((item) => Number(item?.[metric.key]) === 0)
+  if (!allValuesAreZero) return result
+
+  const message = `查询到的作者${metric.label}均为 0，无法据此排序或判断最高作者`
+  return {
+    ...result,
+    message: result.message || message,
+    data: {
+      ...result.data,
+      ranking: {
+        metric: metric.key,
+        status: 'unavailable',
+        reason: 'all_returned_values_zero',
+        message
+      }
+    }
+  }
+}
+
 export function buildExecuteParams(args) {
   if (args.jsonFile) {
     const conflictingKeys = ['params', 'query', ...PARAM_FLAG_KEYS].filter(
@@ -372,6 +431,7 @@ async function execute(args) {
     throw new Error(`未知 ability：${ability || ''}，请执行 yizhuan --help 查看可用能力`)
   }
 
+  const requestParams = buildExecuteParams(args)
   const config = readConfig()
   const response = await fetch(`${config.apiBaseUrl}/api/cli.execute`, {
     method: 'POST',
@@ -384,7 +444,7 @@ async function execute(args) {
       json: {
         ability,
         query: typeof args.query === 'string' ? args.query : undefined,
-        params: buildExecuteParams(args)
+        params: requestParams
       }
     })
   })
@@ -395,7 +455,6 @@ async function execute(args) {
   }
 
   let result = payloadResult(JSON.parse(text))
-  const requestParams = buildExecuteParams(args)
   if (
     ability === 'detection' &&
     requestParams?.wait === true &&
@@ -426,6 +485,10 @@ async function execute(args) {
       result = payloadResult(JSON.parse(pollText))
     }
   }
+  result = annotateUnavailableAuthorRanking(result, {
+    query: typeof args.query === 'string' ? args.query : undefined,
+    params: requestParams
+  })
   console.log(JSON.stringify(result, null, 2))
 }
 
@@ -468,9 +531,11 @@ async function query(args) {
   })
   const text = await response.text()
   if (!response.ok) throw new Error(`请求失败 HTTP ${response.status}：${text}`)
-  console.log(
-    renderQuery(JSON.parse(text).result?.data?.json ?? JSON.parse(text), args.format || 'json')
-  )
+  const result = annotateUnavailableAuthorRanking(payloadResult(JSON.parse(text)), {
+    query: request.query || request.keyword,
+    params: request
+  })
+  console.log(renderQuery(result, args.format || 'json'))
 }
 
 async function main() {
@@ -510,7 +575,7 @@ async function main() {
   }
 
   if (command === 'skill' && args._[1] === 'sync') {
-    assertCommandArgs(args, 'skill sync', new Set(['global', 'host', 'help']), 2)
+    assertCommandArgs(args, 'skill sync', new Set(['global', 'host', 'repair', 'help']), 2)
     await runSkillSync(args)
     return
   }

package/src/skill.js

@@ -90,7 +90,7 @@ export function loadOfficialSkill(resourceDir = DEFAULT_RESOURCE_DIR) {
   return { manifest, resourceDir }
 }
 
-export function readSkillMetadata(target) {
+export function readSkillMetadata(target, { allowModified = false } = {}) {
   const metadataPath = path.join(target, SKILL_METADATA_FILE)
   if (!fs.existsSync(metadataPath)) {
     throw new Error(`目标存在未受易撰管理的同名内容，已停止同步：${target}`)
@@ -111,7 +111,7 @@ export function readSkillMetadata(target) {
   }
   for (const file of metadata.files) {
     const installedPath = safeResourcePath(target, file.path)
-    if (!fs.existsSync(installedPath) || sha256File(installedPath) !== file.sha256) {
+    if (!allowModified && (!fs.existsSync(installedPath) || sha256File(installedPath) !== file.sha256)) {
       throw new Error(`已安装 Skill 包含未知修改，已停止覆盖：${file.path}`)
     }
   }
@@ -182,14 +182,15 @@ export function syncOfficialSkill(
   {
     loadBundle = loadOfficialSkill,
     installBundle = installStagedSkill,
-    now = () => new Date()
+    now = () => new Date(),
+    repair = false
   } = {}
 ) {
   const bundle = loadBundle()
   const { manifest } = bundle
   let installed
   if (fs.existsSync(resolved.target)) {
-    installed = readSkillMetadata(resolved.target)
+    installed = readSkillMetadata(resolved.target, { allowModified: repair })
     const comparison = compareVersions(installed.version, manifest.version)
     if (comparison > 0) {
       return { action: 'newer', metadata: installed, target: resolved.target }
@@ -257,11 +258,12 @@ export function resolveSkillTarget(
 
 export function printSkillSyncHelp() {
   console.log(`Usage:
-  yizhuan skill sync [--global] [--host <name>]
+  yizhuan skill sync [--global] [--host <name>] [--repair]
 
 Options:
   --global  安装到当前受支持宿主的用户级 Skill 目录
   --host    明确指定 codex、agents、trae、claude 或 cursor
+  --repair  仅覆盖带官方托管元数据但内容校验失败的 Skill
   --help    显示本帮助`)
 }
 
@@ -272,7 +274,7 @@ export async function runSkillSync(args) {
   }
 
   const resolved = resolveSkillTarget({ global: Boolean(args.global), host: args.host })
-  const result = syncOfficialSkill(resolved)
+  const result = syncOfficialSkill(resolved, { repair: Boolean(args.repair) })
   const actionText = {
     installed: '已安装',
     updated: '已更新',