dsh-pisces 0.2.6 → 0.2.7

package/CHANGELOG.md

@@ -1,7 +1,22 @@
-# 更新记录
+# 更新记录
 
 本项目遵循语义化版本；`0.x` 期间小版本可能带行为变化。
 
+## 0.2.7
+
+- 补完 B 站登录：设置页的「扫码登录（下一步接）」换成真的登录卡。
+  - **手机扫码**（默认）：宿主现画二维码（`lib/qr.js`，零依赖），轮询到「扫到了」→「确认登录」，
+    先写清「登的是 谁（uid）」，人点「就是这个号，保存」才落盘。码 3 分钟过期，可换一张。
+  - **粘贴 cookie**（退路）：`SESSDATA` / `bili_jct`，后端用 `nav` 接口验一次再落盘 `owner.json`
+    （0600 原子写，失败一个字节都不写）。
+  - 扫码登录移植自 dsh-fish（MIT，@Bacon-01 贡献）：`lib/qr.js` 原样、`lib/biliqr.js` 按本项目改写，
+    来源与许可写进 `THIRD-PARTY-NOTICES.md`。cookie 原文只活在宿主内存里，页面与日志都拿不到。
+- 新增 `/bili` 接口：`GET` 只回「有没有登录 / 名字」，`POST {cookie}` 验证并保存，`DELETE` 清掉；
+  扫码四个动作在 `/bili/qr`、`/bili/qr/save`、`/bili/qr/drop`。
+- 去掉 settings 里只读的 `bili.qrLogin` 占位项（它永远不会变成 logged-in，登录态现在由 `owner.json` 决定）。
+- 面板：B 站与百度贴吧共用同一张登录卡（`CookieCard`）；扫码只给 B 站，贴吧不做扫码。
+- 覆盖登录态前先把旧的留成 `owner.json.bak`：点错、扫错号还能翻回来（留备份失败不拦写盘）。
+
 ## 0.2.6
 
 - 好感封顶：`utterance` 累计 ≤15、`heard` ≤20、`diary` ≤10。之前把旧数据一次灌进来会直接顶到 100（5 天就「离不开」），现在 705 条、4 天算下来是 47（亲近）。

package/README.md

@@ -1,4 +1,4 @@
-# 鱼肥生双（dsh-pisces）
+# 鱼肥生双（dsh-pisces）
 
 一只会长大的本地小鱼，DSH 插件。事件流记忆、渐进揭开、好感、新手引导；派希丝是养成目标。
 
@@ -22,6 +22,15 @@ dsh plugin add dsh-pisces
 - 工具面：普通鱼 7 个动作；成年鱼 12 个（额外自查 / 教人 / 引导 / 体检 / 昵称）。
 - 领养之后需要重启一次，工具面才会多出成年鱼的动作。
 
+## 登录（可选）
+
+- **设置 → 鱼肥生双 → 设置**里，B 站和百度贴吧各有一张卡。
+- B 站：点「用手机扫码登录」，手机 B 站扫一下、在手机上点「确认登录」，卡片上会先写清「登的是谁」，
+  再点「就是这个号，保存」才写盘。不想扫码的话，另一格「粘贴 cookie」贴 `SESSDATA` / `bili_jct` 也行。
+- 贴吧：把 `BDUSS` / `STOKEN` 贴进去，验过才存。
+- 只存在本机（B 站 `owner.json`、贴吧 `baidu.json`，0600）；面板、接口、日志都不回显 cookie，验证不过一个字节都不写。
+- 不需要登录也能用：看热门是公开接口；说话、贴吧相关动作要登录。
+
 ## 观测台（可选）
 
 - 地址：`http://127.0.0.1:<端口>/dsh-pisces-api/`（端口就是 DSH 自己的端口）。
@@ -33,12 +42,12 @@ dsh plugin add dsh-pisces
 
 - 所有数据都在本机：事件流（SQLite 或 JSONL）、日记、人设卡、问题、梦、学到的东西。
 - 插件不上传、不收集统计，也没有遥测。
-- 只有你主动触发的联网动作才会出网：B 站公开接口（看热门、说一句）、自学搜索（需要 key）、夜间模型（本地或你自己配的）。
+- 只有你主动触发的联网动作才会出网：B 站公开接口（看热门、说一句）、登录时各验一次（B 站 `nav` / 贴吧 `tbs`）、自学搜索（需要 key）、夜间模型（本地或你自己配的）。
 - 发布版不含开发者钥匙，也没有 `/devkey` 接口；本机路径、Cookie、私聊都不会进发布包。
 
 ## 鸣谢
 
-这些是**思路借鉴**，不是代码依赖；每个项目的代码各自独立，本仓库没有复制它们的实现。完整的来源说明见 [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md)；版本变化见 [CHANGELOG.md](./CHANGELOG.md)。
+这些是**思路借鉴**，不是代码依赖；除 B 站扫码登录（`lib/qr.js` / `lib/biliqr.js` 移植自 dsh-fish）外，每个项目的代码各自独立，本仓库没有复制它们的实现。完整的来源说明见 [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md)；版本变化见 [CHANGELOG.md](./CHANGELOG.md)。
 
 - **dsh-fish** —— 事件流 + 纯函数派生 + 面板形态，本项目的骨架从它长出来。npm：<https://www.npmjs.com/package/@ssamurias/dsh-fish>
 - **dsh-fish-memory** —— 记忆鲜活度与半衰期、中文检索。
@@ -50,5 +59,5 @@ dsh plugin add dsh-pisces
 - **所有养过鱼的人** —— 社区里"把 AI 当室友养"的尝试。
 
 如果你觉得某个想法该被写在这里，发反馈告诉我们（反馈页有加群方式）。
-
-
+
+

package/THIRD-PARTY-NOTICES.md

@@ -5,12 +5,21 @@
 
 ## 代码来源
 
-本仓库**不含上游代码派生**：`lib/` 下全部实现（事件流、派生、分流、双流、人设卡八道闸、夜间流水线、
-渐进揭开、好感推导、新手引导等）均在本项目中新写，插件没有任何运行时依赖。
+`lib/` 下的实现（事件流、派生、分流、双流、人设卡八道闸、夜间流水线、渐进揭开、好感推导、
+新手引导等）均在本项目中新写，插件没有任何运行时依赖。**唯一的例外是 B 站扫码登录**：
+
+- `lib/qr.js`：**原样移植**自 dsh-fish 的 `lib/qr.js`（MIT，Copyright (c) 2026 大肥鱼（dsh-fish）作者）。
+  零依赖二维码编码器，由 @Bacon-01 贡献（dsh-fish PR #17）。
+- `lib/biliqr.js`：**改写移植**自 dsh-fish 的 `lib/biliqr.js`（同一 MIT 许可与版权）。
+  状态机、Set-Cookie 解析与轮询节流沿用原实现；落盘改走本项目的 `readBili`/`writeBili`，
+  认账号改走 `checkBili`，并要求 `bili_jct` 才允许保存。
+- 两个文件顶部都保留了来源说明。dsh-fish 的 MIT 全文见
+  <https://github.com/ssamurias/dsh-fish/blob/main/LICENSE>。
+- 其余部分（`lib/bili.js` 的热门/评论、`lib/baidu.js` 的贴吧登录）为本项目新写。
 
 ## 思想引用
 
-以下项目影响了本项目的设计，但**没有复制它们的代码或文本**，实现均为重新编写：
+以下项目影响了本项目的设计，但除上面写明的扫码登录外，**没有复制它们的代码或文本**，实现均为重新编写：
 
 - **dsh-fish**（@ssamurias/dsh-fish，MIT）—— 事件流 + 纯函数派生 + 设置面板形态。
 - **dsh-fish-memory** —— 记忆鲜活度与半衰期、中文双字组检索。

package/client.js

@@ -533,8 +533,6 @@ window.__ModuleLoader__.load({
           h('p', { className: data ? 'err' : 'empty' }, data ? `设置没读到：${data.settingsError}` : '正在读设置…'))
       }
 
-      const bili = cur.bili || {}
-      const logged = bili.qrLogin === 'logged-in'
       const set = (path, value) => setDraft((d) => ({ ...d, [path]: value }))
 
       async function save() {
@@ -597,27 +595,43 @@ window.__ModuleLoader__.load({
           h('div', { className: 'row' }, h('button', { type: 'button', disabled: busy, onClick: save }, '保存设置')),
           note ? h('p', { className: note === '存好了，重启后生效' ? 'hint' : 'err' }, note) : null,
         ),
-        h(Card, { title: 'B 站', right: '只读' },
-          h('p', { className: 'hint' }, `登录状态：${logged ? '已登录 _小苍兰_' : '未登录'}`),
-          h('div', { className: 'row' }, h('button', { type: 'button', disabled: true }, '扫码登录（下一步接）'))),
+        h(BiliCard, null),
         h(BaiduCard, null),
       )
     }
 
-    // 百度贴吧登录：粘贴 BDUSS/STOKEN → 后端验证 → 状态就地刷新；不做扫码/QQ/微信。
-    function BaiduCard() {
+    // 登录卡（B 站 / 百度贴吧共用）：扫码或粘贴 cookie → 后端验证 → 状态就地刷新。
+    // B 站那张多给一条扫码路：二维码由宿主现画（lib/qr.js），页面只拿 SVG 和「登的是谁」。
+    function CookieCard({ title, api, placeholder, hint, qr }) {
       const [status, setStatus] = useState(null)
       const [text, setText] = useState('')
       const [busy, setBusy] = useState(false)
       const [note, setNote] = useState('')
+      const [q, setQ] = useState(null)
 
       useEffect(() => {
         let alive = true
-        getJson('/baidu')
+        getJson(api)
           .then((d) => { if (alive) setStatus(d) })
           .catch(() => { if (alive) setStatus({ loggedIn: false }) })
         return () => { alive = false }
-      }, [])
+      }, [api])
+
+      const key = q && q.key ? String(q.key) : ''
+      const state = q && q.state ? String(q.state) : ''
+      const polling = Boolean(key) && (state === 'waiting' || state === 'scanned')
+
+      // 轮询只在这一张码还活着的时候跑；状态变了（confirmed/expired）就停。
+      useEffect(() => {
+        if (!polling) return undefined
+        let alive = true
+        const timer = setInterval(() => {
+          getJson(`${api}/qr?key=${encodeURIComponent(key)}`)
+            .then((r) => { if (alive) setQ((prev) => (prev && prev.key === key ? { ...prev, ...r } : prev)) })
+            .catch(() => {})
+        }, 1200)
+        return () => { alive = false; clearInterval(timer) }
+      }, [api, key, polling])
 
       const logged = !!(status && status.loggedIn)
       const name = status && status.name ? String(status.name) : ''
@@ -627,7 +641,7 @@ window.__ModuleLoader__.load({
         setBusy(true)
         setNote('')
         try {
-          const r = await postJson('/baidu', { cookie: text })
+          const r = await postJson(api, { cookie: text })
           setStatus(r)
           setText('')
           setNote(r.name ? `登上了：${r.name}` : '登上了')
@@ -638,22 +652,104 @@ window.__ModuleLoader__.load({
         }
       }
 
+      async function startQr() {
+        if (busy) return
+        setBusy(true)
+        setNote('')
+        try {
+          setQ({ ...(await postJson(`${api}/qr`, {})), state: 'waiting' })
+        } catch (e) {
+          setNote(String((e && e.message) || e))
+        } finally {
+          setBusy(false)
+        }
+      }
+
+      async function saveQr() {
+        if (busy || !key) return
+        setBusy(true)
+        try {
+          const r = await postJson(`${api}/qr/save`, { key })
+          setStatus(r)
+          setQ(null)
+          setNote(r.name ? `登上了：${r.name}` : '登上了')
+        } catch (e) {
+          setNote(String((e && e.message) || e))
+        } finally {
+          setBusy(false)
+        }
+      }
+
+      function dropQr() {
+        const k = key
+        setQ(null)
+        if (k) postJson(`${api}/qr/drop`, { key: k }).catch(() => {})
+      }
+
+      const qrLine = !q
+        ? ''
+        : state === 'confirmed'
+          ? (q.account && q.account.name
+            ? `登的是 ${q.account.name}${q.account.mid ? `（uid ${q.account.mid}）` : ''}`
+            : '扫码成功，认不出是哪个号')
+          : state === 'scanned'
+            ? '扫到了，在手机上点一下「确认登录」'
+            : state === 'expired'
+              ? '二维码过期了，点「换一张」'
+              : (q.why || '用手机 B 站扫一下')
+
       return h(
         Card,
-        { title: '百度贴吧', right: 'Cookie' },
+        { title, right: 'Cookie' },
         h('p', { className: 'hint' }, `登录状态：${logged ? (name ? `已登录 ${name}` : '已登录') : '未登录'}`),
+        qr ? h('div', { className: 'row' }, h('button', { type: 'button', disabled: busy, onClick: startQr }, q ? '换一张' : '用手机扫码登录')) : null,
+        q ? h('div', { className: 'qr' },
+          q.svg ? h('img', {
+            className: 'qrimg',
+            src: `data:image/svg+xml;charset=utf-8,${encodeURIComponent(String(q.svg))}`,
+            alt: '登录二维码',
+            width: 180,
+            height: 180,
+          }) : null,
+          h('p', { className: 'hint' }, qrLine),
+          h('div', { className: 'row' },
+            state === 'confirmed' ? h('button', { type: 'button', disabled: busy, onClick: saveQr }, '就是这个号，保存') : null,
+            h('button', { type: 'button', onClick: dropQr }, '收起'),
+          ),
+        ) : null,
         h('textarea', {
           value: text,
           rows: 3,
-          placeholder: '把浏览器的 BDUSS=…; STOKEN=… 贴进来',
+          placeholder,
           onChange: (e) => setText(e.target.value),
         }),
         h('div', { className: 'row' }, h('button', { type: 'button', disabled: busy, onClick: save }, '保存并验证')),
         note ? h('p', { className: note.startsWith('登上了') ? 'hint' : 'err' }, note) : null,
-        h('p', { className: 'hint' }, '浏览器 F12 → Application → Cookies → tieba.baidu.com → 复制 BDUSS 和 STOKEN'),
+        h('p', { className: 'hint' }, hint),
       )
     }
 
+    // B 站登录：手机扫码为主，粘贴 SESSDATA/bili_jct 是退路；登录态落 owner.json。
+    function BiliCard() {
+      return h(CookieCard, {
+        title: 'B 站',
+        api: '/bili',
+        qr: true,
+        placeholder: '把浏览器的 SESSDATA=…; bili_jct=… 贴进来',
+        hint: '不想扫码：浏览器 F12 → Application → Cookies → bilibili.com → 复制 SESSDATA 和 bili_jct',
+      })
+    }
+
+    // 百度贴吧登录：粘贴 BDUSS/STOKEN；只影响贴吧，不碰 B 站。
+    function BaiduCard() {
+      return h(CookieCard, {
+        title: '百度贴吧',
+        api: '/baidu',
+        placeholder: '把浏览器的 BDUSS=…; STOKEN=… 贴进来',
+        hint: '浏览器 F12 → Application → Cookies → tieba.baidu.com → 复制 BDUSS 和 STOKEN',
+      })
+    }
+
     // -------------------------------------------------------------------------
     // 页签：心理活动
     // -------------------------------------------------------------------------

package/index.js

@@ -52,7 +52,8 @@ import { nicknameOf, setNickname as writeNickname } from './lib/nickname.js'
 import { clearFixedOverride, readFixedOverride, writeFixedOverride } from './lib/personafile.js'
 import { ensureHomeWithRetry, HOME_FILE } from './lib/home.js'
 import { SCHEMA as SETTINGS_SCHEMA, mergeConfig, publicSettings, readSettings, writeSettings } from './lib/settings.js'
-import { hot } from './lib/bili.js'
+import { clearBili, hot, loginBili, readBili } from './lib/bili.js'
+import { createQrLogin } from './lib/biliqr.js'
 import { clearBaidu, loginBaidu, readBaidu } from './lib/baidu.js'
 import { speak as speakOnBili } from './lib/speak.js'
 import { guideFor as teachFor } from './lib/teach.js'
@@ -235,6 +236,9 @@ export function apply(ctx, config = {}) {
   if (voiceAdapter?.ok) log(`语音回复：已接 ${voiceAdapter.kind}`)
   else log('语音回复：未接适配器（休眠）')
 
+  // B 站扫码登录：key 与 cookie 只活在内存里，停用时清掉（不落盘、不进日志）。
+  const qrLogin = createQrLogin({ log })
+
   let closed = false
   let disposed = false
   let store = null
@@ -659,7 +663,7 @@ export function apply(ctx, config = {}) {
    * 失败只回 {ok:false, reason}、只 log 一行，不阻塞启动（宿主没有 workspaceRegistry 也照跑）。
    */
   async function ensureHomeOnce() {
-    if (cfg.home?.enabled === false) return { ok: false, reason: '家没开（config.home.enabled=false）' }
+    if (cfg.home?.enabled === false || cfg.home?.auto === false) return { ok: false, reason: '家没开（config.home.enabled=false 或 home.auto=false）' }
     let fish = null
     try {
       const s = await live()
@@ -1144,6 +1148,42 @@ export function apply(ctx, config = {}) {
     return { ok: true, removed: clearBaidu(root) }
   }
 
+  /** B 站登录状态：只读本地 owner.json（保存时已经验过一次，不每次开面板都联网）。 */
+  async function biliStatus() {
+    const saved = readBili(root)
+    if (!saved) return { ok: true, loggedIn: false, name: null, hasCookie: false }
+    return { ok: true, loggedIn: true, name: saved.name || null, hasCookie: true }
+  }
+
+  /** B 站登录：粘贴 SESSDATA/bili_jct → 验证 → 落盘；失败原因由 lib/bili.js 给，不打印 cookie。 */
+  function biliLogin(text) {
+    return loginBili({ root, text, log })
+  }
+
+  function biliLogout() {
+    return { ok: true, removed: clearBili(root) }
+  }
+
+  /**
+   * B 站扫码登录：生成码 → 轮询 → （人点保存）才落盘。
+   * 四个动作都在 lib/biliqr.js 的状态机里；这里只把 root 和库边界接上。
+   */
+  function biliQrStart() {
+    return qrLogin.start()
+  }
+
+  function biliQrPoll(key) {
+    return qrLogin.poll(key)
+  }
+
+  async function biliQrSave(key) {
+    return qrLogin.save(key, root)
+  }
+
+  function biliQrDrop(key) {
+    return qrLogin.drop(key)
+  }
+
   /**
    * 语音回复状态：只回有没有适配器、是哪种。
    * available 同时受隐藏开关约束；没有适配器时恒为 false（宿主现在就是这样）。
@@ -1177,6 +1217,13 @@ export function apply(ctx, config = {}) {
     baiduStatus,
     baiduLogin,
     baiduLogout,
+    biliStatus,
+    biliLogin,
+    biliLogout,
+    biliQrStart,
+    biliQrPoll,
+    biliQrSave,
+    biliQrDrop,
     // 语音回复：状态 + 条件触发。不进面板；未来桥只调 voiceReply。
     voice: voiceInfo,
     voiceReply,
@@ -1422,8 +1469,18 @@ export function apply(ctx, config = {}) {
   //      读不到 home.json 就跳过这条判据，不影响启动。
   // 两条都不满足 → 不挂。
   if (cfg.attachToAgents !== false) {
-    const herHome = join(root, 'home')
     const homeFile = join(root, HOME_FILE)
+    /** 家目录：home.json 的 workspacePath 优先（搬家后 living 就是她家）；没有就退回 <root>/home。 */
+    const readHomeWorkspace = () => {
+      try {
+        const raw = readFileSync(homeFile, 'utf8').replace(/^\uFEFF/, '')
+        const j = JSON.parse(raw)
+        return String(j?.workspacePath ?? j?.cwd ?? '')
+      } catch {
+        return ''
+      }
+    }
+    const herHome = readHomeWorkspace() || join(root, 'home')
     /** 每次现读：home.json 可能在插件启动之后才由 ensureHome 写出来。 */
     const readHomeSessionId = () => {
       try {
@@ -1494,7 +1551,16 @@ export function apply(ctx, config = {}) {
         // 聊天落库的门控：llm/stream 是全局 waterfall，别的会话的生成也会经过观察器。
         // 只有她家里那条会话（home.json 的 sessionId）才记 heard/utterance；每次现读，
         // 读不到 home.json → false。shouldAttach 只管挂人设段，不决定记不记事件。
-        isHerSession: (sid) => Boolean(sid) && sid === readHomeSessionId(),
+        isHerSession: (sid, key) => {
+          if (sid && sid === readHomeSessionId()) return true
+          // 宿主没给 sessionId 时 attach 会退回 cwd 当会话 key：家目录（living）下的会话也算她屋里。
+          if (key && String(key).startsWith('cwd:')) {
+            const cwd = flatPath(String(key).slice(4))
+            const home = flatPath(herHome)
+            if (cwd && home && (cwd === home || cwd.startsWith(`${home}/`))) return true
+          }
+          return false
+        },
         config: cfg,
         log,
       })
@@ -1561,6 +1627,15 @@ export function apply(ctx, config = {}) {
       baiduStatus: () => service.baiduStatus(),
       baiduLogin: (text) => service.baiduLogin(text),
       baiduLogout: () => service.baiduLogout(),
+      // B 站登录：GET /bili 只回状态（绝不回 cookie），POST 粘贴验证，DELETE 清掉。
+      biliStatus: () => service.biliStatus(),
+      biliLogin: (text) => service.biliLogin(text),
+      biliLogout: () => service.biliLogout(),
+      // 扫码登录：POST /bili/qr 生成，GET ?key= 轮询，POST /bili/qr/save 保存，drop 取消。
+      biliQrStart: () => service.biliQrStart(),
+      biliQrPoll: (key) => service.biliQrPoll(key),
+      biliQrSave: (key) => service.biliQrSave(key),
+      biliQrDrop: (key) => service.biliQrDrop(key),
       readStore: () => ensureLive(),
       seed: service.seed,
       writeSeed: service.writeSeed,
@@ -1689,7 +1764,7 @@ export function apply(ctx, config = {}) {
   // 11. 家：已经领养/写过起点的话，在宿主侧栏里建一个工作区 + 一条会话（幂等）。
   // 只在事件流里有 demo 或 seed 时才建；config.home.enabled === false 时整块跳过。
   // 失败只 log 一行，不阻塞启动——宿主没有这些服务时插件照样跑。
-  if (cfg.home?.enabled !== false) {
+  if (cfg.home?.enabled !== false && cfg.home?.auto !== false) {
     ready.then((s) => {
       if (!s) return
       try {
@@ -1725,6 +1800,12 @@ export function apply(ctx, config = {}) {
     const first = !disposed
     disposed = true
     closed = true
+    // 内存里可能还攥着扫码登录的 cookie：停用就清掉，不靠进程退出兜底。
+    try {
+      qrLogin.clear()
+    } catch {
+      /* 清不掉就算了 */
+    }
     if (first) {
       log(`已停用（apply#${n}）`)
     }

package/lib/attach.js

@@ -812,7 +812,7 @@ export function attachToAgents(ctx, {
     let her = false
     if (typeof isHerSession === 'function') {
       try {
-        her = Boolean(isHerSession(sid))
+        her = Boolean(isHerSession(sid, sessionKeyOf(options)))
       } catch (err) {
         log(`聊天落库：会话判据出错（${errText(err)}），这条跳过`)
         her = false

package/lib/bili.js

@@ -1,19 +1,24 @@
-// B 站：只读热门 + 在视频下说一句。网络与凭据都在这里，纯函数、可注入 fetch。
+// B 站：登录（cookie）+ 只读热门 + 在视频下说一句。网络与凭据都在这里，纯函数、可注入 fetch。
 //
-// 三条口径（README「说话」、知识库 n23）：
+// 四条口径（README「说话」、知识库 n23 / n64）：
 // 1. bvid 不能直接发评论，要先 `/x/web-interface/view?bvid=` 拿 aid；
 // 2. 凭据只从 `<root>/owner.json` 读，SESSDATA 与 bili_jct 缺任一都是"cookie 不完整"；
-// 3. 所有失败都不抛，折成 { ok:false, reason }，reason 只写人话、不打印 cookie。
-import { existsSync, readFileSync } from 'node:fs'
+// 3. 登录只收 SESSDATA + bili_jct 两个键，保存前用 nav 接口验一次；0600 原子写，绝不回显；
+// 4. 所有失败都不抛，折成 { ok:false, reason }，reason 只写人话、不打印 cookie。
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs'
 import path from 'node:path'
 
 export const POPULAR_API = 'https://api.bilibili.com/x/web-interface/popular'
 export const VIEW_API = 'https://api.bilibili.com/x/web-interface/view'
 export const REPLY_API = 'https://api.bilibili.com/x/v2/reply/add'
+export const NAV_API = 'https://api.bilibili.com/x/web-interface/nav'
 export const OWNER_FILE = 'owner.json'
+export const OWNER_MODE = 0o600
 
 const BVID_RE = /^BV[0-9A-Za-z]{10}$/
 const SPEAK_MAX = 300
+// 登录只认这两个键：SESSDATA 证明身份，bili_jct 是写操作的 csrf。
+const LOGIN_KEYS = ['SESSDATA', 'bili_jct']
 const UA =
   'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36'
 
@@ -61,6 +66,176 @@ export function readOwner(root) {
   }
 }
 
+/**
+ * 从浏览器复制的整段 cookie 里只挑 SESSDATA / bili_jct，并拼回规范形状。
+ * 缺哪个就说清缺哪个；换行/分号分隔都认。
+ */
+export function parseBiliCookie(text) {
+  const raw = typeof text === 'string' ? text : String(text ?? '')
+  const values = new Map()
+  for (const piece of raw.split(/[;\r\n]+/)) {
+    const part = piece.trim()
+    const eq = part.indexOf('=')
+    if (eq <= 0) continue
+    const key = part.slice(0, eq).trim()
+    const value = part.slice(eq + 1).trim()
+    if (!LOGIN_KEYS.includes(key) || !value) continue
+    values.set(key, value)
+  }
+  const missing = LOGIN_KEYS.filter((key) => !values.has(key))
+  if (missing.length) return { ok: false, reason: `cookie 不完整：缺 ${missing.join('、')}` }
+  return {
+    ok: true,
+    cookie: `SESSDATA=${values.get('SESSDATA')}; bili_jct=${values.get('bili_jct')}`,
+    missing: [],
+  }
+}
+
+/**
+ * 读登录态（登录卡片用）：文件不在 / 坏 JSON / 缺键一律 null（调用方翻成人话）。
+ * 比 readOwner 多认可选的名字与 uid；cookie 本身不回显、不打印。
+ */
+export function readBili(root) {
+  if (!root) return null
+  try {
+    const file = path.join(String(root), OWNER_FILE)
+    const raw = readFileSync(file, 'utf8').replace(/^\uFEFF/, '')
+    const j = JSON.parse(raw)
+    if (!j || typeof j !== 'object' || Array.isArray(j)) return null
+    const parsed = parseBiliCookie(typeof j.cookie === 'string' ? j.cookie : '')
+    if (!parsed.ok) return null
+    const at = Number(j.at)
+    const out = { cookie: parsed.cookie, at: Number.isFinite(at) && at > 0 ? at : 0 }
+    const name = typeof j.name === 'string' ? j.name.trim() : ''
+    if (name) out.name = name
+    const mid = Number(j.mid)
+    if (Number.isFinite(mid) && mid > 0) out.mid = Math.trunc(mid)
+    return out
+  } catch {
+    return null
+  }
+}
+
+/** 原子写：tmp → rename，tmp 用 0600 建；失败清掉 tmp 再抛。 */
+export function writeBili(root, { cookie, name, mid } = {}) {
+  const parsed = parseBiliCookie(cookie)
+  if (!parsed.ok) throw new Error(parsed.reason)
+  if (!root) throw new Error('没有地方存')
+
+  const file = path.join(String(root), OWNER_FILE)
+  const cleanName = typeof name === 'string' ? name.trim().slice(0, 64) : ''
+  const id = Number(mid)
+  const record = {
+    cookie: parsed.cookie,
+    name: cleanName,
+    ...(Number.isFinite(id) && id > 0 ? { mid: Math.trunc(id) } : {}),
+    at: Date.now(),
+  }
+  const text = `${JSON.stringify(record, null, 2)}\n`
+  mkdirSync(path.dirname(file), { recursive: true })
+  // 覆盖之前先把旧文件留成 .bak：里面是上一份登录态，点错一次只能重新扫码。
+  // 备份失败不拦写盘（宁可写成功，也不能因为留副本失败就登不上）。
+  try {
+    if (existsSync(file)) copyFileSync(file, `${file}.bak`)
+  } catch {
+    /* 留不下备份就算了 */
+  }
+  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`
+  try {
+    writeFileSync(tmp, text, { encoding: 'utf8', mode: OWNER_MODE })
+    try {
+      chmodSync(tmp, OWNER_MODE)
+    } catch {
+      /* Windows 不保留 POSIX 位，尽力而为 */
+    }
+    renameSync(tmp, file)
+  } catch (e) {
+    try {
+      unlinkSync(tmp)
+    } catch {
+      /* 没有 tmp 可清就算了 */
+    }
+    throw e
+  }
+  return record
+}
+
+/** 清掉登录文件；返回是否真的删掉了。 */
+export function clearBili(root) {
+  if (!root) return false
+  try {
+    unlinkSync(path.join(String(root), OWNER_FILE))
+    return true
+  } catch {
+    return false
+  }
+}
+
+/** nav 接口的错误码 → 人话。 */
+function navReason(code) {
+  if (code === -101) return '没登录'
+  if (code === -412 || code === -352 || code === -403) return '被风控了'
+  return `B 站回了个看不懂的（code ${code}）`
+}
+
+/**
+ * 用 nav 接口验一次：`data.isLogin === true` 才算登录，顺手取 uname / mid。
+ * 失败只回「没登录 / cookie 不完整 / 被风控了 / 连不上 B 站」，不打印 cookie。
+ * @returns {Promise<{ok:true, name:string, mid:number}|{ok:false, reason:string}>}
+ */
+export async function checkBili({ cookie, fetchImpl = globalThis.fetch } = {}) {
+  const parsed = parseBiliCookie(cookie)
+  if (!parsed.ok) return { ok: false, reason: 'cookie 不完整' }
+
+  const f = typeof fetchImpl === 'function' ? fetchImpl : globalThis.fetch
+  if (typeof f !== 'function') return { ok: false, reason: '连不上 B 站' }
+
+  let nav
+  try {
+    const res = await f(NAV_API, {
+      headers: {
+        'user-agent': UA,
+        cookie: parsed.cookie,
+        referer: 'https://www.bilibili.com/',
+      },
+    })
+    nav = await readJson(res)
+  } catch {
+    return { ok: false, reason: '连不上 B 站' }
+  }
+  if (!nav || typeof nav !== 'object') return { ok: false, reason: '连不上 B 站' }
+
+  const code = Number(nav.code)
+  if (code !== 0) return { ok: false, reason: navReason(code) }
+  // code 0 也可能是"没登录"：没有有效 SESSDATA 时 web 端回 isLogin:false。
+  if (nav.data?.isLogin !== true) return { ok: false, reason: '没登录' }
+
+  const name = typeof nav.data?.uname === 'string' ? nav.data.uname.trim() : ''
+  const mid = Number(nav.data?.mid)
+  return { ok: true, name, mid: Number.isFinite(mid) && mid > 0 ? Math.trunc(mid) : 0 }
+}
+
+/**
+ * 粘贴 → 解析 → 验证 → 写盘。验证不过一个字节都不写。
+ * @returns {Promise<{ok:true, name:string}|{ok:false, reason:string}>}
+ */
+export async function loginBili({ root, text, fetchImpl = globalThis.fetch, log } = {}) {
+  if (!root) return { ok: false, reason: '没有地方存' }
+  const parsed = parseBiliCookie(text)
+  if (!parsed.ok) return { ok: false, reason: parsed.reason }
+
+  const chk = await checkBili({ cookie: parsed.cookie, fetchImpl })
+  if (!chk.ok) return chk
+
+  try {
+    writeBili(root, { cookie: parsed.cookie, name: chk.name, mid: chk.mid })
+  } catch {
+    return { ok: false, reason: '存不进去' }
+  }
+  safeLog(log, 'B 站登录：已保存（只在本机）')
+  return { ok: true, name: chk.name }
+}
+
 async function readJson(res) {
   try {
     if (!res || typeof res.json !== 'function') return null