前言¶
在 DSH 里做智能体时，常见的问题之一是：会话可以处理日志、人物画像和产品资料，但这些内容如果没有统一入口，就仍会散落在本地文本中，检索和复用都要绕回外部工具。
dsh-plugin-jinji 是一个 DeepSeek Harness（DSH）插件。它在网页界面的左侧栏新增「记忆」入口，让日志和人物/产品画像可以直接在 DSH 里浏览。插件定位为极简文本记忆系统，无需安装其他软件，无需编译，无第三方依赖。
这是什么¶
dsh-plugin-jinji 提供双轨记忆：一轨是流水日志，一轨是人物/产品实体画像。组织和维护以大模型为核心驱动。仓库地址为 https://github.com/quan2005/dsh-plugin-jinji，许可证为 MIT，package.json 中的 author 写作 dsh-plugin-jinji Contributors。
核心功能¶
下面按使用路径说明已确认的功能。
入口与浏览¶
- 左侧栏新增「记忆」按钮。
- 日志页按月份分组，展示卡片瀑布流。
- 画像页按「本人 / 产品 / 所在团队」分组。
- 详情视图可显示排版正文或原始文本，并展示当月日志列表。
检索与操作¶
- 支持按标题、摘要、标签即时搜索过滤日志与画像。
- 支持键盘操作：↑/↓ 高亮、Enter 打开、Esc 分级退出。
会话与写入¶
- 新会话启动时自动注入最近日志与全部画像摘要。
- 如需关闭启动注入，可设置：
config.startupContext: false
- 可选一键安装「谨迹秘书」Agent 预设，以主动书写记忆。
配置与性能¶
- 「设置 → 插件配置」中有「谨迹记忆」卡片，可可视化调整日志/画像条数与摘要上限。
- 使用索引文件指纹缓存与渐进渲染，大库浏览不卡。
- 跟随官方深色主题；窄屏 ≤960px 自动切单列。
- 内容做转义和路径校验，只读不改。
安装与启用¶
先确认环境满足 Node >=20。
使用插件命令安装：
dsh plugin --profile web add github:quan2005/dsh-plugin-jinji
然后重启 dsh web。
也可以使用 npm 安装：
npm install dsh-plugin-jinji
然后在该 profile 的 cordis.yml 里以 npm 包方式挂载本插件。
插件找日志库的顺序如下：
1、配置文件中的 root
2、环境变量 DSH_JINJI_ROOT
3、dsh 启动时所在目录
典型用法¶
经过上面的安装，可以先在左侧栏点击「记忆」，查看日志和画像。
日常使用时，可先做搜索，再用键盘定位：
- 用搜索框按标题、摘要、标签过滤。
- 用 ↑/↓ 高亮条目。
- 用 Enter 打开详情。
- 用 Esc 分级退出。
需要调整上下文注入范围时，在「设置 → 插件配置 → 谨迹记忆」卡片中调整日志/画像条数、摘要字节上限。配置保存在记忆根目录的 .jinji-memory.json，无需重启，新会话生效；两个 DSH 会话并行保存配置不会互相覆盖。
如果希望某个会话主动书写记忆，可在「谨迹记忆」卡片中一键安装「谨迹秘书」Agent 预设，然后在新建会话时选用该预设。
开发验证时可用：
npm run check
检查代码语法。
npm run smoke
用模拟环境跑一遍自检。
npm run pack
预览发布包里会包含哪些文件。
适用场景与注意¶
适合需要在 DSH 中浏览日志、画像，并在新会话中复用这些摘要的人。它把「记忆」入口直接放在 DSH 网页界面里，减少在 DSH 之外反复切换工具。
使用前需要注意：插件以当前 dsh 进程权限运行，安装前建议检查源码和 MIT 许可证，确认满足本地安全要求。插件声明为只读不改，内容均做转义和路径校验；如果日志库或画像内容来自敏感数据，仍应按本地数据合规要求处理。
参考¶
- GitHub：
https://github.com/quan2005/dsh-plugin-jinji - 社区目录页（插件线索，非官方应用商店；本次资料未独立确认）：
https://www.skillhub.cn/plugins/quan2005/dsh-plugin-jinji
