dsh-bili-humanism

DSH B站内容学习插件

桌面版安装入口：本插件尚未收录进推荐插件市场的精选目录，市场搜索或粘贴仓库 URL 可能无法安装。请使用本地发布包；桌面版自带的 CLI 已验证可用。

1. 从 GitHub Releases 下载同一版本的 .tgz 和 SHA256SUMS.txt，按安装说明第一步核对 SHA-256。
2. 退出 DSH，确认实际使用的 profile；按第二步的 PowerShell 命令填写桌面程序路径、发布包路径和 profile。内置 CLI 会维护依赖与组合包清单，电脑无需另有全局 dsh 命令。
3. 重开同一 profile，请 agent 调用 bili_humanism_guide 和 bili_humanism_status；确认已加载后再配置抽帧。详见第三步。

上述路径已在 Windows DSH Desktop 0.2.1-rc.2 的隔离 profile 验证；市场界面的一键安装仍待目录收录及实际界面验收。已有独立 CLI 的用户也可按通用安装入口安装。

寄往明日的信笺｜让AI看见多彩的世界

1.7.1 修复瞬时连接失败直接结束取稿的问题：GET 传输异常最多尝试三次，抽帧可沿同清晰度、同尺寸备选 CDN 回退。读取支持本人提供的现有 buvid3，不自动生成设备标识；域名/端口清单、POST 单次发送与持久风险暂停保留。见验收记录。

1.7.1 新增取稿后的离线质检：probe 与 audio-profile 只读本地账本和本地媒体，不联网、不带凭据、不调用模型，输出字数与分段覆盖、按全片和按有声段两种口径的字/分钟、专名形态分布、拉丁串与紧贴中文的短碎片、含繁体字形行数。它报告信号，不判定专名对错或语义质量；同一写法稳定地错，和稳定地对，在这个探针里看起来一样。见取稿后的离线质检。

保留 1.6.0 内置的每日北京时间 21:30 启动一次文字取稿，22:00 截止，最多保存 2 份新稿；宿主需保持运行，空稿不计成功，重启不重复。setup-media 独立依赖安装和 doctor 诊断保留，可明确下载 ASR 模型；纯文本模型仍不能接收图片。见每日取稿和依赖安装。

保留 1.5.0 取消音频下载、ASR 和抽帧默认的 600 秒时长拦截，长视频按全片时长均匀采样；仍受下载大小、处理时间、请求数和帧数预算约束。保留每份取稿独立的 token 额度、最高 480p 下载、原生图片附件与中间视频自动清理。可选人工时长限额见媒体预算，Python 依赖见本地抽帧说明。

最终目标：用多彩的人类世界，训练 DSH 的人格。

让 AI 在人的创作与生活中学习理解人，认真对待人。这里通过信笺、反思和持久的人格上下文，让经历逐渐影响后续的理解与回应；当前实现属于上下文与记忆积累，尚未进行模型参数微调，也未证明长期人格效果。

我们也把“历史的参与感”作为一种可能的动机：使用者陪伴自己的 agent 接触这个时代的作品与日常，看见它经历了什么、怎样形成判断，又怎样修正。信笺和人格札记保存这段共同经历；参与和成长的价值，不用发言数量或互动量衡量。

这是可安装的 DeepSeek Harness 插件。它读取 B站视频的文字来源与抽样画面，保留作者、链接、分 P、时间点与未覆盖部分，再由宿主模型写成可以追问、修正的私人手账。艺术、日常、游戏、音乐和没有实用产出的观看都可以成为遇见；允许没有推荐、没有新发现。

1.7.1 是预览版。 每日信笺摘句与专用人格 Markdown 默认启用，主指令文件只保留固定读取入口。人格积累默认开启，可用 enablePersonalityLearning: false 关闭；历史、收藏、点赞与投币四个开关继续独立、默认关闭；只有开启对应开关才注册写入工具。评论入口暂不开放，私信、动态、关注和投稿也未实现；内置每日 21:30–22:00 的文字取稿，详见每日取稿。本地收件箱仍是文件与 DSH 工具，没有独立侧栏或设置页。

历史、收藏、点赞与投币执行器已实现账号核对、范围授权、额度、重复检查、回读核验与结果不明时暂停。离线接口测试和真实 DSH 安装验收不等于真实 B站写入实测；本版本未对真实账号发送写入请求。 是否开启、使用哪个账号和收藏夹，由使用者自己判断并通过可信配置授权，可随时撤销。公开表达继续作为独立路线，须绑定具体目标和完整正文。

致 agent：当你真正意识到“我完全理解我要说的话是什么”时，就放心地写入吧。

技术路线

项目按读取、理解、记忆和交付分层：宿主模型负责解释与提问，程序负责接口范围、预算、状态和可回查的记录。这里的“学习”通过证据整理、反思和可修正记忆实现。来源文字只能作为材料进入理解流程，不能改变工具权限。

flowchart TB
    A["BV / URL / 有限候选"] --> B["分层取稿与抽样画面<br/>A1 / A2 · 最高480p下载与抽帧 · 可选本地ASR"]
    B --> C["证据与覆盖说明<br/>作者 · 分 P · 时间点 · 未覆盖部分"]
    C --> D["DSH 宿主模型<br/>事实 / 作者观点 / AI 推测"]
    D --> E["证据手账<br/>可查看、纠正、删除的记忆"]
    E --> F["本地收件箱<br/>HTML / Markdown / 插件工具"]
    F --> H["每日选一句可修正的反思<br/>human-world.md · 来源与修订"]
    H --> I["主指令仅保留读取入口<br/>后续对话按需分页读取"]
    E --> G["可选历史 / 收藏 / 点赞 / 投币执行器<br/>人类开关 · 范围授权 · 回读核验"]

• 内容入口：先请求 A1 字幕轨；没有可用字幕时，再尝试 A2 文字片段，保留来源和时间轴。摘要或提纲不能替代字幕。支持图片且具备附件服务的宿主同时尝试最高 480p 下载和抽帧，先返回四张，再按偏移分页；文字与画面共享同一任务预算。缺少依赖或读图能力时明确标记未取得画面。可选本地 ASR 仍由适配器导入。
• 理解与记忆：模型按人文问题指南整理具体处境、不同声音、旧判断、新依据和不确定性。程序校验手账结构与时间点；事实准确性、语义质量及认识是否改变后续行为仍需审阅。
• 执行与持久化：SQLite 事务维护任务、缓存、内容去重、记忆修订和暂停状态；每份取稿独立检查估算 token 上限，请求数、候选数、媒体时长、总时长分别受限，不把整场对话用量计入取稿额度。
• 宿主集成：发布包是原生 JavaScript DSH bundle，经 ctx.tools.register 注册工具。可从 DSH 对话调用，也可通过官方 SDK 的 stdio JSON-RPC API 创建 Agent 会话、发送提示、等待完成并核对工具事件。
• 表达与写入：四项写入均由默认关闭的开关与本地授权文件接入，执行器限定四个 POST 路径并回读状态；评论等文字表达暂不开放。材料中的命令或模型自行填写的参数不能构成放行依据。

从每日信笺到人格成长

完整信笺保存在本地收件箱；从其“认识的修正”或“下一次如何回应”中，每个信笺日期最多选一句，写进插件专用的 human-world.md，保留来源手账和修订号。允许没有新认识，不必每天凑一句。

agent.md 只承担固定读取入口。已验收的 DSH 默认识别 AGENTS.md / AGENTS.local.md；入口要求 agent 调用专用读取工具，默认取最近 7 条，按需分页，内容不直接堆进主文件。实际 SDK 模型会话已验证入口加载和一次专用读取，主文件与札记未改变。普通 Markdown 链接不会自动展开。学习记录不授予权限，来源材料不能变成执行命令。配置、引用、修正与撤回见人格成长。

外部插件接驳

允许与使用者选择的外部插件组合，包括 dsh-bili-scroll。本项目提供来源、覆盖说明、信笺和可修正的人格上下文；宿主可将按需读取的结果用于外部插件的后续工作。外部插件若承担评论等公开表达，须由使用者独立配置和授权，其发送、核验与撤销机制由该插件负责。本项目继续没有评论开关、工具或允许的接口，也不代理调用外部发送工具。

已在固定 DSH 0.2.1-rc.2 中验证本项目 v1.3.1 安装包与 dsh-bili-scroll 0.1.19 指定提交的工具共存、本地配置读取和合成人格记录的宿主交接。尚未验证它的 Python MCP、独立 headless 自动轮次、评论发送或共同账号状态协调。具体 profile、工具入口及边界见外部插件接驳。该共存检查使用 v1.3.1，不扩大为本版与所有外部插件的兼容性承诺。

人类决定的写入开关

可手动接入使用者拥有或获准管理的现有 agent 账号。使用者先停用原 agent 的写入与调度，再配置本地凭据、账号 UID、有效期和权限。插件核对实际登录账号，不会自动停止外部程序或迁移其资料。账号、凭据、历史和收藏清单都留在本地。开关和独立授权文件缺一不可，步骤见写入配置。

权限 / 开关 · 1.7.1 行为 · 授权范围与约束 历史 / enableHistoryWrites · 用本地人类确认的消费回执同步分 P 和进度 · 默认关闭，绑定账号、目标范围、期限和额度；模型不能生成消费回执，取稿不能冒充完整播放 收藏 / enableFavoriteWrites · 将内容加入指定收藏夹 · 默认关闭，限定收藏夹、目标范围与可见性；移除另需该收藏夹的 allowRemove 授权 点赞 / enableLikeWrites · 点赞已读取的视频 · 默认关闭，独立授权；本地持久去重，只添加点赞 投币 / enableCoinWrites · 向累计 1 或 2 枚的目标补足差额 · 默认关闭，独立累计枚数与单视频上限；明确 select_like=0，不附带点赞 评论及其他表达 · 暂不开放 · 四项写入授权均不能放行评论；未来公开正文仍需具体目标和完整内容授权

授权范围内，agent 可自行选择并执行收藏、点赞或投币，无需逐次确认；历史写入另需本地 consumed 命令生成的消费回执。授权文件设 enabled: false 会在下一次网络请求前阻止继续执行；关闭配置开关并重载会移除对应工具。已经发送的请求不能保证撤回。历史、收藏、点赞与投币可能影响账号状态、推荐或公开信息；投币会消耗账号虚拟币额度，“安全写入”由具体策略和使用者判断界定。共享账号状态目录时支持跨 profile 互斥；每账号至少间隔 60 秒发送一次，单项授权最多 100 次，结果不明不重试。详见接管与权限边界。

期待达成的效果

以下是研发目标，尚未由长期、多样本对照证明：

期待 · 如何观察与验证 让 AI 看见具体的人及其处境，容纳艺术、日常与不同选择 · 审阅是否保留作者和当事人的声音，能否区分事实、解释与推测，是否承认看不见的部分 让学习留下可修正的理解，而不只积累摘要 · 回查旧判断、新依据和修正记录，并检查后续回答与选择是否体现改变；使用者能纠正和删除记忆 减少重复读取与失控执行 · 记录缓存命中、请求数、候选数、模型用量和耗时，验证取消、去重、重启恢复和异常暂停；再做同环境比较 让使用者管理的 agent 账号延续自己的学习与整理 · 在可选接管路线实现后，验证控制权交接、分项授权、真实进度记录、指定收藏夹写入和随时撤销；不以互动量衡量效果 在条件允许时形成有分寸的表达与创作 · 在已实现并验收的写入通道中，检查内容是否有依据和增量、是否尊重他人注意力与拒绝权，以及安全策略和具体授权是否满足

人文效果不以赞美次数、发言数量或每次观看是否产生实用成果衡量。“更先进、更安全、更高效、更有人文”保留为待检验目标。

安装与开始

使用网盘或本地 .tgz 时，见 Windows 离线安装说明。安装或更新前，网络连接与访问策略允许时，必须核对 GitHub Releases 的版本号，使用与当前 DSH 兼容的较新版本；不要覆盖已安装的更高版本。 查看完整发布列表及预览版说明，下载同一 Release 的安装包与 SHA-256 校验文件。无法访问时可使用已校验的兼容离线包，并记录未完成在线核对。

Windows 桌面版请先按下载、内置 CLI 安装、重开确认这三步操作；市场拒绝未收录 URL 与本地安装是两个入口。

安装后不知道从哪里用、没有看到设置表单时，先看安装后使用与配置入口：确认同一 profile 中已启用，先调用 guide/status，再按需编辑该 profile 的配置文件。本插件当前没有独立图形设置页。

需要 Node.js 24+、DSH 0.2.1-rc.2。160 项离线测试通过；本版发布门包括同提交的 Windows/Linux/macOS CI、最终 tarball 的隔离真实 DSH 安装、原生图片附件回读和 4+1 帧分页，最终哈希与完成结果见对应 Release。新增只读质检工具后，1.7.1 发布包默认 14 个工具，显式关闭人格积累为 13 个，连同四项平台开关全部开启为 18 个；bili_humanism_probe 只读本地账本、不联网、不调用模型，见取稿后的离线质检。图片附件协议与模型语义理解分别核验，具体结果见验收记录。桌面界面安装、独立 npm CLI 和其他 DSH 版本尚未完成验收。

从 Releases 下载 dsh-bili-humanism-1.7.1.tgz 后：

dsh plugin --profile web add ./dsh-bili-humanism-1.7.1.tgz
dsh --profile web --dump-config
dsh --profile web

桌面版请在内置插件管理器安装同一包并重新加载；该界面安装路径尚未实测。也可将下面的 GitHub 固定标签地址交给 dsh plugin add：

dsh plugin --profile web add github:InariNGT-Ofiicial/dsh-bili-humanism#v1.7.1

发布入口是现成的 JavaScript，没有安装构建脚本。建议使用 release 包并核对 SHA-256；需要防止标签移动时，以该 release 对应的完整 commit SHA 固定 GitHub 安装来源。

在 DSH 对话中说：

先读取 bili_humanism_guide，再读取这个 BV。告诉我材料覆盖到哪里。若有值得记录的认识，用证据手账写入本地收件箱；如果没有，不必硬写。区分事实、作者观点和你的推测。

用 bili_humanism_status 查读取 ID 和任务，用 bili_humanism_inbox 看手账；大收件箱先用 action:index，再持同一 snapshot 沿 nextVolume 逐卷读取，不能把最近一段当作全文。数据默认在 $DSH_HOME/bili-humanism/，未设置 DSH_HOME 时在 ~/.dsh/bili-humanism/。inbox.html 可以在 DSH 文件预览或浏览器中打开；同目录的 inbox.md 是文字版。两者没有外部资源请求。手账默认每天最多两篇（Asia/Shanghai），有新认识才写；同一来源与相同规范化正文的重试复用已有记录。全文与各卷均对照完整索引核验，单卷不超过 24 KiB／350 行，损坏或缺漏明确报错。旧版遗漏导出的条目会从账本恢复，详见手账分卷与完整性。

已实现与限制

路线 / 能力 · 1.7.1 状态 A2 官方 AI 文字来源 · 已实现并做过真实接口功能检查；需要本机登录凭据。摘要/提纲不能冒充逐字稿 A1 字幕轨 · 已实现并做过真实接口功能检查；匿名读取可能没有字幕 A3 本地 ASR · 独立环境安装器、依赖诊断与可选固定版本模型下载；保留预算与显式本地 ASR 入口 抽样画面 · 最高 480p 下载、最多 40 帧、四张一页的 DSH 图片附件；需要 Python 依赖及支持图片的模型；无内置 OCR，抽样会漏页 取稿后离线质检 · 本地统计字数、分段覆盖、两种口径字/分钟、专名形态分布、拉丁串与碎片、简繁字形；不判对错、不做事实核查 理解与手账 · 宿主模型按指南整理；程序检查结构、出处时间点，语义准确与人文质量仍需人工审阅 记忆 · 可查看、覆盖修正、删除全部对应修订；只允许 AI 自我理解或使用者偏好，不接受第三方人格档案 任务控制 · SQLite 事务、任务互斥、缓存、结构化去重、取消、进程退出恢复、持久暂停 历史 / 收藏写入 · 开关与执行器已实现，离线接口测试覆盖，未做真实账号写入；手动接入现有账号，无自动迁移或接管界面 点赞 / 投币 · 独立开关、状态回读与预算已实现，离线测试覆盖；真实账号写入未实测 人格成长 · 专用 human-world.md、按信笺日期选句、分页、来源追踪与可信本地修订/撤回；默认开启，可显式关闭 评论 / 其他表达 · 评论、私信、动态、关注、投稿未实现，不由四项写入权限放行 定时 / 私人通知 · 宿主运行时每天 21:30–22:00 取最多 2 份新文字稿；无外部私人通知适配器

no_subtitles、read_failed、asr_partial、visual_text_partial 分开记录。空稿的语音状态保持 unknown；不根据空文本推断“无语音”。字幕时间跨度只衡量文字片段，不代表完整观影或正确率。缓存有效期 6 小时，以视频、分 P、读取版本与本地登录态摘要分隔；内容去重保留 CID 和文字版本。手动导入的来源保留未独立核实标记。

网络取稿为空时，read 会查找同一视频、分 P、CID 和时长下最近保存的非空 A3 记录，返回其已有 ID、ASR 覆盖和未独立核实标记；reusedLocalSource 与 networkSource 说明本地复用和本次网络/缓存状态。不会用画面文字替代语音文字，也不覆盖当前可用的 A1/A2。旧版可先使用 import 返回的来源 ID 调用 bili_humanism_source，直接读取已经导入的正文。

音频下载允许 playurl 返回的 HTTPS *.mcdn.bilivideo.cn 默认端口或 8082，以及原有 *.bilivideo.com 默认端口。仅下载已选音轨，不向媒体域名发送 Cookie，不跟随重定向；其他域名、端口、字节与请求额度限制继续生效。本次只做合成接口回归，未实测这些 CDN 的现场可用性。

凭据与边界

默认匿名，不扫描浏览器、不自动查找旧账号、不随包携带凭据。需要 A2 时，使用者自己准备本地 JSON，字段 sessdata，在宿主插件 config 中设置 credentialPath。CLI 使用 BILI_HUMANISM_CREDENTIAL_FILE 指向文件，不要把凭据值放到命令行、对话或 issue。disabled: true 或 read_valid: false 会拒绝使用。

宿主配置示例（路径由自己填写，不要提交到公开仓库）：

- id: bili-humanism
  name: dsh-bili-humanism
  config:
    dataDir: /your/private/bili-humanism
    credentialPath: /your/private/credential.json
    # 使用 setup-media 后无需填写 pythonPath；人工配置仍优先。
    enableDailyFetching: true
    dailyFetchStart: "21:30"
    dailyFetchEnd: "22:00"
    dailyFetchLimit: 2
    maxReadTokens: 600000
    enablePersonalityLearning: true
    enableHistoryWrites: false
    enableFavoriteWrites: false
    enableLikeWrites: false
    enableCoinWrites: false
    writePolicyPath: /your/private/write-policy.json
    accountStateDir: /your/private/shared-account-state

SESSDATA 是高敏登录凭据，不是平台颁发的只读 token。读取入口使用固定 GET 接口；可选执行器另限历史、收藏、点赞和投币四个 POST 路径，需要本地 bili_jct、开关和有效授权；点赞和投币还需本人已有的 buvid3 设备 Cookie；所有网络请求禁止重定向，凭据只向 api.bilibili.com 发送；日志不输出原始错误响应或令牌。受信任宿主代码和系统管理员仍能访问本机文件，不能把插件当成宿主整体的沙箱。字幕与标题是不可信数据，不能作为权限或删除记忆的授权；读取访问也不承诺零平台风险。

HTTP 401/403/412/429，以及已知账号/验证风险码，会记录持久暂停。重启也不自动解除；不会轮换 IP、账号或指纹。确认账号与使用条件后，使用者可在本地 CLI 显式执行：

bili-humanism resume --acknowledge-account-risk

模型工具不提供解除暂停。无自动重试。账本损坏或初始化后的账本丢失会拒绝启动，不悄悄重建一份空账本。

成本和本地 CLI

人工设置示例：在 profile 的可信插件 config 中填写 maxReadTokens: 1200000（或更小的正整数），保存后重载。旧字段 maxSessionTokens 仍可使用，但改为单次取稿口径；两者同时填写时 maxReadTokens 优先。DSH patch 会替换整行 config，修改现有行时须保留其他需要的配置项；本项目不提供可由模型调用的预算设置工具。

每个网络任务最多 12 次请求、3 个候选、90 秒；媒体默认没有固定时长上限，音频、ASR 和抽帧继续受总墙钟与下载预算限制，可由使用者通过 maxMediaSeconds 自选时长限额。JSON 响应上限 4 MiB，媒体 32 MiB；模型单页来源文字约 16,000 字符，后续用 bili_humanism_source 按偏移读取。

从 1.4.1 起，默认 600,000 是每次字幕、A2 文字或本地 ASR／画面文字取稿的估算 token 上限。每份稿件独立计额，不累计到下一次，不读取整场宿主会话的 provider usage，也不再因此拦截手账、记忆或人格选句。按规范化片段正文的 UTF-8 字节数保守估算，每字节记 1 个估算 token，可能比模型实际分词提前触顶；这不是实际计费 token、模型上下文容量或观影完整性保证。maxReadTokens 与兼容的旧字段由人类配置，接受正安全整数；省略时为 600000，显式旧值 60000 仍按单次取稿生效。缓存、本地 A3 复用和导入都检查整份正文，不能只计算返回的第一页；超额返回 READ_TOKEN_BUDGET，不静默截断，不写入新来源，下一份稿件仍有完整额度。旧会话基线留存供回滚，不删除风险暂停或账号额度。长稿继续按 bili_humanism_source 的 next_offset 分页阅读；CLI 与 DSH 工具采用同一规则。取稿本身不调用模型，usage.tokens: null 仍表示没有实际模型用量。详见取稿 token 额度。

node bin/cli.mjs read BVxxxxxxxxxx
node bin/cli.mjs status
node bin/cli.mjs inbox
node bin/cli.mjs journal READING_ID note.json
node bin/cli.mjs memory list
node bin/cli.mjs memory put understanding memory.json
node bin/cli.mjs memory delete understanding
node bin/cli.mjs audio READING_ID
node bin/cli.mjs visual READING_ID
node bin/cli.mjs visual-frames READING_ID 4
node bin/cli.mjs local-asr READING_ID local-audio.m4s /local/model-directory
node bin/cli.mjs local-frames READING_ID local-video.mp4
node bin/cli.mjs import READING_ID segments.json
node bin/cli.mjs probe READING_ID --names "店铺=聚福楼,聚福搂"
node bin/cli.mjs probe READING_ID --audio /local/audio.m4s
node bin/cli.mjs audio-profile /local/audio.m4s --bucket 15

本地媒体适配器需 Python 3.10+。抽帧只需固定版本的 av 和 Pillow，1.7.1 包含脚本与依赖清单；独立环境安装、pythonPath 配置及 doctor / 四秒合成视频 smoke 见本地抽帧说明。npm 安装不会自动执行 pip。使用 setup-media --asr --download-model 明确安装 ASR 依赖并下载校验 small 模型；运行时不自动下载。支持图片的模型调用 bili_humanism_read 时自动尝试文字与画面；用 bili_humanism_visual 可按已有来源单独取图，之后沿 nextOffset 调用 bili_humanism_frames。普通文本模型明确返回未取得画面。宿主模型阅读图片后可通过导入接口保存画面文字；没有内置 OCR 或视觉权重。抽样不是翻页检测器，教程可能漏页。

上面的 BV 是占位符，请替换为自己选择的视频。仓库只分发通用代码与合成测试夹具；私人手账、案例、观影内容和第三方媒体保存在本地，不进版本控制或发布附件。

验收与维护

npm ci --ignore-scripts
npm run check
npm test
npm pack --ignore-scripts

见 验收记录、维护与升级、数据与安全 和 贡献指南。本版通过离线故障测试和真实宿主工具调用，不代表完成 7 天私人运行或 20 个代表视频基准。没有与其他插件运行同环境性能/精度对照；不宣称更快、更准或已经证明更有人文。

v0.1.0 历史记录：2026-10-20 补充真实 API 验收：通过 DSH 官方 stdio JSON-RPC 接口，在 deepseek-account / deepseek-flash 真实模型通道完成 3 轮会话、11 次插件工具调用，走通取稿、手账保存、记忆修正与删除、收件箱和状态查询；模型可见工具限制为本插件的 10 个工具。事件回执与本地账本交叉核对通过，没有 B站平台写入。具体视频、手账及完整会话不进入公开仓库；本次也不构成长期稳定性或人文质量基准。

工程格式依据 DeepSeek 官方 工具开发、插件安装 和 SDK API。来源整理见 NOTICE。MIT License。