file-brief 2.0.0 → 2.0.2

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/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Zhiyi-Zhao
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Zhiyi-Zhao
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,5 +1,11 @@
1
1
  # file-brief
2
2
 
3
+ [![npm version](https://img.shields.io/npm/v/file-brief)](https://www.npmjs.com/package/file-brief)
4
+ [![npm downloads](https://img.shields.io/npm/dm/file-brief)](https://www.npmjs.com/package/file-brief)
5
+ [![DSH Market](https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-en.svg)](https://dsh.market/?q=Zhiyi-Zhao%2Ffile-brief)
6
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
7
+ [![CI](https://github.com/Zhiyi-Zhao/file-brief/actions/workflows/validate.yml/badge.svg)](https://github.com/Zhiyi-Zhao/file-brief/actions/workflows/validate.yml)
8
+
3
9
  [中文](#中文) · [English](#english)
4
10
 
5
11
  `file-brief` is an agent-agnostic skill (OpenAI Codex · Claude Code · DeepSeek Harness) that turns repeated input-file inspection into reusable, task-local documentation.
@@ -63,6 +69,16 @@ Copy-Item -LiteralPath ".\skills\file-brief" -Destination "$HOME\.dsh\skills\fil
63
69
  mkdir -p ~/.claude/skills && cp -R skills/file-brief ~/.claude/skills/
64
70
  ```
65
71
 
72
+ **npm 安装(DeepSeek Harness 插件方式)**:`file-brief@2.0.0` 已发布到 npm(声明 `dsh.bundle`),可以作为 DSH 插件安装,也可在 [deepseek1024.com](https://deepseek1024.com/) 插件商店详情页获得一键安装命令:
73
+
74
+ ```bash
75
+ dsh plugin --profile web add file-brief
76
+ # 或
77
+ npx @deepseek-ai/dsh plugin --profile web add file-brief
78
+ ```
79
+
80
+ > 说明:作为 npm 插件安装时,bundle 的 patch 层是空操作(技能本体通过 SKILL.md 加载);仍建议把技能复制到 `~/.dsh/skills` 等技能根目录以获得最佳体验。
81
+
66
82
  安装后请启动一个新的 Agent 会话,使技能列表重新加载。
67
83
 
68
84
  ### 为什么每个任务拥有自己的目录
@@ -363,6 +379,16 @@ Manual copy also works:
363
379
  mkdir -p ~/.claude/skills && cp -R skills/file-brief ~/.claude/skills/
364
380
  ```
365
381
 
382
+ **Install from npm (DeepSeek Harness plugin style)**: `file-brief@2.0.0` is published to npm with a `dsh.bundle` declaration, so it can be installed as a DSH plugin, and the [deepseek1024.com](https://deepseek1024.com/) store shows a one-click install command on its plugin page:
383
+
384
+ ```bash
385
+ dsh plugin --profile web add file-brief
386
+ # or
387
+ npx @deepseek-ai/dsh plugin --profile web add file-brief
388
+ ```
389
+
390
+ > Note: installed as an npm plugin, the bundle's patch layer is a no-op (the skill itself loads through SKILL.md); copying the skill into `~/.dsh/skills` or another skill root still gives the best experience.
391
+
366
392
  Start a new agent session after installation so the skill list reloads.
367
393
 
368
394
  ### Why catalogs are task-local
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "file-brief",
3
- "version": "2.0.0",
3
+ "version": "2.0.2",
4
4
  "description": "Agent-agnostic skill that turns task input files into reusable structural briefs and a per-task searchable index (OpenAI Codex, Claude Code, DeepSeek Harness)",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -14,6 +14,7 @@
14
14
  "url": "https://github.com/Zhiyi-Zhao/file-brief/issues"
15
15
  },
16
16
  "keywords": [
17
+ "dsh",
17
18
  "dsh-plugin",
18
19
  "deepseek-harness",
19
20
  "skill",
@@ -1,7 +1,7 @@
1
- interface:
2
- display_name: "Catalog Input Files"
3
- short_description: "Catalog task files into reusable structural explanations"
4
- default_prompt: "Use $file-brief to catalog this task folder before analyzing its input files."
5
-
6
- policy:
7
- allow_implicit_invocation: true
1
+ interface:
2
+ display_name: "Catalog Input Files"
3
+ short_description: "Catalog task files into reusable structural explanations"
4
+ default_prompt: "Use $file-brief to catalog this task folder before analyzing its input files."
5
+
6
+ policy:
7
+ allow_implicit_invocation: true