@wwkit/harness 1.0.28 → 1.0.30

package/skills/revise/references/article.md

@@ -2,20 +2,22 @@
 
 ## Sprint Goal
 
-产出 `{{count}}` 篇适合社交媒体传播的图文文章（抓人标题 + 图文混排正文），整体为 JSON 数组。
+产出 `{{count}}` 篇适合社交媒体传播的图文文章，整体为 JSON 数组。
 
-## 创作原则
+## Style（默认创作风格，可由 `style` 参数覆盖）
 
-基于原始素材创作，聚焦 format 特有要点：
+基于原始素材创作：
 
-1. **标题要抓人**：有吸引力、有冲突点，读者靠标题决定是否点开
-2. **正文适合快速阅读**：图文混排，段落短、节奏快，文本块与图片块交替出现，建议文本为主、图片辅助，整体 1-20 行
-3. **图片按需提取**：从素材中提取图片地址作为 `{"type": "image"}` 块，最多 5 个图片块；素材无图片时全部用 `{"type": "text"}` 块
-4. **基于素材**：从素材中提炼核心信息，重组为流畅文章，不能凭空编造
+1. **标题抓人**：有吸引力、有冲突点，读者靠标题决定是否点开
+2. **节奏快**：段落短、节奏快，适合快速阅读
 
-## 输出契约
+## Format（输出契约，不可被 `style` 覆盖）
 
-每个 item 结构严格符合 schema `references/article.schema.json5`：`title`（10-30 cn_length）、`blocks`（array，1-20 个，每个含 `type`（text/image）+ `content`）。**整体输出为 JSON 数组，含 `{{count}}` 个 item。**
+- **结构**：每 item = `title`（10-30 cn_length）+ `blocks`（array，1-20 个，每个含 `type`（text/image）+ `content`）
+- **图文混排**：文本块与图片块交替出现，建议文本为主、图片辅助
+- **图片**：从素材中提取图片地址作为 `{"type": "image"}` 块，最多 5 个图片块；素材无图片时全部用 `{"type": "text"}` 块
+- **真实性**：从素材中提炼核心信息，重组为流畅文章，不能凭空编造
+- **输出形式**：整体为 JSON 数组，含 `{{count}}` 个 item；仅输出数组，不包含任何解释、思考过程或额外文本，禁止输出单个对象
 
 > 字数计算采用 **cn_length** 规则：中文字符算 1，非中文字符（英文/数字/符号）算 0.5，结果向上取整。
 
@@ -32,9 +34,4 @@
     ]
   }
 ]
-```
-
-## 铁律
-
-- 仅输出 JSON 数组，不要包含任何解释、思考过程或额外文本
-- 输出始终为数组，包含 `{{count}}` 个 item（默认 1），禁止输出单个对象
+```

package/skills/revise/references/gallery.md

@@ -2,20 +2,21 @@
 
 ## Sprint Goal
 
-产出 `{{count}}` 个适合社交媒体传播的图集内容（吸睛标题 + 图片列表），整体为 JSON 数组。
+产出 `{{count}}` 个适合社交媒体传播的图集内容，整体为 JSON 数组。
 
-## 创作原则
+## Style（默认创作风格，可由 `style` 参数覆盖）
 
-基于原始素材创作，聚焦 format 特有要点：
+基于原始素材创作：
 
-1. **标题要吸引**：点明图集主题，有看点、让人想点开
-2. **每张图配说明**：`images[].title` 简要说明图片内容，有助于读者理解
-3. **图片从素材提取**：从原始素材中提取图片地址，素材中图片不足时可适当精选
-4. **基于素材**：从素材中提炼主题，不能凭空编造
+1. **标题吸引**：点明图集主题，有看点、让人想点开
 
-## 输出契约
+## Format（输出契约，不可被 `style` 覆盖）
 
-每个 item 结构严格符合 schema `references/gallery.schema.json5`：`title`（10-30 cn_length）、`images`（array，1-50 个，每个含 `url` + `title`（10-30 cn_length））。**整体输出为 JSON 数组，含 `{{count}}` 个 item。**
+- **结构**：每 item = `title`（10-30 cn_length）+ `images`（array，1-50 个，每个含 `url` + `title`（10-30 cn_length））
+- **配说明**：每张图必须带 `title` 简要说明图片内容——schema 必填，不可省略
+- **图片来源**：从原始素材中提取图片地址，素材中图片不足时可适当精选
+- **真实性**：从素材中提炼主题，不能凭空编造
+- **输出形式**：整体为 JSON 数组，含 `{{count}}` 个 item；仅输出数组，不包含任何解释、思考过程或额外文本，禁止输出单个对象
 
 > 字数计算采用 **cn_length** 规则：中文字符算 1，非中文字符（英文/数字/符号）算 0.5，结果向上取整。
 
@@ -31,9 +32,4 @@
     ]
   }
 ]
-```
-
-## 铁律
-
-- 仅输出 JSON 数组，不要包含任何解释、思考过程或额外文本
-- 输出始终为数组，包含 `{{count}}` 个 item（默认 1），禁止输出单个对象
+```

package/skills/revise/references/question.md

@@ -2,20 +2,21 @@
 
 ## Sprint Goal
 
-产出 `{{count}}` 条适合社交媒体传播的问题内容（尖锐标题 + 简洁描述），整体为 JSON 数组。
+产出 `{{count}}` 条适合社交媒体传播的问题内容，整体为 JSON 数组。
 
-## 创作原则
+## Style（默认创作风格，可由 `style` 参数覆盖）
 
-基于原始素材创作，聚焦 format 特有要点：
+基于原始素材创作：
 
-1. **标题要尖锐**：有争议性、冲突点，能激发讨论欲和互动
-2. **描述要简洁**：说明背景，引出矛盾点，不要太长
-3. **图片按需提取**：从素材中提取图片地址，最多 5 张；素材无图片时为空数组
-4. **基于素材**：从素材中提取核心矛盾点，不能凭空编造
+1. **标题尖锐**：有争议性、冲突点，能激发讨论欲和互动
+2. **描述简洁**：说明背景，引出矛盾点，不要太长
 
-## 输出契约
+## Format（输出契约，不可被 `style` 覆盖）
 
-每个 item 结构严格符合 schema `references/question.schema.json5`：`title`（10-30 cn_length）、`content`（20-500 cn_length）、`images`（string[]，≤5）。**整体输出为 JSON 数组，含 `{{count}}` 个 item。**
+- **结构**：每 item = `title`（10-30 cn_length）+ `content`（20-500 cn_length）+ `images`（string[]，≤5 张）
+- **图片**：从素材提取图片地址，最多 5 张；素材无图片时为空数组
+- **真实性**：从素材中提取核心矛盾点，不能凭空编造
+- **输出形式**：整体为 JSON 数组，含 `{{count}}` 个 item；仅输出数组，不包含任何解释、思考过程或额外文本，禁止输出单个对象
 
 > 字数计算采用 **cn_length** 规则：中文字符算 1，非中文字符（英文/数字/符号）算 0.5，结果向上取整。
 
@@ -29,9 +30,4 @@
     "images": ["https://example.com/pic1.jpg"]
   }
 ]
-```
-
-## 铁律
-
-- 仅输出 JSON 数组，不要包含任何解释、思考过程或额外文本
-- 输出始终为数组，包含 `{{count}}` 个 item（默认 1），禁止输出单个对象
+```

package/skills/revise/references/status.md

@@ -2,20 +2,21 @@
 
 ## Sprint Goal
 
-产出 `{{count}}` 条适合社交媒体传播的动态内容（短平快正文），整体为 JSON 数组。
+产出 `{{count}}` 条适合社交媒体传播的动态内容，整体为 JSON 数组。
 
-## 创作原则
+## Style（默认创作风格，可由 `style` 参数覆盖）
 
-基于原始素材创作，聚焦 format 特有要点：
+基于原始素材创作：
 
-1. **正文要精炼**：短平快，提炼核心信息，避免大段照抄原文
+1. **正文精炼**：短平快，提炼核心信息，避免大段照抄原文
 2. **有观点、易互动**：口语化表达，带个人观点或情绪，能引发讨论和转发
-3. **图片按需提取**：从素材中提取图片地址，最多 5 张；素材无图片时为空数组
-4. **基于素材**：从素材中提炼要点，不能凭空编造
 
-## 输出契约
+## Format（输出契约，不可被 `style` 覆盖）
 
-每个 item 结构严格符合 schema `references/status.schema.json5`：`content`（20-500 cn_length）、`images`（string[]，≤5）。**整体输出为 JSON 数组，含 `{{count}}` 个 item。**
+- **结构**：每 item = `content`（20-500 cn_length）+ `images`（string[]，≤5 张）
+- **图片**：从素材中提取图片地址，最多 5 张；素材无图片时为空数组
+- **真实性**：从素材中提炼要点，不能凭空编造
+- **输出形式**：整体为 JSON 数组，含 `{{count}}` 个 item；仅输出数组，不包含任何解释、思考过程或额外文本，禁止输出单个对象
 
 > 字数计算采用 **cn_length** 规则：中文字符算 1，非中文字符（英文/数字/符号）算 0.5，结果向上取整。
 
@@ -28,9 +29,4 @@
     "images": ["https://example.com/pic1.jpg"]
   }
 ]
-```
-
-## 铁律
-
-- 仅输出 JSON 数组，不要包含任何解释、思考过程或额外文本
-- 输出始终为数组，包含 `{{count}}` 个 item（默认 1），禁止输出单个对象
+```

package/src/config.js

@@ -0,0 +1,29 @@
+// src/config.js — harness 配置加载（只读参考 + 初始化检测）
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createConfigLoader, getXdgConfigDir } from '@wwkit/shared'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+const _loader = createConfigLoader({
+  builtinConfigPath: path.join(__dirname, 'config.json5'),
+  userConfigDir: getXdgConfigDir('harness'),
+  envContentVar: 'HARNESS_CONFIG_CONTENT',
+  envDirVar: 'HARNESS_CONFIG_DIR',
+})
+
+/**
+ * 获取用户配置文件路径
+ * @returns {string}
+ */
+export function getConfigPath() {
+  return _loader.userConfigPath
+}
+
+/**
+ * 合并内置配置到用户配置文件（追加缺失 key，不覆盖已有值）
+ * @returns {boolean} 是否写入了文件
+ */
+export function mergeBuiltinConfig() {
+  return _loader.mergeBuiltinConfig()
+}

package/src/config.json5

@@ -0,0 +1,19 @@
+// config.json5 — harness 内置配置（只读参考）
+//
+// 此文件为只读配置，由 postinstall 或首次运行时复制到
+// ~/.config/harness/config.json5（或 $XDG_CONFIG_HOME/harness/config.json5）。
+// 实际运行配置通过环境变量生效，此文件主要用于：
+//   1. 配置初始化检测（existsSync 判断是否需要复制）
+//   2. 文档参考（记录 harness 依赖的环境变量）
+//
+// 修改此文件不会影响运行时行为，请通过 shell profile 直接管理环境变量。
+
+{
+  // 环境变量声明（只读 — 由 postinstall 通过 Shell.setEnvVar 自动设置）
+  env: {
+    // harness 包安装目录（agents/skills/commands 所在路径）
+    OPENCODE_CONFIG_DIR: "",
+    // 启用 opencode 实验性 LSP 工具
+    OPENCODE_EXPERIMENTAL_LSP_TOOL: "true",
+  },
+}

package/skills/extract/references/format-aliases.json5

@@ -1,22 +0,0 @@
-{
-  // format 别名映射表：供 agent 将用户的自然语言描述翻译为 format 标准值。
-  // 用户可能用中文/口语而非英文标识，按以下 terms 命中匹配。
-  "aliases": {
-    "list": {
-      "description": "列表提取：从列表页提取多条目（HTML 或结构化 JSON 两种来源）",
-      "terms": ["列表", "多条", "集合", "条目", "list"]
-    },
-    "detail": {
-      "description": "详情提取：单条详情/正文内容",
-      "terms": ["详情", "正文", "单条", "内容页", "detail"]
-    },
-    "text": {
-      "description": "纯文本提取：HTML 转纯文本",
-      "terms": ["纯文本", "文字", "文本", "转文本", "text"]
-    },
-    "navi": {
-      "description": "导航提取：生成栏目/链接导航的 XPath",
-      "terms": ["导航", "栏目", "链接导航", "navi"]
-    }
-  }
-}

package/skills/extract/references/input.schema.json5

@@ -1,23 +0,0 @@
-{
-  // extract 技能入参字段清单（纯文档用途，供 agent 解析入参时参照，不做运行时校验）。
-  "title": "extract 技能入参字段清单",
-  "type": "object",
-  "properties": {
-    "source": {
-      "type": "string",
-      "description": "网页 HTML/文本内容，或本地文件路径",
-      "required": true
-    },
-    "format": {
-      "type": "string",
-      "description": "提取类型。标准值为 list/detail/text/navi 之一",
-      "enum": ["list", "detail", "text", "navi"],
-      "required": true
-    },
-    "url": {
-      "type": "string",
-      "description": "页面 URL；source 为相对路径时基于它转为绝对路径",
-      "required": false
-    }
-  }
-}

package/skills/query/references/input.schema.json5

@@ -1,25 +0,0 @@
-{
-  // query 技能入参字段清单（纯文档用途，供 agent 解析入参时参照，不做运行时校验）。
-  "title": "query 技能入参字段清单",
-  "type": "object",
-  "properties": {
-    "prompt": {
-      "type": "string",
-      "description": "任务要求，包含输出格式说明",
-      "required": true
-    },
-    "source": {
-      "type": "string",
-      "description": "原始素材：普通文本或本地文件路径"
-    },
-    "language": {
-      "type": "string",
-      "description": "输出内容语言，默认 中文",
-      "default": "中文"
-    },
-    "output": {
-      "type": "string",
-      "description": "输出文件路径，未提供时输出到 stdout"
-    }
-  }
-}

package/skills/revise/references/format-aliases.json5

@@ -1,22 +0,0 @@
-{
-  // format 别名映射表：供 agent 将用户的自然语言描述翻译为 format 标准值。
-  // 用户可能用中文/口语而非英文标识，按以下 terms 命中匹配。
-  "aliases": {
-    "question": {
-      "description": "社交媒体风格问题：尖锐标题 + 简洁描述，激发讨论/互动",
-      "terms": ["问题", "提问", "互动话题", "话题", "question"]
-    },
-    "status": {
-      "description": "简短社交动态：微博/朋友圈式的一句话或短文字",
-      "terms": ["动态", "微博", "朋友圈", "状态", "一句话", "status"]
-    },
-    "gallery": {
-      "description": "多图图集：以图片为主的多图形式",
-      "terms": ["图集", "相册", "多图", "图片合集", "gallery"]
-    },
-    "article": {
-      "description": "图文文章：较长的图文长文",
-      "terms": ["文章", "图文", "长文", "推文", "article"]
-    }
-  }
-}

package/skills/revise/references/input.schema.json5

@@ -1,28 +0,0 @@
-{
-  // revise 技能入参字段清单（纯文档用途，供 agent 解析入参时参照，不做运行时校验）。
-  "title": "revise 技能入参字段清单",
-  "type": "object",
-  "properties": {
-    "source": {
-      "type": "string",
-      "description": "原始素材：普通文本或 JSON 字符串，或本地文件路径",
-      "required": true
-    },
-    "format": {
-      "type": "string",
-      "description": "创作格式。标准值为 question/status/gallery/article 之一",
-      "enum": ["question", "status", "gallery", "article"],
-      "required": true
-    },
-    "count": {
-      "type": "integer",
-      "description": "生成的 item 数量，默认 1",
-      "default": 1
-    },
-    "language": {
-      "type": "string",
-      "description": "输出内容语言，默认 中文",
-      "default": "中文"
-    }
-  }
-}