Skip to content

v1.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 30 Oct 17:33
· 3 commits to main since this release
db95542

English

Breaking changes

  • Go SDK: Replace removed XxxDTO types and ToXxxDTO converters with the public entity models, which now serialize directly. Replace AddBookmark / RemoveBookmark with AddArtworkBookmark / RemoveArtworkBookmark; SetAIArtworkVisibility is removed. Replace Artwork.Kind / RawKind and ArtworkKind with Artwork.ContentType and ContentType (illust, manga, ugoira); unknown upstream values are preserved. Empty tag translations and absent profile/cover images are omitted from JSON. (#170, #271)
  • CLI JSON and NDJSON: Content lists use {records, pagination} with string IDs. Artwork records use type:"artwork"; select subtypes through content_type. recommended --type all groups results into artworks, novels, and users. Pipeline diagnostics drop kind:"record_error". Update scripts consuming these outputs. (#271)
  • MCP and FANBOX selectors: MCP entity selectors change from kind to type. pixiv_recommended accepts type=all|artwork|novel|user, with artwork subtypes selected through content_type=all|illust|manga, and returns entity partitions. Change fanbox_creators.kind to relation and CLI fanbox creators --kind to --relation. (#271)
  • Account JSON: Auth summaries remove has_token, premium_status_checked_at, warning, and eligible; account-list and bundle-import results remove redundant default_user_id. An empty auth list --json returns "accounts":[]. Update consumers relying on these fields. (#271)
  • Gallery settings: Remove mcp_gallery_cache_ttl and mcp_gallery_concurrency. Cache TTL is fixed at 15 minutes; metadata and image read concurrency are each fixed at 4. Remove obsolete settings from config.toml; leftover undeclared keys are ignored when loading configuration. (#168, #185)
  • Remove the pointless pixiv --licenses command and bundled third-party license notices. Remove invocations of this flag from scripts. (#234)

Added

  • Add pixiv whoami [--json] to show the current local Pixiv account and cached Premium status without network access or token rotation. JSON output matches an auth list --json account entry. (#260)
  • Add the HTTP MCP pixiv_show_artwork tool for displaying a single artwork. The Gallery adapts to phones and embedded panels and adds cube-style page turns. (#167)

Changed

  • Unify terminal output with readable account identities, status labels, single-line lists, and detail cards. Empty results print No results. to stderr and exit successfully. fanbox download keeps stdout empty on success. Scripts parsing text should use --json or --ndjson where supported, applying the migration changes above. (#269, #270)
  • Compact stderr logs with timestamps, operations, levels, and source locations. JSON logs include command-failure records; debug logs add SDK error origins and safe network details, including OAuth token-exchange failures. Default text logging keeps one error line. (#258, #261)

Fixed

  • Preserve MCP artwork filters when a bookmark strategy is explicitly selected without bookmark bounds. Apply bookmark bounds and artwork filters together before pagination. CLI and MCP best_effort searches report partial even when candidates are empty or exhausted. (#165)
  • Treat early downstream pipe closure as success across automatically selected NDJSON commands, including series, bookmarks, comments, and reverse search. (#246)
  • Escape upstream titles, names, comments, and tags in terminal output. Explain authentication, argument, HTTP, timeout, and cancellation failures with a next step; validate local enum arguments before opening an account. FANBOX creator and post commands report output-write failures. (#268)

Full Changelog: v1.2.1...v1.3.0


简体中文

破坏性变更

  • Go SDK: 删除 XxxDTO 类型及 ToXxxDTO 转换函数,改用可直接序列化的公开实体模型。AddBookmark / RemoveBookmark 改用 AddArtworkBookmark / RemoveArtworkBookmark;移除 SetAIArtworkVisibility。Artwork.Kind / RawKind 与 ArtworkKind 改用 Artwork.ContentType 和 ContentType(illust、manga、ugoira),未知上游值原样保留。JSON 省略空标签译名及缺失的头像、封面字段。(#170、#271)
  • CLI JSON 与 NDJSON: 内容列表统一为 {records, pagination},ID 使用字符串。作品记录统一使用 type:"artwork",子类型通过 content_type 筛选。recommended --type all 按 artworks、novels、users 分区返回。管道诊断删除 kind:"record_error"。读取这些输出的脚本需要同步调整。(#271)
  • MCP 与 FANBOX 选择参数: MCP 实体选择参数由 kind 改为 type。pixiv_recommended 接受 type=all|artwork|novel|user,作品子类型通过 content_type=all|illust|manga 选择,结果按实体分区。fanbox_creators.kind 改为 relation,CLI fanbox creators --kind 改为 --relation。(#271)
  • 账号 JSON: 认证摘要删除 has_token、premium_status_checked_at、warning、eligible;账号列表与 bundle 导入结果删除重复的 default_user_id。空账号列表的 auth list --json 输出为 "accounts":[]。依赖上述字段的调用方需要同步调整。(#271)
  • Gallery 配置: 移除 mcp_gallery_cache_ttl 与 mcp_gallery_concurrency,缓存有效期固定为 15 分钟,元数据与图片的读取并发上限各固定为 4。请从 config.toml 删除旧设置;加载配置时会忽略残留的未声明键。(#168、#185)
  • 移除无意义的 pixiv --licenses 命令及随包分发的第三方许可证汇总;请删除脚本中对该参数的调用。(#234)

新增

  • 新增 pixiv whoami [--json],直接显示当前本地 Pixiv 账号与缓存的会员状态,无需联网或轮换 token;JSON 输出与 auth list --json 的账号项一致。(#260)
  • HTTP MCP 新增 pixiv_show_artwork 工具,用于展示单个作品;Gallery 适配手机与嵌入式面板,并增加立方体翻页效果。(#167)

变更

  • 终端输出统一使用易读的账号身份、状态标签、单行列表与详情卡片。空结果向 stderr 输出 No results. 并成功退出;fanbox download 成功时 stdout 保持为空。解析文本的脚本请优先使用命令支持的 --json 或 --ndjson,并按上方说明迁移机器输出。(#269、#270)
  • 精简 stderr 日志,显示时间、操作、级别与源码位置。JSON 日志包含命令失败记录;debug 日志补充 SDK 错误创建位置与安全的网络细节,覆盖 OAuth 换 token 失败。默认文本日志只保留一行错误。(#258、#261)

修复

  • MCP 搜索显式指定收藏策略、未指定收藏数区间时,仍保留作品筛选条件;收藏数区间与作品筛选在分页前共同生效。CLI 与 MCP 的 best_effort 搜索即使候选为空或已耗尽,也会报告 partial。(#165)
  • 系列、收藏、评论、反向搜图等自动选择 NDJSON 的命令,在下游提前关闭管道时正常退出。(#246)
  • 转义终端输出中的上游标题、用户名、评论与标签;登录、参数、HTTP、超时与取消错误提供可读说明及下一步,本地枚举参数先于打开账号校验。FANBOX 创作者与帖子命令会报告输出写入失败。(#268)

完整变更: v1.2.1...v1.3.0