dsh-plugin-guide 0.1.0 → 0.1.1

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.
Files changed (8) hide show
  1. package/README.es.md +127 -87
  2. package/README.hi.md +128 -87
  3. package/README.md +179 -165
  4. package/README.pt.md +126 -86
  5. package/README.zh.md +179 -0
  6. package/package.json +4 -4
  7. package/scripts/verify-kit.ps1 +1 -1
  8. package/README.zh-CN.md +0 -164
package/README.zh-CN.md DELETED
@@ -1,164 +0,0 @@
1
- <div align="center">
2
-
3
- # 🐳 dsh-plugin-guide
4
-
5
- **开发 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件所需的一切。**
6
-
7
- 官方文档存档 · Cordis 入门 · 社区深读 · 实测踩坑 · 智能体技能
8
-
9
- [English](README.md) · [中文](README.zh-CN.md) · [Español](README.es.md) · [Português](README.pt.md) · [हिन्दी](README.hi.md)
10
-
11
- [![GitHub stars](https://img.shields.io/github/stars/PerryLink/dsh-plugin-guide?style=for-the-badge&color=yellow&label=%E2%AD%90%20Stars)](https://github.com/PerryLink/dsh-plugin-guide/stargazers)
12
- [![GitHub forks](https://img.shields.io/github/forks/PerryLink/dsh-plugin-guide?style=for-the-badge&color=blue&label=Forks)](https://github.com/PerryLink/dsh-plugin-guide/network/members)
13
- [![verify-kit CI](https://img.shields.io/github/actions/workflow/status/PerryLink/dsh-plugin-guide/verify.yml?branch=main&style=for-the-badge&label=CI)](https://github.com/PerryLink/dsh-plugin-guide/actions/workflows/verify.yml)
14
- [![npm version](https://img.shields.io/npm/v/dsh-plugin-guide?style=for-the-badge&label=npm)](https://www.npmjs.com/package/dsh-plugin-guide)
15
- [![npm downloads](https://img.shields.io/npm/dm/dsh-plugin-guide?style=for-the-badge&label=downloads)](https://www.npmjs.com/package/dsh-plugin-guide)
16
- [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue?style=for-the-badge)](LICENSE)
17
- [![Topic: dsh](https://img.shields.io/badge/Topic-dsh-4D6BFE?style=for-the-badge)](https://github.com/topics/dsh)
18
- [![Topic: dsh-plugin](https://img.shields.io/badge/Topic-dsh--plugin-8257D0?style=for-the-badge)](https://github.com/topics/dsh-plugin)
19
- [![Docs: EN/ZH](https://img.shields.io/badge/Docs-EN%2FZH-8257D0?style=for-the-badge)](references/official-docs/)
20
-
21
- </div>
22
-
23
- > 🗺️ **每条事实都链接到出处**——官方文档、上游仓库或社区仓库。有疑问时以官方原文副本为准。
24
- >
25
- > ⏱️ **最后核验 2026-08-15**——官方文档与上游 `master`（47f9438，见 [SNAPSHOT.md](references/official-docs/SNAPSHOT.md)）逐字节一致；npm 标签与 `dsh-plugin` 话题（08-15 快照抓取期间 API total_count **2668 → 2671 持续增长**，分页快照收录 998 个仓库，见 [sources.md](references/sources.md) §D.2）已实时重核；上游 HEAD 与 npm `@deepseek-ai/dsh`（0.1.0-rc.6）无变化。
26
-
27
- ## 📊 一览
28
-
29
- | 官方文档 | 社区深读 | 实测踩坑 | `dsh-plugin` 话题 | 语言 | 智能体技能 |
30
- |---|---|---|---|---|---|
31
- | 215 篇（中英） | 114 个仓库 | 20+ | 998 快照（API ≈2670） | EN · 中文 · ES · PT · HI | `dsh-plugin-guide` |
32
-
33
- ## 🚀 快速开始
34
-
35
- ### 🧩 作为 DSH 插件安装（推荐）
36
-
37
- 本仓库本身是一个可安装的 **DSH bundle**：安装后把整套知识库注册为 `dsh-plugin-guide` 智能体技能——每个会话的技能目录里都可见，模型按需加载工作流、官方文档与社区深读（`./guide/`、`./references/`），无需复制、无需搜索。
38
-
39
- ```sh
40
- # 从 git 安装（源码；建议钉住 commit 保证可复现）：
41
- dsh plugin --profile <profile> add github:PerryLink/dsh-plugin-guide#<sha>
42
-
43
- # 或打 tarball 安装（入口是纯 ESM JS，无需构建步骤）：
44
- pnpm pack
45
- dsh plugin --profile <profile> add ./dsh-plugin-guide-<version>.tgz
46
- ```
47
-
48
- bundle 声明了 `dsh.bundle.patch`，并以可选 peerDependency 钉住 `@deepseek-ai/dsh@0.1.0-rc.6` 版本火车。用 `dsh --profile <profile> --dump-config` 验证 `dsh-plugin-guide` 层已生效。
49
-
50
- ### 🤖 或复制为普通智能体技能
51
-
52
- 把整个目录复制进你的 agent 技能目录（相对路径保持不变）：
53
-
54
- **Windows（PowerShell）**
55
-
56
- ```powershell
57
- pwsh -File scripts/install-skill.ps1 `
58
- -Target "$env:USERPROFILE\.deepseek\skills\dsh-plugin-guide" # 或 <项目>\.agents\skills\dsh-plugin-guide
59
- ```
60
-
61
- **macOS / Linux**
62
-
63
- ```bash
64
- pwsh -File scripts/install-skill.ps1 -Target ~/.deepseek/skills/dsh-plugin-guide # 或 <项目>/.agents/skills/dsh-plugin-guide
65
- ```
66
-
67
- 安装脚本会跳过 `downloads/`（脚本生成）与 `.github/`，并对每个复制的文件做逐字节校验；手工 `Copy-Item -Recurse` 整个目录也可以。
68
-
69
- 然后对智能体说：*"用 dsh-plugin-guide 技能帮我开发一个 XX 插件。"*
70
-
71
- ### 📖 或者直接阅读
72
-
73
- | 想要什么 | 读哪里 |
74
- |---|---|
75
- | 一页速查表 | [`guide/quick-reference.md`](guide/quick-reference.md) |
76
- | 完整 10 章路径 | [`guide/plugin-dev-guide.md`](guide/plugin-dev-guide.md) |
77
- | 官方与社区文档链接 | [`guide/links.md`](guide/links.md) · [`references/community-ecosystem.md`](references/community-ecosystem.md) |
78
- | 服务/事件精确 API | `references/official-docs/docs/subsystems/` 与 `docs/cordis-api/` |
79
-
80
- ## 🧭 目录结构
81
-
82
- | 路径 | 内容 |
83
- |---|---|
84
- | `SKILL.md` | `dsh-plugin-guide` 技能：硬性红线 + 按任务类型的开发路径 |
85
- | `package.json` · `cordis.patch.yml` · `index.js` | 可安装的 DSH bundle：`dsh.bundle.patch` 清单 + 把知识库注册为 `dsh-plugin-guide` 技能的入口 |
86
- | `guide/plugin-dev-guide.md` | 完整开发指南（10 章） |
87
- | `guide/quick-reference.md` | 一页速查表（5 语种） |
88
- | `guide/links.md` | 精选 URL 索引：官方开发文档（线上 ↔ 本地副本）+ 社区开发文档链接 |
89
- | `references/official-docs/` | 官方文档逐字副本（中英双语） |
90
- | `references/*.md` | 调研报告：仓库文档、文档站、Cordis、论文、社区生态、111 仓库归档（15 个深读） |
91
- | `scripts/` | 幂等下载脚本 + 完整性检查器 + 话题快照生成器 |
92
- | `downloads/` | 原始下载物——由 `scripts/` 生成，不入版本库 |
93
-
94
- ## ✨ 亮点
95
-
96
- - 📜 **插件契约与红线**——注册即 effect、waterfall 必须 `next()`、模型可见⟺已记录、Schemastery 配置。
97
- - 🕰️ **机制时间线**——repository-plugin 机制 0809 推出、0811 移除；bundle 与纯 cordis 两条安装通道。
98
- - 🕳️ **20+ 个实测坑**（根因+修法）：cordis 双副本、tsconfig 三件套、`tsc` 报错仍产出、Windows junction、多帧 zstd 会话、`DSH_*` 环境变量、npm `latest` 过期……
99
- - 🔬 **114 个社区仓库归档**（15 个深读）——模板、脚手架、踩坑档案、plugin-check 规则、Fabric 层、MCP 桥，另有 15 语言指南、s01–s23 课程、深度手册、TS/Rust SDK 等 26 个文档型仓库与 08-15 第七批 14 个仓库（桌面端/QQ 桥接/安全 PoC/Python 移植）。
100
- - 🔗 **全量来源索引**——每条结论都链接到出处（官方文档、上游仓库、社区仓库）。
101
- - 🗃️ **官方 Discussions 全量归档（1654 条，含精选线程评论）+ 中英文社区文章快照 100+ 篇**——用 `scripts/archive-discussions.ps1` / `scripts/download-community-articles.ps1` 一键刷新。
102
- - 🆕 **新鲜度印章**——2026-08-15 对照上游 `master`、npm 与实时 `dsh-plugin` 话题复核。
103
-
104
- ## 🔄 保持新鲜
105
-
106
- ```sh
107
- pwsh -File scripts/sync-official-docs.ps1 # 从本地 checkout 同步官方文档逐字副本（只取 origin/master）
108
- pwsh -File scripts/download-sources.ps1 # 官网/文档站、Cordis、论文
109
- pwsh -File scripts/download-community-repos.ps1 # 114 个社区仓库（codeload tarball，ETag 增量刷新）
110
- pwsh -File scripts/download-community-articles.ps1 # 中/英/HN 社区文章 HTML 快照
111
- pwsh -File scripts/archive-discussions.ps1 # 官方 Discussions（需 $env:GH_TOKEN）
112
- pwsh -File scripts/gen-topic-snapshot.ps1 -OutDir <目录> # dsh-plugin 话题普查
113
- pwsh -File scripts/verify-kit.ps1 -Checkout <checkout> # 关键路径 + 断链扫描 + 官方文档漂移报告
114
- ```
115
-
116
- 每次 push 与 PR 都会由 CI 运行 `verify-kit`。
117
-
118
- ## 🏷️ 话题
119
-
120
- 本仓库以 GitHub 话题 **[`dsh`](https://github.com/topics/dsh)** 与 **[`dsh-plugin`](https://github.com/topics/dsh-plugin)** 对外可见——逛这两个话题页可以发现数百个插件与开发资源。
121
-
122
- ## 🤝 参与共建
123
-
124
- - ⭐ **给仓库点 Star**——帮助更多 DSH 插件开发者发现它。
125
- - 发现错误、新坑或值得深读的仓库？提 [issue](https://github.com/PerryLink/dsh-plugin-guide/issues) 或 Pull Request——见 [CONTRIBUTING.md](CONTRIBUTING.md)。
126
- - 加入社区：[DeepSeek Harness Discord](https://discord.gg/Ycq5dCaS4) · [官方讨论区](https://github.com/deepseek-ai/deepseek-harness/discussions) · [`dsh-plugin` 话题页](https://github.com/topics/dsh-plugin)。
127
-
128
- ## 💛 贡献者
129
-
130
- - [PerryLink](https://github.com/PerryLink) — 创建者与维护者：知识库内容、插件化改造（bundle 契约）、生态投递与社区工程。
131
- - 日常维护由 DeepSeek Harness 智能体协助完成（其无 GitHub 账号，此处仅为透明性列出，不计入贡献者）。
132
-
133
-
134
- ## 📄 许可与归属
135
-
136
- - 自有文本（`SKILL.md`、`guide/`、`references/` 报告、`scripts/`、本 README）：**Apache-2.0**——见 [LICENSE](LICENSE)。
137
- - 收录的第三方内容及其分发边界见 [NOTICE.md](NOTICE.md)（例如 `downloads/` 仅限本地、`awesome-dsh-plugins` 禁止再分发）。
138
-
139
- ## ⚖️ 免责声明
140
-
141
- 社区维护，**不是** DeepSeek 官方产品。DeepSeek Harness 处于开发者预览期、会发布破坏性变更；有疑问时以
142
- `references/official-docs/` 中的官方文档为准。
143
-
144
- ## PerryLink DSH 插件家族
145
-
146
- 本项目是 [PerryLink](https://github.com/PerryLink) 维护的 [15 个 DeepSeek Harness 插件](https://github.com/PerryLink)之一。如果你觉得这个插件有用，其余的很可能同样有用：
147
-
148
- | 插件 | 一句话说明 |
149
- |---|---|
150
- | [dsh-mcp-panel](https://github.com/PerryLink/dsh-mcp-panel) | 只读 MCP 运行时面板：/mcp 命令 + 设置页，状态/工具/错误一览 |
151
- | [dsh-doublecheck](https://github.com/PerryLink/dsh-doublecheck) | 工程纪律守门：需求审讯、测试证据门、对抗评审 |
152
- | [dsh-background-agents](https://github.com/PerryLink/dsh-background-agents) | 持久化后台子代理：Web 侧边栏进度、随时留言与打断 |
153
- | [dsh-lsp-actions](https://github.com/PerryLink/dsh-lsp-actions) | 基于语言服务器的诊断/格式化/补全/代码动作/重命名 |
154
- | [dsh-output-styles](https://github.com/PerryLink/dsh-output-styles) | 对标 Claude Code outputStyles 的运行时风格切换 |
155
- | [dsh-checkpoint-rewind](https://github.com/PerryLink/dsh-checkpoint-rewind) | 对标 Claude Code /rewind：快照、会话 fork、一键回退 |
156
- | [dsh-permission-rules](https://github.com/PerryLink/dsh-permission-rules) | Claude Code 风格声明式 allow/deny/ask 权限规则，带审计 |
157
- | [dsh-auto-review](https://github.com/PerryLink/dsh-auto-review) | 审批链上的第二模型自动审查，默认 fail-closed |
158
- | [dsh-memento](https://github.com/PerryLink/dsh-memento) | 带审批门的跨会话记忆：ctx.memory + SQLite + memory 工具 |
159
- | [dsh-skill-pack-security](https://github.com/PerryLink/dsh-skill-pack-security) | 安全审计技能包：密钥扫描、依赖与供应链审查 |
160
- | [dsh-session-pin](https://github.com/PerryLink/dsh-session-pin) | 在 Web 侧边栏置顶会话，持久排序 |
161
- | [dsh-composer-history](https://github.com/PerryLink/dsh-composer-history) | Web 作曲器终端式输入历史：方向键、Ctrl+R 搜索 |
162
- | [dsh-github](https://github.com/PerryLink/dsh-github) | DSH 的 GitHub PR/issue 集成，所有写操作经审批门 |
163
- | **[dsh-plugin-guide](https://github.com/PerryLink/dsh-plugin-guide)** | 插件开发知识库，随 bundle 安装的按需 agent 技能 |
164
- | [dsh-claude-move](https://github.com/PerryLink/dsh-claude-move) | 把 Claude Code 会话、记忆、技能和 CLAUDE.md 迁入 DSH |