前言¶
在 DeepSeek Harness（DSH）里跑 Agent，常见缺口是：会话一换，上下文就丢；想给助手固定「性格」和长期事实，往往只能堆进系统提示或外部向量库，改起来也不直观。社区插件目录里，Thr33H 维护的 Humanity（deepseek-harness-humanity）把人格、记忆、技能、自进化与「梦境」时间线收进同一个原生 Web 工作台，对外是一个可安装的 bundle，模块可单独开关。下面介绍它解决什么问题、能做什么，以及如何安装与使用。
这是什么¶
Humanity 是 DeepSeek Harness 的拟人化套件。仓库说明由 AI 助手（署名澄 / Cheng）参与编写，需求与验收由维护者 Thr33H 负责；许可证为 MIT，当前包版本为 0.1.17（以 package.json 为准）。
它想解决的问题很直接：让 Agent 记得住事、有自己的性格，且这些都在你看得见、改得动的地方——人格与记忆数据落在 $DSH_HOME，不依赖插件外的隐式存储。
SkillHub 分类为「趣味换装」；GitHub 星标数为 0（以目录页线索为准，安装前请以仓库页面为准）。
核心功能¶
各模块在 README 中有明确划分，概要如下。
人格¶
- 身份卡与人格卡两栏编辑；原生项用于插件识别标识，其余为可增删改的自定义项。
- 名称固定、内容直接编辑，改动热更新，并保留可回滚历史。
记忆¶
- 三层记忆：长期 / 区域 / 会话；自动写入，并用七信号做相关性检索。
- 低风险内容自动落库；高风险内容只生成提案，需你批准后才写入。
- 条目可改归属、合并去重、归档与恢复；不会无限膨胀，也不会被自动删掉。
技能¶
- 自进化总结出的技能写入官方用户技能目录（
$DSH_HOME/skills/）。 - 工作台内可新建、修改、停用、恢复；若技能引用了某插件的工具，会指名该插件并告警。
自进化与梦境¶
- 后台按调度扫描新会话 → 模型解析 → 产出记忆与提案，全程记账，可设每日上限。
- 「梦境」把整理过程写成一条可读的运行时间线。
开关与 DSH 集成¶
- 总开关与四个模块开关，改动即时生效。
- 开关注册进 DSH 设置服务；在 DSH 设置里搜索
Humanity也能找到。 - 人格注入与记忆检索不调用模型；记忆衰减为本地计算。自进化会按调度调用模型（见下文「费用与调度」）。
兼容 DSH 的 peerDependencies 为 ^0.1.5-rc.2 || ^0.2.0-rc.2（6 个官方 seam）。不在区间内的 DSH 会在启动时拒绝挂载整个 bundle（人格卡从提示词消失、工作台消失、remember / recall 工具消失；数据不受损）。部分预发布段（如 0.1.7-rc.*）因 semver 规则已知无法匹配，需维护者扩展 peer 范围后才可装。
环境要求¶
- dsh（
@deepseek-ai/dsh）：自0.1.5-rc.2起的 0.1.x，或自0.2.0-rc.2起的 0.2.x。 - Node
>= 22。 - 从 GitHub 源码安装时，构建需要 pnpm（仓库含
pnpm-lock.yaml）。
安装与启用¶
插件以当前 dsh 进程权限运行；安装前应自行审阅 GitHub 源码 与 MIT 许可证。SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。
从 GitHub 安装（README 当前推荐）¶
安装会在 profile 目录执行 pnpm，并自动把本包追加进该 profile 的 dsh.profile.bundles（包内声明了 dsh.bundle），无需手改配置。
dsh plugin --profile web add github:Thr33H/Deepseek-Harness-Humanity
docker restart <容器名> # 或重启你自己的 dsh 进程
Git 安装会触发 prepare 构建产出 lib/。若 pnpm 11+ 忽略 build script，可在 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 <容器名>
装好后¶
- 侧栏出现 Humanity 入口（有待确认内容时图标带红点）。
- 点击进入原生 Web 工作台；模块开关可在工作台或 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 的 $DSH_HOME 即可一并带走 Humanity 数据。
典型用法¶
README 将详细操作放在 docs/USAGE.md，包括人格卡编辑、记忆三层取舍、技能落盘、自进化与梦境各开关。可按下面顺序上手：
- 安装并重启 dsh 后，打开侧栏 Humanity 工作台。
- 在人格页编辑身份卡与人格卡，保存后即时注入后续对话（热更新）。
- 在记忆页查看自动写入与待批准提案；对高风险提案逐项批准或拒绝。
- 在自进化页查看调度（默认
idle：无活跃对话满 30 分钟触发一次，非仅手动）、预算与今日 tokens；在「梦境」时间线查看整理过程。 - 在技能页管理
$DSH_HOME/skills/下由自进化或手工维护的用户技能。
Agent 侧会暴露 remember / recall 等工具（DSH 版本兼容且 bundle 成功挂载时）；具体字段与交互以 USAGE 文档为准。
费用与调度（自进化）¶
自进化会调用模型整理会话。预算项（每次运行的会话数、每会话事件数、单次输入字节、单次输出 token、每日调用上限）可在自进化页修改；超预算只警告并停止。花费在自进化页分项展示（今日调用数 / tokens）。
默认调度为 idle，也可改为每日 / 每周 / 每月。人格注入与记忆检索不额外调用模型。
适用场景与注意¶
适合：希望在 DSH 内本地、可视化地管理 Agent 人格与分层记忆；需要会话结束后自动提炼记忆与技能，并愿意承担自进化的模型调用成本；使用兼容版本的 DSH（0.1.5-rc.2+ 或 0.2.0-rc.2+ 的稳定线）。
注意：
- 插件与 dsh 同进程、同权限；安装前请阅读源码与依赖。
- DSH 版本不匹配时 bundle 不会挂载，表现为功能「消失」，但
humanity.json等数据仍在。 - 自进化默认会在空闲时自动跑，若在意 API 费用，请在自进化页调低预算或改调度。
- 仓库标注为 AI 参与编写；生产使用前建议自行验收行为与数据边界。架构说明见 docs/ARCHITECTURE.md。
结尾¶
Humanity 把 DSH Agent 的拟人化能力（人格、记忆、技能、自进化与梦境）收敛到一个原生 Web 工作台，数据与开关都在 $DSH_HOME，符合 DSH「一切皆插件」的扩展方式。若要浏览简介或跳转安装说明，可看社区目录页 SkillHub：Deepseek-Harness-Humanity；完整安装命令、兼容矩阵与开发说明以 GitHub 仓库为准：Thr33H/Deepseek-Harness-Humanity。
