dsh-session-history 0.2.5 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -88,6 +88,7 @@ dsh plugin --profile desktop add dsh-session-history
88
88
  所有 agent 读的是同一份 `~/.session-history/SKILL.md`,由插件自动生成,手改会被覆盖。
89
89
 
90
90
  - **通用部分**(每个人都一样):怎么检索(先找会话,再有限度地读原文,必要时查原始记录)、查询怎么写、一次回忆读多少、证据纪律。
91
+ - **一次回忆是一轮检索**:可以包含搜索、收窄与读取原文,通常合计控制在 3000 字符内;原文示例使用 `--budget 2000`,按剩余预算调整。索引故障时,兜底命令搜索日志目录内各来源、全部日期的 `*-log.md`。
91
92
  - **按你的电脑生成的部分**:列出的 agent 名单(检测到的,以及只剩旧日志的)、入口的实际路径(Windows 上同时给出 PowerShell/cmd 与 Git Bash 两种写法)、`--agent` 可选的名字、是否提 Claude Code 记忆提示、Pi 的分支说明、检索前补整理的时长,以及兜底搜索用的日志路径。
92
93
  - **什么时候更新**:插件启动时、每次整理之后(定时、检索前补整理、立即整理都算)、打开插件页时、改设置或增删 agent 时。内容没变就不写盘。建软链不会改它——软链只决定哪些 agent 能读到这份文件。
93
94
 
@@ -189,7 +190,7 @@ session-history refresh | status | setup | link all | unlink claude | config
189
190
  Git 子目录地址(不提供原生更新检查):
190
191
 
191
192
  ```text
192
- git+https://github.com/fujingzhai/youxia-dsh-plugins.git#dsh-session-history@0.2.5&path:/dsh-session-history
193
+ git+https://github.com/fujingzhai/youxia-dsh-plugins.git#dsh-session-history@0.2.6&path:/dsh-session-history
193
194
  ```
194
195
 
195
196
  ## 兼容与限制
package/lib/skill.js CHANGED
@@ -53,6 +53,8 @@ export function skillMarkdown(home, { config = loadConfig(home), platform = proc
53
53
  const names = active.map(s => s.name);
54
54
  const has = id => active.some(s => s.id === id);
55
55
  const first = active[0]?.folder || folders[0] || 'Claude';
56
+ const logs = layout(home).logs;
57
+ const fallbackRoot = platform === 'win32' ? `"${logs.replaceAll('\\', '/')}"` : shq(logs);
56
58
  const scope = names.length
57
59
  ? `${list(names)}${legacy.length ? `,以及已停用的 ${list(legacy)}(旧日志照常检索)` : ''}`
58
60
  : legacy.length ? `已停用的 ${list(legacy)}(只剩旧日志)` : '各 agent(尚未检测到会话来源)';
@@ -60,7 +62,7 @@ export function skillMarkdown(home, { config = loadConfig(home), platform = proc
60
62
  const lines = [
61
63
  '---',
62
64
  `name: ${SKILL_NAME}`,
63
- `description: 查各 agent(${list(names.length ? names : legacy) || '各家'})的历史对话。用户提起过往,或提到你不清楚来由的事时使用;上下文和记忆里能找到就不查,同一件事每个会话最多查一次。`,
65
+ `description: 查各 agent(${list(names.length ? names : legacy) || '各家'})的历史对话。用户提起过往,或提到你不清楚来由的事时使用;上下文和记忆里能找到就不查,同一件事每个会话一般只回忆一轮。`,
64
66
  '---',
65
67
  '',
66
68
  '# Session History',
@@ -69,7 +71,7 @@ export function skillMarkdown(home, { config = loadConfig(home), platform = proc
69
71
  '',
70
72
  '## 先定位会话,再有限度地读',
71
73
  '',
72
- '一次回忆一般 **2–3 次调用、合计 ≤3000 字符**。不要一上来加 `--budget`/`--snippets`,不要逐个 get 碰运气,不要 rg 扫日志或整读日志文件(索引报错除外)。',
74
+ '一次回忆一般 **2–3 次调用、合计 ≤3000 字符**。不要一上来调大 `--budget` 或加 `--snippets`,不要逐个 get 碰运气,不要 rg 扫日志或整读日志文件(索引报错除外)。',
73
75
  '',
74
76
  `**1. search 找会话**:查询词=**主体词+事件词**,如 \`${cmd} search 插件 更新失败\`、\`${cmd} search "VPN|openconnect" 断线 --agent ${first} --since 08-01\`;只给主体词必然过宽。`,
75
77
  '',
@@ -80,7 +82,7 @@ export function skillMarkdown(home, { config = loadConfig(home), platform = proc
80
82
  '',
81
83
  `**2. 会话内定位**:\`${cmd} search 更新失败 --session 01a06cc6\` 按时间列该会话命中块;或 \`${cmd} outline 01a06cc6\` 看用户每条发言+末轮回复(\`--all\` 含助手发言)。会话 ID 给前缀即可,outline 也收块 ID。`,
82
84
  '',
83
- `**3. 读原文**:\`${cmd} get 2ddbae3eed --context 1\`,块 ID 至少 6 位,默认 4000 字符。仍不够就按首行路径和行号局部读日志文件。`,
85
+ `**3. 读原文**:\`${cmd} get 2ddbae3eed --context 1 --budget 2000\`,块 ID 至少 6 位;按剩余预算调整 \`--budget\`(命令默认 4000 字符)。仍不够就按首行路径和行号局部读日志文件。`,
84
86
  '',
85
87
  `**4. 查原始记录**:接口名、参数、命令、报错原文多只在工具调用与返回里,日志搜不到。在日志里搜两次仍无,就对候选会话 \`${cmd} raw 5f3c92de "base_url|api.example"\`(含思考与工具往来,默认 2000 字符),别再换词连搜。只有${names.length ? `在用的 ${list(names)} ` : '在用的来源'}有原始记录${legacy.length ? ',已停用的没有' : ''}。`,
86
88
  '',
@@ -97,7 +99,7 @@ export function skillMarkdown(home, { config = loadConfig(home), platform = proc
97
99
  '',
98
100
  '## 索引与兜底',
99
101
  '',
100
- `每次命令自动增量更新索引${config.staleMinutes ? `;距上次整理超过 ${config.staleMinutes} 分钟会先补整理(只重读变过的会话,通常几秒)` : ''}。要查刚刚的对话可先跑一次 \`${cmd} refresh\`,别反复跑。依赖或索引报错时别当无命中:先报告,再按日志路径兜底(兼顾繁简):\`rg -n -m 5 '关键词|關鍵詞' ${platform === 'win32' ? layout(home).logs.replaceAll('\\', '/') : tilde(layout(home).logs)}/${first}/2026-08-*-log.md\``,
102
+ `每次命令自动增量更新索引${config.staleMinutes ? `;距上次整理超过 ${config.staleMinutes} 分钟会先补整理(只重读变过的会话,通常几秒)` : ''}。要查刚刚的对话可先跑一次 \`${cmd} refresh\`,别反复跑。依赖或索引报错时别当无命中:先报告,再按日志路径兜底(兼顾繁简,覆盖各 agent、全部日期的日志):\`rg -n -m 5 -g "*-log.md" "关键词|關鍵詞" ${fallbackRoot}\``,
101
103
  '',
102
104
  '除非用户要求维护本技能,不改日志正文。本文件由 Session History 按检测到的 agent 自动生成,手改会被覆盖。',
103
105
  '',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-session-history",
3
- "version": "0.2.5",
3
+ "version": "0.2.6",
4
4
  "description": "把各个 agent(Claude Code、Codex 等)的对话整理成可检索的原文日志,以一个共用技能提供给所有 agent;保留原话,不做摘要,不用向量,不调用模型。",
5
5
  "author": "youxia",
6
6
  "repository": {