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

package/package.json

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

package/resources/yizhuan-cli/manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
   "name": "yizhuan-cli",
-  "version": "0.1.16-beta.2",
-  "compatibleCliVersion": "0.1.16-beta.2",
-  "source": "npm:@yizhuan-cli/cli@0.1.16-beta.2",
+  "version": "0.1.16",
+  "compatibleCliVersion": "0.1.16",
+  "source": "npm:@yizhuan-cli/cli@0.1.16",
   "digestAlgorithm": "sha256",
   "files": [
     {

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: '已更新',