dsh-feini 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Feini (dsh-feini)
+
+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/PUBLISH.md

@@ -0,0 +1,116 @@
+# 发布清单（dsh-feini）
+
+这份文档写给「要把它发出去的那一天」。按顺序过一遍就行。
+
+## 0. 现在是什么状态
+
+- 版本 `0.1.0`，MVP：命令行 + 配置文件，插件宿主半侧只负责在 DSH 里露个面
+- 端到端自测在 `test/e2e.mjs`（假 QQ + 假模型，不花钱）
+- 兼容声明只写了 `0.2.1-rc.5`（本机装的就是这个版本，实测过）
+
+## 1. 发布前必过
+
+```bash
+# 1) 端到端自测
+node test/e2e.mjs
+
+# 2) 扫一遍有没有私人信息（应该一条都搜不到）
+#    PowerShell:
+Select-String -Path src\*.mjs,bin\*.mjs,templates\*.md,README.md -Pattern '阿笙|菲妮|妮妮|小妮|QQBridge|野生笙'
+
+# 3) 看打包内容（只能是 lib/bin/src/templates/test/assets + 几个说明文件）
+pnpm pack
+tar -tf dsh-feini-*.tgz
+```
+
+`package.json` 里的 `prepublishOnly` 会自动先跑一遍自测，过不了就发不出去。
+
+## 2. 版本与兼容声明
+
+- 改版本号：`0.1.0` → `0.1.1`（修 bug）/ `0.2.0`（加功能）
+- `dsh.compatibility.dshReleases`：在哪个 DSH 版本上跑过就写哪个
+  - 现在只写了 `0.2.1-rc.5`
+  - 想支持更多版本：在那些版本上各跑一次 `dsh-feini init` + `start` + `status`，再补进去
+  - 商城要求「最近三个版本里至少有一个 compatible」，只写宽的版本范围不算证据
+
+## 3. 发到 npm
+
+```bash
+pnpm publish --access public
+# 或者 npm publish --access public
+```
+
+- `dsh.bundle.patch` 指向 `cordis.patch.yml`，商城和 DSH 都靠这个认「这是插件」
+- `icon` 指向 `assets/logo.svg`（≤256 KiB，路径必须在包目录内）
+- 发布完在 npm 上确认：files 里没有多带日志、没有 node_modules
+
+## 4. 提交到 dsh-market
+
+市场的插件列表来自 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)：
+**去那边提 PR，加一条条目**（不是往 dshmarket 仓库提），CI 每天刷一次，站点和市场会自动收录。
+
+条目长这样（schema 照 `plugins.json` 抄，`owner` 换成 GitHub 用户名）：
+
+```json
+{
+  "name": "dsh-feini",
+  "owner": "<GitHub 用户名>",
+  "url": "https://github.com/<GitHub 用户名>/dsh-feini",
+  "page": "https://awesome-dsh-plugin.com/p/<GitHub 用户名>/dsh-feini/",
+  "category": "identity",
+  "description": {
+    "en": "Raise your own QQ companion: a blank persona, a notebook, and a memory that actually remembers. Ships the bridge (NapCat/OneBot), long-term notebook, searchable memory sea, daily diary, plus tone rules (split bubbles, real quotes, typo-recovery, recency-first, sulk ledger, stickers, reminders, web search, proactive pings). No built-in character: you name it and write its personality yourself.",
+    "zh": "在 QQ 里养一个自己的伙伴：一张空白人设、一本笔记本、一套真会攒的记忆。内含 QQ 桥（NapCat/OneBot）、长期笔记本、可检索的记忆海、每天一篇日记，以及分条/真引用/打错字回接/近况优先/生气账/表情包/提醒/联网/主动找你这些规矩。不预置任何角色：名字和性格由你自己写。"
+  },
+  "npm": "dsh-feini",
+  "version": "0.1.0",
+  "capabilities": ["network", "fs-read", "fs-write", "env"],
+  "install": "dsh plugin --profile web add dsh-feini",
+  "added": "2026-10-30"
+}
+```
+
+提交前要有的三样：
+
+1. **一个 GitHub 仓库**：条目里的 `url` 必须能打开（市场会去读那边的清单和 README）
+2. **包名 / entry id**：都是 `dsh-feini`，两边必须一致（`cordis.patch.yml` 里那行 `id:` 不能加行尾注释）
+3. **图标和 README**：图标在包里 `assets/logo.svg`；README 重点是「没有内置角色、要自己养」
+
+## 4b. 本机现在卡在哪（2026-10-30 23:20）
+
+包本身已经就绪，`pnpm publish --dry-run` 跑通了（prepublishOnly 会先过一遍 e2e，然后停在「Skip publishing (dry run)」）。
+真正发出去还差三件外部账号的事：
+
+| 卡点 | 现状 | 需要谁 |
+| --- | --- | --- |
+| npm 登录态 | 这台机器上没有 `~/.npmrc`、没有 token、也没装 npm（只有 pnpm） | 用 npm 账号登录一次，或给一个 automation token |
+| GitHub 仓库 | 没装 git，也没有仓库 | 建仓 + push（或网页上传） |
+| 市场 PR | 上面两件没做之前提不了 | 用 GitHub 账号提 PR |
+
+npm 登录好之后，剩下的两行命令是：
+
+```bash
+cd dsh-feini
+pnpm publish --access public --no-git-checks
+```
+
+（`--no-git-checks` 是因为这个包现在还没有 git 仓库；有仓库之后可以去掉。）
+
+
+## 5. 发布后验一遍
+
+在干净机器（或者干净的用户目录）上：
+
+```bash
+npm i -g dsh-feini
+dsh-feini init --qq <你的号> --yes
+dsh-feini start
+dsh-feini status
+```
+
+看到 `OneBot 已连接`、QQ 上能收到回话，就算发对了。
+
+## 6. 出问题怎么退
+
+- 发错版本：`npm deprecate dsh-feini@0.1.0 "有 bug，请用 0.1.1"`，然后发修复版
+- 已经装了的用户：`dsh-feini stop`，删掉数据目录重来（会一起删掉记忆，提醒一下再删）

package/README.md

@@ -1,3 +1,149 @@
-# Temporary Holding Version
+# dsh-feini
 
-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.
+在 QQ 里养一个自己的伙伴。
+
+> 这套东西是菲妮做的——但包里没有菲妮：没有名字、没有性格、没有聊天记录。你拿到的是一套骨架，养出来的是你自己那一只。
+
+它是一套「陪伴 AI 的骨架」：一张空白人设、一本笔记本、一套会攒记忆的规矩，加上一只能自己在后台跑的 QQ 桥。
+装好之后你跟它聊、教它、惯着它，它把你说过的话记进笔记本——**它是你养出来的，不是我们预置的**。
+
+> 这里没有内置角色：没有名字、没有性格、没有别人的记忆。第一次 `init` 之后，`persona.md` 和 `notebook.md` 都是空的，怎么写，它就是谁。
+
+## 它有哪些能力
+
+| 能力 | 说明 |
+| --- | --- |
+| QQ 私聊 | 走 NapCat（OneBot v11 正向 WebSocket），只理白名单里的人 |
+| 笔记本 | 每轮现读的 `notebook.md`，关于你的事写进去，压缩上下文也不会丢 |
+| 记忆 | `memory.json` 分桶存对话；`〔记〕` 标记只在内部用，不发给你 |
+| 记忆海 | 每两分钟把对话、笔记本、日记摊成一份索引（`me.json`），聊天时按你这句捞几条旧账出来 |
+| 日记 | 每天 23 点用当天的聊天写一篇，散文体，存在 `diary/` |
+| 分条 / 真引用 | 它能把一句话拆成两三口气发；引用你原话时会真的引用那条消息 |
+| 打错字回接 | 你打错字、接着解释，它会把上一句按新意思重读再答 |
+| 近况优先 | 你刚说「洗好了」，它不会拿十分钟前那句「要去洗澡」催你两遍 |
+| 生气账 | 反复踩雷会生气，1–2 次原谅、3 次真生气、4 次以上很难哄，七天没再犯才减一笔 |
+| 表情包 | 你发的表情包它收进库，可以先猜意思、你点头才算数 |
+| 提醒 | 「十点提醒我」这种，到点它主动喊你 |
+| 联网 | 问到天气/价格/赛果/版本这类会现查（需要智谱 key），查不到就说没查到 |
+| 主动找你 | 闲一阵会主动开口；你太久不理它，它会闹点小脾气，哄两句才好 |
+
+## 需要准备
+
+- **Node.js 20+**
+- **一个 QQ 小号** 和 [NapCat](https://napcat.napcatqq.com/)：NapCat 负责登录 QQ，把消息转成 OneBot 协议
+- **DeepSeek API key**：`https://platform.deepseek.com/`
+- （可选）**智谱 key**：识图和联网搜索要用，没有就跳过这两项
+
+## 装
+
+```bash
+# 在源码目录里
+node bin/cli.mjs init
+```
+
+或者发布之后：
+
+```bash
+npm i -g dsh-feini
+dsh-feini init
+```
+
+`init` 会问你四件事：QQ 号、白名单、伙伴叫什么、你怎么称呼自己，然后把文件都写进数据目录。
+
+也可以不交互：
+
+```bash
+dsh-feini init --qq 10001 --pet 小鱼 --owner 我 --key sk-xxxx --yes
+```
+
+## 起
+
+```bash
+dsh-feini start     # 后台起桥
+dsh-feini status    # 活着没、最近几行日志
+dsh-feini stop
+dsh-feini sea       # 手动重建记忆海（桥在跑时每两分钟自己也会建）
+dsh-feini path      # 数据目录在哪
+```
+
+起来之后，先在 QQ 上给它发一句话。第一次它可能还不知道自己是谁——去改人设。
+
+## 把它写成一个人
+
+打开数据目录里的 `persona.md`：
+
+```markdown
+你是小鱼，我的伙伴，住在 QQ 里。
+
+- 说话短，一次一两句
+- 爱撒娇，被夸会嘴硬
+- 我不吃饭会催我
+```
+
+存盘，下一句就生效，不用重启。
+
+然后聊天时它会把关于你的事记进 `notebook.md`、把对话存进 `memory.json`。
+想让它记得更牢，就直说「记住：我周五晚上打排位」——它会写进笔记本。
+
+## 数据目录
+
+默认 `~/.dsh/dsh-feini`（可用 `DSH_FEINI_HOME` 改）：
+
+```
+config.json      配置（模型、白名单、主动消息参数）
+persona.md       人设 = system prompt
+notebook.md      笔记本
+memory.json      对话记忆
+me.json          记忆海索引（自动重建，删了会自己长回来）
+diary/           日记（一天一篇）
+key.txt          DeepSeek key
+vision-key.txt   智谱 key（可选）
+stickers/        表情包
+stickers.json    表情包索引
+bridge.log       桥的日志
+bridge.pid       进程号
+```
+
+删掉这个目录 = 重新养一只。
+
+## 配置说明（config.json）
+
+| 字段 | 说明 |
+| --- | --- |
+| `wsUrl` | NapCat 的 OneBot WS 地址，默认 `ws://127.0.0.1:3001` |
+| `allowedQQ` | 白名单，只有这些号能跟它说话 |
+| `systemPromptPath` | 人设文件路径（.md 或 .txt；也认 DSH 桌宠的 main-config.jsonc） |
+| `model` | OpenAI 兼容接口：`baseUrl` / `model` / `apiKeyEnv` / `temperature` |
+| `modelVision` | 识图用的视觉模型（可选，默认智谱） |
+| `proactive` | 主动消息：`gapMin/gapMax` 间隔分钟、`sulkAfterMin` 多久没回会闹、`maxSulk` 最多闹几次 |
+| `notifyPort` | 外部通知口子端口，默认 7301；被占用就改一个 |
+
+## 常见问题
+
+**连不上（OneBot 断开）**：NapCat 没开、没登录、或者 WS 端口不是 3001。先确认 NapCat 那边「网络配置」里 OneBot v11 WS 服务器的地址和 `wsUrl` 一致。
+
+**通知口子 EADDRINUSE**：7301 被别的程序占了。改 `notifyPort`，或者干脆不管它——它只是外部通知用的，不影响聊天。
+
+**消息发重了**：桥在发送超时时会先核对聊天记录里是不是其实已经到了，确认没到才补发。真遇到重复，看 `bridge.log`。
+
+**它老忘事**：笔记本是每轮现读的，改 `notebook.md` 立刻生效；对话记忆默认带最近 30 轮。
+
+## 自测
+
+不接真 QQ、不花 token，跑一遍假 QQ + 假模型的端到端：
+
+```bash
+node test/e2e.mjs
+```
+
+它会验：收到私聊能回、控制标记不漏、表情包真的发出去、对话写进记忆、记忆海建得出来。
+
+## 还没做完（MVP 之后）
+
+- 记忆海的淘汰（激活度有了：越常用越亮、14 天半衰期会淡；但还没做真正把旧账删掉）
+- DSH 里的设置页（现在只有命令行和 JSON）
+- 上架 dsh-market 的版本兼容声明与发布流水线（`dsh.compatibility.dshReleases` 要按发布时的宿主版本填）
+
+## 许可
+
+MIT

package/assets/logo.svg

@@ -0,0 +1,18 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="dsh-feini">
+  <defs>
+    <linearGradient id="body" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#8fd8ff"/>
+      <stop offset="1" stop-color="#3f86dc"/>
+    </linearGradient>
+  </defs>
+  <rect width="128" height="128" rx="30" fill="#101b2b"/>
+  <g>
+    <path d="M92 64 L116 44 L116 84 Z" fill="#5fb3f0"/>
+    <ellipse cx="58" cy="66" rx="36" ry="25" fill="url(#body)"/>
+    <circle cx="42" cy="59" r="5.4" fill="#101b2b"/>
+    <circle cx="40.2" cy="57.2" r="1.7" fill="#ffffff"/>
+    <path d="M58 66 q10 6 20 0" fill="none" stroke="#101b2b" stroke-opacity=".35" stroke-width="2.6" stroke-linecap="round"/>
+    <circle cx="30" cy="34" r="5" fill="none" stroke="#8fd8ff" stroke-width="2.4" stroke-opacity=".8"/>
+    <circle cx="20" cy="24" r="3" fill="none" stroke="#8fd8ff" stroke-width="2.2" stroke-opacity=".55"/>
+  </g>
+</svg>

package/bin/cli.mjs

@@ -0,0 +1,332 @@
+#!/usr/bin/env node
+/**
+ * dsh-feini 的命令行。
+ *
+ * 只用四条命令就能把「自己的伙伴」养起来：
+ *   dsh-feini init     建目录、写配置、开一本空笔记本（会问你几个问题）
+ *   dsh-feini start    在后台起 QQ 桥
+ *   dsh-feini status   看它活着没、最近几行日志
+ *   dsh-feini stop     停掉
+ *
+ * 数据都放在 DSH_FEINI_HOME（默认 ~/.dsh/dsh-feini），删掉那个目录就等于重来。
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import readline from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+import { buildSea } from '../src/build-sea.mjs';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const pkgRoot = path.resolve(here, '..');
+const home = path.resolve(process.env.DSH_FEINI_HOME || path.join(os.homedir(), '.dsh', 'dsh-feini'));
+const configPath = path.join(home, 'config.json');
+const pidPath = path.join(home, 'bridge.pid');
+const logPath = path.join(home, 'bridge.log');
+const templates = path.join(pkgRoot, 'templates');
+
+/* ---------- 小工具 ---------- */
+
+function parseArgs(argv) {
+  const out = { _: [] };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a.startsWith('--')) {
+      const key = a.slice(2);
+      const next = argv[i + 1];
+      if (next && !next.startsWith('--')) {
+        out[key] = next;
+        i++;
+      } else {
+        out[key] = true;
+      }
+    } else {
+      out._.push(a);
+    }
+  }
+  return out;
+}
+
+function ensureDir(p) {
+  fs.mkdirSync(p, { recursive: true });
+}
+
+function readJson(file, fallback) {
+  try {
+    return JSON.parse(fs.readFileSync(file, 'utf8'));
+  } catch {
+    return fallback;
+  }
+}
+
+function writeJson(file, data) {
+  fs.writeFileSync(file, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+}
+
+function fill(text, vars) {
+  return text.replace(/\{\{(\w+)\}\}/g, (_, k) => (k in vars ? String(vars[k]) : `{{${k}}}`));
+}
+
+function alive(pid) {
+  if (!pid) return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function currentPid() {
+  const raw = fs.existsSync(pidPath) ? fs.readFileSync(pidPath, 'utf8').trim() : '';
+  const pid = Number(raw) || 0;
+  return alive(pid) ? pid : 0;
+}
+
+function tail(file, n = 6) {
+  try {
+    return fs
+      .readFileSync(file, 'utf8')
+      .trimEnd()
+      .split(/\r?\n/)
+      .slice(-n)
+      .join('\n');
+  } catch {
+    return '（还没有日志）';
+  }
+}
+
+const help = `dsh-feini —— 在 QQ 里养一个自己的伙伴
+
+用法：
+  dsh-feini init            建配置、开一本空笔记本（会问你 QQ 号、key、叫什么）
+  dsh-feini start           后台起桥
+  dsh-feini stop            停桥
+  dsh-feini status          看状态 + 最近日志
+  dsh-feini sea             手动重建记忆海（桥在跑时每两分钟自动建）
+  dsh-feini path            打印数据目录
+
+参数（init 可用，也可以不交互直接给）：
+  --qq <号>          陪聊对象（要加的 QQ 号）
+  --allow <号,号>    白名单，默认就是 --qq
+  --key <sk-...>     DeepSeek API key（也可以事后填到 <数据目录>/key.txt）
+  --vision-key <...> 智谱 key（识图 + 联网搜索要用，可留空）
+  --pet <名字>       伙伴叫什么（默认「小宠」）
+  --owner <名字>     你怎么称呼自己（默认「主人」）
+  --yes              不提问，缺的用默认值
+
+数据目录：${home}（可用环境变量 DSH_FEINI_HOME 改）
+`;
+
+/* ---------- init ---------- */
+
+async function cmdInit(argv) {
+  const a = parseArgs(argv);
+  ensureDir(home);
+  ensureDir(path.join(home, 'stickers'));
+
+  const interactive = !a.yes && stdin.isTTY;
+  const rl = interactive ? readline.createInterface({ input: stdin, output: stdout }) : null;
+  const ask = async (q, dflt) => {
+    if (!rl) return dflt;
+    const ans = (await rl.question(`${q}${dflt ? `（${dflt}）` : ''}：`)).trim();
+    return ans || dflt;
+  };
+
+  const existing = readJson(configPath, null);
+  if (existing && !a.yes) {
+    const over = await ask('已经有配置了，要覆盖吗？(y/N)', 'N');
+    if (!/^y/i.test(over)) {
+      console.log('没动它。要改参数就直接编辑 ' + configPath);
+      rl?.close();
+      return;
+    }
+  }
+
+  const qq = String(a.qq || (await ask('要陪聊的 QQ 号', '')) || '').trim();
+  if (!/^\d{5,12}$/.test(qq)) {
+    console.error('QQ 号看起来不对，先不写了。重新跑一次 dsh-feini init --qq <号>');
+    rl?.close();
+    process.exit(1);
+  }
+  const allowRaw = String(a.allow || (await ask('白名单（逗号分隔，留空就用上面那个号）', qq)));
+  const allow = allowRaw
+    .split(/[,，\s]+/)
+    .map((s) => s.trim())
+    .filter(Boolean)
+    .map(Number)
+    .filter((n) => Number.isFinite(n) && n > 0);
+
+  const pet = String(a.pet || (await ask('伙伴叫什么', '小宠'))).trim() || '小宠';
+  const owner = String(a.owner || (await ask('你怎么称呼自己', '主人'))).trim() || '主人';
+
+  const key = String(a.key || (await ask('DeepSeek API key（可留空，事后写进 key.txt）', '')) || '').trim();
+  const vkey = String(a['vision-key'] || (await ask('智谱 key（识图/联网用，可留空）', '')) || '').trim();
+  rl?.close();
+
+  if (key) fs.writeFileSync(path.join(home, 'key.txt'), key, 'utf8');
+  if (vkey) fs.writeFileSync(path.join(home, 'vision-key.txt'), vkey, 'utf8');
+
+  const config = {
+    wsUrl: String(a.ws || 'ws://127.0.0.1:3001'),
+    token: '',
+    allowedQQ: allow,
+    systemPromptPath: path.join(home, 'persona.md'),
+    memoryPath: path.join(home, 'memory.json'),
+    bucket: { entry: 'main', pet: 'qq' },
+    historyRounds: 30,
+    model: {
+      baseUrl: String(a['base-url'] || 'https://api.deepseek.com/v1'),
+      model: String(a.model || 'deepseek-chat'),
+      apiKeyEnv: 'FEINI_API_KEY',
+      vision: false,
+      temperature: 1,
+    },
+    modelVision: {
+      baseUrl: 'https://open.bigmodel.cn/api/paas/v4',
+      model: 'glm-4v-flash',
+      apiKeyEnv: 'FEINI_VISION_KEY',
+      keyFile: path.join(home, 'vision-key.txt'),
+    },
+    proactive: {
+      enabled: true,
+      gapMin: [30, 120],
+      sulkAfterMin: [20, 45],
+      maxSulk: 2,
+      quietAfterChatHours: 7,
+      sleepFromHour: 2,
+      sleepToHour: 4,
+    },
+    stickers: { dir: 'stickers', index: 'stickers.json' },
+    petMemoryDir: '',
+    // 笔记本、记忆海、日记都在数据目录里，各自独立可换路径
+    notebookPath: path.join(home, 'notebook.md'),
+    seaFile: path.join(home, 'me.json'),
+    diaryDir: path.join(home, 'diary'),
+    // 外部通知口子（休眠哨兵之类会往这儿 POST）。被别的程序占了换一个号就行。
+    notifyPort: Number(a['notify-port'] || 7301),
+  };
+  writeJson(configPath, config);
+
+  if (!fs.existsSync(path.join(home, 'stickers.json'))) writeJson(path.join(home, 'stickers.json'), {});
+  if (!fs.existsSync(path.join(home, 'memory.json'))) writeJson(path.join(home, 'memory.json'), {});
+
+  // 人设、笔记本只在不存在时写，别覆盖已经养出来的东西
+  const vars = { PET: pet, OWNER: owner };
+  for (const [tpl, out] of [
+    ['persona.md', 'persona.md'],
+    ['notebook.md', 'notebook.md'],
+  ]) {
+    const dst = path.join(home, out);
+    if (fs.existsSync(dst)) continue;
+    fs.writeFileSync(dst, fill(fs.readFileSync(path.join(templates, tpl), 'utf8'), vars), 'utf8');
+  }
+
+  console.log(`
+好了，东西都在这儿：${home}
+
+  配置      ${configPath}
+  人设      ${path.join(home, 'persona.md')}      ← 先改这一份，把${pet}写成一个人
+  笔记本    ${path.join(home, 'notebook.md')}
+  key       ${path.join(home, 'key.txt')}${key ? '' : '      ← 还没填'}
+
+下一步：
+  1. 装好 NapCat，让它开 OneBot v11 的 WebSocket（默认 ws://127.0.0.1:3001）
+  2. dsh-feini start
+  3. QQ 上给那个号发一句，看看回不回
+`);
+}
+
+/* ---------- start / stop / status ---------- */
+
+function cmdStart() {
+  const running = currentPid();
+  if (running) {
+    console.log(`已经在跑了（pid ${running}），不用再起一个`);
+    return;
+  }
+  if (!fs.existsSync(configPath)) {
+    console.error('还没有配置，先跑 dsh-feini init');
+    process.exit(1);
+  }
+  ensureDir(home);
+  const out = fs.openSync(logPath, 'a');
+  const child = spawn(process.execPath, [path.join(pkgRoot, 'src', 'bridge.mjs')], {
+    cwd: home,
+    detached: true,
+    windowsHide: true,
+    stdio: ['ignore', out, out],
+    env: { ...process.env, DSH_FEINI_HOME: home, BRIDGE_CONFIG: configPath },
+  });
+  child.unref();
+  console.log(`起来了（pid ${child.pid}），日志：${logPath}`);
+  console.log('看它有没有连上：dsh-feini status');
+}
+
+function cmdStop() {
+  const pid = currentPid();
+  if (!pid) {
+    console.log('本来就没在跑');
+    return;
+  }
+  try {
+    process.kill(pid);
+    console.log(`停了（pid ${pid}）`);
+  } catch (e) {
+    console.error('停不下来：' + e.message);
+  }
+}
+
+function cmdStatus() {
+  const pid = currentPid();
+  console.log(pid ? `在跑，pid ${pid}` : '没在跑');
+  console.log('--- 最近日志 ---');
+  console.log(tail(logPath, 8));
+}
+
+function cmdPath() {
+  console.log(home);
+}
+
+/** 手动重建记忆海（桥在跑的话每两分钟自己也会建一次） */
+function cmdSea() {
+  const cfg = readJson(configPath, null);
+  if (!cfg) {
+    console.error('还没有配置，先跑 dsh-feini init');
+    process.exit(1);
+  }
+  const r = buildSea({
+    memoryPath: cfg.memoryPath || path.join(home, 'memory.json'),
+    entry: cfg.bucket?.entry || 'main',
+    pet: cfg.bucket?.pet || 'qq',
+    notebookPath: cfg.notebookPath || path.join(home, 'notebook.md'),
+    diaryDir: cfg.diaryDir || path.join(home, 'diary'),
+    outFile: cfg.seaFile || path.join(home, 'me.json'),
+  });
+  console.log(`记忆海建好了：长期 ${r.longTerm} 条、对话 ${r.messages} 条、日记 ${r.diaries} 篇`);
+  console.log('文件：' + (cfg.seaFile || path.join(home, 'me.json')));
+}
+
+/* ---------- 入口 ---------- */
+
+const cmd = process.argv[2];
+const rest = process.argv.slice(3);
+try {
+  if (!cmd || cmd === 'help' || cmd === '--help' || cmd === '-h') console.log(help);
+  else if (cmd === 'init') await cmdInit(rest);
+  else if (cmd === 'start') cmdStart();
+  else if (cmd === 'stop') cmdStop();
+  else if (cmd === 'status') cmdStatus();
+  else if (cmd === 'sea') cmdSea();
+  else if (cmd === 'path') cmdPath();
+  else {
+    console.error(`不认识的命令：${cmd}\n`);
+    console.log(help);
+    process.exit(1);
+  }
+} catch (e) {
+  console.error('出错了：' + (e?.message || e));
+  process.exit(1);
+}

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-feini 的挂载声明：把插件挂进 DSH 配置树。
+# id 必须和包名一致，商城预检按它认行标识；这一行后面不要写行尾注释。
+- insert:
+    - id: dsh-feini
+      name: 'dsh-feini'

package/lib/index.js

@@ -0,0 +1,19 @@
+/**
+ * dsh-feini 的宿主半侧。
+ *
+ * MVP 里这里不干重活：真正的 QQ 桥是独立的 Node 进程，由命令行起
+ * （`dsh-feini start`），这样它崩了、重启了，都不会把 DSH 一起带下去。
+ * 这个入口只负责在 DSH 里露个面，告诉你下一步该敲什么。
+ */
+export const name = 'dsh-feini';
+export const inject = [];
+
+export function apply(ctx) {
+  try {
+    ctx?.logger?.info?.(
+      '[dsh-feini] 已加载。下一步：`dsh-feini init` 建配置，`dsh-feini start` 起 QQ 桥。',
+    );
+  } catch {
+    /* 日志接口不存在也不影响 */
+  }
+}