@weibaohui/dsh-code-poem 0.3.0

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@weibaohui/dsh-code-poem",
+  "version": "0.3.0",
+  "description": "dsh 插件 · 代码如诗：4598 条古诗词、成语、龙文鞭影典故随机成笺，随会话事件自动浮现（回合结束/工具报错时送你一句），可 ❤ 收藏、展开看释义与故事，宣纸墨色的阅读卡片。",
+  "license": "MIT",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "cordis",
+    "plugin",
+    "poem",
+    "idiom",
+    "allusion",
+    "dsh-plugin"
+  ],
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./client": "./client/bundle-mc.js",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "files": [
+    "src",
+    "client",
+    "data",
+    "cordis.patch.yml"
+  ],
+  "scripts": {
+    "check": "node --check src/index.js && node --check client/index.js",
+    "build:client": "node scripts/build-client.mjs",
+    "export:data": "python3 scripts/export_data.py",
+    "prepublishOnly": "npm run build:client && npm run check",
+    "test": "node --test test/*.test.mjs"
+  },
+  "engines": {
+    "node": ">=22.5"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weibaohui/dsh-code-poem.git"
+  },
+  "homepage": "https://github.com/weibaohui/dsh-code-poem#readme",
+  "bugs": {
+    "url": "https://github.com/weibaohui/dsh-code-poem/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.js

@@ -0,0 +1,214 @@
+'use strict'
+
+/**
+ * dsh-code-poem — Host half
+ *
+ * 代码如诗：从 4598 条诗笺（古诗词 604 / 成语 1930 / 龙文鞭影典故 2064）
+ * 中随机抽一条，供 web 客户端的诗笺卡片消费。数据集随 npm 包自带
+ * （data/entries.json，统一 schema：id/kind/title/sub/author/front/digest/sections），
+ * 也可用插件配置 `dataDir` 指向外部数据集（目录下放 entries.json）。
+ *
+ * HTTP API（/dsh-code-poem/api/*）：
+ *   GET /draw?kind=all|诗|词|文|成语|典故&exclude=id1,id2
+ *                        随机抽一条（exclude 里的 id 优先避开）
+ *   GET /bundle?kind=&n=30&exclude=
+ *                        一次随机取 n 条（客户端低频批量拉取，本地池消费）
+ *   GET /entry?id=       按 id 取整条
+ *   GET /status          数据集概况
+ *   GET /reload          重新读取数据文件
+ *   GET /feed?after=N    会话事件流（turn_end/tool_error/user_msg...），供客户端联动
+ *
+ * 零 npm 依赖：只用 node 内置模块，经注入的 `webServer` 挂路由。
+ */
+
+const fs = require('node:fs')
+const path = require('node:path')
+
+const BUNDLED_DATA_DIR = path.join(__dirname, '..', 'data')
+
+/** 读取数据文件并构建索引。 */
+class PoemStore {
+  constructor(dataDir) {
+    this.dataDir = dataDir
+    this.file = path.join(dataDir, 'entries.json')
+    this.entries = []
+    this.byIdMap = new Map()
+    this.byKind = new Map()
+  }
+
+  build() {
+    const raw = fs.readFileSync(this.file, 'utf8')
+    const list = JSON.parse(raw)
+    if (!Array.isArray(list) || !list.length) throw new Error('entries.json 为空或格式不对')
+    this.entries = list
+    this.byIdMap = new Map(list.map((e) => [e.id, e]))
+    this.byKind = new Map()
+    for (const e of list) {
+      if (!this.byKind.has(e.kind)) this.byKind.set(e.kind, [])
+      this.byKind.get(e.kind).push(e)
+    }
+    return list.length
+  }
+
+  kinds() { return [...this.byKind.keys()] }
+
+  draw(kind, exclude = []) {
+    const ex = new Set(exclude)
+    let pool
+    if (!kind || kind === 'all' || kind === '全部') pool = this.entries
+    else pool = this.byKind.get(kind)
+    if (!pool || !pool.length) return undefined
+    if (ex.size) {
+      const fresh = pool.filter((e) => !ex.has(e.id))
+      if (fresh.length) pool = fresh
+    }
+    return pool[Math.floor(Math.random() * pool.length)]
+  }
+
+  byId(id) { return this.byIdMap.get(id) }
+
+  status() {
+    const kinds = {}
+    for (const e of this.entries) kinds[e.kind] = (kinds[e.kind] || 0) + 1
+    return {
+      total: this.entries.length,
+      kinds,
+      dataFile: this.file,
+      mtime: fs.existsSync(this.file) ? fs.statSync(this.file).mtime.toISOString() : undefined,
+    }
+  }
+}
+
+module.exports = {
+  name: 'dsh-code-poem',
+  inject: ['webServer'],
+
+  __test: { PoemStore, BUNDLED_DATA_DIR },
+
+  apply(ctx, rawConfig) {
+    const config = rawConfig && typeof rawConfig === 'object' ? rawConfig : {}
+    const dataDir = config.dataDir || BUNDLED_DATA_DIR
+    const store = new PoemStore(dataDir)
+    try {
+      const n = store.build()
+      ctx.logger?.info?.(`[dsh-code-poem] 诗笺数据加载完成：${n} 条`)
+    } catch (err) {
+      ctx.logger?.warn?.(`[dsh-code-poem] 数据加载失败：${err.message}（${dataDir}）`)
+    }
+
+    // ── 诗笺缘起：订阅会话事件流，供客户端随机触发诗笺 ──────────────────
+    const feed = []
+    let feedSeq = 0
+    const FEED_MAX = 60
+    const feedPush = (kind, extra = {}) => {
+      feedSeq += 1
+      feed.push({ id: feedSeq, at: new Date().toISOString(), kind, ...extra })
+      if (feed.length > FEED_MAX) feed.splice(0, feed.length - FEED_MAX)
+    }
+
+    ctx.effect(() => {
+      const onSessionEvent = (session, event) => {
+        try {
+          const sessionId = session && session.id
+          const base = { sessionId: typeof sessionId === 'string' ? sessionId : undefined }
+          switch (event && event.type) {
+            case 'user/message': {
+              const src = event.data && event.data.source
+              if (src && src.kind !== 'user') return
+              const text = typeof (event.data && event.data.content) === 'string'
+                ? event.data.content
+                : ''
+              feedPush('user_msg', { ...base, text: text.replace(/\s+/g, ' ').slice(0, 80) })
+              break
+            }
+            case 'tool/call': {
+              const tool = (event.data && event.data.name) || 'tool'
+              feedPush('tool_call', { ...base, tool })
+              break
+            }
+            case 'tool/result': {
+              const tool = (event.data && event.data.name) || ''
+              const failed = !!(event.data && ((event.data.message && event.data.message.isError === true) || event.data.error !== undefined))
+              feedPush(failed ? 'tool_error' : 'tool_ok', { ...base, tool })
+              break
+            }
+            case 'turn/end':
+              feedPush('turn_end', base)
+              break
+            case 'turn/start':
+              feedPush('turn_start', base)
+              break
+          }
+        } catch (e) {
+          ctx.logger?.warn?.(`[dsh-code-poem] session/event handler: ${e && e.message}`)
+        }
+      }
+      const dispose = ctx.on('session/event', onSessionEvent)
+      return () => { try { dispose() } catch {} }
+    }, 'dsh-code-poem: session/event subscription')
+
+    const sendJson = (res, status, payload) => {
+      res.writeHead(status, { 'content-type': 'application/json; charset=utf-8' })
+      res.end(JSON.stringify(payload))
+    }
+
+    ctx.effect(() => ctx.webServer.register({
+      kind: 'prefix',
+      path: '/dsh-code-poem/api',
+      handler: async (req, res) => {
+        try {
+          const url = new URL(req.url || '/', 'http://dsh.local')
+          const p = url.pathname.replace(/\/+$/, '')
+          if (req.method === 'GET' && p.endsWith('/dsh-code-poem/api/draw')) {
+            if (!store.entries.length) { sendJson(res, 503, { error: '诗笺索引为空' }); return }
+            const exclude = (url.searchParams.get('exclude') || '').split(',').filter(Boolean)
+            const e = store.draw(url.searchParams.get('kind'), exclude)
+            if (!e) { sendJson(res, 404, { error: '该类别下没有诗笺' }); return }
+            sendJson(res, 200, { entry: e })
+            return
+          }
+          if (req.method === 'GET' && p.endsWith('/dsh-code-poem/api/bundle')) {
+            if (!store.entries.length) { sendJson(res, 503, { error: '诗笺索引为空' }); return }
+            const kind = url.searchParams.get('kind') || 'all'
+            const n = Math.min(60, Math.max(1, Number(url.searchParams.get('n') || 30)))
+            const ex = new Set((url.searchParams.get('exclude') || '').split(',').filter(Boolean))
+            let pool = (!kind || kind === 'all' || kind === '全部') ? store.entries : store.byKind.get(kind) || []
+            const fresh = ex.size ? pool.filter((e) => !ex.has(e.id)) : pool
+            if (fresh.length >= n) pool = fresh
+            const picked = pool.slice()
+            for (let i = picked.length - 1; i > 0; i--) {
+              const j = Math.floor(Math.random() * (i + 1))
+              ;[picked[i], picked[j]] = [picked[j], picked[i]]
+            }
+            sendJson(res, 200, { entries: picked.slice(0, n) })
+            return
+          }
+          if (req.method === 'GET' && p.endsWith('/dsh-code-poem/api/entry')) {
+            const e = store.byId(url.searchParams.get('id') || '')
+            if (!e) { sendJson(res, 404, { error: '诗笺不存在' }); return }
+            sendJson(res, 200, { entry: e })
+            return
+          }
+          if (req.method === 'GET' && p.endsWith('/dsh-code-poem/api/status')) {
+            sendJson(res, 200, store.status())
+            return
+          }
+          if (req.method === 'GET' && p.endsWith('/dsh-code-poem/api/feed')) {
+            const after = Number(url.searchParams.get('after') || 0)
+            const events = feed.filter((ev) => ev.id > after)
+            sendJson(res, 200, { events })
+            return
+          }
+          if (req.method === 'GET' && p.endsWith('/dsh-code-poem/api/reload')) {
+            const n = store.build()
+            sendJson(res, 200, { reloaded: true, total: n })
+            return
+          }
+          sendJson(res, 404, { error: 'unknown api' })
+        } catch (err) {
+          sendJson(res, 500, { error: String(err && err.message || err) })
+        }
+      },
+    }), 'dsh-code-poem: api route')
+  },
+}