dsh-introspect
以本地优先的方式为 DeepSeek Harness 提供自我观测：记录真实事件，将其映射到五个观测轴（MEL/ROI/ARCTIC/TSA/RRI），存储在本地 SQLite 中，并在右侧面板中查看 MEL x RRI。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:guhanfei-ai/dsh-introspect#c8f8a5156de5c7833ed890e8603c31dd535d9fb1Introspect 以 dsh-introspect 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Local-first self-observability for DeepSeek Harness.
Observe your events, energy, time, value, direction and reality feedback — locally.
Observe the world. Introspect the self.
Records real events into a local SQLite database and projects them onto five observation axes:
| Axis | Question | Range |
|---|---|---|
| MEL | How much usable mental energy is available? | 0–200 |
| RRI | Did the real world observably move? | 0–100 |
| ROI | What did this return to me relative to what it cost? | unbounded |
| ARCTIC | Did this move me toward where I want to go? | -10..+10 |
| TSA | How much finite time did this consume? | minutes, nullable |
The right-side Introspect panel shows all five, a MEL × RRI time series, and recent events.
Why MEL × RRI? High internal energy does not necessarily imply high external progress. dsh-introspect deliberately keeps mental energy and reality feedback as separate dimensions so you can see when they diverge.
dsh plugin --profile web add link:/path/to/dsh-introspect
Or from a published tag:
dsh plugin --profile <profile> add <pkg>#v<version>
| Tool | Description |
|---|---|
introspect_record | Store one event (only when the user explicitly asks to record). |
introspect_status | Today's compact state block. |
introspect_today | Today's aggregation and timeline. |
introspect_history | Bounded multi-day query with filters and sorting. |
introspect_get | One event with its verbatim raw text. |
introspect_update | Correct a score when the user says it is wrong. |
introspect_delete | Remove one event (requires explicit user confirmation). |
You describe what happened
↓
DeepSeek Harness model understands the event
↓
introspect_record stores it in local SQLite
↓
Introspect panel refreshes automatically
$DSH_HOME/introspect/events.sqlite3 on your machine.The Introspect panel (toggle with the "内观" button) shows:
Supports dark mode and light mode (follows the DeepSeek Harness theme).
| Item | Location |
|---|---|
| Database | $DSH_HOME/introspect/events.sqlite3 |
| Schema | PRAGMA user_version, single events table |
| Backup | Copy the .sqlite3 file; it's a standard SQLite database |
Override with dbPath in the plugin config (cordis.patch.yml).
If the DeepSeek Harness session uses a remote AI provider, the conversation content (including event descriptions) may transit that provider's infrastructure. The plugin controls only its own local storage.
See docs/PRIVACY.md for the full statement.
npm install
npm run build:client # build client.js from src/client/ fragments
npm test # run all tests
npm run verify # build + syntax check + test
Tests cover: SQLite initialization, migration, CRUD, unicode, null metrics, timezone boundaries, tool validation, approval hooks, API trust fence, client pure functions, chart geometry, and secret/hygiene scans.
See docs/METRICS.md for the full definition of each axis, their ranges, bands, aggregation rules, and limitations.
See docs/ARCHITECTURE.md.
MIT