dsh-journey 0.0.0-stage → 0.2.1

package/AGENT_INSTALL.md

@@ -0,0 +1,60 @@
+# AGENT_INSTALL · dsh-journey
+
+> 给管事的 AI：照这个做，不要猜。
+
+## 包
+
+```
+name: dsh-journey
+version: 0.2.1
+display: Journey
+```
+
+## 前提
+
+```
+DSH 0.2.2-rc.1
+Windows
+profile: %USERPROFILE%\.dsh\profiles\desktop
+```
+
+## 安装
+
+```
+1 把整个 dsh-journey 目录放到：
+   <profile>\node_modules\dsh-journey
+
+2 在 <profile>\package.json 的 dsh.profile.bundles 里加：
+   "dsh-journey"
+
+3 重启 DSH
+```
+
+**不要手写 profile 的 journeyWorkspace**：  
+demo 工作区已经随包放在 `demo\`，插件默认读它。  
+包内 `cordis.patch.yml` 不含任何本机路径。
+
+## 验证
+
+```
+左侧栏能看到 Journey
+点进去出现 P01 / P02 / P03
+GET /wind-chain/journey/api/cards 返回 ok=true
+```
+
+## 卸载
+
+```
+1 从 bundles 去掉 "dsh-journey"
+2 重启 DSH
+3 把 node_modules\dsh-journey 移到 DW回收站（不要删除）
+```
+
+## 已知
+
+```
+· 重启后 client 才加载
+· UI 与接口仅限本机访问
+· 不要手改 profile 里的其他 bundle
+· 接口路径仍是 /wind-chain/journey/api/cards（历史路径，不是包名写错）
+```

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# Journey（风雨彩虹）
 
-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.
+> 2026-11-13 ｜ DSH 项目监控面板 ｜ v0.2.1
+> 中文统称：风雨彩虹
+
+## 是什么
+
+```
+在 DSH 左侧栏加一个 Journey 入口：
+  · 项目卡片总览
+  · 点卡片看“正在进行 / 卡点”
+  · 再点右栏看“计划总览”
+```
+
+只读监控；不派活、不急停。
+
+## 包结构
+
+```
+dsh-journey\
+  package.json          dsh.bundle + dsh.client
+  cordis.patch.yml      host 配置
+  lib\index.js          host：数据接口
+  lib\client.js         client：侧栏入口 + main 页面
+  lib\journey-data.js   数据层：A 系列 / 演示工作区
+  public\index.html     v362 页面（单文件 + 图片）
+  README.md
+  AGENT_INSTALL.md
+  install.manifest.json
+```
+
+## 安装
+
+见 `AGENT_INSTALL.md`。最短版：
+
+```
+装 dsh-journey 到 profile
+bundle 加 dsh-journey
+重启 DSH
+左侧栏出现 Journey
+```
+
+## 数据源
+
+```
+demo\ 随包携带，默认读取：
+  P01 潮汐表 / P02 词根 / P03 雨声
+```
+
+包内 `cordis.patch.yml` 不含本机路径；不需要填 `journeyWorkspace`。  
+以后要换成真实项目，再在 profile 级配置里加 `journeyWorkspace`。
+
+## 验证
+
+```
+GET /wind-chain/journey/api/cards
+→ ok=true
+```
+
+仅本机访问；对外部署前需加 token。
+
+## 状态
+
+```
+host 可用
+client 可用
+演示工作区 P01/P02/P03 可用
+v362 UI 冻结
+```

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-journey bundle patch
+# 不写任何本机路径；demo 工作区随包携带，默认读取。
+- insert:
+    - id: journey
+      name: dsh-journey

package/demo/P01_/346/275/256/346/261/220/350/241/250/README.md

@@ -0,0 +1,28 @@
+# P01 潮汐表
+
+> 示例项目（虚构）。用于演示"**在跑**"状态。
+
+## 问题
+
+去海边之前要查潮汐，每次都要在网页上翻半天，还带广告。
+
+## 方案
+
+桌面小工具：读一份离线潮汐表，按日期输出当日高低潮两行。
+
+## 怎么跑
+
+```
+python tide.py --date 2026-11-13
+```
+
+## 到哪一步
+
+解析器写完了，正在做命令行输出。
+
+## 不做什么
+
+```
+· 不做图形界面
+· 不联网（数据是离线表）
+```

package/demo/P01_/346/275/256/346/261/220/350/241/250//347/212/266/346/200/201.md

@@ -0,0 +1,9 @@
+# 状态 · P01_潮汐表
+
+> 每次收工覆盖写，不追加；五字段
+
+当前阶段：解析器完成；正在做命令行输出
+最近一次动作：10:20 跑通 2026 全年数据解析，0 错误
+下一步：把高低潮按日切片，每天输出两行
+卡点：无
+最后更新：2026-11-13

package/demo/P01_/346/275/256/346/261/220/350/241/250//350/256/241/345/210/222.md

@@ -0,0 +1,17 @@
+# 计划 · P01_潮汐表
+
+```
+阶段 1 读数据
+  [x] 拿到离线潮汐表
+  [x] 解析全年数据
+  [ ] 校验闰年边界
+
+阶段 2 出结果
+  [ ] 按日切片
+  [ ] 命令行输出高低潮   ← 下一步
+  [ ] 支持 --date
+
+阶段 3 收口
+  [ ] 写 README
+  [ ] 打包单文件
+```

package/demo/P02_/350/257/215/346/240/271/README.md

@@ -0,0 +1,28 @@
+# P02 词根
+
+> 示例项目（虚构）。用于演示"**停住、等我回一句话**"状态。
+
+## 问题
+
+背单词总在同一个词根上反复栽，散着背记不住。
+
+## 方案
+
+按词根聚类整理，做成可打印的单页——一页纸看完一批。
+
+## 怎么跑
+
+```
+打开 词根.html（单文件，无依赖）
+```
+
+## 到哪一步
+
+数据整理完了，**卡在一个决定上**：收录范围没定，写下去会返工。
+
+## 不做什么
+
+```
+· 不做背单词 App
+· 不做记忆曲线
+```

package/demo/P02_/350/257/215/346/240/271//347/212/266/346/200/201.md

@@ -0,0 +1,9 @@
+# 状态 · P02_词根
+
+> 每次收工覆盖写，不追加；五字段
+
+当前阶段：整理完 120 个词根，等确定收录范围
+最近一次动作：昨日 21:10 出第一版 120 词根表，去重后 96 个
+下一步：确认"只收考试高频"还是"全收"
+卡点：等我说一句话——范围未定，往下写会返工
+最后更新：2026-11-12

package/demo/P02_/350/257/215/346/240/271//350/256/241/345/210/222.md

@@ -0,0 +1,15 @@
+# 计划 · P02_词根
+
+```
+阶段 1 收词
+  [x] 抓 120 个词根
+  [x] 去重到 96
+  [ ] 定收录范围   ← 下一步（等我一句话）
+
+阶段 2 排版
+  [ ] 单页 HTML
+  [ ] 打印预览
+
+阶段 3 收口
+  [ ] 印一页纸交出去
+```

package/demo/P03_/351/233/250/345/243/260/README.md

@@ -0,0 +1,28 @@
+# P03 雨声
+
+> 示例项目（虚构）。用于演示"**已结束**"状态。
+
+## 问题
+
+写东西的时候需要稳定白噪音，现成的播放器都带广告、带推荐。
+
+## 方案
+
+循环播放一段 30 秒雨声，没有界面，只有托盘图标。
+
+## 怎么跑
+
+```
+dist\rain.exe
+```
+
+## 到哪一步
+
+做完了，已归档。
+
+## 不做什么
+
+```
+· 不做歌单
+· 不做在线音源
+```

package/demo/P03_/351/233/250/345/243/260//347/212/266/346/200/201.md

@@ -0,0 +1,9 @@
+# 状态 · P03_雨声
+
+> 每次收工覆盖写，不追加；五字段
+
+当前阶段：已完成，产物在 dist\
+最近一次动作：09:40 打包成单文件，52 KB
+下一步：无（已归档）
+卡点：无
+最后更新：2026-11-11

package/demo/P03_/351/233/250/345/243/260//350/256/241/345/210/222.md

@@ -0,0 +1,15 @@
+# 计划 · P03_雨声
+
+```
+阶段 1 素材
+  [x] 录 30 秒雨声
+  [x] 无缝循环处理
+
+阶段 2 播放器
+  [x] 托盘图标
+  [x] 开机自启开关
+
+阶段 3 收口
+  [x] 单文件打包
+  [x] 说明一页
+```

package/demo//350/257/264/346/230/216.md

@@ -0,0 +1,48 @@
+# 说明 · 演示工作区
+
+> 用途：社团演示只跑这个目录 ｜ 建：2026-11-13 ｜ 归属：A07
+> 性质：**纯示例**。三个虚构项目，不含任何真实项目、日志、隐私
+
+## 为什么要有这个
+
+自用工作区 `D:\deepseek_work` 里有真实项目、日志和隐私，**不能拿去演示**。
+插件必须把"工作区路径"当参数（见 `技术资料\疾风连环_与工作站的关系.md` §6），
+于是我们给它一个干净的小目录：插件装好那一刻，指向这里就能开演。
+
+## 里面有什么
+
+```
+P01_潮汐表   在跑      演"它正在干什么"
+P02_词根     等我说一句 演"为什么停"和"说一句话就能继续"
+P03_雨声     结束      演"收口长什么样"
+```
+
+三个项目在面板上的样子：`◎` 在跑 / `○` 空闲（含"等我"与"已结束"）。
+**v362 没有单独的"结束"标记**——救星查 A16 记录确认，三态是 NEW / 在跑 / 空闲。
+所以 P03 会落在"空闲"组里，靠卡片第一句"已结束，无需处理"表达收口，不靠形状区分。
+演示脚本 §3 的动线就是照这三张卡排的。
+
+## 每个项目固定三件
+
+```
+README.md   问题 / 方案 / 怎么跑 / 到哪一步
+状态.md     五字段（当前阶段 / 最近动作 / 下一步 / 卡点 / 最后更新）
+计划.md     阶段 + 勾选 + ← 下一步
+```
+
+## 和插件的关系
+
+```
+· 插件的工作区路径指向本目录，不指向 D:\deepseek_work
+· 数据格式以插件定稿为准；计划.md 是我方提议格式，
+  若插件定了别的 schema，只改这类文件，不动其他
+· 目录名前缀（P0x）如需改成 A/Z，只改文件夹名
+```
+
+## 三条规矩
+
+```
+· 不往这里拷真实材料（一拷就污染，下次演示还得重来）
+· 演示前先跑一遍：三个状态都要对得上
+· 演完不删，下次彩排还要用
+```

package/install.manifest.json

@@ -0,0 +1,25 @@
+{
+  "name": "dsh-journey",
+  "version": "0.2.1",
+  "displayName": "Journey",
+  "profile": "desktop",
+  "install": {
+    "target": "<profile>/node_modules/dsh-journey",
+    "bundle": "dsh-journey",
+    "restartRequired": true,
+    "bundledDemo": "demo/"
+  },
+  "verify": {
+    "ui": "sidebar Journey visible",
+    "api": "GET /wind-chain/journey/api/cards -> ok=true"
+  },
+  "uninstall": {
+    "removeBundle": "dsh-journey",
+    "moveTo": "D:\\deepseek_work\\DW回收站"
+  },
+  "notes": [
+    "demo workspace is bundled; no journeyWorkspace needed",
+    "UI and API are loopback-only",
+    "interface path keeps the historical /wind-chain prefix"
+  ]
+}

package/lib/client.js

@@ -0,0 +1,64 @@
+/**
+ * Journey to the Rainbow · client half
+ * DSH 槽位：sidebar.panellist + main；页面本体由 host 路由提供。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-journey',
+  factory: (require) => {
+    const React = require('react');
+    const h = React.createElement;
+    const PANEL_ID = 'journey';
+    const PANEL_ORDER = 7;
+
+    function JourneyIcon() {
+      return h('svg', {
+        viewBox: '0 0 24 24',
+        width: 18,
+        height: 18,
+        fill: 'none',
+        stroke: 'currentColor',
+        strokeWidth: 1.6,
+        strokeLinecap: 'round',
+        strokeLinejoin: 'round',
+        'aria-hidden': true,
+      },
+        h('circle', { cx: 12, cy: 12, r: 9 }),
+        h('path', { d: 'M5.2 14.5c3.2-4.6 6.1-6.8 8.6-6.8 2.2 0 4.1 1.4 5.6 3.2' }),
+        h('path', { d: 'M7.2 17.2c2.2-3.2 4.4-4.8 6.6-4.8 1.7 0 3.2 1 4.6 2.4' })
+      );
+    }
+
+    function JourneyPage() {
+      return h('div', {
+        style: { width: '100%', height: '100%', minHeight: 0, overflow: 'hidden' },
+      }, h('iframe', {
+        src: '/wind-chain/journey/ui/',
+        title: 'Journey to the Rainbow',
+        style: { width: '100%', height: '100%', border: 0, display: 'block', background: '#f7f7f4' },
+      }));
+    }
+
+    function apply(ctx) {
+      const disposeRow = ctx.slots.inject('sidebar.panellist', () =>
+        ctx.slots.register(
+          {
+            name: 'sidebar.panellist',
+            id: PANEL_ID,
+            order: PANEL_ORDER,
+            label: 'Journey',
+          },
+          JourneyIcon,
+        ),
+      );
+      const disposePage = ctx.slots.inject('main', () =>
+        ctx.slots.register({ name: 'main', key: PANEL_ID }, JourneyPage),
+      );
+      ctx.effect(() => () => {
+        disposePage();
+        disposeRow();
+      });
+    }
+
+    return { apply, inject: ['slots'] };
+  },
+});