dsh-plugin-shiori-role 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-plugin-shiori-role 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-plugin-shiori-role 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-plugin-shiori-role 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/8/15。

角色扮演 YinFengWindy/dsh-plugin-shiori-role

Q: dsh-plugin-shiori-role 是什么插件？

为会话绑定可编辑角色并隔离持久记忆

DeepSeek Harness

YinFengWindy80 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

为会话绑定可编辑角色并隔离持久记忆

25/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/15 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add YinFengWindy/dsh-plugin-shiori-role

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：待复验

是什么

dsh 原生插件 · chat

装得上吗

曾在 dsh 0.2.0-rc.2 下真实安装成功，但当前 dsh 已更新至 0.2.1-rc.5，本站尚未在新版下复验

L4 · 真实安装等级说明 →

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

更新放缓：最近一次提交在 80 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

读写/删除本地文件发起外部网络请求

查看扫描证据（共 47 处，展示前 30 条）

写入本地文件
src/file-memory-table.ts:45
mkdirSync(roleRoot, { recursive: true })
读取本地文件
src/file-memory-table.ts:46
for (const roleDir of readdirSync(roleRoot, { withFileTypes: true })) {
写入本地文件
src/file-memory-table.ts:49
mkdirSync(memoryDir, { recursive: true })
读取本地文件
src/file-memory-table.ts:54
try { raw = readFileSync(semanticPath, 'utf8') } catch { raw = readFileSync(legacyPath, 'utf8') }
写入本地文件
src/file-memory-table.ts:67
mkdirSync(roleDir, { recursive: true })
删除本地文件
src/file-memory-table.ts:75
try { unlinkSync(path) } catch { }
写入本地文件
src/file-memory-table.ts:78
writeFileSync(path, JSON.stringify(payload, null, 2) + '\n', 'utf8')
删除本地文件
src/file-memory-table.ts:79
try { unlinkSync(legacyPath) } catch { }
发起网络请求
src/memory-engine/llm.ts:57
const response = await withTimeout(fetch(this.url, {
发起网络请求
src/memory-engine/llm.ts:99
const response = await withTimeout(fetch(this.url, {
写入本地文件
src/memory-engine/store.ts:240
mkdirSync(dirname(dbPath), { recursive: true })
发起网络请求
src/memory.ts:493
const response = await fetch(config.endpoint.replace(/ $/, '') + '/embeddings', {
发起网络请求
src/memory.ts:607
const response = await fetch(config.endpoint.replace(/ $/, '') + '/chat/completions', {
写入本地文件
src/role-files.ts:51
mkdirSync(dir, { recursive: true })
写入本地文件
src/role-files.ts:52
writeFileSync(join(dir, 'role.json'), JSON.stringify(role, null, 2) + '\n', 'utf8')
读取本地文件
src/role-files.ts:67
return readdirSync(root, { withFileTypes: true }).flatMap(entry => {
读取本地文件
src/role-files.ts:72
const value = JSON.parse(readFileSync(join(root, id, 'role.json'), 'utf8')) as Record<string, unknown>
删除本地文件递归
src/role-files.ts:93
rmSync(this.roleDir(roleId), { recursive: true, force: true })
写入本地文件
src/role-files.ts:98
mkdirSync(this.roleDir(roleId), { recursive: true })
写入本地文件
src/role-files.ts:99
mkdirSync(this.memoryDir(roleId), { recursive: true })
读取本地文件
src/role-files.ts:112
return readFileSync(this.selfPath(roleId), 'utf8').trim()
写入本地文件
src/role-files.ts:118
writeFileSync(this.selfPath(roleId), normalizeSelfDocument(content), 'utf8')
读取本地文件
src/role-files.ts:123
return readFileSync(join(this.memoryDir(roleId), 'MEMORY.md'), 'utf8').trim()
写入本地文件
src/role-files.ts:128
writeFileSync(join(this.memoryDir(roleId), 'MEMORY.md'), normalizeMemoryDocument(content), 'utf8')
读取本地文件
src/role-files.ts:133
return pendingBody(readFileSync(this.pendingPath(roleId), 'utf8'))
读取本地文件
src/role-files.ts:138
const raw = readFileSync(this.pendingPath(roleId), 'utf8')
删除本地文件
src/role-files.ts:171
if (existsSync(snapshot)) unlinkSync(snapshot)
删除本地文件
src/role-files.ts:184
unlinkSync(snapshot)
删除本地文件
src/service.ts:804
rmSync(resolveMemoryDbPath(resolveMemoryRoot(this.config.memoryRoot), roleId), { force: true })
删除本地文件
src/service.ts:819
rmSync(join(root, 'attachments', 'v1', 'objects', match[1].slice(0, 2), match[1]), { force: true })

扫描于 2026/11/4（0 天前） · 范围全包扫描（包内未声明入口） · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-agent@deepseek-ai/dsh-llm@deepseek-ai/dsh-attachment@deepseek-ai/dsh-compaction@deepseek-ai/dsh-session@deepseek-ai/dsh-scope@deepseek-ai/dsh-storage-domain@deepseek-ai/dsh-system-prompt@deepseek-ai/dsh-tools@deepseek-ai/dsh-typert-protocol@deepseek-ai/dsh-api-remotes

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

README

由 DeepSeek 最新模型翻译生成

dsh-plugin-shiori-role 面向 DeepSeek Harness 的原生 Shiori 角色插件，提供可编辑角色、会话级身份绑定、角色素材和隔离的持久记忆。功能 - 在设置 -> 插件 -> 角色中管理角色。页面只显示角色卡片和创建卡片；点击角色卡片后，通过弹层编辑名称、简介、System Prompt、头像、立绘和图片素材库。 - 在聊天输入框选择角色。空白会话可以反复切换；第一次组装 System Prompt 时提交选择，已有内容或恢复的会话保持角色不可变。 - 立即预览当前选择的角色。插件通过角色主题 token 和立绘影响侧栏、工作区，不修改用户的浅色、深色或跟随系统偏好。 - 图片统一交给 Harness attachment service 保存。插件 KV 表只保存 ImageAttachmentRef 元数据，不保存 base64 图片。 - 按角色隔离持久记忆，并在已绑定的 Agent scope 中提供 memorize、recall_memory、forget_memory。后端服务、Remote 描述、客户端 slot、样式和主题清理全部位于插件内部，不需要修改 DeepSeek Harness 源码。配置配置中的角色只会作为可编辑种子导入一次。之后的修改和删除会持久化，重启不会重新创建已删除的种子角色。

展开完整文档（README 剩余 1 节）

dsh-plugin-shiori-role

面向 DeepSeek Harness 的原生 Shiori 角色插件，提供可编辑角色、会话级身份绑定、角色素材和隔离的持久记忆。

功能

- 在 设置 -> 插件 -> 角色 中管理角色。页面只显示角色卡片和创建卡片；点击角色卡片后，通过弹层编辑名称、简介、System Prompt、头像、立绘和图片素材库。
- 在聊天输入框选择角色。空白会话可以反复切换；第一次组装 System Prompt 时提交选择，已有内容或恢复的会话保持角色不可变。
- 立即预览当前选择的角色。插件通过角色主题 token 和立绘影响侧栏、工作区，不修改用户的浅色、深色或跟随系统偏好。
- 图片统一交给 Harness attachment service 保存。插件 KV 表只保存 ImageAttachmentRef 元数据，不保存 base64 图片。
- 按角色隔离持久记忆，并在已绑定的 Agent scope 中提供 memorize、recall_memory、forget_memory。

后端服务、Remote 描述、客户端 slot、样式和主题清理全部位于插件内部，不需要修改 DeepSeek Harness 源码。

配置

配置中的角色只会作为可编辑种子导入一次。之后的修改和删除会持久化，重启不会重新创建已删除的种子角色。

- id: shiori-role
name: '@deepseek-ai/dsh-plugin-shiori-role'
config:
roles:
- id: maintainer
name: Shiori Maintainer
introduction: 维护 Shiori 工作区。
prompt: 你是这个工作区的 Shiori 维护者。

本地开发时，可以把仓库作为 profile 的链接依赖安装：

dependencies:
'@deepseek-ai/dsh-plugin-shiori-role': link:D://Coding//dsh-plugin-shiori-role

角色绑定

ShioriRoleService 在 shiori_role storage domain 中保存可编辑角色、素材、工作区默认角色、空白会话的待选角色和不可变的会话绑定。

输入框可以在空白 Agent 创建前暂存角色选择。空白 Agent 在第一次组装 System Prompt 前仍可选择角色；插件会在模型执行前解析并持久化 pending 或工作区角色。会话没有选择角色且工作区也没有默认角色时会完全绕过插件，不注入角色 Prompt、Markdown 记忆上下文或角色记忆工具。已有会话一旦使用角色绑定便保持不可变，非空白会话不会热切换角色。

删除角色会执行物理删除：移除角色记录、所有 session 绑定、素材引用、Markdown 文件和角色独立的 SQLite memory2 数据库；已有会话也不会再恢复该角色。删除空白会话待选角色或工作区默认角色时，可变引用会改到目录中最早的剩余角色，并通过同一个 catalog 变更信号同步刷新所有插件 UI。

如果被删除角色拥有本地内容寻址图片素材，插件会在确认没有其他角色素材引用同一个 sha256: 对象后删除该附件文件。共享对象和非本地附件后端会保留；此 GC 不扫描角色目录之外的消息或 session 历史引用。

素材与主题

素材用途包括 avatar、portrait、gallery 和 theme_background。头像和立绘分别上传；图片二进制通过 ctx.attachments.saveImage/readImage 保存和读取，角色素材表只保存 attachment 引用。

当前会话角色控制输入框中的头像和名称。立绘可以通过插件自有 CSS 和 ctx.theme.overrideTokens 影响工作区与侧栏。插件释放时会清理注入的 stylesheet、主题覆盖、class、CSS 变量和图片 URL。

角色记忆

每个角色拥有隔离的持久记忆作用域，并由所有 DSH workspace 共享。可编辑角色定义保存在 $DSH_HOME/shiori-plugin/role/<role-id>/role.json；完整的角色可读投影位于 $DSH_HOME/shiori-plugin/role/<role-id>/memory/：MEMORY.md 保存长期事实、偏好与明确要求记住的内容，HISTORY.md 追加共同经历，PENDING.md 缓冲长期候选，RECENT_CONTEXT.md 保存最近话题与进行中事项，SELF.md 维护角色自我认知。相邻的 memory2.db 继续负责检索与结构化记忆。

Shiori 语义记忆层不配置 memory 块也会启用。每轮完成后，插件默认通过当前 Agent 的 Harness provider/model 发起一次有上限的独立请求，在回合关闭前抽取长期记忆；可选的 extraction 端点会覆盖这条默认调用。可选的 embedding 端点提供独立向量召回；未配置时检索降级为确定性文本匹配。

- id: shiori-role
name: '@deepseek-ai/dsh-plugin-shiori-role'
config:
roles:
- id: maintainer
name: Shiori Maintainer
introduction: 维护 Shiori 工作区。
prompt: 你是这个工作区的 Shiori 维护者。
memory:
embedding:
endpoint: https://api.openai.com/v1
apiKey: sk-...
model: text-embedding-3-small
extraction:
endpoint: https://api.openai.com/v1
apiKey: sk-...
model: gpt-4o-mini

检索镜像 Shiori memory2 的实现：关键词 lane 保留字面命中，向量 lane 独立按余弦相似度召回（阈值 0.35），两路排名通过 Reciprocal Rank Fusion（1/(60+vec_rank) + 0.5/(60+keyword_rank)）融合，并叠加 hotness 热度分。回合后抽取同样对齐 Shiori：监听 agent/turn-stopping，把该回合的 USER/ASSISTANT 对话交给一次独立且有上限的模型请求，按 Shiori 的长期记忆契约（USER 原话锚点、跨 session 时效性、来源方向、不提取 event）输出 profile / preference / procedure。监听器会等待写入完成再关闭回合；抽取失败只记录日志，不会让已经完成的回复失败。变化后的记忆由 Harness 追加为 runtime-context 快照，保留此前可复用的请求 prefix。

记忆存储使用角色独立的 SQLite（<memoryRoot>/shiori-plugin/role/<role-id>/memory/memory2.db，Node 内置 node:sqlite，零依赖）：显式 memorize 走 content-hash 查重与强化；写入时对语义高度相似的旧条目自动退休（preference/profile 相似度 ≥ 0.90，高情绪 profile 为 0.92），同 tool_requirement 的 procedure 规则自动合并。Harness 成功压缩后，插件按照 shadowedSeqs 精确读取被压缩窗口，并按角色串行维护：追加 history_entries 与 pending_items，快照 PENDING.md，立即合并到 MEMORY.md，用同一批候选更新 SELF.md，生成 RECENT_CONTEXT.md，最后提交快照；optimizer 失败会回滚快照。SQLite 使用稳定的逐条 source ref 保存对应 event 和长期候选，并在整条流程成功后记录 compaction source ref，使重复投递直接跳过。SELF.md、MEMORY.md 与 RECENT_CONTEXT.md 的精简部分会注入角色上下文；PENDING.md 不注入，HISTORY.md 只作为可维护时间线。

当前版本不宣称与 Shiori default_memory 完全等价。现已实现确定性文本检索、embedding 语义检索与混合 RRF 排序、精确重复强化、语义 supersede/merge、显式记忆工具、回合后自动抽取、compaction 驱动的 Markdown consolidation、即时角色 optimizer 和 prompt 注入；HyDE、query 改写、定时 optimizer、journal 投影与后台 ingest 尚未实现。

开发验证

D:\Coding\deepseek-harness\node_modules\.bin\tsc.cmd --noEmit --project tsconfig.json
node --import file:///D:/Coding/deepseek-harness/node_modules/tsx/dist/esm/index.mjs --test test/*.test.ts
D:\Coding\deepseek-harness\node_modules\.bin\tsc.cmd --project tsconfig.json
D:\Coding\deepseek-harness\node_modules\.bin\tsdown.cmd --config tsdown.config.ts