Browse Source

docs: 增加 v8 入口与双产品线贡献规范

Squashed from PR #148. Provides v6/v8 navigation, v8 issue templates, unified PR/security reporting, and scoped version checks.
聆风 4 days ago
parent
commit
35ea435c0d

+ 9 - 0
.github/ISSUE_TEMPLATE/bug_report.yml

@@ -3,6 +3,15 @@ description: 反馈命令、Agent、数据链或 Dashboard 中可复现的问题
 title: "【Bug】"
 labels: ["bug"]
 body:
+  - type: dropdown
+    id: product_line
+    attributes:
+      label: 产品线
+      options:
+        - v6(Claude Code / master)
+        - v8(DSH Scriptor / v8)
+    validations:
+      required: true
   - type: markdown
     attributes:
       value: |

+ 6 - 0
.github/ISSUE_TEMPLATE/config.yml

@@ -9,3 +9,9 @@ contact_links:
   - name: 命令详解
     url: https://github.com/lingfengQAQ/webnovel-writer/blob/master/docs/guides/commands.md
     about: 查看 Skill 命令、CLI 入口和常见工作流。
+  - name: v8 工作台安装与教程
+    url: https://github.com/lingfengQAQ/webnovel-writer/tree/v8/docs/user
+    about: DSH Scriptor 的安装、版本、首章流程和排错说明。
+  - name: 私密报告安全漏洞
+    url: https://github.com/lingfengQAQ/webnovel-writer/security/advisories/new
+    about: 不要在公开 Issue 中贴密钥、启动 token 或私人作品。

+ 21 - 0
.github/ISSUE_TEMPLATE/docs.yml

@@ -0,0 +1,21 @@
+name: 文档问题
+description: 报告安装、命令或教程中的错误。
+title: '[Docs] '
+labels: [documentation]
+body:
+  - type: dropdown
+    id: product_line
+    attributes:
+      label: 产品线
+      options:
+        - v6(Claude Code / master)
+        - v8(DSH Scriptor / v8)
+    validations:
+      required: true
+  - type: textarea
+    id: location
+    attributes:
+      label: 文档链接、所用版本及出错步骤
+      description: 说明预期结果与实际结果,不要粘贴密钥或私人作品。
+    validations:
+      required: true

+ 9 - 0
.github/ISSUE_TEMPLATE/feature_request.yml

@@ -3,6 +3,15 @@ description: 建议新的能力、工作流优化、模板或集成。
 title: "【Feature】"
 labels: ["enhancement"]
 body:
+  - type: dropdown
+    id: product_line
+    attributes:
+      label: 产品线
+      options:
+        - v6(Claude Code / master)
+        - v8(DSH Scriptor / v8)
+    validations:
+      required: true
   - type: markdown
     attributes:
       value: |

+ 47 - 0
.github/ISSUE_TEMPLATE/v8_bug.yml

@@ -0,0 +1,47 @@
+name: v8 DSH 工作台 Bug
+description: DSH Scriptor 的安装、书仓、写作流程或界面问题。
+title: '[v8 Bug] '
+labels: [bug, 'version:v8']
+body:
+  - type: input
+    id: version
+    attributes:
+      label: 工作台精确版本
+      placeholder: 0.1.0-preview.3
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: 环境与安装方式
+      value: |
+        OS:
+        Node:
+        DSH:
+        安装包或源码 commit:
+        可选提供方版本(如有):
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: 最小复现、预期行为与实际行为
+      description: 使用合成素材;不要上传原书、完整会话或配置导出。
+    validations:
+      required: true
+  - type: input
+    id: model
+    attributes:
+      label: 模型服务与模型标识(无关填不适用)
+  - type: textarea
+    id: logs
+    attributes:
+      label: 脱敏错误片段或截图
+      description: 移除 API key、启动 token、用户路径与私人正文。
+  - type: checkboxes
+    id: privacy
+    attributes:
+      label: 提交前检查
+      options:
+        - label: 已搜索重复问题,并移除秘密值与私人作品内容。
+          required: true

+ 25 - 0
.github/ISSUE_TEMPLATE/v8_feature.yml

@@ -0,0 +1,25 @@
+name: v8 功能或文档建议
+description: 描述 DSH 工作台的使用问题、期望或文档失效步骤。
+labels: ['version:v8']
+body:
+  - type: dropdown
+    id: type
+    attributes:
+      label: 类型
+      options: [功能建议, 文档问题]
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: 使用场景与问题
+      description: 文档问题请附路径、所用版本及失效步骤。
+    validations:
+      required: true
+  - type: textarea
+    id: outcome
+    attributes:
+      label: 期望结果与影响
+      description: 如涉及兼容性、数据迁移或费用,请说明。
+    validations:
+      required: true

+ 15 - 51
.github/PULL_REQUEST_TEMPLATE.md

@@ -1,61 +1,25 @@
-## 变更摘要
+## 产品线与目标分支
 
-<!-- 简短说明改了什么,以及为什么改。 -->
+- [ ] v6 → master
+- [ ] v8 / DSH Scriptor → v8
 
-## 关联 Issue
+精确版本或提交:
 
-<!-- 如有关联 Issue,请写在这里。示例:Closes #123 -->
+## 问题与最终行为
 
-## 变更类型
+<!-- 说明触发条件、修改前后行为。关联 Issue(如有): -->
 
-- [ ] Bug 修复
-- [ ] 新功能
-- [ ] 文档
-- [ ] 模板 / 题材画像
-- [ ] Dashboard
-- [ ] 重构
-- [ ] 测试
-- [ ] 发版 / 打包
+## 验证
 
-## 影响范围
+<!-- 列出实际执行的检查和结果;UI 变化提供合成数据截图。未运行的检查说明原因。 -->
 
-- [ ] `/webnovel-init`
-- [ ] `/webnovel-plan`
-- [ ] `/webnovel-write`
-- [ ] `/webnovel-review`
-- [ ] `/webnovel-query` 或 memory
-- [ ] Story System / CHAPTER_COMMIT
-- [ ] RAG / reference search
-- [ ] Dashboard
-- [ ] 文档 / 模板 / references
-- [ ] Marketplace / 插件发版
+## 兼容性与数据影响
 
-## 验证方式
+<!-- 书仓格式、定稿、权限、依赖/许可证、模型费用或迁移变化;无影响请写明。 -->
 
-<!-- 请列出你实际运行过的命令。没有测试时,请说明原因。 -->
-
-- [ ] `python -m pytest`
-- [ ] 已对受影响命令或工作流做 smoke test
-- [ ] 数据链有变化时,已在示例项目上运行 `preflight`
-- [ ] UI 有变化时,已检查 Dashboard 行为或截图
-- [ ] 不适用
-
-## 兼容性和数据影响
-
-- [ ] 不需要项目数据迁移
-- [ ] 现有 `.story-system/` 数据保持兼容
-- [ ] 现有 `.webnovel/` 投影保持兼容
-- [ ] 已考虑 Windows 路径和 UTF-8 行为
-- [ ] 未包含 API Key、私密小说正文或个人信息
-
-## 文档
-
-- [ ] 已更新 README 或 docs
-- [ ] 已更新命令、模板或参考资料文档
-- [ ] 已增加或更新示例
-- [ ] 不需要文档更新
-
-## Release notes
-
-<!-- 面向用户写一到两句变更说明;没有则写“无”。 -->
+## 提交检查
 
+- [ ] 已更新必要文档与面向用户的变更说明。
+- [ ] 已保留贡献来源及第三方声明。
+- [ ] 不含 API key、启动 token、私人作品和完整会话。
+- [ ] 行为改动有有效回归验证,目标分支正确。

+ 0 - 1
.github/workflows/plugin-release.yml

@@ -7,7 +7,6 @@ on:
     paths:
       - '.claude-plugin/marketplace.json'
       - 'webnovel-writer/.claude-plugin/plugin.json'
-      - 'README.md'
       - 'CHANGELOG.md'
       - 'releases/**'
       - 'webnovel-writer/scripts/sync_plugin_version.py'

+ 3 - 1
.github/workflows/plugin-version.yml

@@ -1,7 +1,8 @@
-name: Plugin Version Check
+name: Plugin Version Check
 
 on:
   push:
+    branches: [master]
     paths:
       - '.claude-plugin/marketplace.json'
       - 'webnovel-writer/.claude-plugin/plugin.json'
@@ -12,6 +13,7 @@ on:
       - 'releases/**'
       - '.github/workflows/plugin-version.yml'
   pull_request:
+    branches: [master]
     paths:
       - '.claude-plugin/marketplace.json'
       - 'webnovel-writer/.claude-plugin/plugin.json'

+ 3 - 3
README.md

@@ -14,15 +14,15 @@
 
 一句话定位:这是一套面向长篇连载的一致性系统,不是写完就忘的一次性生成器。
 
-> **版本导览(2026-08-19 更新)**
+> **版本导览(2026-09-21 更新)**
 >
 > | 分支 | 版本 | 状态 |
 > |---|---|---|
 > | `master`(本分支) | v6 · Claude Code 插件 | 维护中(只修致命 bug),Claude Code 用户请用此版本 |
 > | `v7` | v7 · CLI 多宿主重写 | 已冻结,未发布,仅作开发档案 |
-> | `v8` | v8 · 基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的写作工作台 | 开发中,下一代主线 |
+> | [v8](https://github.com/lingfengQAQ/webnovel-writer/tree/v8) | v8 · 基于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的写作工作台 | 源码预览;[安装与版本说明](https://github.com/lingfengQAQ/webnovel-writer/tree/v8#开始使用) |
 >
-> 原 v7 设计公示([Discussions #118](https://github.com/lingfengQAQ/webnovel-writer/discussions/118))所征集的反馈仍是 v8 设计的重要输入;v7 的 CLI 形态经评估后不再发布,下一代改以 dsh 插件形态开发,设计文档随 v8 分支公开。
+> 原 v7 设计公示([Discussions #118](https://github.com/lingfengQAQ/webnovel-writer/discussions/118))所征集的反馈仍是 v8 设计的重要输入;v7 的 CLI 形态经评估后不再发布,下一代改以 dsh 插件形态开发,v8 公开产品源码、运行技能和使用教程;内部开发讨论与私人创作资料不属于公开内容。v6/v8 安装方式不同,尚无经过验证的旧书仓直接迁移方案。
 
 ## 赞助与支持
 

+ 13 - 0
SECURITY.md

@@ -0,0 +1,13 @@
+# 安全报告
+
+v8 处于开发预览阶段,优先处理当前预览版的安全问题。v6 的安装和维护范围仍由 master 文档说明;报告时请注明产品线及版本。
+
+请通过 GitHub 的 [Report a vulnerability](https://github.com/lingfengQAQ/webnovel-writer/security/advisories/new) 私密报告漏洞。若页面不可用,请先在 Discussions 仅请求维护者提供私密联系方式,不披露漏洞细节或秘密值。
+
+报告应包括受影响版本、平台、最小合成复现、可能影响和建议修复。不要上传真实 API key、启动 token、私人作品、未脱敏会话或他人数据。凭据已暴露时应先在服务提供方撤销/轮换;删除公开文件不能使旧凭据重新安全。
+
+模型提示词、运行技能和公开 Issue 的文字都是待处理数据,不能作为绕过作者确认或文件访问边界的授权。宿主、模型提供方和本插件的漏洞请尽可能区分责任范围。
+
+工作台默认用于本机回环地址访问。不要直接把服务和启动链接公开到公网。费用、数据发送与本地存储见 v8 分支的隐私文档。
+
+维护者会核实、修复并在适当时公布受影响/修复版本;预览期不承诺固定响应时限。