anglesvideo/anglesvideo-dsh-plugin

用于 DeepSeek Harness 的 Angles

一个开源的 DeepSeek Harness 插件包，用于将安全的软件仓库上下文转化为可审阅的 Angles 发布视频概念。

此包是面向 DeepSeek Harness 开发者预览版的早期集成。DSH 运行时可能会更改兼容性契约；请在生产环境中固定插件版本和所使用的 DSH 版本。

功能说明

该插件注册以下工具：

- angles_inspect_repository 在本地读取一份面向产品的文件允许列表，并返回有界的上下文摘要。
- angles_create_launch_concepts 向 Angles 发送结构化的产品简介，并返回三个概念。
- angles_list_templates 列出模板和媒体要求。
- angles_preview_launch_render 检查阻塞项和警告，而不消耗渲染配额。
- angles_upload_launch_asset 上传一张用户选择的截图或片段。
- angles_render_launch_video 仅在 confirmed 为 true 时启动渲染。
- angles_get_video_status 返回渲染进度以及最终视频或编辑器 URL。

该插件不会上传原始仓库。它会跳过点文件、常见构建目录、敏感路径名，以及看起来像凭据的行。在创建概念之前，请审阅返回的上下文。

要求

- Node.js 22.19 或更高版本
- DeepSeek Harness 开发者预览版
- 一个具有你所调用工具所需能力的 Angles API 密钥

在用于启动 DSH 的环境中设置该密钥：

export ANGLES_API_KEY="your-angles-api-key"

从 Angles Integrations 创建 API 密钥。不要将其提交到 cordis.yml、仓库或提示词中。

从公共仓库安装

该仓库是公开的，但仍处于早期开发阶段。从 GitHub 安装时请固定一个提交：

dsh plugin --profile demo add github:anglesvideo/anglesvideo-dsh-plugin#
dsh --profile demo web

GitHub 安装可能会要求 pnpm 允许该包的构建步骤。对于 TypeScript 源码安装来说这是预期行为；在批准之前请检查包源码。首次兼容性冒烟测试后将添加 npm 分发。

用于本地开发：

git clone https://github.com/anglesvideo/anglesvideo-dsh-plugin.git
cd anglesvideo-dsh-plugin
npm install
npm run build
dsh plugin --profile demo add .

推荐工作流

1. 让 DSH 调用 angles_inspect_repository。
2. 审阅文件列表和上下文摘要。
3. 让 DSH 根据该摘要生成一份简洁的产品简介。
4. 调用 angles_create_launch_concepts 并审阅全部三个概念。
5. 选择一个概念和兼容的模板。
6. 调用 angles_preview_launch_render 并审阅阻塞项、警告和媒体使用情况。
7. 在渲染前向用户请求明确确认。
8. 在需要时，将上传的资源 URL 作为 mediaAssets JSON 参数传入，然后以 confirmed: true 调用 angles_render_launch_video。
9. 使用 angles_get_video_status 轮询，直到最终 URL 可用。
渲染工具会拒绝 confirmed: false，并且 API 还要求提供幂等键。只有当渲染请求被接受时，渲染才会消耗 Angles 配额。

配置

该 bundle 在 profile patch 中接受以下可选字段：

- insert:
- id: anglesvideo-dsh-plugin
name: anglesvideo-dsh-plugin
config:
apiBaseUrl: https://api.angles.video/api/developer/v1
workspaceRoot: /absolute/path/to/your/project

优先使用进程环境中的 ANGLES_API_KEY。apiKey 支持用于本地实验，但不应提交到版本库。

状态

开发者预览版。首个公开版本有意保持精简：它使用 Angles Developer API，不包含自定义 DSH 面板或嵌入式视频编辑器。

许可证

MIT