dsh-tiddlywiki 0.33.2 → 0.33.3

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/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "dsh-tiddlywiki",
3
3
  "description": "把 TiddlyWiki 5 变成你和 Agent 共用的本地文档中心(纯文本 + git):你在 DSH 界面里阅读、写作、记日记,Agent 用 16 个 tiddlywiki_* 工具读写同一批笔记;每条笔记都是你能读、能改、能审计、能随时带走的文件——不是自动记忆插件,不做后台抓取。可选一键发布到微信公众号草稿箱。 Turn TiddlyWiki 5 into a document center you and your agent share, in plain text under git — a knowledge base you can read, edit, audit and take with you, not an auto-memory plugin. Mounts via the official dsh plugin system; no DSH source changes.",
4
- "version": "0.33.2",
4
+ "version": "0.33.3",
5
5
  "type": "module",
6
6
  "keywords": [
7
7
  "dsh",
@@ -34,7 +34,8 @@ export const FRAME_MESSAGES: { zh: Record<string, string>; en: Record<string, st
34
34
  'frame.statusUnreachable': '无法访问 /dsh-tiddlywiki/status',
35
35
  'frame.noEditorUrl': '服务未返回编辑器地址',
36
36
  'frame.statusError': '服务状态:{status}',
37
- 'frame.tidPreviewTitle': '.tid 文件预览',
37
+ 'frame.tidPreviewTitle': '真 TiddlyWiki 渲染',
38
+ 'frame.tidMoreFields': '另外 {n} 个字段',
38
39
  'frame.tidPreviewWaiting': '等待文件内容…',
39
40
  'frame.tidPreviewNoBody': '这个 .tid 只有字段、没有正文。',
40
41
  'frame.tidPreviewFallback': '渲染失败,下面是原文:',
@@ -64,7 +65,8 @@ export const FRAME_MESSAGES: { zh: Record<string, string>; en: Record<string, st
64
65
  'frame.statusUnreachable': 'Cannot reach /dsh-tiddlywiki/status',
65
66
  'frame.noEditorUrl': 'The service returned no editor address',
66
67
  'frame.statusError': 'Service status: {status}',
67
- 'frame.tidPreviewTitle': '.tid file preview',
68
+ 'frame.tidPreviewTitle': 'Rendered TiddlyWiki',
69
+ 'frame.tidMoreFields': '{n} more fields',
68
70
  'frame.tidPreviewWaiting': 'Waiting for file content…',
69
71
  'frame.tidPreviewNoBody': 'This .tid has fields but no body text.',
70
72
  'frame.tidPreviewFallback': 'Rendering failed; showing the raw text:',
@@ -25,6 +25,83 @@ export interface ParsedTid {
25
25
  text: string
26
26
  }
27
27
 
28
+ /**
29
+ * 内部/机械性字段:对「人看这个文件」没有信息量,摘要里折到一行小字里。
30
+ *
31
+ * `ws/*` 与 `agent-written` 其实是**标签值里的标记**,不是字段名 —— 见 `summarizeTid`。
32
+ */
33
+ export const INTERNAL_FIELD_KEYS = ['revision', 'workspace', 'human-edited', 'agent-written', 'bag', 'list']
34
+
35
+ /** 摘要里单列出来的字段(其余进「另外 N 个字段」那一行)。 */
36
+ export const SUMMARY_FIELD_KEYS = ['created', 'modified', 'creator', 'modifier', 'type']
37
+
38
+ export interface TidSummary {
39
+ /** 展示标题:`title:` 字段优先。 */
40
+ title?: string
41
+ /** 去掉内部标记后的标签。 */
42
+ tags: string[]
43
+ /** 人类可读的时间(优先 `modified`,其次 `created`)。 */
44
+ time?: string
45
+ /** 单列出来的字段(`created`/`modified`/`creator`/`modifier`/`type`),时间字段已格式化。 */
46
+ known: Array<[string, string]>
47
+ /** 折进「另外 N 个字段」的那些(内部字段 + 其余自定义字段)。 */
48
+ other: Array<[string, string]>
49
+ }
50
+
51
+ /**
52
+ * 把 TiddlyWiki 的 17 位时间戳(`YYYYMMDDHHmmssSSS`,UTC)变成 `YYYY-MM-DD HH:mm`。
53
+ *
54
+ * 不是 17 位数字就原样返回 —— 宁可显示原文,也不要把一个看不懂的值装作看懂了。
55
+ */
56
+ export function formatTidStamp(value: string): string {
57
+ const raw = value.trim()
58
+ if (!/^\d{17}$/.test(raw)) return raw
59
+ const [y, mo, d, h, mi] = [raw.slice(0, 4), raw.slice(4, 6), raw.slice(6, 8), raw.slice(8, 10), raw.slice(10, 12)]
60
+ return `${y}-${mo}-${d} ${h}:${mi}`
61
+ }
62
+
63
+ /**
64
+ * 把解析结果压成**给人看**的摘要。
65
+ *
66
+ * 规则(作者 2026-10-26 要求):只单列 `title` / `tags` / 时间,其余(`revision`、`workspace`、
67
+ * `human-edited`、`ws/*` 这类机械字段)折进一行小字 —— 预览器的第一眼应该看到**内容**,
68
+ * 不是一堆元数据。
69
+ */
70
+ export function summarizeTid(parsed: ParsedTid): TidSummary {
71
+ const known: Array<[string, string]> = []
72
+ const other: Array<[string, string]> = []
73
+ let tags: string[] = []
74
+ let created: string | undefined
75
+ let modified: string | undefined
76
+ for (const [key, value] of parsed.fields) {
77
+ if (key === 'tags') {
78
+ tags = value.split(/[\s,]+/).filter((tag) => tag.length > 0)
79
+ continue
80
+ }
81
+ if (key === 'created') created = value
82
+ if (key === 'modified') modified = value
83
+ if (SUMMARY_FIELD_KEYS.includes(key)) {
84
+ known.push([key, key === 'created' || key === 'modified' ? formatTidStamp(value) : value])
85
+ continue
86
+ }
87
+ other.push([key, key === 'created' || key === 'modified' ? formatTidStamp(value) : value])
88
+ }
89
+ // 系统/机械标记不占版面:`ws/<项目>` 与 `agent-written` 只在「另外 N 个」里留个影子。
90
+ const visibleTags = tags.filter((tag) => !tag.startsWith('ws/') && tag !== 'agent-written')
91
+ const hiddenTags = tags.filter((tag) => !visibleTags.includes(tag))
92
+ // 键名走英文:这是开发者可见的折叠行标签,客户端守门禁止中文字面量。
93
+ if (hiddenTags.length > 0) other.push(['tags(hidden)', hiddenTags.join(' ')])
94
+ const stamp = modified ?? created
95
+ const time = stamp === undefined ? undefined : formatTidStamp(stamp)
96
+ return {
97
+ ...(parsed.title !== undefined && parsed.title.length > 0 ? { title: parsed.title } : {}),
98
+ tags: visibleTags,
99
+ ...(time !== undefined ? { time } : {}),
100
+ known: known.filter(([key]) => key !== 'created' && key !== 'modified'),
101
+ other,
102
+ }
103
+ }
104
+
28
105
  /**
29
106
  * 把一份 `.tid` 文件拆成「字段 + 正文」。
30
107
  *
@@ -32,11 +32,12 @@ import * as React from 'react'
32
32
  import { t } from './i18n.ts'
33
33
  import { RENDER_ENDPOINT, withWikiQuery } from './endpoints.ts'
34
34
 
35
- import { parseTidText, TID_EXTENSIONS, TID_PREVIEW_ID, TID_PREVIEW_SLOT } from './tid-parse.ts'
35
+ import { parseTidText, summarizeTid, TID_EXTENSIONS, TID_PREVIEW_ID, TID_PREVIEW_SLOT } from './tid-parse.ts'
36
36
 
37
37
  // 纯逻辑住在 tid-parse.ts(宿主 barrel 也要导出它,而宿主包不能出现 react)。
38
38
  export { parseTidText, TID_EXTENSIONS, TID_PREVIEW_ID, TID_PREVIEW_SLOT } from './tid-parse.ts'
39
- export type { ParsedTid } from './tid-parse.ts'
39
+ export type { ParsedTid, TidSummary } from './tid-parse.ts'
40
+ export { formatTidStamp, summarizeTid } from './tid-parse.ts'
40
41
 
41
42
  /**
42
43
  * 从正文 props 里取文件文本。
@@ -116,16 +117,26 @@ export function createTidPreviewBody(): (props: unknown) => React.ReactElement {
116
117
  return () => { alive = false }
117
118
  }, [parsed.text])
118
119
 
120
+ // 摘要(v0.33.3,作者要求):第一眼只看 title / tags / 时间,机械字段折成一行小字。
121
+ const summary = React.useMemo(() => summarizeTid(parsed), [parsed])
119
122
  const head: React.ReactElement[] = []
120
- if (parsed.title !== undefined && parsed.title.length > 0) {
121
- head.push(React.createElement('div', { key: 'title', className: 'dsh-tw-tid-title' }, `📄 ${parsed.title}`))
123
+ if (summary.title !== undefined) {
124
+ head.push(React.createElement('div', { key: 'title', className: 'dsh-tw-tid-title' }, `📄 ${summary.title}`))
122
125
  }
123
- if (parsed.fields.length > 0) {
126
+ const chips: React.ReactElement[] = []
127
+ if (summary.time !== undefined) chips.push(React.createElement('span', { key: 'time', className: 'dsh-tw-tid-time' }, `🕒 ${summary.time}`))
128
+ for (const tag of summary.tags) chips.push(React.createElement('span', { key: `tag:${tag}`, className: 'dsh-tw-tid-tag' }, `#${tag}`))
129
+ for (const [key, value] of summary.known) {
130
+ chips.push(React.createElement('span', { key: `k:${key}`, className: 'dsh-tw-tid-field' }, `${key}: ${value.length > 40 ? `${value.slice(0, 40)}…` : value}`))
131
+ }
132
+ if (chips.length > 0) head.push(React.createElement('div', { key: 'chips', className: 'dsh-tw-tid-fields' }, ...chips))
133
+ if (summary.other.length > 0) {
134
+ const folded = summary.other.map(([key, value]) => `${key}=${value.length > 24 ? `${value.slice(0, 24)}…` : value}`).join(' · ')
124
135
  head.push(
125
136
  React.createElement(
126
137
  'div',
127
- { key: 'fields', className: 'dsh-tw-tid-fields' },
128
- parsed.fields.map(([key, value]) => React.createElement('span', { key, className: 'dsh-tw-tid-field' }, `${key}: ${value.length > 60 ? `${value.slice(0, 60)}…` : value}`)),
138
+ { key: 'more', className: 'dsh-tw-tid-more', title: folded },
139
+ `${t('frame.tidMoreFields', { n: summary.other.length })} — ${folded}`,
129
140
  ),
130
141
  )
131
142
  }
package/src/index.ts CHANGED
@@ -143,7 +143,18 @@ export { registerTiddlywikiTools, TRASH_PREFIX, TRASH_INDEX_TITLE, TrashIndexUna
143
143
  export { tiddlywikiToolSummary } from './host/tools.ts'
144
144
  // `.tid` 预览的**纯**半边(v0.32.0)。只能导出不碰 react 的模块:`client/tid-preview.ts`
145
145
  // 依赖 React 与客户端 endpoints,进宿主包会炸。
146
- export { TID_EXTENSIONS, TID_PREVIEW_ID, TID_PREVIEW_SLOT, parseTidText, type ParsedTid } from './client/tid-parse.ts'
146
+ export {
147
+ INTERNAL_FIELD_KEYS,
148
+ SUMMARY_FIELD_KEYS,
149
+ TID_EXTENSIONS,
150
+ TID_PREVIEW_ID,
151
+ TID_PREVIEW_SLOT,
152
+ formatTidStamp,
153
+ parseTidText,
154
+ summarizeTid,
155
+ type ParsedTid,
156
+ type TidSummary,
157
+ } from './client/tid-parse.ts'
147
158
  // 宿主 locale 集成(v0.33.0):只导出**不碰 react** 的那半边(i18n-host 只依赖目录数据)。
148
159
  export {
149
160
  LOCALE_NAMESPACE,