quan2005 / dsh-plugin-jinji

dsh-plugin-jinji · 谨迹记忆面板

一个 DeepSeek Harness 插件：在网页界面的左侧栏加一个「记忆」入口，点开就能浏览你的日志和人物 / 产品画像。不需要编译，不依赖任何第三方包。

这是什么

核心理念：把「记忆」直接带进 DeepSeek Harness，让它成为这个工具自带的记忆能力——不需要安装任何其他软件。

这里的「记忆」是双轨的一套机制（这也是它与大多数记忆系统最大的不同）：

• 流水记忆（日志）：每天用录音、截图、粘贴文字记录素材，由 AI 整理成结构化日志（事件流），按 yyMM/DD-标题.md 存放在 .journal/memory/；
• 画像记忆（画像）：从事件流里持续提炼出的独立实体画像——人物档案（身份、关切、决策模式……）与产品档案，每个实体一份，存放在 .journal/identity/；画像又反哺对后续事件的理解。

这套理念最初在谨迹（JournalClaw）里成型，本插件把它原生落地在 DeepSeek Harness 本身：只要 DSH + 这一个插件，左侧栏就有「记忆」入口——按时间流浏览日志、按分组浏览画像、点开看全文；日志与画像的写入则由 DSH 里的 AI 会话按同一套目录约定完成。谨迹桌面应用不是前提，它是这套理念的来源。

适合所有需要在 DeepSeek Harness 里拥有记忆能力的人。这是一个极简的文本记忆系统：记忆的实体就是纯文本文件（Markdown 日志 + 画像档案），没有数据库、没有复杂后台；组织与维护以大模型为核心驱动——AI 负责把碎片整理成结构、判断什么值得记、如何更新画像，软件本身只提供最简单的读写与浏览界面。

装一个

dsh plugin --profile web add github:quan2005/dsh-plugin-jinji
# 重启 dsh web

也可以直接用 npm 安装：npm install dsh-plugin-jinji，然后在 profile 的 cordis.yml 里以 npm 包方式挂载本插件。

插件找日志库的顺序：配置文件里写的 root → 环境变量 DSH_JINJI_ROOT → dsh 启动时所在的目录。示例见 examples/profile-patch.yml。

装好后到「设置 → 插件配置 → 谨迹记忆」卡片调整：摘要带多少条日志/画像、字节上限；也可以在那里一键安装「谨迹秘书」Agent 预设——新建会话时选用它，那个会话就会主动书写记忆。配置保存在记忆根目录的 .jinji-memory.json，无需重启，新会话生效；两个 DSH 会话并行保存也不会互相覆盖。

能做什么

• 左侧栏「新会话」下方多一个「记忆」按钮，样式和官方按钮一致（收起成窄栏时自动变图标）
• 日志页：按月份分组的卡片瀑布流（日期、主题标签、一句话摘要、来源文件）
• 画像页：按「本人 / 产品 / 所在团队」分组的画像卡片
• 搜索：列表顶部搜索框，按标题 / 摘要 / 标签即时过滤日志与画像（多关键词、大小写不敏感）
• 键盘操作：↑/↓ 高亮条目、Enter 打开详情；Esc 智能分级（先清搜索词 → 退出详情 → 关面板）
• 点卡片看详情：左边是排版好的正文（也可切到原始文本），右边是当月日志列表
• 面板只盖住中间区域，左侧栏随时可以点；点侧栏任意位置面板自动收起；Esc 或 × 也能关
• 大库不卡：日志库几百条时面板依然秒开——索引带文件指纹缓存（没变的文件不重读），列表分组渐进渲染（滚动到底自动加载）
• 启动注入：每个新会话开始时，自动把最近日志与全部画像的摘要注入上下文（config.startupContext: false 可关）
• 主动书写（可选）：一键安装「谨迹秘书」Agent 预设——新建会话时选它，该会话就按书写规范主动沉淀记忆（何时写、日志/画像格式、建档门槛）；普通会话的提示词不带任何书写规则
• 可视化配置：「设置 → 插件配置」里有「谨迹记忆」卡片——日志/画像条数、摘要上限、预设安装，保存即生效（新会话），不用手改 YAML
• 颜色完全跟随 DeepSeek Harness 官方深色主题；窄屏（≤960px）自动切单列；所有内容都做了转义和路径校验，只读不改

文档（写给开发者）

文档	讲什么
docs/architecture.md	插件怎么分成「服务端部分」和「浏览器部分」、数据怎么流动、官方接口；记忆系统核心架构：summary 分层加载 + 双轨记忆（流水 / 画像实体）+ 读写闭环（启动注入），配图
docs/api.md	后台接口的完整约定：请求、响应字段、配置项、兼容边界
docs/design-decisions.md	每个重要取舍的记录：为什么这么做、理由、有什么风险（ADR-0001 ~ 0015）
docs/development.md	怎么改代码、怎么调试、改完怎么验证、前人踩过的坑
CONTRIBUTING.md	想贡献代码时的规矩
CHANGELOG.md	每个版本改了什么

开发

npm run check    # 检查代码语法（本项目无需编译，这是唯一的"检查步骤"）
npm run smoke    # 用模拟环境跑一遍自检（scripts/smoke.mjs）
npm run pack     # 预览发布包里会包含哪些文件

许可证

MIT © 2026 dsh-plugin-jinji contributors