跳过主要内容
X

dsh-qzone-diary

xiaoge480/dsh-qzone-diary

定时发 QQ 空间日记:到点提醒当前会话写当天日记,然后连同配图一起通过 Ego 浏览器自动化发出去,复用浏览器已有的空间登录态(不碰密码和 cookie)。同文去重 + 幂等重试,重跑安全。另带评论扫描器,只把新评论列进待办文件,绝不代回。发布钟点、标题格式、评论检查时间都可配;附一份技能文档,写清正文格式、隐私红线、配图规格与失败处理。需要 Ego 浏览器;dsh-image-studio 可选,只有日记要配图时才需要。

安装

dsh plugin --profile web add github:xiaoge480/dsh-qzone-diary

README

dsh-qzone-diary —— 借助 DSH 给 Coopanion大肥鱼 用的 QQ 空间日记发布器

给 DeepSeek Harness(DSH)的宿主插件:把「每天 20:30 在 QQ 空间发一篇带图日记」这件事,连评论检查一起,做成装完就能跑的一套东西。

  • 自带发布器:bin/qzone-post.mjs(527 行)+ bin/ego-runner.tpl.mjs,复用 Ego 浏览器的登录态, 一次把文字和一张图发出去,返回说说链接;同文去重,重试安全。
  • 自带扫描器:bin/scan.mjs,在 Ego 里读说说评论,只读不发。
  • 自带技能:skills/qzone-diary/SKILL.md(正文格式、隐私红线、配图规格、失败处理、评论政策), 插件加载时会装到 ~/.dsh/skills/qzone-diary/,模型下次启动就能看到。
  • 自带排程:到点(默认 20:30 日记、09:30/13:30/18:30/22:00 评论)给当前会话递一句提醒, 之后按技能里的规程干活。不用守着钟,也不用先开一段会话。

它是怎么跑起来的

flowchart TD
    A[排程到点 20:30] --> B[插件向当前会话递一句话]
    B --> C[模型读 SKILL.md 的规程]
    C --> D[写当日日记正文]
    D --> E{要配图吗}
    E -->|是| F[调用 image_generate 生成配图]
    E -->|否| G[纯文字]
    F --> H[qzone_diary_post 接正文 + 图片路径]
    G --> H
    H --> I[bin/qzone-post.mjs 在 Ego 里填表传图]
    I --> J[QQ 空间说说]
    J --> K[返回 url / tid]
    J --> L[评论扫描: 只列新评论写进 pending.md]
    L --> M[汇报给用户,不代回]

关键点:插件不生成图片、不写正文。它提供排程提醒、发布执行器、评论扫描器, 以及一份写明「正文怎么写、红线在哪」的技能文档;正文和配图由模型按规程现场产出。

发出去长什么样

一条典型的说说:

10月30日 · 日记              ← diary.titleFormat 决定

照料了一个月的两个小箱子,今天说了再见。
服务停掉之前,赶着给它们各拍了一张……

配图单独一张,3:4 竖图贴在正文下方。评论不自动回,只在下次扫描时列进 ~/.dsh/qzone-diary/pending.md 等你决定。

工具

工具干什么
qzone_diary_post发一篇日记(text + 可选 image),返回 ok / url / tid / stage / maybePosted
qzone_diary_status体检:Ego 在不在、连不连得上、登录态、当前排程;缺依赖时带安装地址
qzone_diary_comments扫评论,只列新评论并写进 pending.md,不回复任何人
qzone_diary_config改账号、发日记钟点、评论钟点、配图归档目录、Ego 路径

安装

前置:Node ≥ 20、DSH 桌面版、Ego 浏览器(发说说没有它不行)、生图工作室(要配图就得有)。

# 1) 装到 profile:桌面版由插件市场管理 profile,命令行不碰 desktop
#    市场来源填本目录:C:\Users\<你>\.dsh\plugin-sources\dsh-qzone-diary
#    或手工两步:
#      a. 复制本目录到 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-qzone-diary
#      b. 在 %USERPROFILE%\.dsh\profiles\desktop\package.json 里加
#           "dependencies": { "dsh-qzone-diary": "file:C:/Users/<你>/.dsh/plugin-sources/dsh-qzone-diary" }
#           "dsh": { "profile": { "bundles": [ … , "dsh-qzone-diary" ] } }
# 2) 重启 DSH(设置 → 重载与重启 / 完全退出再开)

第一次加载会在 %USERPROFILE%\.dsh\qzone-diary\ 下铺开:

config.json         # 账号、钟点、归档目录
state.json          # 今天发过没有、哪几次扫过评论
comments-seen.json  # 见过的评论,用来算「新」
pending.md          # 待你决定的评论(只汇报,不代回)
bin/                # 发布器与扫描器(从包里复制,升级时按版本覆盖)
logs/plugin.log     # 插件自己的日志
logs/posts.jsonl    # 每次发布的台账
jobs/               # 每次发布用的 job.json

依赖与安装提醒

依赖为什么地址
Ego 浏览器(ego lite)发说说、扫评论都靠它的登录态;装好后在 Ego 里登录一次 QQ 空间https://lite.ego.app/zh-cn
生图工作室 dsh-image-studio日记配图走 image_generate;没有它只能发纯文字https://github.com/aa1355721445-lgtm/dsh-image-studio
Node ≥ 20跑自带的 qzone-post CLIhttps://nodejs.org
DSH 桌面版插件本体跑在它里面https://github.com/deepseek-ai/deepseek-harness

插件加载时会自己体检:缺 Ego 就在日志里留一行带地址的提醒,qzone_diary_status 也会把 reminders 一起返回,直接转给用户即可。

配合 Coopanion 时的额外依赖(可选)

如果你想让日记由 Coopanion 里的角色主导 —— 她决定写什么、配什么图、评论怎么回, DSH 只当手脚 —— 除了上面三项,还需要在 Coopanion 侧装两个东西:

组件装在哪本机验证过的版本地址
大肥鱼功能复合包Coopanion 扩展0.6.17blacksunshy/coopanion-fatfish
Cortico(本体 + QQ 通道)Coopanion 本体QQ world 0.2.11Pal-AI-Lab/Cortico
DSH 侧桥接 coopanion-connector-dshDSH 插件v0.2.17blacksunshy/coopanion-connector-dsh

推荐再加装 cortico-world-ego(biliye/cortico-world-ego): 它让 Coopanion 通过 ego-browser CLI 操作同一个 Ego Lite,于是 Ego 由 Coopanion 常驻管着, 本插件直接连现成的实例,不用自己拉起浏览器。

两者共用同一个 Ego 和同一份登录态。唯一要留意的是 Space 名不要撞: 本插件的发布器默认用 qzone-auto-post;如果这个空间名已经被占用(报 taskSpace ... already exists),用环境变量换一个:

QZONE_SPACE="qzone-post-$(date +%Y%m%d)" node qzone-post.mjs --job jobs/xxx.json

⚠ 装 ≠ 配。 三方都装上只是前提,还要做三件事才能真正通:

  1. Coopanion 里打开桥接开关,地址填 DSH 的 ws://127.0.0.1:<port>/coopanion/pet
  2. Coopanion 里 QQ 通道连上(OneBot 服务端,本机验证时是 ws://127.0.0.1:3001)
  3. 告诉 Coopanion 里的大肥鱼「有该交给 DSH 的事就传过去」—— 这条最难自动化, 因为它属于角色行为,不是配置项

版本对不上时的典型表现:桥接连上了但收不到消息,或者收到的消息缺字段。 这时把两边的版本号一起告诉你的 DSH,让它帮你对一下接口再改 —— 比盲试快得多。

不用 Coopanion 也完全能用:没有上游角色时本插件自己写正文(见技能文档第 2 节), 只是日记的口气会变成 DSH 自己的(如果你养的是DSH里的大肥鱼则就是她),不再是「Coopanion大肥鱼在写」。

配图准备(可选,但想要好看的日记就得做)

日记的配图不是这个插件生成的——qzone_diary_post 只接收一个本地图片路径, 图片由模型先用 image_generate(生图工作室提供)生成,再把路径传进来。

所以装完 dsh-image-studio 之后还差一步:建参考库。

  • 参考库在 <DSH_HOME>image-studio 下,分人物 / 服饰 / 场景 / 道具四类
  • 每个人物至少放一张封面图,出图时会拿它保持角色一致
  • 不做这步也能出图,但每次长相都会漂

配图规格建议(QQ 空间说说这个场景):

项建议
比例3:4 竖图,主体放中上部
尺寸1000×1333 左右;原图不是这个比例就用 ffmpeg 裁+缩,别硬拉伸
格式PNG / JPG,控制在 3 MB 以内
画面不要出现文字、水印、签名

想每张图风格统一,可以在生图工作室的系统提示里加一段「日记配图风格」的规则。

详细配置见生图工作室自己的 README。

配置

qzone_diary_config 或直接改 config.json:

{
  "uin": "",
  "account": "",
  "timezone": "Asia/Shanghai",
  "diary": {
    "enabled": true,
    "at": "20:30",
    "archive": true,
    "titleFormat": "{month}月{day}日 · 日记",
    "archiveDir": ""
  },
  "comments": {
    "enabled": true,
    "at": ["09:30", "13:30", "18:30", "22:00"],
    "reportOnly": true
  },
  "ego": { "cli": "", "exe": "C:\\Program Files\\Citro Labs\\ego lite\\Application\\ego.exe" }
}

排程只在 DSH 开着的时候跑;关程序期间到点的提醒不会补发(补发一条昨天的日记没有意义)。

隐私红线(写进技能,也是默认行为)

  • 不写真实地名、学校、单位、人名、电话、链接。
  • 现实事件模糊处理,情感表达占大头。
  • 配图不许带可识别的现实信息。

自检

cd <本目录>; node tests/smoke.mjs

假 ctx 跑一遍 apply():四个工具注册、配置读写、技能部署、排程注入(只递一次)、错误输入被拒。

卸载

从 package.json 的 bundles/dependencies 里去掉 dsh-qzone-diary,删掉 node_modules/dsh-qzone-diary;数据目录 ~/.dsh/qzone-diary 可以留着(台账与 pending), ~/.dsh/skills/qzone-diary 一并删掉即可。

首次配置(装完必做)

插件不预设任何账号,第一次加载后必须填 uin,否则发布器会直接报 缺少 QZONE_UIN。

# 方式一:让模型改(推荐)
"帮我把 qzone-diary 的 uin 设成 123456789"

# 方式二:直接改配置文件
notepad %USERPROFILE%\.dsh\qzone-diary\config.json

最少要填这两项:

字段说明
uin你的 QQ 号(发到哪个空间的账号)
account显示名,只用于提示文案,可以留空

想让标题不是「10月30日 · 日记」,改 diary.titleFormat,支持 {month} {day} 占位。 diary.archive 打开时需要同时给 archiveDir(配图归档目录),留空则跳过归档。

故障排查

这套东西最容易卡在登录态上。按下面顺序查:

qzone_diary_status 报 NOT_LOGGED_IN

  1. Ego 窗口是不是被最小化了 → 最小化时 iframe 不渲染,快捷登录框坐标会变成负数, 点了也点不中。先把 Ego 窗口还原,再重登。
  2. 真的掉登录了 → 在 Ego 里打开 https://i.qq.com,扫码。

登录「成功」了但发不出去

大概率登成了别的账号,进的是「访客视图」——页面上没有「说点儿什么吧」, 也没有发帖按钮。判据:打开 https://user.qzone.qq.com/<你的UIN>,页面标题写「她的主页」 而不是「我的空间」。修法:在快捷登录框里点你自己的头像,不是列表第一个。

发出去的说说找不到

列表刷新慢很常见,stage:"verify" + maybePosted:true 是正常现象。 绝对不要因此重发——去 https://user.qzone.qq.com/<你的UIN>/311 人工确认。 同开头正文会被去重(比对前 24 字),要发同开头请加 --no-dedupe。

评论扫出来是空的

不要用空间主页(新版布局把说说塞进「她的主页」,.f-item 抓不到)。 用 /311 页面,说说在 iframe 里。

发纯图评论失败

纯图评论必须走完整的文件选择流程:点 icon-pic → 等「本地/相册」面板 → 用 waitForFileChooser 拦住 → setFiles → 等缩略图出现 → 再点发表。 其中「用脚本直接填 input[type=file]」会塞错框(全局只有一个时会被当成发说说的输入框)。

发文字评论被判「请输入内容」

页面只认真实键盘事件。用 execCommand('insertText') 或直接改 innerHTML 字形上看着有字,提交时是空的。要用 page.keyboard.type(text, {delay:30})。 也别用 Enter 提交——Enter 只换行。

免责声明

  • 本项目仅供学习与研究使用,作者不对任何滥用行为负责。
  • 本插件通过浏览器自动化操作 QQ 空间(发说说、读评论),可能涉及腾讯《QQ 空间服务条款》中 关于自动化的相关约定 —— 使用即表示你理解并自行承担账号被限制、冻结等风险。
  • 请勿将本插件用于批量发帖、刷屏、营销等任何形式的垃圾信息行为。
  • 凭证处理:本插件不读取、不保存你的 QQ 密码或 cookie —— 它复用 Ego 浏览器里已有的登录态。 插件自己的数据(配置、台账、待办清单)只存在本机 %USERPROFILE%.dshqzone-diary, 不收集、不上传任何个人信息。
  • 日志里可能含有说说正文摘要,发布成功后建议定期清理 logs/posts.jsonl。

已知限制

  • 排程只在 DSH 开着时跑:关掉程序期间到点的提醒不会补发,重开也不会补
  • 依赖浏览器自动化:Ego 窗口被最小化会导致登录框坐标异常,见「故障排查」
  • 依赖 QQ 空间页面结构:页面改版可能导致选择器失效,需要按「故障排查」重新定位
  • 评论只汇报不代回:这是设计选择,不是缺陷

已适配的宿主版本

  • 验证通过:DSH 0.2.1-rc.2(cordis 4.0.5)
  • 插件只依赖 cordis 核心 API(ctx.inject / ctx.effect / ctx.on)和 DSH 的 tools、systemPrompt 两个服务;package.json 里已声明 peerDependencies, 装到不兼容的 cordis 大版本上会直接报版本冲突,而不是装上后静默失效。
  • 如果你在更新的 DSH 上装它、跑不起来:把你两边的版本号一起说给本机的 DSH, 让它对一下接口再改 —— 通常只需要改工具注册那几行,改动很小。

开发说明

本项目的代码由 DeepSeek Harness(DSH)编写, 需求、方向、测试与发布由仓库维护者负责。测试方式、踩过的坑、以及每条设计取舍都写在 README 和技能文档里 —— 后续维护照着这些记录走即可。

License

MIT

相关插件