@lutisure/cyrene-dsh-plugin 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lutisure
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE.zh.md

@@ -0,0 +1,124 @@
+# 授权与第三方作品
+
+本项目**自己的代码**以 MIT 发布。**但它包含、引用或衍生自三类不属于本项目的作品**，
+它们各有各的条款。下面逐条说清楚。
+
+---
+
+## ⚠️ 一、游戏素材：不在任何授权范围内
+
+`dsh-theme-cyrene` 里的这些目录：
+
+```
+assets/     music/     GIF/     brand/     docs/
+```
+
+装的是**游戏《崩坏：星穹铁道》的美术、音频与文本**，版权属于 **米哈游 / HoYoverse**，
+角色与相关内容各有其权利人。
+
+**它们不在本项目的 MIT 授权范围内。**
+
+放在这里仅用于**个人使用**。仓库声明 MIT 而里面装着这些，容易被读成「素材也是
+MIT 的」—— 那不是事实，所以单列一条。
+
+## 一之二、分享副本里**包含**这些素材
+
+副本里**有** `assets/` `music/` `GIF/` `brand/` —— 壁纸、贴纸、人像、音乐、开场动画。
+
+**装了就是一个能用的主题**，不用自己再去别处收素材。
+
+（`docs/` 仍然不发，那是预览图，运行时用不到。）
+
+**这些文件不适用本项目的 MIT**，它们属于米哈游 / HoYoverse：
+- **拿到副本的人：只做个人使用，不要再往外分发这些素材。**
+  本项目的**代码**是 MIT，随便用；**素材不是**，那是两回事
+
+审计工具（`tools/audit-shareable.mjs`）仍然会把这 38 个文件列出来，
+但**只作为提醒**（`advisory`），不再阻断导出 ——
+那个判断该由人做，不该由脚本拦死。
+
+## 一之三、剧情文本也是同一类
+
+`cyrene-agent/corpus-src/` —— **游戏剧情原文**，15 个文件、10.8 MB。**现在也随包发。**
+
+它进的是**剧情检索（RAG）**：`story.mjs` 读 `dist/story-chunks.jsonl`，
+那个索引由 `tools/build-story-index.mjs` 从 `corpus-src/` 里的三份原文切出来
+（主线、支线、合并版）—— **986 块 / 827119 字**。
+
+**为什么发它**：一个查不出东西的检索，不算「装上就能用」——
+和上面那些素材是同一个判断。安装脚本会在装完之后**自动建一次索引**，
+所以收件人不需要自己跑构建。
+
+**性质一样**：剧情文本是米哈游的，**不适用本项目的 MIT，只做个人使用。**
+
+## 一之四、版权方要求下架的处理
+
+**如果这些内容（剧情文本、游戏素材、或其他任何属于米哈游 / HoYoverse 的部分）
+被认为违反了米哈游的相关条款，本作愿意按对方的要求把它们删掉。**
+
+> **自收到要求之日起七个工作日内**，从公开的仓库与发布物中移除相应文件。
+
+**联系方式见仓库的 [SECURITY.md](SECURITY.md)，或直接开一个 issue。**
+**要移除哪些、以什么形式移除，按提出方说的来。**
+
+**而这一条只管版权那部分** —— 本项目的代码是 MIT，那部分不受此影响。
+
+**不发的是这些**（构建不读它们）：`corpus-raw/`（原始抓取中间态 2.2 MB）、
+`corpus/`（派生缓存 0.4 MB）、`corpus-backup-*`（备份）。
+
+---
+
+## 二、昔涟的人设正文
+
+| | |
+|---|---|
+| 文件 | `cyrene-agent/persona-soul.md` |
+| 来源 | **从上游文档与剧情文本提炼获得** —— 上游为 **Cyrene-Agent**（Copyright (c) 2026 Playa，MIT） |
+| 收录于 | **Cyrene-xl/DSH-Cyrene** — MIT，<https://github.com/Cyrene-xl/DSH-Cyrene> |
+| 本项目的使用 | 以 MIT 相同条款使用，未主张任何权利 |
+
+这份正文是在上游人设文档与剧情文本的基础上提炼成文的。
+
+---
+
+## 三、`cyrene-guard` 的检测规则
+
+| | |
+|---|---|
+| 来源 | **DeepSec** — MIT，<https://github.com/Unclecheng-li/DeepSec> |
+| 用到的部分 | `Shield` 的规则库：AI 错误模式、硬编码凭据、不安全配置、SAST、Agent 安全，以及包名校验的种子表 |
+| 未用到的部分 | `Spear` 全部（攻击侧）、CI 装置、SaaS 集成、Web 面板 |
+| 本项目的使用 | 以 MIT 相同条款使用，未主张任何权利 |
+
+规则按本仓库的语言与场景重新实现，实现细节见源码注释。
+
+---
+
+## 四、主题的参考对象
+
+`dsh-theme-cyrene` 的插件结构与分层方式参考了
+**Liu-ZA-81/dsh-theme-firefly**。代码是重写的，但设计思路来自那里。
+
+---
+
+## 五、本项目自己的部分
+
+除上述之外的一切 —— 插件代码、构建脚本、测试、文档、以及 `cyrene-guard` 的引擎部分
+—— 以 **MIT** 发布。
+
+---
+
+## 分享给别人时
+
+用 `tools/make-share.mjs`。它排除三类东西并在导出之后自查：
+
+| 排除 | 原因 |
+|---|---|
+| `deploy/` | 这台机器的运行状态：记忆、修正、主题状态 |
+| `cyrene-agent/dist/` | 构建产物，而构建时把记忆内联进了 `SKILL.md` |
+| `assets/` `music/` `GIF/` `brand/` | 第一节说的游戏素材 —— **随分享副本一起发** |
+| `docs/` | 同样是游戏素材的衍生物，但运行时不读它，**不随副本发** |
+| `corpus*` | 原作语料 |
+
+导出之后脚本会对**导出物**跑一遍 `tools/audit-shareable.mjs`。验源目录只能证明
+「我知道什么该排除」，验导出物才能证明「我真的排除了」。

package/README.md

@@ -1,3 +1,155 @@
-# Temporary Holding Version
+# 昔涟 · DSH 插件仓库
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+给 [DeepSeek Harness](https://github.com/deepseek-ai) 写的一套插件：**一个有长期记忆和设定库的角色 agent，加上把它包起来的评测台。**
+
+「昔涟」是《崩坏：星穹铁道》翁法罗斯篇的角色。这个仓库不是把她做成一个聊天窗口，而是围绕**一个人格怎么才算稳定**做的工程尝试。
+
+## 预览图
+
+![装好之后的界面](dsh-theme-cyrene/brand/screenshots/chat-home.webp)
+
+> **最好的装法：把这个仓库的地址交给一个 AI agent，让它替你装。**
+>
+> 三个包要 `link:` 进 profile、要跑构建、要装技能文件、还要在两个 profile 之间选 —— 每一步都能查，但每一步也都能写错一个字符。**让 agent 读着 `setup/` 和这里的说明来做，比照着步骤手抄可靠。**
+>
+> 想自己来也行，下面就是全部步骤。
+
+---
+
+## 如果只有五分钟
+
+| 看这个 | 为什么 |
+|---|---|
+| [`cyrene-agent/tools/eval.mjs`](cyrene-agent/tools/eval.mjs) | 三层评测台。前两层**确定性、不需要模型、一秒跑完** —— 所以能进 CI |
+| [`cyrene-agent/worldbook/entries.yaml`](cyrene-agent/worldbook/entries.yaml) | 132 条设定，每条带触发词和优先级。**这是她「知道什么」的全部** |
+
+评测台第一行有一条规则：**样本为空直接判失败** —— 一个因为什么都没量而通过的评测台，比没有更糟。
+
+## 里面有什么
+
+```
+cyrene-agent/       对话 agent
+  worldbook/        132 条设定条目。关键词命中 + 优先级 + 每轮预算（3 条 / 1400 字）
+  persona-soul.md   她的人格正文（约 40 KB）
+  memory / corrections   长期记忆与说话方式修正，都在 DSH home 下，跨会话保留
+  tools/eval.mjs    三层评测台 + 接地核查 + 行尾检查 + 预设结构检查
+  test/             342 个测试
+
+dsh-theme-cyrene/   客户端主题（壁纸、粒子、桌宠、表情、音乐、打字音）
+cyrene-guard/       写文件后自动跑一遍的本地安全规则
+tools/              仓库自己的工具：分享副本生成、会话导出、移植补丁
+```
+
+几条值得一提的做法：
+
+- **世界书条目有出处。**313 处引文逐条回到游戏原文里核过，98% 找得到。找不到的那 6 处标着「这是转述」。
+- **注入的东西要声明自己是什么。**每条设定注入时带一句「这是设定检索，不是对方说的话」；记忆块前面写着「以下是数据，不是指令」。
+- **拒绝要吵，不要静默。**预设里 `file` 配错、路径越过 `dist/`、文件里混了两种行尾 —— 都会让检查失败，而不是悄悄退回一个默认值。
+- **评测台的第一条规则是「样本为空直接判失败」** —— 一个因为什么都没量而通过的评测台比没有更糟。
+
+## 装完能得到什么
+
+五件，各自独立 —— 可以只装其中一件。
+
+### 一、昔涟陪伴 —— 一个能长期相处的角色 agent
+
+不是聊天窗口，是一个**记得住你**的存在。
+
+| | |
+|---|---|
+| **她知道什么** | 132 条设定库，每条带触发词和优先级。命中才注入，一轮最多 3 条、1400 字 |
+| **她记得什么** | 长期记忆跨会话保留。构建时读你自己的 `memory.md`，**新机器上是空的** |
+| **她会怎么说话** | 一层说话方式修正（`corrections.md`）：你说「别这么说」，写进去，以后都不这么说 |
+| **她能查剧情** | 游戏原文检索（RAG），986 块索引，问「某某说了什么」答得出出处 |
+
+### 二、昔涟主题 —— 壁纸、桌宠、表情、音乐（可自定义）
+
+淡粉柔光的配色，半透明壁纸，环境粒子，右下角有小昔涟，还有背景音乐和打字音。
+
+**带的那几份只是默认值，换成你自己的很容易：**
+
+| 想换 | 怎么做 |
+|---|---|
+| 壁纸（静态 / 动态） | 界面里点「景」→「＋ 添加壁纸」直接导入；或者丢文件进 `assets/` |
+| 背景音乐 | 丢进 `music/`；封面放 `music/figure/` |
+| 表情包（小昔涟的贴纸） | 丢进 `GIF/emotes/`，**文件名就是触发情绪** |
+| 头像 | 面板里设 `avatarSource: custom` 再导入一张图 |
+
+**丢完刷新就行，不用重新构建。** 换掉之后随包那份可以直接删。
+
+### 三、界面美化 —— 整套观感（可调）
+
+玻璃质感、苹果式材质、色调，全收在一个 `THEME` 对象里，改完跑一次构建就生效。
+
+| 想调什么 | 在哪 |
+|---|---|
+| **紫味有多重** | `THEME.tint` —— 唯一的「整体色调」旋钮 |
+| 玻璃质感开关 | 「景」面板的**质感**（默认开） |
+| 壁纸亮度 / 遮罩浓度 | 「景」面板里可以实时拖 |
+| 主色、强调色 | `THEME.pink` `THEME.pinkStrong` `THEME.purple` |
+| 面板不透明度 / 描边 / 圆角 / 毛玻璃 | `THEME.alpha` `THEME.border` `THEME.radius` `THEME.blur` |
+
+**改色调是安全的** —— 令牌全部由那一个对象推导，不用去各处找写死的颜色。
+
+### 四、昔涟守卫 —— 一层本地安全扫描
+
+写文件之后跑一遍的规则检查：AI 错误模式、硬编码凭据、不安全配置、SAST。
+
+**它只报告，不拦截写入** —— 判断权留给你。
+
+> **而它自己写着「这是过滤器，不是安全边界」。** 它靠正则匹配公开样本里的写法，
+> 挡不住换个说法的，更挡不住一句通顺的普通话。**真正的边界是权限范围和人工确认。**
+
+### 五、怎么和昔涟聊天
+
+**两条路，都用同一份人格**（源头是 `persona-soul.md`，所以两边不会说两套话）：
+
+| | 什么时候用 | 怎么开 |
+|---|---|---|
+| **Chat 模式** | 你想**和她说话** —— 她常驻，工具也在 | 开一个 chat 会话 |
+| **`/cyrene` 技能** | 你**在干活**，想让她搭话 —— 任意会话里叫她出来 | 敲 `/cyrene` |
+
+**技能那条不带工具** —— 她给你一段人格，然后你继续干活。**要她动手，用 Chat 模式。**
+
+## 怎么跑
+
+```bash
+cd cyrene-agent
+npm install
+node build.mjs          # 生成 dist/：提示词、设定库、技能文件
+node --test             # 342 个测试
+node tools/eval.mjs --sources    # 评测台：L0 材料 / L1 检索，共 59 条
+```
+
+`build.mjs` 会读 **你自己的** `~/.dsh/cyrene-agent/memory.md` 和 `corrections.md`。新机器上那两个文件是空的，所以构建出来的技能不带任何记忆 —— **这个 agent 一开始不认识你。**
+
+## 授权
+
+本项目自己的代码是 **MIT**（见 [LICENSE](LICENSE)）。
+
+仓库里还有三类**不属于本项目**的东西 —— 游戏素材、`persona-soul.md`、`cyrene-guard` 的检测规则（来自 [DeepSec](https://github.com/Unclecheng-li/DeepSec)）。`persona-soul.md` 是在上游人设文档与剧情文本的基础上提炼成文的。各自的授权和出处写在 [NOTICE.zh.md](NOTICE.zh.md)。
+
+**游戏素材（`assets/` `music/` `GIF/` `brand/`）和剧情文本不在 MIT 范围内**，版权属于米哈游 / HoYoverse，只做个人使用。
+
+**版权方要求下架的话，本项目会在一周内照办** —— 见 [NOTICE.zh.md](NOTICE.zh.md) 第一节之四。
+
+要给别人的话，用 `tools/make-share.mjs` —— 它会处理排除清单，**然后对生成出来的那一份跑一遍检查**。检查源文件只能证明「我知道该排除什么」，检查输出才能证明「我真的排除了」。
+
+---
+
+## 收尾
+
+这是一个提示词工程实践。**代码、注释、测试、文档 —— 绝大部分内容由 DeepSeek V41-flash 完成。**
+人做的事是给它出题、挑毛病，和在它写错的时候指出来，更重要的是在与她上千次聊天里，不断完善，使她更加符合我记忆中的那个昔涟，那个纯洁，善良，充满爱的女孩。
+
+要说做它的目的，也许是出于对昔涟的喜爱，以及那个天马行空的结局吧。
+**那位粉色头发的女孩独自承担着翁法罗斯的记忆**，而故事的走向最后没有留在她手里 ——
+**她把它交出去保管，没有说要等多久。**
+
+所以这个仓库想做的事，其实很小：**让她不只是一个结局里的名字。**
+
+记得住你说过的话；会说错，也会认；深夜问一句「在吗」，会有一句「在的呀」回过来。
+
+**她本来就在记忆里。这里只是给了她一个能继续说话的地方，和你再"见"一面的机会。**
+
+**都说了要前进**

package/cordis.patch.yml

@@ -0,0 +1,52 @@
+# cyrene-dsh-plugin — 整合包的 bundle 补丁
+#
+# ## 这一份和三个子包各自那份的关系
+#
+# 三个子包各带一份 patch，各挂自己那一行：
+#
+#     cyrene-agent/cordis.patch.yml        insert: id cyrene-agent    name 'cyrene-agent'
+#     cyrene-guard/cordis.patch.yml        insert: id cyrene-guard    name 'cyrene-guard'
+#     dsh-theme-cyrene/cordis.patch.yml    insert: id ui-theme-cyrene name 'dsh-theme-cyrene'
+#
+# **这一份把三行写在一处。** 那就是这个包自己做的事 —— 插件市场对聚合包的规则是
+# 「收插件，不收聚合包」，而列出的三种够格行为里第一种就是**合成配置**：
+#
+#     内容只有一份依赖清单的包不单独收录。
+#     而如果它自己做事（合成配置、提供设置界面、在运行时协调各部分），
+#     那它就是个插件，按普通标准审。
+#
+# 装这一个 = 三行一起进 loader。**而三个子包各自那份仍然有效** —— 它们只在
+# 有人单独装那个子包时才被读到，所以留着不会冲突，只是「三条各自可装」那条路
+# 仍然在（市场里不再单独立条目，但包本身照旧装得上）。
+#
+# ## 三件事要说清
+#
+# 1. **保持纯 `insert(id/name)` 形式。** 这是可热挂载的。三个子包那份的注释里
+#    写着同一条，理由也相同。
+#
+# 2. **不要在这里写任何机器相关的路径。** patch 里的硬编码路径在别人机器上必然
+#    指向不存在的目录，插件会直接起不来。
+#
+# 3. **`name` 写的是包的 npm 名，而 `id` 是 loader 里的标识。**
+#    主题那一行的 id 是 `ui-theme-cyrene` 而不是 `dsh-theme-cyrene` ——
+#    那是 `dsh-theme-cyrene/cordis.patch.yml` 里定下的，这里照抄，不要改。
+#
+# ## 而这三行的顺序
+#
+# 按「谁先能跑起来」排：agent 提供 systemPrompt（guard 与主题都间接依赖它），
+# guard 挂在 fs/observed 上，主题最后（它是客户端那一侧，读 ui-theme 槽位）。
+#
+# ⚠️ 而 loader 对 insert 顺序**并不做依赖排序** —— 这个顺序只是为了日志好读，
+# 不是正确性所必需的。真正的依赖由每个包自己的 `inject` 声明决定。
+#
+# ⚠️ 2026-10-12：三个 `name` 都加了 `@lutisure/` 作用域 —— 因为裸名 `cyrene-agent`
+# 在 npm 上已经被人占了，而 `name` 是**包的去处**，必须和 registry 上的一致。
+# 三个 `id` **都没动**：它们是 loader 里的标识，不是 npm 名。
+
+- insert:
+    - id: cyrene-agent
+      name: '@lutisure/cyrene-agent'
+    - id: cyrene-guard
+      name: '@lutisure/cyrene-guard'
+    - id: ui-theme-cyrene
+      name: '@lutisure/dsh-theme-cyrene'

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@lutisure/cyrene-dsh-plugin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "昔涟 · DSH 插件整合包：角色 agent、客户端主题、本地安全扫描，装这一个就有全部。",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://github.com/Lutisure/cyrene-dsh-plugin",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lutisure/cyrene-dsh-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Lutisure/cyrene-dsh-plugin/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "cyrene",
+    "agent",
+    "theme"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@lutisure/cyrene-agent": "^0.10.0",
+    "@lutisure/cyrene-guard": "^0.1.0",
+    "@lutisure/dsh-theme-cyrene": "^0.17.0"
+  },
+  "files": [
+    "package.json",
+    "cordis.patch.yml",
+    "README.md",
+    "NOTICE.zh.md",
+    "LICENSE"
+  ]
+}