前言¶
在 DeepSeek Harness（DSH）里做智能体或长期对话时，外部工具往往帮你「看世界」——检索、浏览器、文件系统。但另一类需求很少被插件单独承接：你自己发生了什么、精力与外部进展是否一致、时间花在哪、这件事相对成本有没有回报。把这些记在云端笔记或表格里可以，数据却和 Harness 会话脱节，也不方便在对话旁实时对照。
InnerSense（向内感知） 是 guhanfei-ai 维护的 DSH 插件，分类为「记忆」。它在本地用 SQLite 记录你明确请求写入的事件，并投影到五条观测轴；右侧 Introspect（内观） 面板展示指标、MEL × RRI 时序和近期事件。与同维护者的 dsh-worldsense 相对：后者感知外部世界，InnerSense 感知「你这边」的状态与反馈。README 标明项目为实验性原型（0.1.0），尚无稳定发行版，API 与数据格式可能变更，不建议用于生产。
这是什么¶
一句话：local-first 的 DSH 自观测（interoception）——记录真实事件、五条轴上的 personal metrics 与现实反馈（RRI），全部留在本机。
- 维护者：guhanfei-ai
- 仓库：guhanfei-ai/dsh-innersense
- 社区目录：skillhub.cn 插件页
- 许可证：MIT
插件本身不直接调用任何 LLM；由 Harness 中的模型理解你描述的事件后，通过工具写入数据库。
五条观测轴¶
事件入库后会被投影到五个维度（完整定义见仓库 docs/METRICS.md）：
| 轴 | 关注的问题 | 取值范围 |
|---|---|---|
| MEL | 当前有多少可用心理能量？ | 0–200 |
| RRI | 现实世界是否可观测地推进？ | 0–100 |
| ROI | 相对付出，这件事回报如何？ | 无界 |
| ARCTIC | 是否朝目标方向移动？ | -10 … +10 |
| TSA | 消耗了多少有限时间？ | 分钟，可空 |
README 刻意把 MEL 与 RRI 分开：高内在能量不等于高外部进展；面板上的 MEL × RRI 双线图会在两线之间 shading，便于看出「能量—现实」是否背离。
核心功能¶
工具（Tools）¶
Harness 侧暴露的工具如下（仅在你明确要求记录或查询时使用）：
| 工具 | 作用 |
|---|---|
introspect_record |
写入一条事件（仅在用户明确要求记录时） |
introspect_status |
当日紧凑状态块 |
introspect_today |
当日聚合与时间线 |
introspect_history |
带过滤与排序的多日 bounded 查询 |
introspect_get |
单条事件及原文 |
introspect_update |
用户指出评分有误时修正 |
introspect_delete |
删除单条事件（需用户明确确认） |
数据流¶
你描述发生了什么
↓
DeepSeek Harness 模型理解事件
↓
introspect_record 写入本地 SQLite
↓
Introspect 面板自动刷新
- 仅在你显式要求时记录（例如「记录一下」「记一笔」、
/self ...等 README 举例）。 - 数据路径：
$DSH_HOME/introspect/events.sqlite3；可在插件配置cordis.patch.yml里用dbPath覆盖。 - 备份：复制该
.sqlite3文件即可（标准 SQLite）。
右侧内观面板¶
点击 「内观」 切换 Introspect 面板，内容包括：
- 五条指标的最新值、趋势箭头与均值
- MEL × RRI 双线图
- 近期事件列表（可展开原文、各轴分数与理由、标签）
- 每次记录后自动刷新；明暗主题跟随 DSH
可选 peer 依赖 dsh-better-sidebar（>=0.10.0，optional）。
隐私与边界¶
插件侧声明：无云账号、无上传、无插件直连 LLM API、无遥测、无自动采集。若当前 DSH 会话使用远程 AI 提供商，对话内容（含事件描述）仍可能经该提供商传输；插件只控制本地库。详见仓库 docs/PRIVACY.md。
安装与启用¶
官方 README 给出的安装方式如下。社区目录与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；安装前建议自行查看源码与 MIT 许可证。插件以当前 DSH 进程权限运行，数据库写在 $DSH_HOME 下。
从 registry / web profile 安装：
dsh plugin --profile web add dsh-innersense
本地目录（link）：
dsh plugin --profile web add link:/path/to/dsh-innersense
指定已发布 tag：
dsh plugin --profile <profile> add <pkg>#v<version>
典型用法¶
- 安装并启用插件后，在 Harness Web 界面打开右侧 内观 面板。
- 在对话中用自然语言说明要记录的事，并明确要求记录（不要用含糊说法指望自动入库）。
- 模型调用
introspect_record后，面板刷新；可用introspect_today/introspect_history等做当日或历史查看。 - 若某条事件的轴评分不对，说明更正意图，由
introspect_update处理；删除需明确确认，对应introspect_delete。
开发者在仓库根目录可执行 npm run verify（build + 语法检查 + 测试）做本地校验；这与终端用户安装路径无关。
适用场景与注意¶
适合： 希望在 DSH 会话旁长期、本地留存「发生了什么 + 五条轴投影」的开发者或重度用户；重视 local-first、可备份 SQLite、不想插件自己打 LLM 或遥测的场景。
注意：
- 实验性原型，行为与格式可能变；生产环境需谨慎。
- 不会自动记日志；未显式请求则不写入。
- 安装与运行权限等同于你启动 DSH 的用户；
dbPath等配置以仓库cordis.patch.yml为准，勿臆造未文档化的字段。 - 星标与目录页展示以社区站点为准；撰写时 GitHub 星标为 0。
结尾¶
InnerSense 把「向内感知」做成 DSH 插件：事件进本地 SQLite，五条轴与 MEL × RRI 在 内观 面板可见，工具链覆盖记录、查询、修正与删除。若要进一步了解指标与架构，可阅读仓库中的 docs/METRICS.md、docs/ARCHITECTURE.md。
- 目录页：https://www.skillhub.cn/plugins/guhanfei-ai/dsh-innersense
- GitHub：https://github.com/guhanfei-ai/dsh-innersense
