Humanity

Name: Thr33H/Deepseek-Harness-Humanity
Author: Thr33H

本仓库由 AI 编写（署名：澄 / Cheng）—— 代码、测试与文档由 AI 助手产出；需求、决策与验收由仓库所有者负责。

English | 简体中文

Humanity 是 DeepSeek Harness 的拟人化套件：把人格、记忆、技能、自进化与梦境四件事收进同一个原生 Web 工作台，对外是一个可安装的 bundle，内部各模块互相独立、可单独开关。

它想解决的问题很朴素：让你的 Agent 记得住事、有自己的性格，而且这些都在你看得见、改得动的地方。

功能

模块	你得到什么
人格	身份卡 + 人格卡两栏编辑。原生项锁定（插件靠它们认标识），其余一切是自定义项：可增、可改名、可整项删除；每项的名称固定、内容直接改，不用"点一下才出现"；改动即时生效（热更新），并留一份可回滚的历史
记忆	三层记忆（长期 / 区域 / 会话）自动写入 + 七信号相关性检索；低风险内容自动落库，高风险内容只生成提案等你批准；条目可改归属、可合并去重、可归档与恢复；不会无限膨胀，也不会被自动删掉
技能	自进化总结出来的技能落在官方用户技能目录，工作台里可新建 / 修改 / 停用 / 恢复；技能引用了哪个插件的工具，会指名到插件告警
自进化与梦境	后台定期扫描新会话 → 模型解析 → 产出记忆与提案，全程记账、可设每日上限；「梦境」把整理过程写成一条可读的运行时间线

另外还有：一个总开关与四个模块开关（改动即时生效）；开关注册进 DSH 设置服务，所以在 DSH 自己的设置里搜 Humanity 也能找到。

环境要求

dsh：0.1.5-rc.2 起的 0.1.x，或 0.2.0-rc.2 起的 0.2.x（见兼容性）
Node >= 22
从源码安装时需要 pnpm（仓库随附 pnpm-lock.yaml）

安装

从 GitHub 安装（源码直达，当前推荐）

dsh plugin --profile web add github:Thr33H/Deepseek-Harness-Humanity
docker restart <容器名>          # 或重启你自己的 dsh 进程

Git 安装会在安装时跑一次构建（prepare）来产出 lib/。若 pnpm 提示 build script 被忽略（pnpm 11 起有构建闸门），在 DSH 的插件页点「允许这些脚本并重试」，或在该 profile 的 pnpm-workspace.yaml 里放上：

allowBuilds:
  esbuild: true

从 npm 安装

⚠️ 先确认 npm 上确有版本：npm view deepseek-harness-humanity version。若查不到（尚未发布），请用上面的 GitHub 方式。

dsh plugin --profile web add deepseek-harness-humanity
docker restart <容器名>

dsh plugin add 会在 profile 目录里跑 pnpm，并自动把本包追加进该 profile 的 dsh.profile.bundles（因为本包在 package.json 里声明了 dsh.bundle）—— 不需要手改任何配置文件。

从本地源码装（要改代码时）

git clone https://github.com/Thr33H/Deepseek-Harness-Humanity.git
cd Deepseek-Harness-Humanity
pnpm install                     # prepare 会自动构建一次
dsh plugin --profile humanity-dev add "$PWD"
dsh --profile humanity-dev --port 3099 --no-open   # 先建隔离 profile 验证，别直接动正在用的那个

装好以后：侧栏出现 Humanity 入口（有待确认内容时图标带红点），点击进入工作台；开关在 DSH 设置里搜 Humanity。

更新 / 卸载

dsh plugin --profile web update deepseek-harness-humanity    # 更新
dsh plugin --profile web remove deepseek-harness-humanity    # 卸载

插件的数据（$DSH_HOME/storages/humanity.json、$DSH_HOME/skills/）是独立数据，卸载插件不会删除它们。

数据放在哪

内容	位置
人格卡、记忆条目、提案、运行记录	`$DSH_HOME/storages/humanity.json`（版本化存储领域 `humanity`）
人格历史（被取代 / 被删内容的留档）	同一份存储的 `persona_history` 表，有保留期（默认 30 天，可设为永久）
模块开关、记忆模式、自进化调度与预算	`$DSH_HOME/settings.yaml` 的 `humanity` 段
技能文件	`$DSH_HOME/skills/`
会话	`$DSH_HOME/sessions/`（DSH 自己的）

一切都在 $DSH_HOME 里，跟着 DSH 一起备份 / 迁移；插件不往别处写。

会花你自己的钱（自进化）

「自进化」会按调度调用模型来整理会话（默认 idle：没有活跃对话满 30 分钟就自动整理一次，不是"只有手动点才跑"；也可改成每日 / 每周 / 每月）。

预算：每次运行的会话数、每会话事件数、单次输入字节、单次输出 token 与每日调用上限都在自进化页可改；超预算只警告并停止，不会偷偷烧钱；
花费逐项记账显示在自进化页（今日调用数 / tokens）；
人格注入与记忆检索不调用模型；记忆衰减核算是纯本地计算，同样不调用模型。

兼容性

机器判据就是本包的 peerDependencies：^0.1.5-rc.2 || ^0.2.0-rc.2（6 个官方 seam）。 不在这个区间里的 DSH 会在启动时直接拒绝挂载整个 bundle，表现为：人格卡从提示词消失、工作台页面消失、remember / recall 工具消失（数据不受损）。

DSH 版本	可装	说明
`0.1.5-rc.2` / `0.1.5-rc.3` / `0.1.6` … 0.1.x	✅	旧线
`0.2.0-rc.2` … 0.2.x	✅	新线（生产与靶机实测）
`0.1.7-rc.` / `0.1.6-rc.` / `0.2.1-rc.*`	❌	已知缺口：semver 的预发布"同段匹配"规则所致，需把该预发布段显式加进 peer 范围
其他	❌	低于下限或超出上界

开发

pnpm install
pnpm typecheck   # 全量类型检查（宿主 + 客户端）
pnpm build       # 产出 lib/index.js（宿主，ESM）与 lib/client.js（客户端，单文件 CJS bundle）
pnpm test        # 先构建，再跑全部测试

src/host/            宿主半边：开关、模块注册表、设置命名空间、存储领域
src/client/          客户端半边：侧栏入口、主工作台、文案字典
scripts/             构建脚本（tsc 编宿主，esbuild 打客户端 bundle）
test/                单元测试 + 真实服务组合测试 + 打包契约测试
cordis.patch.yml     本包作为 bundle 层提供的组合补丁

两条容易踩的线：

客户端半边必须是单文件 bundle —— 浏览器端的 require 只认 shell 播种的静态模块表，相对路径解析不了，所以 src/client 的相对导入必须在构建期内联掉。
默认值只有一处 —— 改默认值只能改 src/host/config.ts 的 schema，cordis.patch.yml 里刻意不写 config:；test/manifest.test.mjs 会盯着这件事。

贡献前请读 CONTRIBUTING.md；设计与边界说明见 docs/。

文档

文档	内容
docs/USAGE.md	使用说明：人格卡、记忆三层的取舍、技能落盘、自进化与梦境的每个开关
docs/ARCHITECTURE.md	架构与设计约束：模块边界、兼容门、为什么这样切
CHANGELOG.md	版本沿革（含每个修复要解决的真实症状）

License

致谢

DeepSeek Harness —— 本插件只使用其公开 seam（槽位、设置、存储领域、cordis loader）
角色卡与记忆格式的设计参考了社区实践（Character Card V2/V3 规范、SillyTavern World Info）

Humanity

本仓库由 AI 编写（署名：澄 / Cheng）—— 代码、测试与文档由 AI 助手产出；需求、决策与验收由仓库所有者负责。

English | 简体中文

它想解决的问题很朴素：让你的 Agent 记得住事、有自己的性格，而且这些都在你看得见、改得动的地方。

功能

模块	你得到什么
人格	身份卡 + 人格卡两栏编辑。原生项锁定（插件靠它们认标识），其余一切是自定义项：可增、可改名、可整项删除；每项的名称固定、内容直接改，不用"点一下才出现"；改动即时生效（热更新），并留一份可回滚的历史
记忆	三层记忆（长期 / 区域 / 会话）自动写入 + 七信号相关性检索；低风险内容自动落库，高风险内容只生成提案等你批准；条目可改归属、可合并去重、可归档与恢复；不会无限膨胀，也不会被自动删掉
技能	自进化总结出来的技能落在官方用户技能目录，工作台里可新建 / 修改 / 停用 / 恢复；技能引用了哪个插件的工具，会指名到插件告警
自进化与梦境	后台定期扫描新会话 → 模型解析 → 产出记忆与提案，全程记账、可设每日上限；「梦境」把整理过程写成一条可读的运行时间线

另外还有：一个总开关与四个模块开关（改动即时生效）；开关注册进 DSH 设置服务，所以在 DSH 自己的设置里搜 Humanity 也能找到。

环境要求

dsh：0.1.5-rc.2 起的 0.1.x，或 0.2.0-rc.2 起的 0.2.x（见兼容性）
Node >= 22
从源码安装时需要 pnpm（仓库随附 pnpm-lock.yaml）

安装

从 GitHub 安装（源码直达，当前推荐）

dsh plugin --profile web add github:Thr33H/Deepseek-Harness-Humanity
docker restart <容器名>          # 或重启你自己的 dsh 进程

allowBuilds:
  esbuild: true

从 npm 安装

⚠️ 先确认 npm 上确有版本：npm view deepseek-harness-humanity version。若查不到（尚未发布），请用上面的 GitHub 方式。

dsh plugin --profile web add deepseek-harness-humanity
docker restart <容器名>

从本地源码装（要改代码时）

git clone https://github.com/Thr33H/Deepseek-Harness-Humanity.git
cd Deepseek-Harness-Humanity
pnpm install                     # prepare 会自动构建一次
dsh plugin --profile humanity-dev add "$PWD"
dsh --profile humanity-dev --port 3099 --no-open   # 先建隔离 profile 验证，别直接动正在用的那个

装好以后：侧栏出现 Humanity 入口（有待确认内容时图标带红点），点击进入工作台；开关在 DSH 设置里搜 Humanity。

更新 / 卸载

dsh plugin --profile web update deepseek-harness-humanity    # 更新
dsh plugin --profile web remove deepseek-harness-humanity    # 卸载

插件的数据（$DSH_HOME/storages/humanity.json、$DSH_HOME/skills/）是独立数据，卸载插件不会删除它们。

数据放在哪

内容	位置
人格卡、记忆条目、提案、运行记录	`$DSH_HOME/storages/humanity.json`（版本化存储领域 `humanity`）
人格历史（被取代 / 被删内容的留档）	同一份存储的 `persona_history` 表，有保留期（默认 30 天，可设为永久）
模块开关、记忆模式、自进化调度与预算	`$DSH_HOME/settings.yaml` 的 `humanity` 段
技能文件	`$DSH_HOME/skills/`
会话	`$DSH_HOME/sessions/`（DSH 自己的）

一切都在 $DSH_HOME 里，跟着 DSH 一起备份 / 迁移；插件不往别处写。

会花你自己的钱（自进化）

预算：每次运行的会话数、每会话事件数、单次输入字节、单次输出 token 与每日调用上限都在自进化页可改；超预算只警告并停止，不会偷偷烧钱；
花费逐项记账显示在自进化页（今日调用数 / tokens）；
人格注入与记忆检索不调用模型；记忆衰减核算是纯本地计算，同样不调用模型。

兼容性

DSH 版本	可装	说明
`0.1.5-rc.2` / `0.1.5-rc.3` / `0.1.6` … 0.1.x	✅	旧线
`0.2.0-rc.2` … 0.2.x	✅	新线（生产与靶机实测）
`0.1.7-rc.` / `0.1.6-rc.` / `0.2.1-rc.*`	❌	已知缺口：semver 的预发布"同段匹配"规则所致，需把该预发布段显式加进 peer 范围
其他	❌	低于下限或超出上界

开发

pnpm install
pnpm typecheck   # 全量类型检查（宿主 + 客户端）
pnpm build       # 产出 lib/index.js（宿主，ESM）与 lib/client.js（客户端，单文件 CJS bundle）
pnpm test        # 先构建，再跑全部测试

src/host/            宿主半边：开关、模块注册表、设置命名空间、存储领域
src/client/          客户端半边：侧栏入口、主工作台、文案字典
scripts/             构建脚本（tsc 编宿主，esbuild 打客户端 bundle）
test/                单元测试 + 真实服务组合测试 + 打包契约测试
cordis.patch.yml     本包作为 bundle 层提供的组合补丁

两条容易踩的线：

客户端半边必须是单文件 bundle —— 浏览器端的 require 只认 shell 播种的静态模块表，相对路径解析不了，所以 src/client 的相对导入必须在构建期内联掉。
默认值只有一处 —— 改默认值只能改 src/host/config.ts 的 schema，cordis.patch.yml 里刻意不写 config:；test/manifest.test.mjs 会盯着这件事。

贡献前请读 CONTRIBUTING.md；设计与边界说明见 docs/。

文档

文档	内容
docs/USAGE.md	使用说明：人格卡、记忆三层的取舍、技能落盘、自进化与梦境的每个开关
docs/ARCHITECTURE.md	架构与设计约束：模块边界、兼容门、为什么这样切
CHANGELOG.md	版本沿革（含每个修复要解决的真实症状）

License

致谢

DeepSeek Harness —— 本插件只使用其公开 seam（槽位、设置、存储领域、cordis loader）
角色卡与记忆格式的设计参考了社区实践（Character Card V2/V3 规范、SillyTavern World Info）

Thr33H/Deepseek-Harness-Humanity

Humanity

功能

环境要求

安装

从 GitHub 安装（源码直达，当前推荐）

从 npm 安装

从本地源码装（要改代码时）

更新 / 卸载

数据放在哪

会花你自己的钱（自进化）

兼容性

开发

文档

License

致谢

Community comments

Thr33H/Deepseek-Harness-Humanity

Humanity

功能

环境要求

安装

从 GitHub 安装（源码直达，当前推荐）

从 npm 安装

从本地源码装（要改代码时）

更新 / 卸载

数据放在哪

会花你自己的钱（自进化）

兼容性

开发

文档

License

致谢

Community comments