dsh-trpg-scenario 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 畔川俱乐部
+
+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,60 @@
-# Temporary Holding Version
+# dsh-trpg-scenario
 
-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 的 AI 跑团插件：导入剧本包、开局、评分。
+
+## 装
+
+```
+dsh plugin --profile desktop add dsh-trpg-scenario
+```
+
+或在 DSH 里让 Agent 用 `plugin_manager` 的 `install_bundle` 装本地目录。
+
+装完重启 DSH 一次。
+
+## 用
+
+| 命令 | 作用 |
+|---|---|
+| `/trpg list` | 列出已装剧本 |
+| `/trpg import <zip>` | 导入一个剧本包 |
+| `/trpg remove <名称>` | 删除剧本 |
+| `/trpg play <名称>` | 开一局 |
+| `/trpg judge <名称>` | 开评分会话 |
+
+剧本库默认在 `~/.dsh/trpg/scenarios`。
+
+## 剧本包格式
+
+一个 zip，里面正好六个文件：
+
+```
+manifest.yaml    id / title / kind / minutes
+system.md        玩法与规则
+setting.md       背景、角色、初始困境
+opening.md       开场场景
+rubric.md        评分维度（每维 0–10）
+judge.md         评委系统提示词
+```
+
+缺一个就会被拒收，并告诉你缺哪个。
+
+## 上下文怎么进
+
+`play` 时把三个文件作为**三个独立段落**注入系统提示词：
+
+- `trpg/rules` ← `system.md`
+- `trpg/world` ← `setting.md`
+- `trpg/opening` ← `opening.md`
+
+规则、世界、开场互不污染，换剧本只替换后两段。
+
+## 限制
+
+- 目前只有命令入口，没有图形界面的上传面板
+- 依赖系统的 `unzip` 命令解包
+- 未在 Windows 上验证
+
+## 许可
+
+MIT

package/cordis.patch.yml

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

package/icon.svg

@@ -0,0 +1,8 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect x="4" y="10" width="56" height="44" rx="6" fill="#1f2937"/>
+  <path d="M4 20 L60 20" stroke="#4b5563" stroke-width="2"/>
+  <circle cx="12" cy="15" r="2.5" fill="#ef4444"/>
+  <circle cx="20" cy="15" r="2.5" fill="#f59e0b"/>
+  <circle cx="28" cy="15" r="2.5" fill="#10b981"/>
+  <text x="32" y="46" font-family="monospace" font-size="20" fill="#e5e7eb" text-anchor="middle">&gt;_</text>
+</svg>

package/index.js

@@ -0,0 +1,222 @@
+import { execFile } from 'node:child_process'
+import { mkdir, readdir, readFile, rm, stat } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import { promisify } from 'node:util'
+
+const run = promisify(execFile)
+
+const REQUIRED = ['manifest.yaml', 'system.md', 'setting.md', 'opening.md', 'rubric.md', 'judge.md']
+
+export const name = 'dsh-trpg-scenario'
+export const inject = ['commands', 'agents']
+
+function parseManifest(text) {
+  const out = {}
+  for (const line of text.split('\n')) {
+    const m = /^([A-Za-z_][\w-]*)\s*:\s*(.*)$/.exec(line.trim())
+    if (m) out[m[1]] = m[2].replace(/^["']|["']$/g, '').trim()
+  }
+  return out
+}
+
+export function apply(ctx, config = {}) {
+  const root = config.root ?? join(homedir(), '.dsh', 'trpg', 'scenarios')
+  const ok = (text) => ({ kind: 'success', text })
+  const err = (text) => ({ kind: 'error', text })
+
+  async function installedNames() {
+    try {
+      const entries = await readdir(root, { withFileTypes: true })
+      return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort()
+    } catch {
+      return []
+    }
+  }
+
+  async function loadScenario(dir) {
+    const meta = parseManifest(await readFile(join(dir, 'manifest.yaml'), 'utf8'))
+    const [system, setting, opening, rubric, judge] = await Promise.all(
+      ['system.md', 'setting.md', 'opening.md', 'rubric.md', 'judge.md'].map((f) =>
+        readFile(join(dir, f), 'utf8'),
+      ),
+    )
+    return { meta, system, setting, opening, rubric, judge }
+  }
+
+  async function cmdList() {
+    const names = await installedNames()
+    if (!names.length) return ok(`剧本库为空：${root}\n用 /trpg import <zip 路径> 导入。`)
+    const lines = []
+    for (const n of names) {
+      try {
+        const { meta } = await loadScenario(join(root, n))
+        lines.push(`· ${n}　${meta.title ?? ''}　${meta.kind ?? ''}　${meta.minutes ?? ''} 分钟`)
+      } catch {
+        lines.push(`· ${n}　（损坏，缺少文件）`)
+      }
+    }
+    return ok(`剧本库（${root}）\n${lines.join('\n')}`)
+  }
+
+  async function cmdImport(rawPath) {
+    const zip = rawPath.trim().replace(/^["']|["']$/g, '')
+    if (!zip) return err('用法：/trpg import <zip 路径>')
+    try {
+      await stat(zip)
+    } catch {
+      return err(`找不到文件：${zip}`)
+    }
+
+    const tmp = join(root, '.incoming')
+    await rm(tmp, { recursive: true, force: true })
+    await mkdir(tmp, { recursive: true })
+
+    try {
+      await run('unzip', ['-o', '-q', zip, '-d', tmp])
+    } catch (e) {
+      await rm(tmp, { recursive: true, force: true })
+      return err(`解压失败：${e.message}`)
+    }
+
+    // 兼容压缩包里多套一层目录
+    let base = tmp
+    const top = await readdir(tmp, { withFileTypes: true })
+    if (top.length === 1 && top[0].isDirectory()) base = join(tmp, top[0].name)
+
+    const missing = []
+    for (const f of REQUIRED) {
+      try {
+        await stat(join(base, f))
+      } catch {
+        missing.push(f)
+      }
+    }
+    if (missing.length) {
+      await rm(tmp, { recursive: true, force: true })
+      return err(`剧本包缺少文件：${missing.join('、')}\n需要的文件：${REQUIRED.join('、')}`)
+    }
+
+    let meta
+    try {
+      meta = parseManifest(await readFile(join(base, 'manifest.yaml'), 'utf8'))
+    } catch {
+      meta = {}
+    }
+    const slug = (meta.id ?? meta.name ?? 'scenario').replace(/[^\w\u4e00-\u9fa5-]/g, '-')
+
+    const dest = join(root, slug)
+    await rm(dest, { recursive: true, force: true })
+    await run('mv', [base, dest])
+    await rm(tmp, { recursive: true, force: true })
+
+    return ok(`已导入：${slug}${meta.title ? `（${meta.title}）` : ''}\n用 /trpg play ${slug} 开局。`)
+  }
+
+  async function cmdRemove(rawName) {
+    const nm = rawName.trim()
+    if (!nm) return err('用法：/trpg remove <名称>')
+    const dest = join(root, nm)
+    if (!dest.startsWith(root)) return err('名称不合法')
+    try {
+      await stat(dest)
+    } catch {
+      return err(`没有这个剧本：${nm}`)
+    }
+    await rm(dest, { recursive: true, force: true })
+    return ok(`已删除：${nm}`)
+  }
+
+  function nextSessionId(kind) {
+    const rand = Math.random().toString(36).slice(2, 8)
+    return `trpg-${kind}-${Date.now().toString(36)}-${rand}`
+  }
+
+  async function cmdPlay(rawName) {
+    const nm = rawName.trim()
+    if (!nm) return err('用法：/trpg play <名称>')
+    const dir = join(root, nm)
+    let sc
+    try {
+      sc = await loadScenario(dir)
+    } catch {
+      return err(`剧本 ${nm} 不存在或缺少文件，先 /trpg list 看看。`)
+    }
+
+    const handle = await ctx.agents.create({
+      sessionId: nextSessionId('play'),
+      agentOptions: { provider: config.provider, model: config.model },
+      setup(agentCtx) {
+        agentCtx.systemPrompt.section({
+          name: 'trpg/rules',
+          order: 100,
+          text: sc.system,
+        })
+        agentCtx.systemPrompt.section({
+          name: 'trpg/world',
+          order: 110,
+          text: sc.setting,
+        })
+        agentCtx.systemPrompt.section({
+          name: 'trpg/opening',
+          order: 120,
+          text: `【开场场景】\n${sc.opening}`,
+        })
+      },
+    })
+
+    return ok(
+      `已开启剧本「${sc.meta.title ?? nm}」。\n\n开场：\n${sc.opening}\n\n直接说你的第一句话即可开始。`,
+    )
+  }
+
+  async function cmdJudge(rawName) {
+    const nm = rawName.trim()
+    if (!nm) return err('用法：/trpg judge <名称>')
+    let sc
+    try {
+      sc = await loadScenario(join(root, nm))
+    } catch {
+      return err(`剧本 ${nm} 不存在或缺少文件。`)
+    }
+
+    await ctx.agents.create({
+      sessionId: nextSessionId('judge'),
+      agentOptions: { provider: config.provider, model: config.model },
+      setup(agentCtx) {
+        agentCtx.systemPrompt.section({ name: 'trpg/judge', order: 100, text: sc.judge })
+        agentCtx.systemPrompt.section({ name: 'trpg/rubric', order: 110, text: sc.rubric })
+        agentCtx.systemPrompt.section({ name: 'trpg/world', order: 120, text: sc.setting })
+      },
+    })
+
+    return ok(`已开启评分会话（${sc.meta.title ?? nm}）。\n把各组导出的 Session 日志拖进来，或告诉我存档路径。`)
+  }
+
+  const register = ctx.effect ?? ((fn) => fn())
+  register(() => ctx.commands.register({
+    name: 'trpg',
+    description: 'AI 跑团：列出剧本、导入剧本包、开局、评分',
+    input: { hint: 'list | import <zip> | remove <名称> | play <名称> | judge <名称>' },
+    async handler({ rawInput }) {
+      const line = String(rawInput ?? '').trim()
+      const [sub, ...rest] = line.split(/\s+/)
+      const arg = rest.join(' ')
+      switch ((sub || 'list').toLowerCase()) {
+        case 'list':
+          return cmdList()
+        case 'import':
+          return cmdImport(arg)
+        case 'remove':
+        case 'rm':
+          return cmdRemove(arg)
+        case 'play':
+          return cmdPlay(arg)
+        case 'judge':
+          return cmdJudge(arg)
+        default:
+          return err('未知子命令。用 /trpg list|import|remove|play|judge')
+      }
+    },
+  }))
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "AI Tabletop Scenario",
+    "description": "Load scenario packs, start a play session, and open a judging session."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "AI 跑团剧本",
+    "description": "导入剧本包、开局游玩、开启评分会话"
+  }
+}

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "dsh-trpg-scenario",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "AI 跑团剧本加载器：导入剧本包、开局、评分",
+  "type": "module",
+  "exports": {
+    ".": "./index.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "license": "MIT"
 }