dsh-animebar 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 V1Y0h
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,113 @@
-# Temporary Holding Version
+# dsh-animebar
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+给 DeepSeek Harness 的看番工具：问一句「今天有什么番」，得到按评分排好的清单。
+
+[中文](#中文) · [English](#english)
+
+---
+
+## 中文
+
+### 它做什么
+
+注册一个工具 `anime_today`，读 [Bangumi](https://bgm.tv) 的公开放送表，返回某一天在播的作品，含低分和没评分的，按分数排序。
+
+```
+今天有什么番
+周三有哪些番在播
+最近有什么剧场版动画
+```
+
+`kind` 支持两种模式：
+
+- `tv`（默认）— 每周放送表
+- `movie` — 剧场版，翻页抓取后按评分排序
+
+返回结构：
+
+```json
+{ "weekday": 5, "total": 6, "items": [{ "title": "…", "score": 7.6, "url": "…" }] }
+```
+
+### 安装
+
+```sh
+# 直接从仓库装
+dsh plugin --profile desktop add github:V1Y0h/animebar-plugin
+```
+
+也可以把本地目录加进 **设置 → 插件**。安装后重启 DeepSeek Harness，工具才会注册。
+
+npm 版本还没发布；发出去之后 `dsh plugin --profile desktop add dsh-animebar` 也能用。
+
+### 平台
+
+插件是纯 Host 侧 JavaScript，没有原生代码，所以只要能跑 DeepSeek Harness 就能用——macOS、Linux、Windows 都行。只要求能访问 Bangumi 的网络。
+
+### 配置
+
+bundle 那一行支持 `config`：
+
+| 字段 | 默认 | 说明 |
+| --- | --- | --- |
+| `minScore` | `0` | 低于这个分数的不返回；0 表示全部显示（含无评分） |
+| `limit` | `8` | 最多返回几部 |
+
+### 数据与隐私
+
+插件在请求时调用 `api.bgm.tv`，不存任何东西、不做缓存、不分发任何番剧画面或内容。离开你机器的只有你查询的番名。
+
+### 限制
+
+- 只覆盖 Bangumi 收录的作品，冷门和独立动画经常缺失。
+- 打分人数很少的作品，分数不可靠。
+- 不提供播放，看还得用你自己的播放器。
+
+### 写给插件作者
+
+做这个插件时有两处很费时间，而且都不明显：
+
+1. 本地链接安装的 bundle，依赖必须在包目录里自己 `pnpm add` 一遍。只写进 `package.json` 不够，因为 pnpm 对本地目录是 link 而不是安装。
+2. `defineTool` 必须提供 `output: { schema, render }`。少任何一个，激活时都会报 `Cannot read properties of undefined (reading 'render')`。
+
+### 许可
+
+MIT。图标是作者本人绘制。
+
+---
+
+## English
+
+Registers one tool, `anime_today`, which reads the public [Bangumi](https://bgm.tv) broadcast calendar and returns the titles airing on a weekday, filtered by rating and sorted by score.
+
+### Install
+
+```sh
+dsh plugin --profile desktop add github:V1Y0h/animebar-plugin
+```
+
+Or point **Plugins → Add plugin** at a local checkout. Restart DeepSeek Harness afterwards so the tool registers.
+
+### Modes
+
+`kind: "tv"` (default) reads the weekly broadcast calendar. `kind: "movie"` searches theatrical films and ranks them by rating.
+
+### Configuration
+
+| key | default | meaning |
+| --- | --- | --- |
+| `minScore` | `0` | skip titles rated below this; 0 keeps everything, including unrated |
+| `limit` | `8` | maximum titles returned |
+
+### Data and privacy
+
+The plugin calls `api.bgm.tv` at request time. It stores nothing, caches nothing, and ships no artwork or episode content.
+
+### Notes for plugin authors
+
+1. A locally linked bundle still needs its own `pnpm add <dependency>` inside the package directory.
+2. `defineTool` requires `output: { schema, render }`.
+
+### License
+
+MIT. The icon is the author's own artwork.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: animebar
+      name: dsh-animebar
+      config: {}

package/docs/DETAIL.md

@@ -0,0 +1,31 @@
+# AnimeBar
+
+给 DeepSeek Harness 加一个查番表的工具。
+
+## 用法
+
+直接问「今天有什么番」，或者指定星期：
+
+```
+今天有什么好看的番
+周三有哪些番在播
+```
+
+工具会返回当天在播、评分不低于配置阈值的作品，按分数从高到低。
+
+## 配置
+
+| 字段 | 默认 | 说明 |
+| --- | --- | --- |
+| `minScore` | 7 | 低于这个分数的不返回 |
+| `limit` | 8 | 最多返回几部 |
+
+## 数据来源
+
+放送表来自 [Bangumi](https://bgm.tv) 的公开接口 `api.bgm.tv/calendar`，本插件不缓存、不分发任何番剧内容。
+
+## 限制
+
+- 只覆盖 Bangumi 收录的作品，冷门/独立动画可能缺失
+- 评分样本少的作品分数会失真（比如只有几个人打分）
+- 不提供播放：想看还得自己用播放器

package/icon.svg

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="1254" height="1254" viewBox="0 0 1254 1254">
+  <path d="M 913 317 L 908 315 L 899 315 L 833 337 L 333 493 L 318 499 L 313 504 L 310 512 L 310 517 L 331 583 L 331 596 L 328 605 L 328 918 L 333 931 L 339 938 L 346 942 L 354 944 L 916 944 L 926 940 L 935 932 L 940 920 L 941 717 L 940 602 L 933 592 L 927 589 L 912 588 L 448 589 L 442 588 L 440 585 L 441 583 L 544 552 L 550 549 L 570 544 L 940 429 L 948 419 L 948 408 L 921 326 Z M 862 607 L 792 696 L 725 695 L 795 605 L 860 605 Z M 698 606 L 630 696 L 563 695 L 630 605 Z M 543 606 L 473 696 L 406 695 L 440 649 L 475 605 Z M 368 562 L 376 562 L 384 566 L 390 572 L 393 580 L 392 589 L 389 595 L 383 601 L 374 604 L 369 604 L 361 601 L 354 594 L 351 586 L 351 579 L 355 570 L 362 564 Z M 529 451 L 530 454 L 492 550 L 489 553 L 435 569 L 429 556 L 459 474 L 461 472 Z M 689 401 L 691 403 L 675 440 L 652 500 L 649 503 L 584 523 L 584 518 L 619 424 L 637 417 Z M 847 352 L 847 357 L 811 452 L 800 457 L 744 474 L 743 472 L 777 375 L 798 367 Z" fill="#000000" fill-rule="evenodd" clip-rule="evenodd"/>
+</svg>

package/index.js

@@ -0,0 +1,85 @@
+import { defineTool } from "@deepseek-ai/dsh-tools";
+
+export const name = "animebar";
+export const inject = ["tools"];
+
+const CALENDAR = "https://api.bgm.tv/calendar";
+const UA = "dsh-animebar/0.1 (+https://github.com/)";
+
+async function fetchMovies(pages = 4) {
+  const all = [];
+  for (let page = 0; page < pages; page += 1) {
+    const res = await fetch(`https://api.bgm.tv/v0/search/subjects?limit=20&offset=${page * 20}`, {
+      method: "POST",
+      headers: { "user-agent": UA, "content-type": "application/json" },
+      body: JSON.stringify({ keyword: "劇場版", filter: { type: [2] }, sort: "heat" }),
+    });
+    if (!res.ok) break;
+    const data = await res.json();
+    const rows = data.data ?? [];
+    if (rows.length === 0) break;
+    all.push(...rows.map((item) => ({
+      title: item.name_cn || item.name,
+      score: item.rating?.score ?? 0,
+      date: item.date ?? "",
+      url: `https://bgm.tv/subject/${item.id}`,
+    })));
+  }
+  return all;
+}
+
+async function fetchCalendar() {
+  const res = await fetch(CALENDAR, { headers: { "user-agent": UA, accept: "application/json" } });
+  if (!res.ok) throw new Error(`Bangumi API returned ${res.status}`);
+  return res.json();
+}
+
+export function apply(ctx, config) {
+  const minScore = Number(config?.minScore ?? 0);
+  const limit = Number(config?.limit ?? 8);
+
+  ctx.tools.register(defineTool({
+    name: "anime_today",
+    description: "List every anime airing on a given weekday (default: today) from Bangumi, ranked by rating. Low-rated titles are included; raise minScore in the bundle config to filter.",
+    parameters: {
+      weekday: {
+        type: "number",
+        description: "ISO weekday, 1 = Monday through 7 = Sunday. Defaults to today. Ignored when kind is movie.",
+      },
+      kind: {
+        type: "string",
+        enum: ["tv", "movie"],
+        description: "tv lists the weekly broadcast schedule; movie lists theatrical films sorted by rating.",
+      },
+    },
+    output: {
+      schema: { type: "object", additionalProperties: true },
+      render: (_args, value) => [{ type: "text", text: JSON.stringify(value) }],
+    },
+    async execute(args) {
+      if (args?.kind === "movie") {
+        const films = (await fetchMovies())
+          .filter((f) => f.score >= minScore)
+          .sort((a, b) => b.score - a.score)
+          .slice(0, limit);
+        return { kind: "movie", total: films.length, items: films };
+      }
+      const data = await fetchCalendar();
+      const weekday = Number(args?.weekday) || new Date().getDay() || 7;
+      const items = data
+        .filter((day) => day?.weekday?.id === weekday)
+        .flatMap((day) => day.items ?? [])
+        .map((item) => ({
+          title: item.name_cn || item.name,
+          original: item.name_cn ? item.name : undefined,
+          score: item.rating?.score ?? 0,
+          url: item.url,
+        }))
+        .filter((item) => item.score >= minScore)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+
+      return { weekday, total: items.length, items };
+    },
+  }));
+}

package/locale/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "AnimeBar",
+    "description": "Shows today's anime lineup from Bangumi and returns it as a ranked list.",
+    "detail": "docs/DETAIL.md"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "title": "AnimeBar 番表",
+    "description": "从 Bangumi 取当天在播的番剧，按评分排好交给你。",
+    "detail": "docs/DETAIL.md"
+  }
+}

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "dsh-animebar",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Anime airing board for DeepSeek Harness — today's lineup from Bangumi.",
+  "exports": {
+    ".": "./index.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "docs",
+    "icon.svg"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-tools": "0.2.2-rc.1"
+  },
+  "license": "MIT",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "anime",
+    "bangumi",
+    "plugin"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/V1Y0h/animebar-plugin.git"
+  },
+  "homepage": "https://github.com/V1Y0h/animebar-plugin#readme"
 }