ProjectKaren

一个 DSH 插件：让角色会睡觉、会被吵醒、会自己找事做、也会先开口说话。

A DeepSeek Harness plugin that gives a roleplay character a clock: sleep / wake, greetings, idle actions, proactive small talk, and optional outing photos.

角色卡与世界观不由本插件提供——懒狗作者假设你的会话里已经有角色了。 本插件只负责「时间」这一维：什么时候睡、什么时候醒、醒来之后干什么。

功能

• 睡眠 / 唤醒：角色也有自己的生活，会睡觉，会起床
• 睡着：当TA睡着的时候，不要打扰TA哦
• 吵醒：TA会因为你的“短信轰炸”醒来
• 问候：早安、午安，还有晚安
• 自由动作：当你不理TA的时候，TA会自己找点事做
• 主动搭话：当你不理TA的时候，TA会主动找上来
• 出游照片：当TA旅游到名胜景点，会给你拍照片
• 静默指令：/mute 30 —— 你让TA闭嘴一段时间，TA就不再主动开口（你说话TA照常回）
• 天气：填了城市，TA会知道外面什么天，问候和闲聊里会自然带上
• 节日：节日当天有不一样的问候、话题与行动
• 生日：支持填写你和TA的生日
• 中英双语：面板文案跟随 DSH 界面语言；注入给模型的提示词也跟随

安装

从 GitHub：

dsh plugin --profile <profile> add "git+https://github.com/2huy4n/ProjectKaren#v0.3.1"

安装后需要重启 DSH，在「设置 → ProjectKaren」里配置。

配置项

键	含义
enabled	总开关
defaultMuted	新会话是否默认静音
sleepStart / sleepJitter	入睡基准时刻 / 模糊 ±分钟
wakeStart / wakeJitter	醒来基准时刻 / 模糊 ±分钟
greetEnabled / greetWindowMinutes	早安+晚安开关 / 醒来后多久内还补早安
greetNoonEnabled / noonStart / noonJitterMinutes	午安开关 / 中午基准 / 模糊 ±分钟
nightLeadMinutes	睡前提前多少分钟道晚安
barrageCount / barrageWindowMinutes / barrageAwakeMinutes	吵醒阈值 / 统计窗口 / 清醒时长
talkEnabled / talkIntervalMinutes / talkJitterMinutes / talkDailyMax	主动搭话开关 / 间隔 / 模糊 / 每日上限
talkQuietStart / talkQuietEnd	静默时段（留空 = 不设）
planningEnabled / planningHorizonMinutes	滚动生活规划开关（默认开启）/ 向前规划的时长（分钟，默认 180，范围 5–1440）
planningRetryLimit	滚动规划失败后的重试次数（默认 5，范围 0–100；0 表示不重试）
actionEnabled / actionIntervalMinutes / actionJitterMinutes / actionIdleMinutes	自由动作开关 / 间隔 / 模糊 / 静默多久才动
actionDefaultMinutes / actionMinMinutes / actionMaxMinutes / actionDailyMax	动作时长默认 / 最短 / 最长 / 每日上限
citySelf / cityUser	角色所在城市 / 用户所在城市（留空 = 同城）
weatherEnabled	天气开关
holidayEnabled	节日开关
birthdayEnabled	生日开关
birthdaySelf / birthdayUser	角色生日 / 用户生日（MM-DD）
apiBase / apiPath / apiKey / model / size	生图接口（OpenAI 兼容的 /images/generations）
photoPrompt	没传 prompt 时用的默认画面描述
offsetMinutes	时钟偏移（调试用，整体平移插件看到的"现在"）

planningHorizonMinutes 控制滚动规划每次向前考虑多长时间； actionIntervalMinutes 控制旧版空闲动作调度器两次请求之间的等待时间。 会话开始使用滚动生活记录后，旧版的间隔、抖动、空闲阈值和每日动作上限不再决定该会话的活动。 此时关闭 planningEnabled 会暂停生成新计划和开始已安排的活动，不会恢复旧版调度器； 重新开启时，暂停期间错过的活动会被标记为延期。活动只有经工具明确确认后才会记为完成；规划时使用调度器所在时区的本地时间。 未解决活动（计划中、进行中或延期）合计最多新增至 200 条；达到上限时不会删除未完成的活动，须先明确恢复、取消或跳过已有活动才能新增。 已有数据超过上限时也不会自动删除。详见滚动生活规划说明。 规划失败后每 5 分钟最多重试一次；默认初次失败后最多重试 5 次。达到上限会记录警告并停止该会话的规划重试。 排除故障后，可关闭再开启滚动规划、修改重试次数或重启进程来重置计数。计数保存在内存中，不影响已有活动记录。

/mute 指令

让TA闭嘴一段时间。这个指令不会进模型，TA看不到。

你输入	结果
/mute 30 · /mute 30m · /mute 30min · /mute 30 minutes · /mute 30分钟	静默 30 分钟
/mute 2h · /mute 2 hours · /mute 2小时	静默 2 小时
/mute 1d · /mute 1 day · /mute 1天	静默 1 天
/mute 到22:00 · /mute until 22:00 · /mute 22:00	到今晚 22:00（时刻已过则顺延到明天）
/mute off · /mute 取消	解除静默

静默期间：不再主动搭话、不再问候、不再播报自由动作的收尾；你主动找TA时照常回复。 可设范围 1 分钟 ~ 7 天。不写单位按分钟算，大小写和多余空格都无所谓。

天气

在面板里填城市即可（中英文都认，如 杭州 / Hangzhou）。| 天气数据来自 Open-Meteo.com（CC BY 4.0）， 免 API Key、无需注册。

• 两个城市相同（或只填了一个）：TA按「TA和你在同一个地方」来说天气。
• 两个城市不同：TA会知道你不在TA那边，可以顺口提一句你那边的天气（比如提醒你带伞）。

天气每小时最多刷新一次，面板里有「立即刷新天气」。取不到天气时TA不会编造。

节日与生日

生日填 MM-DD，例如 05-20。

节日表内置 10 年（2026–2035），含公历节日（元旦 / 情人节 / 妇女节 / 愚人节 / 劳动节 / 儿童节 / 教师节 / 国庆 / 万圣节 / 平安夜 / 圣诞 / 跨年）与农历节日（春节 / 元宵 / 端午 / 七夕 / 中秋 / 重阳）。超出 2035 年会自动只认公历节日，面板会提示。

中英双语

• 面板文案：跟随 DSH 的界面语言设置（客户端 ctx.locale）。
• 注入给模型的提示词、工具描述、报错：同样跟随 DSH 界面语言；客户端还没打开过、没上报时，回退到系统语言。
• 目前只支持中文和英文——DSH 宿主本身也只提供这两种（zh / en）。
• 要改文案只改这两处：dsh/i18n/{zh,en}.json（宿主）与 client/client.js 里的两个字典对象。

状态与日志

配置与每会话状态存在 ~/.dsh/project-karen.json（DSH_HOME 优先）。 除配置与会话状态外，这个文件还保存照片引用、天气缓存和客户端上报的语言。 面板里有「活跃会话」列表（状态 / 入睡醒来时刻 / 正在做什么 / 今日次数 / 是否静默）和「最近动作」日志，可一键清空。

License

AGPL-3.0-or-later —— GNU Affero General Public License v3.0 或更高版本。

Copyright (C) 2026 2huy4n · 完整条文见 LICENSE